2 Using the Administration Console to Configure a Domain

This chapter describes how to configure a Service Broker domain using the Standalone Administration Console and Web Administration Console.

About the Administration Console

The Administration Console provides a graphical user interface to perform configuration tasks easily and intuitively, without programming knowledge. For example, using the Administration Console you can add servers to a domain, configure the Signaling Domain, deploy interworking modules in the Processing Domains, and configure the Orchestration Engine.

The Administration Console manages a single domain. In a typical production deployment there are two instances of the Administration Console, one to manage the Signaling Domain and another to manage the Processing Domain.

Service Broker provides the following types of the Administration Console:

A Standalone Administration Console, which is a desktop software application provided with Service Broker.
A Web Administration Console, which you access using a standard web browser.

The Standalone and Web Administration Consoles have very similar user interfaces.

Understanding the Administration Console User Interface

The Administration Console consists of several working areas described in Table 2-1.

Table 2-1 Administration Console Working Areas

Working Area	Description
Domain Navigation pane	Provides a hierarchical view of the domain. You use the Domain Navigation pane to access individual components deployed in the domain. In a Signaling Domain you can navigate through SSUs; in a Processing Domain you can navigate through the OE, IMs, and Subscriber Store settings. The Navigation pane also includes Domain Management settings.
Configuration pane	Displays configuration parameters of components that you select in the Domain Navigation pane. You use the Configuration pane to set up and modify configuration of components deployed in the domain.
Change Center pane	You can manage changes that you make in the configuration of domain's components. See "Making Configuration Changes in a Domain" for more information.

Working Area

Description

Domain Navigation pane

Provides a hierarchical view of the domain. You use the Domain Navigation pane to access individual components deployed in the domain. In a Signaling Domain you can navigate through SSUs; in a Processing Domain you can navigate through the OE, IMs, and Subscriber Store settings. The Navigation pane also includes Domain Management settings.

Configuration pane

Displays configuration parameters of components that you select in the Domain Navigation pane. You use the Configuration pane to set up and modify configuration of components deployed in the domain.

Change Center pane

You can manage changes that you make in the configuration of domain's components.

See "Making Configuration Changes in a Domain" for more information.

Making Configuration Changes in a Domain

When update the domain configuration using the Administration Console, Service Broker performs all changes in the transaction mode. This means that Service Broker accumulates multiple changes into one transaction and applies all these changes at once.

You can perform the following actions when updating domain configuration:

Locking Domain for Changes (see "Locking Domain for Changes" for more information)
Committing Changes (see "Committing Changes" for more information)
Discarding Changes (see "Discarding Changes" for more information)

Locking Domain for Changes

To make changes in the domain configuration, you need to lock this domain for changes. After you locked the domain, no one else can do any changes in the domain. During the lock, Service Broker accumulates all changes. However, Service Broker does not apply these changes unless you commit them.

To lock a domain for changes:

In the Change Center pane, click the Lock & Edit button.

Committing Changes

You need to commit the changes in order to apply them. Service Broker applies all changes that you have done after locking the domain for changes.

To commit changes:

In the Change Center pane, click the Commit button.

Discarding Changes

As long as you do not commit changes, you can discard these changes. To discard changes, click the Discard button. After you discard all changes, the domain configuration is locked again.

To discard changes:

In the Change Center pane, click the Discard button.

Switching the Domain Configuration Mode

The domain configuration mode specifies how configuration updates are propagated to servers in the domain. You can use one of the following modes:

Online mode, when configuration updates are propagated to all servers in the domain as the changes are carried out.
Offline mode, when updates are carried out only to the domain configuration and applied to each server when it is re-started, the domain configuration is offline.

Setting the domain configuration offline makes it possible to perform a set of configuration updates and apply them the next time a server is restarted. This is used, for example, when doing a rolling upgrade of an installation.

To switch between the domain configuration modes:

In the Change Center pane, click the Switch to Offline Mode button. To switch back from the offline to online mode, click this button again.