Starting an Agent With PSEMAgent Windows Service

You can set an Environment Management agent to start automatically when your Environment Management machine boots and run in the background. This enables you to avoid having a command prompt open at all times showing the constant heartbeat of the agent.

For this option, use the PSEMAgent Windows service that's delivered as part of PeopleTools.

Installing the PSEMAgent Service

You install the PSEMAgent service from a command prompt. Copies of the install program are located in two places:

PS_HOME\bin\client\winx86

PS_HOME\bin\server\winx86

To install the PSEMAgent service:

At a command prompt, change to either location of the install program.
Enter the following command:

PSEMAgentService /install PS_HOME\PSEMAgent

Where PS_HOME is the PeopleTools installed location.

The PSEMAgent service is now installed, but not started. It's configured by default to start automatically when the system boots, and to log on using the local system account. You can start it manually, or wait for the next reboot.

Note:

The PSEMAgent service is configured to start as an automatic service, by default. However, the Hub must be running prior to the PSEMAgent service attempting to start, or the PSEMAgent service will not start successfully. It is recommended to set the PSEMAgent service to manual start in the Windows Services interface. Then, to start the PSEMAgent service, start it manually from the Services interface.

Starting the PSEMAgent Service

You can start the PSEMAgent service from a command prompt, or from the Windows Services control panel. The name of the service follows this convention: PeopleSoft Environment Management Agent-<release>.

To start the PSEMAgent service from a command prompt, use the NET START command. For example:
```
NET START "PeopleSoft Environment Management Agent-8.50"
```
To start the PSEMAgent service from the Windows Services control panel:
1. Open the Windows Control Panel, then double-click Administrative Tools, then Services.
2. In the Services control panel, right-click the PeopleSoft Environment Management Agent entry and select Start.

Stopping the PSEMAgent Service

You can stop the PSEMAgent service from a command prompt, or from the Windows Services control panel.

To stop the PSEMAgent service from a command prompt, use the NET STOP command. For example:
```
NET STOP "PeopleSoft Environment Management Agent-8.50"
```
To stop the PSEMAgent service from the Windows Services control panel:
1. Open the Windows control panel, then double-click Administrative Tools, then Services.
2. In the Services control panel, right-click the PeopleSoft Environment Management Agent entry and select Stop.

Uninstalling the PSEMAgent Service

You uninstall the PSEMAgent service from a command prompt.

To uninstall the PSEMAgent service:

At a command prompt, change to either location of the uninstall program.

Copies of the uninstall program are located in two places:

PS_HOME\bin\client\winx86

PS_HOME\bin\server\winx86
Enter the following command:

PSEMAgentService /uninstall

PSEMAgentService determines if the service is currently started, and automatically stops it before completing the uninstall operation. You'll see messages reporting on the status of the operation.

Note:

If the service is currently stopped, you'll see an error message indicating that it can't be stopped. Regardless of this, the uninstall operation completes normally.