nnmincidentcfgload.sh

Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

Network Node Manager i Software10.30

Name

nnmincidentcfgload.sh — load and validate formatted incident configuration files

SYNOPSIS

nnmincidentcfgload.sh { -load filename [-timeout timeout] [-memory memory] [-u <user name> -p <password>] [-jdniHost <host name> -jdniPort <port>] } { -validate filename [-timeout timeout] [-memory memory] [-u <user name> -p <password>] [-jdniHost <host name> -jdniPort <port>] } { -formats sourceFilename -formatd destinationFilename [-u <user name> -p <password>] [-jdniHost <host name> -jdniPort <port>] } { -expression expression }

DESCRIPTION

The nnmincidentcfgload.sh is used to load and validate incident configuration files. These configuration files must conform to the required tag format described in nnmincidentcfg.format for each configuration type.

Valid configuration types include the following:

*MgmtEventConfig
*PairwiseConfig 
*SnmpTrapConfig
*SyslogMessageConfig

Incident configurations must first have been created using the NNMi console or be loaded into the database using the nnmincidentcfg.sh command.

Before using the nnmincidentcfgload.sh command, do one of the following:

			
*Use the nnmincidentcfgdump.sh command to create a formatted file. Edit the incident configurations using the required format described in nnmincidentcfg.format.
*Use an editor to create the formatted file with all required tags and modifications using the format requirements described in nnmincidentcfg.format.

When using the nnmincidentcfgload.sh command, note the following:

*To avoid errors, if you need to edit complex incident configurations, use the nnmincidentcfg.sh command to create the formatted file rather than using a text editor.
*The content of the formatted file replaces the configurations that are stored in the NNMi database. 
*The nnmincidentcfgload.sh also re-formats the incident configuration file by inserting white space where needed to clarify the format hierarchy. This re-formatted file does not contain any original comments.

Parameters

nnmincidentcfgload.sh supports the following options:

-load <filename>: Loads the formatted incident configuration file you specify into the NNMi database. Invalid file formats are not loaded into the NNMi database. NNMi reports each validation error, including the line number and error.
-validate <filename>: Displays the line number and validation error for all errors encountered in the formatted incident configuration file you specify. It does not load the incident configurations into the NNMi database.
-formats <sourceFilename>: Formats the file you specify and writes the file to the filename specified using -formatd <destinationFilename>.
-formatd <destinationFilename>: Specifies the filename that will contain the formatted version of -formats <sourceFilename>.
-expression <expression>: Validates the specified expression.
-timeout <timeout>: Specifies the transaction time out in seconds that NNMi should use for the nnmincidentdump.sh command.
-memory <memory>: Specifies the maximum heap size in Megabytes (MB). The minimum <memory> value is 512 MB. The default <memory> value is 1536 MB.
-u <username>: Supply the NNMi administrator password to run the script.
-p <password>: Supply the NNMi administrator password to run the script.
-jndiHost <host name>: The server JNDI host. The default value is localhost.
-jndiPort <port>: The server JNDI port. The default value is 1099.

EXAMPLES

Load an incident configuration file:

nnmincidentcfgload.sh -load dumped-config.tag

Validate an incident configuration file:

nnmincidentcfgload.sh -validate modified-config.tag

Reformat an incident configuration file:

nnmincidentcfgload.sh -formats custom.tag -formatd formatted-output.tag

Validate an expression string:

nnmincidentcfgload.sh -expression "ciaName like \"whatTimeIsIt\""

The following example configuraton file contains all of the required tags for an incident configuration of type SnmpTrapConfig:

*ConfigurationType=SnmpTrapConfig
	*Name MinimalistTrapConfig
	*Oid .1.3.4.5.6
	-Author
		-Key com.customer.author
	-Category
		-Key com.hp.nms.incident.category.Fault
	-Family
		-Key com.hp.nms.incident.family.Node
	-MessageFormat Custom message format
	-Severity MINOR

The following example adds an action to the SNMP Trap Incident configuration:

*ConfigurationType=SnmpTrapConfig
	*Name MinimalistTrapConfig
	*Oid .1.3.4.5.6
	-Author
		-Key com.customer.author
	-Category
		-Key com.hp.nms.incident.category.Fault
	-ActionConfiguration
	    -Actions
	        -Action
                -Command echo "hello" > /tmp/hello.test
                -CommandType SCRIPT_OR_EXECUTABLE
                -LifecycleState InProgress
	-Family
		-Key com.hp.nms.incident.family.Node
	-MessageFormat Custom message format
	-Severity MINOR

AUTHOR

nnmincidentcfgload.sh was developed by Hewlett Packard Enterprise.

FILES

NNMi provides example configuration files and a description of the valid formats in the following directory:

/opt/OV/examples/nnm/incidentcfg