Table Of Contents
Managing Jobs
Using Job Browser
Configuring Default Job Policies
Defining the Default Job Policies
Configuring NetShow Job Policies
Defining Default Job Policies
Purging Configuration Management Jobs
Defining Protocol Order
Masking Credentials
Enabling Approval and Approving Jobs Using Job Approval
Job Approval Workflow
Specifying Approver Details
Creating and Editing Approver Lists
Assigning Approver Lists
Setting Up Job Approval
Approving and Rejecting Jobs
Using Device Selector
Using Simple Search
Using Advanced Search
Using the All Tab
Using the Search Results Tab
Using the Selection Tab
Editing Device Attributes
Attribute Error Report
Device Attributes Export File Format
Managing Jobs
In LMS 4.1, there is a Job Browser which enables you to view the status of all the LMS admin-related Jobs.
LMS applications, such as NetConfig, Config Editor, Archive Management, and Software Management allow you to schedule jobs to perform their tasks. Job Approval allows you to require that one of a group of users designated as job Approvers approves each job before it can run.
This section contains the following:
•
Using Job Browser
•
Configuring Default Job Policies
•
Configuring NetShow Job Policies
•
Enabling Approval and Approving Jobs Using Job Approval
•
Job Approval Workflow
•
Using Device Selector
Using Job Browser
In LMS 4.1, there is a Job Browser which enables you to view the status of all the LMS admin-related Jobs.
The job details that you can view here include the job ID, the job type, the job status, the job description, the job owner, the time the job is scheduled to run at, the time of job completion, and the schedule type.
To open the job browser, select Admin > Jobs > Browser.
The Job Browser appears.
Table 12-1 displays the fields in the LMS Job Browser.
Table 12-1 LMS Job Browser
Column
|
Description
|
Job ID
|
Unique number assigned to this task at creation time. This number is never reused. There are two formats:
• Job ID:
Identifies the task. This does not maintain a history. For Example:1001
• JobID.Instance ID:
Here, in addition to the task, the instance of the task can also be identified. For example: 1001.1, 1001.2
|
Type
|
Type of job. The jobs include User Tracking jobs, LMS reports, Inventory Collection, Identity provisioning, Identity monitoring and so on.
|
Run Status
|
Job states include:
• Running
• Waiting for approval
• Scheduled (pending)
• Succeeded
• Succeeded with Info
• Failed
• Crashed
• Cancelled
• Suspended
• Rejected
• Missed Start
• Failed at Start
Select a job state from the Run Status drop-down list box to view the details of the all jobs that match the job state.
If there are no jobs with any of these job states, the Run Status drop-down list box will not display the respective job state.
|
Sched Type
|
Frequency of the job. This can be:
• Once
• Immediate
• Periodic (calendar/time based).
|
Description
|
Description of the job.
|
Run Sched
|
Schedule details of the job.
|
Status
|
Provides the status of the current jobs. The status of the current jobs is displayed as succeeded or failed. It also displays the failure reasons.
|
Owner
|
Username of the job creator.
|
Scheduled At
|
Date and time at which the job was scheduled.
|
Completed At
|
Date and time at which the job was completed.
|
Filtering Jobs
You can filter the jobs by any specified criteria using the Filter by drop-down list. Select your criteria, enter the corresponding value in the text box next to the drop-down list and click Filter. The jobs pertaining to that category are displayed.
Column
|
Description
|
All
|
Displays all jobs in Job Browser.
This is the default filter type.
|
Job ID
|
Unique ID of the job. For example, 1007.0.
Job IDs have N.x format, where x stands for the number of instances of that job.
For example, 1007.4 indicates that the Job ID is 1007 and it is the fifth instance of that job.
You should enter a valid Job ID as filter value. You can also:
• Enter multiple Job IDs separated by commas
• Include the wildcard character * (asterisk) in the Job ID value
• Enter a range of Job IDs
Examples of valid Job IDs are:
• 1002
• 1010.5
• 1004,1008.8, 1004
• 1007*
• 1001-1010
• 1019.20-1019.100
|
Type
|
Type of job. The jobs include User Tracking jobs, LMS reports, Inventory Collection, Identity provisioning, Identity monitoring and so on.
Filters and displays all jobs that match a job type value in Job Browser.
You must select a job type from the list of available types.
|
Run Status
|
Job states include:
• Running
• Waiting for approval
• Scheduled (pending)
• Succeeded
• Succeeded with Info
• Failed
• Crashed
• Cancelled
• Suspended
• Rejected
• Missed Start
• Failed at Start
Select a job state from the Run Status drop-down list box to view the details of the all jobs that match the job state.
If there are no jobs with any of these job states, the Run Status drop-down list box will not display the respective job state.
|
Sched Type
|
Frequency of the job. This can be:
• Once
• Immediate
• Periodic (calendar/time based).
|
Description
|
Description of the job.
Filters and displays all jobs with a specified description.
You cannot leave the description field blank when you select this filter type.
|
Owner
|
Username of the job creator.
Filters and displays all jobs that are scheduled by a user.
You can select a user from the drop-down list of users as a filter value.
|
Click the Refresh icon to refresh the job browser. Use the Stop and Delete buttons to stop or delete jobs:
•
Stop button—Stops or cancels a running job. You will be prompted to confirm the cancellation of the job. However, the job is stopped only after the devices currently being processed are successfully completed. This is to ensure that no device is left in an inconsistent state.
•
Delete button—Deletes the selected job from the job browser. You can select more than one job to delete. You will be asked to confirm the deletion.
Note
You cannot delete a running job.
Configuring Default Job Policies
Each Configuration Management job has properties that define how the job will run. You can configure a default policy for these properties that applies to all future jobs. You can also specify for each property whether users can change the default when creating a job.
You have the option of entering a username and password for running a specific Archive Management, Config Editor, NetConfig, or NetShow job.
If you enter a username and password, Archive Management, Config Editor, or NetConfig applications use this username and password to connect to the device, instead of taking these credentials from the Device and Credential Repository.
While the job is running, the password is retrieved from the Device and Credential Repository for each of the selected devices.
For example, if the TACACS server is managing the devices, the passwords in the TACACS server and the passwords in the Device and Credential Repository should be synchronized (with every password change).
This option of entering the username and password for running a job is useful in high security installations where device passwords are changed at frequent intervals. In such instances, the passwords may be changed every 60-90 seconds.
To use this option of entering a username and password for running a specific job, you should enable the job password policy for Archive Management, Config Editor, NetConfig, or NetShow jobs.
You can do this by using the Enable Job Password option in the Config Job Policies window.
If you have enabled Enable Job Password option, you can enter these credentials while scheduling a job:
•
Login Username
•
Login Password
•
Enable Password
This section also explains about Defining the Default Job Policies.
Defining the Default Job Policies
The following is the workflow for defining the default job policies for Configuration Management applications like NetConfig, ArchiveMgmt, ConfigEditor, Netshow:
Note
View Permission Report (Reports > System > Users > Permission) to check if you have the required privileges to perform this task.
Step 1
Select Admin > Network > Configuration Job Settings > Config Job Policies.
The Config Job Policies dialog box appears.
Step 2
Select one application from the drop-down list. You can select one of the following options:
•
NetConfig
•
ArchiveMgmt
•
ConfigEditor
•
Netshow
Step 3
Based on your selection, enter the following information:
Field Name
|
Description
|
Usage Notes
|
Failure Policy
|
Select what the job should do if it fails to run on the device. You can stop or continue the job, and roll back configuration changes to the failed device or to all devices configured by the job.
You can select one of the options:
• Stop on failure—Stops the job on failure.
• Ignore failure and continue—Continues the job on failure.
• Rollback device and stop—Rolls back the changes on the failed device and stops the job. This is applicable only to NetConfig application.
• Rollback device and continue—Rolls back the changes on the failed device and continues the job. This is applicable only to NetConfig application.
• Rollback job on failure—Rolls back the changes on all devices and stops the job. This is applicable only to NetConfig application.
Note This field appears only if you select either Config Editor or NetConfig application.
|
You can create rollback commands for a job in the following ways:
• Using a system-defined template.
Rollback commands are created automatically by the template.
The Banner system-defined template does not support rollback. You cannot create rollback commands using this template.
• Creating a user template.
Allows you to enter rollback commands into the template.
When you use the Adhoc and Telnet Password templates, you cannot create rollback commands.
|
E-mail Notification
|
Enter e-mail addresses to which the job sends messages at the beginning and at the end of the job.
You can enter multiple e-mail addresses separated by commas.
Configure the SMTP server to send e-mails in the View / Edit System Preferences dialog box (Admin > System > System Preferences).
We recommend that you configure the E-mail ID in the View / Edit System Preferences dialog box (Admin > System > System Preferences).
When the job starts or completes, an e-mail is sent with the E-mail ID as the sender's address.
|
Notification is sent when the job is started and completed.
Notification E-mails include a URL to enter to display job details. If you are not logged in, do so using log in panel.
|
Sync Archive before Job Execution
|
The job archives the running configuration before making configuration changes.
Note This field appears if you select either Config Editor or NetConfig application.
|
None.
|
Copy Running Config to Startup
|
The job writes the running configuration to the startup configuration on each device after configuration changes are made successfully.
Note This appears if you select either Config Editor or NetConfig application.
|
Does not apply to Catalyst OS devices.
|
Enable Job Password
|
The Job Password Policy is enabled for all the jobs.
The Archive Management, Config Editor, and NetConfig jobs use this username and password to connect to the device, instead of taking these credentials from the Device and Credential Repository.
These device credentials are entered while scheduling a job.
|
None.
You can use this option even if you have configured only the Telnet password (without configuring username) on your device.
You must enter a string in the Login Username field. Do not leave the Login Username field blank.
The Login Username string will be ignored while connecting to the device since the device is configured only for the Telnet password.
See Usage Scenarios When Job Password is Configured on Devices.
|
Fail on Mismatch of Config Versions
|
The job is considered a failure when the most recent configuration version in the configuration archive is not identical to the most recent configuration version that was in the configuration archive when you created the job.
Note This appears if you select either Config Editor or NetConfig application.
|
None.
|
Delete Config after download
|
The configuration file is deleted after the download.
Note This appears if you select Config Editor.
|
|
Execution Policy
|
Allows you to configure the job to run on multiple devices at the same time (Parallel execution) or in sequence (Sequential Execution).
|
If you select sequential execution, you can select Device Order in the Job Schedule and Options dialog box to set the order of the device.
1. Select a device in the Set Device Order dialog box.
2. Either:
• Click the Move Up or Move Down arrows to change its place in the order. Click Done to save the current order.
Or
• Close the dialog box without making any changes.
You cannot alter the device sequence for Archive Management application jobs such as Sync Archive, Check Compliance and Deploy, etc.
Sequential Execution is not supported for the following jobs:
• Manual Sync Archive
• Periodic Config Collection and Polling
• cwcli config get
|
User Configurable
|
Select this check box next to any field to make corresponding policy user configurable.
|
You can configure a user-configurable policy while defining job. You cannot modify non-user-configurable policies.
|
Step 4
Click Apply.
A message appears, Policy values changed successfully.
Step 5
Click OK.
Usage Scenarios When Job Password is Configured on Devices
The following tables list the usage scenarios and their implications for Configuration application when job password is configured on devices.
•
When Device Access is Only Through Job Password and No Access is Available Through Regular Telnet/SSH and SNMP (Read or Write)
•
When Devices are Configured for Job Password and Access is Available Through SNMP (Read or Write)
•
When Devices are not Configured for Job Password and Access is Available Through Regular Telnet/SSH but no SNMP
•
When Devices are not Configured for Job Password and Regular Telnet/SSH is Disabled. Access is Available Only Through SNMP (Read or Write)
Table 12-2 When Device Access is Only Through Job Password and No Access is Available Through Regular Telnet/SSH and SNMP (Read or Write)
Scenario
|
Archive Mgmt
|
cwcli config
|
NetConfig
|
Config Editor
|
Device is added into LMS
|
Fails
|
Not applicable
|
Not applicable
|
Not applicable
|
Update archive request through user interface
|
Fails
|
Not applicable
|
Not applicable
|
Not applicable
|
Update archive request through command line
|
Not applicable
|
Fails
|
Not applicable
|
Not applicable
|
Config update when Syslog message is received
|
Fails
|
Not applicable
|
Not applicable
|
Not applicable
|
Config update through periodic scheduled process
|
Fails
|
Not applicable
|
Not applicable
|
Not applicable
|
Config update through SNMP poller based scheduled process
|
Fails
|
Not applicable
|
Not applicable
|
Not applicable
|
Config upload/restore through cwcli config
|
Not applicable
|
Fails
|
Not applicable
|
Not applicable
|
NetConfig Job
|
Not applicable
|
Fails
|
Succeeds
|
Not applicable
|
Config Editor job
|
Not applicable
|
Not applicable
|
Not applicable
|
Succeeds
|
Table 12-3 When Devices are Configured for Job Password and Access is Available Through SNMP (Read or Write)
Scenario
|
Archive Mgmt
|
cwcli config
|
NetConfig
|
Config Editor
|
Device is added into LMS
|
Succeeds for SNMP supported devices
|
Not applicable
|
Not applicable
|
Not applicable
|
Update archive request through user interface
|
Succeeds for SNMP supported devices
|
Not applicable
|
Not applicable
|
Not applicable
|
Update archive request through command line
|
Succeeds for SNMP supported devices
|
Succeeds for SNMP supported devices
|
Not applicable
|
Not applicable
|
Config update when Syslog message is received
|
Succeeds for SNMP supported devices
|
Not applicable
|
Not applicable
|
Not applicable
|
Config update through periodic scheduled process
|
Succeeds for SNMP supported devices
|
Not applicable
|
Not applicable
|
Not applicable
|
Config update through SNMP poller based scheduled process
|
Succeeds for SNMP supported devices
|
Not applicable
|
Not applicable
|
Not applicable
|
Config upload/restore through cwcli config
|
Not applicable
|
Succeeds for SNMP supported devices
|
Not applicable
|
Not applicable
|
NetConfig Job
|
Not applicable
|
Fails
|
Succeeds
|
Not applicable
|
Config Editor job
|
Not applicable
|
Not applicable
|
Not applicable
|
Succeeds
|
Table 12-4 When Devices are not Configured for Job Password and Access is Available Through Regular Telnet/SSH but no SNMP
Scenario
|
Archive Mgmt
|
cwcli config
|
NetConfig
|
Config Editor
|
Device is added into LMS
|
Succeeds
|
Not applicable
|
Not applicable
|
Not applicable
|
Update archive request through user interface
|
Succeeds
|
Not applicable
|
Not applicable
|
Not applicable
|
Update archive request through command line
|
Succeeds
|
Succeeds
|
Not applicable
|
Not applicable
|
Config update when Syslog message is received
|
Succeeds
|
Not applicable
|
Not applicable
|
Not applicable
|
Config update through periodic scheduled process
|
Succeeds
|
Not applicable
|
Not applicable
|
Not applicable
|
Config update through SNMP poller based scheduled process
|
Succeeds
|
Not applicable
|
Not applicable
|
Not applicable
|
Config upload/restore through cwcli config
|
Succeeds
|
Succeeds
|
Not applicable
|
Not applicable
|
NetConfig Job
|
Not applicable
|
Not applicable
|
Succeeds
|
Not applicable
|
Config Editor job
|
Not applicable
|
Not applicable
|
Not applicable
|
Succeeds
|
Table 12-5 When Devices are not Configured for Job Password and Regular Telnet/SSH is Disabled. Access is Available Only Through SNMP (Read or Write)
Scenario
|
Archive Mgmt
|
cwcli config
|
NetConfig
|
Config Editor
|
Device is added into LMS
|
Succeeds for SNMP supported devices
|
Not applicable
|
Not applicable
|
Not applicable
|
Update archive request through user interface
|
Succeeds for SNMP supported devices
|
Not applicable
|
Not applicable
|
Not applicable
|
Update archive request through command line
|
Succeeds for SNMP supported devices
|
Succeeds for SNMP supported devices
|
Not applicable
|
Not applicable
|
Config update when Syslog message is received
|
Succeeds for SNMP supported devices
|
Not applicable
|
Not applicable
|
Not applicable
|
Config update through periodic scheduled process
|
Succeeds for SNMP supported devices
|
Not applicable
|
Not applicable
|
Not applicable
|
Config update through SNMP poller based scheduled process
|
Succeeds for SNMP supported devices
|
Not applicable
|
Not applicable
|
Not applicable
|
Config upload/restore through cwcli config
|
Succeeds for SNMP supported devices
|
Succeeds for SNMP supported devices
|
Not applicable
|
Not applicable
|
NetConfig Job
|
Not applicable
|
Fails
|
Fails
|
Not applicable
|
Config Editor job
|
Not applicable
|
Not applicable
|
Not applicable
|
Fails
|
Configuring NetShow Job Policies
Each NetShow job has properties that define how the job runs. You can configure a default policy for these properties that apply to all future jobs. For each job property you can specify whether users can change the default property when creating a job.
NetShow supports the following Job Policies:
•
Defining Default Job Policies
The default job policies that NetShow support are E-Mail Notification, Enable Job Password, and Execution Policy.
•
Purging Configuration Management Jobs
The Job Purge option provides a centralized location for you to schedule purge operations.
•
Defining Protocol Order
You can define the protocol order for NetShow through the Protocol Ordering option in the Config Management feature in LMS.
This section also gives details on Masking Credentials
Defining Default Job Policies
NetShow supports E-Mail Notification, Enable Job Password, and Execution Policy.
Note
View Permission Report (Reports > System > Users > Permission) to check if you have the required privileges to perform this task.
To define these default Job Policies:
Step 1
Select Admin > Network > Configuration Job Settings > Config Job Policies.
The Job Policy dialog box appears.
Step 2
Select NetShow from the Application drop-down list:
Step 3
Enter the following information in the Job Policy dialog box:
Field Name
|
Description
|
Usage Notes
|
E-mail Notification
|
Enter e-mail addresses to which the job sends messages at the beginning and at the end of the job.
You can enter multiple e-mail addresses separated by commas.
Configure the SMTP server to send e-mails in the View / Edit System Preferences dialog box (Admin > System > System Preferences).
We recommend that you configure the E-mail ID in the View / Edit System Preferences dialog box (Admin > System > System Preferences). When the job starts or completes, an e-mail is sent with the E-mail ID as the sender's address.
|
Notification is sent when job is started and completed.
Notification e-mails include a URL to enter to display job details. If you are not logged in, log in using the login panel.
|
Enable Job Password
|
The Job Password Policy is enabled for all the jobs.
NetShow jobs use this username and password to connect to the device, instead of taking these credentials from the Device and Credential Repository.
These device credentials are entered while scheduling a job.
|
You can use this option even if you have configured only the Telnet password (without configuring username) on your device.
You must enter a string in the Login Username field. Do not leave it blank.
The Login Username string is ignored while connecting to the device since the device is configured only for the Telnet password.
|
Execution Policy
|
Allows you to configure the job to run on multiple devices at the same time (Parallel Execution) or in sequence (Sequential Execution).
|
None.
|
Step 4
Click Apply.
A message appears, Policy values changed successfully.
Step 5
Click OK.
Purging Configuration Management Jobs
The Job Purge option provides a centralized location for you to schedule purge operations for certain Configuration Management jobs including NetShow jobs.
Select Admin > Network > Purge Settings > Config Job Purge Settings to invoke the Job Purge option.
The Job Purge window contains the following information:
Column
|
Description
|
Application
|
Lists the application for which the purge is applicable.
|
Status
|
Whether a purge job is enabled or disabled.
|
Policy
|
This value is in days. Data older than the specified value, will be purged. You can change this value as required. This is a mandatory field. The default is 180 days.
|
Job ID
|
Unique ID assigned to the job by the system, when the purge job was created. This Job ID does not change even if you disable or enable or change the schedule of the purge job.
For the Purge Now task, a Job ID is not assigned. Also, if a Job ID already exists for that application, this Job ID is not updated for the Purge Now tasks. That is, the job scheduled for purging is not affected by the Purge Now task.
|
Scheduled At
|
Date and time that the job was scheduled at. For example: Nov 17 2004 13:25:00.
|
Schedule Type
|
Specifies the type of schedule for the purge job:
• Daily—Daily at the specified time.
• Weekly—Weekly on the day of the week and at the specified time.
• Monthly— Monthly on the day of the month and at the specified time. (A month comprises 30 days).
|
To purge Configuration Management Jobs:
Step 1
Select Admin > Network > Purge Settings > Config Job Purge Settings.
The Job Purge dialog box appears. You can perform the following tasks in the Job Purge window:
Button
|
Description
|
Schedule
|
Schedule a job purging.
|
Enable
|
Enable a job for purging after you schedule it.
|
Disable
|
Disable the purge after enabling a job for purging.
|
Purge Now
|
Purge a job immediately.
|
Defining Protocol Order
You can define the protocol order for NetConfig, Archive Mgmt, Config Editor, and NetShow through the Protocol Ordering option in the Config Management feature in LMS.
Note
View Permission Report (Reports > System > Users > Permission) to check if you have the required privileges to perform this task.
To define the protocol order for NetShow:
Step 1
Select Admin > Collection Settings > Config > Config Transport Settings.
The Transport Settings dialog box appears.
Step 2
Select NetShow from the Application drop-down list:
Step 3
Select a protocol from the Available Protocols pane and click Add.
NetShow supports only Telnet and SSH.
If you want to remove a protocol or change the protocol order, you can remove the protocol using the Remove button and then add it again.
The protocols that you have selected appear in the Selected Protocol Order pane.
Step 4
Click Apply.
A message appears, New settings saved successfully.
Step 5
Click OK.
The protocol used for communicating with the device is based on the order in which the protocols are listed here.
Masking Credentials
You can mask the credentials shown in the output of show commands. If you want to mask the credentials of a particular command, you must specify the command in the NMSROOT\MDC\tomcat\webapps\rme\WEB-INF\classes\com\cisco\nm\rmeng\config\netshow\NSCredCmds.properties file.
In this file you can specify all the commands whose output should be processed to mask the credentials. We recommend that you enter the complete command in the file. For example, you must enter show running-config, not show run. This file contains some default commands like show running-config.
Enabling Approval and Approving Jobs Using Job Approval
LMS applications, such as NetConfig, Config Editor, Archive Management, and Software Management allow you to schedule jobs to perform their tasks. Job Approval allows you to require that one of a group of users designated as job Approvers approves each job before it can run.
See Job Approval Workflow for more information.
Job Approval sends job requests through e-mail to users on a job's Approver list. If none of the Approvers approve the job before its scheduled run time, or if an Approver rejects the job, the job is moved to the rejected state and will not run.
When Job Approval is enabled, applications that use it, require you to schedule the job to run in the future, rather than immediately. Job approval cannot be enabled for jobs that run immediately.
A user with the appropriate privileges uses a Cisco Prime application to schedule jobs.
When you use Job Approval, different people can perform different tasks:
Note
View the Permission Report (Reports > System > Users > Permission) to check whether you have the required privileges to perform job approval tasks.
Role
|
Responsibilities
|
System Administrator
|
Creates and maintains the Approver lists
|
Approver
|
Approves/rejects a job, or changes the schedule for a job.
|
To select the log level settings for the Job Approval application, select Admin > System > Debug Settings > Config and Image Management Debugging settings.
Job Approval is also referred to as Maker Checker in a few places within LMS. For example, in Loglevel Settings and Permission Report (Reports > System > Users > Permission) it is mentioned as Maker Checker.
Job Approval Workflow
A typical job approval workflow may look like this:
A system administrator does the following:
1.
Specifies user/Approver information (see Specifying Approver Details.)
2.
Creates one or more job Approver lists (see Creating and Editing Approver Lists).
3.
Assigns Approver lists (see Assigning Approver Lists).
4.
Sets up Job Approval (see Setting Up Job Approval).
The planner analyzes the network and prompts the network engineer to schedule a job to perform a needed network change.
The job creator uses a Cisco Prime application to create a job.The application must have an Approver list assigned to it before Job Approval is enabled. Also, it must be scheduled to run in the future (not immediately).
All Approvers on the Approver list receive an automatic email notification. The job Approvers approve or reject the job (see Approving and Rejecting Jobs) and give their comments.
The job creator and all Approvers on the Approver list receive an automatic e-mail notification.
A job that is not approved or rejected before its scheduled time is automatically moved to the Rejected state. E-mail notification is sent to all Approvers and the user who scheduled the job. If the job is approved, it runs as scheduled.
Specifying Approver Details
Use the option, Approver Details, to maintain information about users with Approver roles.
Note
View Permission Report (Reports > System > Users > Permission) to check if you have the required privileges to perform this task.
To specify Approver details:
Step 1
Select Admin > Network > Configuration Job Settings > Approver Details.
The Approver Details dialog box appears.
Step 2
Click Synchronize with Local User Database.
All the approvers in with valid E-mail IDs, will appear in theApprovers list. The E-mails of the approvers will be the same as that added in LMS.
(You can create a valid Cisco Prime user using the Local User Setup option under Admin > System > User Management > Local User Setup).
If you want to change the E-mail ID of any of the Approvers, select the Approver from the Approvers list, and change specifying the new e-mail ID in the E-mail Address field. You can add more than one e-mail, separated by commas
Step 3
Click Save to save your changes.
All approvers, have to be manually added to LMS.
To do this, enter the name of the Approver that you want to add in the New Approver field, enter a valid e-mail ID for that user in the E-mail Address field, and click Save.
The Approver that you added, appears in the Approvers box.
Creating and Editing Approver Lists
You can use the option Create/Edit Approver Lists to create, edit, or delete Approver lists. Before you create an Approver list, ensure that users have been added, through the Approver Details option (see Specifying Approver Details).
Note
View Permission Report (Reports > System > Users > Permission) to check if you have the required privileges to perform this task.
To create and edit Approvers lists:
Step 1
Select Admin > Network > Configuration Job Settings > Create/Edit Approver Lists.
The Create/Edit Approver List dialog box appears.
Step 2
Go to the Approver List field and enter a name for an Approver list that you are creating. It can be an alphanumeric name.
Step 3
Click Add.
A message appears:
List Listname has no users. To save the list successfully, add users and click Save.
Step 4
Click OK to proceed.
The newly-created list appears in the lists box.
(If previously-created lists exist, you can highlight a list to see the List Members in the Users group of fields.)
Step 5
Add users to the newly-created list, by highlighting the list.
In the Users group of fields, the Available Users box lists users who have Approver permissions. Only these users can be added to Approver lists to approve jobs.
•
To add a user to the Approver List, select the name from the Available Users list box, and click Add.
The name appears in the List Members list box.
•
To remove a user from the Approver list, select the name from the List Members list box, then click Remove.
The name is removed from the List Members list box.
Step 6
Click Save.
The Approver Lists box displays the name of the new Approver list and the users on this list appear in the box below Approver Lists.
To edit an Approver List:
a.
Select the list.
The approvers of the list appear in the List Members list box.
b.
Add new approvers, or remove existing ones in using the Add and Remove buttons in the Users group of fields.
To delete an Approver List:
a.
Select the list.
b.
Click Delete.
A message appears:
Are you sure you wish to delete? Approval will be disabled for applications to which the Listname is assigned!
c.
Click OK to delete the list.
Assigning Approver Lists
You can assign an Approver list to each of the LMS applications, from the available Approver lists.
Note
View Permission Report (Reports > System > Users > Permission) to check if you have the required privileges to perform this task.
To assign an Approver list:
Step 1
Select Admin > Network > Configuration Job Settings > Assign Approver Lists.
The Assign Approver Lists dialog box appears.
Step 2
Select the required Approver list from the drop-down list box for that application. Repeat this for each of the applications listed here.
Step 3
Click Assign.
The selected Approver lists are assigned to the applications.
Setting Up Job Approval
The Approval Policies dialog box allows you to set up Job Approval for all applications for which you can set up job approval. The applications are:
•
NetConfig
•
NetShow
•
Config Editor
•
Archive Management. See Using Job Approval for Archive Management for details.
•
Software Management. See Using Job Approval for Software Management for details
Prerequisite
Make sure the approver list is assigned to the application, before you enable approval for the application.
Note
View the Permission Report (Reports > System > Users > Permission) to check whether you have the required privileges to perform this task.
To set up Job Approval:
Step 1
Select Admin > Network > Configuration Job Settings > Approval Policies.
The Approval Policies dialog box appears. You can enable or disable Job Approval for the following applications:
•
NetConfig
•
NetShow
•
Config Editor
•
Archive Management.
•
Software Management.
Step 2
Set up Job Approval for the various applications that support job approval, by doing one of the following:
•
Select the Enable check box that corresponds to an application, to enable Job Approval.
•
Deselect the Enable check box that corresponds to an application, to disable Job Approval.
•
Select the All check box to enable Job Approval, for all applications to which it is applicable.
•
Deselect the All check box to disable Job Approval, for all applications to which it is applicable.
Step 3
Click Apply to apply your changes.
After you enable Job Approval, two additional fields appear in the job schedule wizard of the applications. These are:
•
Maker Comments—Job creator's comments.
•
Maker E-mail—Job creator's e-mail address.
Using Job Approval for Archive Management
You can enable Job Approval for Archive Management tasks, (Admin > Network > Configuration Job Settings > Approval Policies). This means all jobs require approval before they can run.
Only users with Approver permissions can approve Archive Management jobs. Jobs must be approved before they can run if Job Approval is enabled on the system.
For more details on enabling job approval see Setting Up Job Approval.
The following Archive Management tasks require approval if you have enabled Job Approval:
Out-of-Sync (Configuration > Compliance > Out-of-Sync Summary)
Sync Archive jobs do not have Job Approval enabled because this job only archives the configuration from the device and there is no change to the device configuration.
If you have enabled Approval for Archive Management tasks, these options appear in the Job Schedule and Options dialog box:
•
Approval Comment—Approval comments for the job approver.
•
Maker E-Mail—E-mail-ID of the job creator.
Using Job Approval for Software Management
You can enable Job Approval for Software Management tasks, (Admin > Network > Configuration Job Settings > Approval Policies) which means all jobs require approval before they can run.
Only users with Approver permissions can approve Software Management jobs. Jobs must be approved before they can run if Job Approval is enabled on the system.
The following Software Management tasks require approval if you have enabled Job Approval:
•
Adding images to Software Repository (Configuration > Tools > Software Image Management > Software Distribution) using:
–
Cisco.com
–
Device
–
URL
–
Network
•
Distribution software images (Configuration > Tools > Software Image Management > Software Distribution) using any one of these methods:
–
Distributing by Devices [Basic]
–
Distributing by Devices [Advanced]
–
Distributing by Images
–
Remote Staging and Distribution
If you have enabled Approval for Software Management tasks, then in the Job Schedule and Options dialog box, you get these two options:
•
Maker Comments—Approval comments for the job approver.
•
Maker E-Mail—E-mail ID of the job creator.
Approving and Rejecting Jobs
Use the Approve or Reject Jobs option to approve or reject a job for which you are an Approver. The job will not run until you or another Approver approves it. If no Approver approves the job by its scheduled run time, or an Approver rejects it, the job is moved to the rejected state and will not run.
For periodic jobs, only one instance of the job needs to be approved. If one instance is approved all other instances are considered approved, and vice-versa.
When a job for which you are an Approver is created, you are notified by email.
An Approver can edit the job schedule at the time of approving the job.
The e-mail displays these details:
Details
|
Description
|
Job ID
|
ID of the job that has been put up for approval.
|
Job Description
|
Description of the job.
|
Job Schedule
|
Date and time for which the job has been scheduled.
|
Server Name
|
Name of the server.
|
Server Time-zone:
|
Time zone of the server.
|
Maker Comments
|
Comments for the Approver, entered by the job creator.
|
URLS
|
Two URLs to launch dialog boxes for:
• Viewing job details.
• Approving or rejecting jobs.
|
View the Permission Report (Reports > System > Users > Permission) to check whether you have the required privileges to perform this task. You need to be a user with an Approver role.
Note
You will be able to select only those jobs for which you are a part of the Approver List. The other jobs, for which you are not a part of the Approver List, will be disabled.
To approve or reject jobs:
Step 1
Select Admin > Jobs > Approval.
The Jobs Pending Approval dialog box appears with the following information about the scheduled jobs on the system:
Column
|
Description
|
Job ID
|
Unique number assigned to the job when it is created.
For periodic jobs such as Daily, Weekly, etc., the job IDs are in the number.x format. The x represents the number of instances of the job. For example, 1001.3 indicates that this is the third instance of the job ID 1001.
Click the Job ID hyperlink to view the details of the job.
|
Owner
|
Job owner.
|
Job Type
|
Application that registered job.
|
Scheduled to Run at
|
When job is scheduled to run.
|
Approver List
|
Name of Approver list whose members can approve job.
|
Description
|
Job description, entered by job creator.
|
You can filter the pending jobs by any specified criteria using the Filter By drop-down list. Select your criteria and click Filter.
Step 2
Either:
•
Select the job and click Approve to approve the job.
The job is approved.
Or
•
Select Next.
The Job Details dialog box appears (For example, if the ID of the job awaiting approval is 1025, then the title of the dialog box appears as Job Details For Job 1025). You can view/ change the job details before approving or rejecting it.
Fields in the Job Details box are:
Field
|
Description
|
Job
|
ID
|
ID of the job (display only).
To see the detailed description of the job, click the View Job Details hyperlink.
|
Schedule Options
|
Run Type
|
Select the frequency at which the job should be run:
• Immediate—Runs the report immediately.
• 6 - hourly—Runs the report every 6 hours, starting from the specified time.
• 12 - hourly—Runs the report every 12 hours, starting from the specified time.
• Once—Runs the report once at the specified date and time.
• Daily—Runs daily at the specified time.
• Weekly—Runs weekly on the day of the week and at the specified time.
• Monthly—Runs monthly on the day of the month and at the specified time.
The subsequent instances of periodic jobs will run only after the earlier instance of the job is complete.
For example: If you have scheduled a daily job at 10:00 a.m. on November 1, the next instance of this job will run at 10:00 a.m. on November 2 only if the earlier instance of the November 1 job has completed. If the 10.00 a.m. November 1 job has not completed before 10:00 a.m. November 2, then the next job will start only at 10:00 a.m. on November 3.
To change, select the required run type from the drop-down list.
|
Current Schedule
|
Date
|
Scheduled date and time of the job. Click Change Schedule to change the schedule of the job.
You must click the Change Schedule button for the changed schedule to take effect. If you do not click this button, the changed schedule will not be set.
|
Approver
|
Comments
|
Enter your comments. This field is mandatory only if you are rejecting a job.
|
Step 3
Click Approve.
The job is approved.
If you want to reject the job, enter comments in the Comments text box and then click Reject.
Using Device Selector
The Device Selector pane is used to select devices to perform LMS tasks. This pane lists all devices in a group. The devices are listed in the appropriate groups based on Device type groups and User-defined group rules.
The devices name that you see in this pane is the Display Name that you have entered at the time of adding the devices in Device and Credential Repository.
You can use the following search options to search for devices:
•
Using Simple Search
•
Using Advanced Search
•
Using the All Tab
•
Using the Search Results Tab
•
Using the Selection Tab
Note
If you have configured Cisco Prime login mode to work under ACS mode, the devices listed for you while performing the tasks are based on your role and associated privileges that are defined in Cisco Secure ACS.
The Device Selector pane contains the following field/buttons:
Field/Button
|
Description
|
Search Input
|
Enter the search expression in this field.
You can enter single device names or multiple device names. If you are entering multiple device names, separate them with a comma. You can also enter the wildcard characters "*" amd "?".
For example: 192.168.10.1*, 192.168.20.*
|
Search
|
Use this icon to perform a simple search of devices based on the search criteria you have specified in the Search Input text field.
For information on Search, see Using Simple Search.
|
Advanced Search
|
Use this icon to perform an advanced search of devices based on the search criteria you have specified in the Search Input text field.
For information on Advanced Search, see Using Advanced Search.
|
All
|
Lists all User-defined and System-defined groups for all applications that are installed on LMS Server.
For more information, see Using the All Tab.
|
Search Results
|
Displays all the search results from Search or Advanced Search.
For more information, see Using the Search Results Tab.
|
Selection
|
Lists all the devices that you have selected in the Search Results or All tab.
Using this tab, you can deselect devices from the list.
For more information, see Using the Selection Tab.
|
Figure 12-1 shows the new device selector.
Figure 12-1 Device Selector
Tool-tips are provided for long device names so that you do not have to scroll to see the complete device name.
Using Simple Search
You can search for devices by entering the devices name (Display Name) in the Search Input field.
The search is based on the Display Name that you view in the Device Selector pane. This Display Name is entered when you add devices to Device and Credential Repository.
Usage Notes
The following are the usage notes for Simple Search:
•
You can enter multiple device names separated with a comma. You can also enter wildcard character, "*" or "?" for selecting multiple devices.
For example:
You can enter device names in these many ways to select multiple devices:
–
192.168.80.140, 192.168.135.101, rtr805
–
192.168.80.*, 192.168.*
–
192.168.22.?
You cannot enter multiple wildcard characters for selecting the devices
For example, 192.*.80.*. This is not allowed.
•
You must enter either the complete device name or enter the partial device name appended with wildcard character *. That is,
–
No devices are selected, if you enter only 192.168 in the Device Name text box.
–
You have to enter either 192.168* or 192.168.10.10.
•
The search is not case-sensitive.
•
The devices that are selected is a unique list. There are no duplicate entries of devices.
For example:
If you have these devices in All Devices and Normal devices nodes: 192.168.10.10, 192.168.10.20, 192.168.10.21, 192.168.10.30, and 192.168.10.31 then,
a.
Select the devices 192.168.10.20, 192.168.10.21, and 192.168.10.30 in the Normal devices node.
b.
Enter the search criteria 192.168.10.2*
c.
The final selected devices that is displayed is, 192.168.10.20, 192.168.10.21, and 192.168.10.30 in the Normal devices node and 192.168.10.20 and 192.168.10.21 in All Devices node. However, the selected devices count that is displayed in the Device Selector is only three and not five.
•
The All Devices node is expanded without selecting any devices, if the search criteria is not satisfied. The objects selected text displays 0 (zero) device selected.
Using Advanced Search
You can use the Advanced Search icon to specify a set of rules for advanced search. Advanced search is based on the Grouping Services attributes of Grouping Services Server. In the Advanced Search dialog box, you can create rules to search for devices.
Figure 12-2 shows the Advanced Search dialog box.
Figure 12-2 Device Selector Advanced Search
This dialog box contains the following fields and buttons (See Table 12-6):
Table 12-6 Advanced Search Dialog Box
Field/Buttons
|
Description
|
OR, AND, EXCLUDE
|
Logical operators.
• OR—Include objects that fulfill the requirements of either rule.
• AND—Include only objects that fulfill the requirements of both rules.
• EXCLUDE—Do not include these objects.
This field appears only after a rule expression is added in the Rule Text box.
|
Object Type
|
Type of object (device) that is used to form a group.
All rule expressions begin with the same Object Type, RME:INVENTORY:Device.
|
Variable
|
Device attributes, based on which you can define the group.
See Advanced Search Rule Attribute.
|
Operator
|
Operator to be used in the rule. The list of possible operators changes based on the Variable selected.
|
Value
|
The value of the rule expression. The possible values depend upon the variable and operator selected. Depending on the operator selected, the value may be free-form text or a list of values.
The wildcard characters are not supported.
|
Add Rule Expression
|
Used to add the rule expression to the group rules.
|
Rule Text
|
Displays the rule.
|
Check Syntax
|
Verifies that the rule syntax is correct.
Use this button if you have entered the rules manually.
|
Search
|
Used to search for devices based on the defined rule.
|
Usage Notes
The following are the usage notes for Advanced Search:
•
If you have not selected any device nodes, then advanced search is applied only for All Devices node.
•
You can either enter the rules directly in the Rule Text field, or select the components of the rule from the Rule Expression fields, and form a rule.
Each rule expression contains the following:
object type.variable operator value
Object Type—The type of object (device) that is used to form a group. All rule expressions begin with the same Object Type, RME:INVENTORY:Device.
Variable—Device attributes, based on which you can define the group. See the Advanced Search Rule Attribute.
Operator—Operator to be used in the rule. The list of possible operators changes based on the Variable selected.
Value—Value of the rule expression. The possible values depend upon the variable and operator selected. Depending on the operator selected, the value may be free-form text or a list of values.
•
If you are entering the rule expressions manually, the rule expression must follow this syntax:
object type.variable operator value
•
If you are entering more than one rule expression, you must enter logical operators OR, AND or EXCLUDE after every rule expression.
You must use Check Syntax button only when you add a rule manually or when you modify a rule expressions in the Rule Text.
•
The advanced search operation is not case-sensitive.
•
To delete the rules in the Rule Text box, select the complete rule including the logical operator and press the Delete key on your keyboard.
•
If you want to perform a new search, click Clear All before selecting any new devices.
Advanced Search Rule Attribute
Table 12-7 lists the available device advanced search rule attributes that you can use for defining advanced search.
Table 12-7 Advanced Search Rule Attribute
Attribute Group
|
Attribute Type
|
Description
|
Asset
|
Asset.CLE_Identifier
|
CLE identifier of the asset.
|
Asset.Part_Number
|
Orderable part number of the asset.
|
Asset.User_Defined_Identifier
|
User-defined identifier of the asset
|
Chassis
|
Chassis.Model_Name
|
Name of the model.
|
Chassis.Number_Of_Slots
|
Number of slots in that chassis.
|
Chassis.Port_Count
|
Total port count of the chassis.
|
Chassis.Serial_Number
|
Serial number of the chassis.
|
Chassis.Vendor_Type
|
Vendor type of the chassis.
|
Chassis.Version
|
Version number of the chassis.
|
Flash
|
Flash.File_Name
|
Name of the flash file.
|
Flash.File_Size
|
Flash file size in MB.
|
Flash.Model_Name
|
Model name of the flash device.
|
Flash.Partition_Free
|
Free space in MB.
|
Flash.Partition_Name
|
Flash partition name.
|
Flash.Partition_Size
|
Flash partition size in MB.
|
Flash.Size
|
Total flash device size in MB.
|
Image
|
Image.ROM_Sys_Version
|
ROM system software version
|
Image.ROM_Version
|
Version of ROM.
|
Image.Sys_Description
|
Image system description
|
Image.Version
|
Running image version.
|
IP Address
|
IP.Address
|
Device IP address.
|
IP.Address_Type
|
Version of IP, IPv4 or IPv6
|
IP.Network_Mask
|
Network Mask address
|
Memory
|
Memory.Free
|
Free memory in MB.
|
Memory.Name
|
Name of the memory.
|
Memory.Size
|
Total RAM size in MB.
|
Memory.Type
|
Memory type.
|
Memory.Used
|
Used memory in MB.
|
Module
|
Module.HW_Version
|
Module hardware version.
|
Module.Model_Name
|
Name of the model.
|
Module.Port_Count
|
Total ports on that module.
|
Module.Serial_Number
|
Serial number of the module.
|
Module.Vendor_Type
|
Vendor type for the module.
|
Processor
|
Processor.Model_Name
|
Name of the model.
|
Processor.NVRAM_Size
|
Size of the processor NVRAM in MB.
|
Processor.NVRAM_Used
|
Size of the processor NVRAM that has been utilized, in MB.
|
Processor.Port_Count
|
Total port count of the processor
|
Processor.RAM_Size
|
Size of the processor RAM in MB.
|
Processor.Serial_Number
|
Serial number of the processor.
|
Processor.Vendor_Type
|
Vendor type of the processor.
|
State
|
State
|
Device state such as Normal, Alias, etc.
|
System
|
System.Contact
|
Device contact person name.
|
System.Description
|
Description of the system.
|
System.DomainName
|
Device domain name.
|
System.Location
|
Device location information.
|
System.SystemOID
|
System Object ID of the device (sysObjectID).
|
Using Advanced Search—An Example
The following example describes the procedure for selecting devices whose IP address starts with 192.168 or Network Mask is 255.255.255.0. Also, these devices are assumed to be in Normal state.
The devices in your network are:
•
192.168.101.200 with network mask 255.255.255.128
•
192.168.101.201 with network mask 255.255.255.0
•
192.168.102.251 with network mask 255.255.255.0
•
192.168.102.202 with network mask 255.255.255.19
•
192.168.200.210 with network mask 255.255.255.128
Use the following procedure for advanced search:
Step 1
Click the Advanced Search icon in the Device Selector pane.
The Define Advanced Search Rule dialog box appears.
Step 2
Select,
a.
State as Variable
b.
= as Operator
c.
Normal as Value
Step 3
Click Add Rule Expression.
The rule is added into the Rule Text.
Step 4
Select,
a.
And as Logical Operator
b.
IP.Address as Variable
c.
Contains as Operator
d.
Enter 192.168.101 for Value.
Step 5
Click Add Rule Expression.
The rule is added into the Rule Text.
Step 6
Select,
a.
OR as Logical Operator
b.
IP.Network_Mask as Variable
c.
Equals as Operator
d.
Enter 255.255.255.0 for Value.
Step 7
Click Add Rule Expression.
The rule is added into the Rule Text.
Step 8
Click Search.
The Device Selection dialog box appears.
The devices that satisfied the search condition are selected. That is these two devices are selected.
•
192.168.101.200 with network mask 255.255.255.128
•
192.168.101.201 with network mask 255.255.255.0
•
192.168.102.251 with network mask 255.255.255.0
Using the All Tab
The All tab lists all the devices that are available in the LMS. The list is based on the Display Name that you entered in the Device Properties dialog box when you added devices to Device and Credential Repository.
List of Device Folders
The following is the list of device folders under the All tab:
•
The All Devices folder lists all devices. That is, this includes devices in Normal, Alias, Pending, and Pre-deployed states. This folder does not include devices in Suspended and Conflicting states.
•
The Normal Devices folder lists devices that has been successfully contacted by LMS or the device has contacted LMS at least once (polling, successful job completion, Syslog receipt etc.).
•
The Pre-deployed folder lists Device has never ever been reachable by LMS (by protocol such as SNMP).
•
The Previous selection folder lists LMS devices that were selected in previous LMS task in the same session.
•
Saved device list folder lists devices that are saved explicitly by you while generating the Inventory Reports, View Credential Verification Report and Error Report.
Only one Saved device list is created within the device selector. If concurrent users have created Saved device list, only the last created Saved device list appears in the Device Selector. The previous Saved device list is overwritten with the latest.
Note
You can use the Previous selection and Saved device groups only when you are working on a application. You cannot use these device groups when you are working on another Cisco Prime application. That is, if you are working on the Campus Manager application, these groups must not be used.
•
The User Defined Groups folder lists devices that satisfy the group rules. The group rules are defined by you at the time of creating the User-defined groups.
•
Based on the applications that are installed on your LMS Server, you will also view device folders related to other Cisco Prime applications: CiscoWorks_ApplicationName@CiscoWorks_ServerHostName
For example: For Cisco Prime Common Services, you will see:
CS@CiscoWorks_ServerHostName.
In a stand-alone system, server name is not appended. For example, for Common Services, you will see CS.
•
Other application folders are displayed in LMS based on the settings. For more details, see Common Services Online Help.
•
In Device Selector, the other Cisco Prime application device folders will list only devices.
For example: If you have devices, A, B, C and D in Cisco Prime Common Services and you have devices A, B, and C in LMS then in the Device Selector under Common Services device folder, you will view on device list, A, B, and C.
•
The device appears in a disabled (greyed out) state when:
–
Device type is Unknown in Device and Credential Repository. In all applications device is shown as disabled except in Inventory job creation and reports.
–
Device type is known and correct in Device and Credentials (that is, the SysObjectID is correct and is available in Device and Credentials). However, that device is not supported by applications. (Inventory, Software Management, and Configuration Management).
There are two types of device selectors in LMS:
•
Single Device Selector
•
Multiple Device Selector
Single Device Selector
In the single device selector, you can select a device only at the leaf-level (device-level). The radio buttons at the node-level (folder-level) are grayed out.
Multiple Device Selector
In the multiple device selector, you can select devices at both the node-level and leaf-level.
The following are the usage notes for the multiple device selector:
•
If you select devices at the node-level, all devices listed under this node are selected.
For example, if you select the All Devices node, all devices under this node are selected.
•
If you expand a device node, you cannot select devices at the node-level. You need to select devices individually at the leaf-level.
For example, if you expand the All Devices node, you cannot select devices at the All Devices node-level (the check-box is grayed out). You need to select devices individually under the All Devices node.
•
If you select devices at a node-level and expand that particular node, you can deselect the devices only at the leaf-level and not at the node-level.
For example, if you select the Normal Devices node and expand the same, you can deselect the devices only at the leaf-level. You cannot deselect all the devices at the Normal Devices node-level (the check-box is grayed out), when it is expanded. However, you can use Clear All to deselect all the devices.
•
You can select multiple device nodes to perform the tasks.
For example, you can select the Previous selection and the Saved device list nodes together to perform the tasks.
Using the Search Results Tab
The Search Results Tab lists all the results of Simple search or advanced search operations. It displays a flat list of devices and you can do a select all , clear all , or select a few devices from the list.
Using the Selection Tab
The Selection Tab serves as a repository of all the devices that you select from the Search Results tab or the All Tab.
There are three ways to select devices in the Device Selector:
•
Selection Using All Tab
•
Selection Using Search
•
Selection Combining All and Search
Selection Using All Tab
You can select devices using the tree view in the All tab. This tab displays all devices that are available in LMS.
Selection Using Search
You can search devices using Search or Advanced Search. The list of devices matching the search criteria is shown under the Search Results tab. You can select the required devices from the Search Results tab. The Selection tab reflects whatever you selected from Search Results.
If you click the All tab now, the devices selected from Search Results will be shown in the All Devices group.
Selection Combining All and Search
After you select devices using the All tab, you can add a few more devices using Search. You can enter the search criteria and search using Search or Advanced Search and the Search Results tab displays the devices matching the criteria.
You can select the required devices from the Search Results tab. The Selection tab displays the accumulated list from both All and Search Results tabs. If you click the All tab, it displays the selected devices from Search Results under the All Devices group also.
You can enter another search criteria and select more devices. The selected devices are accumulated in the All tab from the Selection tab, as you select more devices.
Note
The (n) Devices Selected message at the bottom left of the Device Selector screen shows the number of devices you have selected. It launches the Selection tab when you click on it.
Editing Device Attributes
To edit the device attributes for a single device
Step 1
Select Admin > Collection Settings > Inventory > Edit the Inventory, Config Timeout, and Retry settings.
The Edit Devices dialog box appears.
Step 2
Select the devices for which you want to edit the device attributes. See Using Device Selector for further information.
Step 3
Click Edit Device Attributes.
The Device Attributes dialog box appears.
Step 4
Click Inline Edit.
The Device Attributes Information dialog box appears.
Step 5
Select a device from the Devices pane.
Step 6
Edit the device attributes in the Device Information pane.
You can check the Apply to all Devices checkbox to apply the device attributes of one device to all other devices that are listed in the Devices pane.
Step 7
Click Modify in the Device Attributes Information dialog box.
Step 8
Click Apply in the Device Attributes dialog box.
To edit the device attributes for the bulk of devices
Step 1
Select Admin > Collection Settings > Inventory > Edit the Inventory, Config Timeout, and Retry settings.
The Devices dialog box appears.
Step 2
Select the devices for which you want to edit the device attributes. See Using Device Selector for further information
Step 3
Click Edit Device Attributes.
The Device Attributes dialog box appears.
Step 4
Click Export.
The Export Device Attributes to File dialog box appears.
a.
Enter the folder name and the filename on the server.
or
–
Browse to select a folder on the server.
The Server Side File Browser dialog box appears.
–
Select a folder and enter the filename on the server.
–
Click OK in the Server Side File Browser dialog box.
b.
Click OK in the Export Device Attributes to File dialog box.
The notification window displays Data exported successfully.
c.
Click OK in the notification window.
Step 5
Edit the exported file.
You can edit only the device attributes, Serial Number, SNMP Retry, SNMP Timeout, Telnet Timeout, and Natted IP Address. You cannot edit the Device Display Name (device_identity) and add new device entries.
See Device Attributes Export File Format for more information.
Step 6
Click Import in the Device Attributes dialog box.
The Import Device Attributes to File dialog box appears.
We recommend that you import the same file that you have exported after editing. If any new device entries are added, these device entries are ignored. Only device entries that match the existing device entries are imported.
a.
Enter the folder name and the filename on the server.
or
–
Browse to select a folder on the server.
The Server Side File Browser dialog box appears.
–
Select a folder and file on the server.
–
Click OK in the Server Side File Browser dialog box.
b.
Click OK in the Import Device Attributes to File dialog box.
The notification window displays Data imported successfully.
c.
Click OK in the notification window.
The Device Attributes window refreshes to display the updated device attributes.
While importing the edited device attributes file an error message may appear,
Attribute values for some selected devices are invalid. See Attribute Error Report for details.
See Editing Device Attributes section to know the minimum and maximum values for the device attributes. Also see Attribute Error Report for more information.
Step 7
Click Apply.
The Devices window appears.
The device attributes are:
•
Device Display Name
Display name of the device.
•
Serial Number
Cisco manufacturing serial number from chassis. You can enter alphanumeric characters up to 255.
The default value is Default Not Defined.
This attribute is available when you either export or edit the device attributes from the Devices window.
•
SNMP Retry
Number of times that the system should try to access devices with SNMP options.
The default value is 2. The minimum value is zero.
•
SNMP Timeout
Duration of time that the system should wait for a device to respond before it tries to access it again.
The default value is 2 seconds. The minimum value is zero seconds. There is no maximum value limit.
Changing the SNMP timeout value affects inventory collection.
•
Telnet Timeout
Duration of time that the system should wait for a device to respond before it tries to access it again.
The default value is 36 seconds. The minimum value is zero seconds. There is no maximum value limit.
Note
The Telnet timeout and SSh timeout are the same. Modifying the Telnet Timeout also changes the SSH Timeout.
•
Natted IP Address
The server ID. This is the translated address of server as seen from the network where the device resides.
This is used when LMS tries to contact devices outside the NAT boundary, you need to enable support for NAT.
The default value is Default Not Defined.
•
TFTP Timeout
Duration of time that the system should wait for a device to respond before it tries to access it again.
The default value is 5 seconds and the minimum value is 0 seconds. There is no maximum value limit.
This attribute is available only when you edit the device attributes from the Device Attributes window.
Do any one of the following to edit the device attributes:
•
Set the device attributes value for a single device using Admin > Collection Settings > Inventory > Edit the Inventory, Config Timeout, and Retry settings > Edit Device Attributes > Inline Edit. See To edit the device attributes for a single device
•
Set the device attributes value for the bulk of devices using Admin > Collection Settings > Inventory > Edit the Inventory, Config Timeout, and Retry settings > Edit Device Attributes > Export. See To edit the device attributes for the bulk of devices
Note
View Permission Report to check if you have the required privileges to perform this task.
Attribute Error Report
The Attribute Error report is generated when the attribute values imported for some selected devices are invalid. This error occurs when the device attributes that are imported as a CSV file contain invalid attributes.
You can click on the Attribute Error Report link that is displayed in the error message, to open the Attribute Error Report.
You can also view the Attribute Error Report by clicking on the Attribute Error Report button from: Admin > Collection Settings > Inventory > Edit the Inventory, Config Timeout, and Retry settings > Edit Device Attributes
Note
The Attribute Error Report link is available only if importing of device attributes causes error.
Device Attributes Export File Format
The device attributes are exported in CSV 3.0 format. The exported file format is:
; This file is generated by DM Export utility
Cisco Systems NM Data import, Source=DM Export; Type=DMCSV; Version=3.0
;
;Start of section 0 - DM Export
;
;HEADER: device_identity,serial_number,SNMPRetryCount,SNMPTimeout,TelnetTimeout,RMEId
;
192.168.8.4,Default Not Defined,2,2,36,Default Not Defined
;End of CSV file
Where,
•
device_identity—Display name of the device as entered in Device and Credential Repository.
•
serial_number—Cisco manufacturing serial number from chassis. You can enter 0 to 255 alphanumeric characters. The default value is Default Not Defined.
•
SNMPRetryCount—Number of times, system should try to access devices with SNMP options. The default value is 2. The minimum value is zero.
•
SNMPTimeout—Duration of time the system should wait for a device to respond before it tries to access it again. The default value is 2 seconds. The minimum value is zero seconds. There is no maximum value limit.
Changing the SNMP timeout value affects inventory collection.
•
TelnetTimeout—Duration of time the system should wait for a device to respond before it tries to access it again. The default value is 36 seconds. The minimum value is zero seconds. There is no maximum value limit.
•
Natted IP Address—server ID. This is the translated address of server as seen from the network where the device resides. This is used when LMS tries to contact devices outside the NAT boundary. The default value is Default Not Defined.