Service Registry 3.1 Administration Guide


The add user command adds a User object. A User object normally contains at least one PostalAddress, TelephoneNumber, and EmailAddress object.

Specify the information about the user either on the command line itself or by using the -load option to specify a Java property file with the information. The information options and the -load option are evaluated in the order in which they appear on the command line. For example, you can specify some properties on the command line, load others from a property file, and then override information in the property file with subsequent command-line options.

You can specify up to three addresses, telephone numbers, and email addresses for a new user. If you need more, you can add them later using the Web Console or JAXR.

When you specify an address, telephone number, or email address, you must provide a value for its type: for example, -emailType OfficeEmail.

You can use shorthand options (such as -fn) on the command line for some of the common information that is required for every user. However, you must use the longer form when you provide the information in a property file. For example, you can specify the user’s first email address on the command line using either -email1.address, -emailAddress, or -email. However, when you specify the first email address in a property file, you must use email1.address=. Because there is only one option for the user’s second email address, you must use -email2.address on the command line and email2.address= in a property file.

If you specify the -edit option, the Admin Tool launches an editor so that you can edit the new user’s information. See the option description for details.

The command creates a certificate keystore for the new user in your home directory, in the file $HOME/soar/3.0/jaxr-ebxml/security/keystore.jks. If you are running the tool as root, the home directory is either / or /root.

Note –

The property files that you load with -load or edit with -edit use the IS0-8859-1 charset, as do all Java property files. See the documentation for java.util.Properties.load(InputStream) for details on how to represent characters not in ISO-8859-1 in property files.