Migration Utility

The Migration Utility in the HOD Hex Client admin console serves as a web view for the traditional HOD Migration Utility, which allows the HOD Hex Client administrators to migrate the HOD user profiles and data from a lower to a higher version.

This module includes the Export, Import, and Rollback process.

Export:This process allows users to export the HOD data into a Migrationpackage.zip file which gets downloaded to the browser-configured download location on successful export.

Below inputs are provided by the users:

  1. Provide the complete HOD source installation path (mandatory field)

    Example: C:\Program Files\ibm\HostOnDemand

  2. Provide the complete path of custom files except for the default location, i.e., HODObjs

    Example: C:\ibm\CustomFiles

The exported package consists of the HOD user files, the custom files (like kmp, .col, .mac) provided by the user, and ‘Exportinfo.txt’.
Note:
The path provided must have read/write permission.

Import:This process allows users to import the lower version of HOD data to migrate to a higher version as a .zip file.

Below inputs are provided by the users:
  1. Browse the MigrationPackage.zip file that needs to be imported (mandatory field)

  2. Provide the complete Target HOD installation path (mandatory field)

    Example: C:\Program Files\ibm\HostOnDemand15.0.0.0

  3. Next, the ‘Target Backup’ option (by default checked) creates the backup server files of the target HOD.
  4. There are options to override the directories (by default checked), which include ‘Private Directory, Publish Directory, PDFPdt, and Dirutils.’
  5. Next, the ‘Other optional settings’ link is available to override multiple keys and values.
  6. The mandatory dropdown allows users to select any of the options below.
    • Terminal
    • FileTransfer
    • Icon
    • FTPTerminal
    • dbaOptions
    • targetUI
Example: Icon – autoLaunch(Key) – false(value).
Note:
key-value pair field should not be left blank.

On successful import, the NCService Manager will hang on until restart.

Rollback:This Rollback option allows users to restore the application to its previous state. It is applicable only when the ‘Target Backup’ option is selected while importing the files.Users must provide the complete path of the Target HOD installation path (mandatory field).

Example: C:\Program Files\ibm\HostOnDemand15.0.0.0 On successful rollback, the NCService Manager will hang on until restart.
Note:
Users will receive a failed message containing the error if the Export/Import/Rollback process fails.

Terminal:This process has the ability to override the 'Terminal' properties of configuration user profiles during import.

Users provide the following inputs for the configuration migration utility:

  1. Browse and import the ConfigParameters.properties file, which must contain ‘Terminal’ parameters as a key and value pair.

    Example: portBackup1(key) = 23(value)

  2. Provide the complete Target HOD installation path.

    Example: C:\Program Files\ibm\HostOnDemand15.0.0.0

  3. Click on import.
  4. On successful import, the .user files under HOD private directory will be overwritten.
    Note:
    • .properties files disable the directories such as TargetBackup in the import panel.
    • On successful import, the NCService Manager will hang on until restart.