1 – Download OpsHubAutoInstall.xml file


 If you are installing OpsHub Integration Manager then download OpsHubAutoInstall.xml file from here.						
   - For installing OpsHub Integration Manager, you need to follow steps from Configure Installation path.
 If you are upgrading the existing OpsHub Integration Manager then download OpsHubAutoMigrator.xml file from here..			
   - For Upgrading OpsHub Integration Manager, you only need to follow step 3 and step 4.
   Refer section Customized OpsHubAutoInstall.xml file for customized file example.

2 – Customized OpsHubAutoInstall.xml file


You need to change OpsHubAutoInstall.xml file as described in further steps below for configuring your own custom file for OpsHub Integration Manager

Here are the examples of OpsHubAutoInstall.xml after all modification.    
    - Installation with MySQL Database : OpsHubAutoInstall.xml 
    - Upgradation : OpsHubAutoMigrator.xml

3 – Configure Installation Path


 Find "com.izforge.izpack.panels.TargetPanel" and replace the input mentioned below:    
    - Replace @INSTALLATION_PATH@ with actual installation directory which you mentioned in Registration_Input.properties during Silent Registration.	

4 – Configure Verification Code


Find "UserInputPanel.EmailIdVerificationForExistingCode" panel and replace the input mentioned below:			
   - Replace @VERIFICATION_CODE@ with verification code that you got on your registered business email address.

5 – Configure Base Parameter


Find all paramaters below under panel id="UserInputPanel.installationflow".        
   1) Find @COMPANY_NAME@ parameter in the OpsHubAutoInstall.xml file and replace with your company name.
   2) Find @ADVANCE_CONFIG_FLAG@ and replace with either "1" if you want to configure advance parameter or "0" if you don't want to configure advance parameters.
        Note.jpg Advance configuration allows to change default database name, Http/Https configuration, Advanced Security Options. 
        -If you are setting above flag as "0" then advance configuration parameters will be set with default values.
   3) Find @DB_TYPE@ and replace database type as below.
        -Replace with "MySQL" for configuring MySQL database and follow step MySQL Database configuration.
        -Replace with "MS SQL Server" for configuring MySQL database follow step MSSQL Database configuration.
        -Replace with "ORACLE" for configuring Oracle database and follow step  Oracle Database configuration.
        -Replace with "HSQLDB" for configuring HSSQL and follow step HSQL Database configuration.
             

6 – Database configuration


MySQL Database configuration

1) Find panel with id "UserInputPanel.mysqldb".
2) Remove comment from parameters.
3) Go to Common Database configuration parameters and follow the steps.

Common Database Configuration Parameters:
1) Find and replace @DB_PORT@ with the port of your database.
2) Find and replace @DB_PASSWORD@ with the password of your database.
3) Find and replace @DB_HOST@ with the host name of your database.
4) Find and replace @DB_CONNECTOR_JAR_PATH@ with the jar file path of your database connector. Find the jar file name according to the database you are using.
    -For MySQL, refer section Installation with MySQL Server
    -For MS SQL, refer section Installation with MSSQL Server
    -For ORACLE, refer section Installation with Oracle
    -For HSQL, no external connector jar file is required.
5) Find and replace @DB_USER@ with the username of your database.

MSSQL Database configuration

Installation on Windows
With Windows authentication
1) Find panel with id "UserInputPanel.mssqlAuthModeOnWindows".
2) Remove comment from parameters.
3) Find @DB_AUTH_TYPE@ in the same panel.
4) Replace variable value with "Windows Authentication" if you are configuring MSSQL with Windows Authentication.
5) Find panel with id "UserInputPanel.mssqldbOnWindowsAuth".
6) Remove comment from parameters.
7) Go to Common Database configuration parameters and follow the steps to replace @DB_PORT@, @DB_HOST@, @DB_CONNECTOR_JAR_PATH@ with your input.
With SQL authentication
1) Find panel with id "UserInputPanel.mssqlAuthModeOnWindows".
2) Remove comment from parameters.
3) Find @DB_AUTH_TYPE@ in the same panel.
4) Replace variable value with "SQL Authentication" if you are configuring MSSQL with SQL Authentication.
5) Find panel with id "UserInputPanel.mssqldbOnSQLAuth".
6) Go to Common Database configuration parameters and follow the steps.
Installation on Linux
1) Find panel with id "UserInputPanel.mssqlAuthModeOnLinux".
2) Remove comment from parameters.
3) Find @DB_AUTH_TYPE@ in the same panel.
4) Replace variable value with "SQL Authentication" if you are configuring MSSQL with SQL Authentication.
5) Find panel with id "UserInputPanel.mssqldbOnSQLAuth".
6) Go to Common Database configuration parameters and follow the steps.

Oracle Database configuration

1) Remove comment from panel id "UserInputPanel.oracleDatabaseType".
2) Find and replace @ORACLE_DB_TYPE@ from the same panel with CDB or Non CDB depending upon your oracle database type. For reference follow section Installation with Oracle.
3) Now, remove comment from panel id "UserInputPanel.oracledb".
4) Find and replace @ORC_INSTANCE@ with oracle database instance name from the same panel.
5) Go to Common Database configuration parameters and follow the steps.

HSQL Database configuration

1) For HSQL you can move to next step for further configuration.

7 – Enable Advance Configuration


If you are doing advance configuration then only follow the below step.

-Make sure you have @ADVANCE_CONFIG_FLAG@ flag is 1 as specified here.
Enabling advance configuration with HSQL, then follow below steps
1) Remove comment from panel id "UserInputPanel.advancedOptionsHSQL" and add comment in panel id "UserInputPanel.advancedOptions".
2) Find @ADV_ISSERVICE@ and replace with 1 if  you want to configure OpsHub Integration Manager as a service else replace it with 0.
3) Find @ADV_SEC_CONFIG@ and replace with 1 if you want to configure advance Security configuration else replace it with 0.
4) Find @ADV_HTTP_CONFIG@ and replace it with "HTTP" if you want to configure OpsHub Integration Manager with HTTP or replace it with "HTTPS" if you want to configure OpsHub Integration Manager with https.
    -Make sure you are following step no 8 if you configure OpsHub Integration Manager with https.
Enabling advance configuration other than HSQL, then follow below steps
1) Remove comment from id "UserInputPanel.advancedOptions".
2) Find @ADV_ISSERVICE@ and replace with 1 if  you want to configure OpsHub Integration Manager as a service else replace it with 0.
3) Find @ADV_ISDBFLAG@ and replace with 1 if you will create OpsHub Integration Manager database manually else set it as 0.
4) Find @ADV_OPSHUBDBMAME@ and replace it with your OpsHub Integration Manager database name else remove that entry from the panel.
5) Find @ADV_SEC_CONFIG@ and replace with 1 if you want to configure advance Security configuration else replace it with 0.
6) Find @ADV_HTTP_CONFIG@ and replace it with "HTTP" if you want to configure OpsHub Integration Manager with HTTP or replace it with "HTTPS" if you want to configure OpsHub Integration Manager with https.
    -Make sure you are following step no 8 if you configure OpsHub Integration Manager with https.
7) Find @ADV_REPORT_DBNAME@ and replace it with your OpsHub Integration Manager report database name else remove that entry from the panel.

8 – HTTPS configuration


1) Make sure you have configure @ADV_HTTP_CONFIG@ with "HTTPS" value.
   2) Find panel with id "UserInputPanel.certInfo" remove comment from parameters.
   3) Find @CERT_COMP_NAME@ and replace it with your Organization Name.
   4) Find @CERT_COMP_CITY@ and replace it with your Organization's City.
   5) Find @CERT_COMP_COUNTRY@ and replace it with your Organization's Country.
   6) Find @CERT_COMP_UNIT@ and replace it with your Organization's Unit like Manufacturing, Sales etc.
   7) Find @CERT_COMP_STATE@ and replace it with your Organization's State or Province.
   8) Find @CERT_VALIDITY@ and replace it with number of days for which the certificate should be considered valid.
   9) Find @CERT_SERVER_HOST@ and replace it with IP Address/hostname of Machine on which you install OpsHub Integration Manager.

9 – Advance Security Configuration


1) Make sure you have configure ADV_SEC_CONFIG with "1" value in step 5.
   2) Find panel with id "UserInputPanel.securityConfig" remove comment from parameters.
   3) Find @SEC_ALGO@ and replace with either "AES-256" or "DES-56 or "DESede-168" as per your need.
   4) Find @SEC_KEYMODE@ replace with "newSecretKey" 
   5) Find @SEC_KEY_PATH@ and replace with your secret key installation path.
   6) Note do not copy your secret file once its generated after OpsHub Integration Manager installation process.