The site prompt command applies only to the as-admin executable. The command toggles the display of the name of the local site as part of the as-admin command prompt.
Syntax
By default, the name of the local site is included as a part of the as-admin command prompt, which means that the default is on.
site prompt on | off
For example, when it is on, the prompt format is as follows:
as-admin.primarySite>
Parameters
site prompt Parameters
Parameter Description
on Include the name of the local site as part of the as-admin command prompt.
off Display the normal as-admin command prompt.
You can use the as-dump utility to view backup files that are used with ActiveSpaces shared-nothing persistence.
The as-dump program is a utility that you can run offline to examine shared-nothing persistence files and get information such as the ActiveSpaces version the file was created with, the number of entries in the file, and optionally, the data in the file entries. As-dump is useful for examining the data store files created when you are using shared-nothing persistence and detecting possible problems.
The as-dump utility takes a file name and/or a specific directory name as input. You must provide the full directory path.
If you provide the directory name, as-dump reads all files in the directory or in its subdirectory and prints out information on each of the files. If you specify a filename, as-dump outputs information for the specified file only.
Syntax
The as-dump utility has the following syntax:
as-dump [-vhm] <filepath/directory>
-h help
-v verbose, verbose output
-m <int>, number of entries to print at once
as-dump Parameters
Parameter Description
filepath/directory Required.
-h Displays the command syntax for as-dump.
-v Verbose. Displays detail for each tuple in the file.
-m <int> Specifies output of int entries.
Sample Output
The output from as-dump indicates:
● The location of the persistence file (or files if you specify the directory name only).
● The filename for each persistence file.
● The ActiveSpaces version that created the files.
● The number of entries in the file.
● If you specify the verbose option, the contents of each tuple.
The following example shows output from the as-dump command with the verbose option and a specified filename specified:
[2012-11-05 14:29:23:301][4896][7040][INFO][asdump]
<Filter></Filter>
[2012-11-05 14:29:23:401][4896][7040][INFO][asdump]
<File>
<value type="int32" pos="0" name="key"> 1 </value>
<value type="string" pos="1" name="value"> one </value>
<value type="date_time" pos="2" name="time"> 2012-11-05T20:21:33.000GMT </
value>
</Tuple>
[2012-11-05 14:29:24:1][4896][7040][INFO][asdump]
<Tuple>
<value type="int32" pos="0" name="key"> 2 </value>
<value type="string" pos="1" name="value"> two </value>
<value type="date_time" pos="2" name="time"> 2012-11-05T20:21:41.000GMT </
value>
</Tuple>
[2012-11-05 14:29:24:101][4896][7040][INFO][asdump]
<Tuple>
<value type="int32" pos="0" name="key"> 3 </value>
<value type="string" pos="1" name="value"> three </value>
<value type="date_time" pos="2" name="time"> 2012-11-05T20:21:54.000GMT </
value>
</Tuple>
[2012-11-05 14:29:24:201][4896][7040][INFO][asdump]
<Tuple>
<value type="int32" pos="0" name="key"> 4 </value>
<value type="string" pos="1" name="value"> four </value>
<value type="date_time" pos="2" name="time"> 2012-11-05T20:22:02.000GMT </
value>
</Tuple>
[2012-11-05 14:29:24:301][4896][7040][INFO][asdump]
<Tuple>
<value type="int32" pos="0" name="key"> 5 </value>
<value type="string" pos="1" name="value"> five </value>
<value type="date_time" pos="2" name="time"> 2012-11-05T20:22:11.000GMT </
value>
[2012-11-05 14:29:24:824][4896][7040][INFO][asdump]
</File>
[2012-11-05 14:29:24:924][4896][7040][INFO][asdump]
</Dump>
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.
You can also use as-agent to:
● Ensure that the desired degree of replication specified for a space is achieved.
Because the amount of data that can be stored in a space depends on the number of seeding
members of the space, you might need to add seeders to a space to scale it up. Although any process using the ActiveSpaces API can become a seeder on a space, there are situations where applications may not always be running and joined to the space, or where not enough applications have joined the space.
● Ensure data integrity.
Because the data contained in the space disappears along with the last seeder in the space, this can be a problem. You can use the as-agent process to ensure that there are always one or more seeders for each space in the metaspace.
Agents remain connected to the metaspace, and always seed the system spaces, keeping the metaspace’s space definitions alive, even when all other applications have quit the metaspace.
Running as-agent to Include a Command Console
You can use as-agent to run Admin CLI commands when as-agent starts up. To run as-agent and display a command prompt which accepts Admin CLI commands, specify the -admin parameter as follows:
java -jar as-agent.jar -admin
When as-agent starts, an as-agent command prompt appears, where you can enter the Admin CLI commands.
Remote Invocation
The use of remote invocation is possible when using the Java as-agent. Use the following command to start your Java as-agent so that it can find the class files it should use for remote invocation:
java -Djava.ext.dirs=$LOCATION_OF_JARS$ -jar as-agent.jar
Otherwise, running java as-agent in a cluster that includes remote members will cause invoke methods to fail with a “ClassNotFound” exception.