Opt in an Image

Fleet Maintenance offers the flexibility to leverage an existing image stored in FPP tool for patching all supported Exadata components. Opting in allows for the images to be updated in an easier manner with newer versions, allowing targets to subscribe to the series and not have to resubscribe to each new image version.

Opt in is an optional process. You can skip the opt in if you fulfill any of the following conditions:

You don't plan to utilize an existing FPP image
You want to create/update a new image

To opt into an existing FPP image, follow these steps:

Review all available images and obtain the Series ID for the FPP image with the following EM CLI command:
```
emcli db_software_maintenance -getImages -all
```
Review the available FPP Server series by querying the FPP server and listing the image series.
EMCLI command format:
```
emcli db_software_maintenance  -setup -getFPPSeries
    -input_file="data:/scratch/<user_name>/fpp/payload.properties"
```
Example input file that contains all the required information:
```
"targetName":"<FPP server name>",
      "targetType":"cluster"
```
FPP Servers must use target type cluster.
List all available FPP images.
EMCLI command format:
```
emcli db_software_maintenance  -setup -getFPPImages
    -input_file="data:/scratch/<user_name>/fpp/payload.properties"
```
Example input file that contains all the required information:
```
{
    ["seriesId": "<Series ID>",]  
    ["seriesName": "<Series Name>",]
    ["serverName": "<Server Name>"]
}
```
[ ] denotes an optional parameter. To list the available FPP images, enter the series ID or both series name and server name.
Opt in the FPP series. In this step, the image series information is stored in Oracle Enterprise Manager.
EMCLI command format:
```
emcli db_software_maintenance  -setup -optInFPPSeries -input_file="data:<fileLocation>"
```
For more information about the db_software_maintenance verb, see db_software_maintenance in Command Line Interface Reference. For information about the setup parameter, see db_sm_setup(FPP) in Command Line Interface Reference.
Example input files that contains all the required information:
- Example input file for Database Node:
```
{    
"seriesId":"<Series ID>",   
"targetType":"host",    
"imageFile":"<imagefile.zip>",   
"patchManagerLocation":"<location of patch manager>",    
"currentVersionImageId":"<current image ID>"  
}
```
- Example input file for Switch:
```
{   
"seriesId":"<Series ID>",    
"targetType":"oracle_si_netswitch",    
"imageFile":"<imagefile.zip>",    
"currentVersionImageId":"<current image ID>"  
}
```
- Example input file for Storage Server:
```
{
"targetName": "<target name>",  
"targetType": "oracle_exadata" 
"patchManagerLocation":<full location path>.
}
```

For opt in REST API details, see Database Maintenance- Using Oracle Fleet Patching And Provisioning (FPP) REST Endpoints in REST API for Oracle Enterprise Manager.