Administration Guide > Installation > New Installation > Installing Utilities (Windows)

Installing Utilities (Windows)

This document guides you through the new installation of the utilities (Windows).

Supplied Files

The files for the utilities (Windows) are stored in the directory IMAGE:UTILITY\WINDOWS.

*G.EXE - Java loader for utility
*.EXE - Program for batch request
*.BAT - Batch file for utility

Note that as of Automation Engine version 8.00A, the file names of all utilities have been changed to lowercase letters.

Procedure

	1.	Installing the Java Runtime Environment (JRE)

This installation step can be ignored if the required version of JRE is already installed.

Admin computer
You can check the system's current Java Virtual Machine (VM) version by using the command:

java -version

Ensure that the order of the indicated directories is correct in the settings of %PATH% or $PATH if several JRE or Java SDK Versions have been installed on the computer. The Java Runtime Environment that is found first in the listing of directories is applied.

Download the required Java Runtime Environment from http://java.sun.com and install it. The installation process includes the automatic installation of the Java Plug-in for Web browsers. It can be deactivated in the system control because AE does not require it.

	2.	Installing the Microsoft Visual C++ 2010 Re-distributable Package

This installation step can be ignored if the package is already available in the required version. Refer to the Control Panel -> Add or Remove Programs to see if the package is installed, and if so, which version.

Admin computer
Install the package from the IMAGE:CRTS directory.

	3.	Installing the utilities

Admin computer
Start the program SETUP.EXE in the corresponding subdirectory of IMAGE:UTILITY\WINDOWS.
Automic strongly recommends installing the utilities in a separate directory (such as C:\AUTOMIC\UTILITIES).

	4.	Adjusting the INI files and setting up the system environment

Admin computer

The INI files and the corresponding utilities share the same name. Adjust the INI file entries as needed:

AE.DB Archive: UCYBDBAR.ini

AE.DB Change: UCYBChng.ini

AE.DB Client Copy: UCYBDBCC.ini

AE.DB Load: UCYBDBLD.ini

AE.DB Reorg: UCYBDBRE.ini

AE.DB Reporting Tool: UCYBDBrt.ini

AE.DB Revision Report: UCYBDBRR.ini

AE.DB Unload: UCYBDBUN.ini

Almost all utilities require information about the AE databaseA database is an organized collection of data including relevant data structures. connection which is specified in the INI files. Automic recommends creating a new database user for AE. Never create a user that is called "sa". The appropriate passwordA secret combination of characters for a Automation Engine user. can be encoded by using the program UCYBCRYP.EXE.
Use the following parameters in order to specify the program via the command line:

UCYBCRYP[.EXE] -p -nPassword
The file Password.ucc is created in the directory of the program that contains the encoded password.

	5.	Calling the DLL from a freely selected path (optional)

Admin computer
Utility DLL paths can be changed by making an appropriate entry in the system environment variables (system control -> system). Enter the variable JAVA_LIBRARY_PATH and the required path. Libraries are loaded from this directory.
Alternately, you can also use the parameter "-Djava.library.path=Path" in the INI files. Enter it in the line "cmd=" of the section [GLOBAL].

For example:

cmd="javaw" -Djava.library.path=..\libraries -jar -cp .;.\UC4LAF.jar UCYBDBAr.jar

	6.	Starting the utilities

Admin computer
There are three ways to call a utility:

*G.EXE: regular utility start (G stands for GUI).
*.EXE: program to which start parameters can be assigned for batch calls
*.BAT: batch file for the utility

To run the utilities by using an *.EXE file, you must have installed a 32-bit Microsoft Visual C-Runtime Library.