3. Preparing your distribution for Domino R5

3.1. Mandrake Linux 8.1

Domino for Linux will need to be able to find a certain file with filename libjitc.so. This required file is absent from Mandrake Linux 8.1. You will be unable to work correctly with the Agent Manager and Statistic Agent if you ignore this section of mini-HOWTO.

  1. To find out if the file is absent, you can use the locate command.

    First, issue the following command at the command prompt (login as "root"):

    
	bash# updatedb
    	

    This command searches the hard drive and updates a database for the locate command in use. It can take a few minutes to run, but probably it will take only 20-30 seconds or so. Afterwards, issue the command:

    
	bash# locate libjitc.so
    	

    If libjitc.so is on your hard drive somewhere, locate will find it and list where it is. If not, locate will list nothing. If libjitc.so is already there, it is probably already in your search path, until you get an error trying to work with Agent Manager and Statistic Agent indicating otherwise, just assume it is. If you do not have libjitc.so, you will need to get it separately; it is not included as a part of the Domino for Linux package.

    The file libjitc.so is included as a part of the IBM Developer Kit for Linux, which is IBM's port of Sun's JDK (Java Development Kit) 1.1.8 to Linux/x86. libjitc.so is the Java "Just-In-Time" compiler. The reason that this file is absent from SuSE 7.3 is that this Linux distribution comes with a different Java package named Kaffe Virtual Machine.

  2. You can download the IBM Developer Kit for Linux from http://www-106.ibm.com/developerworks/java/jdk/118/linux/?dwzone=java.

  3. Prepare a directory to download JDK into. Change to the /root directory:

    
	bash# cd /
    	bash# cd /root
    	

    and make a new directory named jdk118:

    
	bash# mkdir jdk118
    	
  4. Download the JDK into /root/jdk118. Install the IBM Developer Kit for Java by issuing the following command as root:

    
	bash# rpm -ivh IBMJava118-SDK-1.1.8-5.0-i386.rpm
    	
  5. After successful installation of the IBM Developer Kit you need to copy libjitc.so to the /lib directory:

    
	bash# cp /usr/jdk118/lib/linux/native_threads/libjitc.so /lib
    	
  6. You can uninstall the IBM Developer Kit with Software or Package Manager to clean things up, but consider keeping the rpm file IBMJava118-SDK-1.1.8-5.0-i386.rpm. You may decide later that JDK 1.1.8 is something you want to install (for example, it's necessary for using the IBM DB2 UDB V7.x Linux Control Center).

3.2. SuSE 7.3 Professional

Domino for Linux will need to be able to find a certain file with filename libjitc.so. This required file is absent from SuSE 7.3 Professional. You will be unable to work correctly with the Agent Manager and Statistic Agent if you ignore this section of mini-HOWTO.

  1. To find out if it is absent, you can use the locate command. First, issue the following command at the command prompt (log in as "root"):

    
	bash# updatedb
    	

    This command searches the hard drive and updates a database for the locate command in use. It can take a few minutes to run, but probably it will take only 20-30 seconds or so. Then issue the command:

    
	bash# locate libjitc.so
    	

    If libjitc.so is on your hard drive somewhere, locate will find it and list where it is. If not, locate will list nothing. If libjitc.so is already there, it is probably already in your search path, until you get an error trying to work with Agent Manager and Statistic Agent indicating otherwise, just assume it is. If you do not have libjitc.so, you will need to get it separately; it is not included as a part of the Domino for Linux package.

    The file libjitc.so is included as a part of the IBM Developer Kit for Linux, which is IBM's port of Sun's JDK (Java Development Kit) 1.3 to Linux/x86. libjitc.so is the Java "Just-In-Time" compiler. The reason that this file is absent from SuSE 7.3 is that this Linux distribution comes with a different Java package named Java 2 SDK, Standard Edition.

  2. Install IBM Developer Kit version 1.3 with YaST2 control center. IBM Developer Kit is located on one of the seven SuSE 7.3 Professional installation CD-ROMs.

  3. After successful installation of the IBM Developer Kit, you need to copy libjitc.so to /lib:

    
	bash# cp /usr/lib/jdk1.3/jre/bin/libjitc.so /lib