Created by James Hurrell on Apr 21, 2022


Summary: Instructions explaining how to manually install and uninstall the Windows Service for Console and Node(s) packages.

Manually install the Windows Services

In some circumstances it may be necessary to manually install the Windows Service for the Console (1.x only) and Node packages, for example if you have previously been using the batch files to start and stop Console/Node. To do so, on the server hosting the front-end Console (1.x only) and on each Node where you require a Windows Service, locate the following files:

Console front-end:
≥ 2.x: Enterprise mode (Java JAR installers):
%PROGRAMFILES%\CAST\AIP-Service-Registry\tools\aip-service-registry-service-install.bat
%PROGRAMFILES%\CAST\AIP-Gateway\tools\aip-gateway-service-install.bat

≥ 2.x: Standalone mode (Java JAR installers):
%PROGRAMFILES%\CAST\AIP-Console-Standalone\tools\aip-node-service-install.bat

1.x:
%PROGRAMFILES%\CAST\AipConsole\AipConsole\tools\aip-console-service-install.bat

AIP Node:
≥ 2.x: %PROGRAMFILES%\CAST\AIP-Node\tools\aip-node-service-install.bat
1.x: %PROGRAMFILES%\CAST\AipConsole\AipNode\tools\aip-node-service-install.bat

Then:

  • Either execute the .bat file (by double clicking it) and manually configure the Service when it is installed (start-up preference, logon service account etc.)
  • or execute the .bat file in a CMD Window using the following syntax:
aip-console-service-install start_after_install is_user_account [service_user] [service_password]
aip-node-service-install start_after_install is_user_account [service_user] [service_password]
  • start_after_install: start the service after installation, true/false
  • is_user_account: log on as specific user, true(recommended)/false
  • service_user: service domain\user name
  • service_password: service password

For example, to start the Service after installation and to use a login MyAccount with the password MyPassword:

aip-console-service-install true true MyAccount MyPassword
aip-node-service-install true true MyAccount MyPassword

Manually uninstall the Windows Services

To manually uninstall the Windows Service, locate the following files and execute them on the relevant servers:

Console front-end:
≥ 2.x: Enterprise mode (Java JAR installers):
%PROGRAMFILES%\CAST\AIP-Service-Registry\tools\aip-service-registry-service-uninstall.bat
%PROGRAMFILES%\CAST\AIP-Gateway\tools\aip-gateway-service-uninstall.bat

≥ 2.x: Standalone mode (Java JAR installers):
%PROGRAMFILES%\CAST\AIP-Console-Standalone\tools\aip-node-service-uninstall.bat

1.x:
%PROGRAMFILES%\CAST\AipConsole\AipConsole\tools\aip-console-service-uninstall.bat

AIP Node:
≥ 2.x: %PROGRAMFILES%\CAST\AIP-Node\tools\aip-node-service-uninstall.bat
1.x: %PROGRAMFILES%\CAST\AipConsole\AipNode\tools\aip-node-service-uninstall.bat