# Installation

This section describes how to install, configure and build the Qt Toolkit under OS/2.

## Requirements

In order to build the Qt Toolkit Version 3 under OS/2 or eComStation you need the following tools:

- Compiler: Innotek GCC 3.3.2 for OS/2 beta 4 updated to CSD1.
  Download and install according to the installation instructions (`usr\doc\GCC-3.2.2\Install.os2`).
- Linker: IBM ILINK 3.08, a part of the IBM Visual Age C/C++ 3 distribution updated to version 3.08.
  You need only two files, `BIN\ILINK.EXE` and `DLL\CPPOM30.DLL`. If you already have IBM Visual Age C/C++ installed, you don't need to do anything else. Otherwise, copy the above two files to some directory.
- Make utility: GNU Make 3.81beta1. Just unzip the file `make.exe` to some directory.

Check that the above tooks work, and then proceed to the following step.

## Building Qt

1. Unzip the contents of the Qt for OS/2 distribution archive to some directory.
2. Go to that directory, run the `configure.cmd` script and follow on-screen instructions.
   You will be prompted to enter directories where the script will search for the required tools and to configure the library type you want to build. Note that it is not necessary to remember a full path to a tool -- you can specify an upper-level directory or simply a root directory of the drive you have installed the tools onto.
3. Wait until the compilation process is finished.

If the compilation process fails, you can inspect the file `build.log` created in the installation directory.

After the Qt library is successfully compiled and built, it is recommended that you place the `qt.cmd` script that was generated in the installation directory to some of the directories listed in your `PATH` environment variable and use it as a command line wrapper to work with the Qt Toolkit: run tutorials and examples, compile your own programs, etc. The script sets up the environment necessary for the Qt Toolkit and for all other tools and simply passes all command line arguments to the command line interpreter. For example, in order to run the last Qt tutorial application, go to the subdirectory `tutorial\t14` located inside the installation directory and execute the following command (provided that you have already placed `qt.cmd` somewhere in the `PATH`):

    qt.cmd t14.exe

To recompile the tutorial you can type

    qt.cmd make