Upgrading Unifier 9.12.0.0 (and Later Versions) to Unifier 9.13.1.0

Workflow

  1. Backup a copy of the file repository and database
  2. Uninstall Unifier 9.12.0.0 (and later versions)
  3. Install and deploy Unifier 9.13.1.0 on each application server
  4. Migrate data to Unifier 9.13.1.0

The following sections provide details.

Backup a copy of the file repository and database

  1. Follow your organization procedures and create backup files of the following:
    • Unifier file repository
    • Unifier database
  2. Backup the configurator settings as follows:
    1. In the Unifier Home folder, locate the configuration settings for Unifier in the /configurator directory.
    2. Copy the bluedoor.properties file to a safe location.

      Note: The file locations are set while configuring Unifier and can be found in the Unifier Configurator.

Uninstall the current version of Unifier

Uninstalling Unifier from WebLogic

If WebLogic was deployed using ".sh" or ".bat," then:

  1. Ensure WebLogic is running.
  2. Open the WebLogic directory within the Unifier Home folder.
    • For Windows installations, run undeploy.bat.
    • For Linux installations, run undeploy.sh.

    If prompted, enter the WebLogic user name and password.

If WebLogic was deployed using "unifier.ear," then:

  1. Go to WebLogic console > Deployments
  2. Select Unifier Deployment name, stop, and Delete.

Install and deploy Unifier 9.13.1.0 on each application server

  1. Install the new version of Unifier by following instructions in the Unifier Installation Guide.
  2. After a successful installation, proceed to migrate data to the latest version of Unifier.

Note: During migration all staging environments are automatically renamed and converted as Development environments. Once the migration is complete, you must have only one Development environment. Ensure that other Development environments, if any, are converted/configured to Test environment.

Migrating data from Unifier 9.12.0.0 (and later versions) to Unifier 9.13.1.0

Note: During the preparation of Development and Production environments, do not conduct any design updates on the Production environment. If you want to bring in designs from the 9.9.x Development environment, you can do so only by using the XML Design Export and Import mechanism, which will be available on 9.9.x and 9.11 uDesigner.

Migrating 9.12.0.0 (and later versions) data to 9.13.1.0 Development Environment

  1. Prepare the Unifier 9.13.1.0 environment with the Development configuration, and connect it to the Development database.
  2. Migrate data to the Unifier 9.13.1.0 environment as follows:
    1. On the Application Server, open a browser and enter the following URL: http://localhost:[port]/bp/localhost/migration/log

      The Unifier Migration log window opens.

    2. If there are any data migration targets listed in the log window, then you must run all the listed data migrations.
    3. After running all listed data migrations, select the End of Migration script and click Run.
    4. Click Yes to confirm. A message displays indicating the migration was completed successfully.
    5. Close the browser. The run date on the migration log will update after a successful migration.

This completes data migration process in the Development environment (9.12.0.0 (and later versions) to 9.13.1.0).

Migrating 9.12.0.0 (and later versions) data to 9.13.1.0 Production Environment

Note: Perform this procedure after you have completed migrating the Development Environment from 9.12.0.0 (and later versions) to 9.13.1.0 .

  1. Prepare the Unifier 9.13.1.0 environment with the production configuration and connect it to the production database.
  2. Migrate data to the Unifier 9.13.1.0 production environment as follows:
    1. On the Application Server, open a browser and enter the following URL: http://localhost:[port]/bp/localhost/migration/log

      The Unifier Migration Log window opens.

    2. If there are any data migration targets listed in the Unifier Migration log window, you must run all the listed data migrations.
    3. After running all listed data migrations, select the End of Migration script and click Run.
    4. Click Yes to confirm. A window opens notifying you that the migration was completed successfully.
    5. Close the browser. The run date on the migration log will update after a successful migration.

This completes data migration process in the Production environment (9.12.0.0 (and later versions) to 9.13.1.0).


Last Published Monday, August 28, 2023