Next Previous Contents

2. Installation

2.1 How to obtain QtEZ

you can get the latest QtEZ from http://www.ibl.sk/qtez
or a mirror QtEZ page at    http://go.to/qtez

2.2 Requirements

1) Linux 2.x or higher (ELF system) with X windows on PC
2) The Qt Tool kit version 2.x or higher from the trolls
 
 

2.3 Compilation and installation

In order to compile and install QtEZ on your system, type the following in the base directory of the QtEZ distribution:
For 0.83 and earlier
% ./configure
% perl automoc
% make
% make install
For 0.85 and later
% ./autogen.sh
% ./configure
% make all
% make install
If you run into problems, you may want to look at these more detailed instructions,
which are included in the INSTALL file.

1) Install and compile Qt V 2.x This is available from http://www.troll.no

2) Set the environment variable QTDIR to your Qt v2 source directory
for example (if your shell is bash) if your Qt source is in /usr/local/qt2, type :

export QTDIR=/usr/local/qt2

You may need to add this in your .profile , .bash_profile or .bashrc file
as well. QtEZ has traditionally used $QTDIR to find the Qt source headers.

3) From the QtEZ source directory type
 

For 0.83 and earlier

  ./configure
  perl automoc
  make
  make install
 

For 0.85 and later
./autogen.sh
../configure
make all
make install

  For a non-default $QTEZ location use:
   ./configure --prefix=DIR
  where DIR is the location of your $QTEZ directory (see next section)

*** The following mirrors what 'make install' does. It is included here
         to help those without root access to the system they use.  ***

4) Since QtEZ v 0.80.x, important files needed by QtEZ have been stored in
a directory identified by the QTEZ environment variable. These files are
located in the template subdirectory of the QtEZ source directory.
The default location for QTEZ is /usr/local/share/qtez.  or /usr/local/qtez
depending on the version  of QtEZ. If this doesn't exist on your system and you have root access,
you should create it. Otherwise you will have to create a directory where you
have read/write access and point QTEZ to that directory.

So, for the default location, from the QtEZ source directory type

  mkdir /usr/local/share/qtez
  export QTEZ=/usr/local/share/qtez
  cp template/* /usr/local/share/qtez -r

If you wanted to use ~/qtez for your $QTEZ location, you would type

  mkdir ~/qtez
  export QTEZ=~/qtez
  cp template/* ~/qtez -r

5) It is important that the file "automoc" found in the template directory
be in your path. You can create a symbolic link, or copy it to a directory
in your path, like /usr/local/bin or /usr/bin.
It is also important that the first line of that file point to the correct
location of your perl executable. It defaults to :

#!/usr/local/bin/perl

If on your system perl is located in /usr/bin, change this line to :

#!/usr/bin/perl

6) Run QtEZ to make sure everything is configured correctly. There are
numerous messages that will warn you if something is not correct.
Hopefully the instructions above will be enough to keep you from ever
seeing these messages. If you do see one however, there should be enough
information to help you fix the problem. To run qtez, from an Xterminal type

qtez &

If this fails because it can't find qtez, then your path isn't set to
look where qtez was installed. Either link qtez to a location in your
PATH variable, change your $PATH to include it's location or just run
it from the src directory. For example, from the source directory type:

src/qtez &

6) That should get you to where you can run QtEZ. We hope you will have
great success using QtEZ and if you find bugs please report them to the
maintainer of the distribution you are using.


Next  Previous Contents