Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

Modify Pathfinder Settings From the GUI

 

In addition to modifying the settings from the CLI, you can also modify the component-specific Pathfinder settings by using the Paragon Automation GUI.

Note

The Peer Engineering configuration settings are not supported in Paragon Automation Release 21.1. Although you can modify these settings from the GUI, the changes will not take effect.

To modify the settings from the GUI:

  1. Select Configuration > Network > Pathfinder.

    The Pathfinder page is displayed.

  2. Select a component that you want to modify.

    The component-specific settings appear on the right side of the page.

  3. Modify the settings as needed. Table 1 describes the settings that you can modify.Note

    Fields marked with an asterisk (*) on the GUI are mandatory.

  4. Click Save Changes.

    The changes are saved and a confirmation message is displayed.

    The modified settings are displayed on the Pathfinder page.

Table 1: Pathfinder Settings

Setting

Description

Advanced

Sync Network Model

Click Sync to refresh the synchronization of the network model. You can use this option if the network model audit has unresolved discrepancies or if the information displayed for the model is out of sync.

When you sync the network model, this is what happens behind the scenes:

  1. Information associated with the network model (nodes, links, LSPs, interfaces, SRLGs, and user-defined parameters) remains intact. Nothing is purged from the database.

    Note: Device profiles are not affected.

  2. The network model is repopulated with live data learned from topology acquisition.

Table 2 describes the effects on various elements in the network when you reset or synchronize the model.

Reset Network Model

Warning: The Reset Network Model operation is typically appropriate for a lab rather than a production environment. We strongly recommend that you perform this action only under JTAC supervision.

There are two circumstances under which you must reset the network model in order to keep the model in sync with the actual network:

  • The node ISO network entity title (NET) address changes—This can happen when configuration changes are made to support IS-IS.

  • The routing device’s IP address (router ID) changes—The router ID is used by BGP and OSPF to identify the routing device from which a packet originated. The router ID is usually the IP address of the local routing device. If a router ID has not been configured for the device, the IP address of the first interface (of the device) that comes online is used, which is usually the loopback interface. Otherwise, the first hardware interface with an IP address is used.

    If either of these addresses changes, and you do not perform the Reset Network Model operation, the network model in the Pathfinder database becomes out of sync with the live network.

When you reset the network model, this is what happens behind the scenes:

  1. Information associated with the network model (nodes, links, LSPs, interfaces, SRLGs, and user-defined parameters) is purged from the database (so, we recommend that you do not reset the network model unless it is absolutely required, and that you perform this action only under JTAC supervision).

    Note: Device profiles are not affected.

  2. The network model is repopulated with live data learned from topology acquisition.

Table 2 describes the effects on various elements in the network when you reset or synchronize the model.

Config Server

Settings

  • publish-aslink—Click the toggle button to enable or disable the ConfigServer to publish the AS link (created by the getipconf command) to Pathfinder. By default, this toggle button is disabled.

  • include-interface-type—From the list, select one or more interface types that you want the ConfigServer to add to Pathfinder:

    • physical (physical interfaces)

    • loopback-mgmt (loopback and management interfaces)

    • vrf-if (interfaces associated with a VRF)

    • links-if (interfaces on links)

    • all (all interfaces)

    Note: ConfigServer publishes to all components only the interface types that you specify. The GUI and data collection receive information about the interfaces representing those interface types only. Later, if you modify this setting by clearing the previously selected interface types (that are already represented by interfaces in the Pathfinder model), the information collected for those interfaces remains in the model.

Log Destination

  • name—Displays the name for the log destination settings.

  • level—From the list, select the severity level of the log messages. The available options are:

    • emergency—The system is unusable.

    • alert—Immediate action is needed.

    • critical—Critical condition exists.

    • error—Error condition.

    • warning—Warning condition (this is the default value).

    • notice—Normal but significant condition.

    • info—Information message.

    • debug—Debug message.

    • trace—Trace message.

    • – (none)—No severity level.

Device Profile Adapter

Settings

redis-poll-interval—Specify the frequency (in seconds) with which the device profile adapter polls the Redis service for the Redis status.

Enter 0 or a negative value to disable this setting.

Example: 10s or 10seconds

Default: 5s

Log Destination

  • name—Displays the name for the log destination settings.

  • level—From the list, select the severity level of the log messages. The available options are:

    • emergency—The system is unusable.

    • alert—Immediate action is needed.

    • critical—Critical condition exists.

    • error—Error condition.

    • warning—Warning condition (this is the default value).

    • notice—Normal but significant condition.

    • info—Information message.

    • debug—Debug message.

    • trace—Trace message.

    • – (none)—No severity level.

Mladapter

Settings

polling-interval—Specify the polling interval (in seconds) for interfaces without notification support. To disable polling, enter 0.

Default: 3600

Log Destination

  • name—Displays the name for the log destination settings.

  • level—From the list, select the severity level of the log messages. The available options are:

    • emergency—The system is unusable.

    • alert—Immediate action is needed.

    • critical—Critical condition exists.

    • error—Error condition.

    • warning—Warning condition (this is the default value).

    • notice—Normal but significant condition.

    • info—Information message.

    • debug—Debug message.

    • trace—Trace message.

    • – (none)—No severity level.

Netconf Connection Controller

Device-Connection Pool

  • Device-Connection Pool:

    • batch-size—Specify the maximum number of connections to be attempted per cycle.

      Default: 10

    • reconnect-delay—Specify the delay (in seconds) between reconnection attempts.

      Default: 30s

    • disconnect-delay—Specify the delay (in seconds) after which an attempt is made to disconnect the device when a session is migrated.

      Example: 250s or 250seconds

      Default: 300s

  • Netconf:

    • keepalive-interval—Specify the NETCONF keep-alive interval (in seconds).

      Default: 0s

    • port—Specify a TCP port number to change the default port for NETCONF from 830. In some installations, port 22 is preferred.

      Default: 830

In-memory-Datastore

  • connection-pool-size—Specify the maximum number of connections to be maintained in the pool.

    Default: 5

  • reconnect-delay—Specify the delay (in milliseconds) between reconnection attempts.

    Default: 1000

  • reconnect-retries—Specify the maximum number of reconnection attempts to be allowed.

    Default: 1000

Infra

  • Cache Memory:

    • max-reconnect-attempts—Specify the maximum number of attempts allowed for reconnecting with the cache-memory.

      Default: 30

  • Msg Broker:

    • max-queue-length—Specify the maximum allowed length of the queue used by the message broker.

      Default: 0

      If you use the default value, the queue is set without any maximum length.

    • prefetch-count—Specify the number of messages to be sent at the same time by the message broker.

      Default: 200

Network Data Backend

backend-connection—From the list, select either redis or file-system as the backend datastore from which you want to fetch the topology information:

  • in-memory-datastore—If you select redis, the values that you configured in netconf-connection-controller > in-memory-datastore are applied, and those values are displayed here.

  • folder-path—If you select file-system, specify the path to the network definition folder.

    Default: /opt/northstar/data/network_data/

Registry

  • check-delay—Specify the delay interval (in seconds) between checking registered NETCONF connection controller instances in Redis.

    Default: 45s

  • publish-delay—Specify the delay interval (in seconds) between attempting registration of NETCONF connection controller instances in Redis.

    Default: 30s

Rpc Service

workers—Specify the number of worker threads to be used by the remote procedure call (RPC) service provider.

Default: 10

Log Destination

  • name—Displays the name for the log destination settings.

  • level—From the list, select the severity level of the log messages. The available options are:

    • emergency—The system is unusable.

    • alert—Immediate action is needed.

    • critical—Critical condition exists.

    • error—Error condition.

    • warning—Warning condition (this is the default value).

    • notice—Normal but significant condition.

    • info—Information message.

    • debug—Debug message.

    • trace—Trace message.

    • – (none)—No severity level.

Netconfd

Device Connection Pool

publish-connected-device-status—Specify the delay interval (in seconds) for publishing the status of connected devices.

Default: 0s

If you use the default value, the device connection status is not published.

In-memory Datastore

  • connection-pool-size—Specify the maximum number of connections to be maintained in the pool.

    Default: 5

  • reconnect-delay—Specify the delay (in milliseconds) between reconnection attempts.

    Default: 1000

  • reconnect-retries—Specify the maximum number of reconnection attempts to be allowed.

    Default: 1000

Infra

Cache Memory:

  • max-reconnect-attempts—Specify the maximum number of attempts allowed for reconnecting with the cache-memory.

    Default: 30

  • Msg Broker:

    • max-queue-length—Specify the maximum allowed length of the queue used by the message broker.

      Default: 0

      If you use the default value, the queue is set without any maximum length.

    • prefetch-count—Specify the number of messages to be sent at the same time by the message broker.

      Default: 200

Network Data Backend

backend-connection—From the list, select either redis or file-system as the backend datastore from which you want to fetch the topology information:

  • in-memory-datastore—If you select redis, the values that you configured in netconf-connection-controller > in-memory-datastore are applied, and those values are displayed in this field.

  • folder-path—If you select file-system, specify the path to the network definition folder.

    Default: /opt/northstar/data/network_data/

Proxy

workers—Specify the number of worker threads to be used by the proxy service provider.

Default: 10

Registry

check-delay—Specify the delay (in seconds) between checking registered NETCONF connection controller instances in Redis.

Default: 45s

Log Destination

  • name—Displays the name for the log destination settings.

  • level—From the list, select the severity level of the log messages. The available options are:

    • emergency—The system is unusable.

    • alert—Immediate action is needed.

    • critical—Critical condition exists.

    • error—Error condition.

    • warning—Warning condition (this is the default value).

    • notice—Normal but significant condition.

    • info—Information message.

    • debug—Debug message.

    • trace—Trace message.

    • – (none)—No severity level.

Path Computation Server

Settings

  • ignore-rro-check—Click the toggle button to enable or disable the Path Computation Server (PCS) to ignore explicit route objects (ERO) and record route objects (RRO) during LSP initial node consolidation. By default, this toggle button is disabled.

  • northstar-vpn—Click the toggle button to enable or disable Pathfinder VPN features in the PCS. By default, this toggle button is disabled.

  • lsp-latency-interval—Specify the frequency (in seconds) at which the PCViewer calculates LSP delay and display the data in the Tunnel tab of the GUI (Network > Topology > Tunnels tab > View > Delay).

  • license-check-interval—Specify the interval for the PCS to check for the license (npatpw) file.

    Default: 3600s

  • route-over-logical-SRLink—Click the toggle button to enable or disable the PCS to calculate a route over a logical segment routed (SR) link. By default, this toggle button is disabled.

  • SRLG-provisioning—Click the toggle button to enable or disable the provisioning of shared risk link groups (SRLG). By default, this toggle button is disabled.

  • provisioning-include-lsp-metric—Click the toggle button to enable or disable the PCS to include the LSP metric when provisioning the LSP. By default, this toggle button is disabled.

  • disable-ecmp-tree-calculation—Click the toggle button to enable or disable the calculation of equal-cost multi-paths (ECMP). If you enable this toggle button, ECMP calculation is disabled. By default, this toggle button is disabled.

  • disable-node-sid-calculation—Click the toggle button to enable or disable node segment ID (SID) calculation. By default, this toggle button is disabled. If you enable this toggle button, node segment SID calculation is disabled.

  • lsp-provision-queue-size—Specify the size for the LSP provisioning queue.

    Default: 50

  • pcep-speaker-id—Specify the PCEP speaker ID to be used for P2MP flow mapping.

    Default: northstar

  • zero-bandwidth-signalling—Click the toggle button to enable or disable the zero-bandwidth signalling feature. By default, this toggle button is disabled.

  • ecmp-placement-method—Specify one of the following options as the ECMP placement method. After considering link metrics, if there are multiple ECMPs available, Pathfinder selects a path based on the value you specify here. If you don't specify a value, the first random path is selected for all the LSPs.

    Random—Pathfinder randomly selects one of the ECMP paths.

    Least Fill—Pathfinder selects the path with the maximum available bandwidth.

    Most Fill—Pathfinder selects the path with the minimum available bandwidth.

  • monitor-mode—Click the toggle button to enable or disable the monitor mode in the PCS. By default, this toggle button is disabled.

    If you enable monitor mode, the PCS doesn't send LSP provisioning orders to the PCC. You use this option when you want to monitor the topology but don’t want the LSPs provisioned. If you disable monitor mode, the PCS sends LSP provisioning orders to the PCC.

BGP Steering

  • target-tag—Specify the target prefix for the programmable routing protocol process (PRPD) filtering community.

    Default: 42

  • target-tag-cookie-range-start—Set the starting number for path cookie allocation. EPE static routes added by Pathfinder are allocated an unused path cookie starting from the value specified here.

    Default: 42

  • steering-route-preference—Specify the relative preference value for the Specify the relative preference value for the PRPD steering route. If you specify a sign (+ or -) for the value, the preference is considered the relative increase or decrease of the preference for static routes (relative to BGP routes). If you don’t specify a sign, the value is considered an absolute value.

    Range: -127 through 127

    Default: 1

  • steering-aggregate-colors—Click the toggle button to enable the creation of a steering entry (per ingress prefix) that contains the route target with all the colors. By default, this toggle button is disabled.

    Note: This is an experimental parameter.

In Memory Datastore

  • disable-pipeline—If you enable this toggle button, the in-memory key store (Redis) pipeline feature is disabled. if you disable this toggle button, the PCS uses this feature to retrieve objects from the Redis key store.

  • pipeline-threshold—Specify the buffer threshold value for the Redis pipeline.

    Default: 65536

Link Flap

  • flap-interval—Specify the interval (in seconds) after which the link flap count is reset. If a link remains in the same status (Up or Down) longer than this interval, the counter is reset and the link is no longer considered flapped.

    Range: 1 through 300s

  • flap-count—Specify the maximum value for the link flap count. When a link goes from Up to Down, the Path Computation Element (PCE) increments the counter on that link. When the counter reaches the maximum link flap count, the link is considered flapped. Flapped links carry a large penalty, so are not preferred by the PCS.

LSP To Path Computation Instance

  • LSP Request Discriminator SR NodeSID:

    Instance-type—From the list, select the instance of the PCS that manages the segment routing (SR) LSPs tagged with Use node SIDs:

    • default—To choose the default PCS.

    • SRPCServer—To choose the SR PCS with anycast ID support.

  • LSP Request Discriminator SR Test:

    From the list, select the instance of the PCS that manages the SR LSPs:

    • default—To choose the default PCS.

    • SRPCServer—To choose the SR PCS.

Segment Routing Policy

segment-routing-policy:

  • originator-asn—Specify the originator Autonomous System Number (ASN) for the segment routing policy.

    Default: 0

  • originator-ip—Specify the originator IP address for the segment routing policy.

Log Destination

  • name—Displays the name for the log destination settings.

  • level—From the list, select the severity level of the log messages. The available options are:

    • emergency—The system is unusable.

    • alert—Immediate action is needed.

    • critical—Critical condition exists.

    • error—Error condition.

    • warning—Warning condition (this is the default value).

    • notice—Normal but significant condition.

    • info—Information message.

    • debug—Debug message.

    • trace—Trace message.

    • – (none)—No severity level.

Path Optimization

Timer

Specify the frequency (in minutes) with which path optimization is triggered automatically.

Note: The optimization is based on the current network, and not on the most recent Path Analysis report.

Programmable RPD Client

Settings

  • retry-interval—Specify the frequency (in seconds) with which the connection to the programmable routing protocol process (PRPD) client is retried after a failure.

    Example: 60s or 60seconds

    Default: 30s

  • top-prefix-filter—Specify whether you want the BGP monitor routes to include only the top prefix routes. This setting will not filter out the already-learned routes until the connection to the router is reset.

Log Destination

  • name—Specify a unique name for the log destination settings.

  • level—From the list, select the severity level of the log messages. The available options are:

    • emergency—The system is unusable.

    • alert—Immediate action is needed.

    • critical—Critical condition exists.

    • error—Error condition.

    • warning—Warning condition (this is the default value).

    • notice—Normal but significant condition.

    • info—Information message.

    • debug—Debug message.

    • trace—Trace message.

    • – (none)—No severity level.

System

In Memory Datastore

  • connection-pool-size—Specify the maximum number of connections to be maintained in the pool.

    Default: 5

  • reconnect-delay—Specify the delay (in milliseconds) between reconnection attempts.

    Default: 1000

  • reconnect-retries—Specify the maximum number of reconnection attempts to be allowed.

    Default: 1000

Messaging Bus

  • reconnect-retries—Specify the maximum number of reconnection attempts (0 indicates no attempts and -1 indicates infinite retries) to be allowed.

    Default: -1

  • reconnect-delay—Specify the delay (in milliseconds) between reconnection attempts.

    Default: 1000

  • max-channels—Specify the maximum number of channels that can be multiplexed over a single connection.

    Default: 128

Persistent Datastore

  • Persistent datastore settings:

    • connection-pool-size—Specify the maximum number of connections to be maintained in the pool.

      Default: 5

    • reconnect-delay—Specify the delay (in milliseconds) between reconnection attempts.

      Default: 1000

  • Log Destination:

    • name—Specify a unique name for the log destination settings.

    • level—From the list, select the severity level of the log messages. The available options are:

      • emergency—The system is unusable.

      • alert—Immediate action is needed.

      • critical—Critical condition exists.

      • error—Error condition.

      • warning—Warning condition (this is the default value).

      • notice—Normal but significant condition.

      • info—Information message.

      • debug—Debug message.

      • trace—Trace message.

      • – (none)—No severity level.

Scheduler

device-profile-update-interval—Specify the interval (in milliseconds) after which the internal timer in the scheduler polls for device profile updates.

Default: 5000

Scheduler > Distributed Task Queue

  • thread-pool-size—Specify the thread pool size for device collection.

    Range: 1 through 255

    Default: 10

  • collector-max-pool-size—Specify the maximum queue size (in bytes) of the distributed task collector messaging bus.

    Default: 524288000

Scheduler > Tasks

Collection Cleanup

  • rollup-data-retention-duration—Specify the retention period for aggregated data (in days). Enter 0d to disable the retention of aggregated data.

    Example: 800d or 800days

    Default: 180d

  • raw-data-retention-duration—Specify the retention period for raw data logs (in days). Enter 0d to disable the retention of raw data logs.

    Example: 10days or 10d

    Default: 14d

  • interval—Specify how often (in days) the collection cleanup task is executed. Enter 0 to disable the cleanup task.

    Example: 7d or 7days

    Default: 1d

Demand Reports

demand-reports:

as-demand-bucket-size—Specify the bucket size of the composite query related to autonomous system (AS) demand reports.

Default: 100

Device Collection

  • data-path—Specify the path to the parent directory for the device collection task.

    Default: /opt/northstar/data

  • timeout—Specify the time (in seconds) after which the device collection task times out.

    Example: 3000s or 3000seconds

    Default: 1800s

  • enable-update-device-profile—Click the toggle button to enable updating the device profiles as part of the device collection task. By default, this toggle button is disabled.

  • purge-cutoff—Specify the purge cut-off period (in days). The device collection task deletes all files that are older than the specified cut-off value.

    Example: 10d or 10days

    Default: 7d

File Transfer

  • interval—Specify the interval (in seconds) at which the system transfers files from the active node to other cluster nodes.

    Example: 3000s or 3000seconds

    Default: 3600s

  • paths—Specify one or more complete directory paths for transferring fiels from the active node to other cluster nodes.

Rollup

  • interval—Specify how often the ESRollup system task is run (in hours). The ESRollup system task executes the esrollup.py script to aggregate the previous hour’s data. The ESRollup task is called from the Pathfinder server. You can view (but not modify) the rollup task on the Task Scheduler page (Administration > Task Scheduler).

    Example: 3h or 3hours

    Default: 1h

    Note: We recommend that you do not change this default value except to disable aggregation. If you want to disable data aggregation, set the value to 0h.

  • max-worker-process—Specify the maximum number of worker processes that can be used for the ESRollup system task.

    Default: 4 or equivalent to the number of CPUs (whichever value is smaller)

  • bulk-insert-record-count—Specify the maximum number of records in bulk, which can be inserted to the PostgreSQL database.

    Default: 5000

Scheduled LSP Sizing

  • stats-collection-interval—Specify the interval (in seconds or minutes) at which the native sensor collects statistics related to the LSP.

    Example: 30s or 1m

    Default: 1m

  • Bandwidth Sizing:

    • stats-query-workers—Specify the number of workers that must be used to query the statistics from the native datastore.

      Default: 1

    • Log Destination:

      • name—Displays the name for the log destination settings.

      • level—From the list, select the severity level of the log messages. The available options are:

        • emergency—The system is unusable.

        • alert—Immediate action is needed.

        • critical—Critical condition exists.

        • error—Error condition.

        • warning—Warning condition (this is the default value).

        • notice—Normal but significant condition.

        • info—Information message.

        • debug—Debug message.

        • trace—Trace message.

        • – (none)—No severity level.

  • Container LSP Normalization > Log Destination:

    • name—Displays the name for the log destination settings.

    • level—From the list, select the severity level of the log messages. The available options are:

      • emergency—The system is unusable.

      • alert—Immediate action is needed.

      • critical—Critical condition exists.

      • error—Error condition.

      • warning—Warning condition (this is the default value).

      • notice—Normal but significant condition.

      • info—Information message.

      • debug—Debug message.

      • trace—Trace message.

      • – (none)—No severity level.

SNMP Collection

  • timeout—Specify the time (in seconds) after which the SNMP polling task times out.

    Example: 10s or 10seconds

    Default: 3s

  • retries—Specify the maximum number of retries to be allowed for an SNMP poll.

    Default: 3

Log Destination

  • name—Specify a unique name for the log destination settings.

  • level—From the list, select the severity level of the log messages. The available options are:

    • emergency—The system is unusable.

    • alert—Immediate action is needed.

    • critical—Critical condition exists.

    • error—Error condition.

    • warning—Warning condition (this is the default value).

    • notice—Normal but significant condition.

    • info—Information message.

    • debug—Debug message.

    • trace—Trace message.

    • – (none)—No severity level.

Topology Filter

Data Persistence

  • persistent-storage-init-wait—Specify the wait time (in seconds) for the persistent storage connection to be established before exiting with an initialization failure.

    Default: 45s

  • file-store-path—Specify the default data output directory for file stores.

    Default: /opt/northstar/data

Messaging Bus

  • reconnect-retries—Specify the number of reconnection attempts (0 indicates no attempts and -1 indicates infinite retries) to be allowed.

    Default: -1

  • reconnect-delay—Specify the delay (in milliseconds) between reconnection attempts.

    Default: 1000

  • max-channels—Specify the maximum number of channels that can be multiplexed over a single connection.

    Default: 128

Persistent Datastore

  • Persistent datastore settings:

    • connection-pool-size—Specify the maximum number of connections to be maintained in the pool.

      Default: 5

    • reconnect-delay—Specify the delay (in milliseconds) between reconnection attempts.

      Default: 5000

  • Log Destination:

    • name—Specify a unique name for the log destination settings.

    • level—From the list, select the severity level of the log messages. The available options are:

      • emergency—The system is unusable.

      • alert—Immediate action is needed.

      • critical—Critical condition exists.

      • error—Error condition.

      • warning—Warning condition (this is the default value).

      • notice—Normal but significant condition.

      • info—Information message.

      • debug—Debug message.

      • trace—Trace message.

      • – (none)—No severity level.

Log Destination

  • name—Displays the name for the log destination settings.

  • level—From the list, select the severity level of the log messages. The available options are:

    • emergency—The system is unusable.

    • alert—Immediate action is needed.

    • critical—Critical condition exists.

    • error—Error condition.

    • warning—Warning condition (this is the default value).

    • notice—Normal but significant condition.

    • info—Information message.

    • debug—Debug message.

    • trace—Trace message.

    • – (none)—No severity level.

Topology Server

Application

  • use-live-rsvp-bw-over-configured—Click the toggle button to enable or disable the usage of live RSVP bandwidth (obtained from the live network) instead of the RSVP bandwidth that you configured.

    By default, this toggle button is disabled.

  • use-nokia-path-workaround—Click the toggle button to append a double colon (::) to the device name and routing path name strings for Nokia devices.

    By default, this toggle button is disabled.

  • use-unnumbered-interface-workaround—Click the toggle button to enable or disable the usage of interface index (IfIndex) to correlate link events for unnumbered interfaces.

    If you enable this toggle button, usage of IfIndex is disabled. By default, this toggle button is disabled.

  • use-prefix-link-matching—Click the toggle button to enable or disable the usage of prefixes to correlate bidirectional links events.

    By default, this toggle button is disabled.

  • do-not-publish-rest-updates—Click the toggle button to allow or prevent the topology server from publishing object updates to the REST server.

    If you enable this toggle button, the topology server doesn’t publish object updates to the REST server. By default, this toggle button is disabled.

  • do-not-suppress-beacon-message—Click the toggle button to allow or suppress (prevent) beacon messages from being written to log files.

    If you enable this toggle button, the suppression of beacon messages is disabled. By default, this toggle button is disabled.

  • no-netconf-pathname-allocation—Click the toggle button to allow or prevent the topology server from checking the path names allocated to LSPs configured through NETCONF.

    If you enable this toggle button, the topology server doesn't check for path names and also doesn't set the path name for the planned LSP. By default, this toggle button is disabled.

Application Tuning

  • pce-beacon-holddown—Specify the time (in seconds) within which the topology server must receive a beacon from the PCE server. If the PCE beacon is not received within the specified time, the connection between the topology server and the PCEP server is marked as down.

    Example: 80s or 80 seconds

    Default: 90s

  • resync-unresolved-node-threshold—Specify a threshold value for unresolved objects.

    During the discovery and updation of the topology, the topology server maintains a list of network objects that cannot be resolved to nodes. If the number of unresolved objects exceeds the threshold value specified here, a resynchronization is automatically triggered with the BGP-LS topology source.

    Default: 10

  • lsp-topo-sync-timeout—Specify the frequency (in seconds) with which the topology server performs a global database synchronization of PCEP LSPs.

    Default: 120s

  • pce-restart-holddown—Specify the maximum time (in seconds) until which the topology server waits, after the PCEServer starts, to request the PCEP LSP database.

    Default: 30s

  • message-queue-low-watermark—Specify the low watermark for the messaging queue. If the number of elements in the messaging queue reaches the value specified here, the topology server resumes LSP provisioning.

    Default: 5000

  • message-queue-high-watermark—Specify the high watermark for the messaging queue. If the number of elements in the messaging queue reaches the value specified here, the topology server pauses LSP provisioning until the number of elements in the messaging queue reaches the low watermark.

    Default: 500000

  • message-queue-overflow-watermark—Specify the overflow watermark for the messaging queue. If the number of elements in the messaging queue reaches the value specified here, the topology server purges the messaging queue.

    Default: 0 (meaning no overflow watermark is set and thus, purging is disabled.)

  • pce-watermark-interval—Specify the frequency (in seconds) with which the topology server checks the high and low watermark rates for PCEP messages.

    Default: 10s

  • pce-high-watermark-timeout—Specify the maximum time (in milliseconds) that the topology server waits for the PCEP message rate to reach the low watermark, after which, it resumes the processing of PCEP messages.

    Default: 60000

  • pce-high-watermark-rate—Specify the PCEP message rate to trigger the high watermark. If the PCEP message rate reaches the value specified here, the topology server pauses the processing of PCEP messages.

    Default: -1.0 (to disable the triggering of low watermark)

  • pce-high-watermark-count-threshold—Specify the number of times the PCEP message rate must reach the high watermark, after which, it exceeds the high watermark threshold. If the count exceeds the threshold specified here, the counters for the received messages and for watermark are reset, and the pce-high-watermark-timeout is updated.

    Default: 3

  • pce-low-watermark-rate—Specify the PCEP message rate to trigger the low watermark. If low watermark is triggered, the topology server resumes the processing of PCEP messages.

    Default: -1.0 (to disable the triggering of low watermark)

  • pce-low-watermark-count-threshold—Specify the number of times the PCEP message rate must reach the low watermark, after which, it exceeds the low watermark threshold. If the count exceeds the threshold specified here, the counters for the received messages and for watermark are reset.

    Default: 3

Data Persistence

  • persistent-storage-init-wait—Specify the maximum time (in seconds) until which the topology server waits for the persistent storage connection to be established. If the wait time exceeds the specified value, the topology server exits the topology server application with an initialization failure.

    Example: 10s or 10seconds

    Default: 45s

  • network-snapshot-store-path—Specify the output directory in which you want to save a snapshot of the network topology.

    Default: /opt/northstar/data/network_archive/NorthStar

  • file-store-path—Specify the default data output directory for file stores.

    Default: /opt/northstar/data

  • debug-file-store-path—Specify the default data output directory for debug output files.

    Default: /opt/northstar/data

  • network-snapshot-store-interval—Specify the maximum time (in seconds) until which the network topology snapshot must be stored in the PostgreSQL database.

    Example: 3000s or 3000seconds

    Default: 3600s

  • persist-lsp-topology-object—Click the toggle button to enable or disable the persistence of the LSP topology object in the PostgreSQL database.

    By default, this toggle button is disabled.

  • do-not-persist-pcep-lsp-events—Click the toggle button to enable or disable the persistence of PCEP LSP events in the PostgreSQL database.

    If you enable this toggle button, PCEP LSP events are not stored in the PostgreSQL database. By default, this toggle button is disabled.

  • persist-pcep-pcc-node-events—Click the toggle button to enable or disable the persistence of PCEP node events in the PostgreSQL database.

    By default, this toggle button is disabled.

  • do-not-persist-topology-advertisements—Click the toggle button to enable or disable the persistence of BGP-LS advertisements in the PostgreSQL database.

    If you enable this toggle button, BGP-LS advertisements are not stored in the PostgreSQL database. By default, this toggle button is disabled.

  • do-not-persist-provision-requests—Click the toggle button to enable or disable the persistence of provisioning requests (in JSON format) in the PostgreSQL database.

    If you enable this toggle button, provisioning requests are not stored in the PostgreSQL database. By default, this toggle button is disabled.

  • do-not-persist-lsp-events—Click the toggle button to disable the persistence of LSP events (event description and object data) in the PostgreSQL database.

    If you enable this toggle button, LSP events are not stored in the PostgreSQL database. By default, this toggle button is disabled.

  • do-not-persist-node-events—Click the toggle button to enable or disable the persistence of node events (event description and object data) in the PostgreSQL database.

    If you enable this toggle button, node events are not stored in the PostgreSQL database. By default, this toggle button is disabled.

  • do-not-persist-link-events—Click the toggle button to enable or disable the persistence of link events (event description and object data) in the PostgreSQL database.

    If you enable this toggle button, link events are not stored in the PostgreSQL database. By default, this toggle button is disabled.

  • do-not-persist-lsps—Click the toggle button to enable or disable the persistence of LSP data in the PostgreSQL database.

    If you enable this toggle button, LSP data is not stored in the PostgreSQL database. By default, this toggle button is disabled.

    Note: We recommend that you do not disable the persistence of LSP data (that is, we recommend that you do not enable the toggle button).

  • persist-topology-snapshot—Click the toggle button to enable or disable the persistence of the topology snapshot in the PostgreSQL database.

    By default, this toggle button is disabled.

  • persist-demand-events—Click the toggle button to enable or disable the persistence of demand events in the PostgreSQL database.

    By default, this toggle button is disabled.

    Note: To enable the persistence of demand events, persistence of LSP events is required.

  • persist-topology-objects-to-file—Click the toggle button to enable or disable saving the BGP Monitoring Protocol (BMP) events to a file in binary format.

    By default, this toggle button is disabled.

In-memory Datastore

in-memory-datastore:

  • connection-pool-size—Specify the maximum number of connections to be maintained in the pool.

    Default: 5

  • reconnect-delay—Specify the delay (in milliseconds) between reconnection attempts.

    Default: 1000

  • reconnect-retries—Specify the maximum number of datastore reconnection attempts to be allowed.

    Default: 1000

Messaging Bus

  • reconnect-retries—Specify the number of reconnection attempts (0 indicates no attempts and -1 indicates infinite retries) to be allowed.

    Default: -1

  • reconnect-delay—Specify the delay (in milliseconds) between reconnection attempts.

    Default: 1000

  • max-channels—Specify the maximum number of channels that can be multiplexed over a single connection.

    Default: 128

Persistent Datastore

  • Persistent datastore settings:

    • connection-pool-size—Specify the maximum number of connections to be maintained in the pool.

      Default: 5

    • reconnect-delay—Specify the delay (in milliseconds) between reconnection attempts.

      Default: 5000

  • Log Destination:

    • name—Specify a unique name for the log destination settings.

    • level—From the list, select the severity level of the log messages. The available options are:

      • emergency—The system is unusable.

      • alert—Immediate action is needed.

      • critical—Critical condition exists.

      • error—Error condition.

      • warning—Warning condition (this is the default value).

      • notice—Normal but significant condition.

      • info—Information message.

      • debug—Debug message.

      • trace—Trace message.

      • – (none)—No severity level.

Topology Acquisition

  • retry-before-exit-count—Specify the number of times the topology server requests a topology refresh (after it connects to a BMP topology source) to obtain the topology that contains the links. If the topology server doesn’t receive the topology even after the specified refresh requests, it exits the topology server application.

    Default: 0 (meaning infinite retries)

  • retry-delay—Specify the maximum time (in seconds) that the topology server waits before requesting a topology refresh again (after it connects to a BMP topology source).

    Example: 30s or 30seconds

    Default: 5s

  • reconnection-count—Specify the number of times the topology server tries to reconnect to the BGP-LS topology source before exiting the topology server application.

    Default: 0 (meaning infinite retries)

  • reconnection-delay—Specify the maximum time (in seconds) that the topology server waits before attempting to reconnect to the BGP-LS topology source.

    Example: 30s or 30seconds

    Default: 5s

  • refresh-holddown—Specify the maximum time (in seconds) that the topology server waits to request for a topology refresh after it connects to a BMP topology source but doesn’t receive the topology.

    Example: 100s or 100seconds

    Default: 300s

  • eor-timeout—: Specify the maximum time (in seconds) that the topology server waits to receive the topology from the BGP-LS topology source. After the complete topology is sent, the topology source sends an end-of-Routing Information Base (end-of-RIB or EOR) message that indicates the completion of topology update. If the topology server doesn’t receive this EOR message within the time that you specify here, an EOR timeout is triggered and the topology server sends another topology refresh request.

    Example: 15s or 15seconds

    Default: 20s

Log Destination

  • name—Displays the name for the log destination settings.

  • level—From the list, select the severity level of the log messages. The available options are:

    • emergency—The system is unusable.

    • alert—Immediate action is needed.

    • critical—Critical condition exists.

    • error—Error condition.

    • warning—Warning condition (this is the default value).

    • notice—Normal but significant condition.

    • info—Information message.

    • debug—Debug message.

    • trace—Trace message.

    • – (none)—No severity level.

Table 2 lists the effects of resetting or synchronizing the network model.

Table 2: Effects of Resetting or Synchronizing the Network Model

Element

Is the element removed from the database?

Is the item sent back to the controller by the live network?

Could data be lost?

Reset

Sync

Reset

Sync

Reset

Sync

IP nodes

Yes

No

Yes

Yes

Yes for design attributes, such as user-defined node name

No

IP links

Yes

No

Yes

Yes

Yes for design attributes such as Comment

No

PCC-controlled LSPs

Yes

No

Yes

Yes

No

No

PCC-delegated LSPs

Yes

No

Yes for PCEP attributes

Yes

Yes for non-PCEP attributes such as design flags

No

PCE-initiated LSPs

Yes

No

Yes for PCEP attributes

Yes

Yes for non-PCEP attributes such as design flags

No

Multilayer nodes

Yes

No

Yes

No

Yes for designed attributes such as user-defined names

No

Multilayer links

Yes

No

Yes

No

Yes for design attributes such as Comment

No

Interlayer links

Yes

No

No

Yes, links mapped to known nodes are re-sent.

Yes

Yes, access links to unknown nodes are lost and need to be recreated

Multilayer-derived facilities

Yes

No

Yes

No

No

No

Link-derived facilities

Yes

Yes

Yes

Yes

Yes

Yes

Ongoing maintenance events

No

No

N/A

N/A

No

No

Future maintenance events

Yes

No

N/A

N/A

Yes

No

Ongoing scheduled LSPs

No

No

N/A

N/A

Yes (scheduled LSP is never terminated)

No

Future scheduled LSPs

Yes

No

N/A

N/A

Yes

No

Device profiles

No

No

N/A

N/A

No

No

Router latitude and longitude

No

No

N/A

N/A

No

No

Router grouping

No

No

N/A

N/A

No

No

Users table

No

No

N/A

N/A

No

No

Saved map layout

No

No

N/A

N/A

No

No

Events

No

No

N/A

N/A

No

No

Scheduled path optimization

No

No

N/A

N/A

No

No

It’s worth stressing again that Reset Network Model is a drastic action that wipes out both the network data model and all the information you have manually provided through the Add or Modify functions in the network information table (user model data). We strongly recommend that you perform this action only if JTAC instructs you to do so.

Related Documentation