Juniper NorthStar Planner User guide

NorthStar Planner Desktop Application

User Guide

Release

Published

2021-02-11

6.2.0

Juniper Networks, Inc.

1133 Innovation Way

Sunnyvale, California 94089

USA

408-745-2000

www.juniper.net

Juniper Networks, the Juniper Networks logo, Juniper, and Junos are registered trademarks of Juniper Networks, Inc. in

the United States and other countries. All other trademarks, service marks, registered marks, or registered service marks

are the property of their respective owners.

Juniper Networks assumes no responsibility for any inaccuracies in this document. Juniper Networks reserves the right

to change, modify, transfer, or otherwise revise this publication without notice.

NorthStar Planner Desktop Application User Guide

6.2.0

The information in this document is current as of the date on the title page.

YEAR 2000 NOTICE

Juniper Networks hardware and software products are Year 2000 compliant. Junos OS has no known time-related

limitations through the year 2038. However, the NTP application is known to have some difficulty in the year 2036.

END USER LICENSE AGREEMENT

The Juniper Networks product that is the subject of this technical documentation consists of (or is intended for use with)

Juniper Networks software. Use of such software is subject to the terms and conditions of the End User License Agreement

(“EULA”) posted at https://support.juniper.net/support/eula/. By downloading, installing or using such software, you

agree to the terms and conditions of that EULA.

ii

Table of Contents

About the Documentation | xii

Documentation and Release Notes | xii

Documentation Conventions | xii

Documentation Feedback | xv

Requesting Technical Support | xv

Self-Help Online Tools and Resources | xvi

Creating a Service Request with JTAC | xvi

Introduction

1

NorthStar Application UI Overview | 18

Comparison Between NorthStar Controller and NorthStar Planner | 18

Browser Compatibility | 19

Logging in to NorthStar | 19

User Inactivity Timer | 21

Key NorthStar Planner Features | 21

NorthStar Planner Power Features | 23

Supported Hardware | 24

Juniper Networks | 24

Cisco Systems | 24

Alcatel | 24

Huawei | 24

Main Window

2

Main Window Overview | 26

File Manager

3

The File Manager Window | 32

File Manager Toolbar | 33

File Manager Left Pane | 35

iii

File Manager Right-Click Menu | 36

File Manager Spec File | 38

Text Editor | 51

Config Editor (Router and Switch) | 54

Topology Window

4

Topology Window Overview | 64

Center Pane Map | 65

Left Pane Legend | 66

Map Filters | 70

Filters > Protocols | 70

Filters > Types | 71

Filters > Routing Instances | 72

Filters > Advanced | 73

Map Elements | 74

Network Elements > Nodes | 74

Network Elements > Links | 75

Network Elements > Facilities | 76

Utilization Legends | 77

Subviews > Types | 80

Right Pane Toolbar | 83

Map Popup Menus | 87

Map Views | 87

Grouping Popup Menus | 89

Selection Options | 91

Custom URLs | 92

Labels Menu | 92

Layout | 95

Internet Map at Click | 97

Line Widths | 97

iv

Background Image | 97

Country Maps | 99

Find | 99

Refresh | 99

Zoom | 100

Print | 100

Export | 100

File Menu

5

File Menu Functions | 105

File > Open Network Browser | 106

File > Load Network Files | 107

Saving a File | 109

Import Network Wizard

6

Import Network Wizard | 112

Introduction | 112

Routers and Switches (IP/MPLS only) | 114

NorthStar Planner Config File | 115

OSPF Database | 115

ISIS Database | 116

Marconi CLI | 116

Nortel PND | 117

Nortel Virtual Router | 117

Tunnel Path Extraction | 118

Network Menu

7

Network Menu Overview | 121

Network Menu: Summary | 122

Filter | 124

Search by Property | 124

Advanced Search | 125

Navigation Page Setup | 126

v

Table Options | 127

Network Menu: Nodes | 129

Network Menu: Links | 135

Links: General Tab | 137

Links: Location Tab | 139

Links: Capacity Tab | 139

Links: MPLS/TE Tab | 140

Links: Protocols Tab | 141

Links: Attributes Tab | 141

Links: CoS Policy Tab | 142

Adding Links | 142

Modifying Links | 142

Right-Click Menu Options | 143

Network Menu: Interfaces | 143

Network Menu: Demands | 146

Demands: Properties Tab | 147

Demands: Paths Tab | 148

Adding a Single Demand | 149

Demand Type Parameter Generation | 153

Adding Multiple Demands | 155

Adding One Hop | 156

Modifying a Single Demand | 157

Modifying Multiple Demands | 158

Right-Click Menu Options | 160

Notes on Priority and Preemption | 160

Demand Statistics View | 161

Traffic Load | 162

End-to-End Delay | 163

Find Demands Filter | 164

Network Menu: Tunnels | 165

Properties Tab | 165

Paths Tab | 166

vi

Right-Click Menu Options in the Tunnels Window | 167

Tunnel Type Parameter Generation | 168

Virtual Trunk Tab | 170

Network Menu: Sites | 171

Network Menu: SRLG | 173

Network Menu: Owners | 174

Nework Menu: Templates | 174

Network Menu: OSPF Areas/Domains | 177

Network Menu: QoS Manager | 177

Network Menu: Service Type | 178

Network Menu: Admin Weight | 179

Network Menu: Path and Capacity | 180

Network Menu: Show Site Demands | 183

Network Menu: Aggregate Demands/Tunnels | 184

Design Menu

8

Design Menu Overview | 187

Design Menu: Backbone Design | 187

Resize | 187

Route Paths | 189

Design Menu: Net Groom | 190

Path Diversity Design | 194

Design Menu: Configlets/Delta | 201

Design Menu: Metric Optimization | 201

Design Menu: P2MP Tree Design Window | 202

vii

Simulation Menu

9

Simulation Menu Overview | 206

Simulation Menu: Predefined Scenarios | 206

Scripts | 207

Report Options | 210

Advanced Options | 211

Interactive Scenarios | 212

Simulation Menu: Time-Based Simulation | 215

Traffic Menu

10

Traffic Menu Overview | 218

Traffic Menu: Traffic Load | 218

Traffic Menu: Trending | 221

Network Files | 221

Other Files | 223

Traffic Menu: Growth | 227

Traffic Menu: Traffic Aggregation | 228

Performance Data Indices Used for Aggregated Queries | 229

Generate Options | 230

Range Options | 230

Series Options | 231

Statistic Options | 231

Interval Options | 232

Output Directory and Output Runcode | 232

Load New Data | 232

Using the Generated Trafficload File | 233

Addendum: Traffic Data Input Files | 237

Addendum: Accessing Traffic Charts | 239

Addendum: Interpreting the Traffic Charts | 240

viii

Inventory Menu

11

Inventory Menu Overview | 247

Components of the Hardware Model | 247

Collecting Hardware Inventory | 247

Importing CLI Output Commands | 247

Importing and Saving | 248

Inventory Menu: Hardware Inventory | 250

Hardware Inventory Summary | 251

Devices List | 251

Line Cards | 255

Physical Interfaces | 257

Transceivers | 258

Miscellaneous Parts | 260

Extensive Parts List | 261

Hardware Integrity | 261

Device Usage | 262

Line Card Usage | 264

Customer Usage | 265

Hardware Capex | 266

Equipment View | 267

Event View | 278

Hardware Equipment Cost | 280

Templates | 282

Report Manager

12

Report Manager Window Overview | 291

List of Network Reports | 299

List of Tunnel Layer Network Reports | 304

List of Simulation Reports | 305

List of Configuration Reports (Router Only) | 308

ix

Customized Reports | 309

Report Manager: Network Reports | 316

Demand Reports | 316

Link Reports | 322

Interface Traffic Reports | 331

Group Reports | 334

Node Reports | 342

VPN Reports | 344

Protocols Reports | 345

BGP Reports | 350

Report Manager: Tunnel Reports | 354

Report Manager: Simulation Reports | 355

Report Manager: Configuration Reports | 357

Admin Menu

13

Accessing the User Administration Window | 362

Creating User Groups and Permissions | 362

Creating Users / Assigning Users to Groups | 365

License File Manager | 367

Tools Menu

14

Tools Menu Overview | 369

Tools: Options Menu | 369

General Options | 370

Config Editor Options | 370

Path Placement Options | 371

Failure Simulation Options | 379

Resize Options | 381

Map Preferences | 381

Report Options | 384

x

Appendix A: Input Files Format

15

Spec File | 388

Backbone Data | 388

Control Files | 395

Cost Files | 396

Appendix B: Search Preferences

16

Exact Match Strings | 400

xi

About the Documentation

IN THIS SECTION

Documentation and Release Notes | xii

Documentation Conventions | xii

Documentation Feedback | xv

Requesting Technical Support | xv

Use this guide to access information about the NPAT (Network Planning and Analysis Tools) and NorthStar

Planner desktop application user interface. See the NorthStar Planner Feature Guide for details about

router-specific features such as MPLS, BGP, VPN.

Documentation and Release Notes

To obtain the most current version of all Juniper Networks®technical documentation, see the product

documentation page on the Juniper Networks website at https://www.juniper.net/documentation/.

If the information in the latest release notes differs from the information in the documentation, follow the

product Release Notes.

Juniper Networks Books publishes books by Juniper Networks engineers and subject matter experts.

These books go beyond the technical documentation to explore the nuances of network architecture,

deployment, and administration. The current list can be viewed at https://www.juniper.net/books.

Documentation Conventions

Table 1 on page xiii defines notice icons used in this guide.

xii

Table 1: Notice Icons

DescriptionMeaningIcon

Indicates important features or instructions.Informational note

Indicates a situation that might result in loss of data or hardware

damage.

Caution

Alerts you to the risk of personal injury or death.Warning

Alerts you to the risk of personal injury from a laser.Laser warning

Indicates helpful information.Tip

Alerts you to a recommended use or implementation.Best practice

Table 2 on page xiii defines the text and syntax conventions used in this guide.

Table 2: Text and Syntax Conventions

ExamplesDescriptionConvention

To enter configuration mode, type

the configure command:

user@host> configure

Represents text that you type.Bold text like this

user@host> show chassis alarms

No alarms currently active

Represents output that appears on

the terminal screen.

Fixed-width text like this

•A policy term is a named structure

that defines match conditions and

actions.

•Junos OS CLI User Guide

•RFC 1997, BGP Communities

Attribute

•Introduces or emphasizes important

new terms.

•Identifies guide names.

•Identifies RFC and Internet draft

titles.

Italic text like this

xiii

Table 2: Text and Syntax Conventions (continued)

ExamplesDescriptionConvention

Configure the machine’s domain

name:

[edit]

root@# set system domain-name

domain-name

Represents variables (options for

which you substitute a value) in

commands or configuration

statements.

Italic text like this

•To configure a stub area, include

the stub statement at the [edit

protocols ospf area area-id]

hierarchy level.

•The console port is labeled

CONSOLE.

Represents names of configuration

statements, commands, files, and

directories; configuration hierarchy

levels; or labels on routing platform

components.

Text like this

stub <default-metric metric>;Encloses optional keywords or

variables.

< > (angle brackets)

broadcast | multicast

(string1 |string2 |string3)

Indicates a choice between the

mutually exclusive keywords or

variables on either side of the symbol.

The set of choices is often enclosed

in parentheses for clarity.

| (pipe symbol)

rsvp { # Required for dynamic MPLS

only

Indicates a comment specified on the

same line as the configuration

statement to which it applies.

# (pound sign)

community name members [

community-ids ]

Encloses a variable for which you can

substitute one or more values.

[ ] (square brackets)

[edit]

routing-options {

static {

route default {

nexthop address;

retain;

}

Identifies a level in the configuration

hierarchy.

Indention and braces ( { } )

Identifies a leaf statement at a

configuration hierarchy level.

; (semicolon)

GUI Conventions

xiv

Table 2: Text and Syntax Conventions (continued)

ExamplesDescriptionConvention

•In the Logical Interfaces box, select

All Interfaces.

•To cancel the configuration, click

Cancel.

Represents graphical user interface

(GUI) items you click or select.

Bold text like this

In the configuration editor hierarchy,

select Protocols>Ospf.

Separates levels in a hierarchy of

menu selections.

>(bold right angle bracket)

Documentation Feedback

We encourage you to provide feedback so that we can improve our documentation. You can use either

of the following methods:

•Online feedback system—Click TechLibrary Feedback, on the lower right of any page on the Juniper

Networks TechLibrary site, and do one of the following:

•Click the thumbs-up icon if the information on the page was helpful to you.

•Click the thumbs-down icon if the information on the page was not helpful to you or if you have

suggestions for improvement, and use the pop-up form to provide feedback.

•E-mail—Send your comments to [email protected]. Include the document or topic name,

URL or page number, and software version (if applicable).

Requesting Technical Support

Technical product support is available through the Juniper Networks Technical Assistance Center (JTAC).

If you are a customer with an active Juniper Care or Partner Support Services support contract, or are

xv

covered under warranty, and need post-sales technical support, you can access our tools and resources

online or open a case with JTAC.

•JTAC policies—For a complete understanding of our JTAC procedures and policies, review the JTAC User

Guide located at https://www.juniper.net/us/en/local/pdf/resource-guides/7100059-en.pdf.

•Product warranties—For product warranty information, visit https://www.juniper.net/support/warranty/.

•JTAC hours of operation—The JTAC centers have resources available 24 hours a day, 7 days a week,

365 days a year.

Self-Help Online Tools and Resources

For quick and easy problem resolution, Juniper Networks has designed an online self-service portal called

the Customer Support Center (CSC) that provides you with the following features:

•Find CSC offerings: https://www.juniper.net/customers/support/

•Search for known bugs: https://prsearch.juniper.net/

•Find product documentation: https://www.juniper.net/documentation/

•Find solutions and answer questions using our Knowledge Base: https://kb.juniper.net/

•Download the latest versions of software and review release notes:

https://www.juniper.net/customers/csc/software/

•Search technical bulletins for relevant hardware and software notifications:

https://kb.juniper.net/InfoCenter/

•Join and participate in the Juniper Networks Community Forum:

https://www.juniper.net/company/communities/

•Create a service request online: https://myjuniper.juniper.net

To verify service entitlement by product serial number, use our Serial Number Entitlement (SNE) Tool:

https://entitlementsearch.juniper.net/entitlementsearch/

Creating a Service Request with JTAC

You can create a service request with JTAC on the Web or by telephone.

•Visit https://myjuniper.juniper.net.

•Call 1-888-314-JTAC (1-888-314-5822 toll-free in the USA, Canada, and Mexico).

For international or direct-dial options in countries without toll-free numbers, see

https://support.juniper.net/support/requesting-support/.

xvi

1

CHAPTER

Introduction

NorthStar Application UI Overview | 18

Key NorthStar Planner Features | 21

NorthStar Planner Power Features | 23

Supported Hardware | 24

NorthStar Application UI Overview

NorthStar has two user interfaces (UIs):

•NorthStar Controller—web UI for working with a live network.

•NorthStar Planner—Simulates the effect of various scenarios on the network, without affecting the live

network. The Planner is currently in transition from a desktop application to a web UI. Until the transition

is complete, both the full-featured desktop application and the in-development web UI are available and

documented separately.

Comparison Between NorthStar Controller and NorthStar Planner

Table 3 on page 18 summarizes the major use cases for the NorthStar Controller and NorthStar Planner.

NOTE: All user administration (adding, modifying, and deleting users) must be done from the

NorthStar Controller web UI.

NOTE: A subset of the Planner functionality shown here is currently available in the Planner

web UI.

Table 3: Controller Versus Planner Comparison

NorthStar Planner (Java client)NorthStar Controller (web client)

Design, simulate, and analyze a network offline.Manage, monitor, and provision a live network in real-time.

Network topology map shows simulated or imported data

for nodes, links, and LSP paths.

Live network topology map shows node status, link

utilization, and LSP paths.

Network information table shows simulated or imported

data for nodes, links, and LSPs.

Network information table shows live status of nodes,

links, and LSPs.

Import or add nodes, links, and LSPs for network modeling.Discover nodes, links, and LSPs from the live network

using PCEP or NETCONF.

Add and stage LSPs for provisioning to the network.Provision LSPs directly to the network.

18

Table 3: Controller Versus Planner Comparison (continued)

NorthStar Planner (Java client)NorthStar Controller (web client)

Create or schedule simulation events to analyze the

network model from failure scenarios.

Create or schedule maintenance events to re-route LSPs

around the impacted nodes and links.

Report manager provides extensive reports for simulation

and planning.

Dashboard reports shows current status and KPIs of the

live network.

Import interface data or aggregate archived data to

generate historical statistics for querying and chart

displays.

Analytics collects real-time interface traffic or delay

statistics and stores the data for querying and chart

displays.

Browser Compatibility

For accessing the NorthStar Controller web UI, we recommend using Google Chrome and Mozilla Firefox

browsers for Windows and Mac OS. We also recommend that you keep your browser updated to a recent

version.

Logging in to NorthStar

Use this procedure to log in to the NorthStar controller. You can launch the NorthStar Planner (both web

UI and desktop) from within the NorthStar Controller.

19

1. Enter your external IP address and port number that was provided to you when you installed NorthStar

(for example, https://10.0.1.29:8443).

The NorthStar login window is displayed, as shown in Figure 1 on page 20.

Figure 1: NorthStar Login Window

2. Select Operator.

3. Enter your username and password, and click SIGN IN.

You have now logged in to the NorthStar Controller.

4. If you want to log in to the NorthStar Planner, click the four-square icon in the top right corner and

select Planner for the web UI or Planner Desktop for the desktop application. If you choose the web

UI, a new tab opens in your browser. If you choose the desktop application, you will be prompted to

download and run the desktop .jnlp executable.

NOTE: If you attempt to reach the login window, but instead, are routed to a message window

that says, “Please enter your confirmation code to complete setup,” you must go to your license

file and obtain the confirmation code as directed. Enter the confirmation code along with your

administrator password to be routed to the web UI login window. The requirement to enter the

confirmation code only occurs if the installation process was not completed correctly and the

NorthStar application needs to confirm that you have the authorization to continue.

20

Page is loading ...

Juniper NorthStar Planner User guide

This manual is also suitable for

Juniper NorthStar Planner User guide

Related papers

Other documents