Preparing to use the Migration Assistant

For a successful migration, we recommend taking some measures to prepare your systems to avoid difficult-to-solve problems that could lead to migration failure.
To prepare your systems for migration:
  1. Install RICOH ProcessDirector on the target system.
    1. Verify that your system meets the prerequisites.
    2. Follow the installation instructions just as you would for a new installation.
    3. Return to this procedure after you complete the process to install the base product.
    4. Log in to the version of RICOH ProcessDirector that you just installed. Use the User Name aiw and the Password aiw.

      When you change the password for this user, remember the new password. We recommend logging in as this user until the migration process is complete and all users are imported to the target system.

    5. Install the same features that you had on your old system and any new features that you have purchased. If an error occurs during the installation, contact Ricoh Software Support.
    6. Download and install license keys. RICOH ProcessDirector and all features install in trial mode. If the trial period expires before you install license keys, the software stops working.

      Note: You can install license keys after the migration process is complete if you prefer.
  2. If you are using the Preprinted Forms Replacement feature, export the file from your target system and copy it to the source system. Follow the instructions for Exporting media with electronic forms.
  3. When you import step resources, the files that they refer to are not included in the export package. Copy the files referenced in the step resources from the source system to the target system manually. You must copy the files to the target system before you start the Migration Assistant.
    1. To import all the step resources, copy the contents of /aiw/aiw1/StepResources from the source system into the same directory on the target system.
    2. To import specific step resources, open the XML file that you exported. Find the entry for each step resource that you exported and locate the StepResource.File property. In that value, find the name of the RSC file associated with that step resource. For example, in this value:
      <property name="StepResource.File" value="{&quot;fileName&quot; : 
      &quot; , &quot,&quot;displayName&quot; : &quot;

      The file name is: 1992052c6ef44a229b8b43d77232bf53.rsc

    3. Find the file on the source system and copy it into the same directory on the target system.
  4. The Migration Assistant cannot migrate credentials of any kind. However, objects that require them fail to import if they do not exist on the target system. Export your Password, Session, and Static credentials from the source system now. Import them onto your target system before you start the Migration Assistant.
    • Private Key credentials cannot be exported, because they must be created on the system where they are used. Objects that use private key credentials fail in the Migration Assistant and must be recreated manually afterwards.
  5. Prevent common issues that can result in migration failure:
    1. Take a snapshot or backup of both the source and target systems to avoid the risk of data loss.
      • Using Migration Assistant to upgrade on a different computer does not affect the source system, preserving the data and configuration. We recommend backing up both systems as a safety measure.
    2. 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, you have the opportunity to download the package during the migration. Then you can install the Product Update using Import Package on the source system Feature Manager page.
      • 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.

    3. Check file system capacity. For a successful migration, the target system should have at least as much available capacity as the source system.
    4. Disable any software that scans and locks files, such as antivirus and security software, that may interfere with installation or performance.