Skip navigation.

Administration Console Online Help

  Previous Next vertical dots separating previous/next from contents/index/pdf Contents Index View as PDF   Get Adobe Reader

Administration Tasks

The BEA Tuxedo Administration Console simplifies the task of managing your BEA Tuxedo application resources. The BEA Tuxedo Administration Console enables you to quickly and easily perform the administrative tasks associated with managing mission-critical applications. With the BEA 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 BEA Tuxedo Administration Console provides a browser-based solution for remote system administration.

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

This topic includes the following sections:

 


Setting Up Your BEA Tuxedo Administration Console

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

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.
  2. Figure 3-1 Settings Window

    Settings Window


     

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

Field

Description

Documentation URL

Specifies the location of your BEA 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 BEA 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 BEA 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.


 
  1. 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 BEA Tuxedo Administration Console to the following default work modes:

By default, your BEA 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.
  2. As shown in Figure 3-2, the Select Folders window is displayed.

    Figure 3-2 Select Folders Dialog Box

    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.

  1. 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).
  2. After selecting the classes you want to display, click OK to close the window.
  3. 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 BEA 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-1.

This section provides general instructions on how to create a new object via the BEA 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-1.

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.
  3. Figure 3-3 Quick Menu on a Device

    Quick Menu on a Device


     

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

    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

    Create New Object Window for a Device


     

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

    Create New Object Window for the CORBA Interfaces Class Object


     
  4. 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-1.)
  5. 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-1 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-1 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.
  2. 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

    Selecting an Administrative Object


     
  3. If you are in View mode, switch to Edit mode. (By default, the BEA 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.)
  4. 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.

  5. 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.)
  6. 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-2 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-2 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:

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.
  2. The Connect window is displayed as shown in Figure 3-8.

    Figure 3-8 Connect Window

    Connect Window


     
  3. Fill in the fields as explained in Table 3-3.
  4. Table 3-3 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.


     
  5. Click OK to connect to the requested domain.
  6. 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 BEA 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.

 


Activating Your Domain and Domain Resources

As the system administrator, you are the only user who is authorized to activate the BEA 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 BEA Tuxedo domain. Specifically, you can activate:

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.)
  2. The BEA 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

    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.

  3. To start the activate process for the domain, click Activate.
  4. The BEA 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.)
  2. The BEA 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.


     
  3. 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:
  4. As shown in Figure 3-10, all Activate class objects tab pages include the following list boxes:

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

    Figure 3-10 Activate Objects Window

    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-4.)

    Table 3-4 Using Arrow Buttons to Modify Lists

    Selection

    Action

    Logfile Tool with All Options Displayed

    Right arrow button

    Moves the highlighted item to the list:

    DO NOT ACTIVATE THESE

    Logfile Tool with All Options Displayed

    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.

  5. To start the activate process for the objects on a particular tab, click Activate.
  6. 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 BEA 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 BEA 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:

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:

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

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.

 


Deactivating Your Domain

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

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.)
  2. The BEA 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

    Deactivate Domain Tab Page


     

    The Domain tab page contains the following options:

    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).

  3. To start the deactivate process for the domain, click Deactivate.
  4. The BEA 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.)
  2. The BEA 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.


     
  3. 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:
  4. As shown in Figure 3-13, all Deactivate class objects tab pages include the following list boxes:

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

    Figure 3-13 Deactivate Objects Window

    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-4.)

    The Machine tab page also contains options to:

  5. To start the deactivate process for the objects on a particular tab, click Deactivate.
  6. 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 BEA 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 BEA 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:

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:

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:

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

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 BEA 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 BEA 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:

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 BEA 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:

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 BEA 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:

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 BEA Tuxedo system application and processes and remove all of the BEA 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).
  3. 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.

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).
  3. The Advertise Service window is displayed as shown in Figure 3-15.

    Figure 3-15 Advertise Service Window

    Advertise Service Window


     
  4. Enter the name of the service to be advertised in the Service Name field.
  5. 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.
  6. Click OK to close the dialog box and advertise the service.
  7. 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).
  3. 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).
  3. 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.

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 BEA 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).
  3. If suspension is successful, the BEA 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 BEA Tuxedo Administration Console displays an error message.

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

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).
  3. The BEA 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 BEA 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).
  3. 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 BEA Tuxedo Administration Console process will refuse to kill itself; one BEA 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 using the Client Quick Menu.

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 BEA 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:

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).
  3. 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).
  3. 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 BEA Tuxedo application. The recommended method to kill a workstation handler is as follows:

  1. Suspend the desired workstation handlers.
  2. In the tree, select a suspended workstation handler.
  3. Select Quick Menu—>Kill (right-click).
  4. 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 BEA 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).
  3. 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).
  3. 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).
  3. 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).
  3. 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 BEA Tuxedo Administration Console, you can perform the following tasks:

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.
  3. 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.

  4. Click OK to close the window and create the bridge.
  5. The BEA 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).
  3. The BEA 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).
  3. The BEA 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).
  3. The BEA Tuxedo Administration Console displays a message indicating whether the bridge was deactivated successfully.

 


Security Administration

You can manage application security with the BEA Tuxedo Administration Console ACL objects. The BEA 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.

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.
  2. The Create New Object window is displayed.

  3. Enter values for the fields:
  4. Click Create to close the window and create the new ACL group.
  5. (Or click Cancel to close the window without creating a new group.)

 


Managing Tuxedo CORBA Resources

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

Suspending and Resuming Interfaces

During run time, you can perform the following actions on a CORBA interface:

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 BEA 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 BEA 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).
  3. The BEA 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 on a CORBA interface queue:

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).
  3. If the suspend is successful, the BEA 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 BEA 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 BEA Tuxedo Administration Console displays the Result of Requested Change dialog box, indicating whether the reactivation is successful.

Viewing Attributes for Factories

The BEA Tuxedo Administration Console only allows you to view BEA 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 BEA Tuxedo Administration Console to monitor and track system events. The following sections describe how to use the BEA Tuxedo Administration Console for:

Viewing System Statistics

You can use the BEA 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 BEA 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:

The following table lists the 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 BEA 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 BEA 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.

Statistics Tool window


 

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.

Viewing System Events

If the system event broker server (TMSYSEVT) is configured, you can use the BEA 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.
  2. Figure 3-17 Sample Initial Event Tool Window

    Sample Initial Event Tool Window


     

The menu bar across the top of this window offers four options as shown in the following table.

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.


 
  1. 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.
  2. Figure 3-18 Event Tool Format Options Window

    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.

Viewing a ULOG File

Using the BEA 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

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.
  2. The Logfile Format window is displayed, as shown in Figure 3-20.

    Figure 3-20 Logfile Format OptionsWindow

    Logfile Format OptionsWindow


     
  3. Click the check boxes to enable or disable the format options. (A check mark indicates the option is selected.)
  4. 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.

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

Logfile Tool with All Options Displayed


 

 

Skip navigation bar  Back to Top Previous Next