test

Sun GlassFish Communications Server Diameter Adapter 1.0 Installation and Quick Start Guide

Chapter 1 Installing the Diameter Adapter

Diameter is a networking protocol for authentication, authorization, and accounting (AAA). Many internet providers use AAA before allowing users to connect to their networks. Sun GlassFishTM Communications Server Diameter Adapter 1.0 integrates the Diameter stack into Communications Server.

Diameter Adapter is available to Sun customers as a patch on SunSolve. A Diameter installer and a README file are included in the patch.

This chapter provides instructions for installing Diameter Adapter to an existing installation of Communications Server. The following topics are addressed:

For information on requirements, support, and known issues, see Sun GlassFish Communications Server Diameter Adapter 1.0 Release Notes.

Installing Diameter Adapter on a Single Instance

This section provides instructions for installing Diameter Adapter on a single instance of Communications Server.

ProcedureTo Install Diameter Adapter on a Communications Server Instance

Before You Begin

Communications Server must be installed before attempting to install the Diameter Adapter software.

  1. Download the Diameter Patch from SunSolve.

    You must be a registered Sun customer to access SunSolve.

  2. Extract the .zip file to a location of your choice.

    The .zip file includes an installer JAR file and a README file.

  3. Navigate to the bin directory of your Communications Server installation.


    cd as-install/bin

  4. Stop the Communications Server domain if it is running.


    asadmin> stop-domain domain_name

  5. Run the Diameter Adapter installer.


    asadmin> install-addon path_to_installer_jar

    The Licensing page is displayed.

  6. Accept the license to start the installation.

    When installation is complete, a message similar to the following is displayed:


    Installation of the addon SunDiameter completed.
CLI207 The installation of the addon /home/user1234/
SunDiameter_installer.jar completed.

  7. Start the domain.


    asadmin> start-domain domain_name
Next Steps

For configuration instructions, proceed to Configuring Diameter for Communications Server.

Installing Diameter Adapter on Multiple Instances

This section provides instructions for installing Diameter Adapter on multiple instances of Communications Server.

ProcedureTo Install Diameter Adapter on Multiple Communications Server Instances

Before You Begin

If you are using an existing domain, that domain must support clustering.

  1. Create the domain if not already created.

    You can use the create-domain(1) command. Be sure the domain supports clustering.

  2. Download the Diameter Patch from SunSolve.

    You must be a registered Sun customer to access SunSolve.

  3. Extract the .zip file to a location of your choice.

    The .zip file includes an installer JAR file and a README file.

  4. Navigate to the bin directory of your Communications Server installation.


    cd as-install/bin

  5. Stop the Communications Server domain if it is running.


    asadmin> stop-domain domain_name

  6. Run the Diameter Adapter installer.


    asadmin> install-addon path_to_installer_jar

    The Licensing page is displayed.

  7. Accept the license to start the installation.

    When installation is complete, a message similar to the following is displayed:


    Installation of the addon SunDiameter completed.
CLI207 The installation of the addon /home/user1234/
SunDiameter_installer.jar completed.

  8. Start the domain.


    asadmin> start-domain domain_name

  9. Start the database.


    asadmin> start-database

  10. Create new instances.

    The new instances can be located on the same machine as the DAS or on different machines.

  11. To apply the Diameter service to a cluster, do the following:

    1. If not already created, create a cluster by using the create-cluster(1) command.

      For example:


      asadmin> create-cluster diameter-cluster
Command create-cluster executed successfully.

    2. Create the Diameter service for that cluster by using the create-diameter-service(1) command.

      For example:


      asadmin> create-diameter-service diameter-cluster
Command create-diameter-service executed successfully.

    3. Create instances for the cluster by using the create-instance(1) command.

      Because the Diameter service is enabled at the cluster config level, instances automatically inherit the Diameter service feature. However, some custom properties (required for Diameter stack initialization) pertaining to the instance host address must be created explicitly while creating the instances. The hostname can be specified in IP address format as well.

      Specify DIAMETER_TCP_ADDRESS and DIAMETER_SSL_ADDRESS as the instance_hostname by using the --systemproperties option.

      For example:


      asadmin> create-instance --nodeagent nodeagent_name --cluster cluster_name 
--systemproperties DIAMETER_TCP_ADDRESS=instance_hostname
:DIAMETER_SSL_ADDRESS=instance_hostname instance_name
      Note –

      If you did not specify the system properties during instance creation, use the following command: 


      asadmin> create-system-properties --target instance_name
DIAMETER_TCP_ADDRESS=instance hostname:DIAMETER_SSL_ADDRESS=instance hostname

    4. Restart the cluster.

      Use the stop-cluster(1) and start-cluster(1) commands.

Next Steps

For configuration instructions, proceed to Configuring Diameter for Communications Server.