Domain Editor

Domain editor is used for creating an Oracle Tuxedo domain. To enter the Domain editor page, click Add->Create Tuxedo Domain on the Tuxedo Summary page. Enter a domain name, and then click OK. The domain editor initial page appears.

Note:

The domain name must be global unique within current EM and consist of 0 to 256 characters

Editor Header

The editor header on top of domain editor displays the following information:

Name of the domain being created.
Domain target status: Shown by icons, indicating three status of Status Pending, Up, and Metrics Collection Error. The target status is refreshed every five minutes automatically.
Domain deployment status: Same as the status shown on Oracle Tuxedo Summary page.

A refresh button is shown in the top right corner. Clicking on the button refreshes the domain status as well as machine/package list.

Controls Panel

The Controls panel showed at the top includes the following control buttons:

Save: Saves the current domain configuration. You can load the saved domain by clicking Edit on the Tuxedo Summary page.

When saving the domain, the corresponding UBBCONFIG file is generated according to the parameters defined in each section and verified thoroughly. Once the domain is saved, it is ready to be deployed.

Save&Deploy: Deploys the current domain directly on the domain editor page. Save is performed automatically for each deployment.

There are two kinds of deployment, full (static) deployment and dynamic deployment. The deploy type depends on the domain status.

Policy Management: Enters the Policy Management console, where you can define and manage policies centrally.

Policies define the conditions that trigger a dynamic deployment/undeployment of application packages and machines and automatic server spawn/decay.

Security Management: Enters the Security Management page. If you enable the Tuxedo SECURITY while assembling a Tuxedo application, you need to configure certain authentication and authorization related information in the Security Management page.

DMConfig: Lets you configure each DMCONFIG file section parameters.

JESConfig: Lets you configure the Tuxedo system servers that are specific to ART Batch in the Tuxedo domain.

CICSConfig: Lets you configure the Tuxedo system servers that are specific to ART CICS in the Tuxedo domain.

Packages: Brings up the Manage Application Package dialog, which is the same as the one on the Tuxedo Summary page.

Procedures: Enters the Procedure Activity page in a new tab/window.

Save&Close: Saves current domain configuration and returns to the Tuxedo Summary page.

Cancel: Cancels current domain configuration and returns to the Tuxedo Summary page.

Machine List Panel

The Machine List panel in the upper right lists all the machines managed by EM that are available for deploying Tuxedo domains. Machines that can be used for Tuxedo domain deployment should meet the following two prerequisites:

The host is monitored by EM. That is, there is one EM agent deployed on that host, and the corresponding Agent and Host targets are shown on the All Targets page. The Tuxedo domain can only be deployed to a host with EM agent running locally.

tlisten and Tuxedo Home targets have been discovered and monitored by the agent on that host.

Once a machine is added into current domain by clicking '+' button of one machine entry, machine information appears as a tooltip when placing the mouse cursor over the machine entry.

Package List Panel

The package list panel in the lower right lists all the Tuxedo application packages that have been uploaded. In addition, placing the mouse cursor over the package name displays detailed package information.

UBB Section Panels

On the left side of the screen are the UBB section panels. Each UBBCONFIG file section corresponds to a panelbox. Only valid parameters for each section can be edited in this area (that is, only parameters belonging to the master machine version can be defined).

Initially, when you create an Oracle Tuxedo domain, the Domain UBBCONFIG Editor provides a limited set of parameters in the *RESOURCES section, which does not vary among different Tuxedo versions. The More … in the section *RESOURCES and Add … in other sections are disabled. Such parameters will not be displayed until the master machine is added to the domain. Once the master machine is added to the domain, according to the master machine Tuxedo version, all invalid parameters for each section are filtered out and invisible from the editor.

On first entering the domain editor, the indicator EXT_MON of OPTIONS parameter is set by default for metrics collection purpose.

Creating an Oracle Tuxedo Domain

To create a Tuxedo domain, do the following:

Refer to Domain Editor to enter the domain editor page.
Fill out the *RESOURCES section.

Click More... for more options.
From the Machine List panel, add a machine to domain by clicking + beside the machine name.

A popup dialog is displayed to collect the machine related information.

If it is the first time the machine is being added, the Application Home option must be specified. The Application Home is the root directory where all the domains are deployed.

The Environment Path Variable can also be specified when adding the machine. It is a colon (Unix/Linux) or semi-colon (Windows) separated string that contains paths where the environment specific commands are located. For example, the compiler or Oracle DB client that could be used by user programs.
Click OK.

Another popup dialog which contains all UBB MACHINES section parameters appears.
Fill in any parameter specific to the Tuxedo machine. Click OK.