WebSphere brand IBM WebSphere IP Multimedia Subsystem Connector, Version 6.2

Installing Diameter Enabler base (Standalone)

Diameter Enabler base is installed into the plugins directory in your WebSphere® Application Server Network Deployment path. The installation process includes minor configuration steps necessary to run the Diameter Enabler base.

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 where the WebSphere Application Server server is installed; the default server is server1.
  • Fully qualified host name where the node is installed.
  • 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, AppSrv01 in a standalone environment.

  • 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
About this task
Complete the following steps to install the Diameter Enabler base:
  1. Log in to the server where WebSphere Application Server is installed.
  2. If you have not already done so, unpack the DHAImsConnectorInstallPackage_6.2.0.tar file as described in preparing the environment. Otherwise, open a command prompt and verify that the file com.ibm.ws.diameter_6.2.0.jar was correctly copied to the plugins directory:
    • AIXLinuxSolaris was_root/plugins
  3. Start the application server.
  4. Configure the Diameter channels. Run the following command:
    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 server_name host_name port_number standalone [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 the server is installed
    • node_name represents the name of node where the server is installed
    • server_name represents the name of the application server where you are installing Diameter Enabler base
    • 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
    • standalone indicates that the script is running in a standalone environment
    • debug enables debugging for the configuration script (optional)
  5. Stop the server where you have installed Diameter Enabler base.
  6. Start the server.



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