General Information

New Installations

The procedure for new installations depend on what operating system you are using. Please see the following links:

If you want to install you software on FreeBSD please let us know and we will help you with the installation.

Upgrades

If you have already installed the software, you can upgrade the software either through the web interface or manually from the command line. The upgrade procedure depends from what version you are upgrading. If you are upgrading from versions 1, 2 or 3 we recommend that you talk to us before performing the upgrade.

Error: Before upgrading make a backup of the working directory. If anything goes wrong with the upgrade, you can restore the file system and resume operations from that backup. We suggest that you prepare for an upgrade, so that the impact on your users are minimized. You can perform the upgrade while the system is running, then schedule a reboot at midnight. The system will then perform an upgrade only if there is no call active; otherwise it will wait. See Rebooting the System for more information.
Error: If you have made changes to the templates (web pages, email templates or PnP templates), please double check which of those changes are still necessary. New versions introduce bug fixes or new features that make such changes superfluous or even counterproductive. Keeping modifications of old versions may cause problems.

Upgrades from Version 5

For upgrades from version 5 you need to log in as administrator to the web interface of the Vodia PBX and then navigate to the system tab. There is a field called "Software Update".

Please first check the page maintenance plans if your license covers the version that you would like to upgrade to. Once you have determined what version you want to upgrade to, copy & paste the URL into the input field. The latest version link is:

http://portal.vodia.com/downloads/pbx/version-61.0.xml

For all available releases, see the Releases page.

After hitting the button, the system will start downloading the new software. The web interface will notify when the software update was finished. On the same page you can schedule a reboot or perform the reboot from the operating system. After the system boots up, you should be running the new software.

Upgrades from 4.5

For upgrades from version 4.5 you need to log in as administrator to the web interface of the Vodia PBX and then navigate to the system tab. There is a field called Software Update. Then copy & paste the following URL into your input field: http://portal.vodia.com/downloads/pbx/version-61.0.xml. After hitting the button, the system will start downloading the new software. Give it one or two minutes, then check the log file for messages. On the same page you can now schedule a reboot or perform the reboot from the operating system. After the system boots up, you should be running the new software.

Error: After upgrading to version 5 you need a new license key. You can get a license key from https://portal.vodia.com. We strongly recommend that you get that key before you upgrade, this will avoid possible downtime after the upgrade. Your server needs to have access to the internet during the installation phase and it needs to be able to resolve DNS addresses. As with every upgrade, you should make a backup of the PBX installation, so that if anything should go wrong, you can revert back to the previous installation.

If you want to perform a manual upgrade from the command line, you can just swap out the executable (typically pbxctrl.exe or pbxctrl) and the add the pbxctrl.dat file which is the same for all operating systems. The link in the executable is contained in the above XML file. In order to do this, you should first download the new executable, rename the old executable and then rename the new executable to the original name. There is no need to reboot the server for a software upgrade.

Please notice that for the snom ONE SoHo (AKA snom training kit) you need to perform a manual upgrade. Please visit http://forum.vodia.com/index.php?/topic/6448-upgrading-to-v5-from-v45-on-soho/ for more information.

Upgrades from other version 4 releases and version 3 releases

Upgrades from other version 4 releases are similar. If you have the Software Update field, you can use that the same way it is being used with version 4.5. Because the trunk header settings may have changed during the upgrade, you have to pay special attention to the trunk header settings after the upgrade. If the Software Update field is not available in the used version, you must first use the upgrade procedure to upgrade to version 4.5 and then perform another upgrade from there.