Volt MX Foundry Installation on JBoss Domain Mode (Multinode)

\===============================================================================  
Licensing Type  
\--------------  
  
Installation environment is set to Development by default. Please select the appropriate type based on your license.  
Select Development for single machine instance, Non-Production for larger environments like QA or UAT and Production for the production instance.  
  
     1- Development  
     2- Non-Production  
   ->3- Production  
  
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT::

\===============================================================================  
Send Usage Data Anonymously  
\-------------- ------------  
  
Help us make your Volt MX Foundry experience better by allowing us to collect product usage information. We will not save any of your private or application data.  
  
Send usage data anonymously.  
  
   ->1- Yes  
     2- No  
  
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT::

\=======================================================================  
Install Components  
\------------------  
Please select Volt MX Foundry components to install.  
The Console is the administrative interface to manage your apps, environments and users.  
The Identity Services helps you to use a single gateway for all your authentication and authorization requests.  
The Integration Services helps you connect with any enterprise or third-party system to expose, transform and orchestrate your data as APIs.  
The API Developer Portal is a console that enables partner teams to discover, test and consume APIs.  
Engage your app users over sms, email and push using segmentation, location, campaigns and event driven messaging.  
A specialized component used to manage offline data synchronization between the backend system of record and the front-end app.  
Console, Identity and Integration Services are mandatory components of Volt MX Foundry.  
In a development scenario, all components can be installed on the same server. However, it is recommended to install these components on separate servers for a production environment.  
  
 ->1- Console  
  ->2- Identity Services  
  ->3- Integration Services  
  ->4- API Development Portal  
  ->5- Engagement Services  
  
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT::  

*   **Console** - To install Volt MX Foundry Console, type 1 and press **Enter**.  
    The system creates the following databases: `<prefix>mfconsoledb<suffix>`, `<prefix>mfaccountsdb<suffix>`, and  `<prefix>mfreportsdb<suffix>`.
*   **Identity Services** - To install Volt MX Identity Services, type 2 and press **Enter**.  
    The system creates the following database: `<prefix>idconfigdb<suffix>`.
*   **Integration Services** - To install Volt MX Foundry Integration, type 3 and press **Enter**.  
    The system creates the following databases: `voltmxadmindb`  and  `mfreportsdb`.
*   **API Developer Portal** - To install developer portal, type 4 and press **Enter**.  
    
    > **_Note:_** During installation if you have selected **API Developer Portal**, the **API Developer Portal** is created. You can directly access your [VoltMX Developer Portal](/Volt-MX-Documentation-Archive/docs/documentation/Foundry/voltmx_foundry_user_guide/Content/VoltMXDevPortal.html) in Volt MX Foundry Console.
    
*   **Engagement Services** - To install Volt MX Foundry Engagement Services, type 5 and press **Enter**.  
    The system creates the following database: `<prefix>vpnsdb<suffix>`.

**Reports Database**

The reports database is used for configuring reports.

The Installer creates the `mfreportsdb` if you choose either Console or Integration Services:

*   **Console** without Integration Services (with or without Engagement Services)
*   **Console** and **Integration Services** (with or without Engagement Services)
*   **Integration Services** without Console (with or without Engagement Services)

Reports Database for Integration on a Separate Node:

While installing console and integration on separate nodes, the installer prompts you to point the reports database during the integration installation.  
  
For example:  
  
You have installed only Console on one node. The installer creates these three databases such as `<>mfreportsdb<>` along with the `<>mfconsoledb<>` and `<>mfaccountsdb<>`. For example, your report database name is `voltmxmfreportsdb1`  
  
When you install the integration with or without one or more components (identity, or Engagement Services) on a separate node, the installer displays the **Reports Database Name** field in the **Database Details** window. If the installer prompts you to enter the existing reports db, enter the reports database name (for example, `voltmxmfreportsdb1`) in the **Database Details window > Reports Database Name** field.  
  
Refer to [creating a reports database, for example, **<prefix>mfreports<suffix>**](#CreatingReportsDBMN).

\=======================================================================  
Install Folder  
\---------------------  
Please choose a destination folder for this installation.  
  
NOTE: The installation path should not contain any special characters.  
  
Default Install Folder: /home/user1/VoltMXFoundry  
  
ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT  
: : /root/mfdomainmode  
  
INSTALL FOLDER IS: /root/mfdomainmode  
  
IS THIS CORRECT? (Y/N): y

> **_Note:_** By default, Volt MX Foundry is installed at the home directory of the user.

\===============================================================================  
Application Server  
\------------------  
  
Enter requested information  
\->1- Tomcat  
   2- JBoss  
3- WebLogic  
     
  
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT::

\===============================================================================  
Installation Mode  
\-----------------  
Please select your required installation mode. Standalone mode is for single node deployment whereas domain mode is for multi node deployment in JBoss cluster. Please note that if you want to install in domain mode then JBoss cluster should be preconfigured.  
  
Note: If you are running JBoss in Domain node for a production setup, please procure appropriate licenses from Red Hat, Inc.  
  
 ->1- Standalone Mode (Single Node)  
   2- Standalone Mode (Existing)  
   3- Domain Mode (Multi Node)  
  
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT::

> **_Important:_** To install Volt MX Foundry on single-node on JBoss that is bundled with the Volt MX Foundry installer, choose **1-** **Standalone Mode** (**Single Node**). For more details, refer to [Installing Volt MX Foundry on JBoss - Single Node](Installing_VoltMX_Foundry_on_Linux.html).  
  
To install Volt MX Foundry on single node on JBoss that is installed on your machine, choose **2-** **Standalone Mode** (**Existing**). For more details, refer to refer to [Installing Volt MX Foundry on Existing JBoss - Single Node](Installing_Foundry_JBoss_existing.html).

\========================================================================  
Application Server Details  
\--------------------------  
Please enter the details of preconfigured JBoss cluster. The default value is IP address of this machine.  
  
Master node hostname/IP address should not be 127.0.0.1, 0.0.0.0 or localhost. It should be a public IP address or a fully qualified domain name (FQDN).  
  
Fully Qualified Public URL of Volt MX Foundry(Default: ): http://<IP address:port>  
  
Master Node Hostname/IP Address (Default: ): <IP address>  
  
Master Node Management Port (Default: 9999): 9999  
  
Master Node HTTP/HTTPs Port (Default:8080): 8081  
  
  
  
User (Default: master):  

\========================================================================  
JBoss Master Node User's Password  
\---------------------------------  
Please enter the password:

\===============================================================================  
Server Groups  
\-------------  
A server group is set of server instances that will be managed and configured as one. In a managed domain each application server instance is a member of a server group. Please select the server groups from below mentioned list of available server groups to which you would like to deploy this application.  
1\. main-server-group  
2\. other-server-group  
  
Enter comma separated server groups number you want to use (e.g.: 1,2 or all) (Default: all):

The Selected Server Group details appear.

\===============================================================================  
Selected Server Group  
\---------------------  
You have selected below mentioned server groups.  
1\. main-server-group  
2\. other-server-group  
\->1- Continue with installation.  
          2- Go back to select again.  
  
ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:

\->1- MySQL 5.7

2- MySQL 5.7 Cluster - Group Replication

3- Oracle 19c (19.3.0)

4- SQL Server 2017

5- MariaDB 10.3. 13

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

*   In the _Database Choice_ if you select 2, the _Oracle Database Details_ appear.
    
    \========================================================================  
    Oracle Database Details  
    \-----------------------------------------  
      
    Please enter Oracle database server details.  
      
    Database Server Hostname/IP (Default: 10.10.24.51): <Hostname/IP>  
      
    Port (Default: 1521):  
      
    Service ID / Service Name(Default: ):  
      
    System Username (Default: ):  
    
    1.  Enter the following details:
        *   **Database Server IP**: Enter the server Hostname/IP to be used to create a database of selected components of Volt MX Foundry. By default, the server Hostname/IP is set as localhost.
        *   **Port**: Enter the database port of the Oracle Server. By default, this field is set to 1521 for oracle.
        *   **Service ID** **/ Service Name**: Enter Oracle service ID or service name. Service ID is unique alias given to an instance name of Oracle DB.
            
        *   **System Username**: Enter the user name used while creating the database user.
    2.  Press **Enter**. The installer prompts for _Enter Password for Database User_ details as follows:
        
        \========================================================================  
        Enter Password for Database User  
        \-----------------------------------------  
        Please enter the password:  
        
    3.  Provide a password and press **Enter**.
        *   If the database connection fails, the following error message displays.
            
            \===============================================================================  
            Database Connection Failed  
            \--------------------------  
            Database connection failed.  
              
            For the following reasons: Communications link failure  
              
            The last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server.  
              
            PRESS <ENTER> TO ACCEPT THE FOLLOWING (OK):
            
        *   If the database server not compatible, the following error message displays:
            
            \===============================================================================  
            Incompatible Database Server Version  
            \------------------------------------  
              
              
            PRESS <ENTER> TO ACCEPT THE FOLLOWING (OK):
            
    
    1.  Select the tablespace for Oracle database:
        
        > **_Important:_**  If tablespaces were already created, the DBA must grant quota (permissions) on these tablespaces to installer with admin option.  
          
        The DBA also must include grant quota on the schemas from installer login.
        
        \========================================================================  
        Tablespace Choice  
        \-----------------------------------------  
          
        Please select the Table Space type  
          
        \->1- Default Tablespace  
         2- User Defined Tablespace  
          
        ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT::  
        
        *   **Default Tablespace**: If selected, the database schema and SQL scripts migration happens automatically to the default tablespace - for example, `USERS`
        *   **User Defined Tablespace**: If selected, enter the tablespaces for the following:
            
            \========================================================================  
            Ask for the Tablespaces  
            \-----------------------------------------  
              
            Please enter the names of the Tablespaces  
              
            Data Tablespace (Default: ): HCL123  
            Index Tablespace (Default: ):  
            LOB Table Space (Default: ):  
            
            *   **Data Tablespace**:  
                Enter the name for Data tablespace.  
                
                This is a mandatory field. If the Data tablespace field is empty, the installers displays the error message:
                
                \========================================================================  
                TableSpace details not provided  
                \---------------------------------------  
                Please provide a valid Tablespace for at least the Data field for the installation wizard to proceed further. PRESS <ENTER> TO ACCEPT THE FOLLOWING (OK):  
                
                If the Data tablespace (for example, HCL123) does not exist, the installers displays the error message:
                
                \========================================================================  
                Invalid TableSpace Details  
                \---------------------------------------  
                Installation wizard is not able to access the HCL123 TableSpace provided with give credentials. Please verify the details again. PRESS <ENTER> TO ACCEPT THE FOLLOWING (OK):  
                
            *   **Index Tablespace**: Enter the name for Index tablespace.  
                If input for Index Tablespace is not provided, then the value will be set to the provided Datatable space value.
            *   **LOB Tablespace**: Enter the name for LOB tablespace.  
                If input for LOB Tablespace is not provided, then the value will be set to the provided Datatable space value.
*   In the _Database Choice_ if you select 3, the _SQL Server Database Details_ appear.
    
    \========================================================================  
    SQLServer Database Details  
    \-----------------------------------------  
      
    Please enter SQL database server details.  
      
    Database Server Hostname/IP (Default: 10.10.24.51): <Hostname/IP>  
      
    Port (Default: 1433):  
      
    Username 9Default: ):  
      
    Instance Name (Optional) (Default: ):
    
    1.  Enter the following details:
        *   **Database Server IP**: Enter the server Hostname/IP to be used to create a database of selected components of Volt MX Foundry. By default, the server Hostname/IP is set as localhost.
        *   **Port**: Enter the database port of the SQL Server. By default, this field is set to 1433 for SQL.
        *   **Username**: Enter the user name used while creating the database user - for example, dbclient.
        *   **Instance Name (Optional)**: Enter the instance name for the database. This information is optional.
    2.  Press **Enter**. The installer prompts for _Enter Password for Database User_ details as follows:
        
        \========================================================================  
        Enter Password for Database User  
        \-----------------------------------------  
        Please enter the password:  
        
    3.  Provide a password and press **Enter**.
        *   If the database connection fails, the following error message displays.
            
            \===============================================================================  
            Database Connection Failed  
            \--------------------------  
            Database connection failed.  
              
            For the following reasons: Communications link failure  
              
            The last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server.  
              
            PRESS <ENTER> TO ACCEPT THE FOLLOWING (OK):
            
        *   If the database server not compatible, the following error message displays:
            
            \===============================================================================  
            Incompatible Database Server Version  
            \------------------------------------  
              
              
            PRESS <ENTER> TO ACCEPT THE FOLLOWING (OK):
            
*   In the _Database Choice_ if you select 5, the _MariaDB Database Details_ appear.
    
    \========================================================================  
    MariaDB Database Details  
    \-----------------------------------------  
      
    Please enter MariaDB database server details.  
      
    Database Server Hostname/IP (Default: 10.10.24.51): <Hostname/IP>  
      
    Database Port (Default: 1433):  
      
    Database Username (Default: ):  
      
    Instance Name (Optional) (Default: ):
    
    1.  Enter the following details:
        *   **Database Server IP**: Enter the server Hostname/IP to be used to create a database of selected components of Volt MX Foundry. By default, the server Hostname/IP is set as localhost.
        *   **Database Port**: Enter the database port of the MariaDB Server. By default, this field is set to 3306 for MariaDB.
        *   **Database Username**: Enter the user name used while creating the database user - for example, dbclient.
    2.  Press **Enter**. The installer prompts for _Enter Password for Database User_ details as follows:
        
        \========================================================================  
        Enter Password for Database User  
        \-----------------------------------------  
        Please enter the password:  
        
    3.  Provide a password and press **Enter**.
        *   If the database connection fails, the following error message displays.
            
            \===============================================================================  
            Database Connection Failed  
            \--------------------------  
            Database connection failed.  
              
            For the following reasons: Communications link failure  
              
            The last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server.  
              
            PRESS <ENTER> TO ACCEPT THE FOLLOWING (OK):
            
        *   If the database server not compatible, the following error message displays:
            
            \===============================================================================  
            Incompatible Database Server Version  
            \------------------------------------  
              
              
            PRESS <ENTER> TO ACCEPT THE FOLLOWING (OK):

\===============================================================================  
Database name prefix and suffix  
\-------------------------------  
  
Please enter database name prefix and suffix. Please provide existing prefix and suffix if you intend to upgrade to the new Volt MX Foundry Database.  
  
Database Name Prefix (Default: HCL): tomcat  
  
Database Name Suffix (Default: 1): 54

*   Database Name Prefix: Enter valid prefix databases - for example, HCL.
*   Database Name Suffix: Enter valid suffix for all databases - for example, 1. 27.  Enter the prefix and suffix for the database and press **Enter**. The _Pre-Installation Summary_ details appear.

\===============================================================================  
Pre-Installation Summary  
\------------------------  
Please review the following before continuing:  
  
Install Folder:  
/root/VoltMXFoundry  
  
Components:  
Console and Identity Services  
  
Installation Mode:  
Domain Mode  
  
Fully Qualified Public URL:  
https://<hostname>  
  
Master Node Hostname/IP Address:  
<hostname>  
  
Database Server:  
<IP address>  
  
Database Names:  
voltmxidconfigdb, voltmxmfconsoledb & voltmxmfaccountsdb  
  
PRESS <ENTER> TO CONTINUE:

\========================================================================  
Ready To Install  
\-----------------------------------------  
  
Installer is now ready to install Volt MX Foundry Console onto your system at the following location:  
  
/home/user1/VoltMXFoundry  
  
PRESS <ENTER> TO INSTALL:  

\========================================================================  
Installing...  
\-----------------------------------------  
  
\[==================|==================|==================|==================\] \[------------------|------------------|------------------|------------------\]

\========================================================================  
Installation Complete  
\-----------------------------------------  
  
Congratulations. Volt MX Foundry has been successfully installed to:  
  
/home/user1/VoltMXFoundry  
  
Console URL: https://00.00.00.00:port/mfconsole  
Identity Services URL: https://00.00.00.00:port/authService  
Integration Services URL: https://00.00.00.00:port/admin  
Engagement Services URL: http://00.00.00.000:port/vpns  
  
PRESS <ENTER> TO EXIT THE INSTALLER: \[user1@cnt6-01c downloads\]$

> **_Important:_** When you are using a third party tool (for example, PuTTY) for installing Volt MX Foundry remotely, if any network connection issues occur at the end of the installation, the installer stops the installation and the installation log is not created.