Installing and Running the Cache Agent as a Windows Service

Procedure

Navigate to the ASG_HOME/bin directory.
Copy the existing asg-engine.tra file as follows:
```
copy asg-engine.tra JHF_asg-cache-agent.tra
```
Using a text editor, edit the JHF_asg-cache-agent.tra file as follows:
1. Locate APP_ARGS variable to set the path to the asg_core.ear EAR file.
```
tibco.env.APP_ARGS=ASG_HOME/bin/asg_core.ear -u asg-cache
```
  For example,
```
tibco.env.APP_ARGS=C:/tibcoasg/asg/2.2/bin/asg_core.ear -u asg-cache
```
2. To install the Cache Agent as a Windows service, add the following properties:
```
ntservice.name=ASG-Cache-Agent
ntservice.displayname=TIBCO ASG Cache Agent
ntservice.starttype=automatic
ntservice.binary.path.absolute=ASG_HOME/bin/asg-engine.exe --propFile ASG_HOME/bin/JHF_asg-cache-agent.tra
ntservice.interactive=false
```
3. Add the following property to configure the location of the log directory (Optional):
```
Engine.Log.Dir ASG_HOME/bin/cache/logs
```
4. Verify that RV_HOME and HAWK_HOME variables are set appropriately to the directory where TIBCO Rendezvous and TIBCO Hawk products are installed.
5. Verify that the tibco.class.path.extended variable includes HAWK_HOME/lib directory at the beginning, as follows:
```
tibco.class.path.extended %HAWK_HOME%/lib%PSP%%CUSTOM_EXT_PREPEND_CP%%PSP%%STD_EXT_CP% %PSP%%CUSTOM_EXT_APPEND_CP%%PSP%
```
6. Save the JHF_asg-cache-agent.tra file.
Open a command prompt window. Change to the ASG_HOME/bin directory. Run the following command:
```
asg-engine.exe --propFile JHF_asg-cache-agent.tra --install
```
Open Services Manager on the Windows system. Verify that TIBCO ASG Cache Agent is added as a service in the local services list.
Right-click the TIBCO ASG Cache Agent service and click Start to run the Cache Agent.
Note:
- To uninstall a Windows service, type the following command:
```
asg-engine.exe --propFile JHF_asg-cache-agent.tra --uninstall
```
- If you make any change to the JHF_asg-cache-agent.tra file after the service is registered, make sure to run --uninstall and --install to register the changes.