2 Create an Instance
Topics:
Learn how to create an Oracle Tuxedo for OCI compute instance using Oracle Tuxedo for OCI images.
2.1 Use an Image
/u01/oraHome
: Tuxedo software is installed in this directory. It also includes other utilities such as Oracle JDK 1.8 andOPatch.
/u01/app/oraInventory
: Tuxedo inventory information is stored in this directory. Data files, installation logs, and Oracle home information are stored in it.
- 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>
- 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
, andJAVA_HOME
from thetux.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
- Run the following command to load the Tuxedo environment variable:
- 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
epifregedt
command to modify the registry. - Use the following 3 commands after initialization to modify the TLS LDAP information:
epifregedt -s -k SYSTEM/impl/security/BEA/key_management -a Params=privateKeyDir=file:///$TUXDIR/udataobj/security/keys
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
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 commandepifregedt -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.
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
See Also:
Refer to Common Policies in the Oracle Cloud Infrastructure documentation, Managing Policies.Parent topic: Create an Instance
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.
- 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:
- 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
- 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>
) - Review the terms and conditions and select the Oracle Terms of Use check box and click Select Image.
- 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:
- 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.
- 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>
)
- Oracle Linux 8.6 (labeled as
- 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