Installation

Due to the fact that the DbtuTools framework becomes more and more integrated, it is recommended you install the entire framework [more]. Nevertheless it will still be possible to install a single tool only [more].

Entire framework

One of the basic qualities of the DbtuTools framework is the ability to handle environments with multiple DB2 instances. This, and the use of dbtuswitch.sh [more], configuration-, temporary- and log files, makes it necessary to apply the /opt/dbtutools tree [more] prior to the installation of the tools. In future versions there will be an installation script for automating these steps:

  1. Ensure that you are logged in as the user root (using the whoami command).
  2. Create a group named "dbtuadm" within the operating system and add all users to this group, which will be using the DbtuTools framework later on.
  3. Create the /opt/dbtutools tree [more] including subtree per DB2 instance and apply the proper permissions and ownerships as well.
  4. Copy dbtuswitch.sh [more] and its configuration files dbtuswitch.cfg [more] from your build directory to /opt/dbtutools and ensure that the defaults within the configuration file meets your environment.
  5. Copy the binaries, (wrapper) scripts and JAR files (named in the following list) from your build directory to /opt/dbtutools/INSTANCE/tools/bin (where INSTANCE stands for the instance name):
    • Binaries:
      • dbtuapiwrapper
      • dbtulsts
      • dbtuwho
    • (Wrapper) scripts:
      • dbtuff2code
      • dbtugetss.sh
      • dbtupreptime
      • dbtutraffic
      • dbtuxconnect.sh
    • JAR files:
      • dbtutools.jar
  6. Optional: Copy the entire doc subdirectory content from your build directory to /opt/dbtutools/INSTANCE/tools/doc (where INSTANCE stands for the instance name).
  7. Optional: It's a good idea to add a dbtuswitch.sh call to the ~/.profile file of the users you added to the "dbtuadm" group above :
    . /opt/dbtutools/dbtuswitch.sh default

    Sample entry for the ~/.profile file.

Single tool only

As discussed above, it is not recommended to install a single tool only. Nevertheless it is possible for most of the tools. The effort differs based on the needed resources:

  1. Copy the tool of your choice from the build directory into your preferred target directory.
  2. Optional: If the selected tool is based on Java, you have to copy the JAR files for the build directory into your preferred target directory. Ensure the $CLASSPATH environment variable contains the entries for the JAR files as well.
  3. Optional: If the selected tool works with configuration-, log- or temporary files, you have to create the related parts of the /opt/dbtutools subtree within your preferred target directory (for example ~/db2inst1/tools/temp if ~/ represents the target directory). Ensure the $DBTUTOOLSHOME environment variable points to the chosen target directory.