Creating an OS specification

Edit online

Create an OS specification by using the Select VTMOS screen.

About this task

To create a new OS specification, follow these steps.

Procedure

  1. From the ITNCM - Base Resource Browser, select FileNew > OS Specification. Alternatively, right-click within the Resource Browser, and choose New > OS Specification. The Select VTMOS screen is displayed. Note that the 1. Select VTMOS item is highlighted. Supply a name for the OS specification resource and the VTMOS for the device to be updated. Then click Next to continue. The following table describes each of the fields in the screen.
    OptionDescription
    Screen item Description
    Name:

    Specifies the name for this OS specification resource. For example, NewOS_Spec.

    Vendor:

    Specifies the vendor that corresponds to the vendor of the device to be updated. For example, Cisco.
    Type:

    Specifies the type that corresponds to the device to be updated. For example, Firewall.

    Model:

    Specifies the model that corresponds to the device to be updated. For example, 5*.

    OS:

    Specifies the operating system that corresponds to the device to be updated. For example, *.
  2. The Select OS Registry screen is displayed. Note that the 2. Select VTMOS item is highlighted. Select the correct OS Registry for use with the upgrade. Then click Next to continue.
  3. The OS Version to Upgrade to screen is displayed. Note that the 3. Select OS Version to Upgrade To item is highlighted. From the Target OS drop down menu, select the version to upgrade to. When the selection has been made, this will populate the OS Details information into the lower section of the screen. Click Next to continue.
  4. Because many network resources lack the disk space needed to load a new OS, the utility provides the opportunity to specify files to delete in order to free up space. The Select Files to be Removed screen is displayed. Note that the 4. Select Files to be Removed item is highlighted. To specify the files to delete:
    1. In Image Destination, select the target file system.
      Note: If the image file is in a subdirectory on the device, you will have created a File System Type with the full path of the subdirectory previously. You select that file system.
      CAUTION: The Erase All checkbox option when checked will erase the entire file system using the download section of the device script.
    2. To erase specific file systems, remove the check mark in the Erase All checkbox. In this case, the copydown section of the device script is used to erase the specified file system. If updating the device with the same OS image, the original image will automatically be removed and replaced by the selected target image.
    3. The Make Room On Destination option allows you to make additional room on the destination. In order to upload a new OS image to a network resource, it is sometimes necessary to clear up disk space. You can identify specific files to delete. Or, you can specify a wildcard (for example, *.bin) that recursively removes all files with a .bin extension.
    4. Click Next to continue.
  5. (Optional) The Select Boot Command Set screen is displayed. Note that the 5. Select Boot Command Set item is highlighted. It may be necessary to create a modelled command set to update the value of the configuration register on the device. Subsequently, a user can select this Command Set to modify boot parameters prior to reloading the new OS. Click Next to continue.
  6. The Select Parser screen is displayed. Note that the 6. Select Parser item is highlighted. Specify the parser to use for file system and memory checks. There are two choices: Device Content Parser (Default) and User Defined Parser (Advanced). The Device Content Parser is the ITNCM - Base parser installed with a driver. Alternatively, you can specify a user defined parser for unique cases where the ITNCM - Base parser does not work. The user defined parser can be manipulated using Regex.
  7. If you choose the User Defined Parser, the User Defined Parser screen is activated. Note that the 7. User Defined Parser item is highlighted. The User Defined Parser screen shows six keys for which a value must be returned. The keys for the OS Upgrade are: findcurrentOsImageName, findMemoryTotal, findfilesystemMemoryTotal, findSystemMemoryFree, findfilelist, and findfilesize. Each key of information can be retrieved by performing the relevant show command on a device. For example, the findMemoryTotal value can be returned on a CISCO device using the show version command and using this regular expression to extract the value '(\d+)K\/\d+K bytes of memory'. After updating any keys displayed in the User Defined Parser screen, click Next to continue.
  8. The Describe Work screen is displayed. Note that the 8. Describe Work item is highlighted. Use this screen to describe the OS Specification Resource, or to provide any comments.

Example

The following is an example of the download section of the device script (used when erasing an entire file system).

downLoad.01.send=copy tftp $copy_input2$\r

The following is an example of the copydown section of the device script (used when erasing a specific file system).

copyDown.01.send=copy ftp://
$ftp_altusername$:$ftp_altpassword$@$ftp_althostname$/
$ftp_altpath$/$copy_input1$ $copy_input2$\r

What to do next

To edit an OS specification, use the Edit OS Registry tabbed dialog.