This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
|
install:guides:linux [2014/11/16 03:21] doc |
install:guides:linux [2020/02/26 20:22] doc |
||
|---|---|---|---|
| Line 9: | Line 9: | ||
| ==== Linux Installation Guide ==== | ==== Linux Installation Guide ==== | ||
| - | This guide describes how to install and license the Omnidex software on a Linux operating system. | + | This guide describes how to install and license the Omnidex software on a Linux operating system. The Omnidex installation performs the following tasks: |
| + | |||
| + | - Copy the Omnidex files into /opt/omnidex directory. | ||
| + | - Create symbolic links in /usr/bin for odxsql, odxnet, omnidex, and odxversions. | ||
| + | - 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). | ||
| 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. | 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. | ||
| Line 19: | Line 23: | ||
| Omnidex should be installed using the 'root' system user. Alternatively, Omnidex can be installed with the sudo command. | 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 == | + | == 2. Make sure that the Omnidex repository is installed on your server == |
| - | The Omnidex repository needs to be declared on your system. The following Linux commands will install the Omnidex repository file. | + | The Omnidex repository must be copied to your system. The following Linux command will copy the Omnidex repository file. |
| For Red Hat or CentOS 6.x versions: | For Red Hat or CentOS 6.x versions: | ||
| - | <code> | + | # wget http://www.omnidex.com/downloads/omnidex/Linux/el6/omnidex.repo -P /etc/yum.repos.d |
| - | # 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: |
| - | </code> | + | # wget http://www.omnidex.com/downloads/omnidex/Linux/el5/omnidex.repo -P /etc/yum.repos.d |
| + | == 3. Choose whether to use the latest stable version or the current development version == | ||
| - | For Red Hat or CentOS 5.x versions: | + | By default, yum will install the latest stable version of Omnidex, suitable for production applications. If you would like to access the most recent development version or a previous version of Omnidex, you must edit the Omnidex repository. |
| - | <code> | + | The repository contains three sections: |
| - | # wget http://www.disc.com/download/omnidex/Linux/5/omnidex.repo -P /etc/yum.repos.d | + | |
| - | </code> | + | |
| - | == 2. Install Omnidex == | + | * [omnidex] - The most recent stable version of Omnidex, suitable for production applications. |
| + | * [omnidex-devel] - The most recent development version of Omnidex containing the latest features and bug fixes. | ||
| + | * [omnidex-arch] - An archive of previous versions of Omnidex. | ||
| - | Once the Omnidex repository is installed, Omnidex can be easily installed using the command: | + | Choose which section you want to activate by setting "enabled = 1" for that section and "enabled = 0" for all other sections. |
| - | # yum install omnidex | + | == 3. 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 | + | Once the Omnidex repository is copied, Omnidex can be automatically installed using the command: |
| - | ================================================================================================================================ | + | # yum install omnidex |
| - | Package Arch Version Repository Size | + | |
| - | ================================================================================================================================ | + | You can update an existing version of Omnidex using the command: |
| - | Installing: | + | |
| - | omnidex x86_64 5.3-08D.el6.linux omnidex 39 M | + | |
| - | Transaction Summary | + | # yum update omnidex |
| - | ================================================================================================================================ | + | |
| - | Install 1 Package(s) | + | |
| - | Total download size: 39 M | + | You can remove an existing version of Omnidex using the command: |
| - | 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: | + | # yum remove omnidex |
| - | omnidex.x86_64 0:5.3-08D.el6.linux | + | |
| - | Complete! | + | If your repository is set to [omnidex-arch] as described above, you can view all available versions and install a particular version using the commands: |
| - | + | # yum list --showduplicates omnidex | |
| - | You can update an existing version of Omnidex using the command: | + | # yum install omnidex-<version> (eg. yum install omnidex-5.3-08D.el6.linux) |
| + | |||
| + | Note: To install an earlier version of Omnidex than the version currently installed, first remove Omnidex and then clear the yum cache. | ||
| - | yum update omnidex | + | # yum remove omnidex |
| + | # yum clean metadata | ||
| === Manual installation === | === Manual installation === | ||
| Line 111: | Line 86: | ||
| == 3. Download the software == | == 3. Download the software == | ||
| - | [[install:downloads:home|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. | + | [[install:downloads:home|Download]] the software from the Downloads tab in this documentation. Be sure to choose correctly the version of Omnidex that matches your version of Linux. |
| Omnidex is available as an RPM file or as a TAR file. Both installations contain the same Omnidex software. | Omnidex is available as an RPM file or as a TAR file. Both installations contain the same Omnidex software. | ||
| Line 123: | Line 98: | ||
| Preparing packages for installation... | Preparing packages for installation... | ||
| omnidex-5.3-07H.el6.linux | omnidex-5.3-07H.el6.linux | ||
| - | # | ||
| </code> | </code> | ||
| - | The Omnidex installation performs the following tasks: | ||
| - | |||
| - | - Copy the Omnidex files into /opt/omnidex directory. | ||
| - | - Create symbolic links in /usr/bin for odxsql, odxnet, omnidex, and odxversions. | ||
| - | - 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) === | === Prepare Omnidex for use with Java (optional) === | ||
| Line 139: | Line 106: | ||
| <code> | <code> | ||
| - | export LD_LIBRARY_PATH="opt/omnidex/lib:$LD_LIBRARY_PATH" | ||
| export CLASSPATH="/opt/omnidex/lib/Omnidex.jar:$CLASSPATH" | export CLASSPATH="/opt/omnidex/lib/Omnidex.jar:$CLASSPATH" | ||
| + | export LD_LIBRARY_PATH="opt/omnidex/lib:$LD_LIBRARY_PATH" | ||
| + | export LD_PRELOAD="<see below>" | ||
| </code> | </code> | ||
| To use OdxSQL as a Java client for testing purposes, you also must add the directory containing libjvm.so to LD_LIBRARY_PATH. | To use OdxSQL as a Java client for testing purposes, you also must add the directory containing libjvm.so to LD_LIBRARY_PATH. | ||
| + | |||
| + | Additionally, it is recommended to set LD_PRELOAD to Java's libjsig.so library due to known compatibility issues with Java's signal handling with other applications, including Omnidex. This is necessary to avoid unexplained aborts of the JVM when connecting to Omnidex processes, such as when setting up application pooling using DBCP. Instructions for setting this variable can be found at the following link: | ||
| + | |||
| + | https://docs.oracle.com/javase/8/docs/technotes/guides/vm/signal-chaining.html | ||
| + | |||
| === Install Omnidex to run as a service (optional) === | === Install Omnidex to run as a service (optional) === | ||
| Line 152: | Line 125: | ||
| <code> | <code> | ||
| - | service omnidexd start (start omnidex as a service) | + | systemctl start omnidexd (start omnidex as a service) |
| - | service omnidexd stop (stop omnidex as a service) | + | systemctl stop omnidexd (stop omnidex as a service) |
| - | service omnidexd restart (restart omnidex as a service) | + | systemctl restart omnidexd (restart omnidex as a service) |
| - | service omnidexd status (check if omnidex is running as a service) | + | systemctl status omnidexd (check if omnidex is running as a service) |
| </code> | </code> | ||