Installing Quantum Fabric on Tomcat - Console-mode

NOTE:  If a user installs Quantum Fabric Console on a partition different from the user's home directory, the user must have read/write execute permissions.

This section of the document provides you with the instructions for installing and configuring Quantum Fabric Console on a single node. For multi-node installations, refer the Deployment Checklist and Example Case Studies.

IMPORTANT:  Ensure that you have the required hardware and access to the supporting software as mentioned in the Prerequisites section and performed the steps as mentioned in the Pre-installation Tasks section.

Make sure you have proper administrative rights to install Quantum Fabric on your computer.

You also need a user where Quantum Fabric will be installed.

The <Install Location> directory contains the log files logging each invocation of the installer. To make problem identification easier, provide these log files to Quantum when reporting an issue.

To install Quantum Fabric Console on Tomcat using the installer, follow these steps:

  1. Execute the following command to switch to the user that you created.

    2. # su - username

  2. Press Enter. The system prompt you to enter the password.
  3. Enter the password, and press Enter.
  4. Unzip the QuantumFabricSetup.tar.gz file, and navigate to the folder QuantumFabric_Installer_Linux.
  5. Start the ./QuantumFabricInstaller-x.x.x.x_GA.bin file by executing the following command:
    6. Preparing to install
Extracting the JRE from the installer archive...
Unpacking the JRE...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...

Launching installer...
=====================================
Quantum Fabric                                   
    (created with InstallAnywhere)
-------------------------------------
Preparing CONSOLE Mode Installation...
=====================================
Introduction
------------

This installer will install a new or upgrade an existing instance of Fabric.

Quantum Fabric is a set of enterprise-grade mobile infrastructure services
that makes it easy to build amazing apps that integrate and support all of
your backend systems. With open, standards-based development, scalable and
secure services, and exceptional agility, enterprises can dramatically reduce
the cost and complexity of enterprise mobility projects.

To proceed with installation, please confirm that the following prerequisites
have been met -

1. Database server with admin user for installation. MySQL, MariaDB, Oracle
and MS SQL Server are the supported Database servers. MariaDB is supported for
Tomcat/JBoss only
2. Corresponding database user should exist and that user should have all
required privileges as per the documentation.
3. If you want to use your existing SSL certificate then please have the SSL
certificate mapped to the domain name you want to use.
4. If you want to install with JBoss as an option for application server, then
have the application server preconfigured. Please note that single node JBoss
is also bundled as part of the installer, in case you want to install afresh.

To change input, type 'back' to go back to the previous step.
To cancel the installation, type 'quit' at any time.

For troubleshooting & help on the installation, use
http://docs.kony.com/konylibrary/konyfabric/resources/installer.htm.

For getting started on Quantum Fabric, refer
https://basecamp.kony.com/s/app-platform-documentation.

If you have more questions or feedback, you can join our
community at https://basecamp.kony.com/ or raise a support ticket at
https://basecamp.kony.com/s/caselistview/.

  ->1- Continue with Installation.
    2- Abort Installation.

ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:

  1. Press Enter. The Software License Agreement  details appear. 

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

Installation and Use of Quantum Fabric Requires Acceptance of the Following
License Agreement:

Kony is now part of the Temenos group of companies

KONY, INC. SOFTWARE LICENSE AGREEMENT FOR FABRIC ("AGREEMENT")

THE TERMS AND CONDITIONS CONTAINED HEREIN CONSTITUTE A LEGAL AGREEMENT.
THIS AGREEMENT ("AGREEMENT") CONTAINS THE ENTIRE AGREEMENT BETWEEN YOU
("LICENSEE" or "You" or "you") AND KONY, INC. ("KONY") WITH RESPECT TO THE
TERMS AND CONDITIONS DESCRIBED HEREIN. READ THIS AGREEMENT CAREFULLY BEFORE
YOU CLICK THE "I ACCEPT" BUTTON BELOW. BY CLICKING ON THE "I ACCEPT" BUTTON,
YOU ACKNOWLEDGE THAT (1) YOU ARE AUTHORIZED TO ENTER THIS AGREEMENT FOR AND ON
BEHALF OF YOUR COMPANY, AND ARE DOING SO, AND (2) YOU HAVE READ, UNDERSTOOD,
AND AGREE THAT YOU AND  KONY SHALL BE BOUND BY THESE TERMS AND CONDITIONS AND
ALL MODIFICATIONS AND ADDITIONS AGREED TO IN WRITING BY THE PARTIES.   IF YOU
DO NOT AGREE WITH THESE TERMS AND CONDITIONS, CLICK ON THE "I DO NOT ACCEPT"
BUTTON BELOW AND INSTALLATION WILL TERMINATE.


    DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): Y
  2. Press Enter to continue with new installation.

    The following installation types are supported for new installation:

    • Development for single machine instance.
    • Non-Production for larger environments like QA or UAT.
    • Production for the production instance.
    ======================================
Licensing Type
--------------

To upgrade your existing instance for Fabric, provide the Database details of
your existing instance. The Database schema will be updated to the latest
version, no application data will be lost.

Please select the type of environment you want to install.
Development – Single server instance typically used for development
Non-Production – A multi-server environment for testing or staging
environments
Production – A full production-grade environment

    1- Production
    2- Non-Production
  ->3- Development

ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: 3
  3. Enter your choice and press Enter. The Send Usage Data Anonymously details appear. Allows Temenos to collect product usage information to make your Quantum Fabric experience better. Temenos does not save any of your private or application data.
    ======================================
Send Usage Data Anonymously
---------------------------

Help us make your Quantum Fabric 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: 1
  4. Enter your choice and press Enter. The Install Components details appear.
    ======================================
Install Components
------------------

Please select Quantum Fabric 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
Quantum Fabric. 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 Developer Portal
  ->5- Engagement Services

ENTER A COMMA-SEPARATED LIST OF NUMBERS REPRESENTING THE DESIRED CHOICES, OR
PRESS <ENTER> TO ACCEPT THE DEFAULT: 1,2,3,4,5
    • Console - To install Quantum Fabric 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 Quantum Identity Services, type 2 and press Enter.
      The system creates the following database: <prefix>idconfigdb<suffix>.
    • Integration Services - To install Quantum Fabric Integration, type 3 and press Enter.
      The system creates the following databases: Quantumadmindb  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 Quantum Developer Portal in Quantum Fabric Console.

    • Engagement Services - To install Quantum Fabric Engagement Services, type 5 and press Enter.
      The system creates the following database: <prefix>kpnsdb<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 konymfreportsdb1

    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, konymfreportsdb1) in the Database Details window > Reports Database Name field.

    Refer to creating a reports database, for example, <prefix>mfreports<suffix>.

  5. Press Enter to continue the installation. The Install Folder details appear.

    ==============================
    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/KonyFabric

    ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT
    :

    NOTE:  By default, Quantum Fabric is installed at the home directory of the user.

  6. Press Enter to continue the installation. The installer prompts for the Application Server details as follows:

    ======================================
    Application Server
    ------------------

    Enter requested information
    ->1- Tomcat
       2- JBoss
    3-WebLogic

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

  7. In the Application Server, type 1.

    NOTE: By default Tomcat manager password in used by Quantum Fabric for Web Application publish. To change the default Tomcat manager password, the new password needs to be replaced in the password value for user manager in <tomcat-users> tag in tomcat-users.xml.

    Now to replace the value in database, the password value should be encrypted. To encrypt the database password, follow these steps mentioned in the Encrypt_Passwords section.

    Once the password is encrypted, replace the encrypted value in the prop_value column in the row where prop_value is management_server_password of <DatabasePrefix>admindb<DatabaseSuffix> database in the server_configuration table.

  8. Press Enter. The HTTP or HTTPS details appear asking you to choose the HTTP or HTTPS.

    ===============================
    HTTP or HTTPS
    -------------
    Please select the communication protocol you want to use. We recommend that you use HTTPS in production environment.
    ->1- HTTP
       2- HTTPS

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

    1. In HTTP or HTTPS  if you select 1 and press Enter, the following details in the Details for Application Server details appear.

      ======================================
      Details for Application Server
      ------------------------------

      Please enter the Hostname/IP Address and port you want to use. The default value is the IP Address of this machine.

      Hostname/IP Address (Default: ): <IP address>

      HTTP Port (Default: 8080): 8181


      Tomcat Shutdown Port (Default: 38011):

      IMPORTANT: In case of Tomcat, enter the Tomcat shutdown port.

    2. In the HTTP or HTTPS, if you type 2 and press Enter, the following details in the Details for Application Server details appear.

      ======================================
      Details for Application Server
      ------------------------------

      Please enter the Hostname/IP Address and port you want to use. The default value is the IP Address of this machine.

      NOTE: If you want to use your existing SSL certificate then please have the SSL certificate mapped to the domain name you want to use.

      Hostname/IP Address (Default: ): <IP address>

      HTTP Port (Default: 8080):

      HTTPS Port (Default: 8443):
      Tomcat Shutdown Port (Default: 38011):

      IMPORTANT: After installing Kony Fabric, import your SSL certificate (for example, domain.subdomain.crt) into your Kony Fabric installer's JRE trusted certificate authority (CA) certificates file - for example, <INSTALL_DIR>/jre/lib/security/cacerts

      If your SSL certificate is not configured, the system displays an error - for example, "peer not authenticated".

      For details, refer to Troubleshoot with SSL Certificate Issues.

      NOTE:  Based on the inputs provided in the previous  HTTP or HTTPS  >  a  or  HTTP or HTTPS  >  b, one of the following error messages appears:

      • If a port is already in use, the installer displays the following error message:

        ======================================
        Validation of Host Detail
        -------------------------
        Port 22 is already in use.

        Please provide a different port.

        ->1- Go back to give valid input.
           2- Abort Installation.

        ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:

      • If you provide an invalid port, the installer displays the following error message:

        ======================================
        Port Validation
        ---------------
        Please enter a valid port. Port should be in between 1-65535.
        ->1- Go back to give valid port.
           2- Abort Installation.

        ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT::

      • If you provide an invalid Hostname/IP address, the installer displays the following error message:

        ======================================
        Invalid Hostname/IP Address
        ---------------------------

        Please enter a valid hostname/IP address.

        ->1- Go back to give valid details.
           2- Abort Installation.

        ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:

  9. Provide the Hostname/IP Address, HTTP Port, and HTTPS Port, and press Enter. The SSL Configuration for HTTPS Communication details appear only if you select HTTPS. Choose one of the following two options:

    ===============================
    SSL Configuration for HTTPS Communication
    -----------------------------------------

    Please select the appropriate option to proceed.

    ->1- Create self-signed certificate
       2- Provide SSL certificate

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

    1. In the SSL Configuration for HTTPS Communication, if you select 1, the Details for self-signed SSL Certificate details appear.

      IMPORTANT: To add an existing SSL certificate to cacerts file, refer to How to Add Your Existing SSL Certificate.

      ===============================
      Details for self-signed SSL Certificate
      -----------------------------------------

      Please provide the following details to create self-signed certificate. All the fields are mandatory.

      Please note that the path of self-signed certificate will be  /root/KonyFabric/keystore.jks.

      Organizational Unit (DEFAULT: ): platform

      Host Name (DEFAULT: ): kony.com

      Company (DEFAULT: ): Kony

      City (DEFAULT: ): HYD

      State (DEFAULT: ): AP

      Country (DEFAULT: ): IND

      NOTE: The path for a self-signed certificate will be in this location: <install folder>\keystore.jks

    2. In the SSL Configuration for HTTPS Communication, if you select 2, the SSL Certificate Details details appear.

      NOTE: Provide path for .jks file as input.

      ===============================
      SSL Certificate Details
      -----------------------
      Please provide the following details

      Absolute Path to Keystore File (Default: ): /downloads/_.konylabs.net.2016.jks

    3. Type the details. The installer prompts for Password for keystore file details as follows:

      ===============================
      Password for keystore file
      -----------------------------------------

      Password should contain minimum six characters and should not contain space.

      Please enter the password:

      • If you enter an incorrect password -- for example, one that is fewer than six characters, contains a space, or is empty -- the following error message for an invalid keystore password is displayed.

        ===============================
        Password for keystore file
        -----------------------------------------

        ===============================
        Invalid Keystore Password
        -------------------------
        Keystore password must be at least six characters and should not contain space.

        PRESS <ENTER> TO ACCEPT THE FOLLOWING (OK):

  10. Type the password.
  11. Press Enter. The Database Choice details appear:

    ===============================
    Database Choice
    -----------------------------------------
    Please select the database provider of your choice.

    ->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::

  12. In the Database Choice, choose the DB:
    • In the Database Choice if you select 1, the MySQL Database Details appear.

      ===============================
      MySQL Database Details
      -----------------------------------------

      Please enter MySQL database server details

      Database Server IP (DEFAULT: localhost): <IP address>

      Port (DEFAULT: 3306):

      Username (DEFAULT: ): root

      1. Enter the following details:
        • Database Server IP: Enter the server Hostname/IP to be used to create a database of selected components of Quantum Fabric. By default, the server Hostname/IP is set as localhost.
        • Port: Enter the database port of the MySQL Server. By default, this field is set to 3306 for MySQL.
        • Username: Enter the user name used while creating the database user - for example, dbclient.
      2. Provide a password and press Enter.
      3. If you are using an encrypted database password, type the key that you received from the encryption tool and press Enter. Otherwise, leave the field blank and press Enter.
        For more information, refer to How to encrypt the database password.
        • 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
          ------------------------------------
          Minimum requirement for MySQL database server is 5.7.

          PRESS <ENTER> TO ACCEPT THE FOLLOWING (OK):

    • 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 Quantum Fabric. 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.
      4. If you are using an encrypted database password, type the key that you received from the encryption tool and press Enter. Otherwise, leave the field blank and press Enter.
        For more information, refer to How to encrypt the database password.
        • 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: ): Kony123
          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, Kony123) does not exist, the installers displays the error message:

            ===============================
            Invalid TableSpace Details
            ---------------------------------------
            Installation wizard is not able to access the Kony123 TableSpace provided with give credentials. Please verify the details again. PRESS <ENTER> TO ACCEPT THE FOLLOWING (OK):

          • Index 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 Quantum Fabric. 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.
      4. If you are using an encrypted database password, type the key that you received from the encryption tool and press Enter. Otherwise, leave the field blank and press Enter.
        For more information, refer to How to encrypt the database password. 
        • 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):

          IMPORTANT: Follow the below steps only if you want install Quantum Fabric on Tomcat with Microsoft Azure SQL Server database.

          • For Microsoft Azure (MSSQL), If you want to install Quantum Fabric V8 on Tomcat with Microsoft Azure SQL, you must edit the authService.xml file from the existing Tomcat with Microsoft SQL Server install location. For more details, refer the following section on how to configure identity to work on Microsoft Azure SQL.

            Configure Identity on Tomcat with Microsoft Azure SQL Server

            To run identity on Tomcat with Microsoft Azure SQL, you must edit the authService.xml file from the existing Tomcat with MSSQL install location.

            1. Open the authService.xml file from the existing Tomcat with MSSQL install location.
              Sample Location for authService.xml from Tomcat with MSSQL install folder, <LocalDrive>\QuantumFabricInstallerV8\tomcat\conf\Catalina\localhost\authService.xml
            2. Modify the following the authService.xml file:
              <?xml version="1.0" encoding="utf-8" ?>
<!-- The contents of this file will be loaded for each web application -->
<Context>

    	<Resource auth="Container" driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
              factory="org.apache.tomcat.jdbc.pool.DataSourceFactory" initialSize="5" jmxEnabled="true" logAbandoned="true" maxActive="10" maxIdle="5" maxWait="10000" minEvictableIdleTimeMillis="30000" minIdle="2" name="jdbc/authglobaldb" password="<Password>" removeAbandoned="true" removeAbandonedTimeout="600" testOnBorrow="true" testOnReturn="false" testWhileIdle="true" timeBetweenEvictionRunsMillis="30000" type="javax.sql.DataSource" url="jdbc:sqlserver://<DBServerIP:PORT>;databasename=<auth database name>;sendStringParametersAsUnicode=true;" username="<User_Name>" validationInterval="30000" validationQuery="SELECT 1"/>
		
		<Resource auth="Container" driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
              factory="org.apache.tomcat.jdbc.pool.DataSourceFactory" initialSize="5" jmxEnabled="true" logAbandoned="true" maxActive="10" maxIdle="5" maxWait="10000" minEvictableIdleTimeMillis="30000" minIdle="2" name="jdbc/authconfig" password="<Password>" removeAbandoned="true" removeAbandonedTimeout="600" testOnBorrow="true" testOnReturn="false" testWhileIdle="true" timeBetweenEvictionRunsMillis="30000" type="javax.sql.DataSource" url="jdbc:sqlserver::/<DBServerIP:PORT>;databasename=<auth database name>;sendStringParametersAsUnicode=true;" username="<User_Name>" validationInterval="30000" validationQuery="SELECT 1"/>
		
</Context>
    • 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 Quantum Fabric. 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.
      4. If you are using an encrypted database password, type the key that you received from the encryption tool and press Enter. Otherwise, leave the field blank and press Enter.
        For more information, refer to How to encrypt the database password.
        • 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):

  13. Press Enter. The installation prompts for Database name prefix and suffix details as follows:

    ======================================
    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 Kony Fabric Database.

    Database Name Prefix (Default: kony): tomcat

    Database Name Suffix (Default: 1): 54

    • Database Name Prefix: Enter valid prefix databases - for example, Quantum.
    • Database Name Suffix: Enter valid suffix for all databases - for example, 1.
  14. Enter the prefix and suffix for the database and press Enter. The Administrator Account Configuration details appear.

    The Administrator Account Configuration details help you to configure your super administrator account.

    The Administrator Account Configuration window appears only while installing Console and Identity Services along with one or all other Quantum Fabric components such as Integration Services, and Engagement Services on Tomcat or JBoss on a single node. You can select the components at Install Components.

    ======================================
    Administrator Account Configuration
    -------------------------------

    Please configure your Administrator Account. We require your First Name, Last Name, Email Address and Password. Your Name is used for display purposes in the console, the Email address will be used as your login ID and we do not use it to send unsolicited emails.

    Public URL (Default: ):

    First Name (Default: ):

    Last Name (Default: ):

    Email (Default: ):

    1. In the Administrator Account Configuration, enter the following details to create the administrator account.

      • Public URL: The URL field is filled with required details, for example. <Hostname/IP address>:<port>. Change these details, if required.

      • First Name: Enter the first name of the user.

      • Last Name: Enter the last name of the user.

      • Email: Enter the email address of the user. It can include alphanumeric and special characters that follow standard email address form.

        NOTE: During Quantum Fabric installation if you have configured your super administrator account, you can directly log in to Quantum Fabric Console.

    2. Press Enter. The Password for the Administrator Account details appear.

      ======================================
      Password for the Administrator Account
      -------------------------------
      Please Enter the Password:


      Confirm Password for the Administrator Account Configuration

      Please Enter the Password:

    3. Enter the admin log-in password and press Enter. The Confirm Password for the Administrator Account Configuration details appear.

      ======================================
      Confirm Password for the Administrator Account Configuration
      -------------------------------

      Please Enter the Password:

  15. Re-enter the admin log-in password and press Enter. The Quantum Fabric server startup details appear.

    ======================================
    Quantum Fabric server startup details
    -----------------------------------

    Do you want to start the Quantum Fabric server after successful installation of Quantum Fabric
    ->1- Yes
       2- No

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

  16. To start the server automatically after the successful installation of Quantum Fabric, press Enter.

    NOTE: To start the server manually after the successful installation of Quantum Fabric, refer to Starting Quantum Fabric Console.

    The Pre-Installation Summary details appear.

    =========
    Pre-Installation Summary
    ------------------------
    Please review the following before continuing:

    Installation Type:
    New Installation

    Install Components:
    Console, Developer Portal, Identity Services, Integration Services and Engagement Services

    Install Folder:
    /home/User/QuantumFabricInstaller-DEV-8.4.1.438

    Application Server:
    Tomcat 8.5.32

    Application Server Details:
    Hostname/IP Address: 10.11.12.201, Protocol: HTTP, HTTP Port: 8080,

    Database Choice:
    MySQL 5.7

    Database Details:
    Hostname/IP Address: mbaastest22.konylabs.net, User: mfuser, Port: 3306

    Database Names:
    Test_mfconsoledb_438, Test_mfaccountsdb_438, Test_mfreportsdb_438, Test_idconfigdb_438, Test_admindb_438 and Test_kpnsdb_438

    Admin Account Details:
    First Name:test, Last Name:one, Email:bvtuser@kony.com

    PRESS <ENTER> TO CONTINUE: ================== Installing... ------------- [==================|==================|==================]

  17. Type the details and press Enter. The Ready To Install  details appear.

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

    Installer is now ready to install Kony Fabric Console onto your system at the following location:

    /home/user1/KonyFabric

    PRESS <ENTER> TO INSTALL:

  18. Press Enter to continue the installation.

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

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

  19. Press Enter. The Installation Complete details appear.

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

    Congratulations. Kony Fabric has been successfully installed to:

    /home/user1/KonyFabric

    Console URL: https://00.00.00.00:port/mfconsole
    Identity Service URL: https://00.00.00.00:port/authService
    Integration Service URL: https://00.00.00.00:port/admin
    Engagement Services URL: http://00.00.00.000:port/kpns

    PRESS <ENTER> TO EXIT THE INSTALLER: [user1@cnt6-01c downloads]$

  20. Press Enter to complete the installation. After the installation is completed, the installer creates logs in the install folder.

    IMPORTANT: When you are using a third party tool (for example, PuTTY) for installing Kony Fabric 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.

IMPORTANT:  After installing Kony Fabric, import your SSL certificate (for example, domain.subdomain.crt) into your Quantum Fabric installer's JRE trusted certificate authority (CA) certificates file - for example,
<INSTALL_DIR>/jre/lib/security/cacerts

If your SSL certificate is not configured, the system displays an error - for example, "peer not authenticated".

For more information, refer to Troubleshoot with SSL Certificate Issues.

NOTE: You can now access Quantum Fabric Console by using the URLs. For more details, refer to Accessing Quantum Fabric Console - On-premises.
During installation if you have configured your super administrator account, you can directly log in to Quantum Fabric Console by using the Console URL.