Get up and running with the Tuxedo Administration Console April 2, 2007
Posted by Duncan in Administration, Infrastructure, PeopleSoft, PS Admin, Tuxedo.trackback
I think I’ve stumbled across a better way of remotely administering servers than using remote control software and PSADMIN. There’s a tool called the ‘Tuxedo Administration Console’ (or sometimes ‘WebGUI’) which does the job also.
It looks like this:
Once you’ve done a little bit of config (no more than 15 minutes, and it’s just config, there’s nothing additional to install) you just point the web browser on your client PC to a URL and it loads up the above screen.
You drop down the Domain menu to choose which App Server or Process Scheduler to administer, then use it to start and stop the domain, or you can do individual processes if you prefer. (For example, on my current client site we have a developer who frequently hangs the domain by using all of the PSAPPSERV processes during debugging. Using this tool, we could change the Max App Servers setting and then boot a couple of extra App Servers, all in a few clicks and without rebooting the domain.)
These are the steps I took to get the Admin Console running (substitute your own machine names and ports where appropriate):
- for each app server and process scheduler you wish to administer, edit the *.ubx file under either the app serv or proc sched directories. Go to the PS_ENVFILE section and add:
PS_SERVDIR={$PS_SERVDIR}
PS_SERVER_CFG={$PS_SERVDIR}{FS}{CFGFILE} - locate the webgui.ini file under <tuxedo install directory>\udataobj\webgui\ and in the second section add a line for each domain you wish to administer (i.e. a line for each app server or process scheduler). There are instructions in file, but the line will look something like this.
DOMAIN=HR9DMO;D:\pshome\appserv\HR9DMO\PSTUXCFG - Start the Tuxedo Web Server and Listener
cd /d d:\bea\tux*
tuxwsvr -l //vm-hr9dmo:8080 -i D:\bea\Tuxedo8.1\udataobj\tuxwsvr.ini
Wlisten - From your client log on to ‘http://vm-hr9dmo:8080/webguitop.html’. The username and password will be that chosen when Tuxedo was installed (likely admin/password)
- chose the domain you wish to admin from the drop down domain menu, then you can drill down and activate/inactivate (webgui terminology for start-up/shut-down) whatever you wish.
Hope that helps. If you have any issues, I found the tuxedo website more useful than Peoplebooks or customer connection, however your mileage may vary. Also, the tuxedo helpfile is here:
<bea_home>\Tuxedo8.1\help\guiguide\index.htm
This post was edited on 7th Nov ’07 to include corrections on the port number, as suggested by David Kurtz in his comment below.
Comments
Sorry comments are closed for this entry
The PeopleSoft Tipster Blog 
Hi,
Great Post!! I understand most of it but the 3rd step where it says Start the Tuxedo Web Server and Listner, I am a little confused with that one. Please explain.
Sure …
the tuxwsvr is a mini web server that you use to serve up the Web GUI. The -l tells it what to listen on for new connections, and the -i tells it where to load config parameters from.
The wlisten is the other half of the setup, and listens for commands issued by users of the Web GUI.
If you have a look around for the processes that should help, as will the tuxedo help file given in the article and a quick google should fill in any gaps.
You should not use port 4003 for the web server because is also used by default by the wlisten process to communicate with the applet (look at the NADDR setting in %TUXDIR%\udataobj\webgui\webgui.ini). You are likely to get the following error:
tuxwsvr -l //myhost:4003 -i d:\ps\bea\Tuxedo8.1\udataobj\tuxwsvr.ini
wlisten -i d:\ps\bea\Tuxedo8.1\udataobj\webgui\webgui.ini
WEBGUI_CAT:16583: ERROR: Could not establish listening endpoint //myhost:4003
I would recommend that you use port 80 on Windows, and another port higher that 2048 on Unix (because otherwise you would need to run the web server with root privilege).
In Tuxedo 8.1, if you edit configuration parameters with the administrative applet you will directly update the compiled domain configuration file PSTUXCFG. When you reconfigure the domain with ‘psadmin’ you will lose those changes. If you want to retain those changes you have to remember to make them to the configuration file yourself.
Alternatively you can decompile PSTUXCFG with the Tuxedo ‘tmunloadcf’ utility to a text file to see what has been changed. It is useful to have a decompiled version before any changes are made via the applet, so you can see what has changed.
Hi,
I m Sarvanan.
In the following URL I could ablr to undestand that hr89dmo is the instance name.
But what is that vm-
http://vm-hr9dmo:4003/webguitop.html
Can you explain this?
The whole of the first section is the hostname of the server. So the server – in this case a Virtual Machine – is called ‘vm-hr9dmo’. The port it’s listening on is 4003 (which if you read David Kurtz’s post above may not have been a good idea) and the page you’re requesting is ‘webguitop.html’.
I get the following error when I started the tuxwsvr.
WEBGUI_CAT:16505: ERROR: Could not establish listening endpoint mydomain.com:4003INFO: Terminating tuxwsvr process.
I could start the wlistener.
This is the command I used:( Linux)
tuxwsvr -l mydomain.com:4003 -i $TUXDIR/udataobj/tuxwsvr.ini -L $PS_HOME/appsvr/hrdmo/LOGS
I have listed the values belows of my ini files, commands and URL. I get the first web page but the second errors out. Can anyone help?
webgui.ini
# Web GUI initialization file.
# Created by BEA software installation program.
#
TUXDIR=C:/BEA/Tuxedo8.1
INIFILE=C:/BEA/Tuxedo8.1/udataobj/webgui/webgui.ini
NADDR=//PSWEB1:8080
DEVICE=/dev/tcp
CODEBASE=/java
DOCBASE=/doc
SNAPDIR=C:/BEA/Tuxedo8.1/udataobj/webgui/java/snapshot
SNAPBASE=/java/snapshot
#
# In order to configure one or more domains as part of the Web GUI pull-down
# menu, add lines to this file of the form DOMAIN=domainname;tuxconfig
DOMAIN=HCSP1;C:/PSOFT/HCSP1/PT848/appserv/HCSP1
tuxwsvr.ini
# tuxwsvr initialization file.
# Created by BEA software installation program.
#
CGI /cgi-bin C:/bea/Tuxedo8.1/udataobj/webgui/cgi-bin
HTML /java C:/bea/Tuxedo8.1/udataobj/webgui/java
HTML /doc C:/bea/Tuxedo8.1/help
HTML / C:/bea/Tuxedo8.1/udataobj/webgui
Dos Commands
tuxwsvr -l //PSWEB1:89 -i %TUXDIR%\udataobj\tuxwsvr.ini -L c:\psoft\HCSP1\PT848\appserv\HCSP1\LOGS\LOGS
wlisten
From Browser : http://psweb1:89/webguitop.html
When I click the button that reads “Click Here to Run the BEA Tuxedo …”
I get the window titled “Cannot find server – Microsoft Internet Explorer” and the URL changes to “http://host/CGI-BIN/tuxadm?TUXDIR=TUXDIRVALUE”
PSADMIN, if you have a look at the comment David Kurtz posted he pointed out that I had a port conflict. I’ve amended the original post to use port 8080 instead of 4003. As David pointed out, this should resolve the ‘Could not establish listening endpoint’ error.
DAVID, Check the DOMAIN line in your ini file. Yours reads:
DOMAIN=HCSP1;C:/PSOFT/HCSP1/PT848/appserv/HCSP1, while mine reads:
DOMAIN=HR9DMO;D:\pshome\appserv\HR9DMO\PSTUXCFG
Append the filename for the PSTUXCFG file and let us know how you get on.
Will this also work if appserver is on unix and webserver / Tuxedo is on windows
What would be domainname in step 2 if it is on unix
This isn’t something I’ve ever tried, and I’m not in a position to test this now but I don’t see why it wouldn’t. The domain name would be the same as App Server domains are named in a similar way regardless of whether they reside on Windows or Unix.
Hi,
I am trying to configure “bea tuxedo admin console”. i manage to get the initial console screen using the url: http://wdqakcwx1a9.cmpa.org:9090/webguitop.html
When i click on the button – “click here to administer BEA tuxedo admin console” i get an error:
Internet Explorer cannot display the webpage.
The url of the page that errors out is:
http://host/CGI-BIN/tuxadm?TUXDIR=TUXDIRVALUE
i am using the following commands to start the web server and listener:
tuxwsvr -l //WDQAKCWX1A9.cmpa.org:9090 -i C:\bea\Tuxedo8.1\udataobj\tuxwsvr.ini
wlisten -i C:\bea\Tuxedo8.1\udataobj\webgui\webgui.ini
i am enclosing the supporting config files:
# tuxwsvr initialization file.
# Created Mar 20, 2006 9:18:29 AM by BEA software installation program.
#
CGI /cgi-bin c:\bea\Tuxedo8.1\udataobj\webgui\cgi-bin
HTML /java c:\bea\Tuxedo8.1\udataobj\webgui\java
HTML /doc c:\bea\Tuxedo8.1\help
HTML / c:\bea\Tuxedo8.1\udataobj\webgui
# Web GUI initialization file.
# Created Mar 20, 2006 9:18:29 AM by BEA software installation program.
#
TUXDIR=c:\bea\Tuxedo8.1
INIFILE=c:\bea\Tuxedo8.1\udataobj\webgui\webgui.ini
NADDR=//WDQAKCWX1A9.cmpa.org:7070
DEVICE=/dev/tcp
CODEBASE=/java
DOCBASE=C:\bea\Tuxedo8.1\udataobj\jolt\doc
TEMPLATE=C:\bea\Tuxedo8.1\udataobj\webgui\webgui.html
SNAPDIR=c:\bea\Tuxedo8.1\udataobj\webgui\java\snapshot
SNAPBASE=/java/snapshot
#
# In order to configure one or more domains as part of the Web GUI pull-down
# menu, add lines to this file of the form DOMAIN=domainname;tuxconfig
DOMAIN=CRMDM90;D:\PSOFT\crmdm90\appserv\prcs\CRMDM90\PSTUXCFG
*PS_ENVFILE
{WINDOWS}
PS_SERVDIR={$PS_SERVDIR}
PS_SERVER_CFG={$PS_SERVDIR}{FS}{CFGFILE}
PATH={$PS_HOME}\bin\server\winx86;{$Process Scheduler\DBBIN};{$Tuxedo Settings\Add to PATH};{$PS_HOME}\verity\{VERITY_OS}\{VERITY_PLATFORM}\bin
INFORMIXSERVER={$Startup\ServerName}
{WINDOWS}
regards,
William
Hi Davies,
Thanks for the tip!
Now my problem is trying to find the added value of this tool lol.
-Words of a newbie-
wlisten issue:
I am getting the following in my ULOG file. Anyone have a clue as to how to resolve this? I have it working on another UNIX server, I just cannot get it to run on this one.
082951.dcr-pshr-tmp1-1!wlisten.598212.1.-2: WEBGUI_CAT:3102: INFO: wlisten starting
082951.dcr-pshr-tmp1-1!wlisten.598212.1.-2: WEBGUI_CAT:3108: WARN: Network device does not exist
How do you solve this problem? WEBGUI_CAT:3108: WARN: Network device does not exist. Help me!!!
Update: The wlisten messages do not seem to be relevant. What happens is when I click on the “Click here to run the Tuxedo Admin Console link it just brins up a blank page and does it rather quickly. It is not firing off tuxadm. Any thoughts?
Where is that we create a user id and password for tuxedo. My tuxedo was successful but was never asked the userid and password. Now that i try to go for the psadmin GUI, i m being asked userid and password. Because of this i m not able to proceed. Please help
The password is entered during installation of Tuxedo. By default I think it’s system/password.
Or – use tpsysadm/password or tpsysoper/password
BTW, I get this error during activation of pub/sub handler group:
-10:CMDTUX_CAT:1711: ERROR: Could not boot any servers
Any idea?
I was able to activate the same using PSADMIN utility and was able to deactivate using PSADMIN as well as WEBGUI.
Any insight – would be of immense help.
During the installation was only asked the tlisten password which I gave. But userid/password for Tuxedo as such was never asked. Can you please guide me through.
From your post :
“Where is that we create a user id and password for tuxedo. My tuxedo was successful but was never asked the userid and password. — Now that i try to go for the psadmin GUI, i m being asked userid and password—. Because of this i m not able to proceed. Please help
”
We we referring to PSADMIN gui userid/password which you had mentioned that the utility was asking to supply.
Tipster: Can you pls provide your thoughts on :
10:CMDTUX_CAT:1711: ERROR ?
cheers.
Muthukumar,
sorry, I haven’t encountered the 1711 error before. Assuming you’ve checked the obvious (that it’s not down to being already booted, or the ports aren’t in use by some other process that wasn’t started when you booted them through other means) I don’t know. Try one of the message boards (it-toolbox or peoplesoft-fans), you’ll reach a lot more people that way and I’m sure someone will be able to help.
I completed all the steps. Started tuxwsvr & wlisten with port 8080. I have supplied the id/pwd = tpsysadm/password and the page hangs and GUI is not being launched at this stage.
When I kill the process, I get a window pop up that says ” connection failed”..
I do not see anything in the logs directory as well.
Any helpi sgreatly appreaciated.
I able to start Tuxedo Admin console, but all the buttons except settings and help are disable, there is no domian tree at the left panel. What all I have to do to add one domain.