Technical White Paper

16.17.1 Setting the Key-SetControllerKey()
The SetControllerKey() method sets the key on controllers that support encryption of the virtual
disks.
Invoke SetControllerKey() with the following parameters and syntax:
TARGET: This parameter is the FQDD of the DCIM_ControllerView (Section 16.7)
Key: Maximum size 32 characters
Keyid: Identifier, or description, for the key (maximum size 255 characters)
EXAMPLE:
wsman invoke -a SetControllerKey
http://schemas.dmtf.org/wbem/wscim/1/cimschema/
2/root/dcim/DCIM_RAIDService
?SystemCreationClassName=DCIM_ComputerSystem,
CreationClassName=DCIM_RAIDService,SystemName=DCIM:ComputerSystem,
Name=DCIM:RAIDService -h $IPADDRESS -V -v -c dummy.cert -P 443
-u $USERNAME -p $PASSWORD -J SetControllerKey.xml -j utf-8 -y basic
The input file SetControllerKey.xml is shown below:
<p:SetControllerKey_INPUT
xmlns:p="http://schemas.dmtf.org/wbem/wscim/1/cim-
schema/2/root/dcim/DCIM_RAIDService">
<p:Target>RAID.Integrated.1-1</p:Target>
<p:Key>abc123</p:Key>
<p:Keyid>keyid</p:Keyid>
</p:SetControllerKey_INPUT>
OUTPUT:
This method requires an H700 or H800 controller to properly function. Running this method on
older controllers may display this message:
<n1:SetControllerKey_OUTPUT>
<n1:Message>Controller is not security capable</n1:Message>
<n1:MessageID>STOR022</n1:MessageID>
<n1:ReturnValue>2</n1:ReturnValue>
</n1:SetControllerKey_OUTPUT>
16.17.2 Locking the Virtual Disk-LockVirtualDisk()
The LockVirtualDisk() method encrypts the virtual disk.
Note: The virtual disk must first exist for this method to be successful.
Invoke LockVirtualDisk() with the following parameters and syntax:
TARGET: This parameter is the FQDD of the target virtual disk
EXAMPLE:
wsman invoke -a LockVirtualDisk
http://schemas.dmtf.org/wbem/wscim/1/cimschema/