Device Profile and Connectivity Testing
Completing device profiles is a prerequisite to running collection tasks. Navigate to Administration>Device Profile to open the Device Profile window where you can:
Set up or modify the device list. Initially, the device list contains all the devices discovered from the traffic engineering database (TED). The device IP address (if not already discovered) and the PCEP IP address for each device are required. The PCEP IP address is the local address of the PCC located in the PCE statement stanza block.
Supply a hostname for each router for OSPF networks. This is necessary because the TED does not contain hostnames for OSPF networks.
Specify an MD5 key to secure PCEP communication between the NorthStar Controller and the PCC.
Specify device SNMP parameters for SNMP connectivity.
Test connectivity of devices using ping, SSH, SNMP, and Netconf.
When the Device Profile window is first opened, no automatic comparison between the live network and the configured device list is performed. This means you might not see discrepancies immediately. You can manually perform the comparison by clicking the Sync with Live Network button at the top of the window. When the device list is opened for the very first time, it is blank until you perform a Sync with Live Network.
Figure 1 shows the Device Profile window, including the device list in the upper pane and details about the highlighted device in the lower pane.
Device List Pane
The Device List pane shows all the devices in the profile along with many of their properties. You can change the order of the devices in the list by clicking and dragging rows. Sorting, column selection, and filtering options are available when you hover over a column heading and click the down arrow that appears. Figure 2 shows an example.
You can filter the devices that are included in the display by activating a filter on any column. See Sorting and Filtering Options in the Network Information Table for a description of the column filtering functionality, along with an example.
The buttons across the top and bottom of the Device List pane perform the functions described in Table 1. Button labels are displayed when you hover over icon buttons.
Table 1: Device List Button Functions
Saves the device profile changes. The button becomes active when modifications or edits have been made to entries or fields in the device list. When the button is active, you must click it to finalize your changes.
Sync with Live Network
Synchronizes devices with the live network. This function does not delete devices from the selected profile that do not exist in the live network, but it does add devices that are missing from the live network, and it synchronizes all devices with a corresponding live network device.
When you click Sync with Live Network, this is what happens behind the scenes:
Tests connectivity on the selected devices.
Adds a device.
Modifies the selected device.
Deletes the selected device.
Filters the list of devices according to the text you enter.
(Reload Device Profiles)
Reloads the device profiles. This is useful when you are modifying a device entry and then realize that you don’t want to save it. Reload will reload the device list back to the last saved state.
Offers device group management and group display options.
Export Device Profiles
Exports device profiles to a comma separated values (CSV) file named DeviceProfiles.csv.
Import Device Profiles
Imports devices from a CSV file. This is particularly useful when there are a large number of devices to add. Clicking the button opens the Import Devices from CSV window where you browse to the CSV file and specify the appropriate delimiter. A preview of the data appears in the Data Preview box.
You can perform many of these functions on multiple devices simultaneously. To select multiple devices, Ctrl-click or Shift-click the device rows and then click the button for the function you wish to perform.
The Test Connectivity button opens the Profile Connectivity window shown in Figure 3.
Click the Use Management IP check box if the devices to be tested have management IP addresses specified for out-of-band use. Click Options to open the Test Connectivity Options window shown in Figure 4.
In the General tab, you can:
Specify which test methods you want to use (Ping, SSH, SNMP, NETCONF). Multiple methods are allowed (by default, all methods are tested). To select or deselect methods, click the corresponding check boxes.
Allow for concurrent access of a number of devices by specifying a simultaneous access limit from 1 to 16. The default is 7.
In the SNMP tab, you can add optional SNMP get community string(s), one per line. If an SNMP connectivity check fails with the community string specified in the device profile (SNMP Parameters tab), these additional community strings are tried until one succeeds.
In the Login/Password tab, you can enter alternate login credentials to be used in case of login/password failure.
Click OK to submit your selections and close the Test Connectivity Options window.
In the Profile Connectivity window, click Start to begin the connectivity test. You can click Stop if the test fails to complete quickly. The test is complete when the green (pass) or red (fail) status icons are displayed. Figure 5 shows an example.
In SNMP connectivity testing, the host name and device type (vendor) are polled and are auto-populated in the test results if the information was previously missing or incorrect in the device profile. A red triangle in the upper left corner of a field in the test results indicates that a change was automatically made. You can see an example in the Device column in Figure 5. To propagate those changes to the device profile, click Profile Fix at the bottom of the Connectivity Test Results window.
To display the detailed test results for an individual device in the lower part of the window, click the device row in the upper portion of the window, even if you only tested connectivity for a single device.
The Start button remains unavailable after test completion until you close the window and reopen it to begin a new connectivity test.
The Add button opens the Add New Device window shown in Figure 6.
Table 2 describes the data entry fields under the General tab.
Table 2: Add New Device General Field Descriptions
Name of the network device, which should be identical to the hostname. During configuration collection, the software uses this name as part of the name of the collected configuration file. The configuration filename uses the format ip.name.cfg. If the device name is left blank, the configuration filename uses the format ip.cfg.
Required field: IP address of the network device.
Management IP address for the device. NorthStar Controller first attempts connection using the management IP address if it is specified, and then the IP address.
Note: The management IP address is required for out-of-band management access.
The local address of the PCC located in the PCE statement stanza block.
Note: We highly recommend that this field be populated.
Select the device vendor from the drop-down menu. The default is GENERIC. The vendor is displayed in the Device List under the column heading Type.
Model number of the device.
Type of operating system installed on the device.
Version number of the operating system build installed on the network device. The default value is > 14.2x.
Note: For routers configured with PCEP using Junos OS Release 14.2x and earlier, select <= 14.2x for this parameter.
Required field. Use the drop-down menu to select:
See PCEP Version and RFC 8231/8281 Compliance for more information about PCEP version and RFC 8231/8281 compliance.
Device group name you assign to the device, such as a regional group.
Note: A device can only have one group designation.
Login ID for the network device.
Password for the network device.
Login ID for situations that require a higher-security login.
Password for situations that require a higher-security login.
We recommend you do not use the credentials of Junos OS root users when running device collection. NorthStar Controller will not raise a warning when such credentials are used, even if the task fails.
Table 3 describes the data entry fields under the Access tab.
Table 3: Add New Device Access Field Descriptions
Number of milliseconds after which a connection attempt times out. The default is 300. To enter a different value, type the number of milliseconds in the field or use the up and down arrows to increment or decrement the displayed value.
Number of times a connection to the device is attempted. The default is 3. To enter a different value, type the number of retries in the field.
Command to use for SSH connection. The default is ssh. To enter a different value, type the command in the field. Include the full path of the command and options used for ssh, such as /usr/bin/ssh -1 -p 8888.
Select this checkbox to enable Netconf communication to the device.
Enable Bulk Commit
Select this checkbox to allow NorthStar to do a single commit instead of multiple commits when you provision multiple LSPs on the same router.
Note: This is mandatory for P2MP-TE.
Enter the number of times a Netconf connection is to be attempted. The default is three.
Note: A value of 0 means an unlimited number of retries - connection attempts never stop.
PCEP MD5 String
Message Digest 5 Algorithm (MD5) key string, also configured on the router. Configuring MD5 provides information on configuring MD5 authentication.
Note: All the routers in the network must have their PCEP IP addresses in the profile. This is especially important if any router in the network is configured with an MD5 authentication key.
Click the check box to enable programmable routing protocol process (PRPD) on the device. This is required for EPE.
IP adress for PRPD on the device. The default is the router ID (router’s loopback address). If you leave the field empty, the default is used.
Port on the router that NorthStar can use to establish a PRPD session. The default is 50051, but you can modify it.
The fields on the SNMP Parameters tab are required to set up for SNMP collection. The SNMP parameters are described in Table 4.
Table 4: SNMP Parameters
Use the drop-down menu to select SNMPv1, SNMPv2c, or SNMPv3. The default is SNMPv2c.
SNMP port. The default is 161. Must match the port configured on the router.
SNMP get community string as configured on the router. The default is “public” if you leave it blank.
Number of times connection will be attempted. The default is 3.
Number of seconds after which connection attempts will stop. The default is 3.
Additional fields become available if you select SNMPv3 as the version.
In the User Defined Properties tab, you can add properties not directly supported by the NorthStar UI.
Click Submit to complete the device addition. The new device appears in the device list.
The Modify button opens the Modify Device(s) window, which has the same fields as the Add New Device window. Edit the fields you want to change and click Submit. Click Save Changes to complete the modification. You can wait until you have completed all your device modifications to click Save Changes, which will have become active to flag that there are unsaved changes.
To modify one or more fields in the same way for multiple devices, Ctrl-click or Shift-click to select the devices in the device list and click Modify. On the resulting Modify Device(s) window, you can make changes that affect all the selected devices.
As an alternative to opening the Modify Device(s) window, you can change some of the device properties directly in the Device List pane by double-clicking the fields.
To delete a device, select the device row in the Device List and click Delete. A confirmation window is displayed as shown in Figure 7.
Click Yes to complete the deletion.
If you delete a device from the liveNetwork profile, you are not deleting it from the live network itself. You can restore the device to the profile using the Sync with Live Network button.
Device Grouping Options
With device grouping, you can group devices in ways that are independent of topological groups. Since Netconf task collection supports collection by device profile group, one way to use this functionality is to manage Netconf sub-collection tasks by group.
When you click the down arrow beside the Device Grouping icon, the two options displayed are:
Toggle Device Grouping
Manage Device Grouping
Select Toggle Device Grouping to either display the devices in the Device List according to their assigned groups, or not. Figure 8 shows an example of a device list in which device grouping is toggled on.
To return to the ungrouped device list, select Disable Grouping. To display just the group names without displaying the group members, select Collapse All. To return to the grouped display in which the group members are also shown, select Expand All.
Select Manage Device Grouping to open the Manage Device Groups window as shown in Figure 9.
Existing groups are listed on the left side. Click the name of an existing group to display its members in the “Devices in the group” list on the right. All other devices are listed in the “Select device(s) from” list where you can select devices to add.
To delete a group, click the name of an existing group on the left and click Delete Group(s) at the bottom. This action removes the group assignment from the member devices. Groups with no members are automatically deleted.
To create a new group and add devices to it, type the group name at the top and click the New Group check box. All devices are then listed in the “Select device(s) from” list so you can choose the group members. Figure 10 shows an example. If you add devices that are already assigned to a group, the new assignment removes the previous assignment.
Click Apply to save your work.
You can also assign a group to a device profile in the Add New Device or Modify Device(s) window (General tab). The Manage Device Groups window is particularly useful for making changes to multiple devices at once.
Device Detail Pane
The Device Detail pane displays the properties of the device that is highlighted in the Device List pane. There are two ways to minimize this pane:
Click the down arrow at the top center of the pane. Click the up arrow to maximize the pane.
Click the down arrow in the top right corner of the pane. Click the up arrow to maximize the pane.
Click and drag the top margin of the pane to resize the pane.
PCEP Version and RFC 8231/8281 Compliance
When you configure a device profile, NorthStar automatically
creates a corresponding entry in the
pcc_version.config file in
the NorthStar server. The entry it creates reflects the PCEP version
you configured in the device profile (in the General tab)—either
Non-RFC or RFC Compliant.
The syntax of the configuration is ver=ip_address:pcc_version. The RFC-Compliant option in the device profile sets the pcc_version to 2. A pcc_version setting of 2 sets IANA code points for Association, S2LS Objects, and P2MP-IPv4-Lsp-Identifier TLV. This also makes the system compliant with RFC 8231/8281.
You must be using Junos OS Release 19.x or later to run NorthStar in RFC 8231/8281 compliant mode.
The following example indicates that PCEP version 2 (RFC compliant mode) is configured for the three listed devices:
[root@northstar]# cat /opt/pcs/db/config/pcc_version.config ver=192.0.2.100:2 ver=192.0.2.200:2
The IP address should be the PCC IP used to establish the PCEP session. This is the IP address the PCC uses as the local IP address and is the same as appears in the PCC_IP field in the web UI device profile for the device.
If you select Non-RFC for the PCEP version in the device profile, you are indicating that you do not want to use RFC 8231/8281 compliance and IANA code points for Association, S2LS Objects, and P2MP-IPv4-Lsp-Identifier TLV. This selection sets the pcc_version to 0 in the pcc_version.config file, and is the default setting. This setting is appropriate for:
Any device that is not RFC 8231/8281 compliant, such as devices running a release of Junos OS older than Release 19.x.
Any RFC 8231/8281 compliant device that you do not want running in RFC compliant mode. This is referred to as running in compatibility mode. On these routers, you must also configure the following statements:
set protocols pcep object-class association-old-value set protocols pcep object-class s2ls-old-value set protocols pcep tlv-type p2mp-ipv4-lsp-identifier-old-value set protocols pcep stateful-draft-07-compliant
Whenever a device profile is updated in the web UI, the pcc_version.config file is also updated and reloaded, so there is no need to manually restart the PCE server to capture the updates.
Some networks include both a physical topology and a logical topology. An example of how that could look in the NorthStar UI topology view is shown in Figure 11. In this example, the physical and logical layers are not connected, but they could be, depending on your network.
Logical nodes (and LSPs that incorporate logical nodes) are fully supported by NorthStar, but somewhat differently from physical nodes:
Logical topology is discovered automatically via BGP-LS. See Configuring Topology Acquisition in the NorthStar Controller Getting Started Guide for more information.
LSPs originating from a logical system cannot be discovered directly by PCEP. Instead, you run device collection for physical devices and any corresponding LSPs originating from logical devices are imported into the network information table, under the tunnel tab. The correlation between the physical and logical systems are established via device collection.
In the network information table in NorthStar, display the optional columns Physical Hostname and Physical Host IP so you can confirm that NorthStar successfully correlated the physical and logical nodes when it performed device colleciton.
Because PCEP is not supported for logical devices, it is not possible for NorthStar to obtain real time topology updates for logical devices. We recommend periodic device collection to compensate for this limitation.
Device collection must be run before you attempt to create LSPs that incorporate logical nodes because otherwise, the logical nodes are not available as selections for Nodes A and Z in the Create LSP window. In the Create LSP window, you must specify Netconf as the Provisioning Method (not PCEP) when the LSP incorporates logical nodes.
For more information about logical nodes and provisioning LSPs that incorporate them, see Provision LSPs.
MD5 can be used to secure PCEP sessions as described in RFC 5440, Path Computation Element (PCE) Communication Protocol (PCEP). MD5 authentication must be configured on both the NorthStar Controller (in the Device Profile window) and on the router (using the Junos OS CLI). The authentication key must be the same in both configurations. The device profile acts as an “allowlist” when MD5 is configured. The NorthStar Controller does not report LSPs or provision LSPs for the routers not included in the device profile.
The first time MD5 is enabled on the router, all PCEP sessions to routers are reset to apply MD5 at the system level. Whenever the MD5 enabled status on a router or the MD5 key changes, that router resets the PCEP connection to the NorthStar Controller.
The first four steps are done in the NorthStar Controller Device Profile window, to configure MD5 for the PCEP session to a router.
- Select a router in the Device List pane.
- Click Modify to open the Modify Device(s) window.
- In the MD5 String field (Access tab), enter the MD5 key string. Click Modify.
- Click Save Changes to save
your changes. The PCEP MD5 Configured field for the router changes
from no to yes.
All the routers in the network must have their PCEP IP addresses in the profile. When you save your changes, you might receive a warning, reminding you of this.
- The final step is done in the Junos OS CLI on the router,
to configure MD5 for the PCEP session to the NorthStar Controller.
Use the set authentication-key command at the [edit protocols pcep pce] hierarchy level to configure the MD5 authentication key.user@pcc# set protocols pcep pce pce-id authentication-key md5-key