Installing and Running the Global Throttle Manager as a Windows Service

Procedure

  1. Navigate to the ASG_HOME/bin directory.
  2. Copy the existing asg-engine.tra file as follows: 
    copy asg-engine.tra JHF_asg-gtm.tra
  3. Using a text editor, edit the JHF_asg-gtm.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-gtm

      For example, 

      tibco.env.APP_ARGS=C:/tibcoasg/asg/2.2/bin/asg_core.ear -u asg-gtm
    2. To install the Global Throttle Manager as a Windows service, add the following properties: 
      ntservice.name=ASG-GTM
ntservice.displayname=TIBCO ASG Global Throttle Manager
ntservice.starttype=automatic
ntservice.binary.path.absolute=%ASG_HOME%/bin/asg-engine.exe --propFile ASG_HOME/bin/JHF_asg-gtm.tra
ntservice.interactive=false
    3. Add the following property to configure the location of the log directory (Optional): 
       Engine.Log.Dir ASG_HOME/bin/gtm/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. (Optional)
    5. Verify that the tibco.class.path.extended variable includes HAWK_HOME/lib directory at the beginning, as follows (Optional): 
      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-gtm.tra file.
  4. Open a command prompt window. Change to the ASG_HOME/bin directory. Run the following command: 
    asg-engine.exe --propFile JHF_asg-gtm.tra --install
  5. Open the Services Manager on the Windows system. Verify that TIBCO ASG Global Throttle Manager is added as a service in the local services list.
  6. Right-click the TIBCO ASG Global Throttle Manager service and click Start to run the Global Throttle Manager.
    Note:
    • To uninstall a Windows service, type the following command: 
      asg-engine.exe --propFile JHF_asg-gtm.tra --uninstall
    • If you make any change to the JHF_asg-gtm.tra file after the service is registered, make sure to run --uninstall and --install again to register the changes.