Administration Console Online Help
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
The BEA Administration Console supports high performance client-server applications. It is a powerful, intuitive solution that lets you configure and manage your company's BEA Tuxedo applications.
Based on Java and Web technology, the BEA Administration Console lets you operate your BEA Tuxedo domains from virtually anywhere—even from home, given security authorization.
This topic includes the following sections:
The BEA Administration Console is a Java-based applet that you can download into your Internet browser and use to remotely manage BEA Tuxedo system applications.
The BEA Administration Console simplifies many of the system administration tasks required for managing multiple-tier systems. It lets you monitor system events, manage system resources, create and configure administration objects, and view system statistics.
As system administrator, your tasks include planning, implementing, setting up, and maintaining the operation of an application built on the BEA Tuxedo system. Your application might be as simple as a single client and server operating entirely on one machine, or it might be more complex due to one of the following circumstances:
If you are new to the BEA Tuxedo systems, make sure you are familiar with the concepts discussed in the Introducing the BEA Tuxedo System, Setting Up a BEA Tuxedo Application, Administering a BEA Tuxedo Application at Run Time, and Using the BEA Tuxedo Domains Component, which are on the online documentation CD, before using the BEA Administration Console.
To work with the BEA Tuxedo system resources provided through the BEA Administration Console, you should become familiar with the BEA Tuxedo system online documentation. For additional reading recommendations, see the introductory chapter, About This Online Help.
This section lists the hardware, operating system resources, and browser you must provide to support the BEA Administration Console.
To run the BEA Administration Console, you need a color display device that meets the following requirements:
Given the broad outlines of an application design, you must verify the availability of operating system resources needed to support your application. Operating system resources include:
For additional information about IPC parameters and other system tunables, see Installing the BEA Tuxedo System.
Although any Java capable Web browser might be able to run the Administration Console, at this time BEA supports only the following browsers:
The BEA Administration Console is automatically installed when you install the BEA Tuxedo software. For more information, see Installing the BEA Tuxedo System.
Make sure that the TUXDIR
environment variable is set to the directory in which you installed BEA Tuxedo software. For UNIX systems, if you installed BEA Tuxedo in the default directory, set TUXDIR
to /usr/local/TUXDIR
. Don't forget to export TUXDIR
if you are using a UNIX system. For Windows 2000 systems, if you installed BEA Tuxedo in the default directory, it is automatically set to TUXDIR=c:\TUX
n
(where n
represents the release of BEA Tuxedo being installed).
To run the BEA Administration Console, you need to set up two servers:
tuxwsvr
—a Web server provided with the BEA Tuxedo system software. You are not required to use this server and can use your own commercial Web server.wlisten
—a server required to administer the BEA Administration Console. It must be run on the master machine in a multi-machine configuration. This machine must be able to support a Java capable browser.To start tuxwsvr
on a UNIX system, enter the following command:
tuxwsvr -l //machine:port -i $TUXDIR/udataobj/tuxwsvr.ini
To start tuxwsvr
on a Windows 2000 system, enter the following command at a command prompt:
tuxwsvr -l //machine:port -i %TUXDIR%\udataobj\tuxwsvr.ini
The BEA Tuxedo installation procedure creates the tuxwsvr.ini
file. Usually, you do not need to edit this file—except under certain circumstances. 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, refer to the tuxwsvr(1)
reference page in the BEA Tuxedo Command Reference.
Before starting wlisten
, check the webgui.ini
file to verify that the default values assigned to the parameters during installation are appropriate; otherwise, make the appropriate changes. For example, on a machine called "popeye," the default port assigned to wlisten
is 4003. To run wlisten
with port 6060, edit the NADDR
parameter as follows:
NADDR=//popeye:6060
Depending on your system, webgui.ini
is located in the following locations:
Windows 2000 systems: %TUXDIR%\udataobj\webgui\
UNIX systems: $TUXDIR/udataobj/webgui
/
For details about other parameters in the webgui.ini
file, refer to the wlisten(1)
reference page in the BEA Tuxedo Command Reference.
To start the wlisten
process, enter the following command:
wlisten
Some features of the Administration Console, such as the level of encryption used for communication between the Administration Console applet and the Administration Console server, are configured by settings in the webgui.ini
file. For more information, refer to Appendix A, Configuring the BEA Tuxedo Administration Console.
To start the BEA Administration Console, follow these steps:
http://<machine_name>:<port>/webguitop.html
MEF(Issue): Need new screen shot for Taurus.
Figure 1-1 shows the Administration Console splash screen, including the button that starts the Administration Console, which is located at the bottom of the entry page.
Figure 1-1 BEA Administration Console Entry Page
tlisten.pw
file, which is located in the udataobj
directory where BEA Tuxedo is installed. The main BEA Administration Console window is displayed.
Figure 1-2 illustrates the Administration Console main window that displays after you complete your login.
Figure 1-2 BEA Administration Console Main Window
The main window is displayed and you want to start working with the GUI. |
Refer to the section BEA Administration Console Tutorial on page 1-9. |
The main window is displayed and you want to read a description about it's features. |
Refer to the section A Tour of the Main Window on page 2-1. |
The main window does not display and the |
2. If |
You have successfully started the BEA Administration Console. Now you can start setting up a single-machine domain environment for the simpapp
sample application provided with your BEA Tuxedo software.
To exit the BEA Administration Console, select Domain—>Exit from the menu bar. This closes the current domain and exits the BEA Administration Console applet.
This tutorial provides a step-by-step procedure for using the BEA Administration Console to configure a single-machine domain for either a BEA Tuxedo ATMI or CORBA environment.The tutorial includes the simpapp
sample application, which is provided with your BEA Tuxedo software.
Note: To learn more about the simpapp
domain, refer to the appropriate README
file in one of the following BEA Tuxedo sample application directories:
To set up your sample application environment, follow these steps:
cd simpapp
PATH
variable includes msdev\bin
and the LIB
variable includes msdev\lib
.Note: In this tutorial, the name of the machine is machine1
and the port assigned to the Web server is 8080
. You can use 8080
for the port if you have not already used it for another Web server.
Could not establish listening endpoint
wlisten
Note: If the wlisten
process does not start, edit the line, NADDR=//machine1:4003
in the $TUXDIR/udataobj/webgui/webgui.ini
file by replacing the port number (4003) with a valid port number. Then run wlisten
again.
http://
machine1:8080
/webguitop.html
Note: If you are using a Web server on the default port (8080), you can use the following URL: http://machine1/webguitop.html
tlisten
password after the appropriate prompts, then click on the LOGIN button. As shown in Figure 1-2, BEA Administration Console Main Window, on page 1-7, the BEA Administration Console main window is displayed in your browser.For a complete description of the main window, refer to the section A Tour of the Main Window on page 2-1
To create a new domain, follow these steps:
Figure 1-3 Create New Object Window
Note: If you get an error message, enter a different value in the IPC Key field.
To add GROUP1 to the simpapp
domain, follow these steps:
simpapp
domain name. The tree view displays the listings for the Machines and Service Defaults folders.SITE1
machine to display the administrative objects under its control, as shown in the following figure.To add the simpserv
server to GROUP1, follow these steps:
To activate the simpapp
domain, follow these steps:
To run simpapp
, follow these steps:
simpcl "hello"
Returned string is: HELLO
simpserv
server from the tree. Notice that the Configuration Tool is updated with the current parameters for the simpserv
server.You have successfully configured and run simpapp
through the BEA Administration Console. Now you can start setting up your environment for your own application domain.
![]() ![]() |
![]() |
![]() |