CLI Guide

Table 5. Details of set (continued)
● <object> — Specifies the object name of the value that must be written.
● <index> — This option is specified where FQDD Aliases or Groups must be indexed.
● -f <filename> — Enables set to configure the device from a specified file. This option is not
supported in the Firmware RACADM interface.
● -u — Specifies user name of the CIFS remote share from which the file must be imported
● -p — Specifies password for the remote CIFS share from which the file must be imported.
● -l — Specifies network share location from where the file must be imported.
● -t — Specifies the file type to be imported.
The valid values are:
○ xml—Imports the Server Configuration Profile in XML format either from a local or network share
file.
○ JSON—Specifies a JSON file.
Staging and reboot control options
The following options control when and how system reboots are performed when using the –f option. As
noted above, some FQDDs require a system reboot to apply the new values; other FQDDs optionally support
immediate application of new values. If the imported file contains ONLY immediate application-capable
FQDDs such as iDRAC, do NOT use the –b option and the Set command will schedule a real-time job to
immediately apply the new values.
NOTE: The –b, -w, –s, and --preview options are applicable only with –f option.
● -b—Specifies the host shutdown type to run scheduled import job. The parameters are Graceful,
Forced, and NoReboot for graceful shutdown, forced shutdown, and no reboot respectively. If -b is
not specified, graceful shutdown is taken as the default except as noted above for files containing new
values for immediate application-capable <FQDD>s.
NOTE:
If the operating system is in use, then the graceful shutdown option may time out within
300 seconds. If this operation is unsuccessful, then retry with the force option.
● -w—Maximum time to wait for the graceful shutdown to occur. The value must be entered in seconds.
Minimum accepted value is 300 seconds and the maximum accepted value is 3600 seconds. The default
value is 1800 seconds.
● -s—Power state of the host when the import operation completes. The parameters are "On" for
powered ON and "Off" for powered OFF. If this parameter is not specified, power ON is taken as
default.
● --preview—Validates the configuration .xml file and view the status.
The --preview option provides the Job ID to verify the status of the file preview operation. The Job
ID can be tracked by running the racadm jobqueue view –I <JID> command.
NOTE:
○ The --preview option does not restart the system.
○ The-b,-w options cannot be included with the --preview option.
○ A scheduled job or pending configuration should not be running while using the --preview
option.
● -c—Specifies the FQDD or list of FQDDs separated by ',' of the components for which the
configurations should be imported. If this option is not specified, configuration related to all the
components are imported.
NOTE:
● To use the -c or --preview option, the minimum Lifecycle Controller version required is 1.2.
● On certain devices, importing the server configuration profile requires two imports to apply the
configuration to all the devices. The first import of the profile enables hidden devices which are
then configured with a second import. The devices that require two imports are as follows:
○ PERC S110 and PERC S130 controllers
○ PERC S110 and PERC S130 controllers
○ BIOS and PCIe device: enabling PCIe slots in the system that are disabled and configuring the
PCIe device
Running Get and Set 27