Step 1: Apply the custom upgrade to the test environment

You need to apply the newly-created custom upgrade to your test system for user acceptance testing.

Note If you experience problems, such as a power failure or a network connection error while upgrading the system, you need to restore the database before attempting to run the upgrade again.

To upgrade the custom upgrade, follow these steps:

  1. On the test system, which is a copy of your production system, complete all the preparation tasks in Upgrade tasks on the development environment.
  2. Load the preupg.bin file using Service Manager Database Manager, and then restart the client.

    Note Instead of using the file that you extracted from the product installation package, you must use the preupg.bin file in your CustomUpgrade folder.

    Note The AppUpgVersion.txt file does not exist in the CustomUpgrade folder. Do not copy the file to this folder.

    Caution Before loading these files, you also need to disable the Client side load/unload option from Window > Preferences > Service Manager.

  3. From the System Navigator, click System Administration > Ongoing Maintenance > Upgrade Utility > Apply Upgrade to launch the Upgrade Utility.
  4. In the text box, type the fully qualified path to the folder that hosts transfer.bin, and then click Next.

    Note Instead of using the file that you extracted from the product installation package, you must use the transfer.bin file in your CustomUpgrade folder.


    Windows: c:\temp\upgrade\

    Linux: ~/upgrade/

    Note You must have read, write, and execute permission to the folder.

  5. The loading process may take a long time. Wait until the file is loaded and the system displays the Transfer files loaded message.

  6. The system displays a series of information for your verification, including Applications version upgrading from, Applications version upgrading to, Applications base version, Full path to the Upgrade Utility files and Language(s) to be upgraded. Verify these information and then click Next to continue.

    Note If this screen does not display the correct information, do not continue with the upgrade. Instead contact Micro Focus Software Customer Support.

  7. When you are asked whether you want to proceed, click Yes.
  8. The Upgrade Utility displays the status when the upgrade is being processed.
  9. When you receive an "UPGRADE IS COMPLETE" message, the Upgrade Utility has finished the data processing and you can follow the instructions in the message to complete the next steps. After you click Finish, you are automatically logged out.

  10. Restart the server and log back in to the client.
  11. Open the scversion table in the Database Manager, and verify that the Application Version field is 9.60.00xx. If this field displays a value other than 9.60.00xx, check the log files to identify the issue that occurred.

Note how long it takes to apply the custom upgrade, so you will know how long the production system will be unavailable during the production upgrade. You can check the log file for an estimate.

Upgrade Utility logs and error messages

When applying the custom upgrade to the test system, the Upgrade Utility creates a set of log files, which reside in the same directory as the custom upgrade files.

The contents of these log files are similar to those in the log files when running an out-of-box upgrade. See Upgrade Utility logs and error messages.