¶ Windows Update Service Installation and Configuration
Service is a regular Windows Service and a Win32 application in once.
¶ Installation
Open a command prompt in admin mode and execute the executable with one of the following paramters.
Important:
Service picks up the Executable name, and use it as a service name.
As a good practice it is recommended to add the Port Number and the instance name before the installation.
e.g.:
CIPUpdateWinServiceBuild_8080.exe
Possible parameters:
-help
It shows a list of parameters with a small description.
-install
Installs the service from this directory, and use the exename as the service name.
-uninstall
UnInstalls the service.
-config
It shows the config dialog of the service.
-standalone
The service is able to run as a standalone win32 application, it do not need to be installed as a service.
In this case a service tray icon will be shown.
¶ Error handling, and automatic restart:
In case of Windows Service settings please go the windows service manager, locate the installed service and bring up the config dialog.
Set the necessary StartUp type, e.g: Automatic(Delayed Start)
Specify the account which determinate's the service rights also in the Log On tab.
Recovery and automatic restart:
To be able to restart the service automatically or after errors the Recovery parameters should be configured:
First, second, and third errors: "Restart the Service"
And allow: "Enable Actions for stops with errors"
If this parameters sets correctly the service will generate an dummy error and will be restarted by the windows core system.
¶ Configuration of the Service:
Configuration is available through the -config parameter of the service: "CIPUpdateWinServiceBuild_8080.exe -config"
¶ ServiceSetup.General:
Server Name: Name of the server, it will be displayed in the Web Interface also
Startup Delay: time in seconds to wait until the service start the initialization of the threads. e.g. useful if other services has to run before initialization, (SQL Server)
Cache Directory: in some cases service user needs to have a special directory to be able create files. Default: blank.
Number of critical errors: the number specifies the error count, after the system will generate a service error and Exit. If service is correctly configured (see above) system will restart the service automatically.
¶ ServiceSetup.WebInterface:
HTTP interface of the Service, an overview of the configured threads and service status.
Enabled: Allows the windows (IntraWeb) service thread.
Port: Service WEB interface's port number
Web AccessUser Name: web access can be restricted with a username and password combination.
Web Access Password: web user's password
¶ ServiceSetup.Instances
The service can run multiple thread and instances.
Even one CIP Instance with different threads are possible to run.
Instances will be looked int the /dbconnections subdirectory, You should place Your connection definition .xml-s here.
DataBase connection: Name of the CIP connection used by the instance.
UserName: CIP Username to log into the CIP system.
Password: CIP User's password
Groups: it is a comma separated of CIP Schedule groups which should be executed by this instance. You can use the wizard to select the available groups of an instance.
Special group codes: "ALL" means: run all available groups within the instance. "NONAME" run the schedule group wich ha no name (empty name).