Siebel Analytics Installation and Configuration Guide > Installing Siebel Analytics Software in the UNIX Environment > Installing Siebel Analytics Web Under UNIX >

Configuring Xvfb for Siebel Delivers


Each platform has its own particular way of starting Xvfb, and the Xvfb start process is outlined separately for Solaris, AIX and HP-UX. In each case root access may be required.

NOTE:  These directions are tips or guidelines. Consult the documentation from the hardware vendor for details.

In addition to have a different starting process, each platform implements certain security rules by which users may or may not access a specific X screen. If you do not wish to run PCIS as root, consult your hardware vendor's documentation regarding security restrictions with Xvfb usage. It it not necessary for PCIS to run as the default user of the rest of the Siebel Analytics processes.

To configure Xvfb on Solaris

Assuming that Xvfb is installed at /usr/X11R6/bin/Xvfb:

  1. Configure Xvfb on display 1 screen 0.
  2. Start Xvfb (from bash or sh) using
  3. /usr/X11R6/bin/Xvfb :1 -screen 0 1024x768x8 > /dev/null 2>&1 &

    In this case the DISPLAY environment variable in the pcis.settings file must be set to :1.0. For example:

    DISPLAY=:1.0

To configure Xvfb on AIX

The IBM X server has been extended to support Xvfb.

  1. Install the X11.vfb and OpenGL.OpenGL_X.dev.vfb packages.
  2. Reboot the system after installing these packages, as they require a kernel extension to be loaded at boot time.
  3. NOTE:  Consult AIX documentation for details regarding the installation procedure for Xvfb, as well as any necessary system patches.

  4. After you have installed the software, execute the following command to start Xvfb:
  5. /usr/bin/X11/X -force -vfb -x abx -x dbe -x GLX &

    For an example of a machine without graphics hardware, where there is no X server running on display 0, configure the Xvfb server to run on display 0.

    In this case the DISPLAY environment variable in the pcis.settings file must be set to :0.0. For example:

    DISPLAY=:0.0

To configure Xvfb on HP-UX

There are three tasks required to get Xvfb running on HP-UX:

To configure the Xvfb server

  1. In order to configure Xvfb, decide on a display number and a screen. For example, use display 1 and screen 0.
  2. All HP X servers use configuration files named X#screens (where # is the display number). The X#screen configuration files are located in the directory /etc/X11.

  3. Create the file /etc/X11/X1screens (from the example in which display 1 is the Xvfb display) and add the following two lines:
  4. ServerOptions

    ServerMode XVfb

  5. Start the Xvfb server by issuing the following command:
  6. /usr/bin/X11/X :1 -screen 0 1024x768x24 &

    In this case the DISPLAY environment variable in the pcis.settings file must be set to :1.0. For example:

    DISPLAY=:1.0

Refer to the man page for the X server for additional Xvfb options.


 Siebel Analytics Installation and Configuration Guide, Version 7.5, Rev. C 
 Published: 18 April 2003