Tutorial Part 1: Install Joget DX 8 Operator from the OperatorHub

These steps assume that you already have a running OpenShift 4 cluster. You can access https://try.openshift.com/ and select Openshift 4 playground to setup a new cluster.

1.1 Install Joget DX 8 Operator as Cluster Admin

1. Login to the OpenShift console as the cluster admin 

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
   
   

2. Browse to Operators > OperatorHub and search for Joget DX8

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
   
   
   

3. Select the Joget DX 8 Operator, and click on the Install button

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
   
   
   

4. Click on the Install button to install the Joget DX 8 Operator.

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
   
   
   

5. Browse to Catalog > Installed Operators and select Joget DX 8 Operator to confirm that the operator has been installed successfully.

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
    

Tutorial Part 2: Create a Joget Cluster with the Joget DX 8 Operator

2.1 Create New Project and Deploy Database

1. Now that the Joget Operator has been installed, login to the OpenShift console as a normal user.

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
   
   
   

2. Browse to Projects and click on the Create Project button. Enter a name and click on Create.

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
   
   
   

3. As a prerequisite, you will need to deploy either a MySQL or MariaDB database in the project.

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
   

4. The fastest way to deploy MySQL would be to use the OpenShift CLI e.g.: 

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details

   # deploy persistent mysql
   export DB_APP_NAME=jogetdb
   export MYSQL_DATABASE=jwdb
   export MYSQL_USER=joget
   export MYSQL_PASSWORD=joget
   
   oc new-app openshift/mysql-persistent --name $DB_APP_NAME -p DATABASE_SERVICE_NAME=$DB_APP_NAME -p MYSQL_USER=$MYSQL_USER -p MYSQL_PASSWORD=$MYSQL_PASSWORD -p MYSQL_DATABASE=$MYSQL_DATABASE

5. Alternatively, you can deploy using the OpenShift Console.

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
    

6. Browse to the project, go to Workloads and click on add page.

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
   
   
   

7. Select Database.

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
   

8. Search for MySQL.

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
   
   
   
   

9. Select MySQL then click on Instantiate Template.

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
   
   

10. Key in the following configuration and click on Create.

    License Error

    The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

    • License Details
    
    
    
     
    1. Database Service Name: jogetdb
    2. MySQL Connection Username: joget
    3. MySQL Connection Password: joget
    4. MySQL Database Name: jwdb
       
       

11. Go to Workloads → Deployment Configs to verify that the MySQL database has been deployed successfully.

    License Error

    The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

    • License Details
    
    
    
    

2.2 Deploy Joget DX 8 using the Joget DX 8 Operator

1. Browse to Operators > Installed Operators.

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
   
   
   

2. Select the Joget DX 8 Operator, and click on Create Instance.

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
   
   
   

3. By default the configuration for “name” is “example-joget” and “size” is 1 (the number of required Joget instances). Modify the values as required, click Create.

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
   
   
   

4. The Joget DX 8 Operator will automatically start to deploy the required number of Joget DX 8 instances along with all the required resources, which should take a few minutes.

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
   
   
   

5. Select the created Joget name, and click on Resources to see the resources automatically created and managed by the Joget DX 8 Operator.

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
   
   
   

6. Click on Events to see the events as they happen

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
    

2.3 Complete One-Time Joget Database Setup

1. Browse to Home > Projects and select the Joget DX project. Click on Workloads tab and select Joget DX deployment. After a few minutes, you should see at least 1 available MATCHING PODS.

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
   
   
   

2. Select Resources to see the created Services and Routes. Copy the Location in the created Route. That is the URL to access Joget DX from an external browser.

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
   
   
   

3. Access the Joget DX 8 URL and in the Database Setup page, key in the database configuration of the database deployed earlier and click on the Save button.

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details
   
   
   
   
   

1. Database Type: MySQL
2. Database Host: the service name of the database e.g. jogetdb
3. Database Port: 3306
4. Database Name: the configured database name e.g. jwdb
5. Database User: the configured username e.g. joget
6. Database Password: the configured password e.g. joget
   
   

4. Once the setup is completed, click on Done and you will be brought to the Joget DX App Center. 

   License Error

   The license of the app Translations for Confluence (formerly Language Macros) has expired. Please renew the license.

   • License Details