The IceStorm administration tool,
icestormadmin, is a command-line program that provides administrative control of an IceStorm server.
Configuration properties inform
icestormadmin about the topic manager(s) that you wish to administer. You have several configuration options:
icestormadminconstructs its own proxy for the topic manager at the specified host and port
IceStormAdmin.TopicManager.Default- specifies a proxy for the default topic manager on which administrative commands operate
IceStormAdmin.TopicManager.name- specifies the proxies for any number of named topic managers
The tool supports the following command-line options:
If you specify one or more
-e options, the tool executes the given commands and exits, otherwise the tool enters an interactive session. The
help command displays the following usage information:
Print this message.
Exit this program.
TOwith the optional
Without an argument,
linksdisplays the links of all topics in the current topic manager. You can specify a different topic manager by providing its instance name.
Without an argument,
topicsdisplays the names of all topics in the current topic manager. You can specify a different topic manager by providing its instance name.
Set the current topic manager to the topic manager with instance name
INSTANCE-NAME. The proxy of the corresponding topic manager must be specified by setting an
IceStormAdmin.TopicManager.nameproperty. Without an argument, the command shows the current topic manager.
Display replication information for the given
Displays the identities of the subscribers for each of the
Some of the commands accept one or more topic names (
TOPICS) as arguments. Topic names containing white space or matching a command keyword must be enclosed in single or double quotes.
icestormadmin uses the topic manager specified by your setting for
IceStormAdmin.TopicManager.Default. For example, without additional arguments, the
create command operates on that topic manager.
If you are using multiple topic managers, you can specify their proxies by setting
IceStormAdmin.TopicManager.name for each topic manager. For example:
This sets the proxies for three topic managers. Note that
name need not match the instance name of the corresponding topic manager —
name simply serves as a tag. With these property settings, the
icestormadmin commands that accept a topic can now specify a topic manager other than the default topic manager that is configured with
IceStormAdmin.TopicManager.Default. For example:
This sets the current topic manager to the one with instance name
Foo; the first
create command then creates the topic within that topic manager, whereas the second
create command uses the topic manager with instance name