Installing and Running the Core Engine as a Windows Service

Procedure

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

      For example, 

      tibco.env.APP_ARGS=C:/tibco/asg/2.3/bin/asg_core.ear
      Note: To run the Core Engine with a project configuration, add the project configuration name in the tibco.env.APP_ARGS variable as follows:

      tibco.env.APP_ARGS=ASG_HOME/bin/asg_core.ear -u asg-caching-core -a ASGProject Configuration Name

    2. To install the Core Engine as a Windows service, add the following properties: 
      ntservice.name=ASG-Caching-Core Engine
ntservice.displayname=TIBCO ASG Gateway Caching Core Engine
ntservice.starttype=automatic
ntservice.binary.path.absolute=%ASG_HOME%/bin/asg-engine.exe --propFile ASG_HOME/bin/JHF_asg-engine.tra
ntservice.interactive=false
    3. Add the following property to configure the location of the log directory (Optional): 
      Engine.Log.Dir ASG_HOME/bin/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. Edit the tibco.class.path.extended variable to include the 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-engine.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-engine.tra --install
  5. Open the Services Manager on the Windows system. Verify that TIBCO ASG Gateway Caching Core Engine is added as a service in the local services list.
  6. Right-click the TIBCO ASG Gateway Caching Core Engine service and click Start to run the cache-enabled Core Engine.
    Note:
    • To uninstall a Windows service, type the following command: 
      asg-engine.exe --propFile JHF_asg-engine.tra --uninstall
    • If you make any change to the JHF_asg-engine.tra file after the service is registered, make sure to run --uninstall and --install again to register the changes.