WebSphere brand IBM WebSphere Presence Server, Version 7.0

Configuring content indirection

You can configure content indirection in SIP messages, allowing the messages to contain indirect references to specific content. Content indirection is enabled by default.

Before you begin
You will need the following files to complete this task. After you install the Presence Server product, these files are found in the directory was_root/installableApps/presence/scripts/config.
  • SystemConfiguration.xml
  • ConfigurationParams.txt
  • UpdateConfiguration.jar
Before you can make changes to your configuration, the file UpdateConfiguration.jar must be in the class path.

Be sure that the database is running before you make changes to the configuration.

About this task
Follow these instructions to configure content indirection.
  1. Open SystemConfiguration.xml with a text editor.
  2. Modify the attributes on the contentIndirection tag to enable or disable content indirection.
    You can set the following attributes. By default, content indirection is disabled.
    enable=""
    true to enable content indirection; false to disable it.
    maxDocumentLength=""
    Maximum size, in bytes, of the message body. When a message is larger than this size, content indirection is used. The valid range is 500-5000. The default value is 1000.
    proxyHttpUrl
    HTTP URL for the content indirection Servlet. The host name should be the name of a SIP application server in the stand-alone environment or the name of a proxy host in the clustered environment. This URL will be returned in NOTIFY messages.
    documentExpiration
    Time, in seconds, that the content indirection document should remain available. The valid range is 60-36000. The default value is 600.
    For example:
    • <contentIndirection enable="true" maxDocumentLength="1000" proxyHttpUrl="http://sip.server.example.com:9080/siplets/content" documentExpiration="600" />
  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
  7. Restart the application:
    1. Click Applications > Application types > WebSphere Enterprise Applications.
      Note: If you are using WebSphere® Application Server version 6.1.0.x, reach this window by clicking Applications > Enterprise Applications.
    2. Select the check box associated with the Presence Server.
    3. Click Stop. The Application Status column should indicate a Stopped status.
    4. Click Start. The Application Status column should indicate a Started status.
  8. Restart all servers that are running applications that have implemented content indirection service.



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