Moka5
Moka5


Migrate MokaFive Server from one machine to another   « Go Back


Table of Contents
- Summary
- Pre-Requisites
- Steps



Summary

Sometimes administrators would want to migrate their Mokafive Server installation due to lack of disk space, upgrading underlying operating system, moving to different datacenters etc. The purpose of this document is to help users move their Mokafive Server installation from:

C: drive to a different drive on same host
C: drive of one host to C: drive of another host
C: drive of one host to different drive of another host
Any drive of one host to any drive of another host


Pre-Requisites

The pre-requisites are as follows:

  • During migration the hostname resolution must remain the same. i.e. if you server is configured as mgmt.mokafive.com then after the migration this DNS name should point to the host’s IP address
  • If you’ve defined a custom connector using ‘iconfig’, make sure to update the IP address after migration or make sure that the new host is using same IP address
  • Migration can take from 15 mins to couple of hours. Management Server and/or Image-Store will be down during this time. New users may not be able register and/or download LivePC images and their updates.



Steps

Please have the following handy:

  • MokaFive Installer (moka5-m5es-installer-X.X.X-XXXXX.jar) – This needs to be same version that your server is running before you begin the migration
  • Java JRE – This needs to be same version that your server is running before you begin the migration
  • Time/Disk space/Bandwidth– You’ll be creating a copy of existing LivePC images and Client Packs is you are migrating Image-Store. In that case, please make sure to account for the required time/bandwidth/disk space to copy these over
  • All the hosts involved in migration need to have their time/time-zone set correctly
  • Backup – Take a snapshot if you run server on a virtual-machine or copy the files of MokaFive installation (usually C:\Program Files (x86)\MokaFive\ but can be different if you installed server on a different location)

Once you have made sure that you have the above pre-requisites satisfied and above things handy perform the following steps:

1. Stop MokaFive Services on existing server, go to services>M5ES>stop

Or

Logon to the server using Terminal Stop M5ES service

2. Launch MokaFive installer on the new host (host you want to migrate to)

    • Follow installation prompts (you can change location of directory during installation)
    • Stop MokaFive Services on target server, go to services>M5ES

Or

Logon to the server using Terminal Stop M5ES service.

3. Copy and paste these folders from Existing Server to the Target Server’s location selected in step #2. Locations may vary to your preferences/configurations:

    • <Installation_Path>\MokaFive\conf
    • <Installation_Path>\MokaFive\m5fs (this folder will only exists if the server you want to migrate is an All-in-One setup or Primary Image-Store or a Replica)
    • <Installation_Path>\MokaFive\opends
    • <Installation_Path>\MokaFive\derby (if you are using built-in Database)
    • <Installation_Path>\MokaFive\logs (optional – if you prefer to copy)

4. Start MokaFive Services on the New Server (targeted server), go to services>M5ES>start

Or

Logon to the server using Terminal Start M5ES service

5. Now, test newly created MokaFive Server by downloading a player. Once Server is confirmed to be working, decommission the old server.