This is an old revision of the document!


Software Installation: Installation Guides

Linux Installation Guide

This guide describes how to install and license the Omnidex software on a Linux operating system.

There are two methods of installing Omnidex. Many system administrators like to use the 'yum' facility to automatically install Omnidex. Others will prefer to manually download and install the RPM files. Both approaches are supported.

Automatic installation

1. Log on as root

Omnidex should be installed using the 'root' system user. Alternatively, Omnidex can be installed with the sudo command.

2. Make sure that the Omnidex repository is declared on your server

The Omnidex repository needs to be declared on your system. The following Linux commands will install the Omnidex repository file.

For Red Hat or CentOS 6.x versions:

# wget http://www.disc.com/download/omnidex/Linux/6/omnidex.repo -P /etc/yum.repos.d
--2014-10-13 21:54:17--  http://www.disc.com/download/omnidex/Linux/6/omnidex.repo
Resolving www.disc.com... 184.168.193.46
Connecting to www.disc.com|184.168.193.46|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 114 [text/plain]
Saving to: “/etc/yum.repos.d/omnidex.repo”

100%[=============================================================================>] 114 --.-K/s in 0s      

2014-10-13 21:54:17 (13.6 MB/s) - “/etc/yum.repos.d/omnidex.repo” saved [114/114]

For Red Hat or CentOS 5.x versions:

# wget http://www.disc.com/download/omnidex/Linux/5/omnidex.repo -P /etc/yum.repos.d
2. Install Omnidex

Once the Omnidex repository is installed, Omnidex can be easily installed using the command:

# yum install omnidex
Loaded plugins: fastestmirror, refresh-packagekit, security
Loading mirror speeds from cached hostfile
 * base: mirror.compevo.com
 * extras: mirror.sanctuaryhost.com
 * updates: mirror.trouble-free.net
Setting up Install Process
Resolving Dependencies
--> Running transaction check
---> Package omnidex.x86_64 0:5.3-08D.el6.linux will be installed
--> Finished Dependency Resolution
Dependencies Resolved
================================================================================================================================
Package                     Arch                       Version                               Repository                   Size

Installing: omnidex x86_64 5.3-08D.el6.linux omnidex 39 M

Transaction Summary

Install 1 Package(s)

Total download size: 39 M Installed size: 120 M Is this ok [y/N]: y Downloading Packages: omnidex-5.3-08D.el6.linux.x86_64.rpm | 39 MB 00:23 Running rpm_check_debug Running Transaction Test Transaction Test Succeeded Running Transaction

Installing : omnidex-5.3-08D.el6.linux.x86_64                                                                             1/1 
Verifying  : omnidex-5.3-08D.el6.linux.x86_64                                                                             1/1 

Installed:

omnidex.x86_64 0:5.3-08D.el6.linux                                                                                            

Complete!

You can update an existing version of Omnidex using the command:

yum update omnidex

Manual installation

1. Log on as root

Omnidex should be installed using the 'root' system user. Alternatively, Omnidex can be installed with the sudo command.

2. Remove any previous non-RPM installations of Omnidex

If a previous version of Omnidex has been installed without using RPM, please remove this version of the software before proceeding.

Note that if you have installed Omnidex on databases, it is not necessary to remove the Omnidex indexes on those databases before installing a new version of Omnidex. The existing indexes may be able to be reused.

3. Download the software

Download the software from the Downloads tab in this documentation. Be sure to choose correctly between the 32-bit and 64-bit versions of the software.

Omnidex is available as an RPM file or as a TAR file. Both installations contain the same Omnidex software.

4. Install the Omnidex RPM file

Omnidex is most easily installed using the RPM format. While logged on as the 'root' user, use the rpm command to install the software. Note that the exact filename will be different for each version of Omnidex.

  # rpm -Uvf omnidex-5.3-07H.el6.linux.x86_64.rpm                                   
  Preparing packages for installation...
  omnidex-5.3-07H.el6.linux
  # 

The Omnidex installation performs the following tasks:

  1. Copy the Omnidex files into /opt/omnidex directory.
  2. Create symbolic links in /usr/bin for odxsql, odxnet, omnidex, and odxversions.
  3. Create omnidex.conf file in /etc/ld.so.conf.d directory. The file omnidex.conf contains the path to the Omnidex libraries (/opt/omnidex/lib).

Manual installation of Omnidex

Prepare Omnidex for use with Java (optional)

To use Omnidex with Java, you must set these environment variables:

  export LD_LIBRARY_PATH="opt/omnidex/lib:$LD_LIBRARY_PATH"
  export CLASSPATH="/opt/omnidex/lib/Omnidex.jar:$CLASSPATH"

To use OdxSQL as a Java client for testing purposes, you also must add the directory containing libjvm.so to LD_LIBRARY_PATH.

Install Omnidex to run as a service (optional)

Omnidex is usually run as a service, though it can be run in a console window as well. The files needed to set up Omnidex as a service are automatically placed in /etc/init.d upon installation.

The following commands are available to manage the Omnidex service:

  service omnidexd start        (start omnidex as a service)
  service omnidexd stop         (stop omnidex as a service)
  service omnidexd restart      (restart omnidex as a service)
  service omnidexd status       (check if omnidex is running as a service)

To manage whether the Omnidex service starts every time the system is rebooted, use the following commands:

  chkconfig --add omnidexd      (add omnidex service to startup)
  chkconfig --del omnidexd      (remove omnidex service from startup)
  chkconfig --list omnidexd     (check if omnidex service is in the startup)


If you have any difficulty installing Omnidex on your Linux operating system, please contact Technical Support for assistance.

Additional Resources

See also:

 
Back to top
install/guides/linux.1416108051.txt.gz · Last modified: 2016/06/28 22:38 (external edit)