Starting as-agent

as-agent is provided for Java, .NET, and C.

Procedure

  1. Ensure the ActiveSpaces /bin directory is in defined in the path variable. Go to the ActiveSpaces \bin directory:
    • Windows:

      Default location: <TIBCO_HOME>\as\<version>\bin

    • UNIX/Linux:

      Default location: /opt/tibco/as/<version>/bin

  2. For Java, ensure as-agent.jar from the ActiveSpaces /lib directory is in your CLASSPATH.
  3. Start as-agent as follows
    Platform Command
    Native executable as-agent
    .NET executable Agent.NET
    Java java -jar as-agent.jar

    You can start as-agent with any of the following parameters:

    -metaspace <metaspace_name> 
    -discovery <discovery_url>  
    -listen <listen_url>
    -member_name <member_name> 
    -remote_listen <remote_listen_url> 
    -log <file_path> 
    -log_debug <log_level> 
    -loglimit <logfile_size_limit> 
    -logcount <number_of_log_files> 
    -logappend <true | false> 
    -debug <log_level> 
    -advisory_level <advisory_level> 
    -name <member_name> 
    -admin 
    -data_store <directory path> 
    -worker_thread_count <count> 
    -rx_buffer_size <size> 
    -security_policy <string> 
    -security_token <string> 
    -authentication_domain <string> 
    -authentication_username <string> 
    -authentication_keyfile <string> 
    -authentication_password <string> 
    -identity_password <string> 
    -monitor_system true|false 
    -input <filepath>
    -member_timeout <ms>            
    -cluster_suspend_threshold      
    -connect_timeout <ms>           
    -autojoin.role <role>           
    
    Each parameter specifies a parameter name and a value.
    Note: If you start as-agent with the -member_name parameter; for example as-agent -member_name "agent1", then when you run the Admin CLI you can issue the show member command and specify the member name of the agent to display the attributes of the member; for example, show member_name "agent1"

    To display usage help for as-agent, enter as-agent -help

    The output of the help command includes the default values used if no parameter is provided.
    Note: When you are using the -data_store option with the as-agent command, such as as-agent -datastore "c:/abc/tmp"" ensure that you specify the absolute path to a directory. Also ensure that the datastore has write permissions on the directory.
Related reference