Howto13r1:Firmware Upgrade V12r2 V13r1: Difference between revisions

From innovaphone wiki
Jump to navigation Jump to search
Line 160: Line 160:
That means that if you already provide an Update URL via DHCP that the Provisioning process will not be possible. Therefore delete the Update URL in your DHCP Server. <br>
That means that if you already provide an Update URL via DHCP that the Provisioning process will not be possible. Therefore delete the Update URL in your DHCP Server. <br>
In case you are using Update Server/PHP Update Server 2 for Certificates etc. your phone needs to reach your old Update Server after provisioning again. (further details will follow)<br>
In case you are using Update Server/PHP Update Server 2 for Certificates etc. your phone needs to reach your old Update Server after provisioning again. (further details will follow)<br>
Please Check: [[Reference13r1:Services/Update]]


== Assign Hardware of a User to a phone or softwarephone App ==
== Assign Hardware of a User to a phone or softwarephone App ==

Revision as of 14:19, 28 May 2019

Possible Migration scenarios

In this scenario example we show you the Migration steps "PBX with Linux Application Platform on a local SSD" and we install an additional Gateway with SSD.

Additional components who are necessary:

  • IPxx11 Gateway with new SSD
  • v13 Licenses

Changes that will be performed during the install/migration process:

  • CDR0 will be changed
  • DNS0 will be changed
  • LOG0 will be changed
  • IP0 /priority-tos will be changed
  • HTTP Client Authenticated URLs 1-3 will be changed
  • HTTP, HTTPS Ports will be changed
  • STUN Server will be changed
  • LDAP Server will be changed to "Force TLS", there for all replications and other LDAP accesses need to be changed to TLS
  • No of Regs w/o Pwd will be changed to "0"

All changes can be changed back to another or original value after the migration process manually if necessary.
Make sure you store all these values upfront with a backup or manually. Always make a backup before you start a migration process.
We advice to update all devices to the latest available Minor Release firmware version within your existing release before updating to V13.

App Platform

At first install the gateway with the new Application Platform.

We assume it is in factory default. When a V13 firmware is already installed, you can access the gateway via its IP-address and you will get in the install gui and can start the install process. If this is not the case, you can perform an update of the firmware to v13r1 via Maintenance, Update.

Tip: If an V13r1 is installed but you don't get the install gui immediately you can open it via http://ipaddress/install.htm

  • Install switch from HTTPS to HTTP, please be careful if you have deactivated HTTP, the redirection will fail !!

If not no secure passwords should be assigned automatically, you can use the default passwords by using the URL with a password switch http://ipaddress/install.htm?stdpwd=on. We recommend the use of secure passwords

If the install doesn't start in your desired language or you want another language during the install process as the OS-language, use an appropriate language switch, for example ?lang=nl for Dutch or ?lang=en for english


As first you will be asked for the username and password of the gateway.

As long as these are on the default values, you don't have to enter a value or just enter this default value.

Tip: On the right pane of the install you find the explanations for the parameters that you can fill out.


In the second step the install method will be asked.
Here we select "Only update and network settings" to prepare the gateway for the installation of the App Platform.

Only update and network settings.png

In the step "innovaphone PBX Installation" you enter the necessary network settings of the gateway and the IP address of the App Platform.

It is also possible to update the gateway to the latest possible firmware version.

Be aware that if you choose for an update of the firmware, a restart will accure.

Innovaphone PBX installation.png

In the next step the App Platform will be downloaded and installed and started.

Innovaphone App Platform.png

PBX

After the App Platform is installed and started, we will follow-up with the update of the PBX (Master, in Distributed Systems).

To proceed we need to install the latest version of the V13r1 firmware on the existing PBX.


If the firmware V13r1 is installed, you can access the gateway via its IP-address and you enter into the install process.

As first you will be asked for the username and password of the gateway.

Here you enter the credential of the existing admin user (most of the time it is admin) of the gateway.

The install will recognize that it is an existing PBX configuration and provides you with the appropriate Update scenarios.

We choose for "Update existing PBX with installation of an external App Platform" as the selected scenario.

Tip: Be sure that you don't have any Object with H323 Name: "AP" in your config. If so you will have problems in connecting the AP Platform.

Update existing PBX with installation of an external App Platform.png


In the step "innovaphone PBX Installation" you enter the necessary network settings of the gateway.

It is also possible to update the gateway to the latest possible firmware version.

Be aware that if you choose for an update of the firmware, a restart will accure.

Innovaphone PBX installation2.png

In the step, "Connect to external App Platform" we connect the PBX with the pre-defines gateway with the App Platform.

To proceed we enter the IP-address off the App-Platform and ist password.

After pressing connect and a succesfull connection it will show connected.

Tip: The default password for the App-Platform is "pwd". If you don't enter a password the default password will be used automatically. If you changed the password on the App-Platform into a more secure password yourself before starting the Install to update the PBX, Be sure you use this same password to connect. Otherwise the connection will fail and the install can't proceed.


Tip: With the search option you can searh for available App-platform in your network that are installed on a gateway. It is required that this gateway was in default factory setting.

A search is not possible for an App-platforms that runs on a virtual machine. This can only be accessed via ist IP-address.


Connect to external App Platform.png


Tip: When the next step will follow with "Connect to Devices" the there was already an entry in the advanced user interface in

General/Devices Registration). Clear this entry and restart the Install process again.

In the following step "innovaphone PBX Options" you enter the configuration just as you have seen and learned during the iT Connect op iT Update training.

Here the PBX name and Domain name (System name) should match with your configuration.

Tip: As user please add an additional (not existing) new user as myApps Admin. Name and mail cannot be in use already.
Tip: At the moment only lower case PBX names can be used. In case the PBX you want to update is using upper case you have to change it to lower case (at the moment) and your phones will loose registration. Later on you have to change the PBX entries of all objects to lower case.
In the following step "Emergency Administrator password, please save secure" the passwords will NOT be created randomly as you have learned during the iT Connect Training. The existing passwords of the PBX system remain as they are.

In the following steps the configurations will be done as learned during your iT Connect Training.
After finishing all the install steps, you can login into the system with the previously define myApps Admin in the myApps client.

Tip: If you cant login with the myApps Admin User, go to the Advanced User Interface (https://ip.addr/admin.xml?xsl=admin.xsl) and assign an existing user object the Template "Config Admin". You can then login with this user into myApps.
As mentioned in the beginning , know you can change your saved and special settings back to its original state if this is necessary for your configuration.
To give the existing users the possibility to use the innovaphone myApps, you should inherit the existing templates to the new template "Config User". If the user didn't have any template at all, then assign them o the template "Config User".

Tip: The Users are only seen in Users App if they have the "Visible" flag in Visibility set. This is mostly done by Config Templates. So be aware that if you have another Config Template in use (that has not set the Visibility flag) even if you inheritate it from Config User it will not overwrite the older settings. So choose here the Visibility flag afterwards.

Change template.png

Tip: Assign Administrative users to the new template "Config Admin".

Tip: In case you are using Apps that need a License the selectable box under License only appear after uploading the necessary license. In test mode everything works. So in case you are using test mode it is better to first upload your licenses, select the license boxes and than deactivate your test mode!

Provisioning

If you want to use Provisioning and you are using Update Server/PHP Update Server 2 you have to consider that your phone needs to reach config.innovaphone.com via Update URL.
That means that if you already provide an Update URL via DHCP that the Provisioning process will not be possible. Therefore delete the Update URL in your DHCP Server.
In case you are using Update Server/PHP Update Server 2 for Certificates etc. your phone needs to reach your old Update Server after provisioning again. (further details will follow)

Please Check: Reference13r1:Services/Update

Assign Hardware of a User to a phone or softwarephone App

This can be done by the administrator in UsersAdmin App.
Alternative the User can do this via his Profile. At the instruction from myApps the user can be shown on which point he can assign the app.

Profile PhoneApp.png

Reverse Proxy

Via the advanced user interface install the latest V13r1 firmware.

In the next step we need the Devices App URL. Via the advanced user interface, in General/Devices Registration/Devices App URL.

Copy this URL.


Device Registration2.png

Paste this URL in the advanced user interface of the Reverse Proxy in the field General/Devices Registration/Devices App URL.

From now on this device can be found in the Devices App in Devices.

The MAC address and a wrench symbol will be displayed.

Here you can now assign a meaningful name and the domain to the device.


Devices.png

Via Categories you should assign this gateway also to the appropriate Category.

Devices2.png

Tip: Now the device configurations are assigned to all devices and the corresponding category(s)

These include at least:  Alarmserver Global, Media Global, NTP-settings

Via the PBX Manager App and the Reverse Proxy plugin you can now configure the Reverse Proxy.

You should add here a new Host entry for the App Platform in the Reverse Proxy via the option "Add Host".

The DNS name of the App Platform will be displayed in the next step. Select the DNS name and it will be added to the Reverse Proxy entries.

Via the advanced user interface you have to change the hostnames for every PBX (Slaves and Standby).

In the first http forward field you need to enter the following string /PBX0/APPCLIENT/appclient.htm and forward it to the appropriate IP-address with the port numbers 80 and 443 and tag the checkbox Default.

At least the following entries should be available as shown in the picture below.

Reverse Proxy Entries.png

STUN / TURN / Slave / Standby / DECT

If you  want to have access to the gateway to enter the install process, you have to enter the admin credentials to login.

In the next step select "Manual Configuration" and you will enter the Advanced User Interface.

Install the latest V13r1 firmware.

In the following step we need the Device URL which can be found on two different ways.


  1. Via the Advanced User Interface of the PBX

In General/Devices Registration/Devices App URL copy the complete URL.

Device Registration2.png


Paste this URL via the Advanced User Interface of the Reverse Proxy Gateway in General/Devices Registration/Devices App URL .

Now you can find this Gateway in the Devices App within Devices. It will be displayed with its MAC-address and a wrench symbol.

Here you can now assign a meaningful name and the domain to the device.

Devices.png

Via Category you should assign the Gateway to the appropriate category.


Devices2.png


Tip: Now the device configurations are assigned to all devices and the corresponding category(s)

These include at least: Alarmserver Global, Media Global, NTP-settings

Tip: For a Slave, Standby PBX or DECT you should select TLS as Replication protocol.

Configuration Changes

SNMP disabled by default

Up and including v12r2, SNMP was by default activated on a innovaphone device. In v13 it is by default deactivated, it can be activated by a new Enable Checkmark. As a result, if you upgrade to v13 firmware SNMP is deactivated and needs to be enabled if SNMP is needed in the customer setup.

Config line size was increased to 32KB

Downgrade from 13r1 to 12r2 (or older firmware) will result in objects with a too large config line being dropped.

PBX name in v13 can't include uppercase letter

So you should change it in your configuration in V12 before the upgrade of PBX.

Known issues

For the known issues, please have a look into our Support:DVL-Roadmap Firmware 13r1

Related Articles