Configuring the Sametime Meeting Server for document conversion on AIX

Configure document conversion on an IBM Sametime Meeting Server running on AIX®.

About this task

The Document Conversion server component of the Meeting Server uses stellent libraries to convert files for display. The libraries are located in the following directory: /opt/IBM/WebSphere/STMeetingsServer/stellent

Procedure

Complete the following steps on the Sametime® Meeting Server that you installed with the Document Conversion configuration role.

Install the X Virtual Frame Buffer (Xvfb) and configure it to run whenever you start WebSphere® Application Server:
1. Install the XVFB packages from your operating system CDs:
  - OpenGL.OpenGL_X.dev.vfb.05.01.0000.0000 or the equivalent
  - X11.vfb.05.01.0000.0000 or the equivalent
Use one of the following methods to set the environment variables for document conversion.

Method 1: Configure the environment variables in Xvfb by completing the following steps:
1. Log in from a terminal shell as the root user and from a command line set the following environment variables for document conversion:
```
PATH=$PATH:/opt/IBM/WebSphere/STMeetingsServer/stellent
export PATH 
LIBPATH=$LIBPATH:/opt/IBM/WebSphere/STMeetingsServer/stellent
export LIBPATH
/usr/bin/X11/X -vfb -x GLX -x abx -x dbe -force :1 &
```
2. Verify that the VFB is running properly by entering the following command:
  /usr/lpp/X11/Xamples/bin/xprop -display server_name:1 -root | grep VFB
  Where server_name is the fully qualified server name of your AIX server and 1 is the display number you have associated with this instance of the XVFB. It can be any number except 0.
  The following message appears:
```
XVFB_SCREEN(STRING) = "TRUE"
```
3. Set the DISPLAY variable to the display number you defined in the previous step:
```
DISPLAY=server_name:1 
export DISPLAY 
```
Method 2: Set environment variables in the /etc/profile file by completing the following steps.
The environment variables PATH, LIBPATH, XVFB, and DISPLAY must be set in the same terminal session where the stellent conversion library is used. You can set these variables in the /etc/profile file, which is read on login or when the bash shell is invoked.
1. Append the following lines to /etc/profile, using the vi editor or another editor.
```
PATH=$PATH:/opt/IBM/WebSphere/STMeetingsServer/stellent
export PATH
LIBPATH=$LIBPATH:/opt/IBM/WebSphere/STMeetingsServer/stellent
export LIBPATH
/usr/bin/X11/X -vfb -x GLX -x abx -x dbe -force :1 &
DISPLAY=`hostname`:1
export DISPLAY
```
2. Run each of the following commands on a command line to verify that the environment variables are set correctly:
  - echo $PATH
  - echo $LIBPATH
  - echo $DISPLAY
3. Verify that the VFB is running properly by entering the following command:
  /usr/lpp/X11/Xamples/bin/xprop -display server_name:1 -root | grep VFB
  Where server_name is the fully qualified server name of your AIX server and 1 is the display number you have associated with this instance of the XVFB. It can be any number except 0.
  The following message appears:
```
XVFB_SCREEN(STRING) = "TRUE"
```
Restart the Sametime Meeting Server and node within the same terminal session.
Set the value docshare.pdf.ghostscript to false in the Sametime System Console.