WebSphere brand IBM WebSphere Presence Server, Version 7.0

Deploying IBM WebSphere Presence Server Component

IBM® WebSphere® Presence Server Component is installed as an enterprise application in WebSphere Application Server.

Before you begin
Before you begin, the following software should be installed:
  • WebSphere Application Server Network Deployment, Version 7.0.0.7
  • One of the following supported databases:
    • IBM DB2® Enterprise Server Edition, Version 9.5.0.4 or 9.7.0.1
    • Oracle Database, Version 11.1.0.7 or 11.2.0.1
Before you begin, the following steps should be completed:
  • Started the application server
  • Connected to the database
Verify that you have the following files needed for the installation:
  • IBMWebSpherePresenceServer.ear.ear
  • SystemConfiguration.xml
  • ConfigurationParams.txt
  • UpdateConfiguration.jar
About this task
Important: You must install Presence Server and IBM XDMS on the separate physical servers.

Complete the following steps to install and deploy the Presence Server application:

  1. 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.
    3. Click Log in.
  2. In the navigation panel, click Applications > Install New Application.
  3. Select Local file system and enter the full path and file name for the location of the IBMWebSpherePresenceServer.ear file on your local system. Use the Browse button, if necessary, to locate the file. For example: was_root/installableApps/presence/IBMWebSpherePresenceServer.ear
  4. Click Next.
  5. Accept the default installation options and click Next.
  6. In the Map modules to servers window, click WebSphere:cell=cell_name,cluster=WPS_cluster.

    Where WPS_cluster is the cluster you defined for the Presence Server application.

  7. Select all modules, and click Next.
  8. Verify that the values are correct, and click Finish. The contents of the EAR file are installed on your system.
  9. Review messages from the installation, if any, and click Save directly to the master configuration.
  10. Click OK when node synchronization has completed.
  11. Start the proxy server:
    1. In the navigation panel, click Servers > Proxy Servers.
    2. Select the check box corresponding to WPS_proxy.
    3. Click Start.
    4. Check the Status column to verify that WPS_proxy has started.
  12. Start the cluster:
    1. In the navigation panel, click Servers > Clusters.
    2. Select the check box corresponding to WPS_cluster.
    3. Click Start.
    4. Check the Status column to verify that WPS_cluster has started.
  13. Configure the application for your environment:
    1. Open SystemConfiguration.xml with a text editor.
    2. Modify the attributes to the values for your preferred configuration. The configuration elements and their values are described in the Configuring section of this information center. They are summarized in the topic The XML configuration file.
    3. Save and close the file.
    4. Open ConfigurationParams.txt with a text editor.
    5. Update the following parameters for your environment:
      • cfg.system = xml_path (where xml_path is the directory location for SystemConfiguration.xml)
      • username = database_administrator_user_name
      • password = database_administrator_password
      • DB2 dbDriver = com.ibm.db2.jcc.DB2Driver
      • Oracle dbDriver = oracle.jdbc.driver.OracleDriver
      • DB2 dbConnectionString = jdbc:db2://database_host_name:database_port/database_name
      • Oracle dbConnectionString = jdbc:oracle:thin:@database_host_name:database_port:database_name
    6. Run the java command that is appropriate for your operating system:
      Important: Enter the following parameters on a single line.
      • AIXLinux java -classpath UpdateConfiguration.jar: jdbc_path CmdConfig config_path/ConfigurationParams.txt
      (where jdbc_path is the directory location for your JDBC drivers and config_path is the directory location for ConfigurationParams.txt)
      Important: JDBC drivers must be separated by a colon.
      For example:
      • AIX /usr/IBM/WebSphere/AppServer/java/bin/java -classpath UpdateConfiguration.jar:/opt/IBM/db2/V9.5/java/db2jcc.jar:/opt/IBM/db2/V9.5/java/db2jcc_license_cu.jar CmdConfig ConfigurationParams.txt
      • Linux /opt/IBM/WebSphere/AppServer/java/bin/java -classpath UpdateConfiguration.jar:/opt/IBM/db2/V9.5/java/db2jcc.jar:/opt/IBM/db2/V9.5/java/db2jcc_license_cu.jar CmdConfig ConfigurationParams.txt
  14. Start the application:
    1. Click Applications > Enterprise Applications.
    2. Select the check box associated with the Presence Serverapplication.
    3. Click Start.
    4. Check the Application Status column to verify that the application has started.
Results



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