Date: Fri, 29 Mar 2024 05:32:44 +0000 (GMT) Message-ID: <974089704.4673.1711690364620@wiki.4psa.com> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_4672_1858570082.1711690364620" ------=_Part_4672_1858570082.1711690364620 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
Upgrading a distributed infrastructure is more complicated than upgradin= g a single node installation. Even so, the basic principles stay the same.<= /p>
4PSA recommends to upgrade whenever a new version is released.
VoipNow Product Management notifies customers when a new version is avai= lable using the VoipNowUpdates account on Twitter. It is strongly recommended that you follow this account on Twitter.<= /strong>
At the same time, if you log in to your VoipNow system as Administrator = and open the Unified Communications menu, you will see an alert at the top = of the interface informing you that an update is available.
Planning is one of the most important steps of a successful upgrade. Wit= hout proper planning, deploying a new version in production might become a = very frustrating experience.
The Release Notes cover =
the most important things that have been changed in the new version. They i=
nclude bug fixes as well as major and minor improvements.
They might also contain important advice. For instance, we might tell you =
that, once you have completed the upgrade, you need to take some extra step=
s (usually due to changes in behavior).
While we try to provide an accurate description for these changes, somet= imes it might be hard to understand them, especially if you do not have any= background information. Therefore, if you have any doubt about any item in= the Release Notes, simply open a ticket in 4PSA Help Zone and ask 4PSA = engineers for help.
Maintaining a testing environment is absolutely= necessary, especially with large installations.
The testing deployment should be used whenever you need to execute tasks= that would otherwise be dangerous in the production environment. Such task= s include, but are not necessary limited to:
It is essential to keep the configuration of the testing environment ver= y similar to the configuration of the production environment. Otherwise, it= might not be very useful.
It is required to start with an upgrade of the testing environment, foll= owed by some smoke tests to detect any issue that might have occurred on ac= count of the upgrade. If you detect any issue on your testing environment, = do not hesitate to contact 4PSA Help Zone.
The VoipNow distributed installation involves downtime for your customer= s. While technically it is possible to perform upgrades without any downtim= e, the procedure is much more complicated and should only be followed in mi= ssion critical installations.
In most situations, this downtime takes less than 3 minutes. Therefore, = it is strongly recommended to notify your customers about it.
Rolling back a production installation might be tricky. Even though ther= e are sufficient technical solutions for fast rollbacks (i.e. snapshots), y= ou are unlikely to rollback an installation when information has been commi= tted to database. Simply because this would mean that the entire informatio= n between the snapshot date and the actual time of the rollback will have b= een lost.
Therefore, do not rely on these facilities, even if the= y are available. They should only be used as a last resort.
Maintaining backups is a basic responsibility for any system administrat= or. 4PSA recommends to conduct backups using CDP (continuous data protectio= n) technologies every several hours.
However, as it happens with rollbacks, you should never rely on backups = when fixing upgrade issues. The same loss of information might occur. There= fore, backups too should be used as a last resort.
4PSA recommends that you upgrade the VoipNow distributed installation fo= llowing the procedure detailed below.
To update the MySQL Master node, you muse use the provided script and ta= ke the steps below:
Run the following command.
Ensure that the MySQL node has the following environment variables.<= /p>
Then run the following command.
The Infrastructure Controller is the first node in the system that must = be upgraded after the SQL node (that in case there are MySQL updates). This= upgrade does not cause any downtime. However, depending on the database sc= hema upgrades, it might cause inconveniences to the other roles of the syst= em.
The update requires taking the following steps:
VoipNow must know where MySQL is installed. For this, y= ou must set the following shell environment variables.
Download the installer.
Run the installer.
4PSA tries to minimize these inconveniences by reducing the number of sc= hema upgrades and migrating to schema less databases. Check the Release Notes as we will be = indicating the impact of the changes on the distributed upgrade. If th= e upgrade fails or if any problem should occur, do not continu= e the process. Contact 4PSA Help Zone instead.
We recommend that you upgrade the other nodes of the system at the same = time. This can be done if you simultaneously execute the Command Line Insta= ller on all the other nodes.
During this step, your infrastructure might experience a total o= r partial downtime.
Various strategies may be used to execute the CLI on multiple nodes:
No matter which method you use, make sure that you collect the output of= the CLI in order to detect if any problem occurred.
To update any other role, take the steps below:
Download the installer script.
Make sure to set the installer to run in Standby mode.
Finally, run the installer.
If the Release Notes advise you to perform configuration changes, please= do accordingly. Usually, this is necessary when upgrading to major new ver= sions.
Just like you did when you performed the upgrade on your testing environ= ment, execute the smoke tests that allow you to detect any possible issues.=
If you still have trouble in performing the upgrade, do not hesitate to = ask for advice and follow VoipNow administrators in the GetSatisfaction commu= nity.
If you need more help, our expert engineers are waiting for you in the <= a href=3D"http://help.4psa.com/" class=3D"external-link" rel=3D"nofollow">4= PSA Support Zone.