2 About the runme.sh Script

Use the runme.sh script file to install Transaction Manager for Microservices (MicroTx) in runtime platform, and then quickly run sample applications.

Caution:

Run this script only in test or development environments. Do not use this script in production environments.

• Considerations
  Consider the points discussed in this section before you use the runme.sh script file to run sample applications in your test environment.

2.1 Considerations

Consider the points discussed in this section before you use the runme.sh script file to run sample applications in your test environment.

Required Environment Details

The runme.sh script file is a bash script, so you can run it in environments that support Bash shell.

To run the script and sample applications, ensure that at least 6114 MB of memory is available on your local machine.

Supported Languages

Use the runme.sh script file to run sample applications coded in the following languages:

• TypeScript or JavaScript for Node.js
• Java

Supported Platforms

Use the runme.sh script file to run sample applications in the following development environments:

• Docker
• Minikube
• Oracle Cloud Infrastructure Container Engine for Kubernetes (OKE)

Supported Resource Manager

Before you run the XA sample application, set up an Oracle Database as resource manager for the transaction participant services. In XA transactions, MicroTx client libraries need to access the resource manager's client libraries.

Supported Identity Providers

You can use the following identity providers to create the authentication information.

• Oracle IDCS
• Oracle IAM
• Keycloak
• Microsoft Azure Active Directory and Active Directory

This guide provides information about creating an access token using Oracle IAM and Oracle IDCS. See Use Oracle Identity Providers.

If you want to use Keycloak or Microsoft AD as the identity provider, refer to their product documentation for information about setting up the identity provider and creating an access token.