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:
IBM® DB2® Enterprise
Server Edition
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:
/usr/IBM/WebSphere/AppServer
/opt/IBM/WebSphere/AppServer
/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.
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:
- 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.
- Log in to the server where the deployment manager or
federated node is installed.
- 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:
- Start the deployment manager.
- Start the node agent for each federated node.
- Log in to the Integrated Solutions Console:
- 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.
- Enter an administrator user ID and password. (Omit the password if security is
not enabled.)
- Click Log in.
- 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.
- In the navigation panel, click .
- Click New.
- Select the federated node where you want the new server
created.
- Type diameter0 for the Server
name, and click Next.
- Select default for the server
template, and click Next.
- Select Generate Unique Ports,
and click Next.
- Click Finish.
- Click Save to save changes to
the master configuration. You should see the following
message: The configuration synchronization complete for cell.
- Click OK.
- Configure the Diameter channels. Run the following command from the deployment manager profile
directory:
Important: Enter the following
parameters on a single line.


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)