Upgrading Sterling Gentran:Server

Use the upgrade option on every server in your Sterling Gentran:Server® system when you receive upgrades to the Sterling Gentran:Server software.

1. On the splash screen, click IBM® Sterling Gentran:Server for Microsoft Windows.
2. If you are running any of the Sterling Gentran:Server services, the system prompts you to stop the services so installation can proceed. Click Yes to stop each service.

   If you select No for any of the services, setup will prompt you to exit.

   Note: If you have the Sterling Gentran:Server for RosettaNet, the HTTP Gateway, or the HTTP Message Forwarder installed, setup may prompt you to allow it to stop the World Wide Web Publishing service, Simple Mail Transport Protocol (SMTP) service, FTP Publishing service, and IIS Admin service.
3. Click Next.

   The setup program looks for installed components. Since there are Sterling Gentran:Server components installed on this server, one of the following happens:

   • You are prompted that an older version of Sterling Gentran:Server is installed and asks if you would like to upgrade to the new version.
   • The Installation Options dialog box is displayed.
4. Do one of the following:
   • If you were prompted that an older software version was detected, click Yes.
   • If you were prompted with the Installation Options dialog box, select Upgrade your existing installation and click Next.

   Setup indicates that it is ready to upgrade your current installation and asks if you have read the instructions and backed up your files and database.

5. If you want to proceed, click Yes and continue with the next step.

   If you are not upgrading the primary Sterling Gentran:Server system controller, go to Step 10. If you are upgrading the primary Sterling Gentran:Server system controller, setup locates the system you specified and displays the logon dialog box.

6. Log in to Windows using the Windows administrative user ID and password that the Executive Service uses to access network resources.

   The format is DOMAIN\User for a domain account and .\User for a non-domain account.

   The Database Logon dialog box is displayed because setup needs to update the database tables.

7. Log in to the database using your database administrator user ID and password and click Next. This is the administrative database login that setup uses to build the database tables.
   Notes:

   • For a SQL server user ID, you must use a SQL administrative logon with administrative rights on the Sterling Gentran:Server database. Otherwise, only the user that created the database tables can use those tables.
   • If you are using Oracle, you must use the schema owner of the tables so that the schema will not change.

   If you are upgrading from a Sterling Gentran:Server version prior to 5.0, setup asks if you want to be HIPAA compliant. If this does not apply, continue with Step 9.

8. If you want to be HIPAA-compliant, click Yes and setup will install the appropriate components.

   See the IBM Sterling Gentran:Server for Microsoft Windows HIPAA and NDCPC Compliance Guide for more information.

   If you are installing Integration Components and are upgrading from a pre-5.0 Sterling Gentran:Server system to a 5.x system, the system asks you what default data format you want to use for new maps and new fields.

9. Click Yes if you want to use a free format or No if you want to a format that corresponds to ASCII characters.
   Notes:

   • When you create a new map or a new field, Sterling Gentran:Server assigns a default format to the string fields. This format serves as the basis for character validation. If your preference for default formats corresponds to ASCII characters only (most U.S. users), you will not require this free format option. If your default format is to include languages using character sets beyond ASCII characters, you should choose free format (0x01 – 0x0FF).
   • This selection is permanent and, once you choose this default configuration setting, you are unable to change it.
10. Click Yes to proceed with the upgrade.

    Setup performs the following:

    • Upgrades the components that you previously installed on this server.
    • Upgrades communication scripts.
    • Upgrades system translation objects.
    • Adds registry entries (if necessary).
    • Adds or updates database tables (if necessary).
    • Builds the program group and icons (if necessary).
    • Validates the date and version of the existing files against the date of the upgrade files.

    Note: Depending on the size of your database, the upgrade process may last anywhere from a few minutes up to a couple of hours.

    The setup program then determines if there were any errors:

    • If errors occurred on the primary system controller, when you rerun setup you are prompted to execute automatic recovery to attempt to recover the database. Click Yes when you are prompted to execute automatic recovery.
      Note: If you do not want to run automatic recovery, click No when you are prompted. You should then delete the gupgrade.log file from the root folder of your C: drive.
      Important: You should attempt to fix the cause of the failure (such as a database crash or network failure) before running setup again.
    • If errors occurred on a secondary controller or user interface client, setup reports the errors and informs you that the installation is complete.

      See the InstallShield Error Messages.

    • If no errors occurred, setup informs you that the upgrade installation is complete.

    Note: You may get a message that shared DLLs are locked with a prompt to reboot. If you did not get this message, continue with step 12.
11. If you want to reboot your server now, select Yes, I want to restart my computer now and click OK to reboot the server.

    If not, select No, I will restart my computer later and click OK to terminate the setup program.

    Note: Be certain that you have saved your work in any other open applications prior to rebooting the server.

    Setup asks if you want to restart the services that setup stopped. Any services that are not included in the core install will not start until you upgrade that optional component.

12. If you want to start the services that setup stopped, click Yes.

    Otherwise, click No. You will need to restart the services manually later.

    Setup prompts you that if you loaded Integration Components, you will also need to install the appropriate Sterling Gentran® Standards from the Standards DVD.

13. Click OK.

    Setup prompts you that to configure E-mail notification, you must configure the MAPI profile to be used. See the IBM Sterling Gentran:Server for Microsoft Windows MAPI Gateway Configuration Guide for more information.

14. Click OK.

    Setup prompts you that if you previously installed optional components, you will need to upgrade those components.

15. Click OK.

    The system warns you that if you have any Sterling Gentran:Server extensions or gateways installed on your system, you may need to upgrade those to be compliant with the latest Sterling Gentran:Server release.

16. Click OK to exit setup.

    The installation is complete. If you upgraded Integration components, you are prompted to load the Sterling Gentran Standards.