Installation and configuration of the Process Scheduler agent on Unix/Linux is similar to the Domain agent with a few slight differences. The demo environment for this post will be a Red Hat machine with PeopleTools 8.48.
Run the install script from the installation media. You are asked which option you would like to perform. Choose 1) Install products to the local host:
Select one of the following:Read the agreement and choose 1 if you agree:
1) Install products to the local host.
2) Install products to depot for remote deployment (requires TEMS).
3) Install TEMS support for remote seeding
4) Exit install.
Please enter a valid number: 1
International Program License AgreementEnter a 32 character encryption key or use the default (not recommended). If you’ve previously installed the Domain agent, this step is already done:
Part 1 - General Terms
BY DOWNLOADING, INSTALLING, COPYING, ACCESSING, OR USING
THE PROGRAM YOU AGREE TO THE TERMS OF THIS AGREEMENT. IF
YOU ARE ACCEPTING THESE TERMS ON BEHALF OF ANOTHER PERSON
OR A COMPANY OR OTHER LEGAL ENTITY, YOU REPRESENT AND
WARRANT THAT YOU HAVE FULL AUTHORITY TO BIND THAT PERSON,
COMPANY, OR LEGAL ENTITY TO THESE TERMS. IF YOU DO NOT
AGREE TO THESE TERMS,
- DO NOT DOWNLOAD, INSTALL, COPY, ACCESS, OR USE THE
Press Enter to continue viewing the license agreement, or
enter "1" to accept the agreement, "2" to decline it, "3"
to print it, "4" to read non-IBM terms, or "99" to go back
to the previous screen.
Enter a 32-character encryption key, or just press Enter to use the defaultNext, choose your operating system from the list or hit Enter to use the default and confirm:
Default = IBMTivoliMonitoringEncryptionKey
GSkit encryption key has been set.Next, choose the products you want to install. On our system, we will choose 3) all of the above. If you have previously installed the Domain agent, the Tivoli Enterprise Services User Interface may have already been installed. Confirm:
Key File directory: /opt/IBM/ITM/keyfiles
Product packages are available in /mnt/it2/agents/peoplesoft/ompeoplesoft621
The following products are currently installed in "/opt/IBM/ITM:"
IBM GSKit Security Interface V07.30.31.00 @ Linux Intel R2.4 (32 bit)/Intel R2.6 (32 bit)/AMD64 R2.6
Product packages are available for the following operating systems and component support categories:
1) AIX R5.2 (64 bit)
2) AIX R5.3 (64 bit)
3) HP-UX R11 Integrity (64 bit)
4) Linux Intel R2.6 (32 bit)
5) Linux Intel R2.6 GCC 2.9.5 (64 bit)
6) Linux x86_64 R2.6 (64 bit)
7) Solaris R10 (64 bit)
8) Solaris R8 (64 bit)
9) Solaris R9 (64 bit)
10) Tivoli Enterprise Portal Browser Client support
11) Tivoli Enterprise Portal Desktop Client support
12) Tivoli Enterprise Portal Server support
13) Tivoli Enterprise Monitoring Server support
Type the number for the OS or component support category you want, or type "q" to
[ number "4" or "Linux Intel R2.6 (32 bit)" is default ]: 4
You selected number "4" or "Linux Intel R2.6 (32 bit)"
Is the operating system or component support correct [ 1=Yes, 2=No ; default is "1" ] ? 1
The following products are available for installation:Choose whether or not to install other products and the install will complete:
1) IBM Tivoli Composite Application Manager for Applications Agent for PeopleSoft
Enterprise Process Scheduler V06.21.01.00
2) Tivoli Enterprise Services User Interface V06.21.00.02
3) all of the above
Type the numbers for the products you want to install, or type "q" to quit
If you enter more than one number, separate the numbers by a comma or a space.
Type your selections here: 3
The following products will be installed:
IBM Tivoli Composite Application Manager for Applications Agent for PeopleSoft
Enterprise Application Domain V06.21.01.00
Tivoli Enterprise Services User Interface V06.21.00.02
Are your selections correct [ 1=Yes, 2=No ; default is "1" ] ? 1
... installing "IBM Tivoli Composite Application Manager for Applications Agent
for PeopleSoft Enterprise Application Domain V06.21.01.00 for Linux Intel R2.6
(32 bit)"; please wait.
=> installed "IBM Tivoli Composite Application Manager for Applications Agent for
PeopleSoft Enterprise Application Domain V06.21.01.00 for Linux Intel R2.6 (32
... installing "Tivoli Enterprise Services User Interface V06.21.00.02 for Linux Intel R2.6 (32 bit)"; please wait.
=> installed "Tivoli Enterprise Services User Interface V06.21.00.02 for Linux
Intel R2.6 (32 bit)".
... Initializing component Tivoli Enterprise Services User Interface V06.21.00.02
for Linux Intel R2.6 (32 bit). ... Tivoli Enterprise Services User Interface V06.21.00.02
for Linux Intel R2.6
(32 bit) initialized.
Do you want to install additional products or product support packages [ 1=Yes,
2=No ; default is "2" ] ? 2 ... postprocessing; please wait. ... finished postprocessing. Installation step complete.
As a reminder, you should install product support on each of your TEM servers for
any agents you have just installed.
This is done via the "/opt/IBM/ITM/bin/itmcmd support" command on your TEM
You may now configure any locally installed IBM Tivoli Monitoring product via the
"/opt/IBM/ITM/bin/itmcmd config" command.
Now we can configure our newly installed agent. Start the configuration by running the following command in your CANDLEHOME/bin directory:
./itmcmd config -A p9You will be asked to enter a descriptive instance name:
Agent configuration started... Enter instance name (default is: ): psps01Choose to edit the “Monitoring Agent for PeopleSoft Domain” settings and the “Basic” settings. Th
|Instance Name||psps01||A descriptive name used to identify the instance.|
|Fully qualified path for the Process Scheduler psprcs.cfg file||/apps/psoft/hrms9/appserv/prcs/DH9848DB/psprcs.cfg||The fully qualified path to the psprcs.cfg file for the scheduler being monitored.|
|Fully qualified path of the folder where the Process Scheduler logs are located||/apps/psoft/hrms9/appserv/prcs/DH9848DB/LOGS||The fully qualified path to the folder containing the logs for the scheduler being monitored.|
|Database Name||DH9848DB||The Database name for the Process Scheduler being monitored. This can be found in the psprcs.cfg file.|
|Scheduler Server Name||PS002||The name of the Process Scheduler Server being monitored. This can be found in the psprcs.cfg file.|
|PeopleSoft Application Engine (PSAE) user name||PS||This is the PSAE user name for your PeopleSoft environment. Check with your PeopleSoft administrator.|
|PeopleSoft Application Engine (PSAE) password||**||This is the PSAE password for your PeopleSoft environment. Check with your PeopleSoft administrator.|
|PeopleSoft base install directory||/apps/psoft/hrms9||This is the base PeopleSoft installation directory.|
|Data collection interval||1||The interval, in minutes, at which data will be collected by the monitoring agent.|
|Maximum number of records to return||0||This is the maximum number of records that will be returned. Any records after this number will be discarded. The newest records will be used. Set this to 0 to send all records back.|
|Logging Level of the Agent||Warn||This is the logging level of the agent. Most users will want to set this to the WARN level.|
After entering the configuration options for your environment, you need to also enter the connection settings for your TEMS. After that, you need to preserve the PeopleTools environment for the user account that is running both PeopleSoft and eventually the agents (they must be the same user). To do this, you must edit the .profile for that user. Add the following line:
. [ITM home]/[platform code]/[product code]/bin/preserve_pt_environment.shWhere [ITM home] is the IBM Tivoli installation directory, [platform code] is the code for the operating system, and [product code] is the product code for the agent (P8 or P9). Congratulations, the configuration is complete! Make sure to switch to the same user that PeopleSoft is running on before starting the agents.