WebSphere brand IBM WebSphere IP Multimedia Subsystem Connector, Version 6.2

Installing Diameter Enabler base (Cluster)

Diameter Enabler base is installed into the plugins directory in the WebSphere® Application Server path on each federated node. The installation process includes creating and configuring a template application server for the cluster.

Before you begin
Before you begin, the following software should be installed:
  • A supported version of WebSphere Application Server Network Deployment

    For a list of required WebSphere Application Server fixes, refer to the readme file, WebSpheresoftwareForTelecomReadme.html, on the QuickStart CD.

  • If you require subscribe and notify functions for either Ro or Sh, one of the following databases for storing subscriber notification data:
    • DB2 IBM® DB2® Enterprise Server Edition
    • Oracle Oracle Database
In addition, you should have:
  • Completed the environment preparation steps, which includes unpacking the DHAImsConnectorInstallPackage_6.2.0.tar file into the was_root directory
    Note: was_root is the installation root directory for WebSphere Application Server Network Deployment. By default, this directory is:
    • AIX /usr/IBM/WebSphere/AppServer
    • Linux /opt/IBM/WebSphere/AppServer
    • Solaris /opt/IBM/WebSphere/AppServer
  • Prepared the database
You will need the following files for this installation task:
  • com.ibm.ws.diameter_6.2.0.jar (in was_root/plugins)
  • DiameterChannelInstall.py (in was_root/installableApps/ImsConnector/install)
You will need the following information to complete this task:
  • WebSphere Application Server user name and password. You only need this information if security is enabled.
  • Cell name and node name that will contain the first cluster member.
  • Fully qualified host name that will contain the first cluster member.
  • Port number for the Diameter inbound channel. Port 3868 is the preferred port defined in RFC 3588. You should use this port unless it is already in use.
Tip:
  • To locate your host name and node name, refer to the AboutThisProfile.txt in the following node profile directory:
    • AIX was_profile_root/logs/
    • Linux was_profile_root/logs/
    • Solaris was_profile_root/logs/
    Note: was_profile_root is the directory for a WebSphere Application Server Network Deployment profile called profile_name. By default, this directory is:
    • AIX /usr/IBM/WebSphere/AppServer/profiles/profile_name
    • Linux /opt/IBM/WebSphere/AppServer/profiles/profile_name
    • Solaris /opt/IBM/WebSphere/AppServer/profiles/profile_name

    For example, Custom01 is the name of the federated node's profile which contains the application server diameter0, created below.

  • To locate your cell name, refer to the directory name found in the following location:
    • AIX was_profile_root/config/cells/cell_name
    • Linux was_profile_root/config/cells/cell_name
    • Solaris was_profile_root/config/cells/cell_name
    Where:
    • cell_name is your actual cell name
Important: The combination of port number and IP address must be unique for each cluster member where you plan to install Diameter Enabler base. For horizontal clusters, the same port number should be used as the IP address will be different for each server in the cluster. For vertical clusters with two or more cluster members configured to run on a single physical server with a single IP address, one cluster member can use the default Diameter port number of 3868. The additional cluster members must use different port numbers, such as 3890 or 3891. The IP address is identified as the HostIpAddress in the Web services application properties file, such as Diameter_Sh.properties.
About this task
Complete the following steps to install Diameter Enabler base in a clustered environment:
  1. Add the Diameter Enabler base files to the deployment manager and to each federated node. Complete the following steps:
    Note: If these are on separate machines, repeat these steps for each machine.
    1. Log in to the server where the deployment manager or federated node is installed.
    2. If you have not already done so, unpack the file DHAImsConnectorInstallPackage_6.2.0.tar as described in preparing the environment. Otherwise, open a command prompt and verify that the filecom.ibm.ws.diameter_6.2.0.jar was correctly copied to the plugins directory:
      • AIXLinuxSolaris was_root/plugins
  2. Start the deployment manager.
  3. Start the node agent for each federated node.
  4. Log in to the Integrated Solutions Console:
    1. Open a browser and navigate to the following URL: https://host_name:port/ibm/console.
      Where:
      • host_name is the fully qualified host name of the server where the application or the network deployment manager is deployed.
      • port is the secured port used to access the console. The default port is 9043.
      Note: The default unsecured port is 9060. If you use 9060, you must have "http" instead of "https" in the URL.
    2. Enter an administrator user ID and password. (Omit the password if security is not enabled.)
    3. Click Log in.
  5. Create an application server named diameter0. This application server will serve as the first cluster member and as a template for creating additional cluster members.
    1. In the navigation panel, click Servers > Application servers.
    2. Click New.
    3. Select the federated node where you want the new server created.
    4. Type diameter0 for the Server name, and click Next.
    5. Select default for the server template, and click Next.
    6. Select Generate Unique Ports, and click Next.
    7. Click Finish.
    8. Click Save to save changes to the master configuration. You should see the following message: The configuration synchronization complete for cell.
    9. Click OK.
  6. Configure the Diameter channels. Run the following command from the deployment manager profile directory:
    Important: Enter the following parameters on a single line.
    • AIXLinuxSolaris was_profile_root/bin/wsadmin.sh -username user_name -password password -f script_path/DiameterChannelInstall.py cell_name node_name diameter0 host_name port_number cluster [debug]
    Where:
    • user_name represents your WebSphere Application Server user ID. This parameter is required if security is enabled.
    • password represents the password associated with your user_name. This parameter is required if security is enabled.
    • script_path represents the path to DiameterChannelInstall.py. After the unpack operation, script_path is was_root/installableApps/ImsConnector/install.
    • cell_name represents the name of cell where diameter0 is installed
    • node_name represents the name of node where diameter0 is installed
    • diameter0 indicates the name of the application server
    • host_name represents the fully qualified host name the Diameter TCP channel will bind to. To specify any host name, type "*" (including the quotes) for the value.
    • port_name represents the port number for the Diameter inbound TCP channel, 3868 preferred
    • cluster indicates that the script is running in a clustered environment
    • debug enables debugging for the configuration script (optional)



Terms of use
(C) Copyright IBM Corporation 2009. All Rights Reserved.