Howto14r1:Firmware Upgrade V13r3 V14r1

Applies To

This information applies to:

• All 14r1 capable innovaphone devices

For a general overview of the upgrade process and a list of supported devices with 14r1, see Howto:Firmware Upgrade

Migration Policy

Here is how you upgrade a system to 13r3 from 14r1.

Single AP/Single PBX

• Create a new update job in devices and select 14r1 as major version

Shared AP/Several PBX'es

We generally recommend upgrading the entire system (endpoints, PBXs, AP) in one shot.

If this is not possible for any reason, the recommended sequence is:

1. update the master PBX
2. update the slave PBX and all its endpoints location by location
3. update the App Platform to the latest build
4. update all Apps
5. perform the configuration changes described below

Note that during the update time frame, some App data such as Reporting and Recording may be incomplete.

We recommend reviewing all the configuration changes described below before you begin the update.

Changes visible to the end customers

Listed here are changes that should be communicated by resellers to end users prior to a 14r1 upgrade, as the change will be visible/audible in the behaviour of the application/device.

Softphone/Phone App UI changes

• Dial-pad is now a new tab in the navigation.
• On Smartphones, the Navigation is in the bottom.
• Call button is removed from the searchbar. Calling only via the search results.

Configuration of Logo URI

• In 13r3 this configuration was done in the advanced UI on the page PBX / Config / myPBX / Logo URI.
• But in 14r1 it can be found on the page PBX / Config / General / Logo URL.

Voicemail App

Extra features for the users:

• Call the voicemailbox directly from the app.
• PIN-code is visible and can be changed or set back to default.
• Call Forwards to the Voicemailbox can be activated/removed (CFU/CFB/CFNR).
• Number Resolution via the Search Provider.

Fax App

• While sending an outgoing fax via the fax app, you now can select and configure a fax cover page before sending.
• While configuring a fax app or groupfax via the PBX Manager plugin, you can customize the header line of fax pages and select a language.
• After updating from 13r3 or setting up your device with 14r1, the Fax object has 4 new options, which are enabled by default:
  • Modem capability: the supported modem class can be changed if necessary.
  • Append user number: if checked, the user number will be appended to the object number.
  • ECM: that allows the T.30 connection to use error correction mode.
  • Receiving with 400dpi allowed: which allows you to receive 400*400dpi documents.

AP Manager

• The AP Manager UI has been reworked. It is now responsive design, improved view of all app services and instance. Rework of statistic of CPU/RAM/used disk. This change is for the IT administrator, not relevant for end users

Changed Apps

If the installer is not used for a new installation, some new default settings are not set. Please evaluate per app whether you want to configure the new default settings manually.

Devices App

New Device Configurations option to roll out certificates to the trust list of your devices. Reference14r1:Concept_App_Service_Devices#Certificates_configuration

Recordings App

New option to add WebDav credentials in RecordingsAdmin. Howto14r1:RecordingsApp#Configuring_WebDav_credentials_in_RecordingsAdmin

Voicemail App

• New Setting to configure the automatic deletion of old(er) voicemail-messages per app. Reference14r1:Concept_App_Service_Voicemail#Settings
• New Option to configure the default PIN per voicemail system. Reference14r1:Concept_App_Service_Voicemail#add_voicemail

By configuring a PIN code from a different length, you also configure the length of the PIN code used by the system.

New Apps

New Apps will not be installed automatically by the 13r3 to 14r1 upgrade. The installation description of new 14r1 apps is usually in the concept article. Please rate per app whether you want to install/use the new app and configure it manually.

Calculator

• Although already released in 13r3 sr11, this app is now part of the 14r1 install. This app is explained in the concept article and the how to article.

Connect

• A microblogging tool. This app is explained in the concept article and the how to article.

Connector for Let's Encrypt

• Automatically creates & renews Let's Encrypt certificates, the App is included in the Install process - however when doing an upgrade it needs to be setup manually.

Contact Widgets App

• A Contact Widget (or Website Widget) is an element that can be added to a website. It offers to website visitors a way to get in contact with agents (e.g. help-desk). Website visitors can start chat sessions (asking questions, getting answers) or can start voice or even video calls.

For more details have a look at the concept article.

Customers using the previous Widgets, should change to the new Contact Widgets App

Notes

• Digital notes can be managed with the innovaphone app Notes. The app has a minimalistic feature set and is easy to use. The notes are saved on the server and available on all devices of the users. More infos available in the Reference article

PBX Manager - AP app installer

• in the PBX manager you will find a new coloured plugin. this new plugin give access to the App store in order to ease the installation of an App service and its instance. You basically do not need to go to the AP platform when you want to install a new application. Idea is to have the further installed app done by this plugin, this also ease the way to discover new applications. More infos available in the Reference article

Search App

• The app is immediately available on the PBX (no configuration is needed). In a new V14r1 configuration the Install provides all Users with this Search App via the "Config User"-Template. If the same configuration is required on an upgraded config, the Search App ("search") can be ticked in the "Config User" template. For details refer to the concept article.

TechAssist

• Application for quality assurance and improvement of systems by collecting static and runtime information. For details refer to the concept article.

Needed configuration changes

Virtual Appliance on VMWare

After deploying the new firmware modify the guest configuration file (stemming from ipva.vmx) as such: Modify e.g. ethernet0.virtualDev = "vlance" to become ethernet0.virtualDev = "vmxnet3"

IPVA certificates

IPVA certificates are no longer signed by innovaphone Device Certification Authority 2. Instead they will be now signed by innovaphone Unverified Device CA, as innovaphone cannot control the serial numbers and thus the certificate creation of IPVAs.

In a 14r1 install you'll be asked whether you want to always trust this new CA or not. If you decide not to trust this CA, you have to manually trust newly created IPVA certificates.
Note that this is not neccessary for local registrations inside the IPVA itself and doesn't affect hardware phone registrations.

You can download the innovaphone Unverified Device CA here: https://download.innovaphone.com/certificates/ca-unverified.pem
If you want to trust this new CA or your own IPVA certificates, you can use the Devices App to roll out certificates to the trust list of your devices.

Removed in 14r1

The following software is no longer included in 14r1.

myPBX

This includes the following components

• myPBX webclient
• myPBX for Windows
• myPBX for iOS
• myPBX for Android

Please migrate to innovaphone myApps.

Widgets

The Widgets were based on the myPBX interfaces that have been removed. Please migrate to the the Contacts Widget App.

WebRTC toolkit

The WebRTC toolkit was based on the myPBX interfaces that have been removed. Please use the current interfaces and libraries described in the innovaphone SDK.

Windows Softwarephone

Please migrate to innovaphone myApps for Windows and the Softphone App.

PBX Object Settings

The object provided the PBX Settings App that was used to configure dynamic group memberships in myPBX. Please use the Profile App instead.

PBX Object ICP

Please use the integrated presence features of the innovaphone PBX instead.

Service Call-Lists

This service implemented call lists for myPBX on the local CF card. Please use the Reports App instead.

Deprecated in 14r1

The following software is based on legacy technology with no further development and limited maintenance and support. We strongly recommend migrating to our successor products that are fully compatible with 14r1 and myApps technology.

Linux Application Platform (v10)

Please migrate to the innovaphone App Platform for 14r1 installations.

innovaphone Faxserver (v10)

Please migrate to the Fax App for 14r1 installations.

innovaphone Reporting (v10)

Please migrate to the Reports App for 14r1 installations.

innovaphone Exchange (v10)

Please migrate to the Calendar App for 14r1 installations.

Operator (v9)

Please migrate to the Switchboard App for 14r1 installations.

innovaphone Voice Recording 2014

Please migrate to the Recordings App for 14r1 installations.

PBX Object External UC

Existing configurations still work. But new configurations can't be done using the advanced UI anymore.

Please use the integrated UC and federation features of the innovaphone PBX.

For presence synchronization with other systems we recommend using

• innovaphone myApps Connector for Microsoft 365
• Connector for kuando®
• Calendar App

Known Problems

Long Update-duration

When you update, it can be up to 10 minutes before you have access to your app platform again.

Fax from 14r1 to 13r3 App

14r1 faxes are sent with 400dpi by default, which the 13r3 app doesn't support and you will see a non working incoming fax. The second try with lower resolution will work.

Resources Considerations

New firmware always has more features which in turn requires more resources. Growing firmware will thus consume both more flash and RAM for sure. A given system configuration will run flawlessly after a firmware largely only if there is still enough memory left after boot.

Standard configurations which are according the specs will run on all supported hardware. However, unusual configurations may not. It is a good idea to examine both flash and RAM memory left on high load situations in your existing configuration to see if there is enough resources left for an upgrade. Please find details in Reference:Device Health Check.

RAM

As a rough rule of thumb, a 14r1 release will consume the same amount of RAM compared to a v13r3 firmware.

Flash Memory

As a rough rule of thumb, a v14r1 release will consume ~ 1.8 MB more flash memory compared to a v13r3 firmware. New firmware comes with new code for new features which consumes more flash memory for the firmware image. For this reason, devices may run out of flash memory during upgrade to v14r1. Here is the recommended procedure for upgrade on such devices:

• save entire configuration
• reset to factory defaults
• load saved configuration (this will reorganize the flash memory usage)
• upgrade to new firmware

When there is still not enough flash memory available to store the new firmware (Web GUI ends up in a Firmwareupdate failed:no space / Update client end in a Error 0x00130001 Major FLASHMAN0 no space event) please open a support case with your current configuration file.