Starting the Oracle Tuxedo Administration Console

The following sections provide the system requirements for the Oracle Tuxedo Administration Console and explain how to start and exit the Console.

•	What is the Oracle Tuxedo Administration Console?

•	Administration Console File Tree

•	Server Requirements

•	Browser Requirements

•	Hardware Requirements

•	Setting Up Your Environment for the Oracle Tuxedo Administration Console

•	Starting the Oracle Tuxedo Administration Console

•	Exiting the Oracle Tuxedo Administration Console

What is the Oracle Tuxedo Administration Console?

The Oracle Tuxedo Administration Console is a graphical user interface that enables administrators to perform most administration and configuration tasks for Oracle Tuxedo applications. It is implemented as a set of Java applets, which can run on most platforms that support a Java-capable Web browser.

The server-side components of the Oracle Tuxedo Administration Console reside on one of the server machines in a Oracle Tuxedo application. To use the Console, you must enter the URL of the server and download the Java applets.

Administration Console File Tree

During the Oracle Tuxedo software installation, the installer program places most of the directories and files for the Oracle Tuxedo Administration Console in the webgui directory, as shown in Figure 7‑1.

Figure 7‑1 Oracle Tuxedo Administration Console File Tree

 

 

The installer program installs the following HTML files:

•	An HTML template file named webgui.html, which is used by the common gateway interface (CGI) program tuxadm as the basis for many screens displayed during a Oracle Tuxedo Administration Console session.

•	An HTML file named webguitop.html, which displays legal notices and warnings when the Oracle Tuxedo Administration Console is first brought up on the screen.

•	The HTML documentation files for the Oracle Tuxedo Administration Console, which are installed in a top-level directory named help.

The installer program installs the class files for the Java applet in the java directory, and installs the tuxadm program in the cgi-bin directory. The installer assigns an alias pathname for tuxadm, which is used by Web clients to access tuxadm. The alias pathname is \cgi-bin on a Windows 2003 Server system and /cgi-bin on a UNIX system.

Server Requirements

The Oracle Tuxedo Administration Console server for Oracle Tuxedo 12c Release 1 (12.1.1) is supported on the following platforms:

•	HP-UX 11i v2 (64-bit) on Itanium

•	HP-UX 11i v2 (64-bit) on PA-RISC

•	IBM AIX 5.3 (32-bit) on IBM PowerPC

•	IBM AIX 5.3 (64-bit) on IBM PowerPC

•	IBM AIX 6.1 (32-bit) on IBM PowerPC

•	IBM AIX 6.1 (64-bit) on IBM PowerPC

•	Microsoft Windows 2003 Server (32-bit) on x86 with MS Visual Studio 2005

•	Microsoft Windows XP on x86 (Client Only)

•	Novell SUSE Linux Enterprise Server 10 (64-bit) on x86-64

•	Oracle Enterprise Linux 5.0 (64-bit)

•	Oracle Solaris 10 (32-bit) on SPARC

•	Oracle Solaris 10 (64-bit) on x86-64

•	Oracle Solaris 10 (64-bit) on SPARC

Browser Requirements

The encryption level for the Oracle Tuxedo Administration Console is set with the ENCRYPTBITS parameter in the webgui.ini file for the Console. In the following webgui.ini file, the encryption level is set to 56 bits.

# Web GUI initialization file.
# Created Sep 12, 2002 2:02:07 PM by Oracle software installation program.
#
TUXDIR=C:\oracle\tuxedo12cR1
INIFILE=C:\oracle\tuxedo12cR1\udataobj\webgui\webgui.ini
NADDR=//foo5:4003
DEVICE=/dev/tcp
CODEBASE=/java
DOCBASE=/doc
SNAPDIR=C:\oracle\tuxedo12cR1\udataobj\webgui\java\snapshot
SNAPBASE=/java/snapshot
ENCRYPTBITS=56

The ENCRYPTBITS parameter specifies the strength of encryption used in communication between the GUI applet and the Oracle Tuxedo Administration Console server. The ENCRYPTBITS parameter can be set to 0, 56, or 128. The default value is 128.

Table 7‑1 lists the platforms and browsers supported for Oracle Tuxedo 12c Release 1 (12.1.1) when the Oracle Tuxedo Administration Console is configured for 56-bit or 128-bit encryption.

 

Table 7‑1 Platforms and Browsers

On this platform . . .	Oracle tested these browsers . . .	Using Java plug-in . . .
HP-UX Version 11.23 (32-bit) on PA-RISC
IBM AIX 5.3 (32-bit) on IBM PowerPC
Microsoft Windows 2008 Server (32-bit) on x86	Internet Explorer 6.0	1.4.x
Microsoft Windows XP on x86	Internet Explorer 6.0	1.4.x
Oracle Solaris 10(32-bit) on SPARC

If the Oracle Tuxedo Administration Console is configured with no encryption (0-bit encryption), Internet Explorer 6.0 is supported on any Windows platform regardless of the Java plug-in version.

Hardware Requirements

To run the Oracle Tuxedo Administration Console, you need a color display device that meets the following requirements:

•	Resolution: 800 by 600 or more is required; 1024 by 768 or more is recommended.

•	Colors: A minimum of 256 colors is recommended.

Setting Up Your Environment for the Oracle Tuxedo Administration Console

To run the Oracle Tuxedo Administration Console, first set up your environment as described in “Setting Up Your Environment” on page 6‑9. Ensure that your TUXDIR, WEBJAVADIR, and PATH environment variables are set correctly. Then set up the following two server processes:

•	tuxwsvr(1)

A Web server provided with the Oracle Tuxedo system software. You are not required to use this server; you may, if you prefer, use your own commercial Web server.

•	wlisten(1)

A server required to administer the Oracle Tuxedo Administration Console. It must be run on the MASTER machine in a Tuxedo multi-machine configuration.

After starting the tuxwsvr and wlisten server processes, you can start the Oracle Tuxedo Administration Console to monitor the tuxwsvr server and the Oracle Tuxedo application.

Starting tuxwsvr

The tuxwsvr process is a Web server process that can be used to support the Oracle Tuxedo Administration Console GUI by customers who do not have a commercial Web server or a public-domain Web server on the machine on which the Oracle Tuxedo Web GUI processes are running. The tuxwsvr process places itself in the background when invoked unless otherwise specified, and continues running until the machine shuts down or the tuxwsvr process is killed using an operating system command.

Table 7‑2 lists the commands for starting tuxwsvr.

 

Table 7‑2 Starting tuxsvr

To Start Tuxwsvr on This Platform . . .	Enter the Following Command . . .
Windows 2003 Server system	tuxwsvr -l //machine:port -i %TUXDIR%\udataobj\tuxwsvr.ini
UNIX system	tuxwsvr -l //machine:port -i $TUXDIR/udataobj/tuxwsvr.ini

The Oracle Tuxedo installer program creates the tuxwsvr.ini file, an example of which is shown below:

# tuxwsvr initialization file.
# Created Sep 12, 2008 2:02:07 PM by Oracle software installation program.
#
CGI    /cgi-bin     C:\oracle\tuxedo12cR1/udataobj/webgui/cgi-bin
HTML   /java    C:\oracle\tuxedo12cR1/udataobj/webgui/java
HTML   /doc     C:\oracle\tuxedo12cR1/help
HTML   /        C:\oracle\tuxedo12cR1/udataobj/webgui

Usually, you do not need to edit this file, but under certain circumstances, you may want to do so. For example, you may decide to move your Java files to a non-default directory. In that case, you would need to edit the pathnames in the initialization file appropriately. For details, see reference page tuxwsvr(1) in Oracle Tuxedo Command Reference.

Starting wlisten

The wlisten process is a listener process that receives incoming connections from Web GUI applets and starts a Web GUI gateway process (wgated). All wlisten options are taken from an initialization file that is specified by the -i option. If the -i option is not given, then %TUXDIR%\udataobj\webgui\webgui.ini is used as the default initialization file on a Windows 2003 Server system, and $TUXDIR/udataobj/webgui/webgui.ini is used as the default initialization file on a UNIX system.

To start wlisten, follow these steps:

1.	Check the webgui.ini file to make sure that the default values assigned to the parameters during installation are appropriate. If they are not, make the necessary changes.

For example, on a machine called foo5, the default port assigned to wlisten is 4003. To run wlisten with port 6060, edit the NADDR parameter as follows:

NADDR=//foo5:6060

For details about other parameters in the webgui.ini file, see reference page wlisten(1) in Oracle Tuxedo Command Reference.

2.	Enter the following command:

wlisten

Starting the Oracle Tuxedo Administration Console

The tuxadm process is a CGI process used to initialize the Web GUI from a browser. As shown in the “Synopsis” section of reference page tuxadm(1), this program can be used only as a location, or URL from a Web browser; normally it is not executed from a standard command-line prompt. Like other CGI programs, tuxadm uses the QUERY_STRING environment variable to parse its argument list.

To start the Oracle Tuxedo Administration Console, complete the following four-step procedure:

1.	Start the browser.

2.	Enter the following URL:

http://machine:port/webguitop.html

For example: http://foo5:4003/webguitop.html

Use of this URL depends on the following assumption: You are using tuxwsvr with the tuxwsvr.ini file. If you are using a commercial browser on the default port (8080), you can use a URL such as http://ctomsn:8080/webguitop.html.

The Oracle Tuxedo Administration Console entry page displays.

3.	To start the Oracle Tuxedo Administration Console, select the Click Here to Run the Oracle Tuxedo Administration Console prompt at the bottom of the screen. The Login window displays.

4.	Enter your login name and password in the appropriate fields, and select LOGIN. The password must correspond to one of the entries in the system-encrypted tlisten.pw file.

The main window of the Oracle Tuxedo Administration Console displays.

Table 7‑3 contains instructions for accessing additional information about the Oracle Tuxedo Administration Console main window.

 

Table 7‑3 Accessing Information About the Oracle Tuxedo Administration Console Main Window

If. . .	Then. . .
The main window is displayed and you want to start working with the GUI	See “Administration Console Tutorial” in Oracle Tuxedo Administration Console Online Help.
The main window is displayed and you want to read a description of it	See “A Tour of the Main Window” in Oracle Tuxedo Administration Console Online Help.
The main window is not displayed and the Connect Failed error message is displayed	1. On the Administration Console server machine, verify that the wlisten process is running. On a UNIX machine, for example, enter the ps command. 2. If wlisten is not running, open the webgui.ini file and, in the line NADDR=//foo5:4003, replace the port number (4003) with a valid port number. 3. Enter wlisten again: • $ wlisten -i %TUXDIR%\udataobj\webgui\webgui.ini (on Windows 2003 Server ) • $ wlisten -i $TUXDIR/udataobj/webgui/webgui.ini (on UNIX) 4. Check that the tuxwsvr process is running at the port specified in the URL. 5. Verify the password. It must match one of the entries in the tlisten.pw file. 6. Return to step 1.

Limitation(s)

The Oracle Tuxedo Administration Console has not been updated to support any new features introduced after Oracle Tuxedo release 7.1.

Exiting the Oracle Tuxedo Administration Console

To exit the Oracle Tuxedo Administration Console, choose Domain →  Exit from the menu bar. This menu option closes the current domain and exits the Oracle Tuxedo Administration Console applet.