Solstice Enterprise Manager 4.1 Customizing Guide

Chapter 19

Nerve Center Utilities

Nerve Center templates, conditions, poll rates, and severities can be saved to an ASCII text file using the em_ncexport command-line utility. Templates, conditions, poll rates, and severities previously saved to an ASCII text file can be loaded into an MIS using the em_ncimport command-line utility

This chapter describes the following topic:

• Section 19.1 em_ncimport and em_ncexport

19.1 em_ncimport and em_ncexport

The em_ncimport and em_ncexport facilities are useful for:

• Replicating templates, or selected template components, from one MIS to another
• Storing several versions of the same template, or an entire Nerve Center template data

  Syntax:
  em_ncexport [-host <hostname>] [-file <filename>] [-help]
  [-template <template_name>] [-condition <condition_name>]
  [-pollrate <poll_rate_name>] [-severity <severity_name>]
  [-minimize] [-help]
  
  em_ncimport [-host <hostname>] [-file <filename>] [-template] [-help]
  [-pollrate] [-severity] [-condition] [-v]

19.1.1 Options

• -help--Displays help text.
• -host <hostname>--<hostname> is the name of machine with the target MIS for import or export. Default is localhost.
• -file <filename>--<filename> is name of file to export to or import from. Default is stdin for import, stdout for export.
• -template [<template_name>]--<template_name> is the name of the template to export. By default, all poll rates, severities, and conditions that are associated with the template are exported. Multiple template names can be listed if the list of names is surrounded by double quotes. If no name is specified, all templates are exported. For example:

  em_ncexport -t "IsSnmpSystemUp PingUpOrDown RouterIfStatus"

  Individual templates cannot be selected for import. The -template option imports all templates in the selected file.

• -condition [<condition_name>]--<condition_name> is the name of the condition to export. Multiple condition names can be listed if the list of names is surrounded by double quotes. If no name is specified, all conditions are exported.

  Individual conditions cannot be selected for import. The -condition option imports all conditions in the selected file.

• -pollrate [<poll_rate_name>]--<poll_rate_name> is the name of the poll rate to export. Multiple poll names can be listed if the list of names is surrounded by double quotes. If no name is specified, all polls are exported.

  Individual polls cannot be selected for import. The -pollrate option imports all poll rates from the selected file.

• -severity [<severity_name>]--<severity_name> is the name of the severity to export. Multiple severity names can be listed if the list of names is surrounded by double quotes. If no name is specified, all severities are exported.

  Individual severities cannot be selected for import. The -severity option imports all severities from the specified file.

• -verbose[-v]--Turns on verbose mode. Warnings are printed in addition to errors. For example, if a condition is a duplicate of one already in the MIS, this generates a warning. This option is not supported for export.
• -minimize--if specified, only the template is exported, and not the conditions, poll rates, or severities associated with it. This option is supported only for em_ncexport.

  ---

  Note – For em_ncexport, at least one of the following options must be specified: -template, -condition, -pollrate, -severity. em_ncimport can be used without any options being specified. If no options are specified, em_ncimport imports all components in the specified file.

  ---

19.1.2 Examples

Templates can also be piped to a printer. In the following example, the template IfUP from the remote MIS on machine bar is sent to the printer:

% em_ncexport -host bar -t IfUp -minimize | lp

Export all conditions from the default MIS to file myconditions:

% em_ncexport -f myconditions -c

Import all contents of the file mytemplates to the default MIS:

% em_ncimport -f mytemplates -t -c -p -s

Import only templates from the file templatelib:

% em_ncimport -f templatelib -t

Export all conditions from the machine bighost to the machine host2:

% em_ncexport -host bighost -c | em_ncexport -host host2 -c