Table of Contents Previous Next PDF


Configuring Oracle Tuxedo ATMI for Windows Server

Configuring Oracle Tuxedo ATMI for Windows Server
The following sections describe how to configure Oracle Tuxedo ATMI on a Windows Server system:
Introducing the Oracle Administration Program
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 system. Only if the installation includes Oracle Tuxedo server components will these additional administration tools be installed on the Windows Server system.
You can use the Oracle Administration Program to perform the following tasks:
Invoking the Oracle Administration Program
With Oracle Tuxedo release 7.1 or later software installed on your Windows Server system, perform the following steps to access the Oracle Administration program:
1.
Choose Start Settings Control Panel to launch the Control Panel.
Figure 2‑1 Microsoft Windows Control Panel
2.
Figure 2‑2 Oracle Administration Window with Machines Page Displayed
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. 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.
2.
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 system.
Figure 2‑3 Oracle Administration Window with Environment Page Displayed
To add, modify, or delete environment variables using the Environment page, follow these steps.
1.
2.
3.
4.
Directing Oracle Tuxedo Messages to the Windows Server Event Log
The Logging page enables you to direct Oracle Tuxedo system messages to the Event Log on your Windows Server system, to the traditional user log (ULOG) disk file, or both.
Figure 2‑4 Oracle Administration Window with Logging Page Displayed
You may select the Event Log option, or the traditional user log (ULOG) Disk File option, or both.
Log Output: Windows Event Log
Setting Up to Log to Windows Event Log
No setup is required for the Event Log.
Viewing Windows Server Event Log Entries
To view Windows Server Event Log entries, follow these steps:
1.
From the Windows Server desktop, select Start Programs Administrative Tools Event Viewer to display a list of all the events that have occurred since the application booted.
Figure 2‑5 Event Viewer Window
2.
3.
4.
Figure 2‑6 Event Detail Window
This window provides the following information:
Source—section of System Messages in which the event is described and an appropriate action is recommended.
Log Output: User Log (ULOG) Disk File
Setting Up to Log to ULOG File
If you want to set up the traditional user log (ULOG) messages, perform the following steps to select a storage directory:
1.
2.
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.
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 system.
Figure 2‑7 Oracle Administration Window with Listener Page Displayed
During the Oracle Tuxedo installation, the installer program installed a tlisten service on your Windows Server 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.
Besides viewing and controlling tlisten services using the Listener page, you can click Start Programs Administrative Tools Services to launch the Services window and then view and control tlisten services via the Services window.
Configuring and Monitoring IPC Resources to Maximize System Performance
The IPC Resources page enables you to configure the interprocess communication (IPC) resources on your Windows Server system to maximize Oracle Tuxedo performance.
Figure 2‑8 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 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 “Checking IPC Requirements” in Installing the Oracle Tuxedo System. The following table maps the names of the IPC Resources on a Windows Server system to the traditional names on a UNIX system.
 
To modify IPC Resource values using the IPC Resources page, follow these steps:
1.
2.
3.
4.
5.
Stop and restart the Oracle ProcMGR service to put your changes into effect: click Start Programs Administrative Tools 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 must count any multicontexted Oracle Tuxedo ATMI server multiple times. Your total should match the number of contexts calculated by adding 1 to the value of MAXDISPATCHTHREADS in the target application’s configuration (UBBCONFIG) file, where 1 represents the main dispatcher thread.
You can view the performance of a running Oracle Tuxedo application on the Windows Server Performance Monitor. Choose Start Programs Administration Tools Performance Monitor to launch the Performance Monitor window.
Figure 2‑9 Performance Monitor
Reviewing the Windows Server Registry Content
The Windows Server Registry is the repository for all hardware, software, and application configuration settings for the Windows Server 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\ORACLE\TUXEDO\<version>\...
To view this structure, choose Start Run to launch the Run dialog box, enter Regedit, 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 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:
Any user who runs tlisten(1) must have read access permissions.
Oracle recommends that the Administrator have full control permissions.

Copyright © 1994, 2017, Oracle and/or its affiliates. All rights reserved.