How to configure the ASG engine as a Windows Service?

How to configure the ASG engine as a Windows Service?

book

Article ID: KB0093299

calendar_today

Updated On:

Products Versions
TIBCO ActiveMatrix Service Gateway -
Not Applicable -

Description

Description:
This article describes the steps to setup asg-engine as a Windows Service.

Issue/Introduction

How to configure the ASG engine as a Windows Service?

Resolution

Below are the steps to install asg-engine as a Windows Service
-----------------------------------------------------------------------------------------------------------------------
-----------------------------------------------------------------------------------------------------------------------
Make the following changes in the asg-engine.tra file:

1)> Locate APP_ARGS variable and specify path to EAR
#*******
tibco.env.APP_ARGS=C\:/tibcoasg/asg/1.2/bin/asg_core.ear
#*******

2). Add the properties specific to setting ASG as a Windows Service.
#=============================
# Windows NT Service
#=============================
ntservice.name=ASG-Core
ntservice.displayname=TIBCO ASG Core
ntservice.starttype=automatic
ntservice.binary.path.absolute=C\:/tibcoasg/asg/1.2/bin/asg-engine.exe -u asg-caching-core -a BookQuery
ntservice.interactive=false

3). Log directory can also be confgirued by adding the following property:
Engine.Log.Dir            C:/tibcoasg/asg/1.2/bin/logs

4). Add the following extra properties:
tibco.clientVar.CDD=C\:/tibcoasg/asg/1.2/bin/asg_core.cdd
tibco.clientVar.PUID=default

5). Set RV_HOME & HAWK_HOME variables respectively in the TRA file.

6). Append the HAWK lib directory at the beginning of TIBCO Extended Classpath.
#
# Specifies the classpath with expansion on
#
tibco.class.path.extended %HAWK_HOME%/lib%PSP%%CUSTOM_EXT_PREPEND_CP%%PSP%%STD_EXT_CP%%PSP%%CUSTOM_EXT_APPEND_CP%%PSP%

7). Save the TRA file.

8). From a command window, go to the ASG_Home bin directory(e.g. C:/tibcoasg/asg/1.2/bin) and run the following command:
asg-engine.exe --install

or

asg-engine.exe --propFile  --install
(if you are not using the default properties(.tra) file)

9). Check the Service Manager. "TIBCO ASG Core" will be added.

10). Start the ASG Engine as Windows Service.


Note:

A). To uninstall the Windows Service:
asg-engine.exe --uninstall

or

asg-engine.exe --propFile  --uninstall

(if you are not using the default properties(.tra) file)

B). If you make any change to the tra file, you will have to run --uninstall and --install again to update the service registry.

C). Change PATHs based on your setup.

D). Install Hawk and set the variables, if not already installed.

Additional Information