Foglight 5.9.1 - Upgrade Guide

Upgrade the Foglight for PeopleSoft agents

Follow the procedure below to upgrade the Foglight for PeopleSoft agents.


	NOTE: Unless you require one of the defect fixes that come with this release, there is no benefit to upgrading the Foglight for PeopleSoft agents. If you decide to upgrade the agents, you can upgrade them over time, starting with the agents that did not reconnect properly after Step 3 of To upgrade Foglight for PeopleSoft:.

To upgrade the Foglight for PeopleSoft Agents:

Deploy the agent packages.


	NOTE: The following substeps describe how to deploy the agent packages using the command-line interface. You can also do this using the browser interface. For a procedure describing how to deploy agents using the browser interface, see Appendix: Deploy an agent package using the browser interface.

Run the following commands to deploy the correct package to each applicable target client. The following commands use the target osname and osversion to filter. Note that some of the arguments may differ based on your environment.

fglcmd -usr username -pwd password -cmd agent:deploy -regex -force -host hostname -clientid “clientid” -packageid "PSFTCartridge-<version>-Windows-Agent-Windows-windows-/5\.1.*/-ia32,x86_64" -osname "Windows"

fglcmd -usr username -pwd password -cmd agent:deploy -regex -force -packageid PSFTCartridge-<version>-Windows-AgentPackage -osname "Windows"

./fglcmd.sh -usr username -pwd password -cmd agent:deploy -regex -force -packageid PSFTCartridge-<version>-AIX-AgentPackage -osname AIX

./fglcmd.sh -usr username -pwd password -cmd agent:deploy -regex -force -packageid PSFTCartridge-<version>-HP-UXB-AgentPackage -osname HP-UXB

./fglcmd.sh -usr username -pwd password -cmd agent:deploy -regex -force -packageid PSFTCartridge-<version>-Linux-AgentPackage -osname Linux

./fglcmd.sh -usr username -pwd password -cmd agent:deploy -regex -force -packageid PSFTCartridge-<version>-SunOS-AgentPackage -osname SunOS

where <version> is the version number of the cartridge. Do not include the brackets.

The -force option specifies that the fglcmd command is to update more than one client at the same time. It is recommended that you initially use -test to confirm the correct matchup of package with host/version.

Deployment failures are entered into the Management Server logs.

When the new agent package is successfully deployed, the agents are restarted and the new version is automatically used. Therefore, there is no need to create or start new agents.

To narrow down the list of hosts to which you can deploy updated Foglight for PeopleSoft agents, use the -host option. For example:

UNIX®:

./fglcmd.sh -usr username -pwd password -cmd agent:deploy -regex -force -packageid PSFTCartridge-<version>-Linux-AgentPackage -osname Linux -host .*.co.uk

Windows®:

fglcmd -usr username -pwd password -cmd agent:deploy -regex -force -packageid PSFTCartridge-<version>-Windows-AgentPackage -osname Windows -host .*.co.uk

This will update all hosts in the *.co.uk domain only, leaving alone clients on hosts such as fs-paris2.jhq and jpweb05lin.integra.net.uk.

Be patient as it takes some time for the mass deploy to finish. During this time, do not start/stop/activate/deactivate agents manually in the Agent Status page (Dashboards > Administration > Agents > Agent Status) or via the command-line interface.

Verify that Foglight for PeopleSoft has been upgraded by looking at the version number on the Agent Status page to ensure that it is the correct version. This must be done for every agent type.

If an agent has not reconnected, restart the Agent Manager for that host and check the log files again.

For Foglight clients where the PS_AppServer and PS_SchedServer agents are running as non-root, follow the instructions in the “Running the PS_AppServer and PS_SchedServer as Non-root or Non-PeopleSoft account” section of the latest Foglight for PeopleSoft Release Notes.

For AIX® 5.3, you must apply the xlc.rte.aix50.may2005.ptf.tar.Z patch from the IBM® Web site which upgrades the C++ Runtime Environment Component to version 7. This patch can be found at:

ftp://ftp.software.ibm.com/aix/products/ccpp/xlc-rte-aix-v7/xlc.rte.aix50.may2005.ptf.tar.Z