Once you have fulfilled the installation prerequisites, OpsHub Integration Manager can be installed on a Windows or a Linux machine. To start the installation, follow the steps given below:

  • Unzip the OpsHub Integration Manager installer folder to find the executable(.exe) file.
  • The steps to launch the installer in different Operating Systems (OS) are given below. Follow the steps given for the OS that you are using.

To start the installation on a Windows machine:

  • Double click the executable *.exe file given in the application folder (It is advisable to run .exe file by right-clicking Run as administrator where * is replaced with the application version).
  • If one instance of this release is already installed, then the user will be notified.
  • Click yes to continue with the installation. It will then display the uninstallation key for the current installation.
  • Click here for step-by step instructions for installation with the selected database. Select the database for installation to proceed with registration.

To start the installation on a Linux machine:

Before Installation
  • Unzip the OpsHub Integration Manager installer folder to find the executable(.exe) file. Make sure users who will run installer owns the files and has full access to extracted files.
  • Create empty directory with full access and export its path to OPSHUB_TEMP_DATA variable as shown in the example below:
    • export OPSHUB_TEMP_DATA=/home/setup/temp
  • If you are doing silent installation, ensure you have provided the same path for OPSHUB_TEMP_DATA as provided during silent registration.
  • The minimal access required to install OpsHub Integration Manager is given here, when you do not have root access.

To run the RPM file, you need access to Linux UI. This is because the installation process requires user inputs through UI. Installation will not get completed through remote terminal connection (i.e. Putty).

To Run sh file
  • Open terminal window and go to the folder containing the install.sh file.
  • Execute the following command: sh install.sh.
  • To run the sh File, you need to have access to Linux UI. This is because the installation process requires user inputs through UI. Installation won’t get completed through remote terminal connection (i.e. Putty).
To Run sh File from External File (Silent Installation)

To install OpsHub Integration Manager through terminal connection (i.e. Putty), follow the steps given below:

  • Complete user registration as described here.
  • Download and modify OpsHubAutoInstall.xml file as per your requirement by click here .
  • Make sure, you transfer the modified file on the instance where you want to install OpsHub Integration Manager.
  • Set an environment variable OPSHUB_AUTO_INSTALL on the installation instance, the value of variable is the path to the OpsHubAutoInstall.xml file. File name can be different.
    • For example, export OPSHUB_AUTO_INSTALL=/home/Downloads/OpsHubAutoInstall.xml.
  • After setting environment variable, run the installer with command sh install.sh.
  • Please refer Possible Error section for trouble shooting error(s) occurred during installation.
Note: For Linux installation ”’/ : \”’ characters not allowed for a directory name.
Note: If one instance of this release is already installed, then you will be notified. Click ‘yes’ to continue with the installation. It will then display the uninstallation key for the current installation.
Minimal access required to run Linux installer using external file

OpsHub Integration Manager Installation Directory should be owned by user who runs installer/migrator.

  • –x /usr
  • –x /proc
  • r-x /usr/bin
  • r-x /usr/bin/*
  • –x /usr/lib64
  • r-x /usr/lib64/*
  • –x /usr/share (if user edit file using nano command)
  • r-x /usr/share/*
  • Root access required when you install/migrate OpsHub Integration Manager with HSQLDB
Possible error during Silent installation/upgradation
[ Starting automated installation ]
[Timestamp] java.util.prefs.FileSystemPreferences$2 run
INFO: Created system preferences directory in java.home.
com.izforge.izpack.installer.InstallerException: Validating data for panel
UserInputPanel.EmailIdVerificationForExistingCode was not successfull
com.izforge.izpack.installer.InstallerException: Validating data for panel
UserInputPanel.EmailIdVerificationForExistingCode was not successfull
at com.izforge.izpack.installer.AutomatedInstaller.validatePanel(Unknown Source)
at com.izforge.izpack.installer.AutomatedInstaller.installPanel(Unknown Source)
at com.izforge.izpack.installer.AutomatedInstaller.doInstall(Unknown Source)
at com.izforge.izpack.installer.Installer.main(Unknown Source)
[ Automated installation FAILED! ]


Solution

Make sure you have performed the following steps correctly:

  • You have registered before Installation/Upgradation.
  • You have registered using the same path on which you are installing/upgrading OpsHub Integration Manager.
  • You have used the correct verification code. Verification Code is unique for each machine and installation path. The code generated on a different machine and for different path won’t work.
  • You have export same value for OPSHUB_TEMP_DATA during Registration and Installation/Upgradation.

During the installation process, you must select one of the four types of database (installation selections):

  • Installation with in-built HSQL (not recommended for production use)
  • Installation with MySQL Server
  • Installation with Oracle
  • Installation with MS SQL Server

The installer progresses to next panel in accordance with the user selection.

For step-by-step instructions for installation with the selected database, click the relevant link given below:

In-built Database MySQL Server Oracle MS SQL Server