Administration Tasks

The Oracle Tuxedo Administration Console simplifies the task of managing your Oracle Tuxedo application resources. The Oracle Tuxedo Administration Console enables you to quickly and easily perform the administrative tasks associated with managing mission-critical applications. With the Oracle Tuxedo Administration Console, you can create domains and administrative class objects (such as machines and services), as well as manage Tuxedo CORBA interfaces, factories, and interface queues. The Oracle Tuxedo Administration Console provides a browser-based solution for remote system administration.

This topic describes the administration tasks you can perform using the Oracle Tuxedo Administration Console.

This topic includes the following sections:

•	Setting Up Your Oracle Tuxedo Administration Console

•	Creating Administrative Class Objects

•	Configuring Administrative Objects

•	Connecting to and Disconnecting from a Domain

•	Activating Your Domain and Domain Resources

•	Deactivating Your Domain

•	Migrating Tree Objects

•	Swapping the Master and Backup Machines

•	Cleaning a Machine

•	Advertising, Unadvertising, Suspending, and Resuming Services

•	Suspending, Resuming, and Killing Clients

•	Suspending, Resuming, and Killing Workstation Handlers

•	Opening and Closing Application Queue Spaces

•	Deleting Application Queue Messages

•	Aborting Transactions

•	Creating Bridges Between Machines

•	Security Administration

•	Managing Tuxedo CORBA Resources

•	Monitoring System Events

Setting Up Your Oracle Tuxedo Administration Console

The Oracle Tuxedo Administration Console allows you to customize your administrative environment and set default parameters. Setting up and customizing the Oracle Tuxedo Administration Console includes the following tasks:

•	Setting General Default Parameters

•	Switching Edit and View Modes

•	Controlling What the Tree Displays

Setting General Default Parameters

To set general default parameters for your administrative session:

1.	Select Settings—>Defaults from the menu bar (or click the Settings toolbar button). The Settings window is displayed as shown in Figure 3‑1.

Figure 3‑1 Settings Window

Table 3‑1 explains the options available on the Settings window.

Table 3‑1 Settings Window

 

Field	Description
Documentation URL	Specifies the location of your Oracle online documentation.
Sort Criteria	Indicates the criterion (name or state) by which administrative objects will be sorted. Here are two examples: • If you choose to sort the objects in your domain, all the machines with names that begin with the same string (such as main1, main2, and main3) are grouped together in the Oracle Tuxedo Administration Console display. • If you choose to sort the objects in your domain by state, all the active machines are grouped together and all the inactive machines grouped together in the Oracle Tuxedo Administration Console display.
Default Work Mode (View or Edit)	Indicates the default work mode (view-only or edit) for the current session as follows: • In View mode, you can look at information about your domain but you cannot change it. None of the attribute fields are editable. • In Edit mode, you can create and configure domains. Where appropriate, the attribute fields are editable. Note: You can override this default setting for individual tree objects. For more information, see the section Switching Edit and View Modes.

2.	When you have specified the settings you want, click OK to apply your changes and close the window.

Switching Edit and View Modes

You can set the Oracle Tuxedo Administration Console to the following default work modes:

•	View mode—you can only view atttributes set in the Configuration tab pages; you cannot change the attributes.

•	Edit mode—you can change the attributes in the Configuration tab fields.

By default, your Oracle Tuxedo Administration Console is set to Edit mode so that you can create or modify parameters by editing the appropriate fields in the configuration tab pages. (To change the default mode for the session, select Settings—>Defaults from the menu bar and follow the steps in Setting General Default Parameters.)

You can momentarily override the default setting for individual tree items. Most likely you will use this feature to override a default View mode to edit an attribute on an object. If you return to the same object later in the session, it reverts to the default mode (in this case, View only) unless you override the default again.

To change the mode for a specific object in the Tree View:

1.	Select an object in the tree, and click the right mouse button to display the Quick Menu.

2.	Select either the View or Edit from the Quick Menu. This momentarily overrides the default mode setting for the selected tree object only. All of the other tree objects retain the default setting.

Controlling What the Tree Displays

You can customize the configuration Tree View so that only the administrative classes (tree objects) you want to see are displayed. To control what class folders are displayed in the tree, follow these steps:

1.	Right-click a domain or administrative class object in the tree, and then select Quick Menu —>Folders.

As shown in Figure 3‑2, the Select Folders window is displayed.

Figure 3‑2 Select Folders Dialog Box

Note:

The items listed in the Folders window will vary, depending on which type of tree object you select. Figure 3‑2 shows the Select Folders window displayed for the domain class object.

2.	To select a class object for display, click it to enter a check mark. (Clicking again removes a check mark.) The Tree View will display only the selected classes (those with check marks).

3.	After selecting the classes you want to display, click OK to close the window.

4.	Click the plus sign in front of the domain name to expand the tree and display the selected class folders.

Creating Administrative Class Objects

To create new domains and individual administrative class objects, you use the Create New Object window to define identifying attributes for the object such as name, location, and so on. The Oracle Tuxedo Administration Console provides a class-specific Create New Object window for each class to which you can add an object. The fields on the Create New Object window vary, depending on the administrative class.

You cannot create new objects for all of the classes displayed in the Tree View. (For example, you cannot create new Client class objects.) For a complete list of the administrative resources you can create, see Table 3‑2.

This section provides general instructions on how to create a new object via the Oracle Tuxedo Administration Console, using domains as an example. For detailed information on how to fill in attribute fields for a specific type of object, refer to the help topics listed in Table 3‑2.

Adding New Administrative Objects

To create any new administrative object, use the following general procedure:

1.	Right-click a folder in the tree that contains the type of object you want to create. (Alternatively, you can also select another object of the same type as that you want to create.)

2.	On the Quick Menu, click New.

Figure 3‑3 Quick Menu on a Device

Figure 3‑4 Quick Menu on a CORBA Interfaces Class Object

The Create New Object window is displayed as shown in Figure 3‑5, prompting you for the identifying attributes needed to establish a new device object, or as shown in Figure 3‑6, prompting you to establish a CORBA interface class object.

Figure 3‑5 Create New Object Window for a Device

Figure 3‑6 Create New Object Window for the CORBA Interfaces Class Object

3.	Fill in the fields as needed, and click Create. (For detailed information on how to fill in the fields for a specific type of object, refer to the help topics listed in Table 3‑2.)

The new object appears in the tree contained under the folder you selected originally. (Or, at the same level as whatever non-folder object you selected originally.) The new object automatically includes empty folders of the appropriate subclasses in which you can create new member objects if needed.

Table 3‑2 lists topics that give detailed information on how to fill in the fields on the Create New Object window for a specific type of object.

 

Table 3‑2 Creating New Class Objects

Class Resource	Help Topic
Domains	Creating a New Domain
Machines	Creating Machines
Application Queues	Creating Application Queues
Application Queue Spaces	Creating Application Queue Spaces
Groups	Creating Groups
Servers	Creating Servers
Services	Creating Services
Routing Tables	Creating Routing Tables
Service Defaults	Creating Service Defaults
CORBA Interfaces	Creating a New Interface
Devices	Creating Devices
WS Listeners	Creating Workstation Listeners
ACL Groups	Creating ACL Groups
ACL Principals	Creating ACL Principals
ACLs	Creating ACLs

Configuring Administrative Objects

To configure a domain and its administrative objects shown in the Tree View, you use the Configuration Tool tab pages displayed on the right side of the main window. The tab pages (also called tab folders) show the current attribute settings for the administrative object selected in the tree.

Depending on the type of administrative object you select, anywhere from one to eight tab pages is displayed—each page containing a set of attributes related to a particular administrative area for that object such as Networking, Security, Transactions, and so on. Many of the attribute fields on the tab pages are editable, so you can specify or change attributes as needed.

To configure an administrative object:

1.	Select an administrative object in the Tree View.

The Configuration Tool tab pages for that administrative object are displayed on the right side of the main window, as shown in Figure 3‑7.

Figure 3‑7 Selecting an Administrative Object

2.	If you are in View mode, switch to Edit mode. (By default, the Oracle Tuxedo Administration Console is set to Edit mode so that you can create or modify parameters by editing the appropriate fields in the configuration tab pages.)

Note:

For more information about setting your default configuration mode or switching from one mode to another, see the section Switching Edit and View Modes.

3.

Select the various tab pages you want to work in by clicking on the topic-labeled tabs. Enter the appropriate information in the attribute fields. (To change an attribute, simply highlight its current value and enter a new one. If an attribute field is empty, enter a value for that attribute or press the Enter key on your keyboard to accept the default.)

Note:

Defaults are only available for some fields. The defaults are listed in the help topic for the specific field. If you use the default, you need to click the Refresh button to display the default value.

Not all the fields on the tabbed folders can be edited; some information that cannot be changed, such as statistics for the current operation of the domain.

Table 3‑3 lists topics that give detailed information on how to fill in attribute fields on the Configuration Tool tab pages for a specific type of object.

 

Table 3‑3 Configuring Administrative Resources

Class Resource	Help Topic
Domains	Configuring Domain Resources (T_DOMAIN Class)
Machines	Configuring Machines (T_MACHINE Class)
Application Queues	Configuring Application Queues (T_APPQ Class)
Application Queue Spaces	Configuring Application Queue Spaces (T_APPQSPACE Class)
Application Queue Messages	Configuring Application Queue Messages (T_APPQMSG Class)
Application Queue Transactions	Configuring Application Queue Transactions (T_APPQTRANS Class)
Groups	Configuring Groups (T_GROUP Class)
Servers	Configuring Servers (T_SERVER Class)
Services	Configuring Services (T_SVCGRP Class)
Routing Tables	Configuring Routing Tables (T_ROUTING Class)
Service Defaults	Configuring Service Defaults (T_SERVICE Class)
CORBA Interfaces	CORBA Interfaces (T_INTERFACE)
CORBA Interface Queues	CORBA Interface Queues (T_IFQUEUE)
Factories	CORBA Factories (T_FACTORY)
Devices	Configuring Devices (T_DEVICE Class)
Clients	Configuring Clients (T_CLIENT Class)
WS Listeners	Configuring Workstation Listeners (T_WSL Class)
WS Handlers	Configuring Workstation Handlers (T_WSH Class)
Bridges	Configuring Bridges (T_BRIDGE Class)
ACL Groups	Configuring ACL Groups (T_ACLGROUP Class)
ACL Principals	Configuring ACL Principals (T_ACLPRINCIPAL Class)
ACLs	Configuring ACLs (T_ACLPERM Class)

Connecting to and Disconnecting from a Domain

There are a number of operations that you can perform only when you are connected to a domain. These include:

•	Activating machines and other objects

•	Modifying the Oracle Tuxedo configuration

•	Creating and using the Event Monitor

How to Connect to a Domain

You have two options for connecting to an existing domain.

To connect to a domain listed on the menu bar Domain list, select Domain—>Domain Name.

To open a domain not on the list:

1.	Select Domain —>Open from the menu bar.

The Connect window is displayed as shown in Figure 3‑8.

Figure 3‑8 Connect Window

2.	Fill in the fields as explained in Table 3‑4.

 

Table 3‑4 Connecting to a Domain

Field	Description
Domain Name	The name of the domain you want to open.
TUXCONFIG File	The full path and filename of the TUXCONFIG file.

3.	Click OK to connect to the requested domain.

If the connection is successful, the Tree View displays the domain icon and name, and the Configuration Tool tab pages display information about the domain.

How to Disconnect from a Domain

The Oracle Tuxedo Administration Console automatically disconnects you from a domain whenever necessary (for example, when you select another domain name from the pull-down menu of Domains).

To disconnect from the domain to which you are currently connected, exit the GUI by selecting Domain—>Exit Application from the menu bar.

<A name="A_0"></a>

<a name="A_4"></a>

<a name="A_2"></a>

<a name="A_3"></a>

<a name="A_5"></a>

<a name="A_6"></a>

<a name="A_7"></a>

<a name="A_8"></a>

<a name="A_9"></a>

Activating Your Domain and Domain Resources

As the system administrator, you are the only user who is authorized to activate the Oracle Tuxedo domain and domain resources. You must perform the initial activation process on the Master machine on which the application configuration file is located.

You can activate all or part of a Oracle Tuxedo domain. Specifically, you can activate:

•	An entire domain

•	Only administrative servers in a domain or on a machine

•	Only specific machines, groups, servers, or workstation listeners

How to Activate a Domain

To activate a domain:

1.	Select Tools—>Activate from the menu bar. (Alternatively, you can click the Activate toolbar button or right-click the domain in the tree and select Quick Menu—>Activate.)

The Oracle Tuxedo Administration Console displays the Activate Objects window. Click the Domain tab to display the Domain information as shown in Figure 3‑9.

Figure 3‑9 Activate Domain Tab Page

The Domain tab page contains a single option that indicates whether you want to activate only administrative servers for the domain, or the entire domain.

•	To select only administrative servers, click the check box (a check mark indicates the option is selected). (For more information on this option, refer to Activating Only Administrative Servers.)

•	To select the entire domain, leave the check box unselected (no check mark).

2.	To start the activate process for the domain, click Activate.

The Oracle Tuxedo Administration Console displays the Progress of Activate window. For more information about this window, see How to Monitor the Progress of Activate.

How to Activate Class Objects

To activate domain and class objects:

1.	Select Tools —>Activate from the menu bar. (Alternatively, you can click the Activate toolbar button or right-click an object in the tree and select Quick Menu—>Activate.)

The Oracle Tuxedo Administration Console displays the Activate Objects window containing a set of class-specific tab pages (see Figure 3‑10). Click a tab to display the page for the type of object you want to activate.

The Activate Objects window contains six tab pages as shown in the following table.

 

Select the Tab	To Choose an Activation Policy for...
Domain	The entire domain. (Refer to How to Activate a Domain.)
Machine	A selected list of machines.
Group	A selected list of groups.
Server	A selected list of servers.
WSL	A selected list of workstation listeners.
WSH	For future use.

2.	Click a tab to select the type of object that you want to activate, and then edit the tab page as explained in the following:

As shown in Figure 3‑10, all Activate class objects tab pages include the following list boxes:

•	ACTIVATE THESE. The Oracle Tuxedo Administration Console objects in this list will be activated.

•	DO NOT ACTIVATE THESE. The Oracle Tuxedo Administration Console objects in this list will not be activated.

All objects shown indicate their current state next to the object name.

Figure 3‑10 Activate Objects Window

Move the object(s) you want to activate into the ACTIVATE THESE list and all other objects into the DO NOT ACTIVATE THESE list. (To move an object from one list (or column) to another, highlight the object name and click one of the arrow buttons between the two columns as shown in Table 3‑5.)

 

Table 3‑5 Using Arrow Buttons to Modify Lists

Selection		Action
	Right arrow button	Moves the highlighted item to the list: DO NOT ACTIVATE THESE
	Left arrow button	Moves the highlighted item to the list: ACTIVATE THESE

The Machines tab page also contains an option to Only Activate Administrative Servers. For more information about this option, see Activating Only Administrative Servers.

3.	To start the activate process for the objects on a particular tab, click Activate.

Note:

When you click Activate, you are activating only the selected objects on the current tab, not on all tabs. To activate several types of objects (such as machines, groups, servers, and so on) you need to step through this procedure for each type of object—opening the Activate window, clicking on a particular tab, making your selections, and clicking Activate.

The Oracle Tuxedo Administration Console displays the Progress of Activate window. For more information about this window, see How to Monitor the Progress of Activate.

Activating Only Administrative Servers

The Bulletin Board Liaison Processes (BBLs) and the Distinguished Bulletin Board Liaison Process (DBBL) are Oracle Tuxedo administrative servers. Generally, these servers are activated first. If a BBL fails to activate, the other servers on that machine will not be activated. If the DBBL fails to activate, the entire application's activation process fails.

You can choose whether to limit your activation to BBLs and the DBBL for the entire domain or for selected machines as follows:

•	On the Domain tab, choosing (with a check mark) the Only Activate Administrative Servers option means that only BBLs and the DBBL will be activated for the entire domain.

•	On the Machines tab, choosing (with a check mark) the Only Activate Administrative Servers option means that only BBLs and the DBBL will be activated on the selected machines (those in the ACTIVATE THESE list).

How to Monitor the Progress of Activate

As objects are activated, the Progress of Activate window is displayed (as shown in Figure 3‑11). The Progress of Activate window tracks the status of the activation process as it occurs. You can:

•	View the progress of the activation process

•	Stop the activation process

If you do not want to view the Progress of Activate window during the activation process, click Dismiss to close the window. The activation process continues in the background.

Figure 3‑11 Progress of Activate Window

Note:

Alternatively, if you decide you do not want to activate the chosen objects, you can click Terminate to end the activation process at any time. However, because terminating the operation in mid-process could yield unexpected results, it is recommended that you allow the process to conclude and then deactivate the undesired objects.

Note: <a name="D_0"></a>

Note: <a name="D_2"></a>

Note: <a name="D_3"></a>

Note: <a name="D_4"></a>

Note: <a name="D_5"></a>

Note: <a name="D_6"></a>

Note: <a name="D_7"></a>

Note: <a name="D_8"></a>

Note: <a name="D_9"></a

Deactivating Your Domain

The Oracle Tuxedo Administration Console enables you to deactivate all or parts of a Oracle Tuxedo domain. Specifically, you can deactivate:

•	An entire domain

•	Only administrative servers in a domain or on a machine

•	Only specific machines, groups, servers, or workstation listeners

Note:

You can also deactivate bridges. For more information about deactivating bridges, see Creating Bridges Between Machines.

How to Deactivate a Domain

To deactivate a domain:

1.	Select Tools —>Deactivate from the menu bar. (Alternatively, you can click the Deactivate toolbar button or right-click an object in the tree and select Quick Menu—>Deactivate.)

The Oracle Tuxedo Administration Console displays the Deactivate Objects window. Click the Domain tab to display the Domain information as shown in Figure 3‑12.

Figure 3‑12 Deactivate Domain Tab Page

The Domain tab page contains the following options:

•	Only Deactivate Administration Servers. (For more information, refer to Deactivating Only Application Servers.)

•	Force deactivate even if clients remain. (For more information, refer to Forcing Deactivation.)

To select either of these options, click the check boxes. (A check mark indicates the associated action will be performed as a part of the deactivation).

2.	To start the deactivate process for the domain, click Deactivate.

The Oracle Tuxedo Administration Console displays the Progress of Deactivate window. For more information about this window, see How to Monitor the Progress of Deactivate.

How to Deactivate Class Objects

To deactivate class objects:

1.	Select Tools —>Deactivate from the menu bar. (Alternatively, you can click the Deactivate toolbar button or right-click an object in the tree and select Quick Menu—>Deactivate.)

The Oracle Tuxedo Administration Console displays the Deactivate Objects window containing a set of class-specific tab pages (see Figure 3‑13). Click a tab to display the page for the type of object you want to deactivate.

The Deactivate Objects window contains six tab pages as shown in the following table.

 

Select the Tab	To Choose a Deactivation Policy for...
Domain	The entire domain. (Refer to How to Deactivate a Domain.)
Machine	A selected list of machines.
Group	A selected list of groups.
Server	A selected list of servers.
WSL	A selected list of workstation listeners.
WSH	For future use.

2.	Click a tab to select the type of object you want to deactivate, and then edit the tab page as explained in the following paragraphs:

As shown in Figure 3‑13, all Deactivate class objects tab pages include the following list boxes:

•	DEACTIVATE THESE. The Oracle Tuxedo Administration Console objects in this list will be deactivated.

•	DO NOT DEACTIVATE THESE. The Oracle Tuxedo Administration Console objects in this list will not be deactivated.

All objects shown indicate their current state next to the object name.

Figure 3‑13 Deactivate Objects Window

Move the object(s) you want to deactivate into the DEACTIVATE THESE list and all other objects into the DO NOT DEACTIVATE THESE list. (To move an object from one list (or column) to another, highlight the object name and click one of the arrow buttons between the two columns as shown in Table 3‑5.)

The Machine tab page also contains options to:

•	Only Deactivate Administrative Servers (For more information, refer to Deactivating Only Application Servers.)

•	Force deactivate even if clients remain. (For more information, refer to Forcing Deactivation.)

3.	To start the deactivate process for the objects on a particular tab, click Deactivate.

Note:

When you click Deactivate, you are deactivating only the selected objects on the current tab, not on all tabs. To deactivate several types of objects (such as machines, groups, servers, and so on) you need to step through this procedure for each type of object—opening the Deactivate window, clicking on a particular tab, making your selections, and clicking Deactivate.

The Oracle Tuxedo Administration Console displays the Progress of Deactivate window. For more information about this window, see How to Monitor the Progress of Deactivate.

Deactivating Only Application Servers

Application servers are user-defined or Oracle Tuxedo defined servers configured by the user in the UBBCONFIG file. You can deactivate only application servers for the entire domain or for selected machines as follows:

•	On the Domain tab, choosing (with a check mark) the Only Deactivate Application Servers option means that all application servers in the domain will be deactivated and only BBLs and the DBBL will remain active.

•

On the Machine tab, choosing (with a check mark) the Only Deactivate Application Servers option means that all application servers on the selected machines will be deactivated and only BBLs and the DBBL will remain active. (In this context, selected machines refers to those in the DEACTIVATE THESE list.)

See also Forcing Deactivation.

Forcing Deactivation

If you attempt to deactivate application servers for a domain or machine while there are clients still connected to the machine, the deactivation fails.

However, you can force deactivation even if clients remain connected as follows:

•	On the Domain tab, choosing "Force deactivate even if clients remain" causes deactivation of all application servers in the domain even if there are clients still connected to some of the machines in the domain.

•	On the Machine tab, choosing "Force deactivate even if clients remain" causes deactivation of all application servers on the selected machines even if there are clients still connected to some of these machines. (In this context, selected machines refers to those in the DEACTIVATE THESE list.)

How to Monitor the Progress of Deactivate

As objects are deactivated, the Progress of Deactivate window is displayed (as shown in Figure 3‑14). The Progress of Deactivate window tracks the status of the deactivation process as it occurs. You can:

•	View the progress of the deactivation process

•	Stop the deactivation process

If you do not want to view the Progress of Deactivate window during the deactivation process, click Dismiss to close the window. The deactivation process continues in the background.

Figure 3‑14 Progress of Deactivate Window

Note:

Alternatively, if you decide you do not want to deactivate the chosen objects, you can click Terminate to end the deactivation process at any time. However, because terminating the operation in mid-process could yield unexpected results, it is recommended that you allow the process to conclude and then activate the objects again.

Migrating Tree Objects

Using the Oracle Tuxedo Administration Console, you can migrate server groups and machines to alternate processors. This allows you to schedule maintenance for the original machine. You can also move groups of services from one machine to an alternate machine. By doing so you can schedule maintenance for the original machine.

Note:

A server group is the smallest unit that can be migrated to an alternate location.

Before Starting a Migrate Task

Before you can migrate server groups and machines, MIGRATE must be an option for the domain (see the Options field on the System Parameters folder for the domain) and a backup machine must be specified (see the Master, Backup Machine field on the General folder for the domain).

When you migrate a server group, the environment on the destination machine must duplicate the environment on the source machine, including all packages such as database software and any other application software necessary to run the application.

Displaying the Migrate Objects Window

You use the Migrate Objects window to select the object(s) you want to migrate. To display the Migrate Objects window, select Tools —>Migrate from the menu bar. (Alternatively, you can click the Migrate toolbar button or right-click a Groups object in the tree and select Quick Menu—>Migrate.)

The Oracle Tuxedo Administration Console displays the Migrate Objects window containing a set of class-specific tab pages. Click a tab to display the page for the type of object you want to migrate.

Migrating a Server Group from One Machine to Another

To migrate a server group from one machine to another:

1.	Display the Migrate Objects window and select the name of the server group you want to move, using the drop-down menu in the Migrate Group field.

2.	Enter the name of the machine on which that server group is currently located (source) in the From Machine field.

3.	Enter the name of the machine to which you want to migrate the server group (destination) in the To Machine field.

4.	Click Migrate. The Progress of Migrate window is displayed. For more information about this window, refer to Monitoring the Progress of Migrate.

Your next steps depend entirely on the applications you are running. To ensure an orderly migration, you might need to drain queues, shut down groups, migrate databases using tools provided by the database vendor, and so on.

Migrating All Servers from One Machine to Another Machine

To migrate all servers from one machine to another:

1.	Display the Migrate Objects window and enter the name of the machine from which you are migrating servers in the Migrate Servers From field.

2.	Enter the name of the machine to which you want to migrate the servers in the To Machine field.

3.	Click Migrate. The Progress of Migrate window is displayed.

Your next steps depend entirely on the applications you have running. You may need to drain queues, shut down groups, migrate databases using tools provided by the database vendor, and so on, to ensure an orderly migration.

Monitoring the Progress of Migrate

As objects are migrated, the Progress of Migrate window is displayed. The Progress of Migrate window tracks the status of the migration process as it occurs. You can:

•	View the progress of the migration process

•	Stop the migration process

If you do not want to view the Progress of Migrate window during the migration process, click Dismiss to close the window. The migration process continues in the background.

Note:

Alternatively, if you decide you do not want to migrate the chosen objects, you can click Terminate to end the migration process at any time. However, because terminating the operation in mid-process could yield unexpected results, consider allowing the process to conclude and then migrating the undesired objects back to the original machine.

Swapping the Master and Backup Machines

If you have identified one machine as a Master and a second machine as a Backup, you can choose to run the Oracle Tuxedo application from either machine. For example, you can swap the application from the Master to the Backup so that you can perform down-time maintenance on the Master machine. Or, if the Master processor loses the virtual circuit to other processors while the application is running, you can log in to the Backup machine. You can then bring up the DBBL on the backup node, and allow the application to continue running (although possibly in a degraded state).

Setting up Master and Backup Machines

To have the option to swap machines, you must have set the names of the machines that serve as the Master and Backup nodes of your system. You can set the Master and Backup machines, by either:

•	Specifying a Master and Backup machine name, when creating a new domain.

•	Changing the Master, Backup Machine field in the Configuration Tab for a Domain.

For more information about the Master, Backup Machine field, see the section Master Machine (TA_MASTER) in the section Configuring Domain Resources (T_DOMAIN Class) and Machine Role (TA_ROLE) in the section Configuring Machines (T_MACHINE Class).

To swap a Oracle Tuxedo domain from one machine to another:

1.	In the tree, select the domain.

2.	Right-click to select Quick Menu—>Swap Master. (To be able to do this, you must have already identified one machine as a Master and a second machine as a Backup.)

3.	The Administration Console displays a confirmation window, indicating whether the swap was successful.

Cleaning a Machine

You can clean machines by removing dead, partitioned machines from the booted machine list or by checking for dead clients and servers if the machine is not partitioned.

Select Clean to clean the bulletin board on the specified machine to restart or clean up any servers that may require it. If the machine in question is partitioned, entries for processes and services identified as running on that machine are removed from all non-partitioned bulletin boards.

Occasionally, you may find it necessary to clean your machine (e.g., when the network has gone down or when clients or servers have been killed). The clean operation has the following effects:

•	Checks the integrity of all accessers of the bulletin board residing on your machine, and the DBBL as well.

•	Removes dead servers and restarts them if they are marked as restartable.

•	Removes those resources no longer associated with any processes.

•	Causes the DBBL to check the status of each BBL. If any BBL does not respond within the specified time, it is marked as partitioned.

If the machine is partitioned, entries for processes and services identified as running on the machine are removed from all non-partitioned bulletin boards. If the machine is not partitioned, any processes or services that cannot be restarted or cleaned up are removed.

If you clean a partitioned machine but the machine is still running, you have to kill the Oracle Tuxedo system application and processes and remove all of the Oracle Tuxedo system application shared memory, semaphores, and message queues by hand. A reboot is often faster.

How to Clean a Machine

To clean a machine:

1.	Select a machine in the tree.

2.	Select Quick Menu—>Clean (right-click).

A message is displayed indicating whether the Clean operation is successful or not.

Advertising, Unadvertising, Suspending, and Resuming Services

You can perform the following service-related operations shown in Table 3‑6.

 

Table 3‑6 Service-related Operations

To...	You can...
Make a service available	Advertise the service
Make a currently advertised service unavailable	Unadvertise the service
Prevent the application from accessing a service	Suspend the service
Make a suspended service available to the application	Resume the service

Advertise a Service

To advertise a service (either from an existing service or from a service default object), complete the following steps:

1.	In the tree, select the server that contains the service you want to advertise.

2.	Select Quick Menu—>Advertise (right-click).

The Advertise Service window is displayed as shown in Figure 3‑15.

Figure 3‑15 Advertise Service Window

3.	Enter the name of the service to be advertised in the Service Name field.

4.

Optionally, enter the name of the program function that will handle the service request in the Function Name field. The function name must be one of the functions that is allowed to receive service requests (see buildserver(1) ). If you leave this field blank, the entry in the Service Name field is used as the Function Name.

5.	Click OK to close the dialog box and advertise the service.

A confirmation message is displayed indicating whether the Advertise operation was successful or not.

Unadvertise a Service

To make a currently advertised service unavailable:

1.	In the tree, select the server that contains the service you want to unadvertise.

2.	Select Quick Menu—>Unadvertise (right-click).

Suspend a Service

To suspend a service:

1.	In the tree, select the service you want to suspend.

2.	Select Quick Menu—>Suspend (right-click).

If the Suspend is successful, a Result of Requested Change menu is displayed.

If the service cannot be suspended, an error message is displayed specifying the reason.

Resume a Suspended Service

To reactivate a suspended service:

1.	In the tree, select the suspended service you want to resume.

2.	Select Quick Menu—>Resume (right-click).

A Result of Requested Change window is displayed, indicating whether the reactivation is successful.

Suspending, Resuming, and Killing Clients

You can perform the following client-related tasks using the client Quick Menu shown in Table 3‑7.

 

Table 3‑7 Client-related Tasks

To...	You can...
Prevent a client from accessing the application	Suspend the client
Allow a suspended client to access the application again	Resume the client
Remove a client from the Oracle Tuxedo application	Kill the client

Suspend a Client

If you want to isolate your client temporarily, you can suspend it.

To suspend a client:

1.	Select a client in the tree.

2.	Select Quick Menu—>Suspend (right-click).

If suspension is successful, the Oracle Tuxedo Administration Console displays a Result of Requested Change dialog box and the tree displays the suspended client icon.

If the client cannot be suspended, the Oracle Tuxedo Administration Console displays an error message.

When you suspend a client, the client is prevented from performing the following tasks:

•	Making service requests using Oracle Tuxedo tpcall(3) or tpacall(3)

•	Initiating conversations using Oracle Tuxedo tpconnect(3)

•	Beginning transactions using Oracle Tuxedo tpbegin(3)

•	Enqueuing requests using Oracle Tuxedo tpenqueue(3)

Clients within a transaction can make these calls until they abort or commit the current transaction, at which time they are suspended.

Resume a Suspended Client

To reactivate a suspended client:

1.	In the tree, select the suspended client you want to resume.

2.	Select Quick Menu—>Resume (right-click).

The Oracle Tuxedo Administration Console displays the Result of Requested Change window, indicating whether the reactivation is successful.

Kill a Client

A client can be killed, or abortively deactivated, to remove it from the Oracle Tuxedo application. The recommended method to kill a client is:

1.	Suspend the desired client(s). (For more information about suspending clients, see Suspend a Client.)

2.	In the tree, select the suspended client and select Quick Menu—>Kill (right-click).

If the abortive deactivation is successful, a Result of Requested Change window is displayed, and the client icon is displayed as dead (icon with an X). To remove any dead items from the tree view, you need to use the Quick Menu Clean option.

If the client cannot be killed, an error message is displayed specifying the reason. Although the Oracle Tuxedo Administration Console process will refuse to kill itself; one Oracle Tuxedo Administration Console process can be used to kill another.

The application may not be able to kill the client due to platform or signaling restrictions. In this case, a native client is abortively terminated at its next access to Application-to-Transaction Manager Interface (ATMI), and a Workstation client connection to a workstation handler (WSH) will be preemptively torn down. The connections to all clients attached to that WSH are terminated.

Suspending, Resuming, and Killing Workstation Handlers

You can perform the following workstation handler-related tasks shown in Table 3‑8 using the Client Quick Menu .

 

Table 3‑8 Workstation Handler-related Tasks

To...	You can...
Prevent clients from accessing a workstation handler	Suspend the workstation handler
Make a suspended workstation handler available to clients	Resume the workstation handler
Remove a workstation handler from the Oracle Tuxedo application	Kill the workstation handler

Suspending Workstation Handlers

If you want to isolate the clients connected to a particular workstation handler temporarily, you can suspend it. When you suspend a workstation handler, the clients connected to it are prevented from performing any of the following tasks:

•	Making service requests using tpcall(3) or tpacall(3)

•	Initiating conversations using tpconnect(3)

•	Beginning transactions using tpbegin(3)

•	Enqueuing requests using tpenqueue(3)

In addition, the suspended workstation handler will not accept any new client connections.

Note:

A workstation handler involved in a transaction when you suspend it is not actually suspended until the transaction is aborted or committed.

Suspend a Workstation Handler

To suspend a workstation handler:

1.	In the tree, select the workstation handler you want to suspend.

2.	Select Quick Menu—>Suspend (right-click).

If suspend is successful, a Result of Requested Change dialog box is displayed. The WorkStation Handler icon changes to indicate the suspended state.

If the workstation handler cannot be suspended, an error message is displayed specifying the reason.

Resume a Suspended Workstation Handler

To reactivate a suspended workstation handler:

1.	In the tree, select the workstation handler you want to resume.

2.	Select Quick Menu—>Resume (right-click).

A Result of Requested Change dialog box is displayed, indicating if the reactivation is successful.

Kill a Workstation Handler

A workstation handler can be killed, or abortively deactivated, to remove it from the Oracle Tuxedo application. The recommended method to kill a workstation handler is as follows:

1.	Suspend the desired workstation handlers.

1.	In the tree, select a suspended workstation handler.

2.	Select Quick Menu—>Kill (right-click).

If the abortive deactivation is successful, a Result of Requested Change dialog box is displayed and the object is displayed as dead (icon with an X) until you clean it out with the Quick Menu Clean option. The connections to all clients attached to that workstation handler are terminated.

If you cannot kill the workstation handler, an error message is displayed, specifying the reason. The application may not be able to kill the workstation handler due to platform or signaling restrictions. In this case, a Workstation client connection to a workstation handler will be preemptively torn down.

Opening and Closing Application Queue Spaces

You can use the Oracle Tuxedo Administration Console to allocate and initialize shared memory and to remove shared memory and other IPC resources (for example, message queues and semaphores). The options that perform these functions are Open and Close.

Open an Application Queue Space

To open an application queue space:

1.	In the tree, select the application queue space.

2.	Select Quick Menu—>Open (right-click).

A message is displayed indicating whether the application queue space opened successfully.

Close an Application Queue Space

To close an application queue space:

1.	In the tree, select the application queue space.

2.	Select Quick Menu—>Close (right-click).

A message is displayed to tell you whether the application queue space closed successfully.

Deleting Application Queue Messages

You can delete an application queue message from its queue space if you do not need to keep it any longer.

Delete Application Queue Messages

To delete the application queue message:

1.	In the tree, select the queue message you want to delete. (The message must be in the ACTIVE state to be deleted.)

2.	Select Quick Menu—>Delete (right-click).

A Result of Requested Change dialog box is displayed, indicating whether the application queue transaction was deleted successfully.

Aborting Transactions

If you must stop a transaction before it is complete, you can abort the transaction. Any data that changed as a result of that transaction is rolled back to its value at the start of the transaction. The transaction must be in either the ACTIVE, ABORTONLY, or COMCALLED state.

Caution:

There is a very slight risk that the data roll back may not be successful. You can minimize the risk by aborting a transaction early in the process.

To abort a transaction:

1.	In the tree, select the transaction.

2.	Select Quick Menu—>Abort (right-click).

The Result of Requested Change dialog box is displayed, indicating whether the transaction aborted successfully.

If you cannot abort the transaction, an error message is displayed specifying the reason.

Creating Bridges Between Machines

A bridge is a connection or link between two machines in a multi-processor domain. From the Oracle Tuxedo Administration Console, you can perform the following tasks:

•	Create a Bridge

•	Suspend a Bridge

•	Resume a Suspended Bridge

•	Deactivate a Bridge

Create a Bridge

To create a bridge between two machines, complete the following steps:

1.	Right-click a machine in the tree and select Quick Menu—>Connect to display the Connect window.

2.	In the Connect window, enter the logical machine identifier (LMID) of the machine to which you want to be connected.

The LMID is the first of two strings (separated by a /) that identify a machine in the tree. The second string is the physical machine ID, or PMID. For example, suppose the Machines class in your tree includes the following entry: SITE1/rcuw9. In this case, the LMID is SITE1 and the PMID is rcuw9.

3.	Click OK to close the window and create the bridge.

The Oracle Tuxedo Administration Console displays a message indicating whether the bridge was created successfully. If so, a bridge now connects the two sites.

Suspend a Bridge

To suspend a bridge:

1.	Select the bridge in the tree.

2.	Select Quick Menu—>Suspend (right-click).

The Oracle Tuxedo Administration Console displays a message indicating whether the bridge was suspended successfully.

Resume a Suspended Bridge

To resume a bridge:

1.	Select the suspended bridge in the tree.

2.	Select Quick Menu—>Resume (right-click).

The Oracle Tuxedo Administration Console displays a message indicating whether the bridge resumed successfully.

Deactivate a Bridge

To deactivate a bridge:

1.	Select an active bridge in the tree.

2.	Select Quick Menu—>Deactivate (right-click).

The Oracle Tuxedo Administration Console displays a message indicating whether the bridge was deactivated successfully.

Security Administration

You can manage application security with the Oracle Tuxedo Administration Console ACL objects. The Oracle Tuxedo Administration Console allows you to create new ACL groups, set configuration parameters for ACLs, and ACL Principals. Domain ACLs also allow you to control access to an entire domain.

<a name="N_ACLGROUP"></a>

Creating ACL Groups

To create new ACL Groups, display the Create New Object form and enter values for the fields:

1.	Right-click the ACL Groups folder in the tree, and then select Quick Menu —>New.

The Create New Object window is displayed.

2.	Enter values for the fields:

•	Group Name

•

Group ID

3.	Click Create to close the window and create the new ACL group.

(Or click Cancel to close the window without creating a new group.)

Managing Tuxedo CORBA Resources

Oracle Tuxedo system resources include CORBA interfaces, CORBA interface queues, and CORBA factories that are used in Oracle Tuxedo client and server applications. You can use the Oracle Tuxedo Administration Console to manage Oracle Tuxedo resources during run time as follows:

•	Suspending and Resuming Interfaces

•	Suspending and Resuming Interface Queues

•	Viewing Attributes for Factories

Suspending and Resuming Interfaces

During run time, you can perform the following actions shown in Table 3‑9 on a CORBA interface:

 

Table 3‑9 Suspending and Resuming Interfaces

To...	You can...
Prevent clients from accessing an interface on the application	Suspend the interface
Allow clients to access an interface on the application	Resume the interface

Suspending a CORBA Interface

If you want to isolate your interface temporarily, you can suspend it.

To suspend an interface:

1.	Select the interface object in the tree.

2.	Select Quick Menu—>Suspend (right-click).

If the suspend is successful, the Oracle Tuxedo Administration Console displays a Result of Requested Change dialog box and the tree represents the interface as suspended.

Note:

If the interface cannot be suspended, the Oracle Tuxedo Administration Console displays an error message.

Resuming a Suspended CORBA Interface

To reactivate a suspended interface:

1.	Select the suspended interface object in the tree.

2.	Select Quick Menu—>Resume (right-click).

The Oracle Tuxedo Administration Console displays the Result of Requested Change dialog box, indicating whether the reactivation was successful.

Suspending and Resuming Interface Queues

During run time, you can perform the following actions shown in Table 3‑10 on a CORBA interface queue:

 

Table 3‑10 Suspending and Resuming Interface Queues

To...	You can...
Prevent clients from accessing an interface queue on the application	Suspend the interface queue
Allow clients to access an interface queue on the application	Resume the interface queue

Suspending a CORBA Interface Queue

If you want to isolate your interface queue temporarily, you can suspend it.

To suspend a CORBA interface queue:

1.	Select the interface queue in the tree.

2.	Select Quick Menu—>Suspend (right-click).

If the suspend is successful, the Oracle Tuxedo Administration Console displays a Result of Requested Change dialog box and the tree represents the interface queue as suspended.

If the interface cannot be suspended, the Oracle Tuxedo Administration Console displays an error message.

Resuming a Suspended CORBA Interface Queue

To reactivate a suspended CORBA interface queue:

1.	Select the suspended interface queue in the tree.

2.	Select Quick Menu—>Resume (right-click).

The Oracle Tuxedo Administration Console displays the Result of Requested Change dialog box, indicating whether the reactivation is successful.

Viewing Attributes for Factories

The Oracle Tuxedo Administration Console only allows you to view Oracle Tuxedo CORBA factory information. You cannot make configuration changes to a factory and you cannot create new factories. You can use the Configuration Tool pane to view the interface name for a Factory, the Factory ID, and the object state.

Monitoring System Events

You can use the Oracle Tuxedo Administration Console to monitor and track system events. The following sections describe how to use the Oracle Tuxedo Administration Console for:

•	Viewing System Statistics

•	Viewing System Events

•	Viewing a ULOG File

Viewing System Statistics

You can use the Oracle Tuxedo Administration Console to view current statistics for administrative class objects using the Statistics Tool window.

Displaying the Statistics Tool Window

The Statistics Tool window provides statistics for domains, machines, servers, services, and clients. To display the Statistics Tool window, select Tools —>Stats from the menu bar or click the Stats toolbar button. The Oracle Tuxedo Administration Console displays the Statistics Tool window as shown in Figure 3‑16.

The Statistics Tool displays the domain tab pages by default. You can click a tab to view the statistics for any of the other listed administrative class objects. The domain tab displays statistics for the following administrative classes in a domain:

•

Machines

•

Groups

•

Servers

•

Services

•

Clients

Figure 3‑16 Statistics Tool window

Table 3‑11 lists the parts of the Statistics Tool window.

 

Table 3‑11 Parts of the Statistics Tool Window

Part	Description
Select button	Displays the Select Objects dialog box containing a list of all the objects for which statistics are available.
Hold button	Temporarily stops your statistics from being updated. The bar graph remains unchanged until you resume the update. The Hold button label is replaced by the word Resume.
Resume button	Resumes updating statistics. The bar graph starts displaying the changing statistics, as your statistics are updated. The button is re-labeled Hold.
Refresh field	Controls update rate for statistics. Intervals are specified in seconds.
Tab Pages	Displays the statistics for a specific administrative class: Domain, Machine, Server, Service, and Client.
Bar graph	Displays either a three-dimensional or two-dimensional bar graph of the statistics for an administrative object.
Color key	Lists the color and label for specific statistics displayed in the bar graph.

Changing the Refresh Rate

The Oracle Tuxedo Administration Console updates statistics at a regular interval. You can specify this interval in the Refresh field at the top of the Statistics Tool window. The interval value represents the number of seconds between Refresh operations. The default interval for refreshing the statistics is 60 seconds.

To suspend updating statistics, enter a zero in the Refresh field. To resume updating statistics, enter a number greater than zero. When you enter a zero in the Refresh field, the Hold button is re-labeled Resume; when you enter a value greater than zero, the Resume button toggles back to Hold.

Changing the Bar Graph View

You can display the statistics on any of the tab pages as either a two-dimensional or three-dimensional bar graph. To switch between these two types of graphs:

1.	Place the cursor in the bar graph image.

2.	Hold down the left mouse button and move the cursor around within the bar graph.

3.	Release the button to select the type of bar graph you prefer.

Displaying More Statistics

The Oracle Tuxedo Administration Console can display statistics for all of the available objects in a class. At the bottom of the Statistics Tool window, the status line displays the number of class objects for which statistics are currently being displayed and the total number of objects of this type for which statistics are available. Figure 3‑16 lists [Domain] Displaying: 5 Total: 5. This line indicates statistics are displayed for all five of five possible objects.

You can select other available administrative objects and display their statistics using the Select Objects dialog box. To display this dialog box, click Select in the Statistics Tool window (upper left). As shown the following example, the Select Objects dialog box lists the available administrative objects for which you can display statistics.

To select one or more items from the list, highlight the item. Click OK to show statistics for your selection and close the Select Objects dialog box. Click Apply to show statistics for your selection and keep the Select Objects dialog box open for further selections.

<a name="EVENT"></a>

Viewing System Events

If the system event broker server (TMSYSEVT) is configured, you can use the Oracle Tuxedo Administration Console to monitor system-generated events.

To view system events via the Event Tool:

1.	Select Tools—>Event from the menu bar or on the Event toolbar button.

Figure 3‑17 Sample Initial Event Tool Window

The menu bar across the top of this window offers four options as shown in Table 3‑12.

 

Table 3‑12 Options

Select This Button . . .	To . . .
Subscribe	Request notification of specified system events.
Unsubscribe	Reject further notification of specified system events.
Snapshot	Create a record of the data currently held by the Event Tool.
Select Format	Display the Format Options dialog box to select parameters for the information being collected by the Event Tool. See Figure 3‑18.
Dismiss button	Closes the Event Tool window.
Help button	Provides help on this window.

2.	To set the format for the Event Tool display, click Select Format to display the Event Tool Format Options window. Select (with a check mark) the options you want by clicking on the choice boxes, then click OK to close the window and apply your changes.

Figure 3‑18 Event Tool Format Options Window

3.	Once the format options are set as needed, use the Subscribe, Unsubscribe, and Snapshot options as desired.

4.	Click Dismiss to close the Event Tool window.

5. <a name="ULOG"></a>

Viewing a ULOG File

Using the Oracle Tuxedo Administration Console, you can view the ULOG file from a selected machine in the active domain. You use the Logfile Tool window to display a ULOG file.

Displaying the Logfile Tool Window

To display the Logfile Tool window, select Tools —>Logfile from the menu bar or click the Logfile toolbar button. The Logfile button displays the ULOG file from a particular machine in the active domain.

The Logfile Tool window is shown in Figure 3‑19. The Logfile Tool initially displays a blank viewing area, a drop-down list box and several buttons. The following table describes the Logfile Tool window components.

 

Part	Description
Drop-down menu	Contains a scrollable list of nodes for which you may view the log files.
Select Format button	Invokes the Select Format pop-up dialog box that allows you to specify the type of information you want from the log file and how you want it to be displayed.
Snapshot button	Captures a record from a particular log as it is being displayed.
Plus sign button	Invokes other Logfile function-related buttons.
Dismiss button	Closes the Logfile Tool.
Help button	Provides help on this window.

Selecting a Machine to View its ULOG File

To view a ULOG file for a specific object, select a machine from the drop-down menu in the top left corner of the window. (To display the menu, press and hold the left mouse button on the down arrow. To select a menu item, drag the cursor to highlight a menu item and release the the mouse button.) As shown in Figure 3‑19, the Logfile Tool displays the ULOG file for the selected machine.

Figure 3‑19 Sample ULOG File in Logfile Tool Window

Taking a Snapshot of the ULOG File

To save a record of the displayed ULOG file, click Snapshot on the Logfile Tool window.

Setting the Format for the ULOG file

To modify the format of the ULOG display:

1.	Click Select Format on the Logfile Tool window.

The Logfile Format window is displayed, as shown in Figure 3‑20.

Figure 3‑20 Logfile Format OptionsWindow

2.	Click the check boxes to enable or disable the format options. (A check mark indicates the option is selected.)

3.	Click OK to close the window and save your changes.

Customizing the Logfile Tool Options

As shown in Figure 3‑21, the Logfile Tool provides additional options. When you first invoke the Logfile Tool only a single row of buttons appears in the upper left corner of the Logfile Tool window. To display the additional Logfile Tool options, click the + sign button. The six fields that are then displayed allow you to select a ULOG file and specify which parts of it you want to see.

Table 3‑13 shows how to customize the logfile tool options.

 

Table 3‑13 Customizing the Logfile Tool Options

Use the . . .	To . . .
Message Type scrollable menu	Choose the types of messages (such as error messages and warnings) you want to view.
Date field	Specify the date of the ULOG file you want to view. By default, the ULOG file for the current day (on the server) is displayed.
Filter field	Request a subset of entries (within the set of lines you request through the Initial Download Records field) that match a string that you specify in this field.
Search field	Look for a particular record (in the portion of the ULOG file that you are viewing) by matching a string that appears in that record. Enter the string to be matched in this field.
Initial download records field	Specify the number of records you want to view when you download the ULOG file. (The default is 100.)
Maximum lines in view field	Specify the highest number of lines you want to have available for display in the window at a given time. (The default is 1000.)

Figure 3‑21 Logfile Tool with All Options Displayed