Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Announcement: Try the Ask AI chatbot for answers to your technical questions about Juniper products and solutions.

close
header-navigation

Solutions

Featured solutions AI Campus and branch Data center WAN Security Service provider Cloud operator Industries
Campus and Branch

Welcome to the NOW Way to Wi-Fi

Take your networking performance to new heights with a modern, cloud-native, AI-Native architecture. Only Juniper can help you unleash the full potential of Wi-Fi 7 with our AI-Native platform for innovation.
Prepare for liftoff
Business intelligence analyst dashboard on virtual screen. Big data Graphs Charts.

AI Data Center Networking

Juniper’s AI data center solution is a quick way to deploy high performing AI training and inference networks that are the most flexible to design and easiest to manage with limited IT resources.
Find out more
Enterprise AI-Native Networking

Enterprise AI‑Native Routing

Juniper's Ai-Native routing solution delivers robust 400GbE and 800GbE capabilities for unmatched performance, reliability, and sustainability at scale.
Explore enterprise routing
Zero trust security

Ops4AI Lab

Visit our lab in Sunnyvale, CA and see our AI data center solution for yourself. You can try out your own model’s functionality and performance, too.
Visit the lab
Enterprise AI-Native Networking

Enterprise AI‑Native Routing

Juniper's Ai-Native routing solution delivers robust 400GbE and 800GbE capabilities for unmatched performance, reliability, and sustainability at scale.
Explore enterprise routing
Higher Education

Shaping Student Experiences: The NOW Way to Build Higher Education Networks

Juniper Networks CIO Sharon Mandell and a virtual summit of C-level IT leaders from prestigious institutions discuss ongoing efforts to support digital transformation on campus.
Watch now
Hand on tablet with healthcare overlay of graphics

Security in healthcare

In this IDC Spotlight report, discover how AI networking can automate and strengthen a healthcare ecosystem to defeat criminals and prevent loss. 
Gain insights into ecosystem security
Retail

The Future of In-Store Technologies

Retail experts Kevin McCartan, Senior IT Service Delivery Engineer at Musgrave; Jack Stratten of Insider Trends; and Christian Gilby, Senior Director of Product Marketing at Juniper Networks, discuss customer experiences.
See the future

Products

Wireless access Wired access SD-WAN / SASE Routing and switching Security Mist AI™ Management software Network operating system Blueprint for AI-Native Acceleration Optics
  • Operations
ACX7020 router

Juniper ACX7020 Cloud Metro Access Router

Legacy networks simply cannot meet the demands of today’s rapidly evolving metro landscape. Unlock a new generation of highly scalable architectures and automated operations with the Juniper ACX7020. 
Learn more
EX4000 Ethernet Switch

Next-gen AI-Native EX4000 line of switches

Lack of AI innovation from your current networking vendor slowing you down? Embrace Juniper’s cloud-native, AI-Native access switches that support every level and layer, across nearly every deployment.
Discover how
The Q and AI text with an image of Bob Friday and Kedar Dhuru.

The Q&AI Podcast

Delivering practical solutions and enriching discussions, this podcast series is a vital resource for those seeking an in-depth exploration of AI's transformative potential.
Catch the latest episode

Services

Services
Services AI Care

Juniper AI Care Services Revolutionize Your Service Experience

Our industry-first AI-Native services couple AIOps with our deep expertise across the full network life cycle. You can move from reactive response to proactive insight and action.
Explore AI Care Services
Services AI Data Center

Juniper AI Data Center Deployment Services Optimize Your AI Model Runs

We use our expertise and validated designs to help design, deploy, validate and tune networks, including GPUs and storage, to get the most from your AI infrastructure operation.
Learn about AI Data Center Deployment Services

Partners

Partners

Support and Documentation

Support and Documentation

Learn

About Juniper Training Events The Feed Resources Technology learning topics Thought leadership and insights
Audience raising hands up while businessman is speaking in training at the office.

Juniper certification and training news

See the latest
Ringing of the bell

All global events

See the latest
AI-native-now

AI-Native NOW event series

Explore events
AINN AI Innovation Impact Virtual Event

AI-Native NOW: AI Innovation and Impact

Register NOW
Juniper's Christina Hendrix at the head of a conference table. With the text "The NOW Way to Network" overlayed, with "NOW" emphasizing the "O" in green color.

The NOW Way to Network

Watch the video series
AI Native Now

Executive insights

Dive deep with leading experts and thought leaders on all the topics that matter most to your business, from AI to network security to driving rapid, relevant transformation for your business.
Learn more
A keynote speaker giving a presentation at a conference. There are dozens of people sitting around them. The presentation is displayed via projector on all the walls in the room.

Leadership voices

Juniper Networks’ leaders operate on the front lines of creating the network of the future. Take a look around to see what’s on their minds.
Watch now
Bob Friday and Jessica Garrison speaking

Bob Friday Talks

Join Bob as he ventures into all the knowns -- and -- unknowns -- of AI.
Catch the latest episode
Documentation
Menu
License Guide
Quick Starts
Validated Designs
Home Documentation
NorthStar ControllerNorthStar Planner
NorthStar Controller NorthStar Controller/Planner Getting Started Guide Installation and Configuration Overview

NorthStar Controller/Planner Getting Started Guide

keyboard_arrow_up
close
keyboard_arrow_left
NorthStar Controller/Planner Getting Started Guide
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
ON THIS PAGE
keyboard_arrow_right

Upgrading from Pre-4.3 NorthStar with Analytics

date_range 18-Aug-23
arrow_backward
arrow_forward

The special upgrade procedure described in this topic is only necessary if you use NorthStar Analytics and you are upgrading NorthStar from a version of NorthStar earlier than Release 4.3. In all other cases, you can install NorthStar using the procedure described in Installing the NorthStar Controller.

This procedure involves uninstalling and reinstalling NorthStar analytics in addition to upgrading the NorthStar application, and is a little different depending on whether you have analytics installed on the same server as the NorthStar application or not.

Export Existing Data from the NorthStar Application Server (Recommended)

This procedure involves running a utility called es_export_import_util.py on the NorthStar application server to export and save your existing data prior to upgrade.

The utility exports data to a file called exportdata.tar.Z in the /opt/northstar/northstar_bundle_x.x.x/db_migration directory. Ensure that this directory has available space equivalent to at least 10% the size of your Elasticsearch database. For example, a 10GB Elasticsearch database would require 1GB in the /opt/northstar/northstar_bundle_x.x.x/db_migration directory. When you begin this procedure, the script will tell you how much memory is required and give you the option to stop the procedure if you do not have enough space to continue.

The amount of time required for the export utility to complete depends on the number of export days and Elasticsearch cache memory/CPU cores you have. You can use the utility’s -l option to reduce the number of export days.

You can use the following command to see the utility’s full set of supported export options:

content_copy zoom_out_map
es_export_import_util.py --help

To export and save your existing data, use the following procedure:

  1. Log in to the NorthStar application server.
  2. Navigate to the db_migration directory:
    content_copy zoom_out_map
    [root db_migration]# cd /opt/northstar/northstar_bundle_x.x.x/db_migration
  3. Launch the export utility and type yes to continue if you agree with the setup information provided. An example follows:
    content_copy zoom_out_map
    [root db_migration]# ./es_export_import_util.py -exp

Warning 1: Time taken for export util depends on number of export days and ES cache memory/CPU cores. Reduce the considered number of days using -l option.
Warning 2: Total indexes=6 and total DB indexes size=599MB. Average DB size of an index=99MB and max export DB limit=50000MB.
Considering export data for last 6 days, requires disk space of 59.4MB under current dir

Please enter 'yes' or 'no' to proceed:yes
Starting ES data export
Logs stored at /opt/northstar/logs/es_export_import.log
Export required for datatype=jvision-lsp for the last 6 days
Export required for datatype=jvision-ifd for the last 6 days
Export required for datatype=jvision-ifl for the last 6 days
Export required for datatype=demands for the last 6 days
Export required for datatype=as_demands for the last 6 days
Export required for datatype=rpm-ifl for the last 6 days
Export required for datatype=jnx-cos for the last 6 days
Starting 2 EsExportWorker process with total ES query count in queue=144
Starting process EsExportWorker-0
Starting process EsExportWorker-1
Total rollups data added=13187( jvision-lsp=743 jvision-ifd=8136 jvision-ifl=3230 demands=0 as_demands=0 rpm-ifl=1079 jnx-cos=0) EsExportWorkers-1 completed in minutes=1
Total rollups data added=13378( jvision-lsp=637 jvision-ifd=8424 jvision-ifl=3325 demands=0 as_demands=0 rpm-ifl=993 jnx-cos=0) EsExportWorkers-0 completed in minutes=1
All EsExportWorker processes completed.
Rollup data exported to ./exportdata.tar.gz . Total time taken in minutes=1

Upgrade Procedure with NorthStar Application and NorthStar Analytics on the Same Server

Use the following procedure:

  1. Download the NorthStar software and untar the NorthStar_Bundle. See Installing the NorthStar Controller.
  2. Navigate to the NorthStar directory:
    content_copy zoom_out_map
    [root]# cd /opt/northstar/northstar_bundle_x.x.x
  3. Uninstall analytics:
    content_copy zoom_out_map
    [root]# ./uninstall-analytics.sh
  4. Upgrade the NorthStar application:
    content_copy zoom_out_map
    [root]# ./install.sh
  5. Reinstall NorthStar analytics:
    content_copy zoom_out_map
    [root]# ./install-analytics.sh

Upgrade Procedure with NorthStar Application and NorthStar Analytics on Separate Servers

Use the following procedure:

  1. Download the NorthStar software and untar the NorthStar_Bundle. See Installing the NorthStar Controller.
  2. On the NorthStar application server, navigate to the NorthStar directory and upgrade the NorthStar application:
    content_copy zoom_out_map
    [root]# cd /opt/northstar/northstar_bundle_x.x.x
[root]# ./install.sh
  3. On each analytics server, uninstall and reinstall NorthStar analytics:
    content_copy zoom_out_map
    [root]# ./uninstall-analytics.sh
(wait for completion)
[root]# ./install-analytics.sh
  4. On the NorthStar application server, prepare and redeploy HA analytics data collector settings:
    content_copy zoom_out_map
    [root]# /opt/northstar/utils/net_setup.py

    Select G (Analytics Data Collector Setting) from the main menu, and then B (Prepare and Deploy HA Analytics Data Collector Setting) from the Analytics Data Collector Configuration Settings menu. See Installing Data Collectors for Analytics for more information.

  5. On the NorthStar application server, ensure that analytics data collector connectivity is UP. From the net_setup.py utility main menu, select G (Analytics Data Collector Setting), and then select 9 (Test Analytics Data Collector Connectivity) from the Analytics Data Collector Configuration Settings menu.

Update the Netflow Aggregation Setting

The netflowd process analyzes traffic from the router and displays it in the Demands tab in the network information table. By default, Netflow aggregates traffic by PE, but for some applications (such as EPE), you would want the traffic aggregated by prefix. The Netflow aggregate by prefix setting controls how traffic is aggregated. If the parameter is enabled, Netflow aggregates all traffic from a specific ingress PE router to a specific destination (prefix) within the defined period of time.

Between NorthStar Controller Releases 4.2.0 and 4.3.0, the possible values for the Netflow aggregate_by_prefix parameter changed. If you are upgrading from Release 4.2.0 or earlier, you must modify the setting to reflect a valid value for your post-4.2.0 release. See Table 1

Table 1: Netflow Aggregate by Prefix Values by NorthStar Release

NorthStar Releases Earlier than 4.2.0

NorthStar Releases 4.3.0 and Later

Netflow aggregate by prefix possible values

  • 0 = aggregation by prefix is disabled (this is the default)

  • 1 = aggregation by prefix is enabled

Note:

NorthStar Releases 4.2.0 and earlier: netflow_aggregate_by_prefix parameter maintained in the northstar.cfg file.

  • always = aggregation by prefix is enabled

  • disable = aggregation by prefix is disabled

  • unknown-destination = aggregation by prefix is enabled even though the flow is missing a BGP next hop (BGP_NH) or has a BGP_NH of 0.0.0.0

Note:

NorthStar Releases 4.3.0 through 6.0.0: modify the netflow_aggregate_by_prefix parameter in the /opt/northstar/data/northstar.cfg file.

NorthStar Releases 6.1.0 and later: modify the aggregate-by-prefix setting using the NorthStar CLI set northstar analytics netflowd aggregate-by-prefix command.

Import Existing Data (Recommended)

In this procedure, you run the es_export_import_util.py utility again on the NorthStar application server to import the data you previously exported and saved.

  1. Log in to the NorthStar application server.
  2. Navigate to the db_migration directory:
    content_copy zoom_out_map
    [root db_migration]# cd /opt/northstar/northstar_bundle_x.x.x/db_migration
  3. Launch the import utility:
    content_copy zoom_out_map
    [root db_migration]# ./es_export_import_util.py -imp

Related Documentation

arrow_backward PREVIOUS NorthStar Controller System Requirements
NEXT arrow_forward Guidance for Migrating to CentOS 7.x for NorthStar 6.0.0 and Later
footer-navigation

© 1999 - 2025 Juniper Networks, Inc. All rights reserved.

Scroll to top