Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All
     
     

    Device Library

    Understanding the Device Library

    You can manage the hardware vendor and hardware type using the Device Library. From the Device Library, you can do the following:

    • Add new hardware types.
    • Set images to use in the interfaces and topology map.
    • Create a template of the statements to be run before executing any CLI command from the Run CLI window.

    The CLI Template pane shows the file path to the template file used for CLI commands. Select Modify to change the CLI screen width used.

    To add a new hardware type, select Add. The New Hardware Type window is displayed. Select the vendor from the Vendor Family menu, type the name of the new hardware type, and select Save. To delete a hardware type, select the type and select Delete.

    The vendortemplatefile.csv file in the/u/wandl/db/config/ directory contains the mapping of vendor, command template, and icon used.

    Modifying a Web Image Icon

    To modify a Web image icon:

    1. Select Configuration > Device Library.

      The Device Library window is displayed. The Web Image pane shows the file path to the icon file for the device selected. Figure 1 shows the Device Library window.

      Figure 1: Device Library Window

      Device Library Window
    2. Select Modify to change the icon used for a node in IP/MPLSView.

      The Server File Browser window is displayed.

      • To display the contents of a sub-directory, double-click the directory name.
      • To return to the default directory, select the home icon.
      • To refresh the display, select the blue-circle icon.
      • To move up to the parent directory, select the up arrow icon.
    3. Browse for the icon image (for example, .gif file) to display, and click Select.

    Modifying the CLI Template

    To modify the CLI template:

    1. Select Configuration > Device Library.

      The Device Library window is displayed. The CLI Template pane shows the file path to the template file used for CLI commands. The files in this directory contain templates specifying which commands to issue immediately after logging in and before running any additional commands. Figure 1 shows the Device Library window.

    2. Select the desired Vendor Family and Hardware Type from the left pane.
    3. Click Modify to make changes to the CLI template displayed in the lower-right pane.

      The keywords and their meanings are provided in Table 1.

      Table 1: CLI Template Keywords

      Keyword

      Meaning/Usage

      @silent

      Do not capture terminal output from now on (until an !silent is issued).

      !silent

      Capture terminal output from now on (until an @silent is issued).

      @P

      Indicates that after the subsequent command is issued, the prompt on the device will change. This is needed in order to tell the program that the subsequent command has completed.

      !P

      Indicates that after the subsequent command is issued, the prompt on the device will remain the same.

      __COMMAND__

      This will be substituted with whatever command(s) a particular run CLI command includes.

      As an example, the following template says a) Do not capture the output after issuing the commands cli set terminal rows 0 and enable, b) Capture the output of the CLI command, and c) Do not capture the output of the exit command.

      @Silent
      cli set terminal rows 0
      enable
      !Silent
      __COMMAND__
      @Silent
      exit

      Corresponding Text Files


      Table 2 describes the corresponding text files that are modified by the changes in the Device Library graphical interface:

      Table 2: Text File Descriptions

      Item

      Description

      vendortemplatefile.csv

      (located in /u/wandl/db/config/) Contains a mapping of the vendor, command template, and icon used.

      hardwaretypemapping.csv

      (located in /u/wandl/db/config/) Contains a mapping of recognized device models with their vendors.

      template.vendor

      (located in /u/wandl/db/cmdtemplate/, one file per vendor; for example, template.cisco) Files specify which commands are issued on devices immediately after logging in, before any additional commands are run. A few reserved IP/MPLSView keywords are defined as described in Table 1.

    Adding a New Hardware Type

    To add a new node hardware type:

    1. Select Configuration > Device Library.

      The Device Library window is displayed.

    2. Select Add in the left pane.

      The New Hardware Type window is displayed. Figure 2 shows the New Hardware Type window.

      Figure 2: New Hardware Type

      New Hardware Type
    3. Select the vendor from the list, enter the hardware type, and click Save.
    4. (Optional) To delete a hardware type, select the hardware type and select Delete.
     
     

    Modified: 2016-09-26