Omni-Gen™ Installer User's Guide > Installing Omni-Gen Integration Edition on Windows Platforms > Installing Omni-Gen Integration Edition

Installing Omni-Gen Integration Edition

How to:

Omni-Gen Integration Edition can be installed on a Linux server by running the omnigen-installer-3.14.*-Linux-IE.bin file, which is downloaded from the Information Builders Tech Support Downloads website. This .bin file must be run from the Linux command line by a user who has the correct privileges to execute .bin installation files.

Similar to the Windows installer, the Linux installer prompts you with a series of configuration questions. The installer uses these responses to direct the installation of several components and automatically configures these components based on the responses that were provided.

Procedure: How to Install Omni-Gen Integration Edition on Linux

On Linux platforms, installing as user root is not recommended. Creating a dedicated User and Group with appropriate rights is preferred.

  1. Copy the omnigen-installer-3.14.*-Linux-IE.bin installation file you downloaded to a directory on your system.
  2. Use FTP in binary mode to transfer the installation file to your Linux system.
  3. Navigate to the directory containing the installation file, and ensure that you have the correct privileges to execute the installation file.

    Note: If you do not have the correct privileges, then type the following command at the command prompt to use the execute privilege on the installation file: 

    chmod 777 omnigen-installer-3.14.*-Linux-IE.bin
  4. Enter the following command at the command prompt to start the installation:
    ./omnigen-installer-3.14.*-Linux-IE.bin -i console

    Note: The -i console command runs the installer in console mode.

    The installation may take a few moments to initialize.

    Preparing to install
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...

Launching installer...

========================================================================
Omni-Gen                             (created with InstallAnywhere)
------------------------------------------------------------------------

Preparing CONSOLE Mode Installation...

    When the installation is ready to begin, the Introduction pane opens.

    ========================================================================
Introduction
------------

InstallAnywhere will guide you through the installation of Omni-Gen version 3.14.2635.

It is strongly recommended that you quit all programs before continuing with this installation.

Respond to each prompt to proceed to the next step in the installation.

If you want to change something on a previous step, type 'back'.

You may cancel this installation at any time by typing 'quit'.

PRESS <ENTER> TO CONTINUE:
  5. Press Enter to continue.

    The Accept License Agreement pane opens.

    ========================================================================
Accept License Agreement
------------------------

Installation and Use of Omni-Gen version 3.14.2635 Requires Acceptance of the Following License Agreement:

INFORMATION BUILDERS, INC. HEREINAFTER "INFORMATION BUILDERS" OR "IBI")
CLICKWRAP SOFTWARE LICENSE AGREEMENT ("CWSLA")

INFORMATION BUILDERS IS WILLING TO LICENSE THE SPECIFIC SOFTWARE CHOSEN 
FOR DOWNLOAD AND/OR INSTALLATION AND THE ACCOMPANYING DOCUMENTATION TO
YOU ONLY ON THE CONDITION THAT YOU ACCEPT ALL OF THE TERMS OF THIS
CLICKWRAP SOFTWARE LICENSE AGREEMENT.

IMPORTANT NOTICE TO CUSTOMERS ENCOUNTERING THE DISPLAY OF THIS CWSLA 
DURING AN INSTALL - READ ALL OF THE TERMS AND CONDITIONS CONTAINED
HEREIN CAREFULLY BEFORE ACCEPTING THESE TERMS. YOU ACCEPT THE TERMS
BY EITHER: (A) CLICKING ON THE BUTTON BELOW THAT ACKNOWLEDGES YOUR
ACCEPTANCE/AGREEMENT, IF AVAILABLE;(B) REPLYING "YES" WHERE INDICATED,
IF PROMPTED; OR (C) PROCEEDING OTHERWISE WITH THE INSTALLATION.
BY PROCEEDING WITH THE INSTALLATION, YOU ACKNOWLEDGE THAT YOU ARE
ACCEPTING AND AGREEING TO ALL OF THE TERMS AND CONDITIONS
CONTAINED HEREIN. BY PROCEEDING WITH THE INSTALLATION, YOU ALSO
ACKNOWLEDGE THAT YOU ARE ACCEPTING AND AGREEING TO THE TERMS AND
CONDITIONS OF ANY APPLICABLE THIRD PARTY SOFTWARE AND LICENSES
USED IN THE SOFTWARE.
A LIST OF LICENSES IS AVAILABLE AT
http://www.ibi.com/products/third_party_licenses/index.html.

IF YOU ARE NOT WILLING TO BE BOUND BY THESE TERMS AND CONDITIONS,
YOU MUST PROMPTLY TERMINATE THE INSTALLATION PROCEDURE BY CLICKING
"NO" (OR "CANCEL")

PRESS <ENTER> TO CONTINUE:
.
.
.
  6. Read the terms of the license agreement and continue to press Enter until you reach the last section of the license agreement.
    .
.
.
DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): y
  7. Enter Y to accept the terms of the license agreement and then press Enter to continue.

    The Choose Installation Folder pane opens.

    ========================================================================
Choose Installation Folder
--------------------------

Please specify the folder which will be the root of this installation.

Where would you like to install?

  Default Install Folder: /home/usr

ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT
      :
  8. Enter the desired installation location (for example, /data/omni/product/omnigen) or press Enter to accept the default installation folder and continue.

    Note: If you entered a unique path, a prompt to confirm the path is displayed. Select Y to confirm and then press Enter to continue.

    The Choose Java Virtual Machine pane opens.

    ========================================================================
Choose Java Virtual Machine
---------------------------

Please Choose a Java VM for Use by the installed application

  ->1- home/usr/java/jdk1.8.0_221/bin/java

ENTER THE NUMBER FOR THE JAVA VM, OR PRESS <ENTER> TO ACCEPT THE
      CURRENT SELECTION:
  9. Ensure that the Java version located is version 1.8 or higher, and then press Enter to continue.

    The Specify Base Port Number pane opens.

    ========================================================================
Specify Base Port Number
------------------------

Choose a port number as the starting point.

Base Port Number (Default: 9500):

    Specifying a base port number automatically assigns a set of port numbers for use by Omni-Gen Integration Edition components, and is used when installing more than one instance of Omni-Gen Integration Edition on a single machine. If you are installing a second instance of Omni-Gen Integration Edition, or need to configure different ports to avoid conflicts with systems already deployed on your OmniGen Integration Edition host, then see your system administrator. Otherwise, press Enter to continue.

    The Specify Hostname and Domain pane opens.

    ========================================================================
Specify Hostname and Domain
---------------------------

Enter the Hostname and Domain

Hostname (Default: hostname):

Domain :

    The default host name is the machine on which you are currently installing.

  10. Specify the domain, or press Enter to accept the default and continue.

    The Configure Omni-Gen Repository Tomcat Ports pane opens.

    ========================================================================
Configure Omni-Gen Repository Tomcat Ports
------------------------------------------

The defaults suggested below allow the Omni-Gen Repository Tomcat 
server to run without conflict. Unless your System Administrator
or Security Management instructs you to change these ports to avoid
other local conflicts, leave these ports set to the defaults below.

Enter the Omni-Gen Repository Tomcat information

Enter the location of the JDBC jar file(s). (Default: /home/usr/jdbcjars)

HTTP Port (Default: 9516):

Ajp Port (Default: 9517):

HTTPS Port (Default: 9518):

Shutdown Port (Default: 9515):
  11. Verify the ports that are indicated by default and change accordingly, if necessary. The recommendation is to press Enter to accept the default values.

    The Specify Location of Omni-Gen Designer pane opens.

    ========================================================================
Specify Location of Omni-Gen Designer
-------------------------------------

The proposed ports and location assume a standard installation of
Omni-Gen Designer, and are supplied from data you have already entered.
Unless you have done a custom Omni-Gen Designer installation, leave
these values as proposed.

Enter Location and Parameters of the Omni-Gen Designer

Bridge Host (Default: hostname):

Bridge Port (Default: 9519):

EMF Store Port (Default: 9520):

Omni-Gen Designer Workspace Directory (Default:
   /home/usr/omnigen/OmniGenData/OmniDesignerWorkspace):
  12. Press Enter to accept the default values and continue.

    The Specify Location of Source Control .jar Files pane opens.

    ========================================================================
Specify Location of Source Control .jar Files
---------------------------------------------

For Omni-Gen to communicate with a required  Source Code Control System
(SCCS), it must use “SCCS jar files” specific to whichever of the two
SCCSs (SVN or GIT) you are using with OmniDesigner and Omni-Gen.  
The SCCS jar file(s) are supplied by your SCCS vendor, and you must copy
them to a location on the target Omni-Gen Host machine, and enter the 
location of the sccs jar files below.

Please enter the location of the SCCS jar file(s). (Default:
   /home/usr/sccsjars):
  13. Change the location of the SSCS .jar files, if necessary, or press Enter to accept the default and continue.

    The Select Source Code Control System and Location pane opens.

    ========================================================================
Select Source Code Control System and Location
----------------------------------------------

You must select which of the supported SCCS's, SVN or GIT, are used
by the Repository Service. The defaults for each SCCS choice are
supplied for a standard SCCS install, and from information already
entered in this Installer session.

Select the Source Control Change System and its Connection Parameters

  ->1- svn
    2- git
   
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:
  14. Select either svn or git, or press Enter to accept the default and continue.
  15. Define the location and credential parameters for your source control repository, or press Enter to accept the default values and continue.

    The Specify Location of JDBC .jar Files pane opens.

    ========================================================================
Specify Location of JDBC .jar Files
----------------------------------------------

Omni-Gen uses a DBMS specific .jar file(s) to implement the JDBC
protocol and communicate with the DBMS. The JDBC jar file(s) are
supplied by your DBMS vendor, and you must copy them to a location
on the target Omnigen Host machine, and enter the location of
the JDBC jar files below.

Enter the location of the JDBC jar file(s). (Default: /home/usr/jdbcjars
   :
  16. Specify the location of your JDBC .jar files (for example, /data/omni/product/omnigen/jdbcjars) and then press Enter to continue.

    The Select the DBMS type of the OGS Database pane opens.

    ========================================================================
Select the DBMS type of the OGS Database
----------------------------------------

Select the DBMS type used for OGS Database

    1- DB2
    2- Oracle
  ->3- Postgres
    4- SqlServer - Microsoft Driver
    5- SqlServer- OpenSource jTDS Driver
    6- Teradata

ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:
  17. Type the number that corresponds to the database that you want to use for the Omni-Gen Server (OGS) database, or press Enter to accept the default and continue.

    The Enter OGS Database Parameters: Oracle, Postgres, Teradata pane opens.

    ========================================================================
Enter the OGS Database Parameters
---------------------------------
Enter the OGS Database Connection Parameters

User Name (Default: omnigen): 

Password (Default: omnigen): 

Host (Default: localhost): 

Port (Default: 5432):

Database Name (Default: omnigen):
  18. Specify the DBMS-specific parameters for the OGS database, and then press Enter to continue.

    The Verify the Omni-Gen Master Database URL pane opens.

    ========================================================================
Verify the Omni-Gen Master Database URL
---------------------------------------

Review and or Edit the Omni-Gen Server (OGS) Database URL

Database URL     (Default:
   jdbc:postgresql://hostname:5432/omnigen):
  19. Verify the database URL, and then press Enter to continue.

    The Test Database Connection pane opens.

    ========================================================================
Test Database Connection?
-------------------------

Test the Database Connection?

  ->1- Yes
    2- No

ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:

    A test connection is made to the specified target DBMS based on the specified parameters.

    If you receive a message indicating that your connection test failed, verify your DBMS parameters and that your database name exists in the DBMS you are using.

    When your database exists and the user name, password, and host are correct, the Omni-Gen Server Database Connection Test Passed pane opens. 

    ========================================================================
Omni-Gen Server Database Connection Test Passed
-----------------------------------------------

Omni-Gen Server Connection to
jdbc:postgresql://hostname:5432/omnigen succeeded

PRESS <ENTER> TO CONTINUE:
  20. Press Enter to continue.

    The Select the Omni-Gen Server Runtime Protocol pane opens.

    ========================================================================
Select the Omni-Gen Server Runtime Protocol
-------------------------------------------

Omni-Gen Server Runtime Protocol

    1- http
  ->2- https

ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:
  21. Select the desired server runtime protocol (HTTP or HTTPS), or press Enter to accept the default and continue.

    The Verify the Omni-Gen Server Port Numbers pane opens for the specified Omni-Gen Server runtime protocol (HTTP or HTTPS).

    ========================================================================
Verify the Omni-Gen Server Port Numbers https
---------------------------------------------

Enter the Omni-Gen Server ports

Controller Port (Default: 9500):

Server Port (Default: 9514):

Deployment Tool Server HTTPS Port  (Default: 9502):
  22. Accept the default values, but change them if your system administrator informs you of a conflict and recommends changes to alternate available ports.
  23. Press Enter to continue.

    The Verify or change JVM Memory Settings - IE pane opens.

    ========================================================================
Verify or change JVM Memory Settings - IE
-----------------------------------------

It may become necessary to allocate more memory to the Tomcat Servers in
Omni-Gen. Leave these values as the defaults displayed, unless your
system administrator and Omni-Gen Installation support analysts
specify different values.

Verify and or edit the JVM Memory Settings

Controller Max Memory (Default: 1024M):

OmniServer Max Memory (Default: 1024M): 

Command Line Max Memory (Default: 1024M):
  24. Change the values only if you are instructed by Information Builders or iWay Support analysts, otherwise, press Enter to continue.

    The Pre-Installation Summary pane opens.

    ========================================================================
Pre-Installation Summary
------------------------

Please Review the Following Before Continuing:

Product Name:
    Omni-Gen

Install Folder:
    /home/usr

Link Folder:
    /home/usr

Product Version
    3.12.2635

Install Path
    /home/usr

Java Home
    /usr/java/jdk1.8.0_221

Disk Space Information (for Installation Target):
    Required:    1,718,158,500 Bytes
    Available: 185,251,954,688 Bytes

PRESS <ENTER> TO CONTINUE:
  25. Review all of the settings in the Pre-Installation Summary pane, and then press Enter to continue.

    The Ready To Install pane opens.

    ========================================================================
Ready To Install
----------------

InstallAnywhere is now ready to install Omni-Gen version 3.14.2635 onto your system at the following location:

/home/usr

The installation may take a few minutes depending on the system.

PRESS <ENTER> TO INSTALL:
  26. Press Enter to begin the installation.

    Progress of the installation is shown.

    ========================================================================
Installing...
-------------

 [==================|==================|==================|===========]
 [------------------|------------------|------------------|------------


========================================================================


Please Wait
-----------

Executing Installation Script...

    The Omni-Gen™ installation is complete when the Installation Complete pane displays.

    ========================================================================
Installation Complete
---------------------

Congratulations. Omni-Gen has been successfully installed to:

/home/usr

The install script finished with return code 0

PRESS <ENTER> TO EXIT THE INSTALLER:
  27. Press Enter to exit (close) the installer.

    You are returned to the command prompt.

  28. Navigate to the omnigen home directory that is created.

    For example:

    /data/omni/product/omnigen
  29. Navigate to the omniserver home directory that is created.

    For example:

    /data/omni/product/omnigen/omniserver
  30. Open a terminal window and type the following command:
    ./omni.sh start-controller
  31. Press Enter.

    Note: When the installation has completed, a BUILD Successful message appears, but the startup process continues for a few minutes. You must wait for this process to complete.