9 Setting Up Servers in Signaling and Processing Domains

This chapter describes how to add servers to, and remove servers from, your Oracle Communications Service Controller deployment using the Administration Console and Java MBeans.

Setting Up Servers Using the Administration Console

You can add and remove servers using the Server Configuration screen.

To access the Server Configuration screen:

  1. In the domain navigation pane, expand OCSB and then expand Domain Management.

  2. Select Servers.

Typing a server name into the Filter field displays a filtered list of servers.

Adding a Server to a Domain

Before you add a server to the Domain Configuration, you must install the Service Controller software on that server. See Service Controller Installation Guide for instructions.

To add a server to a domain:

  1. In the Servers List pane, click the New button.

    The Add Server dialog box appears.

  2. Fill in the fields described in Table 9-1.

  3. Click Apply.

Removing a Server from a Domain

Before you remove a server from the Domain Configuration you must stop the server.

To remove a server from the domain:

  1. In the Servers screen, in the list of servers, select the check box corresponding to the server you want to remove.

  2. Click Delete.

Setting Up Servers with Java MBeans

Using DomainServiceMBean, you can add servers to, and remove them from, a domain.

See the following sections for more information:

Adding a Server to a Domain

When you add a server to a domain using Java MBeans, the process of adding the server requires the following:

  1. Specifying properties of the server. For example, you need to define the name of a server, IP address of the system on which the server runs, and ports to be used in different states.

  2. Setting up clustering parameters, if required

  3. Setting up security for the server

To add a server to a domain:

  1. Invoke the following operation of DomainServiceMBean:

    void addManagedServer(String name, String host, int port, int adminPort, int jmxJrmpPort, int jmxRegistryPort)

    Table 9-1 lists the parameters that you need to provide.

    Table 9-1 Server Properties

    Property Description

    name

    The name of the server.

    The name must be unique across all domains.

    Format: alpha-numeric characters. Case-sensitive. No white spaces.

    Do not use white space in the name.

    host

    The host name or IP-address of the system where the server runs.

    Format: alpha-numeric. IP-address format or DNS name format.

    port

    This port setting is deprecated and no longer used.

    It should be set to its default value, -1.

    adminPort

    The IP port to use for the server when it is at SAFE level. This is the port used for configuration when the server is starting up.

    Format: numeric

    jmxJrmpPort

    The port to use for Java Remote Method Protocol (JRMP) invocations to the server.

    Format: numeric.

    JmxRegistryPort

    The port to use for the MBean Server on the server.

    Format: numeric.

  2. If your Service Controller deployment uses well-known addresses to group the Processing Domain and the Signaling Domain, specify how the newly added server distributes events to other servers across the domain boundaries by setting up clustering. See "Setting Up IP Unicast" for more information.

  3. Configure security for the server. See Service Controller Security Guide for more information.

Removing a Server from a Domain

When you remove a server from a domain using Java MBeans, the process of removing the server requires the following:

  1. Stopping the server that you want to remove

  2. Specifying the name of the server that you want to remove

  3. Updating clustering parameters, if required

  4. Uninstalling the software

To remove a server from a domain:

  1. Stop the server that you want to remove by invoking the following operation of ManagementAgentMBean:

    void shutdown()

    See "ManagementAgentMBean" for more information about this MBean.

  2. Invoke the following operation of DomainServiceMBean:

    void removeManagedServer(String name)

  3. If your Service Controller deployment uses well-known addresses to group the Processing Domain and the Signaling Domain, remove it from the domain configuration. To remove a server from the Coherence configuration that uses well-known addresses to group domains, perform the following on all domains:

    1. Identify which UniCastAddress MBean corresponds to the server you are removing by checking the MBean attribute ServerName.

    2. Invoke the operation removeUnicastAddress on the MBean UnicastAddressesMBean.

  4. Uninstall the software from the physical server using Oracle Universal Installer. See Service Controller Installation Guide for information on uninstallation.