Upgrading Unifier 9.9.4 to Unifier 9.13.1.0

Workflow

  1. Backup a copy of the file repository and database
  2. Uninstall Unifier 9.9.4
  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, find the configuration settings for Unifier in the weblogic/configurator directory.
    2. Copy the bluedoor.properties file to a safe location. The file locations are set while configuring Unifier and can be found in the Unifier Configurator.

Uninstall Unifier 9.9.4

  1. Stop the Unifier service on all machines within the environment (including a cluster environment if it exists).
  2. Ensure all open windows related to Unifier are closed, including any administrative tools such as Windows Services.
  3. From the Windows Start menu, click Programs, Unifier [version no.], Uninstall Unifier.
  4. Click the Uninstall button. This will uninstall Unifier, remove the services, and remove the directory.
  5. When prompted, click Yes to remove all the files in the Unifier directory.
  6. Ensure that the WebLogic Admin server is running.
  7. Navigate to the Unifier server and verify that the files and the Unifier directory were successfully removed.
  8. Before rebooting the server, restart the World Wide Web Publishing Service from the Services window.
  9. If you receive a message that all of the files could not be removed, reboot the server before continuing.
  10. After restarting the server, open Windows Explorer, right-click the Unifier folder and select 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 (WebLogic).
  2. After a successful installation, proceed to migrate data to Unifier 9.13.1.0. See the following section.

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 from Unifier 9.9.4 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.9.4 data to 9.13.1.0 Development Environment

  1. Prepare a new database for 9.13.1.0 with a database import from the 9.9.4 Production database.
  2. Prepare the 9.13.1.0 Unifier environment with the “Production” configuration, and connect it to the new database created in the previous step.
  3. Perform data migration on the 9.13.1.0 Unifier environment. This includes running the End-Of-Migration target on the 9.13.1.0 Unifier environment.
  4. On the Application Server, open a browser and type this URL in the Address bar: http://localhost:[port]/bp/localhost/migration/log

    The Unifier Migration log window opens. If there are any data migration targets listed in the log window, then you must run all the listed data migrations before finally executing the End-Of-M Migration step.

  5. Run the migration script, select End of Migration, click Run, and click Yes to confirm. A window opens notifying you that the migration has been completed successfully.
  6. Close the browser. The run date on the migration log will update after a successful migration.
  7. Log in to the 9.13.1.0 Unifier environment as company administrator (ootbadmin) and navigate to Administration Mode > uDesigner.
  8. Verify that all the designs were successfully migrated. If a design was not successfully migrated, the Version field for that design has a value -1 (minus on) and the id field has a value included in the [ ] (brackets). If you see any instances that did not migrate successfully, proceed as follows:
    1. Save the current Unifier log file which will be used to identify the issues.
    2. Contact Oracle Support. Oracle Support will identify the problems and may recommend updating the current production environment to have those designs brought to a stage where they are suitable for 9.13.1.0.
    3. Repeat the previous steps in this procedure if you need to apply any updates to the current production environment.
  9. If there are no errors, reconfigure the application server to Development. This is your new 9.13.1.0 Development environment.
  10. As a company administrator, you might want to disable most of the production users in the new Development environment.
  11. Proceed to migrating 9.11.0.0 to 9.13.1.0 Production environment.

Migration of 9.9.4 data to 9.13.1.0 Production Environment

Perform this procedure after you finish creating a new 9.13.1.0 Development environment from the 9.9.4 Production database.

Note: When you complete the following procedure, both the Unifier 9.13.1.0 Development environment and the Unifier 9.13.1.0 Production environment are built and ready to use.

  1. Prepare the Unifier 9.13.1.0 environment with the 9.9.4 production configuration and connect it to the production database.
  2. Perform data migration on the 9.13.1.0 Unifier Production environment. This includes running the End-Of-Migration target on the 9.13.1.0 Unifier environment.
  3. On the Application Server, open a browser and type this URL in the Address bar: http://localhost:[port]/bp/localhost/migration/log

    The Unifier Migration log window opens. If there are any data migration targets listed in the log window, then you must run all the listed data migrations before finally executing the End-Of-M Migration step.

  4. Run the migration script, select End of Migration, click Run, and click Yes to confirm. A window opens notifying you that the migration has been completed successfully.
  5. Close the browser. The run date on the migration log will update after a successful migration.
  6. Log in to the 9.13.1.0 Unifier environment as company administrator (ootbadmin) and navigate to Administration Mode > uDesigner)
  7. Verify that all the designs were successfully migrated. No errors occur at this stage because errors have been identified and resolved when building the 9.13.1.0 Unifier Development environment.

The Unifier 9.13.1.0 Development environment and the Unifier 9.13.1.0 Production environment are built and ready to use.


Last Published Monday, August 28, 2023