Enable remote document conversion

To balance processing power, document conversion services can also be performed on a remote IBM WAS that supports document conversion services. Enabling the delegation of document conversion services to a remote server requires steps on both WebSphere Portal and the remote server.

Before running Document Conversion Services on a remote server:

• Update the content-types.properties file as described in the Enabling Document Conversion Services section.

• You must also download the latest RemoteDCS.zip file from the Recommended fixes and updates for WebSphere Portal and Web Content Management.

Linux on PowerPC:

Document conversion services must be performed on a remote WAS that supports document conversion services. Local document conversion is not supported on Linux for PowerPC. Additionally, the 64-bit zLinux platform does not support running document conversion or spell checker locally. These functions must be run on a remote server.

To enable Document Conversion Services on a remote server:

1. Install WAS on the remote system. The remote system must be supported by Stellent 8.0.1.

2. Copy the latest RemoteDCS.zip file to the remote server and unzip it in the directory of choice. Use the appropriate unzip tool for your operating system.

3. A dcs directory is created with many files and subdirectories in it.

4. Deploy dcs.war into WAS using the administrative console. The war file will be found in the unzipped directory, and the user should specify a context root of dcs. You should not change the default application name dcs_war.

5. Run the config script found in the unzipped directory.

   It is setupdcs.bat for Windows.

   It is setupremotedcs.sh for supported systems other than Windows.

   When using version 6.0.0.1 or greater of the portal, the script prompts you to enter the profile name where dcs.war is installed. If dcs.war is present in the default directory, leave this field blank. When entering a profile directory other than the default directory, do not append the profile name to the directory path.

6. The oiexport directory should be added in PATH as well as in the Library path.

   Table 1. Platform and library path

   Platform	Library path variable
   AIX	LIBPATH
   HP-UX	SHLIB_PATH
   Linux	LD_LIBRARY_PATH
   Solaris	LD_LIBRARY_PATH
   Windows	PATH

7. Restart the server.

Once Document Conversion Services is installed on the remote server...

1. Add the following property in the profile_root/ConfigEngine/properties/wkplc.properties file:

   DcsRemoteHost: URL of the remote host

   where the value of DcsRemoteHost is the URL of the remote host that provides document conversion services.

   For example, http://remotehost:port number/dcs/dcs. The variable port number refers to the port on which dcs.war is installed.

2. Run...
   one of the following configuration tasks to delegate some or all of the document conversion functions to the remote server.

   The possible tasks are:

   • delegate-all-conversions

   • delegate-text-conversions

   • remove-conversion-delegation

   The following command can be used to run the task:

   profile_root/ConfigEngine/ConfigEngine.sh <task_name>

   For example: profile_root/ConfigEngine/ConfigEngine.sh delegate-all-conversions.
   • Restart the portal server.

Parent topic:

Enable Document Conversion Services

---