13. Installing DB2 Version 8.2 on Gentoo (2005-01-17)

13.1. Pre-installation notes

Emerge the rpm package and any of its pre-requisites:

emerge rpm

If you want to run a multiple-partition environment, you will need to emerge either the pdksh or ksh package.

13.2. Installation notes

Gentoo uses the latest version of the GNU coreutils package of utilities, which includes the tail command. The DB2 install script (db2_install) and several instance administration shell scripts rely on deprecated command line arguments to tail that have been removed entirely from the latest GNU coreutils version of tail. Therefore, you must copy the contents of the install CD and modify the db2_install script before you can successfully run the install.

The RPM packages supplied with the DB2 install CD contain dependency listings that cannot be satisfied inside a Gentoo environment, because Gentoo does not use RPM as a native packaging method. To overcome these dependencies, you also need to modify the db2_install script to ignore dependencies and force the installation of DB2 onto your system.

Perform the following steps to modify the db2_install script for the required tail and rpm changes and install the product:

1. (Skip this step if you downloaded a tarball containing the DB2 install code.) Assuming you want to copy the contents of the DB2 install CD to a subdirectory named "cdrom" in your home directory, issue the following command:

   cp -r /mnt/cdrom/* ~/cdrom

2. Open the ~/cdrom/db2/linux/db2_install script in your text editor and modify the following lines

   From:

   output_df="`df -k ${dirname2?} | tail -1`"

   To:

   output_df="`df -k ${dirname2?} | tail -n -1`"

   From:

   ( rpm -ivh ${INSTDEV?}/${pkg?}${RPMEXTN?} 2>&1; \ echo $? > ${TMPRC?} ) | tee -a ${DB2INSTLOG?}

   To:

   ( rpm --force --nodeps -ivh ${INSTDEV?}/${pkg?}${RPMEXTN?} 2>&1; \ echo $? > ${TMPRC?} ) | tee -a ${DB2INSTLOG?}

3. Change to the ~/cdrom directory and issue the following command as root:

   ./db2_install

4. The DB2 installer prompts you to enter the keyword of the product you want to install. for example, issuing the db2_inst command for the DB2 UDB Express Edition for Linux install displays the following screen:

   Specify one or more of the following keywords, separated by spaces, to install DB2 products. Keyword Product Description DB2.EXP DB2 UDB Express Edition for LINUX Enter "help" to redisplay product names. Enter "quit" to exit. *********************************************************** DB2.EXP

The DB2 installer will now install many RPM packages into the /opt/IBM/db2/V8.1/ directory.

13.3. Post-installation notes

Now that you have installed DB2, you need to create the groups, users, DB2 Administration Server instance, and database instance for your database. The following instructions create users and groups with the default names used in the DB2 documentation (dasadm1, db2inst1, db2fenc1).

1. As root, create the required groups:

   groupadd -g 999 db2iadm1 groupadd -g 998 db2fadm1 groupadd -g 997 dasadm1

2. As root, create the required users and assign them to their corresponding groups:

   useradd -u 1004 -g db2iadm1 -m -d /home/db2inst1 db2inst1 useradd -u 1003 -g db2fadm1 -m -d /home/db2fenc1 db2fenc1 useradd -u 1002 -g dasadm1 -m -d /home/dasusr1 dasusr1

3. Before you can create the DB2 Administration Server and database instance, you have to modify the db2iutil library to update calls to the tail command to the current GNU syntax. As root, open the /opt/IBM/db2/V8.1/instance/db2iutil file in an editor and make the following changes (or apply the changes to the file using the patch utility):

   --- db2iutil.orig 2005-01-17 07:05:58.000000000 -0500 +++ db2iutil 2005-01-17 07:06:32.000000000 -0500 @@ -327,7 +327,7 @@ fi # Get output of the "df" command - output_df="`df -k ${dirname2?} | tail -1`" + output_df="`df -k ${dirname2?} | tail -n 1`" # On some platforms, the filesystem is on the previous line causing us # one less token for awk to find. free_space_in_fs=`echo ${output_df?} | awk '{if ($4 !~ /%/) {print $4} else {print $3}}'` @@ -382,7 +382,7 @@ rm -f ${TMPFILE3?} # Get the name of the filesystem where dir $dirname2 resides. - df -k ${dirname2?} | tail +2 > ${TMPFILE3?} + df -k ${dirname2?} | tail -n +2 > ${TMPFILE3?} # There must be only one line in TMPFILE3 file lcount=`wc -l ${TMPFILE3?} | awk '{print $1}'` @@ -394,7 +394,7 @@ chk_fsystype 22 stop_prog 1 fi - fsname=`awk '{print $NF}' ${TMPFILE3?} | tail -1` + fsname=`awk '{print $NF}' ${TMPFILE3?} | tail -n 1` rm -f ${TMPFILE3?} foundit=${FALSE?} @@ -879,7 +879,7 @@ ${DB2VER_V2?}) # Dir of DB2 V2 instances if [ -f ${DB2V2ILIST?} ]; then - tail +2 ${DB2V2ILIST?} > ${TMPFILE3?} + tail -n +2 ${DB2V2ILIST?} > ${TMPFILE3?} if [ -s ${TMPFILE3?} ]; then for iname in `cat ${TMPFILE3?}`; do db2ilist=${db2ilist?}" ${iname?}" @@ -891,7 +891,7 @@ ${DB2VER_DJ?}) # Dir of DB2 V2 instances if [ -f ${DJV211ILIST?} ]; then - tail +2 ${DJV211ILIST?} > ${TMPFILE3?} + tail -n +2 ${DJV211ILIST?} > ${TMPFILE3?} if [ -s ${TMPFILE3?} ]; then for iname in `cat ${TMPFILE3?}`; do db2ilist=${db2ilist?}" ${iname?}"

4. Create the DB2 Administration Server:

   /opt/IBM/db2/V8.1/instance/dascrt -u dasadm1

   Create the DB2 database instance:

   /opt/IBM/db2/V8.1/instance/db2icrt -a server -u db2fenc1 db2inst1