Moka5
Moka5


Move All-In-One Primary Image Store Server to Standalone Primary Image Server   « Go Back
Table of Contents
- Summary
- Pre-Requisites
- Steps

Summary

This article outlines the steps for moving an existing Primary Image Store to a standalone server.

Prerequisites

  • Moka5 Installer (moka5-m5es-installer-X.X.X-XXXXX.jar)
  • Java JRE
  • Disk space (copy existence LivePC images/Client Packs)
  • Any SSL Certificates
  • DNS entry (FQDN) for new Primary Image Store server
  • Server’s time in Sync (both Management & New Primary Image Store)

Steps

PLEASE NOTE:

If your architecture is such that you connect through the Moka5 Application Gateway when externally accessing your infrastructure, you must consider some pre-requisites prior to splitting the Primary Image Store. The following architecture change is assumed:

Moka5 All-In-One


Moka5 Management Server with Stand Alone Image Store (names added for clarity)

Based upon this architecture change, you must ensure the following:

  1. You must create a new internally and externally routable fully qualified DNS name for your Image Store. In this example, my FQDN is 'image.company.com'. The FQDN should route as follows:
    • Externally: 'image.company.com' should route to the Moka5 Application Gateway (192.168.10.100).
    • Internally: 'image.company.com' should route to the Moka5 Image Store (10.10.5.2)
  2. You must create a new proxy host in your Moka5 Application Gateway referencing the new image store FQDN.
  3. If you are using publicly signed certificates and you only have one that is tied to the FQDN of the Management Server, you must create new certificates. In other words, you will need either a wildcard certificate or one that has alternate subject names. Please reference the product documentation on certificates if you need more information.

Moving the All-In-One Primary Image Store Server to Standalone Primary Image Server

Log in to the server with administrative privileges

Install Java JRE

Install & configure Moka5 Enterprise Server (Standalone Primary Image Store)

1. Launch installer MokaFive-X.XX.XXX-MgmtServer-Installer.jar

a. Accept License Agreement <Next>

b. Select Installations path <Next>

c. Select Image Store <Next>

d. Review Installation Items <Next>

e. Enter Settings

i. Enter FQDN for primary image store server

ii. Username & Password for bootstrap account <Next>

f. Setup Shortcuts <Next>

g. Installation Finished <Done>

2. Configure new Primary Image Store server

a. Launch web browser https://imagestore server (FQDN)/iconfig

b. Continue/accept with website’s security certificate issue

c. Login with bootstrap account & password

d. Go to Settings tab, Advanced, ensure Replica is OFF

e. Go to Settings tab, Advanced, Access Keys and copy the KeyID and KeySecret to a notepad document.

f. Go to Certificates tab, SSL Certificates, and click on the key alias for the SSL certificate in use. Copy the PEM Encoded Certificate to a notepad document.

3. Reconfigure Management server’s primary image store

a. Login management console with server bootstrap account

b. Go to Settings tab, select Infrastructure

c. Edit Primary Store’s Server URL

d. Edit Image Store: <https://imagestore server (FQDN)/xmfs/>

e. Enter new primary image store Key ID & Key Secret from step 2e

f. Perform <Test>, if success, <Save>

g. Log out bootstrap account

h. Log back in with manager account and verify Primary Image Store

i. Go to Settings, Infrastructure, perform <Test Now> with Primary Image Store

· Note URL Address should be https://imagestore server (FQDN)/xmfs

4. Prepare copy data from All-In-One primary image store to new standalone primary image store

a. Stop Moka5 Enterprise Server Services with Stop M5ES on both servers under <Start/All Program/MokaFive Enterprise Server/Stop M5ES>

b. Copy all data files (include subdirectories) from All-In-One primary image store to new standalone primary image store

i. From: ‘C:\Program Files (x86)\MokaFive\m5fs’

ii. To: new Primary Image store ‘x:\Program Files (x86)\MokaFive\m5fs\xmfs

· x: = drive location

c. Restart Moka5 Enterprise Server Services with Start M5ES on both servers under <Start/All Program/MokaFive Enterprise Server/Stop M5ES>

5. Copy Standalone Primary Image Store certificate to the Management Server

a. Launch web browser https://management server (FQDN)/iconfig

b. Login using the boostrap admin account

c. Go to Certificates tab, Trusted CA Certificates and click on Add Certificates

d. Copy the certificate from step 2f into the Trusted CA store and click Add