The ovowserviceutil
tool allows command-line
management of services. Specific services and service sub-trees are
referred to in several different ways.
Services are referred to by service name and ID:
-service_name
)
Represents the Caption property of the OV_Service object that
uniquely identifies a service. The parameter should also include
the full hierarchy path. The path must always start with a single
backslash (\
), which denotes the Root.
\
)
only.-service_id
)
Represents the Name property of the OV_Service object that uniquely identifies a service. It is usually a GUID, but can also be any other unique string.
Service sub-trees are referred to by service name and ID:
-service_hierarchy_name
)
Same as -service_name
, except a whole tree of
services gets managed.
-service_hierarchy_id
)
Same as -service_id
, except a whole tree of
services gets managed.
ovowserviceutil [ -help ] [ -add_service -service_name <service path> [ -service_id <service id>] -service_type <service type> [ -virtual_service | -hosted_on_node <host node> | -hosted_on_nodegroup <host node group> ] ] [ -delete_service (-service_name <service path> | -service_id <service id>) ] [ -list_sub_services (-service_name <service path> | -service_id <service id>) [ -recursive] [-by_name | -by_id | -detailed] ] [ -list_antecedent_services (-service_name <service path> | -service_id <service id>) [-by_name | -by_id | -detailed] ] [ -rename_service (-service_name <service path> | -service_id <service id>) -new_name <new service caption> ] [ -set_service_calc_rule (-service_name <service path> | -service_id <service id>) -calc_rule <service calculation rule> ] [ -set_service_msg_prop_rule (-service_name <service path> | -service_id <service id>) -prop_rule <service propagation rule> ] [ -set_service_comp_prop_rule (-service_name <service path> | -service_id <service id>) -prop_rule <service propagation rule> (-child_service_name <child service path> | -child_service_id <child service id>) ] [ -set_service_depend_prop_rule (-service_name <service path> | -service_id <service id>) -prop_rule <service propagation rule> (-antecedent_service_name <dependant service path> | -antecedent_service_id <dependant service id>) ] [ -outage_service [-scheduled | -unplanned] [-service_name {<service name>} | -service_id {<service id> }] [-service_hierarchy_name {<service hierarchy name>} | -service_hierarchy_id {<service hierarchy id>}] -get [-single_line | -detailed | -show_outage_only] ] [ -outage_service [-scheduled | -unplanned ] [-service_name {<service name>} | -service_id {<service id> }] [-service_hierarchy_name {<service hierarchy name>} | -service_hierarchy_id {<service hierarchy id>}] (-on | -off | -toggle) [ -delete_msgs ] ] [ -add_dependency (-service_name <service path> | -service_id <service id>) (-antecedent_service_name <antecedent service path> | -antecedent_service_id <antecedent service id>) ] [ -delete_dependency (-service_name <service path> | -service_id <service id>) (-antecedent_service_name <antecedent service path> | -antecedent_service_id <antecedent service id>) ] [ -list_sub_service_types -service_type_name <service type path> [ -recursive] ] [ -list_antecedent_service_types -service_type_name <service type path> ] [ -set_service_type_calc_rule -service_type_name <service type path> -calc_rule <calculation rule> [ -set_service_type_msg_prop_rule -service_type_name <service type path> -prop_rule <propagation rule> [ -set_service_type_comp_prop_rule -service_type_name <service type path> -prop_rule <propagation rule> -child_service_type_name <child service type path> [ -set_service_type_depend_prop_rule -service_type_name <service type path> -prop_rule <propagation rule> -antecedent_service_type_name <antecedent service type path> [ -add_calc_rule -rule_name <new calculation rule name> [ -rule_id <propagation rule id>] [ -most_critical ] ] [ -add_calc_rule -rule_name <new calculation rule name> [ -rule_id <propagation rule id>] -single_threshold [ -by_percentage | -by_value ] [ -threshold <threshold value>] [ -set_to_value <severity>] ] [ -add_calc_rule -rule_name <new calculation rule name> [ -rule_id <propagation rule id>] -multi_threshold [ -by_percentage | -by_value ] [ -normal_threshold <threshold value>] [ -normal_set_to_value <severity>] [ -warning_threshold <threshold value>] [ -warning_set_to_value <severity>] [ -minor_threshold <threshold value>] [ -minor_set_to_value <severity>] [ -major_threshold <threshold value>] [ -major_set_to_value <severity>] [ -critical_threshold <threshold value>] [ -critical_set_to_value <severity>] [ -delete_calc_rule -rule_name <calculation rule name> ] [ -change_calc_rule -rule_name <new calculation rule name> [ -most_critical ] ] [ -change_calc_rule -rule_name <new calculation rule name> -single_threshold [ -by_percentage | -by_value ] [ -threshold <threshold value>] [ -set_to_value <severity>] ] [ -change_calc_rule -rule_name <new calculation rule name> -multi_threshold [ -by_percentage | -by_value ] [ -normal_threshold <threshold value>] [ -normal_set_to_value <severity>] [ -warning_threshold <threshold value>] [ -warning_set_to_value <severity>] [ -minor_threshold <threshold value>] [ -minor_set_to_value <severity>] [ -major_threshold <threshold value>] [ -major_set_to_value <severity>] [ -critical_threshold <threshold value>] [ -critical_set_to_value <severity>] [ -add_prop_rule -rule_name <new propagation rule name> [ -simple] [ -unchanged | -ignored | -fixed_as [<serverity>] | -relative [<relative>] ] ] [ -add_prop_rule -rule_name <new propagation rule name> -severity_based [ -unchanged | -ignored | -fixed_as [<serverity>] | -relative [<relative>] ] [ -prop_normal <propagation>] [ -prop_warning <propagation>] [ -prop_minor <propagation>] [ -prop_major <propagation>] [ -prop_critical <propagation>] ] [ -delete_prop_rule -rule_name <new propagation rule name> ] [ -change_prop_rule -rule_name <new propagation rule name> [ -simple] [ -unchanged | -ignored | -fixed_as [<serverity>] | -relative [<relative>] ] ] [ -change_prop_rule -rule_name <new propagation rule name> -severity_based [ -unchanged | -ignored | -fixed_as [<serverity>] | -relative [<relative>] ] [ -prop_normal <propagation>] [ -prop_warning <propagation>] [ -prop_minor <propagation>] [ -prop_major <propagation>] [ -prop_critical <propagation>] ]
-help
-add_service
-service_name <service path>
-service_id <service id>
-service_type <service type>
-virtual_service
-hosted_on <host node>
-hosted_on_nodegroup <host node group>
-delete_service
-service_name <service path>
-service_id <service id>
-list_sub_services
-service_name <service path>
-service_id <service id>
-recursive
-by_name
-by_name
, -by_id
, and
-detailed
are not specified.)-by_id
-detailed
-list_antecedent_services
-service_name <service path>
-service_id <service id>
-by_name
-by_name
, -by_id
, and
-detailed
are not specified.)-by_id
-detailed
-rename_service
-service_name <service path>
-service_id <service id>
-new_name <new service name>
<new service name>
does not have a hierarchy
path.) The Caption may not begin or end with a backslash
(\
). If Captions contain backslashes, they should be
escaped with additional backslashes (for example,
\\
).-set_service_calc_rule
-service_name <service path>
-service_id <service id>
-calc_rule <service calculation rule>
-set_service_msg_prop_rule
-service_name <service path>
-service_id <service id>
-prop_rule <service propagation rule>
-set_service_comp_prop_rule
-service_name <service path>
-service_id <service id>
-prop_rule <service propagation rule>
-child_service_name <child service path>
-child_service_id <child service id>
-set_service_depend_prop_rule
-service_name <service path>
-service_id <service id>
-prop_rule <service propagation rule>
-antecedent_service_name <dependant service
path>
-antecedent_service_id <dependant service
id>
-outage_service
-scheduled
-unplanned
-service_name {<service name>}
-service_id <service id>
-service_hierarchy_name <service hierarchy
name>
-service_hierarchy_id <service hierarchy id>
-on
-off
-toggle
-get
-scheduled
or
-unplanned
) is defined, the outage states of both
modes are returned.-delete_msgs
-service_name, -service_id, -service_hierarchy_name,
-service_hierarchy_id
-detailed
-single_line
-show_outage_only
-add_dependency
-service_name <service path>
-service_id <service id>
-antecedent_service_name <dependant service
path>
-antecedent_service_id <dependant service
id>
-delete_dependency
-service_name <service path>
-service_id <service id>
-antecedent_service_name <antecedent service
path>
-antecedent_service_id <antecedent service
id>
-list_sub_service_types
-service_type_name <service type path>
-recursive
-list_antecedent_service_types
-service_type_name <service type path>
-set_service_type_calc_rule
-service_type_name <service type path>
-calc_rule <calculation rule>
-set_service_type_msg_prop_rule
-service_type_name <service type path>
-prop_rule <service propagation rule>
-set_service_type_comp_prop_rule
-service_type_name <service type path>
-prop_rule <service propagation rule>
-child_service_type_name <child service type
path>
-set_service_type_depend_prop_rule
-service_type_name <service type path>
-prop_rule <service propagation rule>
-antecedent_service_type_name <antecedent service type
path>
-add_calc_rule
-rule_name <new calculation rule name>
-rule_id <propagation rule id>
-most_critical
-single_threshold
-multi_threshold
-by_percentage
-by_value
-threshold <threshold value>
-set_to_value <severity>
-normal_threshold <threshold value>
-normal_set_to_value <severity>
-warning_threshold <threshold value>
-warning_set_to_value <severity>
-minor_threshold <threshold value>
-minor_set_to_value <severity>
-major_threshold <threshold value>
-major_set_to_value <severity>
-critical_threshold <threshold value>
-critical_set_to_value <severity>
-delete_calc_rule
-rule_name <new calculation rule name>
-change_calc_rule
-rule_name <calculation rule name>
-most_critical
-single_threshold
-multi_threshold
-by_percentage
-by_value
-threshold <threshold value>
-set_to_value <severity>
-normal_threshold <threshold value>
-normal_set_to_value <severity>
-warning_threshold <threshold value>
-warning_set_to_value <severity>
-minor_threshold <threshold value>
-minor_set_to_value <severity>
-major_threshold <threshold value>
-major_set_to_value <severity>
-critical_threshold <threshold value>
-critical_set_to_value <severity>
-add_prop_rule
-rule_name <new propagation rule name>
-simple
-severity_based
-unchanged
-ignored
-fixed_as <severity>
-relative <relative>
-prop_normal <propagation>
-prop_warning <propagation>
-prop_minor <propagation>
-prop_major <propagation>
-prop_critical <propagation>
-delete_prop_rule
-rule_name
-change_prop_rule
-rule_name <propagation rule name>
-simple
-severity_based
-unchanged
-ignored
-fixed_as <severity>
-relative <relative>
-prop_normal <propagation>
-prop_warning <propagation>
-prop_minor <propagation>
-prop_major <propagation>
-prop_critical <propagation>
ovowserviceutil -add_service -service_name
\Applications\Service1 -service_type "\Application Services"
-virtual_service
ovowserviceutil -add_service -service_name
\Applications\Service1 -service_id Service1_ID -service_type
"\Application Services" -hosted_on_node \node1
ovowserviceutil -add_service -service_name
\Applications\Service1 -service_id Service1_ID -service_type
"\Application Services" -hosted_on_nodegroup \nodegroup1
ovowserviceutil -delete_service -service_name
\Applications\Service1
ovowserviceutil -delete_service -service_id
Service1_ID
ovowserviceutil -list_sub_services -service_name
\Applications\Service1
ovowserviceutil -list_sub_services -service_id
Service1_ID -recursive
ovowserviceutil -list_antecedent_services -service_name
\Applications\Service1
ovowserviceutil -list_antecedent_services -service_id
Service1_ID
ovowserviceutil -rename_service -service_name
\Applications\Service1 -new_name Service2
ovowserviceutil -rename_service -service_id Service1_ID
-new_name Service2
ovowserviceutil -set_service_calc_rule -service_name
\Applications\Service1 -calc_rule rule_name1
ovowserviceutil -set_service_calc_rule -service_id
Service1_ID -calc_rule rule_name1
ovowserviceutil -set_service_msg_prop_rule -service_name
\Applications\Service1 -prop_rule rule_name1
ovowserviceutil -set_service_msg_prop_rule -service_id
Service1_ID -prop_rule rule_name1
ovowserviceutil -set_service_comp_prop_rule -service_name
\Applications\Service1 -prop_rule rule_name1 -child_service_name
\Applications\Service1\SubService1
ovowserviceutil -set_service_comp_prop_rule -service_id
Service1_ID -calc_rule rule_name1 -child_service_id
SubService1_ID
ovowserviceutil -set_service_depend_prop_rule
-service_name \Applications\Service1 -prop_rule rule_name1
-antecedent_service_name \Applications\Service2
ovowserviceutil -set_service_depend_prop_rule -service_id
Service1_ID -prop_rule rule_name1 -antecedent_service_name
\Applications\Service2
ovowserviceutil -outage_service -service_name
\Applications\Service1 \Applications\Service2 -scheduled -off
-delete_msgs
ovowserviceutil -outage_service -service_hierarchy_name
\Applications\Service1 -unplanned -on -delete_msgs
ovowserviceutil -outage_service -service_name
\Applications\Service1 -scheduled -get
ovowserviceutil -outage_service -service_hierarchy_id
Service1_ID -unplanned -get
ovowserviceutil -add_dependency -service_name
\Applications\Service1 -antecedent_service_name \Service2
ovowserviceutil -add_dependency -service_ID Service1_ID
-antecedent_service_id Service2_ID
ovowserviceutil -delete_dependency -service_name
\Applications\Service1 -antecedent_service_name \Service2
ovowserviceutil -delete_dependency -service_ID
Service1_ID -antecedent_service_id Service2_ID
ovowserviceutil -add_calc_rule -rule_name CalcRule1
-most_critical
ovowserviceutil -add_calc_rule -rule_name CalcRule2
-single_threshold -by_percentage -threshold 0.66 -set_to_value
Minor
ovowserviceutil -add_calc_rule -rule_name CalcRule3
-multi_threshold -by_percentage -warning_threshold 0.3
-major_threshold 0.66 -major_set_to_value Major
ovowserviceutil -delete_calc_rule -rule_name
CalcRule1
ovowserviceutil -change_calc_rule -rule_name CalcRule1
-most_critical
ovowserviceutil -change_calc_rule -rule_name CalcRule2
-single_threshold -by_percentage -threshold 0.66 -set_to_value
Minor
ovowserviceutil -change_calc_rule -rule_name CalcRule3
-multi_threshold -by_percentage -warning_threshold 0.3
-major_threshold 0.66 -major_set_to_value Major
ovowserviceutil -add_prop_rule –rule_name PropRule1
-simple -fixed_as Minor
ovowserviceutil -add_prop_rule –rule_name PropRule1
-severity_based -unchanged -prop_minor Unchanged –prop_major
Incr1
ovowserviceutil -delete_prop_rule -rule_name
PropRule1
ovowserviceutil -change_prop_rule -rule_name PropRule1
-simple -fixed_as Minor
ovowserviceutil -change_prop_rule -rule_name PropRule1
-severity_based -unchanged -prop_minor Unchanged –prop_major
Incr1
ovowserviceutil -list_sub_service_types
-service_type_name "\System Infrastructure\SystemServices"
ovowserviceutil -list_sub_service_types
-service_type_name "\System Infrastructure\SystemServices"
-include_SPI_service_types -recursive
ovowserviceutil -list_antecedent_service_types
-service_type_name "\System Infrastructure\SystemServices"
ovowserviceutil -list_antecedent_service_types
-service_type_name "\System Infrastructure\SystemServices"
-recursive
ovowserviceutil -rename_service_type -service_type_name
"\System Infrastructure\ServiceType1" -new_name ServiceType2
ovowserviceutil -rename_service_type -service_type_name
"\System Infrastructure\ServiceType1" - new_id
ServiceType2_ID
ovowserviceutil -set_service_type_calc_rule
-service_type_name "\System Infrastructure\ServiceType1" -calc_rule
rule_name1
ovowserviceutil -set_service_type_msg_prop_rule
-service_type_name "\System Infrastructure\ServiceType1" -prop_rule
rule_name1
ovowserviceutil -set_service_type_comp_prop_rule
-service_type_name "\System Infrastructure\ServiceType1" -prop_rule
rule_name1 -child_service_type_name "\System
Infrastructure\ServiceType1\SubServiceType1"
ovowserviceutil -set_service_type_depend_ prop_rule
-service_type_name "\System Infrastructure\ServiceType1" -prop_rule
rule_name1 antcedent_service_type_name "\System
Infrastructure\ServiceType2"