Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updated using 4PSA automated script

...

4PSA recommends that you upgrade the VoipNow distributed installation following the procedure detailed below.

...

Anchor
mysqlnode
mysqlnode

Update the MySQL master node

To update the MySQL Master node, you muse use the provided script and take the steps below:

  1. Run the following command.

    Shell

    curl "http://www.4psa.com/software/voipnow35installer.sh" -o voipnowinstaller.sh -L

  2. 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
  3. 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:

  1. 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>

  2. Download the installer.

    Shell

    curl "http://www.4psa.com/software/voipnow35installer.sh" -o voipnowinstaller.sh -L

  3. 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 databases. Check the 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 occur, do not continue the process. Contact 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 can be done if you simultaneously execute the Command Line Installer on all the other nodes.

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.

To update any other role, take the steps below:

  1. Download the installer script.

    Shell

    curl "http://www.4psa.com/software/voipnow35installer.sh" -o voipnowinstaller.sh -L

  2. Make sure to set the installer to run in Standby mode.

    Shell

    export VNSTANDBY=1

  3. 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).

...

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 4.0 International.