Configure Images for Document Conversion Services
In HCL Portal versions CF205 and later, DX Document Conversion Services is automatically configured to use HCL-supported functions. The third-party component, which was supplied by Oracle, is no longer included. In HCL Portal versions CF204 and earlier, HCL Portal installations upgraded from CF203 or CF204, and HCL Portal installations upgraded after manually backing up the Oracle Stellent files, configure the Document Conversion Services to view images in an operating system other than Windows.
-
Connect to one of the following workstations from your Windows™ workstation with PuTTY or any other Telnet client.
- AIX®
- Linux™
-
The oiexport directory should be in the PATH as wp_profile_root/PortalServer/config/oiexport:$PATH
For example,
export PATH = wp_profile_root/PortalServer/config/oiexport:AppServer_root/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 operating systems, as detailed in the following table:
Platform Library path variable AIX LIBPATH Linux LD_LIBRARY_PATH For example, in case of Linux, the command might be
export LD_LIBRARY_PATH = wp_profile_root/PortalServer/config/oiexport:/usr/X11R6/lib
-
Now connect to another workstation through XBrowser.
-
Start the XBrowser and enter the host name. When you log in successfully, type
echo $DISPLAY
at the prompt. Which gives you<machine-ip>:0.0,
, where<machine-ip>
refers to the IP of the workstation from where XBrowser was started. -
In the same Telnet/ssh session where you exported PATH and LD_LIBRARY_PATH/LIBPATH/SHLIB_PATH, type the command
export DISPLAY=<machine-ip>:0.0
. This value is the same as the value you get in the previous step. -
Change directory to the location where the
xclock
andxhost
files are present, such as,/usr/X/bin
. -
Type the command
./xclock &
. -
Type
./xhost +
on the workstation through which you are connected through XBrowser.Which gives you the message
access control disabled, clients can connect from any host.
Note
Changing directory is required because by entering the commands
xclock&
orxhost+
, the error messagecommand not found
is displayed. -
The Xclock menu comes up on the desktop of the workstation to which you are connected through X-Browser.
-
Change directory to AppServer_root/bin`.
-
Restart the server.
-
Open a web browser and try viewing the file that contains the images.
Starting the X server by using Exceed or X virtual frame buffer (Xvfb)
The previous steps are given to start the X server by using XBrowser. The following steps are used to start the X server by using Exceed or X virtual frame buffer (Xvfb).
-
Start Exceed.
-
Connect to one of the following workstations with PuTTY and then type
export PATH
.- AIX
- Linux
-
Type
export LD_LIBRARY_PATH/LIBPATH/SHLIB_PATH
. -
Type
export DISPLAY
. -
Type
echo $DISPLAY
on the workstation to which you connected by using Exceed or Xvbf. -
Enter
xclock &
(ifxclock
displays on the desktop of the workstation to which you are connected through Exceed or Xvfb, then X server is running). -
If
xhost + {xhost + <IP>}
displays, this means conversion works for this particular IP and only + means for all workstations.You must start HCL 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 Window System server, since they require access to the Xm, Xt and X11 libraries. Also, the DISPLAY environment variable must be set to the account that Portal is running under. The DISPLAY must be valid at the point that Portal is started. Otherwise, telnetting to a workstation and starting Portal from there does not work. You must start Portal from an X terminal.