Versions Compared

Old Version 6

changes.mady.by.user Adam Lee

Saved on

compared with

New Version 7

changes.mady.by.user Julian

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Login to the OpenShift console as the cluster admin 

    Image Modified

  2. Browse to Catalog > OperatorHub and search for Joget DX

    Image Modified

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

    Image Modified

  4. Click on the Subscribe button to install the Joget DX Operator.

    Image Modified

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

    Image Modified

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

...

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

    Image Modified

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

    Image Modified

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

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

    Code Block
    # deploy persistent mysql
export DB_APP_NAME=joget-mysqljogetdb
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. registry
  5. Alternatively, you can deploy using the OpenShift Console. For MySQL, you can use either the public docker hub image centos/mysql-57-centos7, or the certified one from the Red Hat Registry registry.redhat.io/rhscl/mysql-57-rhel7. 
    To access images from the Red Hat Registry, you will need to create a Secret containing a valid Red Hat login. If you do not have an account, you can acquire one by registering for one of the following options:
  6. Red Hat Developer Program. This account gives you access to developer tools and programs.
    7. 30-day Trial Subscription. This account gives you a 30-day trial subscription with access to select Red Hat software products.
    Browse to Workloads > Secret, select Image Pull Secret from the Create dropdown and key in the Red Hat registry server and login information e.g.
    Image RemovedRegistry Server Address:
  7. .
    8. redhat.io
  8. Username: Red Hat login username
    9. Password: Red Hat login password

  9.  
  10. Browse to the project, go to Workloads and click on add other content.

    Image Modified

  11. Select Database.

    Image Modified
  12. Search for MySQL.

    Image Modified


  13. Select MySQL then click on Instantiate Template.

    Image Modified
  14. MYSQL_DATABASE: jwdb
  15. MYSQL_USER: joget
    16. MYSQL_PASSWORD: joget 
  16. Name: joget-mysql
    17. Environment Variables:

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

    Image Modified
     
    1. Database Service Name: jogetdb
    2. MySQL Connection Username: joget
    3. MySQL Connection Password: joget
    4. MySQL Database Name: jwdb

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

    Image Modified

2.2 Deploy Joget DX using the Joget DX Operator

  1. Browse to Operators > Installed Operators.

    Image Modified

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

    Image Modified

  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.

    Image Modified

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

    Image Modified

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

    Image Modified

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

    Image Modified

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.

    Image Modified

  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.

    Image Modified

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

    Image Modified

    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. 

    Image Modified