2.1 Provision MicroTx from Oracle Cloud Marketplace

Before you begin, complete all the prerequisites.
To provision MicroTx from Oracle Cloud Marketplace:
  1. Sign in to Oracle Cloud Marketplace.
  2. From the Oracle Cloud Marketplace home page, use the search box under Applications and search for the keywords MicroTx.
  3. From the search results, select MicroTx Free Edition.
  4. Click Launch Stack.
  5. 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.
  6. 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.
  7. 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 Oracle ATP database 26ai instance 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 connect to 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.
      • 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.
  8. Under Workflow Server Secret, browse for the encryption.key file for MicroTx Workflows that you had created earlier.
  9. Under OCIR Configurations, provide the following information.
  10. 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.
  11. Click Next.

    The Review page displays all the information that you have provided.

  12. 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.

  13. 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.

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

Parent topic: Deploy Stack