Using the FoD Key on a CMM for a portable target system

The following procedure describes how to display the target system’s FoD information and how to install or uninstall the FoD license key(s) using 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 a laptop is available for OOB mode.
DSA has internet access. The commands report_cmm_active_fod, install_cmm_fod, and uninstall_cmm_fod require Internet access.

Procedure

Insert the removable medium with DSA Portable Edition into the laptop.
Start the DSA Portable Edition executable on the removable medium.
Enter the following command and parameters that indicate the remote key repository (CMM) and the default value for its local CMM device:
```
DSA fod report_cmm_active_fod --host <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 corresponding FoD features from KMS and installed on the target system (CMM repository):
```
DSA fod install_cmm_fod --ibmid userid:password> | 
--uid <unique_id> | --authcode <code> | --mt <machinetype> | 
--host <[http(s)://userid:password@hostip:[port]> 
```
The definitions of the 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 device (CMM).

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

The remote key repository (CMM).
Enter the following command and parameters to uninstall the FoD key from the target system (CMM repository):
```
DSA fod uninstall_cmm_fod --keyid <keyid> | 
--host <[http(s)://userid:password@hostip:[port]> 
```
The definitions of the parameters are:
--keyid<Keyid>

This is obtained from the command DSAfod_report_cmm_active_fod.

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

The remote key repository (CMM) and the default value for its local CMM device.

Note: The parameter --host <[http(s)://userid:password@hostip:[port]> is the authorization information for the remote key repository (CMM). http or https is the cim interface; the default is https. User ID, Password is for the device interface connection. The default value of CMM port is 5989.

If DSA failed to connect to CMM, the following error message is displayed: Failed to connect CMM, Error code = **.