Configure Document Conversion Services
Configure DCS in non-Windows platforms
The following steps apply to all non-Windows platforms except for IBM i.
- Ensure that the oiexport directory is in the PATH as...
WP_PROFILE/PortalServer/config/oiexport:$PATH
For example,
export PATH = WP_PROFILE/PortalServer/config/oiexport:WAS_HOME/java/jre/bin:$PATH
- Export...
LD_LIBRARY_PATH / LIBPATH / SHLIB_PATH
...to point to the oiexport directory and the graphics library directory. This environment variable is different for different platforms:
Platform Library path variable AIX LIBPATH Linux LD_LIBRARY_PATH Solaris LD_LIBRARY_PATH z/OS LD_LIBRARY_PATH, LIBPATH For example, in AIX , the command might be...
export LIBPATH = WP_PROFILE/PortalServer/config/oiexport:/usr/X11R6/lib
Required library: On Solaris and Linux, the following library is required to run document conversion services: libstdc++.so.5. This library is included with GNU Compiler Collection (GCC) 3.2 to 3.3.6.
Install libstdc++.so.5 and include the folder containing the library in the library path variable.
For example, in Linux, the command might be...
export LD_LIBRARY_PATH = WP_PROFILE/PortalServer/config/oiexport:/usr/X11R6/lib:/user/lib
Configure DCS for IBM i
To perform document conversions on IBM i:
- Log in to the WAS admin console and select...
Servers | Server Types | WebSphere appservers | WebSphere_Portal | Server Infrastructure | Java and Process Management | Process definition | Additional Properties | Environment Entries | LIBPATH
- In the Value field, add the following to the entry: :/QOpenSys/usr/bin:/QOpenSys/usr/bin/X11:/QOpenSys/usr/sbin.
- Click Apply and save the changes to the master configuration.
The value for the LIBPATH environment entry displays as follows:
WP_PROFILE/PortalServer/config/oiexport:/QOpenSys/usr/bin:/QOpenSys/usr/bin/X11:/QOpenSys/usr/sbin
- Restart WAS.
Configure images in non-Windows platform
The following steps apply to all non-Windows platforms except for IBM i.
To view images in non-Windows platforms:
- Connect to the non-Windows machine from your Windows machine using PuTTY or any other Telnet client.
- The oiexport directory should be in the PATH as...
WP_PROFILE/PortalServer/config/oiexport:$PATH.
For example...
export PATH = WP_PROFILE/PortalServer/config/oiexport:WAS_HOME/java/jre/bin:$PATH
- Export LD_LIBRARY_PATH /LIBPATH/ SHLIB_PATH to point to the oiexport directory and the graphics library directory. This environment variable is different for different platforms:
Platform Library path variable AIX LIBPATH Linux LD_LIBRARY_PATH Solaris LD_LIBRARY_PATH z/OS LD_LIBRARY_PATH, LIBPATH For example, in case of Linux, the command could be...
export LD_LIBRARY_PATH = WP_PROFILE/PortalServer/config/oiexport:/usr/X11R6/lib
- Now connect to another non-Windows machine through XBrowser.
- Start the XBrowser and enter the host name. Once you login successfully, type echo $DISPLAY at the prompt. This will give you <machine-ip>:0.0,, where <machine-ip> refers to the ip of the machine from where XBrowser has been started.
- In the same Telnet/ssh session where you have exported PATH and LD_LIBRARY_PATH/LIBPATH/SHLIB_PATH, type the command...
export DISPLAY=<machine-ip>:0.0
This value will be the same as the value you get in the previous step.
- Change directory to the location where the xclock and xhost files are present, for example...
/usr/X/bin
- Type the command ./xclock &.
- Type ./xhost + on the non-Windows machine through which we are connected through XBrowser. This will give you the message access control disabled, clients can connect from any host.
Change directory is required because by entering the commands xclock& or xhost+, the error message command not found is displayed.
- The Xclock popup comes up on the desktop of the non-Windows machine to which we are connected through X-Browser.
- Change directory to WAS_HOME/bin.
- Restart the server.
- Open a web browser and try viewing the file containing images.
The previous steps are given to start the X server using XBrowser. To start the X server using Exceed or X virtual frame buffer (Xvfb):
- Start Exceed.
- Connect to the AIX, Linux, or Solaris machine using PuTTY and then type export PATH.
- Type...
export LD_LIBRARY_PATH/LIBPATH/SHLIB_PATH.
- Type...
export DISPLAY.
- Type...
echo $DISPLAY
...on the machine to which you have connected using Exceed or Xvbf.
- Enter xclock & (if xclock appears on the desktop of the non-Windows machine to which we are connected through Exceed or Xvfb, then X server is running).
- If xhost + {xhost + <IP>} appears, this means conversion works for this particular IP and only + means for all machines.
When using AIX, Linux, or Solaris, you must launch WebSphere Portal from the console or an X Server-enabled client with the same privileges (xhost+) as the console. The graphical conversions require access to an X-Windows server, since they require access to the Xm, Xt and X11 libraries. Also the DISPLAY environment variable must be set to the accounthat Portal is running under. Note that the DISPLAY must be valid at the point that Portal is started. Otherwise, telneting to a machine and starting Portal from there does not work. You will need to start Portal from an X terminal.
Visual C++ libraries are required for Windows 2003
To run DCS on Windows2003, you need to download Visual C++ libraries included in the Visual C++ 2005 SP1 Redistributable Package available from the Microsoft download site. There are three versions of this package, x86, x64, and IA64 for the 86 - bit, 64 - bit, and 64 - bit Itanium-based systems, respectively.
You need to search the Microsoft download site for the files vcredist_x86.exe, vcredist_x64.exe, or vcredist_IA64.exe. The required version of each of these downloads is the 2005 SP1 Redistributable Package or newer.
Parent: Enable Document Conversion Services
Related:
Render documents on IBM i