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.
- Open SystemConfiguration.xml with
a text editor.
- 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" />
- 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
- Restart the application:
- Click .
Note: If you are using WebSphere® Application Server version 6.1.0.x, reach
this window by clicking .
- Select the check box associated with the Presence Server.
- Click Stop. The Application
Status column should indicate a Stopped status.
- Click Start. The Application
Status column should indicate a Started status.
- Restart all servers that are running applications that
have implemented content indirection service.