Skip Headers
Oracle® Communication and Mobility Server Installation Guide
Release 10.1.3 for HP-UX PA-RISC (64-Bit)

Part Number E10063-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

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

2 Installing Oracle Communication and Mobility Server

This chapter describes how to perform an installation of Oracle Communication and Mobility Server (OCMS) and Oracle Communication and Mobility Server Service Creation Environment (OCMS SCE). It describes the following topics:

Installing a Cluster of OCMS Instances in a High Availability Environment

You can install OCMS either as a single node for evaluation or development, or you can install OCMS to multiple nodes for a high availability production topology. For a high availability production topology you will need one or more Edge Proxies nodes along with the other OCMS nodes. Edge Proxies provide scalability and high availability. Edge Proxies are required for advanced production level topologies, and are usually used to provide SIP distribution. The Edge Proxy distributes incoming SIP traffic among OCMS SIP application servers when used between a SIP unaware load balancer and an OCMS cluster.

For information on recommended deployment topologies and configuring high availability see the "Deployment Topologies" and "Configuring High Availability" chapters in the Oracle Communication and Mobility Server Administrator's Guide.

Configuring OCMS in a Clustered Environment with Edge Proxies

An administrator typically installs Edge Proxies on separate nodes. The installation of an Edge Proxy as part of an OCMS installation is supported only in Oracle Application Server installation mode. An Edge Proxy is aware of multiple OCMS instances through OPMN clustering. This requires a clustered Oracle Application Server 10.1.3 environment where each OCMS instance references a unique Oracle Home.

Sizing the Installation

The number of Edge Proxies recommended for an OCMS installation depends on scalability and high availability requirements for the installation and on the number of SIP clients and OCMS instances. A minimum of two Edge Proxies is recommended to guarantee high availability in a clustered environment. As the number of SIP clients or OCMS instances grows, additional Edge Proxy servers can be added. Refer to the Oracle Communication and Mobility Server Administrator's Guide for more information.

In OCMS installations with three or more OCMS instances, Edge Proxies are typically separately installed OCMS instances that consists of only the Edge Proxy application (that is, only Edge Proxy is selected for installation from the Custom Installation window). For OCMS installations with not more than two instances, Edge Proxies can be installed concurrently with the OCMS instances.

Assigning Ports in a Multi-Instance Installation

After you have decided on the number of OCMS instances and Edge Proxy-only instances in the OCMS installation, you must decide what ports will be assigned to each instance. For single machine installations, each instance in the OCMS installation must have uniquely defined ports. The OCMS installer verifies that ports are available at the time of installation. Example 2-1 shows how to assign ports in a multi-instance OCMS installation with an Edge Proxy server.

Example 2-1 Assigning Ports in a Multi-Instance OCMS Installation with an Edge Proxy

OCMS instance 1: Custom installation consisting of Edge Proxy only
Edge Proxy Port: 5060 (default)

OCMS instance 2: Typical installation
SIP Port: 5080 (user-configured during installation)

OCMS instance 3: Typical installation
SIP Port: 5090 (user-configured during installation)

OCMS instance 4: Typical installation
SIP Port: 5100 (user-configured during installation)

Installing Edge Proxies

Perform the following steps to install Edge Proxies into an OCMS installation:

  1. Select the Custom installation type, select only Edge Proxy for installation.

  2. Click Next.

  3. Configure the Edge Proxy port and click Next.

  4. Complete the OCMS installation.

  5. Perform an opmnctl status command to see the status of the Edge Proxy.

    The Edge Proxy runs automatically after being installed and reports a status of "Alive."

  6. Run the OCMS installer and repeat the steps above to configure additional Edge Proxies.

  7. Perform the following additional procedures in the Oracle Communication and Mobility Server Adminstrator's Guide:

    • "Configuring the OCMS SIP Containers for High Availability"

    • "Configuring the Edge Proxy Nodes for High Availability"

    • "Configuring Highly Available SIP Servlet Applications"

  8. Install the non-Edge Proxy OCMS instances using the procedures in this guide.

    After installation of all the Edge Proxies and OCMS instances you will be able to view the topology of the OCMS installation through Enterprise Manager from the Oracle Application Server instance where "Start AS Control" was selected during Oracle Application Server installation.

Performing Pre-installation Procedures for Oracle Communication and Mobility Server Service Creation Environment

The OCMS Service Creation Environment (OCMS SCE) component is a package for third-party developers on the Microsoft Windows operating system. OCMS Service Creation Environment (SCE) consists of tools and APIs for developers to create their own services using the OCMS platform.

Installing OCMS SCE consists of three procedural tasks:

Perform the following pre-installation steps if installing OCMS Service Creation Environment:

  1. Install the prequisite software tools:

    Tip:

    To avoid problems with extracting files with long names when using the utility Winzip to extract the Eclipse WebTools files, use the Winzip option "Extract to here" rather than "Extract to folder"
  2. Configure environmental variables required for OCMS SCE.

    • Configure JAVA_HOME to the Java 2 Platform, Standard Edition 5.0 installation directory. For example, C:\j2sdk1.5.0\jre.

    • Add %JAVA_HOME%\bin to the PATH environment variable.

  3. Start Eclipse by executing eclipse.exe from the Eclipse installation directory.

    Configure the following items in Eclipse:

    • Select the location for storing your developing artifacts in Eclipse. For example, C:\workspace.

    • Verify in Eclipse that the selected Java Runtime Environment is version 5.0 (1.5.0) by selecting Window, Preferences, Java, Installed JRE. The Name and Location must specify the JDK 1.5 that you previously installed. If not, configure the version 5.0 (1.5.0) JRE to be the installed JDK 1.5.

    • Verify in Eclipse that the compiler compliance level is 5.0 by selecting Window, Preferences, Java, Compiler.

    • Configure a proxy host for Eclipse downloads by selecting Window, Preferences, Internet. Select Enable Proxy and provide the hostname or IP address for the Proxy Host.

You have completed the pre-installation requirements for OCMS SCE. Next install OCMS SCE through Custom installation mode in the OCMS InstallShield wizard as described in Installing Oracle Communication and Mobility Server. After that, to complete the installation perform the procedures described in Performing Post-Installation Procedures for Oracle Communication and Mobility Server Service Creation Environment.

Installing Oracle TimesTens In-Memory Database

Both Oracle TimesTen and OCMS must be installed as the same user, and that user should not be root. Depending on whether you have an existing non-root user defined for installing Oracle TimesTen and OCMS, you must perform one of the following procedures:

When you have completed one of these procedures, perform the steps in Installing Oracle TimesTen.

Creating a Non-Root User for Installing Oracle TimesTen and OCMS

If a non-root user does not exist, perform the following procedure as a root user:

  1. Create the Oracle TimesTen group if it does not already exist using the following command:

    /usr/sbin/groupadd timesten
    
    
  2. Create a non-root user (e.g. ocmsuser) and add the user as a member of the timesten group using the following command:

    /usr/sbin/adduser -d </location of home directory of user ocmsuser> -G timesten ocmsuser
    
    
  3. Change or set the password for user ocmsuser using the following command:

    passwd ocmsuser
    
    

    Enter the password twice.

  4. Create the directory /etc/TimesTen, if it does not already exist, using the following command:

    mkdir /etc/TimesTen
    
    
  5. Assign ownership and permission to this directory using the following commands:

    chmod 775 /etc/TimesTen
    chgrp timesten /etc/TimesTen
    
    

Next, perform the procedures described in Installing Oracle TimesTen.

Installing Oracle TimesTen by an Existing Non-Root User

As root, perform the following steps if you already have a non-root user for installing Oracle TimesTen and OCMS:

  1. Create the timesten group, if it does not already exist, using the following command:

    /usr/sbin/groupadd timesten
    
    

    All users who install Oracle TimesTen need to be in this group.

  2. Create the directory /etc/TimesTen if it does not already exist, using the following command:

    mkdir /etc/TimesTen
    
    
  3. Assign ownership and permission to this directory using the following commands:

    chmod 775 /etc/TimesTen
    chgrp timesten /etc/TimesTen
    
    

Next perform the procedures described in Installing Oracle TimesTen.

Installing Oracle TimesTen

Perform the following steps as a non-root user:

  1. Execute setup.sh and complete the interactive installation.

  2. Select the default value of "tt60" for the instance name.

  3. Select Oracle TimesTen In-Memory Database (first option: we do not require the cache connect feature).

  4. Install the Client/Server and Data Manager.

  5. Accept the default values until you get to enabling access control. Select "yes" to enable access control.

  6. For the hostname running the Oracle TimesTen server, enter the fully qualified domain name of your host.

  7. Accept the default values and finish the installation.

    A screen log, provided in Appendix A, Oracle TimesTen Installation Output, shows a typical installation.

Verifying Oracle Times Ten In-Memory Database Installation

Ensure that OracleTimes In-Memory database is installed and running by performing the following tests:

  1. After installing TimesTen, please verify that TimesTen is up and running by performing the following command:<TimesTen_Home>/bin/ttstatus

    If you receive the following error, TimesTen is not up:

    ttStatus: Could not connect to TimesTen daemon: Connection refused
    
    
  2. Start TimesTen with the following command:

    <TimesTen_Home>/bin/ttdaemonadmin -start 
    
    
  3. Verify that you receive the following output:

    TimesTen Daemon startup OK.
    
    
  4. Issue the ttstatus command again to verify that TimesTen is up and running.

Installing Oracle Communication and Mobility Server

Normally OCMS is installed through an InstallShield wizard. OCMS may also be installed through a silent installation mode.

Perform the following steps to install OCMS:

  1. Close any SIP client applications that are running.

  2. Configure JAVA_HOME to the Java 2 Platform, Standard Edition 5.0 installation directory.

  3. Add $JAVA_HOME/bin to the PATH environment variable.

  4. Run the installation executable setupHPUX.bin.

    After running the OCMS executable, the InstallShield Wizard for OCMS searches for a Java 2 Platform, Standard Edition Development Kit (JDK) 1.5. If the InstallShield Wizard for OCMS is unable to automatically find the JDK 1.5, you must specify its location.

    For HP-UX installations, perform the following command:

    -is: javahome <JAVA_HOME>
    
    

    When the InstallShield Wizard for OCMS locates the JDK 1.5, it starts and displays the Welcome screen.

  5. Click Next to continue.

  6. Select the IP address of the system for the OCMS deployment from the list. Record this IP address for later access to OCMS through Enterprise Manager.

Selecting an Installation Mode

After selecting the installation type (and after configuring Custom Installation and Edge Proxy, if selected), the OCMS Installation Mode window appears (Figure 2-1).

Figure 2-1 OCMS Installation Mode Window

OCMS Installation Mode Window
Description of "Figure 2-1 OCMS Installation Mode Window"

Select one of the following installation modes. For more information on these installation modes see "Installation Modes" in the Product and Installation Overview chapter.

  • Install to existing Oracle Application Server, Release 10.1.3.2 or higher: This installation mode is the default selection and it is also the recommended selection for production deployments. The InstallShield for OCMS verifies if the provided Application Server Home contains an Oracle Application Server installation.

  • Install in standalone developer mode: The standalone developer mode is recommended for development users only due to limited management capabilities. This option installs Oracle Containers for J2EE (OC4J) software, Release 10.1.3.2, and does not require an application server.

Specifying the Application Server Home

The Application Server Home is the installation directory for Oracle Application Server, or the installation directory for a standalone developer mode OC4J installation.

To specify the Application Server Home:

  1. Specify an installation directory in the Application Server Home field.

    For Oracle Application Server installation mode, specify the application server home.

    For standalone developer mode enter the path of an empty or non-existent directory. The default directory will work correctly. You can use the Browse button to navigate to a directory. You can also create a new directory.

  2. Click Next to continue.

Specifying Oracle Application Server Username and Password

For installation to an existing Oracle Application Server home, enter the administrator username and password for your installation of the Oracle Application Server. These credentials will be used to connect to the Oracle Application Server instance and deploy applications to it. The username and password provided will be validated before you can continue with the installation.

For installation in standalone developer mode, the username and password are for the standalone OC4J which will be installed along with OCMS. You cannot change the default username of oc4jadmin. Your standalone installation of OC4J will be protected with these credentials. No validation of credentials is performed in this installation mode.

Selecting the Installation Type

A typical installation includes the SIP Container, Proxy Registrar, Presence, Subscriber Data Services, and Application Router. Features that can only be installed in a custom installation include Presence Web Services, STUN Server, Aggregation Proxy, and Edge Proxy, and the Service Creation Environment (SCE) Eclipse Plugin.

Select whether to perform a typical or custom installation and click Next. Select the custom installation type if you do not require all the applications provided in the typical installation mode. If you selected a custom installation, select the features to be installed (for more information refer to Chapter 1, "Overview") and click Next.

Specifying the Eclipse Home

If you selected SCE Eclipse Plugin for installation in Custom installation mode, you will be prompted to enter the directory for the Eclipse Home.

To specify the Eclipse Home:

  1. Specify the directory where Eclipse is installed in the Eclipse Home field.

    You can use the Browse button to navigate to the Eclipse Home directory.

  2. Click Next to continue.

The OCMS SCE Plugin for Eclipse is installed in the \plugins directory under the Eclipse home directory.

Specifying the STUN Server Primary and Secondary Addresses

If you selected STUN Server for installation in Custom installation mode, you will be prompted to enter the host and port for the primary and secondary STUN servers. Configuring both primary and secondary STUN servers is required.

To specify the STUN Server hosts and ports:

  1. Enter the hostname or IP address of the primary STUN server in the Primary Host Address field.

  2. Enter the hostname or IP address of the secondary STUN server in the Secondary Host Address field.

  3. Verify that the primary and secondary ports (default values of 3478 and 3479) are available, or enter available port numbers.

  4. Click Next to continue.

Specifying Oracle TimesTen In-Memory Database Location

You must install and configure an Oracle TimesTen In-Memory Database if you install the Subscriber Data Services component of OCMS.

To specify the TimesTen database location:

  1. Enter the TimesTen database location in the TimesTen Home field. You can use the Browse button to navigate to the directory.

  2. Click Next to continue.

    The message "Checking TimesTen Requirements. Please Wait." is displayed. The InstallShield Wizard for OCMS verifies that the TimesTen directory is valid, and that it can connect to it.

    Note:

    If Oracle TimesTen is not correctly configured, the installation will fail. Refer to Oracle TimesTen Installation Guide for information on configuring these parameters.

Configuring the SIP Container

After the InstallShield Wizard for OCMS verifies the TimesTen requirements, it displays the SIP Container configuration window (Figure 2-2).

Figure 2-2 OCMS SIP Servlet Container Configuration Window

OCMS SIP Servlet Container Configuration Window
Description of "Figure 2-2 OCMS SIP Servlet Container Configuration Window"

To configure the SIP Container:

  1. Select or configure the following options:

    • Use Default SIP Port (selected by default): The InstallShield for OCMS displays the default SIP port. The port used is 5070 in an installation with Edge Proxy, and is port 5060 in an installation without Edge Proxy.

      If you receive a message that the SIP port is in use, exit all client applications, select Back, and return to this window.

      To provide a different port number, deselect this option and enter the port number. This port can be reconfigured later through a JMX console. Refer to the Oracle Communication and Mobility Server Administrator's Guide for configuration details.

    • SIP Domain: Specifies the domain or hostname of the machine where OCMS is being installed. The default is example.com.

    • SIP Realm: Specifies the SIP realm used for authentication. This is also the domain or hostname of the machine where OCMS is being installed. The default is example.com.

  2. Click Next to continue.

Note:

InstallShield for OCMS enables configuration of only one SIP domain and one SIP realm. You can configure additional SIP domains and SIP realms after the installation using the Domains and Realms attribute of the SIP Servlet Container MBean. Multiple SIP domains can exist in a SIP realm. Refer to Oracle Communication and Mobility Server Administrator's Guide for more information.

Configuring Test Users

When installing OCMS you can create a number of predefined test users. To create test users:

  1. Select the Number of Test Users from 0-12.

    Selecting 0 will not create any test users.

  2. Enter the Username Prefix for the test users.

    The default prefix is "test.user". The username for each test user will be prefixed by this string.

    For example, if you select 3 for Number of Test Users and "test.user" for Username Prefix, the following test users will be created:

    test.user1@sip-domain
    test.user2@sip-domain
    test.user3@sip-domain
    
    

    WARNING:

    This release of OCMS supports lowercase usernames. Only use lowercase usernames for the Username Prefix.

  3. Enter Password for the test users.

    Each test user will have this password.

  4. Confirm the Password for the test users.

  5. Click Next.

Recording Installation Summary Information

The OCMS installation summary screen displays the installation environment, the components to be installed, and the settings and port numbers that you configured.

  1. Record the installation summary information in the "Installation Configuration" section, including port numbers, for your later reference.

    This information is required when configuring the SIP client.

  2. Ensure that all the installation summary information is correct, and the correct OCMS applications will be installed.

  3. Click Next to begin installing the OCMS components.

The InstallShield Wizard for OCMS displays messages to inform you about the installation progress. The following events occur during installation:

  • The InstallShield Wizard for OCMS deletes all existing OCMS Oracle TimesTen In-Memory database tables, and creates new, empty tables. The messages "Configuring OCMS datastores", "Dropping Tables under OCMSDB", "Creating Tables under OCMSDB", and "Creating OCMS datastores" are displayed.

  • In Oracle Application Server mode and standalone developer mode installations, the message " Starting Oracle Communication and Mobility Server" is displayed. After you press the Finish button, you are prompted to start Oracle Communication and Mobility Server.

  • One or more of the following messages are displayed for the installation of each OCMS application: "Deploying Subscriber Data Services Application", "Deploying Proxy Registrar Application", "Deploying Presence Application", and "Deploying Application Router Application."

Note:

If you encountered any errors during the installation, look at the installation log file at $ORACLE_HOME/ocmsinstall.log

Selecting Whether to Start OCMS

After OCMS is successfully installed, you are prompted to start OCMS (this is the default selection). To exit the installer and start OCMS click Finish. To select not to start OCMS you must uncheck the "Start OCMS server before exiting" box, then click Finish.

Note:

The installation summary is available at the following HTML file:
$ORACLE_HOME/sdp/install/InstallSummary.htm 

In addition, if you choose to start the server at the conclusion of the installation, your Web browser is launched and displays InstallSummary.htm.

The configuration options you selected during installation are available at:

$ORACLE_HOME/sdp/install/installconfig.xml 

Listing the Oracle Remote Method Invocation (RMI) Port

Oracle Application Server Containers for J2EE (OC4J) provides support for allowing EJBs to invoke one another across OC4J containers using the proprietary Remote Method Invocation (RMI)/Oracle RMI (ORMI) protocol. For more information on Oracle RMI, refer to Oracle Application Server Containers for J2EE Services Guide.

If a particular JMX application requires connecting to the Oracle RMI port, then you will need to know what port is assigned for RMI. The RMI port is dynamically assigned by OPMN (Oracle Process Management and Notification).

The following command lists the latest port assignments:

opmnctl status -l

For example (some columns omitted for clarity):

Figure 2-3 Output from opmnctl command

output of opmnctl status command
Description of "Figure 2-3 Output from opmnctl command"

The ports column of the table lists the ports selected by opmn. The following example corresponds to the OCMS instance of OC4J ("OC4J: ocms"):

jms:12603,ajp:12503,rmis:12703,sip:5060,rmi:12403

Verifying the OCMS Installation

Perform the following steps to verify that OCMS has been successfully installed and is running:

  1. With the OCMS server up and running, perform the following command to make sure that the SIP container is listening for SIP traffic on port 5060 (default SIP port):

    netstat -a | grep 5060
    
    

    Replace "5060" with the port number you chose during installation. You should see the following output:

    tcp      0     0 <hostname>:5060  *:*       LISTEN
    udp       0      0 <hostname>:5060  *:*                                  
    
    
  2. Navigate to the Oracle Enterprise Manager Web page at:

    http://<ip_address>:<port_number>/em.
    
    

    For port number, use one of the following values:

    • Use 8888 for standalone developer mode installation.

    • Use the HTTP server port for an Oracle AS installation with an HTTP server.

    • Use 7785 for an Oracle AS installation without an HTTP server.

    • For HTTPS, use the HTTPS port for the Oracle AS installation.

  3. Enter the OC4J administrator username and password.

  4. Verify that Oracle Home specifies the OCMS installation directory.

  5. Verify that server Status is "Up."

  6. Select the Applications tab.

  7. Verify that the applications you installed are deployed and are all up and running. You may notice that one or more applications are deployed as a child application of subscriberdataservices.

    For a typical installation, you should see ocmsrouteloaderear, proxyregistrar, subscriberdataservices, and presence.

  8. Return to the home page and select the Administration tab. In the left margin, expand SipContainer and click on SipServletContainer and verify the MBean property values.

The verification of OCMS is complete.

Installing Diameter Libraries

Installing the Diameter libraries allows you to use the Diameter protocol for Diameter client development. Diameter is an AAA (Authentication, Authorization, and Accounting) protocol. Oracle provides support for the Diameter Base Protocol as defined by RFC 3588, and APIs for developing base Diameter applications, as well as IMS applications leveraging the Sh, Ro, and Rf interfaces.

Diameter Components

The Oracle distribution of Diameter consists of a runtime environment, an SDK, and emulators. The SDK includes the runtime environment and code examples. Developers should install the SDK for development purposes. If developing and testing the Sh interface, HSS and SLF emulators are needed as well. For production, only the runtime environment is needed.

Home Subscriber Server (HSS) Emulator

HSS is the master user database that supports IMS network entities that handle calls and sessions. It stores subscription-related information such as user profiles, performs user authentication and authorization, and provides information about the physical location of users.

Subscriber Location Function (SLF) Emulator

SLF maps user addresses when multiple HSSs are used.

Installing Diameter Runtime

Perform the following steps to install the Diameter runtime for production deployments:

  1. Create the Diameter installation directory ($DIAMETER_HOME) at $ORACLE_HOME/sdp/diameter.

  2. Copy OracleAS-diameter-runtime-1.0.0-HP-UX-11iv1-PA from the CD Disk1/Diameter/HPUX into $DIAMETER_HOME.

  3. Decompress the SDK files into $DIAMETER_HOME. It will be decompressed into a subdirectory called OracleAS-diameter-runtime-1.0.0-HP-UX-11iv1-PA ($DIAM_RUNTIME_HOME).

    For example:

    gunzip OracleAS-diameter-runtime-1.0.0-HP-UX-11iv1-PA.tgz
    tar xvf OracleAS-diameter-runtime-1.0.0-HP-UX-11iv1-PA.tar
    
    
  4. Copy or perform a symbolic link to mdiameter.jar from $DIAM_RUNTIME_HOME/lib to the applib directory.

    For a standalone developer mode installation perform the following commands:

    cp $DIAM_SDK_HOME/lib/mdiameter.jar $ORACLE_HOME/j2ee/home/applib
    
    

    For an Oracle Application Server mode installation perform the following commands:

    cp $DIAM_SDK_HOME/lib/mdiameter.jar $ORACLE_HOME/j2ee/ocms/applib
    
    
  5. Add a shared library path to SHLIB_PATH.

    For standalone developer mode installation perform the following commands:

    • Edit the file $ORACLE_HOME/sdp/bin/startocms.sh

    • Add $DIAM_SDK_HOME/lib to SHLIB_PATH

    For an Oracle Application Server mode installation perform the following commands:

    • Edit the file $ORACLE_HOME/opmn/conf/opmn.xml.

    • Modify the following line:

      <variable append="true" id="SHLIB_PATH"
      value="/scratch/ocmsuser/TimesTen/tt60/lib"/>
      
      

      to:

      <variable append="true" id="SHLIB_PATH"
      value="/scratch/ocmsuser/TimesTen/tt60/lib:$DIAM_SDK_HOME/lib"/>
      
      

Installing Diameter for Development

Perform the following procedures to install Diameter for development.

Updating CLASSPATH to Include Diameter Java Library

There is one Java library that exposes all the Diameter APIs. This library is installed in the applib directory. You must include this library in your CLASSPATH.

Installing the Diameter SDK

Perform the following steps to install the Diameter SDK for development purposes:

  1. Create the Diameter installation directory ($DIAMETER_HOME) at $ORACLE_HOME/sdp/diameter.

  2. Copy OracleAS-diameter-runtime-1.0.0-HP-UX-11iv1-PA from the CD Disk1/Diameter/HPUX into $DIAMETER_HOME.

  3. Decompress the SDK files into $DIAMETER_HOME. It will be decompressed into a subdirectory called OracleAS-diameter-sdk-1.0.0-HP-UX-11iv1-PA ($DIAM_SDK_HOME).

    For example:

    gunzip OracleAS-diameter-sdk-1.0.0-HPUX.tgz
    tar xvf OracleAS-diameter-sdk-1.0.0-HPUX.
    
    
  4. Copy or perform a symbolic link to mdiameter.jar from $DIAM_SDK_HOME/lib to the applib directory.

    For a standalone developer mode installation enter the following command:

    cp $DIAM_SDK_HOME/lib/mdiameter.jar $ORACLE_HOME/j2ee/home/applib
    
    

    For an Oracle Application Server mode installation enter the following command:

    cp $DIAM_SDK_HOME/lib/mdiameter.jar $ORACLE_HOME/j2ee/ocms/applib
    
    
  5. Add a shared library path to SHLIB_PATH.

    For a standalone developer mode installation enter the following commands:

    • Edit the file $ORACLE_HOME/sdp/bin/startocms.sh

    • Add $DIAM_SDK_HOME/lib to SHLIB_PATH

    For an Oracle Application Server mode installation perform the following steps:

    • Edit the file $ORACLE_HOME/opmn/conf/opmn.xml.

    • Modify the following line:

      <variable append="true" id="SHLIB_PATH"
      value="/scratch/ocmsuser/TimesTen/tt60/lib"/>
      
      

      to:

      <variable append="true" id="SHLIB_PATH"
      value="/scratch/ocmsuser/TimesTen/tt60/lib:$DIAM_SDK_HOME/lib"/>
      
      

Installing the HSS and SLF Emulators

Perform the following steps to install the HSS and SLF emulators:

  1. Create the Diameter installation directory ($DIAMETER_HOME) at $ORACLE_HOME/sdp/diameter.

  2. Copy the SLF_HSS_Emulator.tar.gz from the CD Disk1/Diameter/HPUX into $DIAMETER_HOME.

  3. Decompress the SDK files into $DIAMETER_HOME. It will be decompressed into a subdirectory called SLF_HSS_Emulator.

    For example:

    gunzip OracleAS-diameter-runtime-1.0.0-HP-UX-11iv1-PA.tgz
    tar xvf OracleAS-diameter-runtime-1.0.0-HP-UX-11iv1-PA.tar
    
    

Importing the Diameter Packages into Your Servlet

The base package name, oracle.sdp.diameter, must be known to import the packages into your servlet. You can perform an import oracle.sdp.diameter.* to import all packages.

Starting and Stopping Oracle Communication and Mobility Server

After installation, you are prompted to start Oracle Communication and Mobility Server. You can manually start or stop OCMS as described in the following procedures.

Standalone Developer Mode or Oracle Application Server Mode

In standalone developer mode or in Oracle Application Server mode perform the following procedures to start or stop OCMS:

To start OCMS, enter the following commands:

  • cd $ORACLE_HOME/sdp/bin
    ./startocms.sh 
    
    

To stop OCMS , enter the following commands:

  • cd $ORACLE_HOME/sdp/bin
    ./stopocms.sh 
    
    

Performing Post-Installation Procedures for Oracle Communication and Mobility Server Service Creation Environment

Perform the following steps to complete the installation of OCMS SCE:

  1. If OCMS is running, stop it by selecting Start, Program Files, Oracle Communication and Mobility Server, Stop OCMS.

    When completing the installation of OCMS the InstallShield wizard prompts you to start OCMS. If you selected to start OCMS, the server is running and will need to be stopped so that you can start the server through Eclipse.

  2. Close and restart Eclipse by entering eclipse.exe -clean from the command line.

    This allows Eclipse to load OCMS SCE.

  3. Define OCMS as a new server in Eclipse by selecting, File, New, Other.

    The Define a New Server wizard appears (Figure 2-4).

  4. Select Server under the Server folder.

  5. Click Next.

  6. Navigate to the Oracle folder and select the following application server.

    OCMS SipAS/OC4J 10.1.3.x: this refers to an installation of OCMS in an Oracle Application Server environment or standalone developer mode OC4J environment.

  7. Click Next.

  8. Specify the path for the OCMS instance, and specify the same path for the Classpath Variable. Continue and complete the wizard.

    You can now start OCMS by opening the Servers view.

  9. Select Window, Show view, and Other. Select Server, Servers and click OK (Figure 2-4).

    Figure 2-4 Defining OCMS as a New Server in Eclipse

    Defining OCMS as a New Server in Eclipse
    Description of "Figure 2-4 Defining OCMS as a New Server in Eclipse"

    You can now start and stop OCMS from the Servers view by selecting Window, Show View, Server, Servers. The server status is indicated in the Status column.

    The OCMS installation is complete. Perform the procedures in the Verification chapter to verify that OCMS has been installed correctly and that you can establish communication between two SIP clients.