FPP for Enterprise Manager Prerequisites

In order to integrate Fleet Patching & Provisioning (FPP) services into Enterprise Manager you must perform the following prerequisites tasks. An EM_ALL_ADMINISTRATOR account is required for these tasks.

Environment Prerequisites

For full FPP support with Enterprise Manager the following configurations are required:

Oracle Enterprise Manager 13c Release 5 Update 14 (13.5.0.14) or above
FPP Server version 19.18 or above with patch 35159977
FPP Client version 19.18 or above is required before patching databases on clusters

For more details for setting up and upgrading your FPP server, see Oracle Fleet Patching and Provisioning Administrator's Guide.

Deployment Prerequisites

Existing FPP Customers:
1. Discover the FPP server and client, running on Grid Infrastructure, as cluster targets in Enterprise Manager. If the Grid Infrastructure where the FPP Server or FPP Client are running are already monitored by Enterprise Manager, no additional discovery of targets is required. You can discover targets in EM by configuring autodiscovery, or by using either a guided or a declarative discovery process. For more details, see Discovering and Adding Host Targets.
2. Register existing FPP server in Enterprise Manager using REST API or EM CLI:
  - REST API: URI Rest End point: https://<subdomain>.<domain>.com:<port>/em/api/fppServers for example:
```
https://host1.example.com:24500/em/api/fppServers
```
    Sample Payload:
```
{
   "name":"cluster1",
   "properties":{
      "restUrl":"https://host1.example.com:24500/rhp-restapi/rhp",
      "agentCredential":"CUSER:SYSMAN"
   },
   "restUser":{
      "username":"restuser",
      "password":"<password>"
   },
  "schedule":{
      "recurring":"frequency:weekly;days:1"
   }
   }
}
```
  - EM CLI: Use command emcli db_software_maintenance -setup -registerFPPServer -input_file="<fileLocation>" with the input file containing:
```
"name":"host1",
"restUrl":"https://host1.example.com:24500/rhp-restapi/rhp",
"agentCredential":"CUSER:SYSMAN"
"username":"restuser",
"password":"<password>"
"recurring":"frequency:weekly;days:1"
 
```
New FPP Customers:
1. Setup and configure an FPP server outside of Enterprise Manager, for more details see: Configure an Oracle Fleet Patching and Provisioning server.
2. Discover the FPP server and client, running on Grid Infrastructure, as cluster targets in Enterprise Manager. If the Grid Infrastructure where the FPP Server or FPP Client are running are already monitored by Enterprise Manager, no additional discovery of targets is required. You can discover targets in EM by configuring autodiscovery, or by using either a guided or a declarative discovery process. For more details, see Discovering and Adding Host Targets.
3. Register the new FPP server in Enterprise Manager using REST API or EM CLI:
  - REST API: URI Rest End point: https://<subdomain>.<domain>.com:<port>/em/api/fppServers for example:
```
https://host1.example.com:24500/em/api/fppServers
```
    Sample Payload:
```
{
   "name":"cluster1",
   "properties":{
      "restUrl":"https://host1.example.com:24500/rhp-restapi/rhp",
      "agentCredential":"CUSER:SYSMAN"
   },
   "restUser":{
      "username":"restuser",
      "password":"<password>"
   },
  "schedule":{
      "recurring":"frequency:weekly;days:1"
   }
   }
}
```
  - EM CLI: Use command emcli db_software_maintenance -setup -registerFPPServer -input_file="<fileLocation>" with the input file containing:
```
"name": "string",
    "restUrl": "https://xyz.com:4473/em/api/fppServers",
    "agentCredential": "USER:SYSMAN"
    "timeToStart": "<TIME>",
    "timeToEnd": "<TIME>",
    "isTargetZone": true,
    "scheduleType": "string",
    "recurring": "Weekly",
    "startGracePeriodInMinutes": 60
```

Optional FPP Client Registration

FPP Client registration occurs automatically using Enterprise Manager, should you optionally need to register the FPP client manually use the following EM CLI or REST API operations.

REST API: URI Rest End point: https://<subdomain>.<domain>.com:<port>/em/api/fppClients for example:

https://host1.example.com:24500/em/api/fppClients

Sample Payload:

{  
"serverName": "<Server Name>",  
"clientName": "<Client Name>"
}

EM CLI: Use command emcli db_software_maintenance -setup -registerFPPClient-input_file="data:<fileLocation>"w with the following input file:
```
"serverName": "<Server Name>",  
"clientName": "<Client Name>"
```