Administration Guide > Installation > New Installation > Installing the ServiceManager (Windows)

Installing the ServiceManager (Windows)

This document describes the hotfix installation procedure for the ServiceManager (Windows).

Automic strongly recommends installing the ServiceManager and its dialog program in separate directories (for example, C:\AUTOMIC\SERVICEMANAGER\BIN and C:\AUTOMIC\SERVICEMANAGERDIALOG\BIN).

Supplied Files

The ServiceManager files are stored in two different directories of the supplied AE CD. The files that provide the ServiceManager service can be found in the directory IMAGE:SERVICEMANAGER\WINDOWS.

The directory IMAGE:SERVICEMANAGERDIALOG\WINDOWS contains the files for the dialog and command line programs of the ServiceManager.

Additional files that are included in these sub-directories belong to the installation program and the AE runtime system.
See: Knowledge Base.

Procedure

Server computer or host computer

	1.	Installing the Microsoft Visual C++ 2010 Redistributable Package

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

Host (32 bit)
Install the package from the IMAGE:CRTS\WINDOWS\X86 directory.

Host (64 bit)
Install the package from the IMAGE:CRTS\WINDOWS\X64 or IMAGE:CRTS\WINDOWS\IA64 directory.

	2.	Installing the ServiceManager

Host (32 bit)
Start the program SETUP.EXE in the corresponding subdirectory of IMAGE:SERVICEMANAGER\WINDOWS\X86.
Adjust the INI file UCYBSMGR.INI to your system environment.
Adjust the definition file (SMD file)

Host (64 bit)
Start the program SETUP.EXE in the corresponding subdirectory of IMAGE:SERVICEMANAGER\WINDOWS\X64 or IMAGE:SERVICEMANAGER\WINDOWS\IA64.
Adjust the INI file UCYBSMGR.INI to your system environment.
Adjust the definition file (SMD file)

	3.	Installing the Dialog and Command Line Programs of the ServiceManager

Host (32 bit)
Start the program SETUP.EXE in the corresponding subdirectory of IMAGE:SERVICEMANAGERDIALOG\WINDOWS\X86.
Adjust the INI file UCYBSMDI.INI according to your system environment.
These programs can also be installed on computers where no ServiceManager runs, which enables the ServiceManager to be operated from these computers.

Host (64 bit)

Start the program SETUP.EXE in the corresponding subdirectory of IMAGE:SERVICEMANAGERDIALOG\WINDOWS\X64 or IMAGE:SERVICEMANAGERDIALOG\WINDOWS\IA64.
Adjust the INI file UCYBSMDI.INI according to your system environment.
These programs can also be installed on computers where no ServiceManager runs, thereby facilitating that the ServiceManager can be operated from these computers.

	4.	Installing the ServiceManager as a service

Open an MS DOS window
Start the program UCYBSMGR.EXE using the command:

UCYBSMGR[.EXE] -install Phrase [-iPath and name of the INI file]

The ServiceManager is entered in Windows as a service. You can use a string of your choice as the phrase.
Verify in the Control Panel –> Administrative Tools –> Services that the service is correctly entered. The name displayed here is structured - as follows: "Automic ServiceManager [Phrase]".
Set the start type to "Automatic" if needed.
The phrase name is "UC4" by default. If you choose to use a different term, you must adjust the following section in the INI file UCYBSMGR.INI:

[Destination Phrase]
deffile=Path to the SMD file
cmdfile=Path to the SMC file

Example:

[Destination UC4PROD]
deffile=C:\AUTOMIC\SMgr\bin\UC4PROD.smd
cmdfile=C:\AUTOMIC\SMgr\bin\UC4PROD.smc

Start the service

The ServiceManager can be installed as a service multiple times. This means that different ServiceManager environments can be created; one that serves as a test system and one that serves as a production system, for example. If several of these services are used, they are distinguished by the ServiceManager environment name (default name: UC4).

Note that the ServiceManager service must be started under a Windows user with administrator rights. The reason is that the ServiceManager can be used to start components that can start processes for various different users.

	5.	Starting services using the ServiceManager

Make sure that the ODBC data source is set up as a system DSN (Data Source Name) so that the Automation Engines (program UCSRVCP.EXE and UCSRVWP.EXE) are executable as a service.

Start the dialog program of the ServiceManager.
Select the computer and the ServiceManager environment (phrase).
All provided services are displayed (status "stopped").
Right-click to start the service or to change a particular service's properties (such as starting automatically when the system starts or delaying its start).

Potential Problems

Not all ServiceManager environments (phrases) are displayed:
A port number range must be specified in order for more than one ServiceManager to be selectable in the dialog program. Enter this range in the INI file of the utility, keeping in mind that it is limited to 10 port numbers.
Not all services are displayed:
Ensure that the correct instructions are given in the definition file (SMD file). Each service should be displayed in an extra line. Also enter the path of the SMD file in the INI file of the ServiceManager.
A service cannot be started:

Verify that the path specified in the properties is correct (to be opened via the context menu in the dialog program).
Automation Engines on UNIX: the file "syntax.bin" must be in the same directory as the INI file.

Further information can be obtained from the ServiceManager's log file (default name of the latest file: SMgr_LOGG_00.txt), which is found in the TEMP folder and which contains detailed information on all procedures.

Uninstalling the ServiceManager

In some cases it is necessary to uninstall a specific ServiceManager environment (Phrase).

Open an MS DOS window.
Start the program UCYBSMGR.EXE with thecommand:
UCYBSMGR -remove Phrase
This command uninstalls the ServiceManager environment as a service under Windows.
Check the Control Panel - Administrative Tools - Services in order to verify that the service has been removed.

Installing the ServiceManager (Windows)

Supplied Files

Procedure

Potential Problems

Uninstalling the ServiceManager

See also: