Installation Guide for UNIX This section provides instructions to install iQ.Suite under Domino 5 and Domino 6 on IBM AIX, Linux and SUN Solaris 8 operating systems. The installation consists of the following steps: 1. Copy files to server Copy the tar file (e.g. lgrp750.tar) to /tmp (via FTP) Call tar -xvf lgrp750.tar All files required for installation are now located in /tmp/tk_install Please make sure the Domino user (under which the Domino server is started) has read rights to this directory! 2. Before starting the installation script, make sure all Domino servers have been shut down and you are logged in as 'root'. 3. Start the installation script => ./install.sh , where is the Notes program directory (e.g. /opt/lotus/notes/latest/sunspa) and the Notes data directory (e.g. /export/home/domino/notesdata) (both parameters my be omitted when calling the script, in which case they are prompted for at a later stage). 4. Installation sequence The installation is run in either English or German (depending on how the $LANG environment variable is set). If $LANG is not set at all, the language is selected interactively. You are next asked to confirm that you are logged in as 'root' and that the Domino server(s) has/have been shut down. Then enter the name and the group of the user under which the Domino server is started. This is to make sure the owner rights of the files to be installed are set correctly during the installation. The installation script deletes any existing iQ.Suite specific semaphores and 'shared memories'. Next confirm that 'GROUP-TOOLS-ADMIN' is to be the Administrator for iQ.Suite or enter another Administrator if this question is answered with 'No'. Now select the type of installation for the configuration databases. You may choose between standard installation and an installation in replicated environments. Standard installation means that the databases provided with the installation package will be installed. Installation in replicated environments means that the databases to be installed are replicas of the databases on another server. In that case, enter the name of that server (Master Server) as well as the directory where the databases are located (under the Notes data directory). The actual installation will start now. If it does not exist already, a grptools directory is created under the Notes data directory. Most of the files are copied to that directory. If running an 'installation in replicated environments', you may now check whether the Master Server is running and start if required (important if running the installation in an environment of partitioned servers). Then a program installs the databases ad modifies the notes.ini parameters as required. 4.1. Installation in replicated environments To run an installation in replicated environments, the following requirements have to be met: a) The target server must have access rights to the Master Server. b) A working network connection between both servers. c) The Master Server databases (to be replicated) must have read rights (as user) for the target server. d) Both the Master Server and the "local" server have to be started. 5. Set environment variables Before starting iQ.Suite, a few environment variables have to be set in the .profile of the Notes user. 5.1 .profile extensions 5.1.1 Sun/Solaris Add the following lines: if [ -n "$LD_LIBRARY_PATH" ] then export LD_LIBRARY_PATH=/grptools/bin else export LD_LIBRARY_PATH=/grptools/bin:$LD_LIBRARY_PATH fi 5.1.2 IBM/AIX Add the following lines: if [ -n "$LIBPATH" ] then export LIBPATH=/grptools/bin else export LIBPATH=/grptools/bin:$LIBPATH fi 5.1.3. Linux Add the following lines (to .profile or .bash_profile): if [ -n "$LD_LIBRARY_PATH" ] then export LD_LIBRARY_PATH=/grptools/bin else export LD_LIBRARY_PATH=/grptools/bin:$LD_LIBRARY_PATH fi For an installation under Linux, the installation script adds the following line to the /etc/ld.so.conf file: /grptools/bin Please check this file to confirm the line has been added. 6. Check notes.ini The notes.ini file must contain the following entry: ServerKeyFileName=server.id Note: If the ServerKeyFileName entry is missing in the notes.ini file, please add the line above manually (where "server.id" represents the corresponding Server-ID file). Make sure this ID file is located in the Notes data directory. After the installation, the notes.ini file must contain the following entries: extmgr_addins=te_hook ServerTasks=...., tm_grab, td_grab Toolkit_DataDir=grptools Toolkit_ExecDir=/grptools Toolkit_Admin=GROUP-TOOLS-ADMIN (or value entered during installation) Toolkit_Loglevel=6 Toolkit_MailIntercept=YES Toolkit_MgrabThreads=5 Toolkit_DgrabThreads=5 If you plan to run iQ.Suite on a partitioned server, the entry: Toolkit_ServerInstance=001 has to be added manually, with servers numbered consecutively. This in particular also applies to Domino servers run in operating system clusters, in which case the numbering must be unambiguous throughout the entire cluster. Example: Server1 (notes.ini): ToolKit_ServerInstance=001 Server2 (notes.ini): ToolKit_ServerInstance=002 7. Silent installation It is also possible to run an installation under Unix in the command line without dialog entries (Silent Installation). To do so, the selected installation sequence first has to 'recorded' by running the normal installation with an additional parameter: --> ./install.sh rec All dialog entries are then recorded in a 'silent_rec_dat' file located in the current directory. Entering the command --> ./install.sh