IBM AIX - Server Setup Guide

Step 3: Build the Omnidex Executables

This step involves executing a command file named make/omnidex. The make/omnidex command file does the following.

• It modifies the .profile file to support Omnidex.
• It installs drivers for the databases and file systems supported on IBM AIX.
• Install the Oracle Driver
• Install the DB2 Driver
• Install the POSIX Flat File Driver
• Finish the Driver Installation
• It creates executable files from files you loaded onto the system in Step 2.

To run odxmake, follow these steps.

1. If you have not already done so, log in as the user you created in Step 1:

$ login omnidex
Password: omnidex

2. Run odxmake, which resides in the /omnidex root subdirectory:

$ odxmake

3. odxmake checks to see which data drivers have been provided in your product account and asks which drivers to link into the Omnidex utilities. You may select any or all of the available drivers. However, make sure that if the selected driver is for a third party file management system (not POSIX flat files), the corresponding vendor software (like Oracle) is present on your system. The following sections describe the prompts and the responses required to select each of the available drivers.

If the message “Unable to locate the library file libtermcap.a in the standard location /usr/ccs/lib/ “ is received, the following steps will need to be followed before odxmake is able to properly create the Omnidex utilities.

1. Logon as root.

2. Copy the file $OMNIDEX_HOME/lib/termcap.src to the directory /usr/lib/libtermcap/

3. Copy the file $OMNIDEX_HOME/lib/libtermcap.a to the directory /usr/ccs/lib/

4. Create a soft link in /usr/lib/ pointing to /usr/ccs/lib
example:

ln -s /usr/ccs/lib/libtermcap.a /usr/lib/libtermcap.a

5. Create a soft link in /etc/ pointing to /usr/lib/libtermcap/
example:

ln -s /usr/lib/libtermcap/termcap.src /etc/termcap

Installing the Oracle Driver

To select the Oracle driver, enter Y for “yes” at this prompt.

Would you like the Oracle Driver (Y/[N])? y

odxmake asks you for the following information. Note that default responses are enclosed in square brackets [ ]:

1. Oracle’s home directory

Enter the Oracle home directory [/u/oracle]:

2. The Oracle SID (system identifier)

Enter the Oracle SID [oracle]:

3. The version of Oracle you are running.

Enter the Oracle version 8.0 or [8.1]:

Depending on the version and home directory you specified, a message similar to the following appears:

Link using Oracle 8.1 libraries in /u/oracle/lib

Installing the DB2 Driver

To select the DB2 driver, enter Y for "yes" at this prompt:

Would you like the DB2 driver (Y/[N])? Y

odxmake asks the following questions. The default responses are enclosed in square brackets [ ]:

1. The DB2 home directory:

Enter the DB2 home directory [/usr/db2]:

2. The name of the DB2 instance:

Enter the DB2 instance name [db2]:

Installing the POSIX Flat File Driver

To select the POSIX or “flat” file driver, enter Y for “yes” at this prompt:

Would you like the POSIX flat file driver Y/[N])? Y

Omnidex uses POSIX routines that are part of the IBM AIX operating system, so you do not need to provide any additional information for the POSIX driver.

Finish the Driver Installation

When you are finished installing drivers, odxmake lists all of the libraries and files that it is linking. Lastly, it tells you that it is updating .profile to initialize Omnidex.

If you failed to install a driver, and would like another chance, you can run odxmake again. Note, however, that at that time you must also install all the previously requested drivers as well.

Top