Running the Migration Assistant

With the Migration Assistant, objects are transferred from one RICOH ProcessDirector system to the other. This process significantly minimizes the likelihood of human error associated with the import of a large number of objects.
Before you begin, make sure you know the URL for the login page of the system you want to migrate from (source system). To proceed with migration, you need Administrator access for both the source and target systems.
  • We recommend logging in to the target system using the aiw user, as your RICOH ProcessDirector user ID probably does not exist on the new system yet.
  • You can create a new administrator user to log in to the target system, but, if it exists on the source system, it is overwritten during migration.
To use the Migration Assistant:
  1. Log in to your RICOH ProcessDirector target system as aiw user.
  2. Click the Administration tab.
  3. In the left pane, click Utilities Migration Assistant.
  5. Log in to the source system with an administrator user name and password.
    • You must provide the full URL for the log in page of the source system.
  6. On the Verify page, make sure all the information presented is correct and click Continue.
  7. On the Prepare page, review the suggested actions to reduce the migration failure possibilities. For each step, you have the option to either complete or ignore it. Click Save and Continue to proceed with the migration.
    For example, in this step, you can make sure that the Product Update features are installed on both systems at the same level. In the Feature Manager, find the Product Update feature for both systems and compare the values in the Installed Version column.
    • If the target system has a higher version, click the download button in the Migration Assistant to save the package to your system. Then you can install the Product Update using Import Package on the source system.
    • If the source system has a higher version, find the most recent product update package in: /opt/infoprint/ippd/available. The name of the package is: ProductUpdate-3.4.version_number.epk. Download the package, then log in to the target system. Open Feature Manager, import the package, then install it.

      For more information, see Adding or upgrading a feature using Import Package.

  8. On the Features page, click CHECK FEATURES to compare the features installed on the systems. To proceed, make sure that both the source and target systems have the same features installed.
    If any features are missing, click Save and Continue. Review the features to install and click OK. Feature Manager opens so you can install the missing features. After the features are installed, log in to your RICOH ProcessDirector target system again and return to the Migration Assistant. When both systems contain the same features, click Continue to proceed with the migration.
    • If you purchased one or more features for the first time, they can exist on the target system only.
    • If you worked with Ricoh's Advanced Solutions Practice to install additional functions on your source system, you must transfer those feature packages to your target system. Contact your Ricoh representative for assistance.
  9. On the Objects page, select to migrate all objects from your source system or specific objects.
    We recommend migrating all objects, but you can select which objects to migrate if you want to take this opportunity to remove some objects from your system. If you choose to selectively migrate objects, click the Select objects and choose the objects you want to migrate.

    The Migrate options let you overwrite any identically named objects on the target system with the corresponding objects from the source system.

  10. On the Settings page, select which previously configured system settings to migrate. These settings are configured in the Settings section of the Administration page. Choose the settings to import and click Save and Continue.
    Note: System Identification properties cannot be exported with General System settings and must be created on the system where they are used.
  11. Before proceeding with the migration process, review the configuration to import from the source system. If you need to change any choices, you can navigate to any step of setting up the migration elections by selecting Edit.
  12. When everything is confirmed, click START MIGRATION.
    The Migration Assistant starts to import objects and settings while displaying the progress. You can download the migration log file to review the details when any migration errors occur or the final version when the migration is complete.
  13. Download the ZIP file log if there are any errors that you need to review.
  14. After you download the ZIP file, click X button at the top of the page to exit the MIGRATION ASSISTENT.
  • You can click X in the upper right corner of the window followed by SAVE CHANGES to save the progress at anytime during migration. In this way, you can return to complete the migration process from where you left off.
  • See Completing the upgrade process to complete the migration process.