Installing Hotfixes

Hotfixes are released with each sub-release. They serve to remove possible malfunctions and defects. Please note that the most current hotfix always includes the modifications of previous hotfixes. It is therefore not necessary to install all previous hotfixes in order to have all modifications included in your AE system.

Use the guidelines for upgrading an AE system if you intend to upgrade to a new version of AE.

Messages and message numbers can also change within hotfixes. Adjust them if they have a control function in your AE system. The message-comparing program UCCMPMSL.EXE lists all messages that have changed.

To Install Hotfixes

Important!

• The Automation Engine and the Automic Web Interface components must have the same service pack/hotfix version number.

• When a hotfix is issued for the AWI or the AE component, there is either a confirmation that there are no incompatibility issues, or an equivalent hotfix for both components is released at the same time.

• If a hotfix has been released for both components, you should upgrade both components to ensure compatibility.

• In case of any doubt, components bundled together in a download offering are tested for compatibility. An offering always contains the same service pack/hotfix version of the AE and AWI components.

  For more information, see Automic Compatibility Matrix.

1. Download a Hotfix.

   • Log on to the Automic Download Center (http://downloads.automic.com).
   • Select "Automation Engine" from the Application drop-down optionally filter with any of the other fields.

   A list of applicable downloads will be listed at the bottom of the screen.

   • Download the Hotfix.

2. Install a Hotfix.

   The installation procedure depends on the component that is to be updated.

   • Hotfix for initial data:
   • Copy the whole database directory to the computer on which the utilities are installed.

   The DB directory must be a parallel directory of the utilities' BIN directory.

   • Shut all server processes down. This is especially important if server processes are distributed among several computers. Then load the file UC_UPD.TXT to the database using the utility AE.DB Load.
   • If necessary, load the server processes (see Hotfix for Servers).

   Set the parameter StartMode =COLD in the INI-file UCSRV.INI of the server process that starts first (in other words, the one that will be the primary work process). Restart this server process and then restart all other server processes.

   If you intend to update the server as well, a coldstart is only required after the server hotfix installation.
   
   

   • Hotfix for Autmation Engine: Stop the server processes on all computers. Install the hotfix files and restart the server processes.
   • Hotfix for Automic Web Interface: Install the hotfix files for Automic Web Interface.

   Automic recommends installing one common hotfix version for initial data, server processes and Automic Web Interface.

   When updating the Automic Web Interface to a new hotfix version, make sure that you use the current Online Documentation. If your version is not up to date it can happen that an incorrect document opens when you open the help in AWI via the F1 key. This can also happen if you install the Online Documentation with a hotfix but use an older version of the AWI.

   • Hotfix for utilities, agents and other components: Stop the component and install the hotfix files.