![]() | |
Sun Java System Portal Server 6 2005Q1 Technical Reference Guide |
Chapter 14
rwadminThis chapter contains the following sections:
DescriptionThe rwadmin command enables the administrator to manage the Rewriter data available in the Sun Java System Access Manager Rewriter service.
SyntaxThe rwadmin command syntax is described in this section.
Short Named Format
rwadmin list -u uid -w password [-l locale] [-b] [-h]
rwadmin store -u uid -w password [-l locale] [-b] [-h] filename
rwadmin get -r rulesetname -u uid -w password [-l locale] [-b] [-h] [filename]
rwadmin remove -r rulesetname -u uid -w password [-l locale] [-b] [-h]
Long Named Format
rwadmin list --runasdn uid --password password [--locale locale] [--verbose] [--version] [--help]
rwadmin store --runasdn uid --password password [--locale locale] [--verbose] [--version] [--help] filename
rwadmin get --rulesetid rulesetname --runasdn uid --password password [--locale locale] [--verbose] [--version] [--help] [filename]
rwadmin remove --rulesetid rulesetname --runasdn uid --password password [--locale locale] [--verbose] [--version] [--help]
SubcommandsThese subcommands are supported:
list
Description
This subcommand lists all the available ruleset names.
Syntax
rwadmin list -u|--runasdn uid -w|--password password
Example
In the following example, the command displays names of all available rulesets.
rwadmin list -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua
store
Description
This subcommand stores the Rules available in the local file system into Access Manager. If you want to store the DefaultRuleSet, use the following command:
rwadmin store -u uid -w password /resources/DefaultRuleSet.xml
where /resources/DefaultRuleSet.xml is the location of RuleSet stored in rewriter.jar file. Note that when this command is executed, if a ruleset with the same ID already exists, no new data is stored. Delete the existing ID and try again.
Syntax
rwadmin store -u|--runasdn uid -w|--password password filename
Example
In the following example, the command stores the Rules available at /opt/data/ExampleRuleSet.xml into the Access Manager.
rwadmin store -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua /opt/data/ExampleRuleSet.xml
get
Description
This subcommand gets the RuleSet from Access Manager. If the filename is provided, the retrieved RuleSet is stored in the specified file, or else it is displayed on stdout (or the console).
Syntax
rwadmin get -r|--rulesetid ruleset -u|--runasdn uid -w|--password password [filename]
Examples
In the following example, the command retrieves the RuleSet named ExampleRuleSet from Access Manager and displays it on the console.
rwadmin get -r "ExampleRuleSet" -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua
In the following example, the command retrieves the RuleSet named ExampleRuleSet from Access Manager and saves it in the file abc.xml in the /tmp directory.
rwadmin get -r "ExampleRuleSet" -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua /tmp/abc.xml
remove
Description
This subcommand deletes the RuleSet from Access Manager. This command deletes the RuleSet without any warning.
Syntax
rwadmin remove -r|--rulesetid ruleset -u|--runasdn uid -w|password password
Example
In the following example, the command deletes the RuleSet whose name is ExampleRuleSet from Access Manager.
rwadmin remove -r "ExampleRuleSet" -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w joshua
OptionsThe following table contains a summary of the rwadmin command options. It contains two columns: the first column lists the possible options; the second column gives a brief description of the corresponding option. The rwadmin command supports the following options (listed in alphabetical order):