Hotfix Installation

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.

Importnant!

• 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.

• Use the guidelines for upgrading an AE system if you intend to upgrade to a new version of AE. For more information, see Upgrading an Automation Engine System Manually.

• 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. For more information, see Comparing Messages.

Shutting Down and Storing the Automation Engine

On the admin computer, user computer, server computer, and hosts:

• Close all Automic Web Interface instances

• Close all agents

• Close all instances of the Automation Engine

• If necessary, close the service that started the ServiceManager

• Store all directories in which AE has been installed

• Store the database

  Make sure to store the database with database utilities.

Comparing Messages

Messages provide information about the status of the AE system and its activities. They are written to log files, reports or the Message Window of the Automic Web Interface. Because there can be new, changed or deleted messages from one Automation Engine version to the next, it is important that you understand these adaptations.

The message-comparing program lists all changes in detail. It compares the message libraries (UC.MSL) of both Automation Engine versions and prints the result, sorted by language, in HTML files.

The program UCCMPMSL.EXE is stored in the directory IMAGE:TOOLS\UCCMPMSL. Copy the whole folder to the AE installation directory.

Call the program via the command line with the following parameters:

UCCMPMSL[.EXE] -opath of the original UC.MSL  -npath of the new UC.MSL -pdestination path

There will be 5 files in your destination directory, including RESULT_ENGLISH.HTML, RESULT_GERMAN.HTML and RESULT_FRENCH.HTML, which provide an overview of the message changes. Each of these three files contains a list that can be sorted by changed, deleted and new messages. Additionally, a style sheet for templates (HELP.CSS) and the log file COMPARE_ZUHELP_LOGG.TXT are copied to this destination directory.

Example

UCCMPMSL.EXE -oC:\AUTOMIC\uc.msl -nC:\AUTOMIC\uccmpmsl\uc.msl -pC:\AUTOMIC\uccmpmsl\

Installation

Download the hotfix from https://downloads.automic.com/. Select Automation Engine in the drop-down list to see which hotfixes can be downloaded.

The installation procedure depends on the component that is to be updated. Make sure to install one common hotfix version for initial data, server processes and the Automic Web Interface.

Hotfix for Initial Data

1. Copy the complete database directory to the computer on which the utilities are installed.

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

2. Shut down all server processes.

   This is especially important if they are distributed among several computers.

3. Load the UC_UPD.TXT file to the database using the AE.DB Load utility.

4. If necessary, load the server processes:

   1. In the INI file (ucsrv.ini) of the Automation Engine, set the startMode = parameter to COLD.

   2. Restart the (PWP) server process first and then restart all other server processes.

   Note: You only need a coldstart after a server hotfix installation.
   

Hotfix for the Automation Engine Component

Stop the server processes on all computers, install the hotfix files and restart the server processes.

Hotfix for the Automic Web Interface Component

Install the hotfix files for Automic Web Interface. Make sure the Automic Web Interface and the online documentation have the same version.

Hotfix for Utilities, Agents and Other Components

Stop the relevant component and install the hotfix files.