CiscoWorks Service Level Manager

• -h hostname
  Router's hostname.

  Note: This is the name used to telnet to the router (IP address in dotted notation is acceptable). It may or may not be the same as the name set by the "hostname" command in the router's configuration file.

• -p login_password
  Password to log in to the router.

• -u login_user_name
  User name to login to the router (for those routers that require both a username and a password to login (the line configuration command "login [local|tacacs] was used))

• -U enable_user_name
  username to enter privileged exec mode (for those routers that require both a username and a password to get into privileged mode). if not specified, the login_user_name will be used.

• -e enablepassword
  Password to enter privileged exec mode. If only password or enablepassword is specified, it will be used as both login and enable password.

• -c config filename
  Name of output file in which config information for the router should be saved. Allows a user to override our default behavior of saving config output in a file name same as the router hostname.

• -s suffix
  Suffix to be used with every output config file. Allows user to name output config files as,-confg OR anything they desire.

• -a ip_addr
  If telnet using hostname given by -h option failed, ip_addr will be used next to try telnet again. This is useful in cases where DNS or /etc/hosts is not properly set up. However, hostname is still used as output file name. If DNS fails the time_out parameter will need to be increased.

• -t time_out
  How long to wait for output from telnet to arrive. If omitted, a default value of 10 seconds is used.

• -n
  Use this option if neither username nor password is required to log in to the router. enable password may still be needed to enter privileged exec mode (no longer needed, maintained for compatability only)

• -f filename
  Name of a file containing hostnames, passwords, etc. of the routers whose configuration files to be retrieved.

The interface also allows users to export proposed configuration changes (via a delta configuration command file) after reaching a desired network configuration through "what-if" analysis within the NSM software. "Delta" files should be checked and confirmed by the user. They can then either be exported to the CiscoWorks database (Sybase) or through the database to the routers (with a copy of the new configuration file stored in Sybase).

In NSM 4.02 and later, the "Collect Cisco Configurations from Ciscoworks Host" wizard allows you to schedule the collection of router configuration files from hosts running CiscoWorks.

1. Did you press <return> when completing the source and destination directory fields? This must be done in order for the input to take effect.

2. Does the source directory contain Cisco router configuration files?

3. Do you have "write" permissions to the target directory?

4. Is there enough room on the partition?

NSM assumes that a router configuration file contains a "hostname" entry or an "interface" entry within the first 32,767 bytes. If not, the file is omitted during the creation of the new baseline.

1. In Netsys, select Open Baseline -> Routers -> Add.

2. In the dialog box that displays, specify the source directory and select the new configurations. If any of the configs match an existing configuration by filename (not hostname), you will be asked if you want to replace the old with the new.

The faster way to do this is to use the run_ngs executable and invoke the feature to update the baseline with configuration files from a specified directory. For example:

    run_ngs -baseline <baselineDir> -u <newConfigsDir> 

Here is the help output from run_ngs -h:

The u <dir> | -update_baseline <dir> [-no_case] command updates the baseline with configuration files from the given <dir>. If the -no_case option is specified, the file names specified are not case sensitive.

It is also important not to modify the actual files in the config directory. The only safe way to modify files in the config directory is through an editor started from within Cisco NSM.

Also, do not copy a new configuration file into the <baseline>/config directory, then attempt to import the configuration into the baseline because these configs are under SCCS control. If you want to add another configuration to the baseline:

1. Open the baseline

2. Select Open Baseline -> Routers -> Add to add a new configuration to the baseline.