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 IBM WebSphere Portal 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 System z
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 named dcs becomes available.
This directory contains several files and subdirectories.
- 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® Linux Solaris:
./setupremotedcs.sh
- IBM i: setupremotedcs.sh
- Windows: setupdcs.bat
- When prompted, specify the WebSphere Application
Server installation directory. For example, AppServer_root.
- 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 required files
to new directory named oiexport in the 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
- Add the oiexport directory to the library
path variable.
Table 1. Platform and library
pathPlatform |
Library path variable |
AIX |
LIBPATH |
Linux |
LD_LIBRARY_PATH |
Solaris |
LD_LIBRARY_PATH |
Windows |
PATH |
z/OS |
LD_LIBRARY_PATH, LIBPATH |
- Restart the server. Document Conversion
Services is now installed on the remote server.
- 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.
Important: This property does not exist in wkplc.properties 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 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 2. 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 WebSphere Portal.
- For z/OS, start the Customization
dialog. Read Configuring the Portal Productivity Components for
instructions on enabling remote Document Conversion Services. You
must follow the Customization dialog instructions for submitting the
customization jobs.