Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
install:guides:linux [2011/01/26 17:39]
els
install:guides:linux [2021/08/26 21:36] (current)
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:
  
-=== 1Remove any previous installations of Omnidex ​===+  - 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).
  
-If a previous version ​of Omnidex ​has been installed, please remove this version of the software before proceeding.  ​+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.
  
-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.+=== Automatic installation ===
  
-=== 2Create an Omnidex user account ===+== 1Log on as root ==
  
-Omnidex should be installed ​in its own user account on the Linux system.  ​Typically, Omnidex ​is installed ​using a user named "​omnidex";​ however, this is not required.+Omnidex should be installed ​using the '​root' ​system ​user.  ​Alternatively, Omnidex ​can be installed ​with the sudo command.
  
-=== 3Downloading ​the software ===+== 2Make sure that the Omnidex repository is installed on your server ​== 
  
-[[install:​downloads|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.+The Omnidex repository must be copied to your system.  ​The following Linux command will copy the Omnidex repository file.
  
-=== 4Extract the software from the downloaded TAR file ===+For Red Hat or CentOS 6.x versions:
  
-The downloaded software is in TAR format While logged on as the Omnidex user, use the tar command to extract the software.+  # wget http://www.omnidex.com/​downloads/​omnidex/​Linux/​el6/​omnidex.repo -P /​etc/​yum.repos.d
  
-<​code>​ 
-  $ tar -xvf <​filename>​ 
-  bin/ 
-  bin/obj/ 
-  ... 
-</​code>​ 
  
 +For Red Hat or CentOS 5.x versions:
  
-=== 5Run "​odxmake",​ the Omnidex linkage script ===+  # wget http://www.omnidex.com/​downloads/​omnidex/​Linux/​el5/​omnidex.repo -P /​etc/​yum.repos.d
  
-The "​odxmake"​ script is a UNIX Korn Shell script that will build the Omnidex software. It modifies the .profile file to support Omnidex, and creates the executable files from files loaded onto the system when the software was downloaded and extracted. 
  
-//NoteBecause of variations in the DBMS vendor'​s installations and location of installed files, the odxmake file may fail during the linkage process. Please contact [[appendix:​contactus|Technical Support]] Technical Support to help determine site specific installation issues. //+For SuSE versions:
  
 +  # wget http://​www.omnidex.com/​downloads/​omnidex/​Linux/​el6/​omnidex.repo -P /​etc/​zypp/​repos.d
 +  ​
  
-== Step 1 ==+== 3. Choose whether to use the latest stable version or the current development version ​== 
  
-While logged on as the Omnidex ​userexecute ​the "​odxmake"​ script.+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: ​
-$ ./odxmake+
  
-Omnidex ​Installer ​for Linux(2.6)  (v5.01.20100308) ​  Thu Nov 25 2010 +  * [omnidex] - The most recent stable version of Omnidex, suitable ​for production applications. 
-(c)Dynamic Information Systems Corporation ​  1995-2010+  * [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.
  
-Welcome ​to DISC's Omnidex 5.01 software installation system. ​ If  +Choose which section you want to activate by setting "​enabled = 1" for that section and "​enabled = 0" for all other sections.
-you have any problems with this utility please contact our Technical  +
-Support staff at:+
  
-  In the U.S.:      Phone: ​     303-444-6610 +== 3Install Omnidex ==
-                    Fax:        303-444-0208 +
-                    Email: ​     support@disc.com +
-                    Internet: ​  ​http://​www.omnidex.com +
-  In Europe: ​       Phone: ​     +44-1372-362777 +
-                    Fax:        +44-1372-386418 +
-                    Email: ​     support@disceurope.co.uk+
  
-Available responses to prompts are in parentheses () and default +For Red Hat or CentOS versions:
-responses are in square brackets [].+
  
-Thank you for using Omnidex.+Once the Omnidex ​repository is copied, Omnidex can be automatically installed using the command:
  
-Do you wish to continue ([Y]/N)? +  # yum install omnidex 
-</​code>​+   
 +You can update an existing version of Omnidex using the command:
  
-Enter Y and press Return to continue with the installation.+  # yum update omnidex
  
-== Step 2 ==+You can remove an existing version of Omnidex using the command:
  
-You will be prompted whether you want the Oracle driver. ​ If Oracle is installed on this computer and if you will be using Omnidex to directly connect to Oracle databases, then you will need the Oracle driver. ​ If you are not using Oracle, you should not attempt to install the driver.+  # yum remove omnidex
  
 +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
 +  # 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 remove omnidex
 +  # yum clean metadata
 +
 +For SuSE versions:
 +
 +Once the Omnidex repository is copied, Omnidex can be automatically installed using the command:
 +
 +  # zypper install omnidex
 +  ​
 +You can update an existing version of Omnidex using the command:
 +
 +  # zypper update omnidex
 +
 +You can remove an existing version of Omnidex using the command:
 +
 +  # zypper remove omnidex
 +
 +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:
 +
 +  # zypper packages omnidex
 +  # zypper install omnidex-<​version> ​ (eg. zypper 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.
 +
 +  # zypper ​ remove omnidex
 +  # zypper ​ clean 
 +
 +=== 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 ==
 +
 +[[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.
 +
 +== 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.
  
 <​code>​ <​code>​
-Would you like the Oracle Driver (Y/[N])?y +  # rpm -Uvf omnidex-5.3-07H.el6.linux.x86_64.rpm ​                                   
-Enter the Oracle home directory [/​u/​oracle]:/​dbs1/​ora1102/​11.2.0 +  ​Preparing packages for installation... 
-Enter the Oracle SID [oracle]: v1102 +  ​omnidex-5.3-07H.el6.linux
-Enter the Oracle version 10 or [11]:11 +
-Link using Oracle 11g libraries in /​dbs1/​ora1102/​11.2.0/lib+
 </​code>​ </​code>​
  
-== Step 3 == 
  
-You will be prompted whether you want the unixODBC driver. ​ This driver uses the open-source unixODBC manager to provide access to other database system using ODBC.  If you are not using unixODBC, you should not attempt to install the driver. +=== Prepare Omnidex for use with Java (optional) === 
- + 
 +To use Omnidex with Java, you must set these environment variables: 
 <​code>​ <​code>​
-Would you like the unixODBC driver (Y/[N])?y +  export CLASSPATH="​/opt/omnidex/lib/​Omnidex.jar:$CLASSPATH"​ 
-Enter the unixODBC library directory [/usr/lib64]+  ​export LD_LIBRARY_PATH="​opt/omnidex/lib:​$LD_LIBRARY_PATH"​ 
-Link using unixODBC libraries ​/usr/lib64/​libodbc.so+  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.
  
-== Step 4 ==+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:
  
-The "​odxmake"​ script will not create the Omnidex ​executables.+https://​docs.oracle.com/​javase/​8/​docs/​technotes/​guides/​vm/​signal-chaining.html 
 + 
 + 
 +=== 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:
  
 <​code>​ <​code>​
-***************************************************** +  systemctl start omnidexd ​        ​(start omnidex as a service) 
-* Begin the creation of the Omnidex executables. ​   * +  ​systemctl stop omnidexd ​         (stop omnidex as a service) 
-***************************************************** +  ​systemctl restart omnidexd ​      ​(restart omnidex as a service) 
-*** Setting library dependencies... ​ complete. +  ​systemctl status omnidexd ​       (check if omnidex is running as a service) 
-*** Creating dbinstal ... complete. +</​code>​
-*** Creating oahelper ... complete. +
-*** Creating oacomp ... complete. +
-*** Creating oadecomp ... complete. +
-*** Creating oatest ... complete. +
-*** Creating versions ... complete. +
-*** Creating odxsql ... complete. +
-*** Creating snowgen ... complete. +
-*** Creating viewgen ... complete. +
-*** Creating regmaint ... complete. +
-*** Creating regtest ... complete. +
-*** Creating sysinfo ... complete. +
-*** Creating odxaim ... complete. +
-*** Creating odxnet ... complete. +
-*** Creating ldoa ... complete. +
-*** Updating profile ... complete.+
  
-***************************************************** +To manage whether the Omnidex service starts every time the system is rebooted, use the following commands: 
-* odxmake has ended successfully. ​                  * + 
-*****************************************************+<​code>​ 
 +  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)
 </​code>​ </​code>​
 +
 +----
 +
 +====  ====
 +\\
  
 If you have any difficulty installing Omnidex on your Linux operating system, please contact [[appendix:​contactus|Technical Support]] for assistance. If you have any difficulty installing Omnidex on your Linux operating system, please contact [[appendix:​contactus|Technical Support]] for assistance.
 
Back to top
install/guides/linux.1296063557.txt.gz · Last modified: 2016/06/28 22:38 (external edit)