
	News \| FAQs \| Contacts

WebMap Composer Product Home

	Requirements
	Install Note
	Release Note
	Configuration

Tomcat environment variables; no map / headless server and unexpected XML encoding

The following apply to Linux/Solaris servers.

Server without graphics card

If WebMap Composer isn't producing map images for locally rendered data, check if your server has a graphics card.

If your server doesn't have a graphics card, you need to set up Xvfb (X virtual frame buffer) and reference it as follows. Most recent X distributions should provide an Xvfb executable. (The Java VM headless switch does not work with WebMap Composer 1.x, 2.x).

In $TOMCAT_HOME/bin.startup.sh, add the following at the top of the file:

DISPLAY=:1; export DISPLAY

echo using DISPLAY=$DISPLAY

xvfb needs to be started in a compatible manner, eg

/usr/X11R6/bin/Xvfb :1 -screen 0 1000x800x8 &

A sample init.d script for starting xvfb is given at the end of this page.

XML data isn't being styled / set locale

Parts of a WebMap Composer application may not style XML encoded data; ie appear blank. This may be due to a locale setting, whereby the XML is returned referencing a character encoding not understood by the style sheet engine, eg something like "ANSI_X3.4-1968". This may be resolved by adding the following to $TOMCAT_HOME/bin.startup.sh.

LC_ALL="en_US.UTF-8"; export LC_ALL

echo LC_ALL=$LC_ALL

LANG="en_US"; export LANG

echo LANG=$LANG

Below is an etc/init.d script we use for starting Xvfb. Essentially you need to start Xvfb with the following parameters:

/usr/X11R6/bin/Xvfb :1 -screen 0 1000x800x8

#!/bin/sh

#

# Xvfb:    Starts the virtual frame buffer used by jrun to

# display maps

#

# Version:

#

# description:

#

# processname:

# jrobens/marcus 19991130

                                                                                                                                                            

XPATH="/usr/X11R6/"

XVFB_PROG="${XPATH}bin/Xvfb"

XVFB_ARGS=":1 -screen 0 1000x800x8"

                                                                                                                                                            

# Source function library.

. /etc/rc.d/init.d/functions

                                                                                                                                                            

# See how we were called.

case "$1" in

  start)

        echo -n "Starting the X-Virtual Frame buffer"

        ${XVFB_PROG} ${XVFB_ARGS} &

        echo

        ;;

  stop)

        echo -n "Stopping the X-Virtual Frame buffer: "

        killproc ${XVFB_PROG:-nogood}

        rm -f /tmp/.X0-lock

        echo

        ;;

  restart)

        $0 stop

        $0 start

        ;;

)


        echo "Usage: $0 {start|stop|status|restart}"

        exit 1

esac

                                                                                                                                                            

exit 0

Sort Support FAQs by Subject | Date