This step involves executing a command file named odxmake. The odxmake command file does the following:

It modifies the .profile file to support OMNIDEX.

It installs drivers for the databases and file systems supported on Linux.

It creates executable files from files you loaded onto the system.

To run odxmake, follow these steps.

1. If you have not already done so, log in as the user you created in Step 1:
2. $ login omnidex Password: omnidex
3. Run odxmake, which resides in the /omnidex root subdirectory:

$ ./odxmake

4. odxmake checks to see which data drivers are present in the product account and asks which of them to link into the OMNIDEX utilities. Any of the available drivers may be selected as long as the corresponding vendor software is present on your system. The following sections tell how to install te flat files drivers.

When installing drivers, be sure to install all that apply to your installation. If you re-run odxmake later to add a driver you overlooked, you must reinstall all drivers, including the ones you previously installed.

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

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

6 OMNIDEX Server Setup Guide for Linux

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.1]:

4. 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

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]:

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 Linux operating system, so you do not need to provide any additional information for the POSIX driver.

OMNIDEX Server Setup Guide Linux 7

Finishing the driver installation

When you are finished installing drivers, odxmake lists all of the libraries and files that it is linking. Finally, 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.

8 OMNIDEX Server Setup Guide for Linux

The last steps to finish the installation involve invoking the new .profile that odxmake modified and licensing the software.

To invoke the new .profile, enter the following at the system prompt:

$ . /.profile

To activate and license the OMNIDEX software, follow these steps.

1. Run regmaint, which resides in the /bin subdirectory:

$ bin/regmaint

2. From the menu, shown below, select item 1:

Please choose from one of the following: 
  1) Enter licensing code and activation key. 
  2) Enter the expiration extension codes. 
  3) Display cpu model and system identification value. 
  4) Display licensing information. 
  0) Exit Regmaint.
Enter your menu choice [0]: 1

3. Enter the path where you want to place the OMNIDEX registry file, or press [Return] for the default:

Please enter the location of the Omnidex registry file [/disc_dir]:

The default location of the registry file (shown above as disc_dir) is the home directory you specified through sam when you created the user omnidex.

4. Regmaint prompts you for the licensing information from the sticker affixed to the last page of this manual. Enter the appropriate licensing information at the appropriate prompt.

For example:

Licensing code :McNnbsBpTMBYK Activation key :MUMJ7M Licensee Name :My company's name

OMNIDEX Server Setup Guide Linux

9 Entering Software licensing information

10 OMNIDEX Server Setup Guide for Linux

Be sure to enter licensing information exactly as it appears on the sticker affixed to the last page of this manual. Type capital letters (like G) as such and lower case letters (like g) as such.

5. If the correc licensing information has been entered, regmaint will display the following message:

The following software products have been initialized for your use: Omnidex Core. Version 307 Omnidex Library. Press the <enter/return> key to continue.

6. Press [Enter] or [Return] twice to return to the main menu and to exit regmaint. odxmake creates in the omnidex.profile which contains the default location of the OMNIDEX_REG variable. If you choose not to use omnidex.profile, you must declare the location of the odxreg file by setting the OMNIDEX_REG environment variable in /etc/.profile (or each user's .profile), as shown in the following example: export OMNIDEX_REG “/odxreg_path/odxreg” odxreg_path represents the location of the OMNIDEX registry file you specified in step 3 above.

7. Activate the edited profile by entering . .profile. OMNIDEX is now installed on the system and is ready to use. Where to go from here

See the on-line help files for complete instructions on how to install and maintain OMNIDEX on production databases. If, after reviewing the on-line help manuals, you still have questions about OMNIDEX, contact the DISC Response Center at (303) 444-6610. Updating from a previous version

If you are updating your OMNIDEX software from a previous version, please note that you must perform the following steps:

1. Recompile all OMNIDEX environment catalog source files using the current version of omnidex/bin/oacomp.

2 For example:

 bin/oacomp orders.src orders.env

In this example, orders.src represents the environment source file and orders.env represents the compiled environment file’s name.

2. Reinstall OMNIDEX keys on all environment catalogs. If you created an installation batch file, simply change each batch file to call the current version of omnidex/bin/dbinstal.

3. Reindex the reinstalled environment catalogs using the current version of omnidex/bin/dbinstal.

4. Relink all of your existing applications using the current version of omnidex/bin/ldoa. For example:

bin/ldoa object.o program
2 omnidex represents the directory where you just finished installing the new OMNIDEX software.
OMNIDEX Server Setup Guide Linux 11
Licensing information
Licensing information
You must enter the information below through regmaint to license OMNIDEX. Be sure to enter this information exactly as it appears on the sticker. Enter upper case letters (like G) as such and lower case letters (like g) as such. If the Licensee Name is incorrect, contact DISC for a new code with a corrected Licensee Name.
12 OMNIDEX Server Setup Guide for Linux