The following topic describes how to configure X11 to run TrackStudio.
TrackStudio does not contain graphical libraries for generating colors, fonts or other AWT information. Java relies on your system's libraries for providing such information, and so an environment capable of providing AWT information and a graphics card (for exporting to static formats) are required.
In a Windows environment, nothing extra needs to be done to set up such an environment, as a GUI interface and graphics card already exist by default.
For non-Windows environments, such is usually not the case. You need to have X or some form of X running on such systems and point the display to the machine running X (such as running the command
in a korn shell). For best performance, TrackStudio recommends running X on the machine (or setting the DISPLAY to point to another machine running X). However, if that is not an acceptable solution, there are alternative solutions available.
If your TrackStudio UNIX server does not have an X11 Server installed or the DISPLAY environment variable is not set, you may receive one of the following errors when executing your reports:
Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable., stack: java.lang.InternalError: Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable. at sun.awt.X11GraphicsEnvironment.initDisplay(Native Method)
Internal error: exception thrown from the servlet service function (uri=/xxx/xxx2.jsp): java.lang.NoClassDefFoundError: java/awt/SystemColor, stack: java.lang.NoClassDefFoundError: java/awt/SystemColor at com.sas.visuals.BaseBorder.<init>(BaseBorder.java:209)
Possible circumventions follow:
Where to specify the options will vary between servlet engines. For Tomcat 5.x, you would specify these options in the catalina.bat or catalina.sh file for CATALINA_OPTS.