Supported Environments
Tuxedo 6.3 or higher
Known Limitations
If Tuxedo 7.1 or later is installed, you can monitor more than one PeopleSoft (Tuxedo) application server at a time. If Tuxedo 6.5 or earlier is installed, you can monitor only one PeopleSoft (Tuxedo) application server at a time.
Requirements
1. Make sure that you have LoadRunner 7.8 Feature Pack1 or higher installed on all the machines.
2. Make sure that the Controller / Tuning Console machine is installed with Tuxedo Workstation client (not a native client). The Tuxedo workstation client, also called App Designer is either part of the Tuxedo installation or the PeopleSoft client installation. Please check with PeopleSoft regarding how to obtain the same.
Note: A Tuxedo workstation client communicates with the application server over the network, and is not required to run the Tuxedo application server on the same machine. A native client can only communicate with the Tuxedo application server if it is part of the relevant Tuxedo domain. )
3. Define the Tuxedo environment variables on the Controller / Tuning Console machine:
a. Create and set the TUXDIR variable to the Tuxedo installation directory
b. Create and set the NLSPATH variable to contains subdirectories to support the localisation of system messages along with message catalogues for the default locale
b. Add the Tuxedo bin directory to the PATH variable.
Example:
PATH = <Tuxedo>\bin
TUXDIR =<Tuxedo>
NLSPATH =<Tuxedo>\local\c
4. Ensure that the workstation listener (WSL) process is running. This enables the application server to accept requests from workstation clients. Note that the address and port number used to connect to the application server must match those dedicated to the WSL process.
Logon Information
If you do not have the logon information, you can find it out by recording against a utility that that comes with PeopleSoft. You need to install this tool, and do a Tuxedo or a PeopleSoft-Tuxedo recording against it.
For PeopleSoft 7.5 or below, the utility is called PeopleTools.
For PeopleSoft 8.0 or above, the utility is called Application Designer.
On recording, just login to the server and stop the recording. This will generate a tpinit.ini file in the scrīpt folder; you can use the information on this file in the Controller / Tuning Console to connect to the Tuxedo server and get the resources for the Tuxedo Monitor. The tpinit.ini file should look similar to this:
[Logon]
[LogonServer=//psft1:7000
[LogonUserName=tester
[LogonPassword=__asdnasdqwenqwekpqwnenwic
[LogonExtra1=clarify
[LogonExtra2=__asdnasdqwenqwekpqwnenwic
[LogonExtra3=
Configuring the PeopleSoft (Tuxedo) Monitor in Controller
1. In the Controller, right-click on the PeopleSoft(Tuxedo) Monitor graph and select 'Add measurements.'
2. Click on the first 'Add' button to add the machine on which the Tuxedo server is installed. Give the name of the machine and the OS then click 'OK'.
3. Click on the second 'Add' button, this should open a dialog asking for information like server name, login, etc. and it should also have a Browse button.
4. You can fill up the information manually, or click on the Browse button and browse to the folder where the newly created tpinit.ini file is stored, select it, and click 'OK'. That should connect to the Tuxedo server and you should be able to add resources.
Note: The format of the server name is //<machine name>:<port number>.
5. To authenticate the PeopleSoft (Tuxedo) monitor, click 'Advanced', and enter the authentication data as a hexadecimal string (beginning with ?x? in the Data field. The authentication data value can be obtained from the tpinit.ini file of an existing Tuxedo scrīpt.
6. Click 'OK'. The 'Add' PeopleSoft (Tuxedo) Measurements dialog box opens.
7. For each measurement, select an object, measurement, and instance, and then click 'Add'
8. When you have finished adding measurements, click 'Close'.
9. In the PeopleSoft (Tuxedo) dialog box, click 'OK'.
Configuring the PeopleSoft (Tuxedo) Monitor in Tuning Module
Note: This is only available with LoadRunner8.0 and higher.
1. Click 'Monitors' to open the 'Monitors Configuration' dialog box.
2. From the Server list, choose the server running PeopleSoft.
3. Click 'Add Monitor' and select 'Show All Available Monitors'. The 'Select Measurements to Monitor' dialog box opens, displaying all the available monitors.
4. In the left section of the dialog box, expand the 'ERP/CRM Server' category,select 'PeopleSoft (Tuxedo)' , and click 'Add'.
5. The 'PeopleSoft (Tuxedo) logon' dialog bos opens, asking for information like server name, login, etc. and it should also have a Browse button.
6. You can fill up the information manually, or click on the Browse button and browse to the folder where the newly created tpinit.ini file is stored, select it, and click 'OK'. That should connect to the Tuxedo server and you should be able to add resources.
Note: The format of the server name is //<machine name>:<port number>.
7. To authenticate the PeopleSoft (Tuxedo) monitor, click 'Advanced', and enter the authentication data as a hexadecimal string (beginning with ?x? in the Data field. The authentication data value can be obtained from the tpinit.ini file of an existing Tuxedo scrīpt.
8. Click 'OK'. The 'Add' PeopleSoft (Tuxedo) Measurements dialog box opens.
9. For each measurement, select an object, measurement, and instance, and then click 'Add'
10. When you have finished adding measurements, click 'Close'.
11. In the Tuning Console, click OK in the Select Measurements to Monitor dialog box, and in the Monitors Configuration dialog box, to activate the monitor.
