This article describes how to install/upgrade to a NorthStar Service Pack.
NorthStar patches are packaged into a Service Pack, which is identified with an SP number. The higher SP version has a dependency on the lower SP version. For example, SP 2 will require SP 1 to be installed first.
First, download the patch onto the NorthStar server. In this example, we are downloading NorthStar_5.1.0-Patch-All-20200422.tgz .
NorthStar_5.1.0-Patch-All-20200422.tgz
After we extract the tgz, we will end up with the following:
[root@localhost Patches]# tar -xzvf NorthStar_5.1.0-Patch-All-20200422.tgz NorthStar_5.1.0-Patch-All-20200422/ NorthStar_5.1.0-Patch-All-20200422/ batch-install.sh NorthStar_5.1.0-Patch-All-20200422/NorthStar_5.1.0-Patch-SP2-20200422_112357-767683b_107.x86_64.rpm NorthStar_5.1.0-Patch-All-20200422/ batch-uninstall.sh NorthStar_5.1.0-Patch-All-20200422/NorthStar_5.1.0-Patch-SP1-20200122_171645-43da472_50.x86_64.rpm [root@localhost Patches]#
Installing/Upgrading to a Service Pack
Install the patch by using the batch-install.sh script. By default, if you do not provide any options, SP1 and SP2 will be installed:
batch-install.sh
root@localhost NorthStar_5.1.0-Patch-All-20200422]# ./batch-install.sh Failed to set locale, defaulting to C Loaded plugins: product-id, search-disabled-repos, security, subscription-manager This system is not registered with an entitlement server. You can use subscription-manager to register. Setting up Install Process Examining NorthStar_5.1.0-Patch-SP1-20200122_171645-43da472_50.x86_64.rpm: NorthStar_5.1.0-Patch-SP1-20200122_171645-43da472_50.x86_64 Marking NorthStar_5.1.0-Patch-SP1-20200122_171645-43da472_50.x86_64.rpm to be installed Examining NorthStar_5.1.0-Patch-SP2-20200422_112357-767683b_107.x86_64.rpm: NorthStar_5.1.0-Patch-SP2-20200422_112357-767683b_107.x86_64 Marking NorthStar_5.1.0-Patch-SP2-20200422_112357-767683b_107.x86_64.rpm to be installed Resolving Dependencies --> Running transaction check ---> Package NorthStar_5.1.0-Patch-SP1.x86_64 0:20200122_171645-43da472_50 will be installed ---> Package NorthStar_5.1.0-Patch-SP2.x86_64 0:20200422_112357-767683b_107 will be installed --> Finished Dependency Resolution Dependencies Resolved ======================================================================================================================== Package Arch Version Repository Size ========================================================================================================================Installing: NorthStar_5.1.0-Patch-SP1 x86_64 20200122_171645-43da472_50 /NorthStar_5.1.0-Patch-SP1-20200122_171645-43da472_50.x86_64 21 M NorthStar_5.1.0-Patch-SP2 x86_64 20200422_112357-767683b_107 /NorthStar_5.1.0-Patch-SP2-20200422_112357-767683b_107.x86_64 124 M Transaction Summary ========================================================================================================================Install 2 Package(s) Total size: 144 M Installed size: 144 M Is this ok [y/N]: Y Downloading Packages: Running rpm_check_debug Running Transaction Test Transaction Test Succeeded Running Transaction Installing : NorthStar_5.1.0-Patch-SP1-20200122_171645-43da472_50.x86_64 1/2 Running /opt/northstar/patch/SP1/deliver/apply-patch.sh Application is detected. Applying config /opt/northstar/patch/SP1/deliver/application.cfg ### Stop northstar_pcs:* ### northstar_pcs:PCViewer: stopped northstar_pcs:PCServer: stopped northstar_pcs:configServer: stopped ### Replace /opt/pcs/bin PCServer ### Replacing /opt/pcs/bin/PCServer... ### Start northstar_pcs:* ### northstar_pcs:PCViewer: started northstar_pcs:PCServer: started northstar_pcs:configServer: started Installing : NorthStar_5.1.0-Patch-SP2-20200422_112357-767683b_107.x86_64 2/2 Running /opt/northstar/patch/SP2/deliver/apply-patch.sh ### Application process is detected. >>> Applying config /opt/northstar/patch/SP2/deliver/application.cfg ### Stop web:* ### web:app: stopped web:proxy: stopped ### Stop northstar_pcs:* ### northstar_pcs:PCViewer: stopped northstar_pcs:PCServer: stopped northstar_pcs:configServer: stopped ### Stop northstar:toposerver ### northstar:toposerver: stopped ### Replace /opt/northstar/utils collector-utils.py ### Replacing /opt/northstar/utils/collector-utils.py... ### Replace /opt/northstar/web/client/net util.js ### Replacing /opt/northstar/web/client/net/util.js... ### Replace /opt/northstar/web/client/net/app/view/analytic MultiTrafficView.js ### Replacing /opt/northstar/web/client/net/app/view/analytic/MultiTrafficView.js... ### Replace /opt/northstar/thirdparty/python/lib/python2.7/site-packages/nsutils esquery.py ### Replacing /opt/northstar/thirdparty/python/lib/python2.7/site-packages/nsutils/esquery.py... ### Replace /opt/northstar/web/routes/v1/scheduler index.js ### Replacing /opt/northstar/web/routes/v1/scheduler/index.js... ### Replace /opt/northstar/web/client/net/app/view/topology StdMapPanel.js ### Replacing /opt/northstar/web/client/net/app/view/topology/StdMapPanel.js... ### Replace /opt/northstar/web/lib SSE.js ### Replacing /opt/northstar/web/lib/SSE.js... ### Replace /opt/northstar/web app.js ### Replacing /opt/northstar/web/app.js... ### Replace /opt/northstar/web/lib nsUserTracker.js ### Replacing /opt/northstar/web/lib/nsUserTracker.js... ### Replace /opt/pcs/bin PCServer ### Replacing /opt/pcs/bin/PCServer... ### Replace /opt/pcs/bin TopoServer ### Replacing /opt/pcs/bin/TopoServer... ### Replace /opt/pcs/lib/wandl libpcs.so ### Replacing /opt/pcs/lib/wandl/libpcs.so... ### Replace /opt/pcs/lib/wandl libamqp.so ### Replacing /opt/pcs/lib/wandl/libamqp.so... ### Replace /opt/northstar/lib db_cass.so ### Replacing /opt/northstar/lib/db_cass.so... ### Start web:* ### web:app: started web:proxy: started ### Start northstar_pcs:* ### northstar_pcs:PCViewer: started northstar_pcs:PCServer: started northstar_pcs:configServer: started ### Start northstar:toposerver ### northstar:toposerver: started ### Analytics process is detected. >>> Applying config /opt/northstar/patch/SP2/deliver/analytics.cfg ### Stop analytics:netflowd ### analytics:netflowd: stopped ### Replace /opt/northstar/netflowd/netflow netflow_decoder.py ### Replacing /opt/northstar/netflowd/netflow/netflow_decoder.py... ### Replace /opt/northstar/netflowd/netflow netflow_worker.py ### Replacing /opt/northstar/netflowd/netflow/netflow_worker.py... ### Replace /opt/northstar/netflowd/netflow netflow_info_elements.py ### Replacing /opt/northstar/netflowd/netflow/netflow_info_elements.py... ### Start analytics:netflowd ### analytics:netflowd: started >>> Applying config /opt/northstar/patch/SP2/deliver/application_or_analytics.cfg ### Stop infra:healthmonitor ### infra:healthmonitor: stopped ### Replace /opt/northstar/web/lib nsUtils.js ### Replacing /opt/northstar/web/lib/nsUtils.js... ### Replace /opt/northstar/healthMonitor/hm_analytics index.js ### Replacing /opt/northstar/healthMonitor/hm_analytics/index.js... ### Replace /opt/northstar/healthMonitor/lib cpuInformation.js ### Replacing /opt/northstar/healthMonitor/lib/cpuInformation.js... ### Start infra:healthmonitor ### infra:healthmonitor: started Verifying : NorthStar_5.1.0-Patch-SP2-20200422_112357-767683b_107.x86_64 1/2 Verifying : NorthStar_5.1.0-Patch-SP1-20200122_171645-43da472_50.x86_64 2/2 Installed: NorthStar_5.1.0-Patch-SP1.x86_64 0:20200122_171645-43da472_50 NorthStar_5.1.0-Patch-SP2.x86_64 0:20200422_112357-767683b_107 Complete!
Notice that the script gives you confirmation of the patches that have been installed.
If you want to install only SP1, then you would use the following option in the batch-install.sh script:
./batch-install.sh -n 1
Uninstalling the Service Pack
To uninstall, use the ./batch-uninstall.sh script, and specify which SP version you want to uninstall. The specified SP version will be uninstalled, along with all subsequent higher SP versions (since the higher SP versions have a dependency on the lower version).
./batch-uninstall.sh
Example
[root@localhost NorthStar_5.1.0-Patch-All-20200422]# ./batch-uninstall.sh 1 Failed to set locale, defaulting to C Loaded plugins: product-id, search-disabled-repos, security, subscription-manager This system is not registered with an entitlement server. You can use subscription-manager to register. Setting up Remove Process Resolving Dependencies --> Running transaction check ---> Package NorthStar_5.1.0-Patch-SP1.x86_64 0:20200122_171645-43da472_50 will be erased --> Processing Dependency: NorthStar_5.1.0-Patch-SP1 for package: NorthStar_5.1.0-Patch-SP2-20200422_112357-767683b_107.x86_64 --> Processing Dependency: NorthStar_5.1.0-Patch-SP1 for package: NorthStar_5.1.0-Patch-SP2-20200422_112357-767683b_107.x86_64 --> Running transaction check ---> Package NorthStar_5.1.0-Patch-SP2.x86_64 0:20200422_112357-767683b_107 will be erased --> Finished Dependency Resolution Dependencies Resolved ========================================================================================================================================================= Package Arch Version Repository Size ========================================================================================================================================================= Removing: NorthStar_5.1.0-Patch-SP1 x86_64 20200122_171645-43da472_50 @/NorthStar_5.1.0-Patch-SP1-20200122_171645-43da472_50.x86_64 21 M Removing for dependencies: NorthStar_5.1.0-Patch-SP2 x86_64 20200422_112357-767683b_107 @/NorthStar_5.1.0-Patch-SP2-20200422_112357-767683b_107.x86_64 124 M Transaction Summary ========================================================================================================================================================= Remove 2 Package(s) Installed size: 144 M Is this ok [y/N]: Y Downloading Packages: Running rpm_check_debug Running Transaction Test Transaction Test Succeeded Running Transaction Running /opt/northstar/patch/SP2/deliver/apply-patch.sh ### Application process is detected. >>> Applying config /opt/northstar/patch/SP2/deliver/application.cfg ### Stop web:* ### web:app: stopped web:proxy: stopped ### Stop northstar_pcs:* ### northstar_pcs:PCViewer: stopped northstar_pcs:PCServer: stopped northstar_pcs:configServer: stopped ### Stop northstar:toposerver ### northstar:toposerver: stopped ### Replace /opt/northstar/utils collector-utils.py ### Restoring /opt/northstar/utils/collector-utils.py to original... ### Replace /opt/northstar/web/client/net util.js ### Restoring /opt/northstar/web/client/net/util.js to original... ### Replace /opt/northstar/web/client/net/app/view/analytic MultiTrafficView.js ### Restoring /opt/northstar/web/client/net/app/view/analytic/MultiTrafficView.js to original... ### Replace /opt/northstar/thirdparty/python/lib/python2.7/site-packages/nsutils esquery.py ### Restoring /opt/northstar/thirdparty/python/lib/python2.7/site-packages/nsutils/esquery.py to original... ### Replace /opt/northstar/web/routes/v1/scheduler index.js ### Restoring /opt/northstar/web/routes/v1/scheduler/index.js to original... ### Replace /opt/northstar/web/client/net/app/view/topology StdMapPanel.js ### Restoring /opt/northstar/web/client/net/app/view/topology/StdMapPanel.js to original... ### Replace /opt/northstar/web/lib SSE.js ### Restoring /opt/northstar/web/lib/SSE.js to original... ### Replace /opt/northstar/web app.js ### Restoring /opt/northstar/web/app.js to original... ### Replace /opt/northstar/web/lib nsUserTracker.js ### Restoring /opt/northstar/web/lib/nsUserTracker.js to original... ### Replace /opt/pcs/bin PCServer ### Restoring /opt/pcs/bin/PCServer to original... ### Replace /opt/pcs/bin TopoServer ### Restoring /opt/pcs/bin/TopoServer to original... ### Replace /opt/pcs/lib/wandl libpcs.so ### Restoring /opt/pcs/lib/wandl/libpcs.so to original... ### Replace /opt/pcs/lib/wandl libamqp.so ### Restoring /opt/pcs/lib/wandl/libamqp.so to original... ### Replace /opt/northstar/lib db_cass.so ### Restoring /opt/northstar/lib/db_cass.so to original... ### Start web:* ### web:app: started web:proxy: started ### Start northstar_pcs:* ### northstar_pcs:PCViewer: started northstar_pcs:PCServer: started northstar_pcs:configServer: started ### Start northstar:toposerver ### northstar:toposerver: started ### Analytics process is detected. >>> Applying config /opt/northstar/patch/SP2/deliver/analytics.cfg ### Stop analytics:netflowd ### analytics:netflowd: stopped ### Replace /opt/northstar/netflowd/netflow netflow_decoder.py ### Restoring /opt/northstar/netflowd/netflow/netflow_decoder.py to original... ### Replace /opt/northstar/netflowd/netflow netflow_worker.py ### Restoring /opt/northstar/netflowd/netflow/netflow_worker.py to original... ### Replace /opt/northstar/netflowd/netflow netflow_info_elements.py ### Restoring /opt/northstar/netflowd/netflow/netflow_info_elements.py to original... ### Start analytics:netflowd ### analytics:netflowd: started >>> Applying config /opt/northstar/patch/SP2/deliver/application_or_analytics.cfg ### Stop infra:healthmonitor ### infra:healthmonitor: stopped ### Replace /opt/northstar/web/lib nsUtils.js ### Restoring /opt/northstar/web/lib/nsUtils.js to original... ### Replace /opt/northstar/healthMonitor/hm_analytics index.js ### Restoring /opt/northstar/healthMonitor/hm_analytics/index.js to original... ### Replace /opt/northstar/healthMonitor/lib cpuInformation.js ### Restoring /opt/northstar/healthMonitor/lib/cpuInformation.js to original... ### Start infra:healthmonitor ### infra:healthmonitor: started Erasing : NorthStar_5.1.0-Patch-SP2-20200422_112357-767683b_107.x86_64 1/2 Running /opt/northstar/patch/SP1/deliver/apply-patch.sh Application is detected. Applying config /opt/northstar/patch/SP1/deliver/application.cfg ### Stop northstar_pcs:* ### northstar_pcs:PCViewer: stopped northstar_pcs:PCServer: stopped northstar_pcs:configServer: stopped ### Replace /opt/pcs/bin PCServer ### Restoring /opt/pcs/bin/PCServer to original... ### Start northstar_pcs:* ### northstar_pcs:PCViewer: started northstar_pcs:PCServer: started northstar_pcs:configServer: started Erasing : NorthStar_5.1.0-Patch-SP1-20200122_171645-43da472_50.x86_64 2/2 Verifying : NorthStar_5.1.0-Patch-SP2-20200422_112357-767683b_107.x86_64 1/2 Verifying : NorthStar_5.1.0-Patch-SP1-20200122_171645-43da472_50.x86_64 2/2 Removed: NorthStar_5.1.0-Patch-SP1.x86_64 0:20200122_171645-43da472_50 Dependency Removed: NorthStar_5.1.0-Patch-SP2.x86_64 0:20200422_112357-767683b_107 Complete! [root@localhost NorthStar_5.1.0-Patch-All-20200422]#