## Add Broker

Use this dialog to create a representation of a broker in the administration console's navigational pane. You do not have to start the broker to do this. You will need to start the broker before you can connect to it.

Broker Label Specifies the name you would like displayed for this broker in the administration console's navigational pane. This name does not have to be the same as the broker's instance name.

Host Specifies the name of the machine hosting this broker or leave the default value of `localhost`.

Primary Port Specifies the number of the port assigned to the port mapper. By default this is 7676. The combination of the host name and primary port number uniquely identifies the broker. To run two instances of a broker on the same server, each broker's Port Mapper must have a different port number.

Username Specifies your user name. By default, this is `admin` for the administrator. This information is used to authenticate you when you try to connect to the broker. Entering it in this dialog is not secure. If you are concerned about security, you should wait until connection-time when you will be prompted for this information.

Password Specifies your user password. By default, this is `admin` for the administrator. This information is used to authenticate you when you try to connect to the broker. Entering it in this dialog is not secure. If you are concerned about security, you should wait until connection-time when you will be prompted for this information.

- Use the OK button to commit all the entered information and add the broker.

To connect to the broker that you have added:

1. Select the broker in the administration console's navigational pane.
2. Choose Actions > Connect to Broker.

To query and/or update a running broker:

1. Select the broker in the administration console's navigational pane.
2. Connect to it if it is not already connected.
3. Choose Actions > Query/Update Broker.

To change the information you have specified in this dialog for a particular broker, you must do the following:

1. Select the broker in the navigational pane.
2. Disconnect the broker if it isn't already disconnected. A broker is disconnected if its icon in the navigational pane looks like:
   To disconnect a broker, choose Actions > Disconnect from Broker
3. Choose Actions > Properties to open the Broker Properties dialog.