Use the Command Assistant wizard to create, modify, and delete the
following physical runtime components:
- Brokers
- Configuration Managers
- User Name Servers
Using the wizard, you access the equivalent command line command through
a graphical interface:
The wizard consists of a series of panels that lead you
through the task you want to complete. The wizard provides help in the banner
at the top of each panel, which indicates what actions you should take to
complete the panel and continue. Not every optional parameter on each of these
commands is supported through the wizard; if you are using some of the more
advanced features (for example, setting or modifying LDAP directory access
for a broker), you must use the command line interface.
Use the buttons
displayed at the bottom of each panel to move Back to
the previous panel, to move to the Next panel, to Finish working
with the wizard, or to Cancel the current action and
end the wizard.
- Switch to the Broker Application Development
perspective or the Broker
Administration perspective.
- Select . The New dialog
opens.
- Select Command Assistant Wizard within the Broker
Administration - Getting Started category and click Next. The wizard opens and displays its first panel.
- Select the type of component that you want to work with. The wizard checks which components have been installed on this system.
You must select a value from the available list; you cannot enter a different
value.
- Navigate to the Name input field. If the wizard has found any existing components of the type you entered,
it shows these in this field. If there are no existing components of this
type, or you want to create a new component, enter a new unique name in this
field, following the naming restrictions enforced by the product and any naming
conventions that are in use in your environment.
The name of a resource
is case insensitive. If a resource of the same name exists, but with characters
in a different case to those you typed into this field, the name you typed
is overwritten with the existing name.
- Navigate to the Action input field and choose
the action you want to complete. The wizard prevents you from entering
an invalid action for the resource you have entered in the Name field.
For example, if you have entered a name that the wizard has not found on this
system, you can only choose to create a new resource. If the resource already
exists, you can choose to modify it or to delete it.
- If you have more than one installation of the product on this system,
you must also select the correct value in the Location field. This field displays the home directory of the installation identified
by the wizard:
- If there is only one installation on this system, the directory is displayed
and the field is greyed out.
- If you have specified an existing, uniquely named, resource in the Name field,
the wizard displays the location of the installation associated with that
resource and the field is greyed out.
- If more than one installation exists, and could be the target for your
request, you must select the correct location in this field,
- Click Next. The wizard displays
the next panel, the content of which depends on your choices so far.
Use
the help displayed by the wizard on each panel, and navigate through the entry
fields, selecting or entering text where appropriate.
If you enter
a password, the characters are displayed as asterisk characters in the entry
field to increase security.
- When you have completed the entry field on the panel, click Next. The wizard displays a summary that shows you the commands that will
be invoked, and any additional actions that will be taken.
- Check the information in the summary; if it is correct, click Next.
If you want to change anything, click Back to
return to a previous panel and change your input.
- The wizard starts processing your request. If
the action succeeds, the wizard displays messages in the summary panel.
If
an action fails, the wizard reports the error in a message dialog. If you
know what is causing the error, and can fix it, correct the error and click Yes.
The wizard reissues the command.
If you do not know what is causing
the error, or you cannot fix it, click No. The wizard
backs out any actions that have already completed and returns your system
to its initial state.
- Click Finish to end the wizard, or click Next to
return to the first page and select another task to complete.