Create an Instance

2.1 Use an Image

Utilizing the Oracle Tuxedo for OCI images, you can create Oracle Tuxedo domain nodes in the Oracle Cloud Infrastructure compute instances, with the entitlement to use Tuxedo software. The Oracle Tuxedo for OCI images contain the following two directories:

/u01/oraHome: Tuxedo software is installed in this directory. It also includes other utilities such as Oracle JDK 1.8 and OPatch.
/u01/app/oraInventory: Tuxedo inventory information is stored in this directory. Data files, installation logs, and Oracle home information are stored in it.

Follow these instructions to use the Oracle Tuxedo for OCI images:

When you create an instance using an image, you must specify an SSH key. You require this SSH key to access the instance and launch it.
You can connect to an instance using the SSH command as the opc user.
SSH Private key: The private key associated with the public key is used during provisioning. For example, $ssh -I <private_key> opc@< ip_address>
The user public key was provided during provisioning. Log in directly with the following command: $ssh opc@< ip_address>

See Also:
Connecting to a Linux Instance in Oracle Cloud Infrastructure documentation
When you have logged in as the OPC user, switch to the Oracle user by using the following command: $sudo su oracle
Use the source command to load Tuxedo environment variables such as TUXDIR, and JAVA_HOME from the tux.env file, which is required to run Tuxedo.
- Run the following command to load the Tuxedo environment variable:
```
source /u01/oraHome/tuxedo22.1.0.0.0/tux.env
```
By default, tlisten is not configured. Oracle TSAM plus and MP/clustered mode configuration require tlisten. Follow the instructions to set the tlisten password:
- cd /u01/oraHome/tuxedo22.1.0.0.0/
- . ./tux.env
- tlistpwd $TUXDIR
Tuxedo supports TLS by default. It is optional to use LDAP. When using Oracle Wallet, LDAP is not required. A user is required to configure LDAP only if any of the following conditions are met.
- The use of legacy security credentials
- The local host must use a port other than 389 for LDAP
- There is no LDAP server running on localhost
LDAP configuration: Use the epifregedtcommand to modify the registry.
Use the following 3 commands after initialization to modify the TLS LDAP information:
1. epifregedt -s -k SYSTEM/impl/security/BEA/key_management -a Params=privateKeyDir=file:///$TUXDIR/udataobj/security/keys
2. epifregedt -s -k SYSTEM/impl/security/BEA/certificate_validation -a Params=caCertificateFile=file:///$TUXDIR/udataobj/security/certs/trust_ca.cer -a Params=peerValidationRuleFile=file:///$TUXDIR/udataobj/security/certs/peer_val.rul
3. epifregedt -s -k SYSTEM/impl/security/BEA/certificate_lookup -a Params=userCertificateLdap=ldap://*LDAP_SERVICE_NAME*:*LDAP_PORTID* -a Params=ldapBaseObject=*LDAP_BASE_OBJECT* -a Params=filterFileLocation=file:///*LDAP_FILTER_FILE_LOCATION*
On Unix, the Tuxedo registry is located at $TUXDIR/udataobj/System.rdp. Using the command epifregedt -g, you can print the current registry. The first command modifies the key management object to specify a particular private key directory.
Please run the following command and instructions to reset the administrator password for Oracle® Tuxedo Application Rehosting Test Manager.
- $ORA_HOME/art_tm12.2.2.0.0/config.sh
Following links (if any) for creating a Tuxedo Domain: Using the Tuxedo Domains Component.

Parent topic: Create an Instance

2.2 Create Compartment Policies

You must be granted management access to Marketplace applications and Resource Manager if you are not an Oracle Cloud Infrastructure administrator. Oracle Tuxedo for OCI images allows you to create compute instances.

The following are sample policies:

Allow group
        MyGroup to use app-catalog-listing in compartment MyCompartmentAllow group
        MyGroup to manage instance-family in compartment MyCompartmentAllow group
        MyGroup to manage orm-family in compartment MyCompartmentAllow group
        MyGroup to manage virtual-network-family in compartment MyNetworkCompartment

2.3 Create an Instance Using the Compute Instance Console

The compute instance console enables you to create a new instance using Oracle Tuxedo for OCI images.

Follow the instructions to create an instance:

Sign in to the Oracle Cloud Infrastructure console.
Click Navigation from the menu, select Compute and under the Compute group, click Instances.
Click Create Instance.
If required, you can modify the name of the instance.
Select the compartment in which to create the instance.
Under Placement, select the Availability Domain for creating the instance. Click Show advanced options.
Under Image and Shape, click Change Image and follow the instructions:
1. From the Image source drop-down, select Marketplace, and you can either use Search or select one of the following Oracle Tuxedo for OCI images:
  - Oracle Tuxedo BYOL Image
  - Oracle Tuxedo Enterprise BYOL Image
  - Oracle Tuxedo UCM Image
  - Oracle Tuxedo Enterprise UCM Image
  - Oracle Tuxedo Mainframe Modernization Runtimes BYOL Image
  - Oracle Tuxedo Mainframe Modernization Runtimes UCM Image
2. For the selected image, click Arrow on the right, and then select the image build version for the BYOL or UCM images. For example, Oracle Linux 8.6 (labeled as <release>-ol8.6-<build>-<timestamp>)
3. Review the terms and conditions and select the Oracle Terms of Use check box and click Select Image.
Under Image and Shape, click Change Shape. Select the Instance Type and select the shape.
While creating a virtual machine, under Shape series, select a processor group, and then select a shape. To know the supported shapes, see Shapes for the images.
Configure the network for the instance. Click Show advanced options to specify advanced network settings.
Under Add SSH keys, generate a key, upload your public key, or paste the keys.
Under Boot Volume, specify the size and encryption options for the instance's boot volume.
Click Show advanced options to configure advanced settings.
Click Create.
For more details, see Creating a Linux instance in Oracle Cloud Infrastructure documentation.

Parent topic: Create an Instance

2.4 Create an Instance Using the Marketplace

By using the Oracle Tuxedo for OCI images available on the Marketplace, you can create a new instance.

Follow the instructions to create an instance using the Marketplace:

Sign in to the Oracle Cloud Infrastructure console.
Click the navigation menu, select Marketplace, and then click All Applications.
Select one of the following Oracle Tuxedo for OCI images (BYOL or UCM) :
- Oracle Tuxedo BYOL Image
- Oracle Tuxedo Enterprise BYOL Image
- Oracle Tuxedo UCM Image
- Oracle Tuxedo Enterprise UCM Image
- Oracle Tuxedo Mainframe Modernization Runtimes BYOL Image
- Oracle Tuxedo Mainframe Modernization Runtimes UCM Image
From the Version drop down, select the image build version.
Every image is built for a specific operating system, which may not support all operating systems.
- Oracle Linux 8.6 (labeled as <release>-ol8.6-<build>-<timestamp>)
Review the terms and conditions and select the Oracle Terms of Use check box.
Click Launch Instance.
Select the compartment in which you want to create the instance.
Under Placement, select the Availability Domain for creating an Instance.
Click Show advanced options to specify capacity type and fault domain.
Under Image and Shape, click Change Shape. Select the Instance Type and select the shape.
While creating a virtual machine, under Shape series, select a processor group, and then select a shape. To know the supported shapes, see Shapes for the images.
Configure the network for the instance and click Show advanced options to specify advanced network settings.
Under Add SSH keys, generate a key, upload your public key, or paste the keys.
Under Boot Volume, specify the size and encryption options for the instance's boot volume.
Click Show advanced options to configure advanced settings.
Click Create.
For more details, see Creating a Linux instance in Oracle Cloud Infrastructure documentation.

Parent topic: Create an Instance