Skip Headers
Oracle® Communications Services Gatekeeper Installation Guide
Release 5.0

Part Number E16615-02
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

5 Configuring the Domain for Oracle Communications Services Gatekeeper

This chapter describes how to use the Oracle Communications Services Gatekeeper domain configuration tools to set up Oracle WebLogic Server for use with Oracle Communications Services Gatekeeper. It covers:

Before you follow the instructions in this chapter to configure a domain, you should have:

Understanding Service Gatekeeper Domain Configuration

In order to run Oracle Communications Services Gatekeeper, its container, Oracle WebLogic Server, must be given basic information about the various parts of the system. This is called configuring the domain. A domain is the basic administrative unit in Oracle WebLogic Server. It consists of an Administration Server and, usually, one or more Managed Servers, which may be associated into clusters.

Figure 5-1 Oracle WebLogic Domains

Surrounding text describes Figure 5-1 .

The Administration Server provides a central point for managing the domain and providing access to the Oracle WebLogic Server administration tools.

A single Oracle WebLogic Server instance can function as both the Administration Server and a Managed Server, depending on the needs of the installation. For example, developers creating communication service extensions using the Platform Development Studio commonly might run both the Administration Server and Managed Servers on a single machine.

Managed Servers are often grouped together into clusters. Clusters are groups of server instances that work together to provide scalability and high availability. Clusters improve performance and provide failover should a server instance become unavailable. The servers within a cluster can run on the same machine, or they can reside on different machines. To the client, a cluster appears as a single Oracle WebLogic Server instance.

Figure 5-2 Initial Server Instances Added to Clusters

Surrounding text describes Figure 5-2 .

Managed Servers, or the clusters into which they are linked, host application components - in this case, the communication services - and resources, which are also deployed and managed as part of the domain. In Figure 5-3 below, the applications (wlng_nt_communication-service-name#4.1 and wlng_nt_communication-service-name#4.1) are assigned to the two clusters (WLNG_NT_Cluster and WLNG_AT_Cluster). But each Network Tier server (WLNG_NT1 and WLNG_NT2) must have its own JMS resources, so they are shown per server.

Figure 5-3 Managed servers/clusters host applications and resources

Surrounding text describes Figure 5-3 .

Each server instance is also assigned to a Machine, a logical representation of actual hardware. The Machine representation is used by the Administration Server to start and stop remote servers using the Node Manager. Multiple server instances can run in a single Machine.

Figure 5-4 Servers are assigned to Machines

Surrounding text describes Figure 5-4 .

For more information on Oracle WebLogic Server domains, see “Introduction” and the following sections in Oracle Fusion Middleware Creating Domains Using the Configuration Wizard at:

http://download.oracle.com/docs/cd/E15523_01/web.1111/e14140/toc.htm

All servers must have their domains configured. You can either use one of the methods below to manually configure each server in your installation, or you can configure the domain on your Administration server and then use the pack and unpack commands provided by WLS to package the configuration data for copying to all the other servers. For more information on pack and unpack, see “Overview of the Pack and Unpack Commands” in Oracle Fusion Middleware Creating Templates and Domains Using the Pack and Unpack Commands at:

http://download.oracle.com/docs/cd/E15523_01/web.1111/e14144/intro.htm

The scripts themselves are located in the common/bin directory. In the default installation, this would be Services_Gatekeeper_Home\wlserver_10.3\common\bin.

Configuring a Domain With the Graphical Mode Configuration Wizard

Use the following instructions explain how to use the Services Gatekeeper GUI-based Configuration Wizard to configure Oracle WebLogic Server for Oracle Communications Services Gatekeeper.

To do so, the console attached to the domain configuration system must support a Java-based GUI. All consoles for Windows systems support Java-based GUIs, but not all consoles for UNIX/Linux systems do. If you attempt to start the configuration program in graphical mode on a system that cannot support a graphical display, the configuration program automatically starts console-mode installation.

Configuring a Domain with the GUI Configuration Wizard - Windows

You can start the Configuration Wizard in graphical mode from either the Windows Start menu or from the command line.

  • To start the GUI Configuration Wizard from the Windows Start menu, choose the Configuration Wizard option from the BEA program group in the Windows Start Menu:

    Start->Programs->Oracle Communications Services Gatekeeper 5.0-> OCSG 5.0->Tools->Configuration Wizard 
    

    Note:

    If you have used the GUI-based installer, and the Run Quickstart box is checked in the Installation Complete window, the Quickstart window opens automatically. Simply click Start Domain Configuration Wizard to launch the Wizard.

    See the Configuring Domain Settings section for details on how to fill in the domain settings.

  • To start the GUI Configuration Wizard from the command line:

    1. Log in to the target system

    2. Open a command prompt window

    3. Go to the Middleware_Home\common\bin subdirectory. For example:

      cd c:\Middleware_Home\wlserver_10.3\common\bin

    4. At the prompt, type config and press Enter.

    5. The Configuration Wizard starts in graphical mode and the Welcome screen appears. See the Configuring Domain Settings section for details on how to fill in the domain settings.

      Note:

      You can also use Explorer to find the config.cmd file in c:\Middleware_Home\wlserver_10.3\common\bin, and simply double-click it.

Configuring a Domain with the GUI Configuration Wizard - UNIX/Linux

To start the GUI Configuration Wizard on a UNIX/Linux system:

  1. Log in to the target system

  2. Open a command shell window

  3. Go to the /common/bin subdirectory. For example:

    cd Services_Gatekeeper_Home/wlserver_10.3/common/bin

  4. Invoke the following script:

    sh config.sh

  5. The Configuration Wizard starts in graphical mode and the Welcome screen appears. See the Configuring Domain Settings section for details on how to fill in the domain settings.

Configuring Domain Settings

This section assumes that you have followed the instruction in either Configuring a Domain with the GUI Configuration Wizard - Windows or Configuring a Domain with the GUI Configuration Wizard - UNIX/Linux and launched the GUI Configuration Wizard and have the Welcome screen. The GUI Configuration Wizard screens prompt you to enter specific information about your system and configuration. For instructions on responding to the prompts during installation, see the following sections.

To complete this section you need the name of the database name, database instance name, any listening port numbers, and the name and password of a database user to use. Services Gatekeeper domains require this connection information.

Note:

If you are going to be using any CORBA-based functionality that in one way or another connects to a machine other than your own, you should not use the value “localhost” in any of your configuration choices.

Welcome Screen - Create or Update a WebLogic Domain

  1. Do one of the following:

    • Select the Create a new WebLogic domain ratio button to create a new domain.

    • Select the Extend an existing WebLogic domain to extend an existing domain with additional components.

  2. Click Next to proceed with the installation.

    You may cancel the installation at any time by clicking Exit and you may go back to a previous window by clicking Previous.

Select Domain Source Screen

  1. Select the Generate a domain configured automatically to support the following products radio button. This option offers you these standard options for pre-configured domains based on popular products and options:

    Select the appropriate template depending on your needs:

    • Basic Oracle Communications Services Gatekeeper Domain

      Creates an all-in-one domain, with the Access and Network Tier and the Administration Server all on a single machine. This configuration is common for development machines.

    • OCSG Basic HA configuration

      Creates a basic domain with two servers, each with an AT and an NT instance and a database. This configuration can be expanded later in the process.

    • OCSG Domain with Access and Network Clusters

      Creates a basic distributed domain, with a two instance Access cluster and a two instance Network cluster. This configuration can be expanded later in the process.

    • OCSG Domain with Access and Network Clusters with Oracle RAC Configuration

      Creates a basic distributed domain, with a two instance Access cluster and a two instance Network cluster. This configuration can be expanded later in the process. It also creates the additional data sources required for use with an Oracle RAC based installation.

    • OCSG OSB Integration Configuration

      Creates a domain for integration with Oracle Service Bus (OSB), using the Service Oriented Architecture (SOA) Facade. If you are using this template, you need additional special information. Please look in Installing SOA Facades for this information.

Specify Domain Name and Location Screen

  1. Accept the default domain name or create a new name in the Domain Name text box.

  2. Accept the default domain location or click the Browse button to change the location.

  3. Click Next to save your changes and continue.

Configure Administrator User Name and Password Screen

  1. Specify the main Administrative user in the Name text box.

    This name is used to boot the Administration Server and connect to it. For setup and testing, Oracle suggests that you use weblogic. User names are case sensitive. Do not use commas or any characters in the following comma-separated list:

    \t, < >, #, |, &, ?, ( ), { }
    
  2. Specify the password for the Administrative user in the User password text box.

    The password must contain a minimum of eight case-sensitive characters, at least one of which is not alphabetic.

  3. Re-enter the password in the Confirm user password text box.

  4. (Optional) Enter an informal description for this username in the Description text box.

  5. Click Next to save your changes and continue.

Configure Server Startup Mode and JDK Screen

  1. On the left side of the window, select the appropriate startup mode for your installation:

    • Development Mode

    • Production Mode

    Note: If you select Production Mode, you should not enable SSL unless you have a trusted key. For more information on startup modes, see “Development vs. Production Mode Default Tuning Values” in Oracle Fusion Middleware Performance and Tuning for Oracle WebLogic Server at:

    http://download.oracle.com/docs/cd/E15523_01/web.1111/e13814/wls_tuning.htm

  2. On the right side of the window, select the Available JDKs radio button.

  3. Highlight the appropriate JDK.

  4. Click Next to save your changes and continue.

Configure JDBC Data Sources Screen

This screen appears if you are installing a non-RAC based Gatekeeper.

Use this screen to specify connection information between Services Gatekeeper and the JDBC data sources (databases). A JDBC data source contains a pool of database connections that are created when the data source instance is created - when it is deployed or targeted, or at server startup. Applications look up a data source on the JNDI tree, and then request a connection.

  1. Configure wlng.datasource, wlng.localTX.datasource, and wlng.localTX.datasource.

    Select the wlng.datasource, wlng.localTX.datasources, and (for SOA domains) wlng.localTX.datasource check boxes to configure these data sources simultaneously. To configure these data sources separately, make adjustments in the data source for the transactional data source.

    Typically, fields you may need to edit include:

    • Vendor: Select the database vendor from the list; the default is Oracle.

    • Driver: Select the driver for your database type from the list; the default is Oracle's Driver (Thin) for Instance connections. Non-RAC domains need to use the non-XA thin driver for wlng.localTX.datasource.

    • Username: The Oracle Communications Services Gatekeeper user name you created when you installed the database. The default is SETME_DBUSER.

    • Password: The Oracle Communications Services Gatekeeper password you created when you installed the database (it is not be echoed on the screen).

    • DBMS/Service: Enter name of the database you created in Installing the Database; the default is SLEE_DB.

    • Host Name: Where the database is located; the default is localhost.

    • Port: Enter the port number for contacting the database. For Oracle, the default is 1521. For MySQL, the default is 3306.

    • Configure selected data sources as RAC multi data sources in the next panel. Check this check box if you are using Real Application Cluster features.

  2. Click Next to save your changes and continue.

  3. The Test JDBC Data Sources screen appears and automatically tests your data source configurations.

    A green check displayed in the Status column indicates that the configuration is valid. A red circle and slash indicates a problem. To correct any problems, click Previous to return to the Configure JDBC Data Sources screen and make the necessary changes and Click Next. When the Test JDBC Data Sources screen reappears, click Test Connections to retest the configurations.

(As Needed) Configure RAC Multi-Data Sources

If you checked the Configure selected data sources as RAC multi data sources in the next panel box in the Configure JDBC Data Sources screen, this screen appears next. Follow these steps to configure JDBC data sources:

  1. Check the boxes next to wlng.datasource, wlng.TX.datasources and (if applicable) wlng.localTX.datasource to configure them all at the same time.

  2. Enter the service name of a database to connect to in the Service Name text box.

  3. Enter a database user account name in the Username text box.

  4. Enter the password for the user account password in the Password text box.

  5. Enter the IP address or DNS name of the server that hosts the database in the Host Name field.

  6. Enter the database name in the Instance Name text box. Naming schemes vary by database.

  7. Enter a port on which the database listens for connection requests in the Port text field.

  8. Click Add to add the data source.

  9. Add as many data sources as you need. Typically only one is configured per database.

  10. Click Next to save your changes an continue to the next screen.

Select Optional Configuration Screen

Leave these boxes unchecked to accept the default values for the se options. These settings are described in the Optional Configuration Screens section.

RAC domains require that you at least configure an administration server using the Configure the Administration Server (Administration Server Screen) section

Configuration Summary Screen

Displays the domain details. Use the Summary View drop-down list to choose a category view to use. The options vary with your configuration and my include:

  • Deployment

  • Application

  • Service

  • Cluster

  • Machine

  • JDBC Multi Data Source

  • JMS Server

Click Create to accept the domain details and start creating the domain.

Optional Configuration Screens

The following sections explain how to configure options for the Optional Configuration screens. A few of these settings are required for certain domain configurations.

Configure the Administration Server (Administration Server Screen)

  1. Replace AdminServer with the name of your administration server in the Name text box.

  2. Replace host-admin.bea.com with the IP address or DNS name of your administration server in the Listen address text box.

  3. Replace 7001 with a port5number on you r administration server to use as a listening port. in the Listen Port text box.

  4. (Optional) Enter a port number to use as an SSL listening port in the SSL listen port text box.

  5. (Optional) check the SSL enabled check box to use SSL.

    Do not enable SSL unless you have a trusted key.

  6. Click Next to save your changes and continue.

JMS Distribution Destination (Select JMS Distributed Destination Type Screen)

  1. Select Uniform distribution Destination (UDD) or Weighted Distributed Destination (WDD) settings for each of your JSM system resources.

    See the screen text for more information.

  2. Click Next to save your changes and continue.

Managed Servers, Clusters and Machines (Configure Managed Servers Screen)

Use this window to add or change connection information for Managed Servers. Each Managed Server is an instance of WebLogic Server. Some information may already be filled in.

  1. Change the Listen address of each of your servers, based on your installation values. You can add Managed Server instances at this time. (You can also do this using the Administration Console at any time.).

    Note: The Listen address and Listen port per server combination must be unique. The values for the Listen address can include alphanumeric characters, dots [.], and dashes [-] only.

  2. Replace 7001 with a port5number on you r administration server to use as a listening port. in the Listen Port text box.

  3. (Optional) Enter a port number to use as an SSL listening port in the SSL listen port text box.

  4. (Optional) check the SSL enabled check box to use SSL.

    Do not enable SSL unless you have a trusted key

  5. Click Next to save your changes and continue.

  6. When finished, configure the new system by returning to the Select Optional Configuration screen, checking the Deployments and Services checkbox, and then clicking Next.

    The Target Deployments to Clusters or Server screen appears. See "Deployments and Services (Target Deployments to Clusters or Server Screen)" for details.

Deployments and Services (Target Deployments to Clusters or Server Screen)

  1. Assign services to servers or clusters

    This window does not appear if you selected Create Oracle Communications Services Gatekeeper Basic Domain.

    Use this window to add any additional Managed Servers you listed in the Configure Managed Servers window to clusters configured in the Configure Clusters window. Select the appropriate cluster in the right pane, the appropriate Managed Server in the left pane, and assign them to each other by clicking the right arrow button.

  2. Configure Machines/Configure Unix Machines

    Use this window to add or change information about Machines. In the context of WebLogic Server, a Machine is the logical representation of the system that hosts one or more WebLogic Server instances, for the purposes of starting and stopping remote servers using the Node Manager. In a domain, machine definitions identify a particular, physical piece of hardware and are used to associate a computer with the Managed Servers it hosts.

    For more information about the various fields, see “Configuring Machines” in Oracle Fusion Middleware Creating Domains Using the Configuration Wizard at:

    http://download.oracle.com/docs/cd/E15523_01/web.1111/e14140/custom.htm

    Click Next to continue.

  3. Assign Servers to Machines

    This window does not appear if you selected Create Oracle Communications Services Gatekeeper Basic Domain

    Use this window to assign Servers (either Administration or Managed) to their appropriate Machines, if necessary. Select the appropriate Machine in the right pane and the server(s) in the left pane and assign them to each other by clicking the right arrow button.

    Click Next to continue.

RDBMS Security Store (Configure RDBMS Security Store Database Screen)

  1. Select a Database Type from the drop-down list.

  2. A driver is automatically entered in the Driver text box. If necessary, select another driver from the drop-down list.

    The correct Class Name for the driver is automatically filled in.

  3. Enter a database session identifier in the DBMS SID text box.

  4. Enter a database name in the DBMS Host text box.

  5. (As needed) Replace the default port number in the DBMS Port text box.

  6. Enter a DBMS administrator user name in the User Name text box.

  7. Enter a password for the DBMS administrator in the User Password text box.

  8. Confirm the password.

  9. Add any required items to the Additional Properties text box.

  10. Click Next to save your changes and continue.

Using the Console Configuration Wizard

Use the following instructions if you wish to use the Console-based Configuration Wizard to configure Oracle WebLogic Server for Oracle Communications Services Gatekeeper. Specific instructions on launching the Wizard by platform are found after the next section.

The Console Configuration Wizard Interface

The Console Configuration Wizard is designed to mimic as closely as possible the choices available in the GUI version, but in a completely text-based form. The following images give you a sense of the way the Console Screen displays certain types of workflow choices.

Most Console Configuration Wizard screens have the same pattern: the top of the screen indicates what is being configured; the center of the screen indicates the range of options; and the bottom of the screen prompts for user input.

Figure 5-5 Select Options

Surrounding text describes Figure 5-5 .

In Figure 5-5 above, the top of the current screen is marked by the Oracle Communications Services Gatekeeper Wizard banner. The top part of the screen displays the set of configuration parameters that can be set - in this case, configuration information for Managed Servers. The center of the screen indicates the range of options - in this case, Add a server, Modify a server, or Delete a server. The bottom part of the screen prompts for the user input that is available in this screen - in this case

Enter option number to select or [Exit][Previous][Next]>

Here you can either enter an option (indicated by number) or use one of the standard navigation commands. In this case, option 1, Add a server, has been chosen. Confirm the entry by pressing the Enter key:

Figure 5-6 Add a Managed Server

Surrounding text describes Figure 5-6 .

In Figure 5-6, the bottom of the screen displays the user input prompt:

Enter name for a new OR [Exit][Previous][Next]>

The name for the new Managed Server to be added, WLNG_NT3, has been filled in. Again the input is confirmed by pressing the Enter key.

Figure 5-7 Finish Work on the Selected Item

Surrounding text describes Figure 5-7 .

In Figure 5-7 the new Managed Server, WLNG_NT3, has been added. Note the right arrow (->) next to the new Server's name. This indicates that this is the selected item, and that any options chosen will affect that item. To finish with this server and select another item in the list, enter 5 - Done and the Enter key.

Launch the Console Configuration Wizard - Windows

To start the Console Configuration Wizard:

  1. Log in to the target system

  2. Open a command prompt window

  3. Go to the Services_Gatekeeper_Home\common\bin subdirectory. For example:

    cd c:\Services_Gatekeeper_Home\wlserver_10.3\common\bin

  4. At the prompt, type config -mode=console and press Enter.

  5. The Configuration Wizard starts in console mode.

Launch the Console Configuration Wizard - UNIX/Linux

To start the Console Configuration Wizard:

  1. Log in to the target system

  2. Open a command shell window

  3. Go to the /common/bin subdirectory. For example:

    cd c:\Services_Gatekeeper_Home\wlserver_10.3\common\bin

  4. Invoke the following script:

    sh config.sh -mode=console

  5. The Configuration Wizard starts in console mode

Create Your Domain

To create your domain, respond to the prompts in each section by entering the number associated with your choice, pressing Enter, or typing next (or n) to accept the current selection. For information on the different options see the Configuring Domain Settings section. The screen names are the same for both the Graphical and Console Domain Configuration Wizards.

Note:

If you are going to be using any CORBA based functionality that in one way or another connects to a machine other than your own, you should not use the value “localhost” in any of your configuration choices.

The right arrow (->) indicates the value currently selected. To quit the Configuration Wizard, enter Exit in response to any prompt. To review or change your selection, enter Previous at the prompt.

Instead of typing complete words when you want to enter [Exit], [Previous], and [Next], you can use the following one-letter shortcuts: x, p, and n, respectively.

Configuring a Domain with Oracle WebLogic Scripting Tool Scripts

This section explains how to monitor and manage Oracle WebLogic Server instances and domains using the Oracle WebLogic Scripting Tool (WLST) instead of the Configuration Wizard GUI.

The WLST scripting environment is based on the Java scripting interpreter, Jython. For more general information on WLST, see “Introduction and Roadmap” in Oracle Fusion Middleware Oracle WebLogic Scripting Tool at: http://download.oracle.com/docs/cd/E12839_01/web.1111/e13715/intro.htm

Caution:

WLST is a powerful, flexible tool, and has a significant learning curve associated with its effective use. If you do not know how to use WLST and do not wish to spend the time to become familiar with it, consider using one of the Configuration Wizards to set up your domains instead.

Set Up Your Environment

You must set a number of environment variables for WLST to run properly. To simplify this, the Oracle Communications Services Gatekeeper installer provides shell/cmd scripts that must be run before WLST is invoked. The scripts are located in Services_Gatekeeper_Home/wlserver_10.3/server/bin. There are both setWLSEnv.sh and setWLSEnv.cmd versions available. It is usually enough simply to run the appropriate script, but some shells may require using source, as in:

source Services_Gatekeeper_Home/wlserver10.3/server/bin/setWLSEnv.sh

If this still does not work, you may need to change shells. There have been some issues reported with bash, particularly on HPUX machines. If you are having problems with your shell, change to an sh shell before running the script.

Choose from the Provided Scripts

Oracle Communications Services Gatekeeper provides five WLST scripts to set up your environment. The scripts are located in the Services_Gatekeeper_Home/wlserver10.3/common/templates/scripts/wlst/ directory:

  • basic-ocsg-ha.py uses the domain template basic-ocsg-ha-domain.jar for its basic setup. This creates a domain with two servers, each with an AT and an NT instance and a database. Database replication must be set up separately.

  • ocsg-cluster.py uses the domain template ocsg-domain.jar for its basic setup. This creates an all-in-one domain typical of development environments.

  • access-network-cluster.py uses the domain template ocsg-access-network-domain.jar for its basic setup. This creates a domain with separate Access and Network clusters.

  • access-network-rac-cluster.py uses the domain template ocsg-access-network-rac-domain.jar for its basic setup. This creates a domain with separate Access and Network clusters with the additional data sources that a RAC installation requires.

  • ocsg-osb-integ.py uses the domain template ocsg-osb-integ-domain.jar for its basic setup. This creates a domain for integration of Oracle Communications Services Gatekeeper with Oracle Service Bus.

If you are configuring an HP-UX installation, you must run the script using the -Djava.security.egd flag. For example, you would invoke the basic-ocsg-ha.py script by typing:

java -Djava.security.egd=/dev/random weblogic.WLST basic-ocsg-ha.py

Edit the Scripts

  • The wlng-cluster.py script sets up a development machine, use this script as is.

  • If you are using one of the other four scripts, you must set a few variables found at the top of the script, and, in some situations, edit a few other values. See the Configure Multi-cluster Settings section for details.

  • If you are using one of the two other scripts and you also wish to create additional servers, you must make more complex edits. See the Adding Servers to a Multi-cluster Configuration section.

  • If you wish to prevent communication services from ever being deployed, you may edit whichever script you are using. See Keep unused communication services from being deployed.

    It is also possible to remove communication services after the initial deployment. See the System Administrator's Guide for information on accomplishing this.

Configure Multi-cluster Settings

If you are setting up the standard version of one of the multi-cluster domains, only a few variables need to be set at the top of the script, in the section called Configuration (INPUT) Parameters.

Example 5-1 The Configuration (INPUT) Parameters Section from Access-Network-rac.py

#=========================================================================
# Configuration (INPUT) Parameters
#=========================================================================

# listen address input parameters
# example: hostname can be DNSName or IPAddress

AdminServerListenAddress = "host-admin.bea.com"
AdminServerListenPort    =  7001
NT1ServerListenAddress   = "host-nt1.bea.com"
NT1ListenPort            =  8001
NT2ServerListenAddress   = "host-nt2.bea.com"
NT2ListenPort            =  8001
AT1ServerListenAddress   = "host-at1.bea.com"
AT1ListenPort            =  8001
AT2ServerListenAddress   = "host-at2.bea.com"
AT2ListenPort            =  8001

NTClusterAddress         = "host-nt1.bea.com:8001,host-nt2.bea.com:8001"
ATClusterAddress         = "host-at1.bea.com:8001,host-at2.bea.com:8001"

NTClusterMultiCastAddress = '237.0.0.101'
NTClusterMultiCastPort    = 8050
ATClusterMultiCastAddress = '237.0.0.102'
ATClusterMultiCastPort    = 8050

# DataSource Settings

# RAC Node-1 Settings

RACNode1URL      = "SETME_URL"

# RAC Node-2 Settings

RACNode2URL      = "SETME_URL"

# Database settings

OracleXADriver    = "SETME_XADRIVER"
OracleNonXADriver = "SETME_nonXADRIVER"
DBUser            = "SETME_USER"
DBPassword        = "SETME_PASSWORD"
Make these edits to Configure a Multi-cluster Domain
  1. Set the Listen Address and Listen Port for the Administration Server, the two Access Tier servers, and the two Network Tier servers.

  • Replace the host*.bea.com values with either the DNS name or the IP Address of the appropriate servers.

  • Replace the Listen Port values as necessary. The Listen Address:Port combinations must be unique.

  1. Fill in the appropriate Listen Address:Port combinations to assign the servers to the appropriate clusters. The entry should be comma delimited, with no spaces.

  2. Fill in the appropriate Multicast Addresses per cluster.

  3. Set the appropriate URLs for each of the RAC instances (only in RAC scripts)

  4. Set the appropriate values for the transactional (XA) and localTX(nonXA) datasources (in RAC scripts).

    Set the appropriate values for the wlng.datasource (in non-RAC scripts)

  5. Set the appropriate values for the wlng.localTX.datasource. The values should be non-XA (only in non-RAC scripts).

    The following change may also need to be made:

  6. If you want to be able to use the Administration Console and Node Manager to start remote servers, you must change the NodeManager ListenAddress values in the Configure Managed Servers section. To do so edit the following line for each managed server

    set('ListenAddress','localhost')

    to change localhost to the correct ListenAddress.

  7. The default domain user is weblogic and the default password is weblogic123. You can modify these values in the script.

Adding Servers to a Multi-cluster Configuration

If you want to use the WLST script to set up a multi-cluster domain and, at the same time, to add additional servers, first make the edits in the Configure Multi-cluster Settings section. Then make the following additional edits listed in this section. The specific edits depends on how your particular installation is set up.

WLST in offline mode, which is the mode that Oracle Communications Services Gatekeeper scripts use, can access and update only those configuration objects that have been previously persisted to a configuration file. All the provided WLST scripts create this configuration file automatically as they run, but each adds only those objects that are specified in the domain templates. If you need to add more configuration objects, such as additional Managed Servers or Machines, you must add statements to the script to create them before you can configure them.

You can also add servers and machines using the Administrative Console GUI after you set up your core domain. This is a simpler way of accomplishing the same goal.

Create Machines

For example, if you need to add additional Machines, you must create them in the script before you assign Managed Servers to them.

Table 5-1 Code to Create Additional Machines

Comment Section Code to add Value

Configure managed servers

cd('/')

create('new_Machine_5','Machine')

cd('Machine/new_Machine_5')

create('new_Machine_5','NodeManager')

Add as many of these statements as you need, replacing new_Machine_5 with whatever value is appropriate


Create Managed Servers

After you create the Machine, you can assign Managed Servers to them. You can also add new Managed Servers. In the code below, the new Managed Server WLNG_NT3 is created and then assigned to new_Machine_5, created above.

Table 5-2 Code to Create Additional Managed Servers

Comment Section Statement to edit Value

Configure managed servers

cd('/')

create('WLNG_NT3', 'Server')

cd('Server/WLNG_NT3')

set('ListenPort', 8001)

set('ListenAddress', 'myserver5')

set('Machine','new_Machine_5')

Create new servers as needed, and set the ListenAddress


Set NodeManager Listen Address

You must also add a section to configure any new Machine (and its Node Manager) being added.

Table 5-3 Setting Listen Address for Node Manager

Comment Section Statement to add Value

Configure managed servers

cd('/')

cd('Machine/new_Machine_5')

set('Name','new_Machine_5')

set('Address','new_Machine_5')

cd('NodeManager/new_Machine_5')

set('ListenAddress','myserver5')

set('ListenPort',5556)

One section per added Machine.


Assign New Managed Servers to the appropriate cluster

You must assign any newly-created managed servers to their appropriate cluster by adding an “assign server” line.

Table 5-4 Assigning New Managed Servers

Comment Section Statement to add Value

Configure a cluster and assign the Managed Servers to that cluster.

cd('/')

[standard]

assign('Server', 'WLNG_NT3','Cluster','WLNG_NT_Cluster')

One line per added Managed Server.


Keep unused communication services from being deployed

It is always possible to remove communication services after the initial deployment of Services Gatekeeper. If you know that your installation is not using one or more communication services and you prefer that they not be deployed at all in your system, you can add the following information to your configuration script. Remember that all communication services consist of two EAR files, an Access Tier version and a Network Tier version. You will need to address both files to completely remove the communication service.

For example, to keep the PX 3.0 Third Party Call communication service from being deployed, add the following to your script:

#===================================================================
# Unassign applications to target
#===================================================================
cd('/')
unassign('Application', 'wlng_at_third_party_call_px30#4.0 ', 'Target', 'WLNG_AT_Cluster')
unassign('Application', 'wlng_nt_third_party_call_px30#4.0 ', 'Target', 'WLNG_NT_Cluster')

Run the Script

Once you have made all necessary changes to the script, run it using the following command:

java weblogic.WLST <appropriate-version>.py

Where to Go From Here

You must now:

See Completing Post-Installation for more information.