Basic Installation
Requirements
- A Linux or FreeBSD compatible operating system.
- At least the Qt 3.3.*
development library (Qt 4 not yet supported).
- At least the Berkeley DB 4.1
database. FreeBSD users are required to use the 4.3 version.
- Better to install the binary packages of the Qt and DB that are
relevant to your particular operating system.
Installing from source
Binary package users can ignore this advice as this will be done
automatically by the package installer.
Ensure that DB is installed properly
If you installed DB at a non-standard location,
then edit the "configure" file (e.g. "INCLUDEPATH +=
/opt/local/include/db4").
Also make sure that you have installed DB properly, e.g. some
installations
miss symbolic links in the lib directory.
For Linux users:
- Check to make sure you have your shell QTDIR environment variable
set to point to the location of the root Qt directory. This setting is
usually something like this: 'export QTDIR=/usr/lib/qt' or something
similar to this. Failure to set this properly will result in make
errors.
- Unpack the Qtstalker source.
- ./configure (this will create the Makefile)
- make
- make install (as root)
- the executable 'qtstalker' will be copied to the /usr/bin
directory
- the plugins will be copied to /usr/lib/qtstalker directory
- the docs will be copied to /usr/share/doc/qtstalker/html
directory (toc.html for the table of contents)
- the translation files will be copied to
/usr/share/qtstalker/i18n directory
- Thats it.
For FreeBSD users:
- We have to set a few environment variables first in your shell.
Enter this 'export QTDIR=/usr/X11R6' Then enter this 'export
QMAKESPEC=/usr/local/share/qt/mkspecs/freebsd-g++' . Failure to set
these variables properly will result in make
errors.
- Unpack the Qtstalker source.
- ./configure (this will create the Makefile)
- make
- make install (as root)
- the executable 'qtstalker' will be copied to the /usr/bin
directory
- the plugins will be copied to /usr/lib/qtstalker directory
- the docs will be copied to /usr/share/doc/qtstalker/html
directory (toc.html for the table of contents)
- the translation files will be copied to
/usr/share/qtstalker/i18n directory
- Thats it.
For Macintosh OS X users (Tiger 10.4+):
- Get Berkeley DB using Darwinports.org
('sudo port install db4') or Fink.sf.net
- Get Qt for Aqua. Trolltech says must be qt-3.3.5
so use 'fink --tree=unstable qt3mac'.
- Set your shell QTDIR environment variable to point where you
installed Qt.
e.g. 'export QTDIR=/sw/lib/qt3mac' or something similar.
Failure to set this properly will result in make errors.
- Unpack the Qtstalker source.
- edit the "configure" file to be:
qmake "DEFINES += QT_NO_COMPAT" "CONFIG += qt" "macx:INCLUDEPATH += /opt/local/include/db4" "macx:LIBS += -L/opt/local/lib" -o Makefile qtstalker.pro
- ./configure (this will create the Makefile)
- make
- sudo make install
- the executable 'qtstalker' will be copied to the /usr/bin
directory
- the plugins will be copied to /usr/lib/qtstalker directory
- the docs will be copied to /usr/share/doc/qtstalker/html
directory (toc.html for the table of contents)
- the translation files will be copied to
/usr/share/qtstalker/i18n directory
- To start, type 'open /usr/bin/qtstalker'
Updating a previous version.
If you are updating from a previous source version already installed on
your system, it is best
that you first uninstall the previous version first before you install
the upgraded version. Doing this will better ensure a problem-free
upgrade. Many upgrade errors can be caused by old plugins and libraries
hanging around complicating things. You can uninstall the old version
by doing a 'make uninstall' from the root directory of the old source
install.
Using the current development source.
See instructions for using CVS.
