Deprecated: mysql_connect(): The mysql extension is deprecated and will be removed in the future: use mysqli or PDO instead in /var/www/localhost/htdocs/g-system/inc.p.config.php on line 5

Notice: Undefined index: ID in /var/www/localhost/htdocs/g-system/inc.p.config.php on line 27
G System

Notice: Undefined index: ID in /var/www/localhost/htdocs/g-system/inc.h.page_top.php on line 85

Notice: Undefined index: ID in /var/www/localhost/htdocs/g-system/inc.h.page_top.php on line 90

Notice: Undefined index: TID in /var/www/localhost/htdocs/g-system/inc.h.page_top.php on line 95
 
How to install
These are instructions for installing the G System on Unix, Linux, MAC OS X and Windows.

Please consider whether you want to install from source code or ready-to-use binary packages.

Please contact us if you encounter any problems.

UNIX Platforms (source code)

Preparation

- Download all required files from the download page.
- Install Qt4 with qmake and a database plugin (SQLite and PostgreSQL are recommended):
	$ tar -xzf qt-x11-opensource-src-4.1.3.tar.gz  # or other version
	$ cd qt-x11-opensource-src-4.1.3
	$ ./configure -release -qt-sql-sqlite -qt-gif -no-qt3support
	$ make  # should be GNU make
	$ make install
	$ export PATH=/usr/local/Trolltech/Qt-4.1.3/bin:$PATH  # setenv on csh
	$ export LD_LIBRARY_PATH=/.../Qt-4.1.3/lib # DYLIB_LIBRARY_PATH on MAC
	
You should make sure that these environment variables are set permanently, for example by putting the above commands in your .profile

- Install the X3DToolKit with the following commands:
	$ tar -xjf X3DToolKit-1.1.tar.bz2
	$ cd X3DToolKit-1.1
	$ cd src
	$ qmake JPEG_DIR=/usr/local   # wherever you have JPEG installed
	$ qmake JPEG=no   # if the above doesn't work
	$ make  # it should be the GNU version of make
	$ cd ..
	$ cp -r include/X3DTK /usr/local/include  # or other prefix
	$ cp -R lib/* /usr/local/lib              # or other prefix
	


Installing

- The G System provides a graphical installation script, if you have problems with this, have a look at doc/INSTALL:
	$ tar -xjf G-System-0.6.0-BETA.tar.bz2
	$ cd G-System-0.6.0
	$ ./installer
	
As an alternative you can extract the tar ball and simply click on the installer script from within Konqueror.

- The installer will greet you with a choice of what to install:
Component Selection

- The next step is to choose the installation directory:
Installation Directory

- After all this has been chosen, the G System can be compiled:
All Ready

- While the G System is being compiled for your platform, you can have a look at the README file:
All Ready

You will be notified as soon as the installation is completed which takes between 4 and 10 minutes, depending on your hardware and selected components.

Configuration

- After installing you should run god to create an initial configuration:
	$ god
	
This will show you the configuration dialog:
god

You should make sure that you choose a master_server that is also UP and available. Have a look at the server status page to find a suitable server.
Set the identity to the username that you desire. This will be visible to other users.

Troubleshooting

Make sure that the qmake application from Qt4 is in your path. You must not use Qt3. You should set QMAKESPEC to the correct value.
The cleancompile script requires you to have all environment variables set. So you should work with ./scripts/cleancompile if there are any problems with the normal procedures.

If you have the X3DToolKit installed in an unusual location, you can set the X3DTK_LIB_DIR and X3DTK_INC_DIR environment variables before compiling the G System. Additionally you can set additional linker flags with the G_EXTRA_LIBS environment variable, like -L/usr/local/lib
You should use ./scripts/cleancompile if you set the variables after you already tried to compile the G System(!) because ./scripts/compile doesn't regenerate the makefiles.

If installations fails while making the documentation, you should consider simply deselecting the documentation component in the installer. The documentation requires xsltroc, docbook-xsl and other packages while the API documentation needs doxygen and graphviz additionally. If you don't have these, simply don't install the documentation.

If any problems remain, please contact us on the mailing lists.