Joget DX 8 Stable Released
The stable release for Joget DX 8 is now available, with a focus on UX and Governance.
In this case, requests to all subdomains of example.com (e.g. account1.example.com, account2.example.com, account3.example.com) are directed to Joget.For local testing purposes, it is possible to just modify the local hosts file http://en.wikipedia.org/wiki/Hosts_(file) . Please note that typically, hosts file configuration does not support wildcards so it will be necessary to add separate entries for each subdomain (e.g., account1.example.com, account2.example.com, etc.).
In the Community or Enterprise Edition, only 1 profile is selected at a time. In the Cloud Edition, this is enhanced such that all accounts and profiles are enabled concurrently.
Open the file (joget.home)/wflow/app_datasource.properties. Here's an example of the file content:
The key to the left of the equal sign is the domain name, while the value to the right is the profile.
Each profile has a corresponding file app_datasource-(profile).properties which contains the database settings.
When a request is received, any matching domain name will use the associated profile.
currentProfile is a special key to indicate the default profile to use if there are no matching domains.
In terms of file uploads and system generated files, each profile stores its files in the subdirectory (joget.home)/wflow/app_profiles/(profile).
Create a new Joget database using the script provided in (joget.home)/data/jwdb-cloud.sql, or any other custom scripts.
Create a new profile file (joget.home)/wflow/app_datasource-(profile).properties by copying from app_datasource-default.properties and changing the values accordingly.
Add an entry into (joget.home)/wflow/app_datasource.properties. The entry would be (domain name)=(profile).
The profile is active immediately, and no restart is necessary.
Execute the file (joget.home)/cloud-provision-account.sh.
When prompted for Account Profile Name, enter the required account name (e.g., demo).
The next prompt is for the Main Domain Name. Enter the main domain (e.g., example.com).
Subsequent inputs will have default values that you can just enter and accept, or change before submitting.
Upon submission of all the inputs, the script will create the database and perform the necessary configuration for the account. The inputs are as follows:
Account Profile Name
Desired account name (e.g., demo)
Main domain (e.g., example.com)
Account Domain Name
Account domain (e.g., demo.example.com)
Account Database Name
Database name for the account (e.g., jwc_demo)
Account Database User
Database user for the account (e.g., jwc_demo)
Account Database Password
Database password for the account (e.g., jwc_demo)
Joget home directory; defaults to current directory
Joget configuration directory; defaults to ./wflow
MySQL host name
Database server host name
Database admin user (with permission to create database)
Database admin password
Import the app in (joget.home)/lib/APP_cloud-xxxx.zip into Joget.
Go to Properties & Export and set the “domain” to the appropriate value for the main domain (e.g., example.com).
Publish the app.
Access the app at http://localhost:8080/jw/web/userview/cloud/admin/.
Login to view the Account List.
Select New Account from the drop-down menu to request for a new account.
When a request is submitted, it needs to be approved. Approve the request; a BeanShell tool will be executed to provision the account.
Verify that the account is created at the requested domain (e.g., demo.example.com).
Modify the app where necessary:
In a production environment, it is recommended for security purposes that this app be installed on a specific profile instead of the default profile.
Remove the profile entry from (joget.home)/wflow/app_datasource.properties. This effectively disables the account.
To fully delete the account:
Remove the profile entry from (joget.home)/wflow/app_datasource.properties.
Delete the profile properties file (joget.home)/wflow/app_datasource-(profile).properties.
Delete the associated account database.
Delete the associated account profile directory (joget.home)/wflow/app_profiles/(profile).
If the Cloud Admin App is used, delete the record from the db table app_fd_cloud_account.