![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |
ActiveSpaces provides an agent process called as-agent. The main purpose of as-agent is to join all distributed spaces in the specified metaspace as a seeder. You can run as-agent on any host.To start as-agent:
1. Go to the ActiveSpaces \bin directory:Default location: C:\tibco\as\2.0\binDefault location: /opt/tibco/as/2.0/bin
2. Enter as-agent.
If you start as-agent with the -member parameter; for example as-agent -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"
3. To display usage help for as-agent, enter as-agent -help
The member name that you specify with the -name parameter can specify simply the member name; or, if you are implementing host-aware replication, can specify a membername in the form a.b, where a specifies the name of a region, for example region1, and b specifies the name of a seeder running in that region, in effect, on the same host.
For information on deploying host-aware replication, see Host-Aware Replication.
There is also a Java version of as-agent available in the lib directory that can be launched using java -jar as-agent, and which takes the same argument as the C version of the agent described above. The Java version of the as-agent behaves exactly as the C version, but will be able to service requests to remotely invoke methods as triggered by other applications using the space (obviously as long as it has the classes being invoked present in it's CLASSPATH).For more details about discovery and listen URLs, see Chapter 3, “Performing Basic ActiveSpaces Tasks,” in the TIBCO ActiveSpaces Developer’s Guide.If you are using as-agent to start a requestor node that is authorized using a security domain controller that uses a security token file, the command to start as-agent must include the -security_token parameter. This parameter specifies the name of the security token file that has been placed on the controller node.To run as-agent and display an as-admin console that allows you to enter Admin CLI commands, specify the -admin parameter as follows:When as-agent starts, an as-agent command prompt appears, which allows you to enter Admin CLI commands.If you include the parameter -log <log_file>, then the log filename will be log_file-<processid>.log. For example, if you enter -log as, then the log filename is as-<processid>.log.The -data_store parameter specifies the directory path where shared-nothing persistence files are stored.If you are using shared-nothing persistence, specify the -data_store parameter when you run as-agent; for example:where directory_path specifies the directory path for the shared nothing persistence data store.
![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |