ADTRAN n-Command MSP v6.1 Help 61700841G1-1A ADTRAN n-Command MSP v6.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Table Of Contents Getting Started......................................................................................................1 Network Security Considerations ..........................................................................3 Administration Dashboard.....................................................................................4 Administration Dashboard .................................................................................
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Firmware Alerts............................................................................................21 Missed Check-In Alerts ................................................................................21 Operation Alerts...........................................................................................21 Voice Alerts..................................................................................................21 Device Types..............
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Changing or Setting Manage Access Parameters...........................................41 Adding New Access Credentials .....................................................................43 Discovering Devices Manually with Auto-Link .................................................44 Jobs ....................................................................................................................46 Jobs Tab ............................................
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Update Device Alert Settings...........................................................................66 System Alert Settings ......................................................................................68 Creating an Alert Email Notification.................................................................69 Device Details View ............................................................................................70 Device Details Tab ..........
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A License Information .........................................................................................90 Log Settings ....................................................................................................92 Creating a New Log Entry ...............................................................................93 Editing a Log Entry Notification Type ..............................................................94 Deleting a Log Entry.......
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Table Of Contents Deleting a User..............................................................................................112 Quick Reference ...............................................................................................113 n-Command MSP Quick Reference ..............................................................113 Help Menu .....................................................................................................
ADTRAN n-Command MSP v6.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Getting Started Welcome to n-Command MSP. The n-Command MSP server comes preloaded with the n-Command MSP software. The default IP address is 10.10.10.1. The default login user name is admin and the password is adtran. There are a few tasks to perform before you can begin using the system to manage devices on your network. For maximum network security, refer to the recommendations in Network Security Considerations.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A your network. In order to successfully discover devices, you must complete two tasks. First, change the default Device Access credentials that the system uses to connect with the devices. Navigate to the Devices tab and select Manage Access. Select the default entry from the list, and make the necessary changes and choose Save. Refer to Changing or Setting Manage Access Parameters for more information. Second, enable auto-link on your AOS device.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Network Security Considerations For maximum security, n-Command MSP should be deployed in a DMZ behind a firewall. The following considerations should be made to ensure proper operation when deployed in this manner. Inbound connections are necessary for the n-Command MSP user interface, as well as device management.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Administration Dashboard Administration Dashboard The Administration Dashboard is a graphical user interface (GUI) that provides access to the administrative functions and displays current attributes of the n-Command MSP server. The Administration Dashboard is accessible by entering the server's IPv4 address (or host name) into your browser's address field, followed by the path /msp.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A System Info - Displays the current temperature and power supply status. The color green indicates the device is functioning properly and red indicates a failure, requiring immediate attention. The resource modules can be manipulated in the following ways: To move any of the modules, select the title bar of the module, then drag and drop it to a new location. The other modules will automatically move and realign to accommodate the relocated module.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Network Settings The Network Settings selection of the Settings menu (on the Administration Dashboard) displays the network configuration. From the dialog box, you can view the Host Name, Default Gateway, Primary DNS Server, and Secondary DNS Server settings of the n-Command® MSP server. Also available from this dialog box are the configurations for each of the unit's Ethernet ports.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Changing Network Settings To edit the configuration of the n-Command MSP server, follow these steps: 1. Delete the existing information for the server's Host Name, Default Gateway, Pri DNS Server (primary), or Sec DNS Server (secondary). 2. Enter the new information in the appropriate fields. 3. Verify the changes have been entered correctly, and select Apply. To change the configuration of an Ethernet port, follow these steps: 1.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Date/Time Settings The Date/Time Settings selection of the Settings menu provides the current server time, the NTP server location, and the time zone. The date and time settings can be changed to suit your particular situation. The NTP server is used to synchronize the time of the local server with a time server. Change the NTP server address by entering a new host name in the Time Server (NTP) field.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Configuring a Cluster Creating a cluster environment with multiple n-Command MSP servers allows resource sharing across multiple servers and provides an immediately available backup solution. In a clustering scenario with multiple n-Command MSP servers, only one server is configured as the master server, while the others are configured as nodes.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Remote Database To configure a remote database, use the expanded menu that displays when you select the Remote Database check box from the Cluster Configuration dialog box. 1. Enter the Database Host, Port, User, and Password credentials for your remote PostgresSQL database. The address of the remote database server. Specify as either IPv4 address or host name. The port on which the database is listening. The default port for Port PostgresSQL is 5432.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Join a Cluster In order for a node to join a cluster, the cluster must already be configured using steps described in Configuring a Cluster. Follow these steps to join a cluster: 1. Log into the Administration Dashboard of the node server you want to add to the cluster. 2. Navigate to the Settings > Join Cluster. 3. Enter the necessary settings for Cluster Host, Bind Address, Username, and Password.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Changing the Administration Dashboard Password You can change the password once you are logged into the Administration Dashboard. 1. Navigate to Settings > Change Password. 2. Enter your current password. 3. Enter the new password. 4. Re-enter the new password in the Verify field. 5. Select Save to save the new password and exit the dialog box. The administration dashboard user name and password is independent of the main dashboard user name and password.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A System Shutdown/Restart The System Shutdown/Restart option on the Settings menu of the Administration Dashboard, allows you to shut down the server, restart the n-Command MSP application, or reboot the server. Select Shutdown to power down the server. Select Reboot to power down the server and restart. Select Restart Service to restart the n-Command MSP application service without powering down the server.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Static Routes The Static Routes option on the Settings menu of the Administration Dashboard provides a menu for configuring static routes. A static route is configured by specifying an interface, destination IPv4 network, subnet mask, and gateway. Existing static routes can be deleted from this menu as well.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Administration Dashboard Connection Settings The Connection Settings option on the Settings menu of the Administration Dashboard provides a way to view and modify the Hypertext Transfer Protocol (HTTP) and Secure Hypertext Transfer Protocol (HTTPS) ports used by nCommand MSP. From this dialog box, you can view the port settings of the nCommand MSP server.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Main Dashboard Main Dashboard Tab The main Dashboard tab is the first menu to display after logging into the system. It provides real time status for all devices being managed by the system using the Average Uptime, Current Labels, Device Alerts, Device Types, Heap Usage, New Devices, Processor Utilization, Software Revisions, and Watch Devices modules. Each of the modules can be closed, resized, or moved around within the screen.
ADTRAN n-Command MSP v6.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Average Uptime The Average Uptime module on the Dashboard tab displays the average number of days the devices have been operational. This module can be filtered to show only those devices with a maximum or minimum uptime specified in the options settings. The Refresh rate can also be changed from 30 seconds to 1 or 5 minutes. The options settings are available by selecting the wrench in the lower right corner of the module.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Current Labels The Current Labels module on the Dashboard tab displays labels created in the system. The Refresh rate can be changed from 30 seconds to 1 or 5 minutes. The options settings are available by selecting the wrench in the lower right corner of the module. After making changes to the options, select the wrench again to return to the status view. This module also provides a quick link to the Devices menu with the label applied as a filter.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Device Alerts The Device Alerts module on the Dashboard tab displays all alerts present throughout the system. The system reports alerts for Management, Exception, Firmware, Missed Check-Ins, Operations, and Voice errors. The alert notices can be filtered or sorted by the alert type. The icons above the columns change to display a red warning box with the number of errors detected when alerts of that type exist in the system.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A listed provides detailed information about the exception by jumping to the Exceptions tab in the Detailed Device menu. Firmware Alerts Firmware alerts are issued when a primary or backup firmware image is not on the system, the currently executing firmware version is not the same as the primary firmware image, or the specified primary and backup firmware images are the same file.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Device Types The Device Types module on the Dashboard tab depicts the devices by type in a pie chart. The pie chart can be changed to show the devices by group as well through the Options Settings. The Refresh rate can also be changed from 30 seconds to 1 or 5 minutes. The options settings are available by selecting the wrench in the lower right corner of the module. After making changes to the options, select the wrench again to return to the status view.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Heap Usage The Heap Usage module on the Dashboard tab displays the percent of heap used on each device. This module can be filtered to show only those devices with a minimum change or minimum usage by specifying a value in the options settings. The number of devices can be limited by setting the Max Devices number, up to 100 devices. The Refresh rate can also be changed from 30 seconds to 1 or 5 minutes.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A New Devices The New Devices module on the Dashboard tab displays all the new devices discovered on the network in the last 10 days. The Refresh rate can be changed from 30 seconds to 1 or 5 minutes. The options settings are available by selecting the wrench in the lower right corner of the module. After making changes to the options, select the wrench again to return to the status view. For more detailed information about the new devices, click on the column.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Processor Utilization The Processor Utilization module on the Dashboard tab displays the percent of processor being used on each device. This module can be filtered to show only those devices with an minimum usage by changing the options settings. The number of devices can be limited by setting the Max Devices number. The Refresh rate can also be changed from 30 seconds to 1 or 5 minutes.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Software Revisions The Software Revisions module on the Dashboard tab depicts the software revisions in a pie chart. The view can be adjusted to show just the Primary, Backup, or Running firmware versions by changing the options settings. The Refresh rate can also be changed from 30 seconds to 1 or 5 minutes. The options settings are available by selecting the wrench in the lower right corner of the module.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Main Dashboard Watch Devices The Watch Devices module on the Dashboard tab is a group of devices that match a specified filter. By selecting the wrench in the lower right corner of the module, you can specify a filter to use and also customize the display settings. You can only choose one filter at a time to display in the Watch Devices module. The list of filters displayed reflects any filters already created and saved within the system.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Devices Devices Tab The Devices tab allows you to discover devices on the network, preinstall configurations, group the devices by type, add labels, discontinue device management, and edit Manage Access parameters. To open the Devices tab, select the Open Tab menu from the upper left-hand corner of any screen in n-Command MSP. Select Devices from the drop-down menu.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Discovering Devices on the Network n-Command MSP can manage AOS devices located on the network once they have been discovered. The discovery process locates devices running AOS versions A2.04, 17.05.04, or later. There are two methods for discovering devices.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Discovering Devices Using a Range of IP Addresses A group of devices can be discovered all at once using an IP address range. By providing the beginning IP address and the ending IP address (or subnet mask), n-Command MSP can identify all devices within the range capable of being managed. Use the following steps to discover devices on the network using this method: 1. Navigate to the Devices tab at the top left of the menu. 2.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Devices that are configured to report to a different n-Command MSP server are not reconfigured to report to this one.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Discovering Devices from an Imported CSV File Devices can be discovered by importing the necessary information from a comma separated value (CSV) file. The CSV file should list the following information: IP Address, Username, Password, Method (HTTP/HTTPS), and optionally Port Number. Use these steps to discover devices and add them to the Devices tab for management: 1. Navigate to the Devices tab at the top left of the menu. 2.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Preinstalling a Configuration The Preinstall Config feature allows a customized AOS configuration file to download to a device as soon as it is discovered. Prior to deploying a device in the field, the configuration file is generated and uploaded to n-Command MSP along with the serial number of the device.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Renaming and Displaying Custom Columns There are five custom columns provided in the n-Command MSP server. These custom columns can be renamed and displayed on the Devices tab. 1. Select Rename Custom Columns from the Manage drop-down menu. 2. Enter the new column name in the fields provided. 3. Select Save to save the settings and return to the Devices tab. 4. To display the columns, choose Columns from the bottom right corner of the Devices tab.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Using Labels All of the managed devices can be grouped in a number of ways to make better use of the dashboard modules and maintenance tasks. This is accomplished by creating labels to identify the group and adding devices to the label. The following sections explain how to add a label, add devices to the label once it is created, remove devices from the label, and delete a label from the system.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Saving Filters Filters are used to limit the devices displayed in a list based on a specified criteria. To create a filter in the Devices tab, refer to Adding a Filter to a List. To save the filter once it is applied, use the following steps: 1. Select the Add button under the Saved Filters heading. 2. Enter a descriptive title for the filter in the blank field provided. 3. Select Add to save it.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Adding Labels to a Device Use the following steps to create labels and add devices: 1. From the Devices tab, enter a new label name in the Labels field. 2. Select Add (or press Enter) to create the label and add it to the list below All Devices. 3. Select the devices to add to the label and drag them to the new label. The icon changes as it is being dragged. When the device is directly on top of the label and shows a green + sign, drop it into the label group.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Removing a Device from a Label Use the following steps to remove a device from a label: 1. From the Devices tab, select a label to list the devices associated with it. 2. Select the device from the list on the right. The Remove from Label option above should become available in the taskbar directly above the device list. 3. Select the Remove from Label option.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Removing a Label from the System A label can be removed completely from the system. The devices which were included in the label remain in the All Devices group, as well as in any other label containing them. Use the following steps to remove a label from the system: 1. From the Devices tab, select the label to be removed from the list on the left side of the menu. 2. Select the minus circle button that appears next to the label. The label is deleted.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Discontinuing Management of a Device Devices can be deleted from n-Command MSP so they are no longer actively managed by the system. 1. From the Devices tab, select All Devices. 2. Locate the device to be removed in the list on the right. Select the check box next to the device. 3. Select Delete. The device is removed from the system and no longer being managed.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Changing or Setting Manage Access Parameters Manage Access parameters provide the access credentials (user name and password), as well as the preferred IP address, port, and method for connecting to the device from n-Command MSP. Each set of parameters can be managed in a central location and applied to any number of devices on the network. Use the following steps to add a new set of Manage Access parameters: 1.
ADTRAN n-Command MSP v6.1 Help • 61700841G1-1A To edit a set of parameters, select the name of the access parameters from the list on the left and make the necessary changes. Select Save once the all changes are completed.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Adding New Access Credentials When discovering devices, an authentication user name and password must be entered to allow access to the device. These are called Access Credentials and can be managed by the system. New entries are added from the Discover Devices menu by selecting the Edit button or from the Manage Access dialog box by selecting Manage Credentials. Use the following steps to add a new entry: 1.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Discovering Devices Manually with Auto-Link Devices can be discovered manually by configuring the auto-link settings on the AOS network products. Connect to the device through console, Telnet, or secure shell (SSH) as described in the quick start guide that shipped with the unit or available online at http://www.adtran.com. Once auto-link is enabled and configured on the device, it will check in with the server and become a managed device.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Devices Additional information about these commands and using the CLI is can be found in the AOS Command Reference Guide available online at http://supportforums.adtran.com.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Jobs Jobs Tab The Jobs tab enables you to create, edit, and manage specific jobs you want to perform on your network. The jobs included are Push Firmware, Push Configuration, Restore, Reboot, and Purge Exceptions. Each user on the network is configured to have access to specific jobs, or all jobs, depending on their user configuration. The network administrator is responsible for configuring the user's permissions.
ADTRAN n-Command MSP v6.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Toggling Between Jobs Tab Views To toggle between the Details and Grid views of the Jobs tab, follow these steps: 1. For the Details view, select the Details button on the top right corner of the Jobs tab. 2. For the Grid view, select the Grid button on the top right corner of the Jobs tab. You can toggle back and forth between views as often as necessary.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Creating a New Job To create a new job from the Jobs tab, select the Schedule Job button at the top left of the menu. Selecting this button opens a new window, entitled Schedule New Job. In the Schedule New Job window, there are five sections (Targets, Tasks, Schedule, Notifications, and General) that display down the left side to guide you in configuring the job. Enter the information for each section as described in the steps below.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A you select. For more details about each task, select the task from the following list: • • • • • Purge Exceptions Pushing Firmware to a Device Pushing a Configuration to a Device Restoring Files Rebooting Device(s) 3. Select the Schedule section to configure the new job's schedule. You can specify whether the job will start at a specific time or immediately, by selecting the appropriate option.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Purge Exceptions A new job can be created to purge all exception alerts on a device. Once the exception alerts are cleared from the device, the exception condition is cleared from n-Command MSP as well. To create a Purge Exception job, navigate to the Schedule New Job menu by selecting Schedule Job from the Jobs tab. Refer to Creating a New Job for information on creating a new job. You will assign the task as Purge Exceptions.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Pushing Firmware to a Device Navigate to the New Job window by selecting Add Job from the Jobs tab. Select the Tasks tab from the New Job window. Refer to Creating a New Job for more information on accessing the New Job window and configuring notifications, schedules, and devices that accompany this job. Once you are in the Tasks menu, select Push Firmware to configure the firmware push. To configure this job, follow these steps: 1.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Pushing a Configuration to a Device Navigate to the New Job window by selecting Add Job from the Jobs tab. Select the Tasks tab from the New Job window. Refer to Creating a New Job for more information on accessing the New Job window and configuring notifications, schedules, and devices that accompany this job. Once you are in the Tasks menu, select Push Config to push a configuration to a unit, or units, managed by n-Command MSP.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Restoring Files Navigate to the New Job window by selecting Add Job from the Jobs tab. Select the Tasks tab from the New Job window. Refer to Creating a New Job for more information on accessing the New Job window and configuring notifications, schedules, and devices that accompany this job. Once you are in the Tasks menu, select Restore to configure the file restoration job. To configure this job, follow these steps: 1.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Rebooting Device(s) Navigate to the New Job window by selecting Add Job from the Jobs tab. Select the Tasks tab from the New Job window. Refer to Creating a New Job for more information on accessing the New Job window and configuring notifications, schedules, and devices that accompany this job. Once you are in the Tasks menu, select Reboot to configure a the device's reboot job. To configure this job, follow these steps: 1.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Canceling a Job To cancel a job, follow these steps: 1. Select the job you wish to cancel from the job list. In Details view, the job list is on the left side of the menu. In Grid view, the job list is in the center of the menu. 2. Select the Cancel button from the top left side of the Jobs menu. 3. The job has been cancelled.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Jobs Deleting a Job To delete a job, follow these steps: 1. Select the job you wish to delete from the job list. In Details view, the job list is on the left side of the menu. In Grid view, the job list is in the center of the menu. 2. Select the Delete button from the top left side of the Jobs menu. 3. The job has been deleted and is removed from the jobs list.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Firmware Firmware Tab The n-Command MSP Firmware tab provides an interface for firmware management. To open the Firmware tab, select the Open Tab menu from the upper left-hand corner of any screen in n-Command MSP. Select Firmware from the drop-down menu. Firmware is used for distribution to network devices being managed by nCommand MSP. Each device has specific firmware that can be acquired from ADTRAN.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Uploading Firmware to the n-Command MSP Server The firmware must first be available locally before attempting to upload to the n-Command MSP server. Check with the reseller or ADTRAN technical support at http://www.adtran.com/support for the most current firmware. To upload firmware to the server, follow these steps: 1. Navigate to the Firmware tab by selecting the Open Tab menu from the upper left-hand corner and select Firmware from the drop-down menu. 2.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Deleting Firmware from the Server 1. Navigate to the Firmware tab by selecting the Open Tab menu from the upper left-hand corner and select Firmware from the drop-down menu. 2. Select a device group from the left-hand column. The firmware available on the server (specific to the types of devices selected) will display on the right. Device Groups will only display if firmware for that device type is currently available on the server.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Firmware Updating Firmware on a Device from the Firmware Menu Transferring firmware to a device is accomplished using a job created in the Jobs menu. The firmware must first exist on the n-Command MSP server before the transfer can be performed. For more information, refer to Uploading Firmware to the n-Command MSP Server.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Alert History and Templates Alert History Tab The Alert History tab displays all alerts for all devices on the system in a list format that is easily sorted by the column headings. To open the Alert History tab, select the Open Tab menu from the upper left-hand corner of any screen in n-Command MSP. Select Alert History from the drop-down list.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Alert Templates Alert templates are an easy way to apply alert settings to multiple devices at one time or to new devices as they are discovered. An alert template specifies how alerts are delivered from the devices to an administrator. This delivery method can be sent through SNMP to a monitoring agent, email sent to a valid email address, or visible from the Alerts widget on the main Dashboard in nCommand MSP. To create an alert template: 1.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A email from the drop-down list. Refer to Email Settings for details about creating these entries. 5. Select the check box next to Apply to new Devices if you want to apply to devices when they are discovered as well. Not selecting this options indicates you want to apply the alert template only to devices currently managed by nCommand MSP. 6. Specify the Criteria settings. The alert template is applied to devices meeting the criteria.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Adding Criteria to Alert Templates Alert templates can be applied to devices matching a specified criteria. Use the following steps to specify the criteria for an alert template: 1. From the Alert Template menu, be sure to select the template to configure from the list on the left. Select Add Criteria from the Alert Template menu. Once selected, a filter statement line is shown below the Criteria heading. 2. Select an attribute from the first pop-up list.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Update Device Alert Settings Alert settings can be altered for multiple devices all at one time without changing the Alert templates or creating a new one. This is accomplished through the Update Device Alert Settings dialog box. The alert settings specifies how alerts are delivered from the devices to an administrator.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A 5. Select Next. You will now select the devices. 6. There are four options available for selecting devices to which the settings will be applied. Select the Run on ALL devices option to apply to all discovered devices. Devices - select the devices individually from the list, drag and drop in the Devices for Job field below. Labels - use existing labels to select the devices. Refer to Adding Labels for more information.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A System Alert Settings There are specific alerts that can be sent pertaining to the nCommand MSP server. These are called System Alerts. Just like an alert template, the system alert settings specifies how alerts are delivered to a system administrator. This delivery method can be sent through SNMP to a monitoring agent or email to a valid email address. To change the system alert settings: 1.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Alert History and Templates Creating an Alert Email Notification Email settings must be configured before this method can be selected for alert notifications. To create an alert email notification, use the following steps: 1. Select Email Settings from the Alert Templates menu. 2. Enter a name for the email notification in the field provided and select Add. 3.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Device Details View Device Details Tab The Device Details tab is an optional menu that can be displayed by double clicking on a device from many locations throughout the software. A new tab is displayed with the device name as the heading. It provides all of the device's available information through several menus: Summary, VQM Statistics, Backup Files, Alert Template, SIP Files, and Exceptions.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Summary Menu The Summary section of the Device Details tab provides General Information, Firmware Information, Auto-Link Information, System Usage, Exceptions, Network Information, Device Access, and VQM statistics. The only information on this screen that can be changed is the Device Access. Selecting the Edit button next to Device Access opens the Device Access dialog box, where changes can be made to the credentials.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A credentials, IP address settings, port number, and the method used. VQM is an optional section of the Summary menu. Not all devices have voice quality monitoring (VQM) statistics. If available, VQM statistics are provided in a summary graph at the bottom of the screen displaying the MOS LQ and Call Quality. The data can be filtered to show only a specific interface or to show a summary of all calls.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A VQM Statistics Menu Voice quality monitoring (VQM) allows real time passive Voice over IP (VoIP) quality measurements to be taken on all Realtime Transport Protocol (RTP) voice streams transmitted through an AOS device. The VQM statistics gathered by the AOS device are shared with the n-Command® MSP server using the VQM reporter. The reporter must be enabled on the AOS device before n-Command MSP can aggregate the VQM statistics gathered by the AOS device.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Individual Call Detail Grid The individual call detail grid lists every call individually and can be filtered by selecting the Add Filter menu option at the bottom of the grid. Apply a filter in the same manner described in the section Adding a Filter to a List. The columns can be hidden or revealed by selecting the Manage Columns menu option at the bottom of the grid, as discussed in Manage List Columns.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Backup Files Menu The Backup Files section of the Device Details tab provides a list of backup points to use for restoring the device configuration. The backup points are defined on the device itself as to when they are created. To review a backup file, select a backup point from the list on the left. A list appears, providing the Path, Name, Size, and date Modified On for each backup file.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Individual Device Alert Settings The method used to deliver alerts can be altered on a per device basis. From the Device Details tab, select the Alert Templates button to display the current alert settings. 1. To change the way an alert is handled, select the check box in the columns under the delivery method SNMP, Widget, or E-mail.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A SIP Files Menu The SIP Files section of the Device Details tab provides a list of packet capture (PCAP) files received for the device. This information is available only if SIP is enabled on the device. The PCASH settings must also be configured before SIP traffic PCAP files will be received. Refer to PCASH Settings for more information. To sort the list by a specific column, click on the column heading.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Exceptions Menu The Exceptions section of the Device Details tab provides more information about each Exception alert active on the device. The name of the report, size, and date it was created are all displayed in this section. Double click on the report name to download the file locally and review the contents.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Device Details View Installing a Configuration File The Install Config feature is available from the Device Details tab. It provides a method for downloading a configuration file to a specific unit. The configuration file can be created prior to installing on a unit that has already been deployed and is currently being managed by n-Command MSP. To install a configuration file, follow these steps: 1.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Settings Settings Menu The Settings menu is located in the top right corner of the n-Command MSP menu, and provides quick access to manage settings and viewing preferences.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Authentication Settings The Authentication Settings, available from the Settings menu, indicate the method to use for user authentication, such as Local, Radius, LDAP, or Active Directory. Each method requires specific settings be provided in order to authenticate users and allow them access to the n-Command MSP server. After an authentication type is selected, the dialog box displays the appropriate fields to populate for that method.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Local Authentication After selecting the Local authentication method, select Apply to save and exit the menu. Select Cancel to exit without making any changes. Selecting Local authentication allows users to login using the credentials stored on the local nCommand MSP server. These settings are configured from the Users tab. Changing to another authentication method after using the Local authentication method does not erase the local users.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Radius Authentication After selecting the RADIUS authentication method, you will need to provide the following information: 1. Assign the authentication type as either CHAP or PAP. 2. Enter the Authentication Server address. 3. Enter the server Port (the default is 1812). 4. Select a number of Server Retries. 5. Enter the shared key. (The shared key is the key received from the server administrator.) 6.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A LDAP Authentication After selecting the LDAP authentication method, you will need to provide the following information: 1. Assign the authentication type as Simple, Digest MD5, or Kerberos. Simple authentication type is NOT recommended since it does not encrypt passwords. 2. Enter the Authentication Server address. 3. Enter the Server Port (the default is 389). 4. Enter the Security Domain (for example, corp.mycompany.com). 5.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Once changes have been made in the dialog box, select Apply to save and exit the menu. You can select Cancel to exit without making any changes.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Active Directory Authentication After selecting the Active Directory authentication method, you will need to provide the following information: 1. Assign the authentication type Kerberos. 2. Enter the Authentication Server address. 3. Enter the Server Port (the default is 389). 4. Enter the Security Domain (for example, CORP.MYCOMPANY.COM). 5. Specify the DN in the User Base DN field. n-Command MSP uses this attribute to locate user information.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Setting User Permissions for LDAP or Active Directory Authentication After selecting either LDAP or Active Directory authentication method, you will need to set the user permissions in order for the n-Command® MSP permissions to be retrieved correctly. This function should be performed by an administrator familiar with the LDAP or Active Directory methods used in your network. Use one of the following two methods to set the user permissions in nCommand MSP: 1.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A If a user is not defined with permissions as described above, they will be able to log into the n-Command MSP server, but will not have permission to perform any actions.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Ignore Devices The Ignore Devices selection of the Settings menu provides a dialog box to specify a serial numbers for specific devices on the network to ignore. Once a device is added to the list, it is ignored every time n-Command MSP updates until it is removed from the list. To add a device to the Ignore Devices list, use the following steps: 1. Select New from the dialog box. 2. Enter the serial number, adding any comments as necessary. 3. Select Save.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A License Information The banner across the top of the screen displays the license information for the current installation of n-Command MSP. This license information changes color depending on the current status. It displays green if the license is currently valid, yellow if you are within 30 days of expiration of the license period, and red if the license has expired.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A 10. Enter the challenge key from the n-Command MSP software that you generated in Step 2 (you can copy and paste the string) and select Generate License Key. A license certificate is generated and emailed to the registered user. Save the file containing the license certificate. You will upload it to the n-Command MSP server in the next step. 11. Return to the n-Command MSP software.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Log Settings The Log Settings selection of the Settings menu displays a dialog box that lists all log configurations. New log entries can be created or existing configurations can be edited or deleted from this dialog box. Select a topic for more information. • Creating a New Log Entry • Editing a Log Entry's Notification Type • Deleting a Log Entry Log Settings can have a negative effect on unit memory if too many items are logged.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Creating a New Log Entry To create a new log entry, follow these steps: 1. Select the New tab at the top left corner of the Log Settings dialog box. 2. Enter the name of the log in the appropriate field. 3. Specify the notification type from the drop-down menu. 4. Select Cancel if you do not wish to add the log. 5. Select Add to add the log to the Log Settings list. 6. Select Save before exiting the Log Settings menu. 7.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Editing a Log Entry Notification Type The log entry's notification is the only log parameter that can be edited from the Log Settings dialog box. To edit a log entry notification type, follow these steps: 1. Select the log entry to edit by highlighting the selection. 2. Select the appropriate notification type (Info, Warn, Debug, Trace, or Error). 3. Select Cancel if you do not wish to change the notification type. 4.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Deleting a Log Entry To delete a log entry from the Log Settings list, follow these steps: 1. Select the log entry to delete by highlighting the selection. 2. Select Delete from the top left corner of the menu. 3. Select Save to save the new list. 4. Exit the Log Settings menu by selecting the X in the top right corner of the box. Log Settings can have a negative effect on unit memory if too many items are logged.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Login Banner Settings The Login Banner option of the Settings menu allows you to add or change the message displayed before logging into the system. Enter the message in the box provided and select Save to accept the changes, or select Cancel to exit without making any changes.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Mail Settings The Simple Mail Transfer Protocol (SMTP) configuration settings are accessed from the Mail Settings option on the Settings menu. From this dialog box, you can review the Sending User, Host, and Port settings of the n-Command MSP server. To make changes, enter the information in the fields provided and select Save. A test message can also be sent to confirm the settings are correct. Enter an email address in the To Address field and select Test.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Message Log The Message Log selection of the Settings menu displays a list of messages generated by the server. The log also displays the time the message was logged and the type of message sent. When a user performs an action in the system, it generates an entry in the message log. The types of messages that can be captured are success, error, and warning.
ADTRAN n-Command MSP v6.1 Help PCASH Settings The PCASH Settings selection of the Settings menu displays a dialog box to enter the user name and password for the Packet Capture Archival Server HTTP (PCASH). This enables nCommand MSP to communicate with the PCASH to receive SIP traffic packet captures (PCAPs) from AOS devices. This information is used to populate the SIP ladder diagram in nCommand MSP, available from the Device Detail tab. SIP must be enabled on the AOS device in order for PCAPs to be sent.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Reverse DNS The Reverse DNS option of the Settings menu allows you to enable reverse domain naming system (DNS) lookup. If this option is enabled, when a device checks in with the n-Command MSP server, a reverse DNS lookup is performed on the IPv4 address. If a host name is associated with the IPv4 address, nCommand MSP will use the fully qualified domain name (FQDN) instead of the IPv4 address.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A SNMP Settings The SNMP Settings selection of the Settings menu displays a dialog box that lists the Simple Network Management Protocol (SNMP) settings for the nCommand MSP server. Use this dialog box to configure or edit the SNMP trap settings. 1. Select SNMP Settings from the Settings menu. 2. Enter the management server IP address in the Host 1 field. The address should be for the server that will receive the SNMP traps. 3.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A System Backup The System Backup selection of the Settings menu enables you to view available system backups, create a backup schedule, configure the remote FTP server settings, and test the remote server settings. Viewing the Available System Backups Available system backups are listed on the Backups tab of the System Backup dialog box. You can place the cursor over a backup entry to view the full details of the backup.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A System Restart The System Restart option of the Settings menu allows you to restart the n-Command MSP application. Select Restart to restart the nCommand MSP application service without powering down the server. Select Cancel to exit the dialog box without performing any of these functions.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A System Updates The System Updates selection of the Settings menu provides access to available updates for the n-Command MSP software. From this dialog box, you can view the system updates available for your server and current release notes. You can choose to install the update from the released versions available online or choose a file stored locally on your own computer. To install an update, follow these steps: 1.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A VQM Statistics Export The VQM data for all devices on the n-Command MSP system can be exported to a comma-delimited file (.csv) at a specified scheduled time. The schedule can be exported daily at the same time, or a single export can be requested. The exported file contains all VQM data received during the previous day. When exported, the .csv file is compressed via gzip and transferred to the destination specified.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A ADTRAN n-Command MSP v6.1 3. Select Submit to complete the process and request the export file. Tips: Select Test Connection to make sure the FTP server information is correct. The file naming scheme is: callhistoryexport_serial#-versiondate.csv.gz. serial# is the n-Command MSP server serial number, version is the version of n-Command MSP running on the server, and date is the date the export was submitted.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Users Users Tab The n-Command MSP Users tab provides network administrators with the ability to manage the users of the system. Administrators can create new users, update user's settings and contact information, and delete users from the system from a single screen. To open the Users tab, select the Settings menu from the top right corner. Select Users from the drop-down menu.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Adding a New User Prior to adding a new user, you should have the following user information readily accessible: User Name User Password User Email Address User Contact Name User's Office and Mobile Phone Numbers User Permissions To add a new user to the system, follow these steps: 1. Select Add User on the top left corner of the menu. 2.
ADTRAN n-Command MSP v6.1 Help • 61700841G1-1A User Management allows users access to the Users Tab, and gives permission to edit user configurations. For more information on specific jobs, refer to the Jobs tab. 5. When all required fields are complete, and user permissions have been enabled, select Save User from the top right corner of the menu. Close the new user tab and select the Users tab. The newly added user appears in the user list.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Changing a User's Password To change a user's password, follow these steps: 1. Select the user's name from the user list and double click on the link. 2. The user's information appears full screen. To edit the password information, select Edit User at the top right corner of the menu. 3. Under the Account Settings heading, delete the old password from the Password field and enter the new one in its place. 4. Enter the new password in the Verify Password field.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Editing User Settings To edit a user's settings, follow these steps: 1. Select the user's name from the user list. Double click on this user entry. 2. The user's information appears in full screen. To edit the user information, select the Edit User button at the top right corner of the menu. 3. Edit the necessary information. Only the network administrator can edit the Job/User Permissions.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A ADTRAN n-Command MSP v6.1 Deleting a User To delete a user, follow these steps: 1. Select the user to be deleted from the user list. 2. Select Delete from the top left corner of the menu. There is no verification prompt for deleting a user. Once the Delete button is selected, the user is removed from the system. Any user except the administrator can be deleted from the system.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Quick Reference n-Command MSP Quick Reference There are many features of the n-Command MSP software common to many of the work areas.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Help Menu Selecting the Help menu displays a drop-down menu that provides access to online support and the About n-Command MSP dialog box. Online support is provided through Help files and topics. Once you have selected Online Support from the Help menu, you can navigate through the Help topics from the Contents menu, Index, or conduct a search.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A About n-Command MSP The About n-Command MSP selection of the Help menu provides an overview of the version of n-Command MSP you are using.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Edit Account Menu Selecting the Edit account menu opens a window to edit the user account of the currently logged-in user. The window opens and displays the user's information. To edit this information, select the Edit User button at the top right side of the window. You can then edit the information as necessary, and select Save User when your edits are complete.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Logout Menu The Logout menu allows you to safely exit the n-Command MSP software. When you select this option, you are automatically logged off the system, and returned to the login screen.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Dashboard Icons There are three main icons displayed on every dashboard module: arrow, X, and wrench. Each icon is described below. Arrow Icon The arrow icon is located to the left of the X icon at the top right side of each dashboard module. Selecting the arrow icons maximizes or minimizes the dashboard module. X Icon The X icon is located at the top right side of each dashboard module. Selecting the X icon on a dashboard module closes that dashboard module.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Adding a Filter to a List Anywhere in the n-Command MSP software that there is a columned list of information, a Filter button is available at the bottom right of the list. Selecting this button enables you to select a previously saved filter from the list and limit how much data is displayed in the list. The information available for filtering varies by list.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Managing Columns n-Command MSP provides a Columns management option in areas of the software with lists of data. These lists display multiple columns of information, such as host name, firmware, serial number, user names, etc. Anywhere in the software that has a columned list of information, there is a Columns button in the bottom right side of the list. Selecting this button allows you to choose which set of information is displayed in the list.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Quick Reference CSV Format Export n-Command MSP provides you with the ability to export list information in comma separated value (CSV) file format. This feature is available in any area of the software that contains a columned list (for example, Users tab, Devices tab, etc.). To export list information in a CSV format, follow these steps: 1. Select the CSV button at the bottom left corner of the list. 2.
ADTRAN n-Command MSP v6.1 Help F.A.Q.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A Why don't I have a Users tab? Not all users have access to other user's information. If you do not have a Users tab, your profile does not have permission to access other user's profiles. The administrator always has access to create, edit, and delete user's profiles. If you require this access, contact your administrator.
ADTRAN n-Command MSP v6.1 Help 61700841G1-1A ADTRAN n-Command MSP v6.1 Why can't I edit a user's jobs and permissions? You may have only limited access to other user's profiles. Based on the permission of your profile, you may or may not be able to edit the jobs and permissions of other users. The network administrator always has permission to edit all user's jobs and permissions. If you require the ability to edit the jobs and permissions of other users, contact your network administrator.