Using Oracle Tuxedo ATMI on Windows

     Previous  Next    Open TOC in new window  Open Index in new window  View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Configuring Oracle Tuxedo ATMI for Windows Server 2003

The following sections describe how to configure Oracle Tuxedo ATMI on a Windows Server 2003 system:

 


Introducing the Oracle Administration Program

In addition to the Oracle Tuxedo Administration Console, the Oracle Tuxedo 7.1 or later software for Windows provides an Oracle Administration program and two Windows services (Tlisten and Oracle procMGR) for configuring the Oracle Tuxedo system on a Windows Server 2003 system. Only if the installation included Oracle Tuxedo server components will these additional administration tools be installed on the Windows Server 2003 system.

Note: The Oracle Tuxedo Administration Console offers extensive online help: instructions for all the administrative tasks that can be performed through the console, plus reference information for all configuration tool folders. For information about how to use the Oracle Tuxedo Administration Console, see Oracle Tuxedo Administration Console Online Help.

 


Invoking the Oracle Administration Program

With Oracle Tuxedo release 7.1 or later software installed on your Windows Server 2003 system, perform the following steps to access the Oracle Administration program:

  1. Choose Start Arrow symbol Settings Arrow symbol Control Panel to launch the Control Panel.
  2. Figure 2-1 Microsoft Windows Control Panel


    Microsoft Windows Control Panel

  3. In the Control Panel, double-click the Oracle Administration icon to launch the Oracle Administration window.
  4. Figure 2-2 Oracle Administration Window with Machines Page Displayed


    Oracle Administration Window with Machines Page Displayed

You can use the Oracle Administration window to perform the following tasks:

 


Accessing Other Machines on a Network

The Machines page of the Oracle Administration window enables you, as the Oracle Tuxedo system administrator, to access any machine (where you have login privileges) on the Microsoft Windows Network running Microsoft Windows Server 2003. You can then set environment variables remotely; determine the location of Oracle Tuxedo event logging; add, remove, stop, or start tlisten services; and tune IPC resources.

To access a remote machine, locate and click the machine’s icon on the network tree. If you know the name of a remote machine, but do not know its work group, perform the following steps to select it:

  1. In the lower right-hand corner of the Machines page, click Select to display the Enter Machine Name dialog box.

  2. Oracle Administration Window with Machines Page Displayed

  3. In the Enter Machine Name dialog box, enter the name of the remote machine (for example, \\intrepid) and click OK.

At this point, all subsequent actions performed on other pages (Environment, Logging, Listener, and IPC Resources) in the Oracle Administration window will take place on the selected machine (intrepid in this example).

 


Setting and Modifying Environment Variables

The Environment page enables you to view, set, or modify Oracle Tuxedo environment variables on your Windows Server 2003 system.

Figure 2-3 Oracle Administration Window with Environment Page Displayed

Oracle Administration Window with Environment Page Displayed

To add, modify, or delete environment variables using the Environment page, follow these steps.

  1. To add a variable, enter its name in the Variable field and its value in the Value field, and then click Set.
  2. To modify a variable, select the variable, enter its new value in the Value field, and then click Set.
  3. To delete a variable, select the variable you want to delete and then click Delete.
  4. Click OK or Apply to write your changes to the Windows Server 2003 Registry.

 


Directing Oracle Tuxedo Messages to the Windows Server 2003 Event Log

The Logging page enables you to direct Oracle Tuxedo system messages to the Event Log on your Windows Server 2003 system, to the traditional user log (ULOG) disk file, or both.

Figure 2-4 Oracle Administration Window with Logging Page Displayed

Oracle Administration Window with Logging Page Displayed

You may select the Event Log option, the traditional user log (ULOG) Disk File option, or both. No setup is required for the Event Log.

Setting Up a ULOG

If you want to set up the traditional user log (ULOG) messages, perform the following steps to select a storage directory:

  1. On the Logging page, click the arrow to the right of the Directory field to display a drop-down list of directories.
  2. Select the name of the directory in which you want ULOG messages to be stored.
  3. In the Prefix field, type a prefix for the name of the log file. The default prefix is ULOG, and the default file name is ULOG.mmddyy, where mmddyy is the month, day and year that the log file was created.
  4. To save your selections to the Windows Server 2003 Registry, click OK or Apply.

Viewing Windows Server 2003 Event Log Entries

To view Windows Server 2003 Event Log entries, follow these steps:

  1. From the Windows Server 2003 desktop, select Start Arrow symbol Programs Arrow symbol Administrative Tools Arrow symbol Event Viewer to display a list of all the events that have occurred since the application booted.
  2. Figure 2-5 Event Viewer Window


    Event Viewer Window

  3. On the menu bar (across the top of the Event Viewer window), click Log to display a drop-down Log menu.
  4. From the drop-down Log menu, choose Application. As a result of this selection, only application-specific events are listed in the Event Viewer window.
  5. Double-click the entry for the event for which you want more information. The Windows Server 2003 Event Detail window appears, with information about the event you have specified.
  6. Figure 2-6 Event Detail Window


    Event Detail Window

This window provides the following information:

Viewing ULOG Entries

A ULOG is a text file. You can use any text editor to open a ULOG and view its contents.

 


Configuring tlisten Processes to Start Automatically

The Listener page enables you to view, create, or modify Tlisten services on your Windows Server 2003 system.

Figure 2-7 Oracle Administration Window with Listener Page Displayed

Oracle Administration Window with Listener Page Displayed

During the Oracle Tuxedo installation, the installer program installed a Tlisten service on your Windows Server 2003 system. Each time you boot your system, the Tlisten service starts a tlisten process on port 3050 of your machine. The password associated with the tlisten process is the one you entered during the installation.

A tlisten process must be started on each machine of a networked Oracle Tuxedo application before the Oracle Tuxedo system and application servers can boot. You use the tlisten process to perform administrative actions across multiple machines. To learn more about tlisten processes, see tlisten (1)in Oracle Tuxedo Command Reference.

To add, remove, stop, or start Tlisten services using the Listener page, follow these steps.

  1. To add a Tlisten service, enter a port number in the Port Number field and then click Add. (Generally, you need one tlisten process for each Oracle Tuxedo application running on your machine.)
  2. To remove a Tlisten service, select the Tlisten service you want to delete and then click Remove.
  3. To stop a Tlisten service that has been started, select the Tlisten service you want to stop and then click Stop.
  4. To start a Tlisten service that has been stopped, select the Tlisten service you want to start and then click Start.
  5. Click OK or Apply to write your changes to the Windows Server 2003 Registry.

Besides viewing and controlling Tlisten services using the Listener page, you can click Start Arrow symbol Programs Arrow symbol Administrative Tools Arrow symbol Services to launch the Services window and then view and control Tlisten services via the Services window.

 


Configuring IPC Resources to Maximize System Performance

The IPC Resources page enables you to configure the interprocess communication (IPC) resources on your Windows Server 2003 system to maximize Oracle Tuxedo performance.

Figure 2-8 Oracle Administration Window with IPC Resources Page Displayed

Oracle Administration Window with IPC Resources Page Displayed

During the Oracle Tuxedo installation, the installer program installed an Oracle ProcMGR service on your Windows Server 2003 system. Each time you boot your system, the Oracle ProcMGR service configures the IPC resources on your machine to whatever values you set on the IPC Resources page. The values shown in the preceding display are the default IPC values set by the installer program.

On most machines, Oracle ProcMGR runs as installed; however, you can use the IPC Resources page to tune the IPC resources and maximize performance. To determine the minimum IPC Resource values required for an Oracle Tuxedo application, see the following table and Checking IPC Requirements” in Installing the Oracle Tuxedo System. The following table maps the names of the IPC Resources on a Windows Server 2003 system to the traditional names on a UNIX system.

Table 2-1 IPC Resource Name Mappings Between Windows and UNIX Systems
Windows Server 2003 Name
Traditional UNIX Name
Maximum Allowed Message Size
MSGMAX
Maximum Number of Message Headers
No matching name
Maximum Message Queue Size
MSGMNB
Maximum Number of Message Queues
MSGMNI
Size of Message Segment
MSGSSZ
Number of Message Segments
MSGSEG
Maximum Number of Processes Using IPC
NPROC
Maximum Number of Semaphores
SEMMNS
Maximum Number of Semaphore Sets
SEMMNI
Maximum Number of Semaphore Undo Structures
SEMMNU
Maximum Number of Processes Per Shared Segment
No matching name
Number of Shared Memory Segments
SHMMNI

To modify IPC Resource values using the IPC Resources page, follow these steps:

  1. In the “Current Resource: Default box,” click the Use Default IPC Settings check box to clear it. An insert box appears in the Current Resource: Default box.
  2. Click the insert box, enter the name of your Windows Server 2003 machine, and press Enter.
  3. Click the fields next to the IPC resources you want to change and enter the desired values.
  4. Click OK or Apply to write your changes to the Windows Server 2003 Registry.
  5. Stop and restart the Oracle ProcMGR service to put your changes into effect: click Start Arrow symbol Programs Arrow symbol Administrative Tools Arrow symbol Services to launch the Services window and then stop and restart the Oracle ProcMGR via the Services window.

When interpreting the Maximum Number of Processes Using IPC parameter on the IPC Resources page, keep the following information in mind:

You can view the performance of a running Oracle Tuxedo application on the Windows Server 2003 Performance Monitor. Choose Start Arrow symbol Programs Arrow symbol Administration Tools Arrow symbol Performance Monitor to launch the Performance Monitor window.

Figure 2-9 Performance Monitor

Performance Monitor

 


Reviewing the Windows Server 2003 Registry Content

The Windows Server 2003 Registry is the repository for all hardware, software, and application configuration settings for the Windows Server 2003 system. During the Oracle Tuxedo installation, the installer program writes general installation information as well as IPC Resource values to the Registry. The structure of the Registry relevant to Oracle Tuxedo is as follows.

HKEY_LOCAL_MACHINE\Software\BEA Systems\Tuxedo\9.1\...

To view this structure, choose Start Arrow symbol Run to launch the Run dialog box, enter regEdt32, and click OK to launch the Registry Editor window.

Developer Key

The Developer key stores product information, including the major and minor version numbers of the release, and user and company names.

Environment Key

The Environment key stores the locations referenced by the Oracle Tuxedo environment variables set on your Windows Server 2003 system. It also stores other values such as IPC resource settings.

Security Key

The Security key holds the access permissions for Oracle Tuxedo processes and services. The following permissions are mandatory:

Oracle recommends that the Administrator have full control permissions.


  Back to Top       Previous  Next