valraid.exe

The valraid utility validates policy files against inventory files generated by the invraid utility.

valraid has two modes of operation:

Simulation mode

Used in simulation mode, valraid simulates the effect that a policy file would have on a RAID configuration if it were applied using the praid utility, which makes it useful for creating PRAID policy files. The policy files can be tested without running praid on the target system.

Check mode

Used in check mode, valraid determines whether the policy file specified matches the RAID configuration represented in the inventory file. This capability can be used in OS deployment scripts to skip the RAID configuration step if the controller is already configured with the required RAID configuration and thus avoiding an extra reboot before installing the OS. valraid will set the return code to 20 to indicate that the policy file does not match the configuration represented by the inventory file.

valraid usage

The two modes of operation share most parameters, but the syntax is mode-specific.

The simulation mode syntax is:
valraid /ini:input_inventory_file /inp:input_policy_file 
/outi:output_inventory_file /outp:output_policy_file 
/raid:/inifiles
The check mode syntax is:
valraid /c /ini:input_inventory_file /inp:input_policy_file /raid:/inifiles

The following examples illustrates valraid parameters and usage.

Table 1. valraid parameters
Parameter Description Example 
/ini:input_inventory_file
  • Specifies the input inventory file.
  • To generate the inventory file, run invraid against a target system.
 
valraid 
/ini:myfile.inv
/inp:policy.ini
/outi:newfile.inv
/outp:newpolicy.ini
/raid:/inifiles
 
/inp:input_policy_file
 Specifies the input policy file. 
valraid 
/ini:myfile.inv
/inp:policy.ini
/outi:newfile.inv
/outp:newpolicy.ini
/raid:/inifiles
 
/outi:output_inventory_file
  • This option is valid only for simulation mode.
  • Specifies the file name for the output inventory file.
  • The inventory file represents the RAID configuration that results from using the praid utility to apply input_policy_file to the system described in input_inventory_file.
 
valraid 
/ini:myfile.inv
/inp:policy.ini
/outi:newfile.inv
/outp:newpolicy.ini
/raid:/inifiles
 
/outp:output_policy_file
  • This option is valid only for simulation mode.
  • Specifies the file name for the output policy file.
  • The output policy file can be applied to a target system by using the praid utility.
 
valraid 
/ini:myfile.inv
/inp:policy.ini
/outi:newfile.inv
/outp:newpolicy.ini
/raid:/inifiles
 
/raid:inifiles
  • Specifies the directory that contains the RAID configuration .ini files.
  • The default is /opt/lnvgy/sgtk/sgdeploy/sgtklinux/.data/valraid
 
valraid 
/ini:myfile.inv
/inp:policy.ini
/outi:newfile.inv
/outp:newpolicy.ini
/raid:/inifiles
 
/c
  • Specifies check mode to compare the configuration from input_inventory_file to the configuration represented in input_policy_file.
  • The default is simulation mode.
 
valraid /c 
/ini:myfile.inv 
/inp:policy.ini
/raid:inifiles

Return codes

The valraid utility returns the following values to indicate status:
  • 0 - Success.
  • 1 - An error occurred while parsing the input policy file.
  • 2 - An error occurred while parsing the input inventory file.
  • 3 - The controller is not supported.
  • 4 - The RAID level is not supported.
  • 5 - The Stripe Size is not supported.
  • 6 - The number of arrays is not supported.
  • 7 - The number of drives in an array is not supported.
  • 8 - The number of logical volumes in an array is not supported.
  • 9 - There are not enough drives to create hotspare.
  • 10 - There are not enough drives of the same size.
  • 11 - An error occurred while opening the input policy file.
  • 12 - An error occurred while opening the input inventory file.
  • 13 - An error occurred while opening the output inventory file.
  • 14 - An error occurred while writing to the output inventory file.
  • 15 - An error occurred while opening the output policy file.
  • 16 - An error occurred while writing to the output policy file.
  • 17 - Partial drive sizing is not supported.
  • 18 - A command line syntax error occurred.
  • 19 - There is no policy match.
  • 20 - The controller is not configured, and it does not match the policy file.
Parent topic: ServerGuide Scripting Toolkit tools and utilities