Installing Utilities (Windows)
This document guides you through the new installation of the utilities (Windows).
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 database 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 password 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.
See also: