 |
 |
 |
|
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:
- The next step is to choose the installation directory:
- After all this has been chosen, the G System can be compiled:
- While the G System is being compiled for your platform, you can have a look at the README file:
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:
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.
|
|
|
 |
|
 |
|
 |
 |