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:
- 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.
- Click Log in.
- In the navigation panel, click .
- 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
- Click Next.
- Accept the default installation options and click Next.
- 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.
- Select all modules, and click Next.
- Verify that the values are correct, and click Finish. The contents of the EAR file are installed on your system.
- Review messages from the installation, if any,
and click Save directly to the master configuration.
- Click OK when
node synchronization has completed.
- Start the proxy server:
- In the navigation panel, click .
- Select the check box corresponding to WPS_proxy.
- Click Start.
- Check the Status column to verify that WPS_proxy has started.
- Start the cluster:
- In the navigation panel, click .
- Select the check box corresponding to WPS_cluster.
- Click Start.
- Check the Status column to verify that WPS_cluster has started.
- Configure the application for your environment:
- Open SystemConfiguration.xml with
a text editor.
- 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.
- Save and close the file.
- Open ConfigurationParams.txt with
a text editor.
- 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
dbDriver =
com.ibm.db2.jcc.DB2Driver
dbDriver =
oracle.jdbc.driver.OracleDriver
dbConnectionString =
jdbc:db2://database_host_name:database_port/database_name
dbConnectionString =
jdbc:oracle:thin:@database_host_name:database_port:database_name
- Run the java command
that is appropriate for your operating system:
Important: Enter the following
parameters on a single line.

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:
/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
/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
- Start the application:
- Click .
- Select the check box associated with the Presence Serverapplication.
- Click Start.
- Check the Application Status column to verify that the application
has started.