Using the FoD Key on an IMM for a portable target system

The following procedure describes how to view the target system’s FoD information and how to install or uninstall the FoD license key(s) using in-band (IB) or out-of-band (OOB) mode.

Before you begin

The following prerequisites are necessary for this task:

The DSA Portable Edition is available on a removable medium (for example, a CD-ROM or USB key) as a self-extracting file.
The operating system on the target system is available for IB mode.
The operating system on a laptop is available for OOB mode.
DSA has internet access. The commands display_imm_available_fod and install_imm_fod require Internet access.

Procedure

Insert the removable medium with the DSA Portable Edition into the machine.
Start the DSA Portable Edition executable on the removable medium.
Enter the following command and parameters for DSA to get all of the available FoD features for the target system (IMM repository), and display them in the console with status:
```
DSA fod display_imm_available_fod --ibmid userid:password>, 
--host <userid:password@hostip:[port]> | 
```
Enter the following command with no parameters, and the unique identifier for specified FoD features on the local system. The FoD features are exported to the dsa_fod_ids.txt located in the DSA output folder. You can copy the FoD Identifier file to removable media such as a CD-ROM or USB key.
```
DSA fod export_imm_unique_ids
```
Enter the following command and parameters which indicate the remote key repository (IMM) and the default value for the local IMM device:
```
DSA fod report_imm_active_fod --host <[http(s)://userid:password@hostip:[port]>
```
The active FoD feature(s) for the key repository are displayed in the console.
Enter the following command and parameters to download specific keys for the corresponding FoD features from KMS that are installed on the target system (IMM repository).
```
DSA fod_install_imm_fod --ibmid userid:password>, 
--uid <unique_id>, --authcode <code>, --mt <machinetype>, 
--host <userid:password@hostip:[port]> 
```
The definitions of these parameters are:
--ibmid userid:password>

The IBM ID credential for the IBM website.

--uid <unique_id>

The unique identifier information of the FoD feature.

--authcode <code>

Authentication code for FoD features.

--mt <machinetype>

The machine type of target system (IMM).

--host <[http(s)://userid:password@hostip:[port]>

The remote key repository (IMM) and the default value for it is local IMM device.
Enter the following command and parameters to uninstall the FoD key from the target system (IMM repository).
```
DSAfod uninstall_imm_fod --keyid <keyid>| 
--host <[http(s)://userid:password@hostip:[port]> 
```
The definitions of these parameters are:
--keyid<Keyid>

This is obtained from the command DSAfod report_imm_active_fod.

--host <[http(s)://userid:password@hostip:[port]>

The remote key repository (IMM) and the default value for it is local IMM device.

Note: For multi-node systems, FoD support is only available for the node with the IMM IP address specified.
The parameter --host <userid:password@hostip:[port]> is the authorization information for the remote key repository (IMM). If this parameter is not specified, the local IMM device will be applied. The default value of IMM port is 5989.

If DSA failed to connect to the Baseboard Management Controller (BMC), the following error message is displayed: Failed to connect BMC, Error code = **.