Starting the GUI: start ADFjobs

We will assume that you have installed the full ADF package on your machines.

The most convenient way to start the GUI is to first start ADFjobs, one of the GUI modules. Using the SCM menu in ADFjobs (either the text SCM, or the SCM logo) you can next start any other GUI module that you have a license for.

Depending on your platform, you start ADFjobs in a slightly different way:

UNIX (such as Linux) users

In this tutorial we will assume that you have added $ADFBIN to your PATH. We advise you to do this if you have not already done so. If you do not wish to add $ADFBIN to your PATH, you must start the utilities using

$ADFBIN/adfjobs &

instead of just

adfjobs &

On all UNIX platforms, including Mac OS X, the GUI modules are XWindow (X11) programs. Your environment should have been set up correctly to run such programs. In particular, you need to make sure that your DISPLAY environment variable has been set properly.

You can test this easily by starting a simple X program from your shell:

xcalc &

Assuming the xcalc program is in your $PATH, a small window should appear with the image of a calculator. If not, please consult your local system administrator for additional help. Typical problems have to do with your DISPLAY variable, and with security issues when trying to connect to the X server.

When you log in to a remote linux UNIX system using ssh, make sure you are using X11 forwarding. You can force this by using the -X (sometimes with the -Y) flag to the ssh command. As ssh is taking care of setting your DISPLAY variable, you should make sure not to set it yourself.

Most GUI modules use OpenGL to render the 3D images. With X11 this is done using the GLX X11 extension. You can test if GLX is working properly by running the glxgears command:

glxgears

In case of troubles, the glxinfo command might also give useful information.

Windows users

In this tutorial we will assume that you have installed the ADF package using the Installer with all the options set to default.

You can start the GUI (adfjobs) by double-clicking its icon on the desktop.

Macintosh users

Macintosh users have several easy ways of starting the GUI modules: just like on any other UNIX system (thus, using the command line), or using the ADF2016.xxx program.

The easiest way is using the ADF2016.xxx program. When you start it, ADFjobs will be started automatically. Next you can use the SCM menu to start the other ADF-GUI modules.