Provision MicroTx from Oracle Cloud Marketplace

2.1 Provision MicroTx from Oracle Cloud Marketplace

This topic explains the process to provision MicroTx from Oracle Cloud Marketplace.

Before you begin, complete all the prerequisites.

To provision MicroTx from Oracle Cloud Marketplace:

Sign in to Oracle Cloud Marketplace.
From the Oracle Cloud Marketplace home page, use the search box under Applications and search for the keywords MicroTx.
From the search results, select MicroTx Free Edition.
Click Launch Stack.
On the Launch Stack page, provide the following information:
1. Compartment: Select a compartment where you want to build the resources.
2. Version: Select the version of the stack.
3. Review the terms and conditions, and then select the I have reviewed and accept the Publisher terms and conditions check box.
4. Click Launch Stack to launch the stack in the OCI environment.
The Create Stack page is displayed. Optionally customize the Stack Information fields. All fields are completed with defaults.
Under MicroTx Configurations, provide the following information.
1. MicroTx Version: Select the MicroTx version to deploy.
2. Deployment Name: Enter a unique deployment name. The name must be less than 32 characters and can contain lowercase letters, numbers, and hyphens. All resources generated by the stack in OCI are prefixed with the specified name.
3. Domain Name: Enter the Domain name for the MicroTx HTTPS hostname. The final hostname is generated as <Deployment Name>.<Domain Name>. For example: microtx-demo.example.com.
Under Database Configuration, provide information based on whether you want the stack to provision a new Oracle Autonomous AI Database instance or if you want to connect to an existing database.
- To permit the stack to provision a new Oracle Autonomous AI Database instance:
  1. Select the Provision a new Oracle Autonomous AI Database on OCI check box.
  2. Select the type of Autonomous AI Database instance that you want the stack to provision. If you have logged in to OCI with an Oracle Cloud Free Tier account, you can only select Always Free Autonomous AI Database. If you have a paid account, you can select Autonomous AI Database for Developers or based on your resource requirements. An instance of Autonomous AI Database for Developers uses 4 ECPUs, while the Always Free and Paid options use 2 ECPUs.
  3. Database User: Enter the name of the database user that you want the stack to create. Optionally, use only _ as a special character in the user name.
    The stack creates the database user with privileges to access the MicroTx database schema. You cannot change the database username after it is created.
  4. Database Password: Enter the password for the specified database user.
- To use an existing instance of Oracle Database 19c or later:
  - Database User: Enter the name of the database user with privileges to access the MicroTx database schema.
    
    Note:
    Database User should not be an Admin.
  - Database Password: Enter the password for the specified database user.
  - Database JDBC URL: Enter the connection string to the database instance in the following format: jdbc:oracle:thin:@//<publicIP>:<portNumber>/<database unique name>.<host domain name>.
  - Database Wallet PAR URL: Enter the pre-authenticated request URL to access the database wallet that you have uploaded to Object Storage in OCI as a prerequisite.
  - Grant privileges to the database user to create and run stored procedures. See Grant Privileges to Database User
  - Upload the wallet ZIP file, if required, to Object Storage in OCI and create a read-only pre-authenticated request (PAR) URL. Note down the PAR URL as you will need to provide it later while creating the stack. See Creating an Object Storage Pre-Authenticated Request.
Under Workflow Server Secret, browse for the encryption.key file for MicroTx Workflows that you had created earlier.
(Optional) Under OCIR Configurations, provide the following information. The OCIR configurations are optional and available only for Enterprise Edition. Enter these fields only if available in the stack.
- OCIR Username: Enter the user name to sign in to Oracle Cloud Infrastructure Registry. See Logging in to Oracle Cloud Infrastructure Registry.
- OCIR Auth Token: The authentication token used to access OCIR. See Generating an Auth Token to Enable Login to Oracle Cloud Infrastructure Registry.
Under Kubernetes Cluster Configurations, provide the following information.
1. Node Pool Name: Name of the node pool for the worker nodes. Use lowercase letters, numbers, and single hyphens only.
2. Enable Cluster Autoscaler for Node Pool: Select this to enable node pools to autoscale based on resource usage. This setting permits addition and removal of worker nodes as needed.
3. Minimum Number of Worker Nodes: The minimum number of nodes in the node pool. If autoscaling has not been enabled, this is the total number of worker nodes available. The default value is 1.
4. Maximum Number of Worker Nodes: The maximum number of nodes in the node pool. This is only available if autoscaling has been enabled. The default value is 10.
5. Worker Nodes Instance Shape: Select an appropriate compute shape: VM.Standard.E3.Flex, VM.Standard.E4.Flex, or VM.Standard.E5.Flex.
6. Worker Node OCPU Count: The number of OCPUs for each worker node compute instance. The minimum is 6 OCPUs.
7. Worker Node Memory (GB): The amount of memory for each worker node compute instance. The minimum is 32 GB.
Click Next.

The Review page displays all the information that you have provided.
On the Review page, review the information you provided and click Create.

The Run Apply check box is selected by default. This runs the stack and sets up MicroTx.

The Job Details page in Oracle Resource Manager is displayed. An Apply job is started to provision the stack.
Periodically monitor the progress of the Apply job until it is finished.
After you apply the Terraform stack, Resource Manager performs the following tasks:
1. Creates the OCI networking resources.
2. Creates the OKE cluster.
3. Creates the worker node pool.
4. Creates File Storage resources.
5. Creates the optional Autonomous AI Database.
6. Uploads deployment files to the temporary jump host.
7. Downloads the Oracle MicroTx software.
8. Pushes Oracle MicroTx container images to OCIR.
9. Installs Istio.
10. Deploys Oracle MicroTx by using Helm.
11. Waits for the Kubernetes pods to become ready.
12. Returns deployment outputs.
The deployment can take several minutes, especially while OKE node pools, load balancers, Autonomous AI Database instance, and container images are being created.
Note:
Editing parameters of terraform after deployment is not supported in this stack. Changing database mode after deployment is not supported; create a new stack or destroy/recreate this stack.

If the job fails, click the job name to view logs.

Parent topic: Deploy Stack