Troubleshoot > HPE Service Manager Doctor > Configuration Validation Rules

Configuration Validation Rules

The following provides instructions about using configuration validation rules in the Service Manager Doctor tool.

Configuration rule file

Caution It is not recommended that you edit the configuration rule file manually in this version of the tool.

The configuration rule file is an XML file with predefined rules that are used to validate Service Manager server configurations. All configuration information is based on the sm.ini and sm.cfg files, where sm.cfg is prioritized higher than sm.ini.

The elements of the configuration rule file include source, domain, rule, condition, conditonrule, operation, and output. Configuration rules for all configurations should be defined within the configuration source. Configuration rules used for specific validation should be defined within a specific domain. There can be multiple domains within each source, and multiple rules within each domain. See Appendix C. Rule Configuration File Snippets.

Considerations for updating the rule file

  • This tool includes an SM_Configuration_Rule.xsd file to maintain the integrity of the rule file. Detailed messages are displayed in the validation results, including information about the row, column, and other violation specifics.
  • If one rule serves as a condition for another rule, the first rule cannot have conditions of its own. Or, a TWO_LEVEL_CONDITION_FOUND error is returned.
  • For operation elements within a rule element, the "param" and "action" attributes are required. The "target" and "type" attributes are optional, but they are mutually dependent. If one parameter is defined, you must define the other one too.
  • For condition elements, if "operator" and "target" are not defined, they default to and and true respectively.
  • In addition to customized rules, you can use the generic rules directly: is32OS, is64OS, isUnix, and isWindows.
  • An error 100018 is returned if the XML content cannot be parsed.
  • In the current version of the tool, only the configuration data source is editable, which includes both the sm.ini and sm.cfg files.

Validation results

Validation results are included as part of the command output for the conf -ini and conf -cfg commands in command-line mode. In GUI mode, a separate column is displayed next to the command results if a rule failure is detected.