About Installing Management Agents and Deploying Plugins

Install management agents on all PeopleSoft component nodes. In this use case, you should install the agent on a single node.

Note:

Using the OCA agent for PeopleSoft discovery is not yet supported. For more details, see "Install Management Agents", which you can access from "Explore More", elsewhere in this playbook.

Download a Management Agent and Create an Install Key

First, you need to download a management agent and then create an installation key. Use this procedure.

From the OCI menu, navigate to Observability & Management then Management Agent then Downloads and Keys.
In Agent Software Download, download the agent for Linux to your desktop (this will be an RPM file).
If you are deploying the agent for the first time on your compartment, continue this step. Otherwise you can skip this step and proceed to copy the key from the existing key configuration. To deploy the agent for the first time, in Agent Install Keys, click Create Key and enter the following values in the pop-up:
- Key Name: PSFT-key
- Compartment: Choose your compartment.
Click Create.
Download your key to a file. From the OCI Observability & Management menu, select Management Agent then Downloads and Keys. Download by selecting Download from the menu for that key.

Deploy the Management Agent to Your Compute Instance

Now, you need to deploy the management agent on the PeopleSoft instance. Use this procedure:

Log into the instances by using SSH.
Download the management agent as described in "Download a Management Agent and Create an Install Key", above.
Install the RPM by running the following command:
```
 sudo install –ivh oracle.mgmt_agent.rpm 
```
Note:
If you encounter any Java errors, install Java by running this command:
```
sudo yum install java-1.8.0-openjdk –y
```
Open the key file downloaded on the previous step.
Use a text editor of your choice and create a file in the /tmp directory named psft-stackmonitoring.rsp with entries from your key file. At a minimum, you will need entries for ManagementAgentInstallKey and CredentialWaletPassword. Make sure the file is readable by the mgmt_agent user.
For example:
```
vi /tmp/psft-stackmonitoring.rsp 
ManagementAgentInstallKey=xxxxxxxxxxxxx CredentialWalletPassword = password 
```

Use the following command to configure your Management Agent:

sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=/tmp/psft-stackmonitoring.rsp

Delete the /tmp/psft-stackmonitoring.rsp file after successful agent configuration then validate the agent by running these commands:
```
sudo rpm -q oracle.mgmt_agent 
```
```
sudo systemctl status mgmt_agent
```
```
sudo ps –ef |grep mgmt_agent
```
Click Deploy Plug-Ins to open the deployment pop-up.
Select Observability & Management, Management Agent and Agents, Stack Monitoring, Operations Insights Host Service and click Update. After several minutes, the plugins should deploy.