Installing and Running the Central Logger 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-cl.tra
  3. Using a text editor, edit the JHF_asg-cl.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-cl

      For example, 

      tibco.env.APP_ARGS=C:/tibco/asg/2.3/bin/asg_core.ear -u asg-cl
      Note: To run the Central Logger 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-cl -a ASGProject Configuration Name

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