Reset Search
 

 

Article

KB44654 - PulseOne On Premise Upgrade Steps and Best Practices

« Go Back

Information

 
Last Modified Date3/1/2021 5:41 PM
Synopsis

Best Practices on PulseOne Upgrade

  • This article outlines the recommendations and best practices to be followed for PulseOne Upgrade.
  • Since PulseOne upgrades can only be initiated from the console not from the GUI, this Article describes the steps
  • All the below mentioned steps are console commands.

If you are on a version lower than 2.0.1904 please make sure that you upgrade to version 2.0.1904 and then to the Latest version.
Problem or Goal
Cause
Solution

DON'Ts

1) If you see any messages in RED like "Upgrade migrations failed ..." , "system is in an invalid state" etc

    Please don't ignore them. Follow as suggested there. Like it might suggest to do a "system reboot"

    Do not issue any further commands like "cluster promote"  or create new configurations like adding appliances etc unless the issue is resolved.

2) Don't try "system destroy" commands without Pulse Support. 

3) If an upgrade fails please don't proceed further by upgrading again and raise a support ticket with us.

4) Do not import backup of older pulse one version on to a newer pulse one version or vice versa. Import/Export of configurations are supported only on same version of Pulse One

Cluster Upgrade

1. Demote the passive node using command

                i.  cluster demote
                ii. cluster status (Observe that it becomes stand-alone node) 

2. 
Demote the Active node using command

                i.  cluster demote
                ii. cluster status (Observe that it becomes stand-alone node)

3. Take System backup of active node and Take a snapshot using the commands below (for debugging purpose later)

                i.   If the data is too large (check using the command "system storage show") exclude syslog data using the command:
                                a) system backup export -e syslog
                      otherwise use the command:
                                b) system backup export
                ii.  system snapshot

4. Initiate the Upgrade on Previously Active node by following upgrade steps mentioned on the bottom of the Article  

5. Upgrade passive node (same steps as in active node) by following upgrade steps mentioned on the bottom of the Article  

6. Check if both the above nodes are successfully upgraded (by checking all the tabs from the Pulse One GUI,  also "system version" should show upgraded PulseOne versions)

7.  Perform the below action commands in both nodes.

                                i.   cluster status (make sure both are in stand-alone mode)
                                ii.  network interface internal --ip <> --netmask <> --gateway <> (configure internal interface)
                                iii. network show (this should reflect the above command)

8. Recreating Pulse Cluster:

                a) Go to active node and perform below commands:

                                i.   cluster promote (to make this as active node)
                                ii.  cluster add <internal ip of passive node>
                                iii. From the above commands output:
                                                                copy "cluster join <xxxxxx>" and paste in the passive node.

                b) Go to passive node and perform:

                                i.  cluster join <xxxx>  (from the active node output)
                                ii. cluster status

                c) Observe cluster status and make sure cluster is created properly.

9. Services restart (run this command on both nodes)

10. System reboot  (run this command on both nodes)

Standalone Upgrade

1. Take System backup of active node and Take a snapshot using the commands below ( for debugging purpose later)

                i.   If the data is too large (check using the command "system storage show") exclude syslog data using the command:
                               a) system backup export -e syslog
                      otherwise use the command:
                                b) system backup export
                ii.  system snapshot

2. Upgrade the device by following upgrade steps mentioned on the bottom of the Article  

3. Check if both the above nodes are successfully upgraded (by checking all the tabs from the Pulse One GUI,  also "system version" should show upgraded PulseOne versions)

Upgrade Steps
 

a) For Older PulseOne versions use below commands (Version before 2.0.1902):

i.  system upgrade <http path to upgrade bundle> <md5 hash of upgrade bundle>
*  Once the upgrade is complete use below commands:
ii. services restart
iii. system reboot (SYSTEM REBOOT IS MANDATORY STEP AFTER UPGRADE)

 iv. Check all the services are up using command "services status"

b) For Newer PulseOne versions use below commands (Version 2.0.1902 and above) :

 i.  system upgrade -i <interface>
 *  The above command will provide you an url to upload the upgrade package.
 *  Once the upgrade is complete use below commands
ii. services restart
iii. system reboot (SYSTEM REBOOT IS MANDATORY STEP AFTER UPGRADE)
iv. Check all the services are up using command "services status"

Note: For PulseOne devices running on versions 2.0.1901 or below, you will need an external web server to host the upgrade bundle to initiate the upgrade


 

Related Links
Attachment 1 
Created ByAsutosh Dash

Feedback

 

Was this article helpful?


   

Feedback

Please tell us how we can make this article more useful.

Characters Remaining: 255