...
When to upgrade
| Note |
|---|
4PSA recommends to upgrade upgrade whenever a new version is released. |
VoipNow Product Management notifies customers when a new version is available using the VoipNowUpdates account on Twitter. It is strongly recommended that you follow this account on Twitter.
At the same time, if you log in to your VoipNow system as 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 upgradesuccessful upgrade. Without proper planning, deploying a new version in production might become a very frustrating experience.
...
While we try to provide an accurate description for these changes, sometimes it might be hard to understand them, especially if you do not have any background information. ThereforeTherefore, 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.
...
- testing administration procedures
- testing Apps
- testing various integrationvarious integration
- testing new customer packages and charging strategies
It is essential to is essential to keep the configuration of the testing environment very 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, followed by some smoke tests to detect any issue that might have occurred have occurred on account of the upgrade. If you detect any issue on your testing environment, do not hesitate to contact contact 4PSA Help Zone.
Plan the downtime
...
Rolling back a production installation might be tricky. Even though there are sufficient technical solutions for fast rollbacks (i.e. snapshots), you are unlikely to rollback an installation when information has been committed to been committed to database. Simply because this would mean that the entire information between the snapshot date the snapshot date and the actual time of the rollback will have been lost.
...
Maintaining backups is a basic responsibility for any system administrator. 4PSA recommends to conduct backups using CDP (continuous data continuous data protection) technologies every several hours.
...
4PSA recommends that you upgrade the VoipNow distributed installation following the procedure detailed below.
| Anchor | ||||
|---|---|---|---|---|
|
Update the MySQL master node
To update the MySQL Master node, you muse use the provided script and take the steps below:
Run the following command.
Shell curl "http://www.4psa.com/software/voipnowinstaller.sh" -o voipnowinstaller.sh -L
Ensure that the MySQL node has the following environment variables.
...
Shell export ALT_DB_HOST=<hostname>
export ALT_DB_PORT=<port>
export ALT_DB_USER=<user>
export ALT_DB_PASSWD=<password>
export ALT_DB_NAME=<database>Note Credentials can be found in voipnowcredentials.conf Then run the following command.
Shell sh voipnowinstaller.sh mysql
Update
...
the Infrastructure Controller node
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 schema upgrades, it might cause inconveniences to the other roles of the system.
The update requires taking the following steps:
VoipNow must know where MySQL is installed. For this, you must set the following shell environment variables.
Shell export ALT_DB_HOST=<hostname>
export ALT_DB_PORT=<port>
export ALT_DB_USER=<user>
export ALT_DB_PASSWD=<password>
export ALT_DB_NAME=<database>Download the installer.
Shell Run the installer.
Shell sh voipnowinstaller.sh
4PSA tries to minimize these inconveniences by reducing the number of schema upgrades and migrating to schema less databasesto schema less databases. Check the Release Notes as as we will be indicating the impact of the changes on the distributed upgrade.If If the upgrade fails or if any problem should occurshould occur, do not continue the process. Contact 4PSA Help Zone instead instead.
...
Update the remaining roles
We recommend that you upgrade the other nodes of the system at the same time. This This can be done if you simultaneously execute the Command Line Installer on all the other nodes. 
During
| Note |
|---|
During this step, your infrastructure might experience a total or 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.problem occurred.
To update any other role, take the steps below:
Download the installer script.
Shell Make sure to set the installer to run in Standby mode.
Shell export VNSTANDBY=1
Finally, run the installer.
Shell sh voipnowinstaller.sh
| Note |
|---|
| To speed up the upgrade, it is recommended that you mirror the VoipNow repository located at http://voipnow.4psa.com/downloads in your local infrastructure. To match the URL of your repository, you have to edit the Command Line Installer repository line (one of the first 20 lines). |
...
Just like you did when you performed the upgrade on your testing environment, execute the smoke tests that allow you to detect any possible issues.
| 4psahelpbox | ||
|---|---|---|
| ||
If you still have trouble in performing the upgrade, do not hesitate to ask for advice and follow VoipNow administrators in the the GetSatisfaction community. If you need more help, our expert engineers are waiting for you in the the 4PSA Support Zone. |
Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 4.0 International.