Importing and making changes to resources in a single UOW

Use this procedure to manually import the current configuration for a resource into the database and make changes to it in a single unit of work (UOW).

Before you begin

Read the following information before beginning this procedure:

General information
- You should understand the meaning of the different categories of resources that Netcool Configuration Manager manipulates.
- The Netcool Configuration Manager allows both manual and automated initial input of your network resource information into the database.
  Note: If you have many resources to import, there is a separate command line BulkLoader utility available. This utility provides a way to automate the import of resources.
- The resource that you are importing and making changes to should have a state of staged, indicating that it has not yet been imported into the Netcool Configuration Manager database.
- If you import and make changes within the same UOW, the network resource cannot be rolled back correctly if an error occurs.
About importing and making changes to head end devices
- Importing a head end device on its own renders its associated vswitch (the managed device) stale. Thus, when importing an entire realm that contains head end devices and vswitches (managed devices), make sure to set the VTMOS filter in the Import Network Resource wizard.
  First, import the head end device. Then import the vswitches. This sequence assures that all configurations are current.

About this task

Follow these steps to manually import a resource into the database and make changes to the resource in a single UOW.

Procedure

Select the Resource Browser in the navigation tree.
Your resources display.
Select or Search for the network resources you want to import.
Note: The resource should have a state of “staged,” indicating that it has not yet been imported into the Netcool Configuration Manager database.
Click to highlight the desired resource, and then select Edit > Edit , or alternatively right click on the resource and select Edit.
The Configuration Editor displays a blank configuration.
Add the configuration information you want to be applied to the resource.
Save the new configuration (File > Save).
From the Configuration Editor, select File > Submit.
A dialog displays giving you several choices of how to handle the combined import/configuration change.

The Submit Configuration Change wizard displays the Configure Execution Options dialog, only if the support level of the configuration is SmartModel. If the support level is Standard, this dialog is not available. Use the following table as a guide to entering the appropriate information. After entering the requested information, click Next.

Table 1. Configure Execution Options dialog
Element	Description
Execution Mode
Execute Mode	Applies Config Change to the selected network resources.
Report Only Mode	Does not change resources but will run Compliance Checks only.
Pre-Emptive Compliance Options Note: These options are only available if the user is a member of a group with Pre-Emptive compliance activities.
Enable Pre-Emptive Compliance Checks	This option allows the user to disable Pre-Emptive validations only if the user's group has the 'Manage Work' activity. Users who do have this activity will not be able to change this setting.
Block Configuration Change if projected configuration contains compliance failures	If a compliance violation is found within the projected configuration then the configuration change will be blocked.
Block Configuration Change if projected configuration contains new compliance failures only	If a compliance violation is found within the projected configuration and the current configuration has no violations then the configuration change will be blocked. If both projected and current configurations have failures then the configuration change will not be blocked and changes will be made to the device.
Report Compliance Failure(s) only (Configuration change will not be blocked)	In execution mode 'execute' any compliance failure will be ignored and the changes will be applied to the device. In report only execution mode only the compliance checks will be run - the UOW finish after Pre-Emptive checks.

The Submit Configuration Change wizard displays the Password Override dialog. Use the following table as a guide to entering the appropriate information. After entering the requested information, click Next.

Table 2. Password Override dialog
Field	Definition
Override ITNCM Authentication	Select this check box to override the default authentication information.
Login Name	Provide the login name for the device you are accessing.
Password	Provide the password for the device you are accessing.
Enable Password	Provide the device enable password for the device you are accessing.
Only Use This Authentication	Select this check box if you will always use this authentication for your resource.

The Submit Configuration Change wizard displays the Config Change dialog. Use the following table as a guide to entering the appropriate information. After entering the requested information, click Next.

Table 3. Config Change dialog
Field	Definition
Force Directory Override	Make this selection to force the changes and override the database.
Disaster Recovery; Use Raw CLI	Provide the login name for the device you are accessing. Note: If you are submitting a standard config, this field must be selected in order to proceed. Until it is selected, the Next button is greyed out.

Only when submitting a draft configuration, the Submit Configuration Change wizard displays a second Config Change dialog. Use the following table as a guide to entering the appropriate information. After entering the requested information, click Next.

Table 4. Config Change (page 2 of 2) dialog
Field	Definition
Merge	Adds the config settings you have made to those currently on this network resource. Any settings currently on the Network Resource will remain intact.
Replace	Applies the changes required to make the configuration on the Network Resource the same as the configuration being submitted. Please be careful with this option as it may remove items off the Network Resource that are necessary for it to communicate.

The Submit Configuration Change wizard displays the Execution Priority dialog. By default, all UOWs are submitted with a priority of Medium. Select the appropriate radio button for the required execution priority and then click Next.

The Rollback Options window displays, only if the support level of the configuration is SmartModel. If the support level is Standard, this dialog is not available. A Rollback can be requested in the event of a configuration change failure. The Rollback can be carried out for a single configuration change, or multiple configuration change. Using the following table as a guide, please enter the appropriate information requested. Select Next to proceed.

Table 5. Rollback Options fields
Field	Definition
How should Rollback on configuration change failure be handled?
No Rollback	Select this to turn off the rollback option.
Rollback	Select this to activate the rollback option.
Reload the configuration and reboot the device	This option will load the original configuration and reboot the device.
Use Modeled Rollback	This option will enable a rollback to a modeled configuration.
Click here to have Rollbacks verified	Select this checkbox to enable rollback verification.

The Submit Configuration Change wizard displays the Schedule Work dialog. Select either immediate or scheduled execution. If you select scheduled execution, additional fields are displayed asking for the execution window. Provide the start date and time, and the end date and time for executing the work. From this dialog you can also specify a recurring schedule for the UOW.
After making your selections, click Next.
The Submit Configuration Change wizard displays the Describe Work dialog. Type a description for your work and click Finish.