Skip to end of metadata
Go to start of metadata

This page outlines the process for upgrading the software on a VX node. In order to successfully upgrade the node, the following are required:

  • Access the Sonus Global Support Portal (see below) for downloading the desired software package(s)
  • Full CLI access to the node
  • Either FTP or VXbuilder File Transfer access
  • The location of the upgrade folder on your node (as seen from the above file transfer facilities). This is the "Upgrade" folder. For more information on locating this folder, expand the section below by clicking the heading.

Click here to see how to locate the Upgrade folder on the VX node

In this section:

Requesting the Software Bundle

To request a software package from the Ribbon Support Portal:

  1. Open https://ribboncommunications.com/.

    Figure : Ribbon Communications Home Page

      

  2. Click SERVICES > RIBBON SUPPORT PORTAL.

    Figure : Ribbon Support Portal

       

  3. Enter your Ribbon-provided credentials to log on to the portal.

    Figure : Login Screen

       

  4. Click DOWNLOADS in the Ribbon Support Portal.

    Figure : Support Menu

       

  5. Click Sonus > Select Software to open the Select Software dialog box. To determine the latest Software Bundle and the respective files, refer to the product Release Notes, and then perform the following:

    1. Select the desired product from the Product drop-down list.

    2. Select the product's operating system from the Operating System drop-down list.

    Figure : Software Download Menu

       

  6. Click Request Download on the appropriate software bundle. This opens the Software Download Form.

    Figure : Requesting Download

       

  7. Complete the Software Download Form.

    Figure : Software Download Form

       

  8. Click I ACCEPT to accept the End-User License Agreement, and then click Submit.
         

  9. Review the Software Request Detail window. A notification is sent by email when your bundle is ready to download.

    Figure : Download Request Submitted State

Acquiring the Software Bundle

Customer Support emails you when the bundle is ready to download. Click on the link in the email and then follow these steps:

  1. Open https://ribboncommunications.com/.

    Figure : Ribbon Communications Home Page

        

  2. Click SERVICES > RIBBON SUPPORT PORTAL.

    Figure : Ribbon Support Portal

         

  3. Enter your Ribbon-provided credentials to log on to the portal.

    Figure : Login Screen

        

  4. Click DOWNLOADS in the Ribbon Support Portal.

    Figure : Support Menu

        

  5. Click Downloads > Sonus > Download Requests. Click the appropriate Software Request ID

    Figure : Download Requests

     

        

  6.  The Software Request Detail window opens. The window shows the bundle name and the components of the bundle. Click on the URL hypertext to download the software.

    Figure : Software Download Available State

        

  7. The browser redirects you to the following page and a pop-up window appears to save your file. If the pop-up window fails to appear, return to the Software Request Detail window, re-select the software and when the About Download Manager window opens, click the click here link to save your file.

    Figure : Download Manager

       

  8. Save the software to your local PC or server.

Opening the .zip File

The package will be downloaded in a .zip file format. 

  1. Locate and open the .zip file and unpack it to a temporary folder. This will produce a Readme file, a .tbz file and optionally a .obf file.
  2. Open the Readme file and follow the upgrade instructions.

Additional notes

The Readme file provides basic instructions on how to install the package. Read it carefully and be aware of all warnings and notes. It also contains the specific upgrade command (which differs by package). More detailed notes are below:

  • All packages require restarting the node, and as such, will cause service disruption. Install them at an appropriate time such as to minimize the impact of said disruption.
  • The packages take some time to install. The exact time depends on the package - refer to the Readme. If no specific time is listed, it takes 5-10 minutes - slower packages will specify how long they take to install (from the time of the last prompt to the time that the node is back up and running).
  • The files can be transferred using an FTP client, or by using the Uploading System Files facility in VXbuilder.
  • You can monitor the state of the node by pinging it. Once pings are being received consistently, the upgrade is complete (note that the node will also ping immediately after commencing the upgrade, since it hasn't shut down yet).

Some upgrades may require you perform this procedure several times, going via intermediate versions to get to the desired version (this seldom requires more than 2 upgrades). This is required if you do not see your desired version listed on the download site. If this is the case, upgrade to the next highest version - this will be an intermediate version. Once complete, perform the procedure again with the intermediate version as the new base.

  • No labels