Domain Editor

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

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: It is 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: The same as the status shown on Oracle Tuxedo Summary page.

A refresh button is shown on the top right corner of the page. 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 in the domain editor page. Save action is performed automatically for each deployment.

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

Policy Management: Enters the Policy Management console, from 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 section parameters of DMCONFIG.

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 same to 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 back to the Tuxedo Summary page.

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

Machine List Panel

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

The host is being monitored by EM. That is, there's one EM agent deployed on that host, and the corresponding Agent and Host targets have been shown in 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 the machine is added into current domain by clicking '+' button of one machine entry, machine information is showed as tooltip when pausing the mouse cursor over the machine entry.

Package List Panel

The package list panel showed in the lower right lists all the Tuxedo application packages that have been uploaded. Also, pausing the mouse cursor over the package name shows up the detailed information of the package.

UBB Section Panels

On the left side, which takes the most space of the screen, are the UBB section panels. Each section of UBBCONFIG is corresponding to a panelbox. Only the valid parameters of each section can be edited in this area, that is, only the parameters belonging to the master machine version can be defined.

At initial stage when you create an Oracle Tuxedo domain, the Domain UBBCONFIG Editor just 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 for this time. Such parameters will not be displayed until the master machine is added into the domain. Once the master machine is added into the domain, according to the master machine's Tuxedo version, all the invalid parameters of each section are filtered out and turned to invisible from the editor.

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

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.

Clicking on More... brings out 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 to which 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 looked for. For example, the compiler or Oracle DB client that could be used by user programs.
Click OK.

Another popup dialog which contains all the UBB parameters in MACHINES section is displayed.
Fill in any parameter specific to this Tuxedo machine, and click OK.