To balance processing power, you can run document conversion services on a remote IBM
WebSphere Application Server that supports document conversion services. Enabling the delegation
of document conversion services to a remote server requires steps on both HCL Digital Experience
and the remote server.
About this task
Local document conversion
is supported on z/OS®.
You do not have to run Document Conversion Services remotely for z/OS®. If required, install
the following package on the remote server to improve graphics performance
with your document conversions: X11R6.
Linux on PowerPC: Run document conversion services on
a remote WebSphere® Application Server that
supports document conversion services. Local document conversion is
not supported on Linux™ for PowerPC®. Additionally, the 64-bit Linux on z Systems
does not support running document conversion or spell checker locally.
You must run these functions on a remote server.
Procedure
- Install WebSphere® Application Server on
the remote system.
Restriction: Stellent version
8.01 must support the remote system.
- Copy RemoteDCS.zip to the remote server
and extract it in any directory with an appropriate archiving tool.
A directory that is named dcs becomes
available. This directory contains several files and sub-directories.
- Deploy dcs.war to WebSphere® Application Server.
- Log in to the WebSphere® Integrated Solutions Console.
- Select .
- Browse to the directory where you extracted RemoteDCS.zip then
locate and select dcs.war.
- Specify dcs as the context root
and click Next.
- Leave all other values as default.
Restriction: The application name must be dcs_war
.
Do not change the default name.
- Map the application to the appropriate servers and specify
the installation options as required.
- Click Finish and save your changes
to the master configuration.
- Ensure dcs.war is running.
- Log in to the WebSphere® Integrated Solutions Console.
- Select .
- Locate dcs_war in the list of
installed applications.
- Select dcs_war and click Start if
the application is not started.
- Run the configuration script.
- Open a command prompt.
- Change to the dcs directory.
The configuration script is in the root of the dcs directory
that is in the directory where you extracted RemoteDCS.zip.
- Run the following command:
- AIX® HP-UX Linux™ Solaris:
./setupremotedcs.sh
- IBM® i: setupremotedcs.sh
- Windows™: setupdcs.bat
- When prompted, specify the WebSphere® Application Server installation directory.
- When prompted for the profile, specify the directory
where dcs.war is installed.
For
example,
AppServer_root/profiles/profile_name/installedApps/node_name/dcs_war.ear
The configuration script copies all the files to the
oiexport directory
where you installed
dcs.war; for example,
AppServer_root
/profiles/profile_name/installedApps/node_name/dcs_war.ear/dcs.war/WEB-INF/lib/oiexport
- Complete the following steps to add environment variables
to your remote search server:
- Log on to the WebSphere® Integrated Solutions Console.
- Go to .
- Select your remote DCS server.
- Go to .
- Click Environment Entries.
- Click New to create the following
entries:
Note: If the entries exist, click the entry and
update the value.
- LD_LIBRARY_PATH
- AppServer_root/profiles/profile_name/installedApps/node_name/dcs_war.ear/dcs.war/WEB-INF/lib/oiexport
- LIBPATH
- AppServer_root/profiles/profile_name/installedApps/node_name/dcs_war.ear/dcs.war/WEB-INF/lib/oiexport
- PATH
- AppServer_root/profiles/profile_name/installedApps/node_name/dcs_war.ear/dcs.war/WEB-INF/lib/oiexport
- SHLIB_PATH
- AppServer_root/profiles/profile_name/installedApps/node_name/dcs_war.ear/dcs.war/WEB-INF/lib/oiexport
- Save your changes.
- Restart the server.
Document Conversion
Services is now installed on the remote server.
- Complete the following steps:
- Open wkplc.properties with any
text editor from the wp_profile_root/ConfigEngine/properties directory.
- Add the following property and value to wkplc.properties: DcsRemoteHost=URL
of the remote host.
Where URL
of the remote host is the URL of the remote server to which
you plan to delegate document conversion services. For example, DcsRemoteHost=http://server_name:port_number/dcs/dcs.
The server_name is the fully
qualified host name of the remote DCS server. The port_number is
the port number of the default host where DCS is run. For example,
the URL might be DcsRemoteHost=http://example.mycompany.com:9080/dcs/dcs.
Important: This property does not exist in the wkplc.properties file
by default. You must add this property and specify a value before
you proceed to the next step.
- Run the appropriate task to delegate some or all of
the document conversion functions to the remote server.
- Open a command prompt.
- Change to the following directory:
- Run the following task:
Note: Run the following command on all
nodes in a cluster, if applicable.
- AIX® HP-UX Linux™ Solaris: ./ConfigEngine.sh task_name
- IBM® i: ConfigEngine.sh task_name
- Windows™: ConfigEngine.bat task_name
Where task_name is one of the following configuration
tasks: Table 1. Tasks to delegate document
conversion functions to a remote server.
Task |
Description |
delegate-all-conversions |
This task delegates all file conversion services
to a remote server. |
delegate-text-conversions |
This task delegates text document conversions
to a remote server. |
remove-conversion-delegation |
This task ends the delegation of all file conversion
services to a remote server. |
- Restart HCL Portal.