innovaphone wiki - User contributions [en]

Reference:My Innovaphone

2022-10-19T12:18:34Z

Kti: /* Check licence, SSA and warranty status of a device */

==Where is my old my.innovaphone?==
Don't worry, just login with your old my.innovaphone account! You will be asked to confirm your forename and surname (just a '''natural person''' is allowed) and accept some terms and conditions. 
Afterwards you find the old license/device view inside the [[#Licenses_tab | Licenses tab]].

==About==
my.innovaphone allows the handling of licenses and includes the handling of device warranty and software service agreements. 
You can also sign contracts here for different purposes.

===Project-View===
My innovaphone offers the possibility for several users to be in one company. This company shares its balance of licenses over all users and can have several projects. Projects have their own balance of license types and devices are bound to a project.

===Language===
My innovaphone will support multiple languages. You can select your desired language at the top of the page. 
Currently supported languages:
* English
* German
* Italian
* Dutch
* French
* Spanish (partially)
* Polish (partially)

===Guides===

====Quickstart guide====
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_nl.pdf Dutch quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_en.pdf English quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_fr.pdf French quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_de.pdf German quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_it.pdf Italian quickstart guide] 

====SSA guide====
;V10 and greater:
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10nl.pdf Dutch SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10en.pdf English SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10fr.pdf French SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10de.pdf German SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10it.pdf Italian SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10pl.pdf Polish SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10es.pdf Spanish SSA guide] 

;V8 and greater:
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_en.pdf English SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_fr.pdf French SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_de.pdf German SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_it.pdf Italian SSA guide] 

==First steps==
Open [https://my.innovaphone.com my.innovaphone.com] and click the "I would like to create a new personal user account" link.
Enter your personal data and register.

You will receive a registration email with an activation link.
After account activation you have two options:
* create a new my.innovaphone company with the "Create company account" button
* ask another user of your company to invite your email address to an already existing company

If you accidentally created an own my innovaphone company, just ask another user of your company to import your just created company.

If you create a new company, you can '''optionally''' enter your innovaphone account ID (which is your customer number with innovaphone) with your postal code, to retrieve your company data.

Inside the license tab of the my.innovaphone portal, you will see a help link at the right side of the horizontal tab menu.
This link shows the corresponding text of the wiki section, when hovering with the mouse over it,
and redirects to the corresponding wiki menu, if clicked.

It is possible, that one user is member of serveral companies!

==Left bar==
If you open the left bar, you have the options to:
* select one of your companies
* edit your personal user account
** user name
** email address
** flag to recieve SSA expiry emails
** password
* create a new company
[[Image:Myinnovaphone bar.png|center|thumb|200px|Left bar]]

==Main tabs==
Inside each company you see the three main tabs:
* Contracts
* Authorized persons
* Licenses (see [[#Licenses_tab | Licenses tab]])

You may also have two buttons:
* Add Contract (just as company administrator or with the contract right)
* Invite person (just as company administrator)

[[Image:Myinnovaphone main.png|center|thumb|200px|Main view]]

=== Contracts ===
Inside the contracts tab, you see all your contracts and you can download these conracts. 
In general, contracts must be first approved by innovaphone, so you see three types of contracts:

* open contracts which must be approved by innovaphone first
* approved contracts which can be already used
* cancelled contracts which are not valid anymore

[[Image:Myinnovaphone contracts.png|center|thumb|200px|Conracts]]

These type of contracts currently exist:
==== innovaphone myApps Cloud Service ====
Conclude this contract to use the innovaphone myApps Cloud.

==== innovaphone software rental ====
Conclude this contract to rent innovaphone software products. You must conclude this contract if you want to use the software rental inside the Devices App.

=== Authorized persons ===
Here you see all persons which exist inside your company. Each person can have the following rights:
* Administrator (everything)
* Contracts (can conclude contracts)
* Licenses (can work with licenses)
* Viewer (can just see everything without doing something)
* Locked (cannot even login to this company anymore)

=== Licenses ===
Here comes the old my.innovaphone view which allows the handling of devices, licenses, activation keys etc.

==Search (inside licenses tab)==
At the right top of the licenses tab you have a search field. You can search for different things:
* Devices (part of a device name or device comment)
* Projects (part of a project name or project description)
* Own activation keys (part of an activation key or its description)
* Hardware rental orders (part of the innovaphone order number or your own order reference or a MAC address of an order)

You have to enter at least '''three''' chars to start a search. To search for activation keys,
you have to enter at least '''five''' chars.
* Search for license types. Enter e.g. "PBX-Port8" to find all devices with Port8 licenses or enter "PBX-Port8=100" to find all devices with Port8 licenses '''>=''' 100.
* Search for products, e.g. 01-00811 für IP811 (such a search may take longer!)

==Licenses tab==
===Projects===
After creation of an own company, you will have a default project named "DEFAULT". You can rename this project later.
You can also create more projects on the projects page with "Create".
Each project of a company must have a unique name.

Do '''not''' set SSA, if you want to import your devices from your old license manager account first.
If you want SSA and you '''won't import''' devices into this project from your old account, you should set SSA at once.

You can select a certain project by activating it in the project list. This selection is then true for all other pages, as some pages require a selected project.

[[Image:overview.jpg|center|thumb|200px|Projects page]]

By activating a project by clicking on the project name in the project list, you can manage this project and its settings.

====Properties====
Rename the project or/and change its description. 
 
You can configure further CC mail addresses inside your '''License Purchase''' project, if you have one. If you purchase licenses on credit, the emails will be also sent to theses addresses.
 
 
Since version 10, an innovaphone device will automatically connect to http://config.innovaphone.com/init
This script looks at the project properties of the project, where the device exists. 
You can configure an update '''URL''' and a '''trusted certificate'''.

====Software Service====
You can put your project under SSA (software service agreement).
You will be asked to enter a SSA end date. This will be the date, where all SSA licenses of all devices in this project will expire.
The end date mustn't be more than one year in the past. 
Optionally you can enter a maximum SSC amount. The SSA end date will be automatically calculated then. 
If you have entered a maximum SSC amount, you have to use the '''Recalculate''' link to calculate a new SSA end date,
if you change your license selection.
 
You can also calculate SSA over all projects at once. In this mode, you '''won't be able''' to confirm the calculation. You'll just see the necessary SSC amount.

After entering a date/SSC amount, you will get a summary of all licenses, which will be put under SSA and the amount of needed SSC licenses.
The SSC value for each license is calculated by the bind date of the license and the entered SSA end date/SSC amount.

[[Image:Ssa_extend.jpg|center|thumb|200px|SSA summary]]

If you have licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the current license version. 

e.g. you have a V7 PBX-PBX7#15 license with bind date 1/1/2010. Version 8 was released on 7/12/2009, so SSA is
calculated from 7/12/2009 for this license. You will see the calculation date in the list under "bind date"

If licenses already have a SSA date, just the difference between the current SSA date and the entered SSA end date must be paid.
If the bind date of the device lies in the past, the difference between the bind date and the current date must be paided twice (this is the column 'days*2'). 
If your license is under SSA, which is already over, you also have to pay the time between the old SSA date and the current SSA end date twice.

Here is a short example, how the days are calculated:

Bind date: 24/06/2009 
Current date: 31/08/2009 
SSA end date: 12/12/2011 
 
You will have to pay from 24/06/2009 to 31/08/2009 twice for 68 days.
From 31/08/2009 to 12/12/2011 you will then have to pay the normal price for 833 days.

You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

You can preview the SSC calculation for another calculation date. Simply change the dropdown
selection to get the new SSC value.
Of course you can't confirm this calculation for another date, just for the current date!

''You may add additional licenses to the calculation, which you will bind later''. Just click on the '''+''' near this text and you can add
multiple licenses, which will be added to your calculation after using the recalc link. Listed are licenses of the current version and from
your balance.

After confirming your entered SSA end date, each license will have this date as SSA end date and can be downloaded in all versions of this SSA time.

You can now extend the projects SSA end date like as setting a new one.
The resulting summary is the same as above.

If your user account has the right to buy licenses on credit, just check the checkbox.
You may enter an order number, which you can use for your order, if you buy on credit.

=====Past SSA end date=====

You can configure a new SSA end date in the past, if you accidentally configured a wrong date. 
No licenses will be changed, if you configure a date in the past, just the SSA end date of the project!

=====SSA Expiry Mail=====

If project SSA will expire, each company user will receive a reminder mail '''7''' weeks before and
then every week one mail.
You can disable these mails with the checkbox 'Send SSA expiry mails'.
Note that every user can configure, if he wants to receive mails or not in his account settings.

If you want the end user of the project to receive an expiry mail, you can configure a '''reseller''' mail address and end user mail addresses. These end users will then receive an email, 30 days before the project will expire. The default text is:

<code type="text">
Your Software Service Agreement for your innovaphone PBX in project "{$arg[3]}" will expire in {$arg[1]} days.
Please contact your reseller {$arg[2]} to upgrade the license. 
The upgrade of the license is important to secure the phone system!
</code>

You can change this text as you want. You can use placeholders:
* '''{$arg[1]}''': days left
* '''{$arg[2]}''': reseller mail address
* '''{$arg[3]}''': project name
 
You can also define a global text for all projects under your [[Reference:My_Innovaphone#Company | Company settings]].

You can optionally configure to receive project SSA independent reminder mails for each license of a device [[Reference:My_Innovaphone#Company_2|here]].

=====Automatic SSA Extension Service=====

You can request an automatic SSA extension service for a project, which is under SSA. By following this link, you will have the opportunity to request a callback and/or the necessary agreement as PDF file.

All licenses have to be under SSA to use the automatic SSA extension service!

There are some basics to know, if a project is under automatic SSA:
* If you bind new/free licenses, they'll get SSA until the current project SSA date and you will receive an invoice for the SSCs
* If you move devices into this project, their licenses will get SSA until the current project SSA date and you will receive an invoice for the SSCs
* You can't join this project into another project, but you can join another project into this one

====Rights====
=====Own project=====
Add or delete company rights for this project. To add a company right, you have to enter the company id of this company.
Each user of a company with rights on this project can add devices, licenses, activation keys to this specific project, but is restricted in removing devices, editing the project and can't create activation keys with the projects balance.

The company id can be found under Licenses->company and the company tab.

[[Image:Project_rights.jpg|center|thumb|200px|Project rights]]

=====External Project=====
If another company granted access rights to a project to you, you can unsubscribe from this project here.

====Import====
The import has been disabled. All old devices are already imported and can be added to your project manually.

====Join====
Here you can join your currently selected project with another project, which you select from a dropdown box. 
If the other project has SSA, you'll see the current SSA end date, which you might change for the join process and you will get a list of all licenses, which might be updated to the ssa end date/changed date of the other project. The list equals the list shown under [[Reference:My_Innovaphone#Software_Service|Software Service]].

The selected project will be automatically deleted after the join. You can't join a project,
if it grants external rights to another customer. Delete these rights before.

You can't change the SSA end date, if the other project is under automatic SSA! You will receive an invoice for SSCs used for the join.

====Project Move (admin only)====
A company admin can move a project with its devices, activation keys, balance etc. to another company. You have to know the company ID from this company, which can be found under Licenses->Company and the company tab. 
The history won't be moved!

Projects with negative balances can't be moved!

Existing project rights will be deleted.

====Delete====
Delete the project. Only possible if it has no activation keys, project rights, devices or user rights.
 
You may [[Reference:My_Innovaphone#Join|join]] your project into another one, if you can't delete it.

====Project Freed_RMA_licenses====
If you see a project with this name in your project list, you had a RMA device with not yed moved licenses, which was shipped to innovaphone and reshipped to another customer. 
The licenses of such a device have been moved into the pool of free licenses of the project Freed_RMA_licenses, from where you can assign them to another device.

====Rental====
Projects starting and ending with the '''$''' sign in their name are rental projects. 
The name corresponds to the domain name of a Devices App installation. 
 
All software licensing and device management can be just done through the Devices App itself, see [[Reference13r1:Concept_App_Service_Devices#Rental_program_and_Payment_method]]. 
Just '''hardware licenses''' still need to be bound inside my.innovaphone currently and have to be downloaded there and uploaded on the device itself just as usual.

===Balance===
On the balance page you will see the balance of the currently selected project or the balance of all your projects together.
The balance is bound to your company and '''not''' to your user account. The balance is bound to a specific project, but can be shared for license creation or activation key creation if wished. 
Sharing the balance over several projects is not possible in external projects!

[[Image:Balancepage.jpg|center|thumb|200px|Balance page]]

====Free licenses====

Here you see a list of all your free licenses. If you return licenses from one of your devices, the returned licenses are stored in your free licenses pool. You can assign these licenses to another device (see [[#Add licenses from free licenses|'Add licenses from free licenses']]).

[[Image:Balance_free_lics.jpg|center|thumb|200px|Free licenses list]]

The bind date, SSA end date and the external key (like DECT-Multi-Cell-Ari) are stored for each license.

===Activations===

You'll see a list of all your bound activation keys with their licenses here.

[[Image:Activations.jpg|center|thumb|200px|Activation key page]]

====Add an activation key====
To increase your projects balance, select one of your projects, follow the "Add" link and enter the activation key in the corresponding field. You can also enter an optional comment for this key. You will then get a listing of all contained licenses. After commiting this key, your project balance will have been increased by the keys values.

"Deselect the current project" to view all activation keys independent of the selected project.

====Search for an activation key by your order number====
Enter your own order number (or nothing), to view your activation keys for this order.

====License certificate====
You can always download the innovaphone license certificate for activation keys in your projects. Simply press the download link in the list at the right side.

===Own Activations===
Here you'll see a list of all created activation keys in the selected project (or over all projects).

You can create activation keys on the project page for other users/companies or to simply transfer licenses from one project to another. 
You can enter a comment, an order number and an order reference. The '''order number''' is your own order number for the key and the '''order reference''' is the reference number of the customer, who receives the newly created key. 
The order reference and order number will be shown in the innovaphone license certificate.

[[Image:Created_activations.jpg|center|thumb|200px|Created activation keys]]

You have to select an activation key in the activation key list to update or delete it.

Updating and deleting a key is only possible, if this key is not assigned.

====Update====
Add more licenses to this key or change its comment, order number and order reference. 
You can also remove licenses by entering e.g. -2, if you want to remove 2 licenses from the key.

[[Image:Own activations update.jpg|center|thumb|200px|Update own activation keys]]

====Delete====
Delete this key. Its licenses will go back into the balance of the currently selected project.

===Devices===
To view your devices you first have to click on the "Show" button. You can leave the filter field empty if you want to view all your devices.

[[Image:Devices_page.jpg|center|thumb|200px|The Devices Page]]

Red marked device names are devices, which are currently in RMA.

MAC addresses of RMA devices do not longer start with 01-...

====List====
A List of your devices in the currently selected project. 
You can deselect the current project/device to list all your devices.

Select a certain device from the device list, to manage its properties, licenses etc.

Actions on multiple devices:
* Move: move several devices into another project at once (see [[Howto:My_Innovaphone#Move_device|Move Device]])
* Remove: remove several devices at once (see [[Howto:My_Innovaphone#Remove|Remove]])

=====Add=====
Follow the "Add new devices" link on the devices page.

There you have a few options:
* You can add a single new device
* You can add devices according to a mac address range (e.g. from 00-90-33-08-20-00 to 00-90-33-08-22-00), maximum 50 at once
* You can add devices by uploading a text file with mac addresses like this (maximum 50 at once, each line one mac):

00-90-33-08-20-20
00-90-33-08-20-21
00-90-33-08-20-22
00-90-33-24-20-20

* You can add devices according to your received order number. Just enter you order number and you will get a list of all devices bount to this number.

Note: MAC addresses can be always given like this:
* 00-90-33-xx-xx-xx
* 00:90:33:xx:xx:xx
* 009033xxxxxx
* xxxxxx (00-90-33- will then be added automatically)

There might be errors, if you try to add a device. They are explained [[Howto:My_Innovaphone#Image_explanation|here]].

As the device warranty will be handled by licenses now, you can also add telephone devices
to your projects.

=====Add warranty extensions=====

Here you can add warranty extension licenses for all devices in the currently selected project. 
You'll get a list of all devices with the corresponding license type(s) and you can specify the years for each device (or for all devices by entering the number in the list header). 
After confirming your selection, you'll get an overview of all needed licenses, which you have to confirm too.

=====Check licence, SSA and warranty status of a device=====
Here you can list licenses with ssa and the warranty end date of a device, which is not in one of your projects. 
For this option to work, you have to link your innovaphone customer ID (5 digits) to your my.innovaphone company. (As the warranty is also the one we grant to our distributors, we don't want to get an end customer confused.)

=====Download devices of an order as CSV=====
Enter an order number to retrieve all devices for this order in a CSV file.

=====Download devices of an order as PDF with barcodes=====
Enter an order number to retrieve all devices for this order in a PDF file with a barcode for each MAC address. 
Der Barcode ist vom Typ C128B.

====Properties====

Change the name and comment of a device.
You can only change the name, if it's no MAC or IPEI.
 
Here you have also the possibility, to directly request RMA for this device with prefilled values.

====Licenses====
Here you can add, download or move licenses.

=====Add licenses from balance=====
To create new licenses for a device, you have to add this device first on the devices page and then select a version of the license
and whether you want to summate the current licencing. If you select current licenses, then older licenses for example V6 or V7 licenses will also be counted as V8 licenses in the next overview. This is necessary if you want to license a V6 unit with V8 licenses, but still want to use it as V6.
After that click "Next".
On the next page you will see a list of all available license types, which depends on your current available license types, of the selected license version and the device type (IP6000, IP800 e.g.):
[[Image:licenses.jpg|center|thumb|200px|Licenses for an IP3000]]
 
If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses to this SSA end date or you can optionally change this date to another one for the new licenses.
 
You see the available project balance, the balance over all projects (excluding external projects), the currently installed licenses and the maximum amount for this device type. You can now enter the value of the new license.
Base/Upgrade licenses can be selected via dropdown box.
'''Voicemail and Standby lics must always have the same amount as the selected PBX-PBX... license!
The maximum amount of PBX-Registration licenses equals the amount of the selected PBX-PBX... license!'''

The whished overall amount of pbx version 8 and above licenses can be specified here and the concrete amount of license sub types will be requested on the next page.

You can preview the SSC calculation of the wished licenses without having them in your balance.

[[Image:licenses2.jpg|center|thumb|200px|Licenses for an IP800 with V8, step two]]

The best (cheapest) combination of each v8 pbx license type is already filled in, but you might change the amount of sub types if your does not fit and you do not want to purchase new activation keys for the sub types.

The column SSC/Unit is just shown if your project is currently under SSA and you have entered a SSA end date.

The SSC multiplicator is the value, which you have to multiplicate with each license unit to get
the corresponding SSC amount.
E.g. if you have 20 units of PBX-Port8*20 licenses with a SSC value of 54 and a multiplicator of
1.0000 (which equals to 365 days) you have to pay 20*54*1.0000 ~ 1080 SSCs.

 If you create licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the currently selected version twice. 
e.g.: you want to bind licenses for V6 with SSA, so you have to pay SSCs from the release date of V7
 You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

You can't change the SSA end date, if the project is under automatic SSA! You will receive an invoice for SSCs used for the new binding.

Now confirm your new selection. If you have not enough licenses in your current project, but there are still licenses in other projects, you will get a dropdown box with a list of all projects containing the needed licenses. You can now select all desired/needed projects and confirm your selection again.
The balance of all selected projects will then be decreased by the needed amount.
 
 
If your user account has the right to buy licenses on credit, just check the checkbox.
 
You may enter an order number, which you can use for your order, if you buy on credit.

=====Add licenses from free licenses=====

Here you can assign licenses, which you returned from other devices.
You will also have to select the desired version and will than get a list of fitting licenses according to the current device and selected version.

[[Image:licenses_free.jpg|center|thumb|200px|Free Licenses for an IP800 with V8]]

If a license is under SSA, the correct license type is shown in column 'License Type' besides the 'Original Type'.
On confirming the selection, a consistency check is done (e.g. only 4 Relay-PRI licenses on an IP6000).
Bind and SSA end date will be maintained for each license.

As external keys are also maintained, you can select e.g. an old Dect-Multicell-Ari license to have the same ARI on another IP1200.
 

If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses
to this SSA end date or you can optionally change this date to another one for the new licenses.
You will have to confirm this after your first license selection (this is the same calculation as [[Reference:My_Innovaphone#Software_Service|here]]).

You can't change the SSA end date, if the project is under automatic SSA! You will receive an invoice for SSCs used for the binding.

=====Add V7 floating license (slave pbx)=====
Here you can add a V7 floating license for a slave pbx. A device with a floating license can't have V7 pbx licenses and a device with V7 pbx licenses can't have a floating license.

=====Delete V7 floating license=====
Here you can delete an already existing floating license, if you won't use it anymore.

=====Add warranty extension licenses=====
Extend your warranty by adding warranty extension licenses:

[[Image:add_warranty.jpg|center|thumb|200px|Warranty extension]]

If you add the warranty extension immediately after the receipt of your device,
you can add the cheaper warranty extension licenses, otherwise you'll have to add
the more expensive ones.

You can extend the warranty for a maximum of four years.

=====Download licenses=====

[[Image:Device_download.jpg|center|thumb|200px|Download Licenses]]

You will get a dropdown with all available versions. Versions are dependent of your device, your licenses and of the ssa of your licenses. 
'''From V9 on''', you just have one option, which will create a license file, which contains the licenses upgraded to the highest version of their type. 
You are able to download downgraded versions of your licenses. E.g. if you have only V8 licenses, you can download a V7 license file (same restrictions as below).

Downgrades or only possible down to version 6!

If you do not want to download licenses by version, you have to decide whether to download the licenses encrypted or not.
'''If you download the licenses unencrypted, you won't be able to return those licenses anymore.'''
So you won't be able to return licenses for devices with V5-V7 licenses, as licenses for these versions are not encrypted.
To return these licenses, you will have to upgrade to a new bootcode, which prevents firmware downgrades to versions below version 8. 
Encrypted licenses are stored in a xml file, which you can then upload on your V8 (or higher) device.

You can now also download licenses directly from by the web interface of a device.
You just have to enter your account data and start downloading the licenses from my.innovaphone.com
without having to download/upload a license file.

=====Download test licenses=====

[[Image:Device_download_test.jpg|center|thumb|200px|Download test licenses]]

You can also download test licenses if you want to run tests. You will be asked, which version you want to use, whether the device is used as slave and if not used as slave, how many pbx licenses you want to use.

'''Important: Since V11, trial licenses are valid for 3 months and can be released once for a dedicated device. After expiration of those 3 months no further trial license creation for this device is possible.'''

V5 does '''not''' support test licenses!

=====Move licenses to another device=====
If you have the needed account rights or the device is already in RMA, you can move licenses to another device. After moving licenses, the former device will be marked as a RMA device.

You can just move licenses to devices without licenses!

=====Mix of rental and purchased licenses=====
From '''13r2 SR12''' onwards you can mix rental and purchased licenses. 
A device with rental licenses will be always inside a rental project (you recognize such a project by it's starting and ending '''$''' in the name). 
You can now add licenses from the balance to a device in such a rental project. 
 
If you invalidate lifetime licenses on such a device, just purchased licenses are returned. Rental licenses stay bound until you remove them inside your Devices App! (under rental menu)
Inside my.innovaphone you will always see both rental and purchased licenses. Inside the Devices App, you will just see the rental licenses. 
 
You must download and/or install the purchased licenses as usual. 
 
A 13r1 PBX or a PBX with an older SR will just recognize rented licenses!

====Move device====
Here you can move the current device or the selected devices to another project. 
If you select a SSA project, you can change the SSA end date for the move process. 

If the other project is under SSA, you will first see a SSC calculation, which you have to confirm,
as the SSA date for each SSA license will be extended until the given SSA end date
(this is the same calculation as adding SSA to an already existing project, see [[Reference:My_Innovaphone#Software_Service|here]]).

You can't change the SSA end date, if the other project is under automatic SSA! You will receive an invoice for SSCs used for the move.

====Invalidation====

=====Requirements=====
* V8 or higher
* access to the webinterface
* a device certificate
* my.innovaphone login credentials
* '''no IPVA device'''
* no 'In House' licenses

=====Informations=====

You can invalidate V8 (or higher) licenses by uploading the XML file, you got from your device or by returning your licenses over the web interface of your device ([[Reference8:Configuration/General/License]]), in order to return [[Reference8:Licenses#Gateway_Licenses|PBX licenses]] back to the balance.

V7 licenses can be just returned, if you agree, that you won't be able to downgrade below V8 anymore. You will need a new bootcode, to use this function. '''You need a V8 firmware or higher for invalidation.'''

If your device has access to my.innovaphone.com, you can also invalidate licenses directly
from the web interface of the device.

[[Reference8:Licenses#Gateway_Licenses|gateway licenses]] and warranty extensions won't be returned to the balance and remain to be assigned to the device!

The licenses needn't be present on the local device to perform the invalidation!

SSA it's bound to the license and it's not lost when performing invalidation.

=====Process=====

Steps to invalidate licenses, if your device has internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# enter your my.innovaphone account, the device must be in one of your projects
# click Invalidate
# click Transfer (this might fail, if NTP or DNS is not configured properly or device certificate is not installed)
# reset if asked for

Steps to invalidate licenses, if your device has no internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# click Invalidate
# click Backup and upload this file on my.innovaphone [[Reference:My_Innovaphone#Upload_the_invalidation_document_to_return_licenses|here]] (Licenses->Devices (select the corresponding device)->Invalidation)
# you'll get a confirmation file after uploading the saved file
# upload this on the device (under Step1)
# reset if asked for

"Your IP800 does not have a device certificate on it." - In this case you need to download a hardware certification,
please contact the innovaphone [mailto:license@innovaphone.com license].

=====Download confirmation file=====
If you created a new certificate or you invalidated your licenses, you can later download the confirmation file, which you have to upload on the box.

=====Request certificate=====
If you have the needed rights, you can request a new device certificate for your device.

=====Upload the invalidation document to return licenses=====
Licenses->Devices (select the corresponding device)->Invalidation:

Upload the invalidation document, which you got from the website of the device to return the licenses of this device.

After uploading you'll get a confirmation file, which you have to upload on your device.

====Remove====
You can always remove devices from a project. If they have licenses, these won't be deleted, so you might add the device to another project again.

===History===
[[Image:history.jpg|center|thumb|200px|History page]]
You can view your history for several contexts:
* Company: history of all actions in your company
* User: history of all actions of the selected user
* Device: history of all actions for the selected device

Each context applies to the currently selected project.
If you deselect the current project, you will see the history over all projects.

You can select to view the history of the last day, week, month, year or from always. Collecting data might take a while...

===Company===
Manage users SSA expiry email flag, import other companies or add your companies innovaphone ID.

====Users====

You can just edit the SSA expiry email flag here. The other user settings moved to the [[#Authorized Persons | Authorized persons tab]].

====Join (admin only)====
As admin you can also join another company into your company by entering an admin account of this company. This might be usefull if one user of your company has accidentally created an own company. 
Everything like projects, users, devices, balance, activations etc. will be imported! 
You also have to enter the company id of the company, which is to be imported. You can find this company under Licenses->Company and the company tab.

This is not available for non company admin users.

The joined company will be deleted afterwards!

====Company====

You can check the '''Device SSA''' checkbox, if you want to receive SSA expiry reminder mails for each device independent of the projects SSA end date.
These mails will be send weekly seven weeks before the SSA for a license a the device expires.
 
 
You can also enter additional email addresses, which should receive SSA emails.
 
You can define a global '''end user expiry mail text''' here, which will be sent to end users, if end users are configured in a [[Reference:My_Innovaphone#SSA_Expiry_Mail | project]]. This text can be overridden by a text in a project under [[Reference:My_Innovaphone#SSA_Expiry_Mail | SSA Expiry Mail]].

==RMA==
Here you can see all your RMA devices, which arrived innovaphone already. The licenses of this macadresses are moveable.
[[Image:rma.jpg|center|thumb|200px|RMA page]]
 
If you want to request RMA for a certain device, go to the device properties and follow the "Request RMA" link.

==Support==
===Mantis===
Here you'll get a list of all open cases and [[Understanding_the_innovaphone_trouble_ticket_status_page#Information_available | additional info regarding their state]] in our ticket system. This list is composed of all tickets assigned to email addresses of your my.innovaphone users in your company. 
Often used functions:
* You can click on the ticket number ("ID" column) to open an email prepared with the right emailadress and subject to address this case.
* You can click on the ''History'' link to get an overview of the already made communication with our support/presales-team.
* Another important new function is the option to upload larger files to your support/presales tickets using the ''Fileupload'' column.

===Announcements===
You can convert audio files into G.7xx files which you can use as announcements. 
 
;Supported input formats:
* mp3
* wav
* ogg
* flac
* ...

;Generated output formats:
* G.711u
* G.711a
* G.729
* G.723
* G.722

==Image explanation==

===Errors===

====Already In Company====
[[Image:Icon_in_company_inno_01.png]]
* This device already exists in your company and can't be added/imported.
If you want to import this device anyway, you first have to delete your current device from its project.

====Already Imported====
[[Image:Icon_imported_inno_01.png]]
* This device has been already imported.
You can't import it again.

====Not Found====
[[Image:Icon_not_found_inno_01.png]]
* This device was not found in the my innovaphone database.
This should never happen, but if, contact the administrator.

====IPVA MAC exists====
[[Image:Icon_ip_va_exists_inno_01.png]]
* An IPVA MAC address must be unique and can be assigned to just one company. You tried to add an already existing IPVA MAC.
Please assign a new one to your IPVA. For further details, see [[Reference13r2:Concept_Innovaphone_Virtual_Appliance#License_Configuration]].

my.innovaphone supports the following MAC address ranges:
* 00-50-56-...
* 00-15-5d-...
* 00-03-ff-...
* 00-0d-3a-...
* 00-12-5a-...
* 00-17-fa-...
* 00-50-f2-...
* 00-1d-d8-...
* 00-05-69-...
* 00-1c-14-...
* 00-0c-29-...
* 00-1d-db-...
* 5a-ad-1d-...

===Warnings===

====Several Companies====
[[Image:Icon_several_companies_inno_01.png]]
* This device is already in another company.
This means, that either you do not have the physical device or it once belonged another company.
You can still import/add this device and you will have access to all of its current licenses.

====Several Users====
[[Image:Icon several users inno 01.png]]
* This device has licenses from several users of the old license manager.
This means, that you are not neccessarily the user, who physically owns this device. If you do not own it, do not import it.

===Misc===
====No downgrade====
[[Image:no_downgrade.png]]
* Licenses, which have been downloaded for V5/V6/V7, were returned from this device, so no downgrade to these versions is allowed any more.



==Release dates==
V5: January 1st 2003 
V6: November 2nd 2006 
V7: November 14th 2008 
V8: December 7th 2009 
V9: April 26th 2011 
V10: July 8th 2013 
V11: February 9th 2015 
V12: July 11th 2016 
V13: May 13th 2019 



==External interface==

There is an external interface, which you can use to control some functionality without a login to the my.innovaphone web site. 
You can use the interface with an '''HTTP GET''' request to the following URL: 
 
'''<code>https://my.innovaphone.com/interface.php</code>'''

===General parameters for all commands===
:;cmd: the wished command
:;email: the email address of a user who is registered in my.innovaphone
:;project_id: the project ID of the project where the user has access to (you can find the project ID under [[Reference:My_Innovaphone#Properties | Licenses->Projects->Properties]])
:;hash: an SHA256 hash value which is computed over all GET parameters but the hash parameter itself plus the '''trust''' value of the project (see [[Reference:My_Innovaphone#Properties]])
:;hash: the values of the GET parameters have to be URL encoded before calculation of the hash

;Example: URL <code>https://my.innovaphone.com/interface.php?cmd=addDevice&email=user@example.com&project_id=123456&serial=00-90-33-01-02-03&hash=b62f7948d6383cc365592ed289b6173cd35229cadc347847b953f78c8880d5b9</code>
:;project trust value: 1234567890abcdef
:;the data of the SHA256 hash: ?cmd=addDevice&email=user%40example.com&project_id=123456&serial=00-90-33-01-02-03&trust=1234567890abcdef
:;example PHP function call to generate the hash: hash("sha256", "?cmd=addDevice&email=user%40example.com&project_id=123456&serial=00-90-33-01-02-03&trust=1234567890abcdef");
:;with the current values, the function should return: b62f7948d6383cc365592ed289b6173cd35229cadc347847b953f78c8880d5b9

===Add a device to a project===
;HTTP GET parameters:
:;general parameters
:;cmd: '''addDevice'''
:;serial: the serial number of the device, e.g. 00-90-33-01-02-03

;Return value: a JSON object is returned
:;success: boolean, either '''true''' or '''false'''
:;error: string, a string with an error. Just existent if success is false
:;example success: <code type="javascript">{ "success":true }</code>
:;example error: <code type="javascript">{ "success":false, "error":"the project with ID 123456 doesn't exist" }</code>

===Remove a device from a project===
;HTTP GET parameters:
:;general parameters
:;cmd: '''delDevice'''
:;serial: the serial number of the device, e.g. 00-90-33-01-02-03

;Return value: a JSON object is returned
:;success: boolean, either '''true''' or '''false'''
:;error: string, a string with an error. Just existent if success is false
:;example success: <code type="javascript">{ "success":true }</code>
:;example error: <code type="javascript">{ "success":false, "error":"the project with ID 123456 doesn't exist" }</code>

===Get the warranty of a device===
;HTTP GET parameters:
:;general parameters
:;cmd: '''getWarranty'''
:;serial: the serial number of the device, e.g. 00-90-33-01-02-03

;Return value: a JSON object is returned
:;success: boolean, either '''true''' or '''false'''
:;error: string, a string with an error. Just existent if success is false
:;warranty: a unix timestamp in seconds sind 1970 (timezone Europe/Berlin), e.g. '''1448492400'''
:;warrantyStr: a string like '''"2015-11-26 00:00:00"'''

===Create a new project===
;HTTP GET parameters:
:;general parameters: you must use the project_id and trust value of an already existing project!
:;cmd: '''createProject'''
:;project_name: the name of the new project
:;[project_desc]: optional, a description for the new project
:;[update_url]: optional, an update URL for the project (do not forget to URL encode the value inside your HTTP GET request!)
:;[ssa_due_date]: optional, a unix timestamp in seconds sind 1970 (timezone Europe/Berlin), e.g. '''1448492400'''

;Return value: a JSON object is returned
:;success: boolean, either '''true''' or '''false'''
:;error: string, a string with an error. Just existent if success is false
:;projectId: the project id of the created project

The newly created project is created with the same trust value which was used for the creation request. This allows you to directly use the API with the new project.

==Known Issues==
===Smaller issues===
* Devices where imported into a project with SSA. If this happened to you, please move the corresponding devices into a project '''without''' SSA and back into the project '''with''' SSA to extend/add SSA for the licenses until the SSA end date.
* IE7 moves a list under the menu, when a list becomes to wide
===Licenses don't work on a device, where an invalidation has been done===
A possible reason here is, that the invalidation process hasn't been completed.
To resolve this issue, follow these steps:

* Download the Confirmation File (Certificate) from http://my.innovaphone.com under [[Reference:My_Innovaphone#Invalidation|Invalidation]] after selecting the project and the device
* Open [[Reference9:General/License/my.innovaphone|General->License->my.innovaphone.com]] on your device
* Click on "Invalidate" (no my.innovaphone credentials needed)
* Upload the previously downloaded confirmation file newcert-00-90-33-xx-xx-xx.xml as "Confirmation file"
* Reset the box
* Reupload the licenses

===Internet Explorer doesn't work===
Yes, that's correct. Please use an up to date version of Chrome, Firefox or Edge!

Howto:Dimension and weight for packing

2020-04-15T22:13:48Z

Kti:

==More information==
This information applies to innovaphone products including package.


= Dimensions an weight of packaged goods =
For delivery and in tender some times the dimension and weight for the packed single products are requested.

The following table shows weight in kg and dimensions of packaging in mm of some products:

{| {{table}}
{| border="1"
! Item Number !! Description !! Net weight in kg !! Gross weight in kg !! Dimensions with packaging in mm !! Dimensions without packaging in mm
|-
| 01-00011-001 || IP0011 || 0,80 || 1,06 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00029-001 || IP29 || 0,91 || 1,16 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00029-003 || IP29-2 || 0,91 || 1,16 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00029-004 || IP29-4 || 0,91 || 1,16 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00029-005 || IP29-8 || 0,91 || 1,16 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00038-001 || IP38 || 0,69 || 0,94 || 230 X 225 X 80 || 210 X 133 X 37
|-
| 01-00110-002 || IP110A || 0,39 || 0,73 || 225 X 205 X 70 || 190 X 160 X 50
|-
| 01-00101-001 || IP101 || 0,66 || 0,8 || 200 X 235 X 80 || 160 X 160 X 37
|-
| 01-00102-001 || IP102 || 0,66 || 0,8 || 200 X 235 X 80 || 160 X 160 X 37
|-
| 01-00111-001 || IP111 || 0,50 || 1,07 || 260 X 230 X 95 || 213 X 160 X 37
|-
| 01-00112-001 || IP112 || 0,50 || 1,07 || 260 X 230 X 95 || 213 X 160 X 37
|-
| 01-00150-001 || IP150 IP Phone|| 1,90 || 2,93 || 385 X 255 X 200 || 270 X 190 X 95
|-
| 01-00150-010 || Ferntel IP HH with Headphones || 3,26 || 6,00 || 400 x 305 x 335 || 195 x 295 x 95
|-
| 01-00200-002 || IPPhone200 || 0,63 || 1,16 || 320 X 224 X 100 || 220 X 220 X 85
|-
| 01-00222-001 || IP222 (Black) || 0,50 || 1,20 || 275 X 195 X 90 || 217 X 155 X 31
|-
| 01-00222-002 || IP222 (White) || 0,46 || 1,18 || 275 X 195 X 90 || 217 X 155 X 31
|-
| 01-00230-001 || IP230-X || 0,23 || 0,40 || 240 X 160 X 70 || 190 X 100 X 50
|-
| 01-00232-001 || IP232 (Black) || 0,50 || 1,20 || 275 X 195 X 90 || 220 X 150 X 30
|-
| 01-00232-002 || IP232 (White) || 0,52 || 1,21 || 275 X 195 X 90 || 220 X 150 X 30
|-
| 01-00240-003 || IP240 || 0,81 || 1,39 || 355 X 240 X 110 || 270 X 190 X 98
|-
| 01-00241-001 || IP241 || 0,80 || 1,36 || 335 X 240 X 110 || 268 X 190 X 100
|-
| 01-002X2-001 || IP2X2-X (Black) || 0,38 || 0,66 || 275 x 195 x 90 || 152 x 89 x 32
|-
| 01-002X2-002 || IP2X2-X (White) || 0,38 || 0,66 || 275 x 195 x 90 || 152 x 89 x 32
|-
| 01-00302-001 || IP302 || 0,69 || 1,03 || 230 X 225 X 85 || 210 X 135 X 33
|-
| 01-00305-001 || IP305 || 0,69 || 1,02 || 230 X 225 X 85 || 210 X 135 X 33
|-
| 01-00311-001 || IP311 || 0,83 || 1,08 || 235x228x85 || 210x149x34
|-
| 01-00411-001 || IP411 || 0,83 || 1,09 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00800-016 || IP800 || 1,30 || 1,80 || 230 X 225 X 85 || 210 X 185 X 33
|-
| 01-00811-001 || IP811 || 0,83 || 1,09 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00999-001 || IP800-RACK || 1,18 || 1,38 || 510 x 195 x 60 || 483 x 186 x 49
|-
| 01-01130-001 || IP1130 || 1,03 || 1,28 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-03011-001 || IP3011 || 1,64 || 1,87 || 235 x 228 x 85 || 210 x 210 x 34
|-
| 01-06010-002 || IP6010 || 1,64 || 1,87 || 230 X 225 X 85 || 210 X 213 X 33
|-
| 03-00010-002 || 12 V PSU with int. Adapter for IP phones || 0,08 || 0,14 || 110 X 94 X 70 || 77 X 35 X 50
|-
| 03-00010-004 || 12 V PSU for IP phones || 0,08 || 0,14 || 105 X 96 X 39 || 73 X 75 X 27
|-
| 03-00010-009 || mSata 32GB || 0,06 || 0,08 || 60 x 60 x 1 || 51 x 30 x 1
|-
| 03-00010-010 || mSata 128GB || 0,06 || 0,08 || 60 x 60 x 1 || 51 x 30 x 1
|-
| 03-00010-011 || mSata 256GB || 0,06 || 0,08 || 60 x 60 x 1 || 51 x 30 x 1
|-
| 03-00010-231 || PoE Adapter Gigabit || 0,34 || 0,42 || 116 X 21 X 56 || 50 X 138 X 35
|-
| 50-00060-001 || DECT Charger and PSU IP61/IP62/IP63/IP64/IP65 EU || 0,23 || 0,32 || 140 X 115 X 70 || 95 X 90 X 60
|-
| 50-00060-002 || DECT Charger and PSU IP61/IP62/IP63/IP64/IP65 UK/US/AUS || 0,31 || 0,39 || 173x115x65 || 90x70x100
|-
| 50-00060-005 || DECT Battery IP61/IP64 || 0,17 || 0,18 || 60 X 55 X 10 || 47 X 35 X 7
|-
| 50-00060-006 || DECT Multicharger IP61/IP62/IP63/IP64/IP65 || 1,66 || 1,88 || 165 x 498 x 130 || 158 x 456 x 103
|-
| 50-00060-007 || DECT Battery Multicharger IP62/IP63 || 1,48 || 1,7 || 165 x 498 x 130 || 158 x 456 x 103
|-
| 50-00060-008 || DECT Battery IP62 / IP63 || 0,28 || 0,32 || 75 X 70 X 10 || 70 X 45 X 8
|-
| 50-00060-009 || Dect Swivel Clip IP62 / IP63 / IP64 || 0,20 || 0,22 || 105 X 80 X 10 || 55 X 50 X 10
|-
| 50-00060-010 || DECT Safety Belt IP61/IP62/IP63/IP64/IP65 || 0,006 || 0,008 || 97 X 60 X 20 || 70 X 45 X 20
|-
| 50-00060-011 || Dect Standard Clip IP61/IP64 || 0,008 || 0,01 || 60 X 25 X 25 || 55 X 23 X 25
|-
| 50-00060-012 || DECT Standard Clip IP62 / IP63 || 0,006 || 0,01 || 150 X 95 X 10 || 58 X 25 X 10
|-
| 50-00060-016 || DECT Headsetcable jack IP61 / IP62 / IP63 || 0,01 || 0,02 || 245 X 130 X 10 || 300 X 20 X 10
|-
| 50-00060-017 || Dect PSU IP1202 / IP1202/4 / IP1202e EU || 0,226 || 0,258 || 130 x 90 x 65 || 96 x 83 x 29
|-
| 50-00060-018 || DECT PSU IP1202 / IP1202/4 / IP1202e UK || 0,230 || 0,266 || 130 x 90 x 62 || 70 x 25 x 45
|-
| 50-00060-021 || Desktop programmer IP62/IP64/IP65 || 0,12 || 0,17 || 140 X 115 X 70 || 140 X 80 X 40
|-
| 50-00060-023 || Dect Battery Multicharger IP65 || 1,5 || 1,72 || 495x165x125 || 455x150x10
|-
| 50-00060-024 || Dect Standard Clip IP65 || 0,006 || 0,01 || 150 X 95 X 10 || 58 X 25 X 10
|-
| 50-00060-025 || Dect Swivel Clip IP65 || 0,02 || 0,02 || 120x80x10 || 50x55x10
|-
| 50-00060-026 || Dect Leathercase IP64 || 0,05 || 0,06 || 240x90x10 || 150x65x15
|-
| 50-00060-027 || Dect Leathercase IP65 || 0,05 || 0,06 || 240x90x10 || 145x65x15
|-
| 50-00060-028 || Dect Battery IP65 || 0,28 || 0,32 || 75 X 70 X 10 || 70 X 45 X 8
|-
| 50-00060-029 || DECT Headsetcable jack IP64 / IP65 || 0,02 || 0,04 || 185x40x30 || 1000x10x5
|-
| 50-00060-030 || Dect Headset mono IP61 / IP62 / IP63 / IP64 / IP65 || 0,04 || 0,18 || 190x145x70 || 1000x45x25
|-
| 50-00060-032 || Dect Adapter for Headset mono IP64 / IP65 || 0,02 || 0,02 || 245x130 || 330x10x5
|-
| 50-00062-001 || IP62 WLAN phone || 0,14 || 0,19 || 145 X 80 X 40 || 133 X 45 X 35
|-
| 50-00064-004 || IP64 || 0,12 || 0,16 || 7,6 x 15,0 x 4,0 || 5,5 x 13,8 x 3,2
|-
| 50-00065-001 || IP65 || 0,12 || 0,17 || 7,6 x 15,0 x 4 || 5,2 x 13,8 x 3,2
|-
| 50-00081-001 || D81 DECT phone || 0,176 || 0,278 || 160 X 70 X 45 || 140 X 55 X 30
|-
| 50-00081-002 || D81 ex. DECT phone || 0,18 || 0,28 || 73 x 163 x 47 || 54 x 140 x 35
|-
| 50-00081-003 || DECT Charger and PSU D81/D81 ex. EU || 0,18 || 0,35 || 145 X 117 X 74 || 90 X 105 X 55
|-
| 50-00081-004 || DECT Charger and PSU D81/I62/D81 ex. UK || 0,31 || 0,40 || 180 X 115 X 70 || 90 X 90 X 60
|-
| 50-00081-005 || battery D81 || 0,03 || 0,03 || 120 X 72 X 11 || 72 X 43 X 9
|-
| 50-00081-006 || battery D81 ex || 0,02 || 0,06 || 65 x 158 x 45 || 40 x 70 x 12
|-
| 50-00081-007 || Battery pack opener D81 ex. || 0,004 || 0,008 || 140 X 100 X 6 || 70 X 40 X 6
|-
| 50-00081-009 || D81 belt Clip || 0,02 || 0,02 || 90 x 148 x 30 || 42 x 78 x 32
|-
| 50-00081-010 || D81 Leathercase || 0,08 || 0,088 || 245 X 165 X 60 || 145 X 55 X 60
|-
| 50-01202-001 || IP1202 || 0,40 || 0,51 || 187 X 175 X 78 || 170 X 165 X 40
|-
| 50-01202-002 || IP1202 (4 Channel) || 0,38 || 0,49 || 185 x 173 x 67 || 162 x 162 x 30
|-
| 50-01202-003 || IP1202e || 0,43 || 0,62 || 187 X 175 X 78 || 170 X 165 X 40
|-
| 50-01202-004 || IP1202e Double directional antenna || 0,15 || 0,32 || 270 X 125 X 45 || 100 X 95 X 35
|-
| 50-01202-005 || IP1202e Single directional antenna || 0,70 || 1,02 || 320 X 145 X 132 || 265 X 140 X 35
|-
| 50-01202-006 || IP1202e Omnidirectional antenna || 0,472 || 0,314 || 440 X 92 X 115 || 1530 X 30 X 40
|-
| 50-01202-007 || IP1202 / IP1202/4 / IP1202e Additional housing transparent || 1,51 || 1,51 || 360 x 254 x 114 || 360 x 254 x 114
|-
| 50-01202-008 || IP1202 / IP1202e Additional housing with trace heating || 6,80 || 7,00 || 410 X 225 X 430 || 390 X 205 X 410
|-
| 01-00029-007 || IP29-20 || 1,66 || 1,82 || 235 x 228 x 85 || 225 x 210 x 34
|}

= storage parameters =
Please observe storage parameters:

storage temperature 10°C to +70°C

humidity 10% to 90% noncondensing.

This information is dated January 2019 and is subject to change without notice.

= Number of units in a pallet =

{| {{table}}
{| border=1
|+
! Item Number !! Description !!Articles in pallet !! Gross weight in kg !! Dimensions with packaging in mm
|-
|88-00010-030
|Pallet IP240
|80
|134
|EURO pallet 120 x 80 x 120
|-
|88-00010-035
|Pallet IP241
|80
|134
|EURO pallet 120 x 80 x 120
|-
|88-00010-037
|Pallet IP222 (Weiß)
|172
|230
|EURO pallet 120 x 80 x 120
|-
|88-00010-038
|Pallet IP222 (Schwarz)
|172
|230
|EURO pallet 120 x 80 x 120
|-
|88-00010-039
|Pallet IP232 (Weiß)
|172
|230
|EURO pallet 120 x 80 x 120
|-
|88-00010-040
|Pallet IP232 (Schwarz)
|172
|230
|EURO pallet 120 x 80 x 120
|-
|88-00010-069
|Pallet IP111
|120 (midyear of 2020, 165)
|150 (midyear of 2020 -188)
|single-use 120 x 80 x 120 (midyear 2020 - 105)
|-
|88-00010-072
|Pallet IP112
|165
|188
|single-use 120 x 80 x 105
|-
|88-00010-087
|Pallet IP101
|150
|135
|EURO pallet 120 x 80 x 110
|-
|88-00010-088
|Pallet IP102
|150
|135
|EURO pallet 120 x 80 x 110
|-

|}

Howto:Dimension and weight for packing

2020-01-30T09:38:11Z

Kti:

==More information==
This information applies to innovaphone products including package.


= Dimensions an weight of packaged goods =
For delivery and in tender some times the dimension and weight for the packed single products are requested.

The following table shows weight in kg and dimensions of packaging in mm of some products:

{| {{table}}
{| border="1"
! Item Number !! Description !! Net weight in kg !! Gross weight in kg !! Dimensions with packaging in mm !! Dimensions without packaging in mm
|-
| 01-00011-001 || IP0011 || 0,80 || 1,06 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00029-001 || IP29 || 0,91 || 1,16 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00029-003 || IP29-2 || 0,91 || 1,16 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00029-004 || IP29-4 || 0,91 || 1,16 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00029-005 || IP29-8 || 0,91 || 1,16 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00038-001 || IP38 || 0,69 || 0,94 || 230 X 225 X 80 || 210 X 133 X 37
|-
| 01-00110-002 || IP110A || 0,39 || 0,73 || 225 X 205 X 70 || 190 X 160 X 50
|-
| 01-00101-001 || IP101 || 0,66 || 0,8 || 200 X 235 X 80 || 160 X 160 X 37
|-
| 01-00102-001 || IP102 || 0,66 || 0,8 || 200 X 235 X 80 || 160 X 160 X 37
|-
| 01-00111-001 || IP111 || 0,50 || 1,07 || 260 X 230 X 95 || 213 X 160 X 37
|-
| 01-00112-001 || IP112 || 0,50 || 1,07 || 260 X 230 X 95 || 213 X 160 X 37
|-
| 01-00150-001 || IP150 IP Phone|| 1,90 || 2,93 || 385 X 255 X 200 || 270 X 190 X 95
|-
| 01-00150-010 || Ferntel IP HH with Headphones || 3,26 || 6,00 || 400 x 305 x 335 || 195 x 295 x 95
|-
| 01-00200-002 || IPPhone200 || 0,63 || 1,16 || 320 X 224 X 100 || 220 X 220 X 85
|-
| 01-00222-001 || IP222 (Black) || 0,50 || 1,20 || 275 X 195 X 90 || 217 X 155 X 31
|-
| 01-00222-002 || IP222 (White) || 0,46 || 1,18 || 275 X 195 X 90 || 217 X 155 X 31
|-
| 01-00230-001 || IP230-X || 0,23 || 0,40 || 240 X 160 X 70 || 190 X 100 X 50
|-
| 01-00232-001 || IP232 (Black) || 0,50 || 1,20 || 275 X 195 X 90 || 220 X 150 X 30
|-
| 01-00232-002 || IP232 (White) || 0,52 || 1,21 || 275 X 195 X 90 || 220 X 150 X 30
|-
| 01-00240-003 || IP240 || 0,81 || 1,39 || 355 X 240 X 110 || 270 X 190 X 98
|-
| 01-00241-001 || IP241 || 0,80 || 1,36 || 335 X 240 X 110 || 268 X 190 X 100
|-
| 01-002X2-001 || IP2X2-X (Black) || 0,38 || 0,66 || 275 x 195 x 90 || 152 x 89 x 32
|-
| 01-002X2-002 || IP2X2-X (White) || 0,38 || 0,66 || 275 x 195 x 90 || 152 x 89 x 32
|-
| 01-00302-001 || IP302 || 0,69 || 1,03 || 230 X 225 X 85 || 210 X 135 X 33
|-
| 01-00305-001 || IP305 || 0,69 || 1,02 || 230 X 225 X 85 || 210 X 135 X 33
|-
| 01-00311-001 || IP311 || 0,83 || 1,08 || 235x228x85 || 210x149x34
|-
| 01-00411-001 || IP411 || 0,83 || 1,09 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00800-016 || IP800 || 1,30 || 1,80 || 230 X 225 X 85 || 210 X 185 X 33
|-
| 01-00811-001 || IP811 || 0,83 || 1,09 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00999-001 || IP800-RACK || 1,18 || 1,38 || 510 x 195 x 60 || 483 x 186 x 49
|-
| 01-01130-001 || IP1130 || 1,03 || 1,28 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-03011-001 || IP3011 || 1,64 || 1,87 || 235 x 228 x 85 || 210 x 210 x 34
|-
| 01-06010-002 || IP6010 || 1,64 || 1,87 || 230 X 225 X 85 || 210 X 213 X 33
|-
| 03-00010-002 || 12 V PSU with int. Adapter for IP phones || 0,08 || 0,14 || 110 X 94 X 70 || 77 X 35 X 50
|-
| 03-00010-004 || 12 V PSU for IP phones || 0,08 || 0,14 || 105 X 96 X 39 || 73 X 75 X 27
|-
| 03-00010-009 || mSata 32GB || 0,06 || 0,08 || 60 x 60 x 1 || 51 x 30 x 1
|-
| 03-00010-010 || mSata 128GB || 0,06 || 0,08 || 60 x 60 x 1 || 51 x 30 x 1
|-
| 03-00010-011 || mSata 256GB || 0,06 || 0,08 || 60 x 60 x 1 || 51 x 30 x 1
|-
| 03-00010-231 || PoE Adapter Gigabit || 0,34 || 0,42 || 116 X 21 X 56 || 50 X 138 X 35
|-
| 50-00060-001 || DECT Charger and PSU IP61/IP62/IP63/IP64/IP65 EU || 0,23 || 0,32 || 140 X 115 X 70 || 95 X 90 X 60
|-
| 50-00060-002 || DECT Charger and PSU IP61/IP62/IP63/IP64/IP65 UK/US/AUS || 0,31 || 0,39 || 173x115x65 || 90x70x100
|-
| 50-00060-005 || DECT Battery IP61/IP64 || 0,17 || 0,18 || 60 X 55 X 10 || 47 X 35 X 7
|-
| 50-00060-006 || DECT Multicharger IP61/IP62/IP63/IP64/IP65 || 1,66 || 1,88 || 165 x 498 x 130 || 158 x 456 x 103
|-
| 50-00060-007 || DECT Battery Multicharger IP62/IP63 || 1,48 || 1,7 || 165 x 498 x 130 || 158 x 456 x 103
|-
| 50-00060-008 || DECT Battery IP62 / IP63 || 0,28 || 0,32 || 75 X 70 X 10 || 70 X 45 X 8
|-
| 50-00060-009 || Dect Swivel Clip IP62 / IP63 / IP64 || 0,20 || 0,22 || 105 X 80 X 10 || 55 X 50 X 10
|-
| 50-00060-010 || DECT Safety Belt IP61/IP62/IP63/IP64/IP65 || 0,006 || 0,008 || 97 X 60 X 20 || 70 X 45 X 20
|-
| 50-00060-011 || Dect Standard Clip IP61/IP64 || 0,008 || 0,01 || 60 X 25 X 25 || 55 X 23 X 25
|-
| 50-00060-012 || DECT Standard Clip IP62 / IP63 || 0,006 || 0,01 || 150 X 95 X 10 || 58 X 25 X 10
|-
| 50-00060-016 || DECT Headsetcable jack IP61 / IP62 / IP63 || 0,01 || 0,02 || 245 X 130 X 10 || 300 X 20 X 10
|-
| 50-00060-017 || Dect PSU IP1202 / IP1202/4 / IP1202e EU || 0,226 || 0,258 || 130 x 90 x 65 || 96 x 83 x 29
|-
| 50-00060-018 || DECT PSU IP1202 / IP1202/4 / IP1202e UK || 0,230 || 0,266 || 130 x 90 x 62 || 70 x 25 x 45
|-
| 50-00060-021 || Desktop programmer IP62/IP64/IP65 || 0,12 || 0,17 || 140 X 115 X 70 || 140 X 80 X 40
|-
| 50-00060-023 || Dect Battery Multicharger IP65 || 1,5 || 1,72 || 495x165x125 || 455x150x10
|-
| 50-00060-024 || Dect Standard Clip IP65 || 0,006 || 0,01 || 150 X 95 X 10 || 58 X 25 X 10
|-
| 50-00060-025 || Dect Swivel Clip IP65 || 0,02 || 0,02 || 120x80x10 || 50x55x10
|-
| 50-00060-026 || Dect Leathercase IP64 || 0,05 || 0,06 || 240x90x10 || 150x65x15
|-
| 50-00060-027 || Dect Leathercase IP65 || 0,05 || 0,06 || 240x90x10 || 145x65x15
|-
| 50-00060-028 || Dect Battery IP65 || 0,28 || 0,32 || 75 X 70 X 10 || 70 X 45 X 8
|-
| 50-00060-029 || DECT Headsetcable jack IP64 / IP65 || 0,02 || 0,04 || 185x40x30 || 1000x10x5
|-
| 50-00060-030 || Dect Headset mono IP61 / IP62 / IP63 / IP64 / IP65 || 0,04 || 0,18 || 190x145x70 || 1000x45x25
|-
| 50-00060-032 || Dect Adapter for Headset mono IP64 / IP65 || 0,02 || 0,02 || 245x130 || 330x10x5
|-
| 50-00062-001 || IP62 WLAN phone || 0,14 || 0,19 || 145 X 80 X 40 || 133 X 45 X 35
|-
| 50-00064-004 || IP64 || 0,12 || 0,16 || 7,6 x 15,0 x 4,0 || 5,5 x 13,8 x 3,2
|-
| 50-00065-001 || IP65 || 0,12 || 0,17 || 7,6 x 15,0 x 4 || 5,2 x 13,8 x 3,2
|-
| 50-00081-001 || D81 DECT phone || 0,176 || 0,278 || 160 X 70 X 45 || 140 X 55 X 30
|-
| 50-00081-002 || D81 ex. DECT phone || 0,18 || 0,28 || 73 x 163 x 47 || 54 x 140 x 35
|-
| 50-00081-003 || DECT Charger and PSU D81/D81 ex. EU || 0,18 || 0,35 || 145 X 117 X 74 || 90 X 105 X 55
|-
| 50-00081-004 || DECT Charger and PSU D81/I62/D81 ex. UK || 0,31 || 0,40 || 180 X 115 X 70 || 90 X 90 X 60
|-
| 50-00081-005 || battery D81 || 0,03 || 0,03 || 120 X 72 X 11 || 72 X 43 X 9
|-
| 50-00081-006 || battery D81 ex || 0,02 || 0,06 || 65 x 158 x 45 || 40 x 70 x 12
|-
| 50-00081-007 || Battery pack opener D81 ex. || 0,004 || 0,008 || 140 X 100 X 6 || 70 X 40 X 6
|-
| 50-00081-009 || D81 belt Clip || 0,02 || 0,02 || 90 x 148 x 30 || 42 x 78 x 32
|-
| 50-00081-010 || D81 Leathercase || 0,08 || 0,088 || 245 X 165 X 60 || 145 X 55 X 60
|-
| 50-01202-001 || IP1202 || 0,40 || 0,51 || 187 X 175 X 78 || 170 X 165 X 40
|-
| 50-01202-002 || IP1202 (4 Channel) || 0,38 || 0,49 || 185 x 173 x 67 || 162 x 162 x 30
|-
| 50-01202-003 || IP1202e || 0,43 || 0,62 || 187 X 175 X 78 || 170 X 165 X 40
|-
| 50-01202-004 || IP1202e Double directional antenna || 0,15 || 0,32 || 270 X 125 X 45 || 100 X 95 X 35
|-
| 50-01202-005 || IP1202e Single directional antenna || 0,70 || 1,02 || 320 X 145 X 132 || 265 X 140 X 35
|-
| 50-01202-006 || IP1202e Omnidirectional antenna || 0,472 || 0,314 || 440 X 92 X 115 || 1530 X 30 X 40
|-
| 50-01202-007 || IP1202 / IP1202/4 / IP1202e Additional housing transparent || 1,51 || 1,51 || 360 x 254 x 114 || 360 x 254 x 114
|-
| 50-01202-008 || IP1202 / IP1202e Additional housing with trace heating || 6,80 || 7,00 || 410 X 225 X 430 || 390 X 205 X 410
|}

= storage parameters =
Please observe storage parameters:

storage temperature 10°C to +70°C

humidity 10% to 90% noncondensing.

This information is dated January 2019 and is subject to change without notice.

= Number of units in a pallet =

{| {{table}}
{| border=1
|+
! Item Number !! Description !!Articles in pallet !! Gross weight in kg !! Dimensions with packaging in mm
|-
|88-00010-030
|Pallet IP240
|80
|134
|EURO pallet 120 x 80 x 120
|-
|88-00010-035
|Pallet IP241
|80
|134
|EURO pallet 120 x 80 x 120
|-
|88-00010-037
|Pallet IP222 (Weiß)
|172
|230
|EURO pallet 120 x 80 x 120
|-
|88-00010-038
|Pallet IP222 (Schwarz)
|172
|230
|EURO pallet 120 x 80 x 120
|-
|88-00010-039
|Pallet IP232 (Weiß)
|172
|230
|EURO pallet 120 x 80 x 120
|-
|88-00010-040
|Pallet IP232 (Schwarz)
|172
|230
|EURO pallet 120 x 80 x 120
|-
|88-00010-069
|Pallet IP111
|120 (midyear of 2020, 165)
|150
|single-use 120 x 80 x 120
|-
|88-00010-072
|Pallet IP112
|165
|150
|single-use 120 x 80 x 120
|-
|88-00010-087
|Pallet IP101
|150
|135
|EURO pallet 120 x 80 x 110
|-
|88-00010-088
|Pallet IP102
|150
|135
|EURO pallet 120 x 80 x 110
|-

|}

Howto:Dimension and weight for packing

2019-02-22T07:23:43Z

Kti: /* storage parameters */

==More information==
This information applies to innovaphone products including package.


= Dimensions an weight of packaged goods =
For delivery and in tender some times the dimension and weight for the packed single products are requested.

The following table shows weight in kg and dimensions of packaging in mm of some products:

{| {{table}}
{| border="1"
! Item Number !! Description !! Net weight in kg !! Gross weight in kg !! Dimensions with packaging in mm !! Dimensions without packaging in mm
|-
| 01-00011-001 || IP0011 || 0,80 || 1,06 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00029-001 || IP29 || 0,91 || 1,16 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00029-003 || IP29-2 || 0,91 || 1,16 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00029-004 || IP29-4 || 0,91 || 1,16 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00029-005 || IP29-8 || 0,91 || 1,16 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00038-001 || IP38 || 0,69 || 0,94 || 230 X 225 X 80 || 210 X 133 X 37
|-
| 01-00110-002 || IP110A || 0,39 || 0,73 || 225 X 205 X 70 || 190 X 160 X 50
|-
| 01-00111-001 || IP111 || 0,50 || 1,07 || 260 X 230 X 95 || 213 X 160 X 37
|-
| 01-00112-001 || IP112 || 0,50 || 1,07 || 260 X 230 X 95 || 213 X 160 X 37
|-
| 01-00150-001 || IP150 IP Phone|| 1,90 || 2,93 || 385 X 255 X 200 || 270 X 190 X 95
|-
| 01-00150-010 || Ferntel IP HH with Headphones || 3,26 || 6,00 || 400 x 305 x 335 || 195 x 295 x 95
|-
| 01-00200-002 || IPPhone200 || 0,63 || 1,16 || 320 X 224 X 100 || 220 X 220 X 85
|-
| 01-00222-001 || IP222 (Black) || 0,50 || 1,20 || 275 X 195 X 90 || 217 X 155 X 31
|-
| 01-00222-002 || IP222 (White) || 0,46 || 1,18 || 275 X 195 X 90 || 217 X 155 X 31
|-
| 01-00230-001 || IP230-X || 0,23 || 0,40 || 240 X 160 X 70 || 190 X 100 X 50
|-
| 01-00232-001 || IP232 (Black) || 0,50 || 1,20 || 275 X 195 X 90 || 220 X 150 X 30
|-
| 01-00232-002 || IP232 (White) || 0,52 || 1,21 || 275 X 195 X 90 || 220 X 150 X 30
|-
| 01-00240-003 || IP240 || 0,81 || 1,39 || 355 X 240 X 110 || 270 X 190 X 98
|-
| 01-00241-001 || IP241 || 0,80 || 1,36 || 335 X 240 X 110 || 268 X 190 X 100
|-
| 01-002X2-001 || IP2X2-X (Black) || 0,38 || 0,66 || 275 x 195 x 90 || 152 x 89 x 32
|-
| 01-002X2-002 || IP2X2-X (White) || 0,38 || 0,66 || 275 x 195 x 90 || 152 x 89 x 32
|-
| 01-00302-001 || IP302 || 0,69 || 1,03 || 230 X 225 X 85 || 210 X 135 X 33
|-
| 01-00305-001 || IP305 || 0,69 || 1,02 || 230 X 225 X 85 || 210 X 135 X 33
|-
| 01-00311-001 || IP311 || 0,83 || 1,08 || 235x228x85 || 210x149x34
|-
| 01-00411-001 || IP411 || 0,83 || 1,09 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00800-016 || IP800 || 1,30 || 1,80 || 230 X 225 X 85 || 210 X 185 X 33
|-
| 01-00811-001 || IP811 || 0,83 || 1,09 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00999-001 || IP800-RACK || 1,18 || 1,38 || 510 x 195 x 60 || 483 x 186 x 49
|-
| 01-01130-001 || IP1130 || 1,03 || 1,28 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-03011-001 || IP3011 || 1,64 || 1,87 || 235 x 228 x 85 || 210 x 210 x 34
|-
| 01-06010-002 || IP6010 || 1,64 || 1,87 || 230 X 225 X 85 || 210 X 213 X 33
|-
| 03-00010-002 || 12 V PSU with int. Adapter for IP phones || 0,08 || 0,14 || 110 X 94 X 70 || 77 X 35 X 50
|-
| 03-00010-004 || 12 V PSU for IP phones || 0,08 || 0,14 || 105 X 96 X 39 || 73 X 75 X 27
|-
| 03-00010-009 || mSata 32GB || 0,06 || 0,08 || 60 x 60 x 1 || 51 x 30 x 1
|-
| 03-00010-010 || mSata 128GB || 0,06 || 0,08 || 60 x 60 x 1 || 51 x 30 x 1
|-
| 03-00010-011 || mSata 256GB || 0,06 || 0,08 || 60 x 60 x 1 || 51 x 30 x 1
|-
| 03-00010-231 || PoE Adapter Gigabit || 0,34 || 0,42 || 116 X 21 X 56 || 50 X 138 X 35
|-
| 50-00060-001 || DECT Charger and PSU IP61/IP62/IP63/IP64/IP65 EU || 0,23 || 0,32 || 140 X 115 X 70 || 95 X 90 X 60
|-
| 50-00060-002 || DECT Charger and PSU IP61/IP62/IP63/IP64/IP65 UK/US/AUS || 0,31 || 0,39 || 173x115x65 || 90x70x100
|-
| 50-00060-005 || DECT Battery IP61/IP64 || 0,17 || 0,18 || 60 X 55 X 10 || 47 X 35 X 7
|-
| 50-00060-006 || DECT Multicharger IP61/IP62/IP63/IP64/IP65 || 1,66 || 1,88 || 165 x 498 x 130 || 158 x 456 x 103
|-
| 50-00060-007 || DECT Battery Multicharger IP62/IP63 || 1,48 || 1,7 || 165 x 498 x 130 || 158 x 456 x 103
|-
| 50-00060-008 || DECT Battery IP62 / IP63 || 0,28 || 0,32 || 75 X 70 X 10 || 70 X 45 X 8
|-
| 50-00060-009 || Dect Swivel Clip IP62 / IP63 / IP64 || 0,20 || 0,22 || 105 X 80 X 10 || 55 X 50 X 10
|-
| 50-00060-010 || DECT Safety Belt IP61/IP62/IP63/IP64/IP65 || 0,006 || 0,008 || 97 X 60 X 20 || 70 X 45 X 20
|-
| 50-00060-011 || Dect Standard Clip IP61/IP64 || 0,008 || 0,01 || 60 X 25 X 25 || 55 X 23 X 25
|-
| 50-00060-012 || DECT Standard Clip IP62 / IP63 || 0,006 || 0,01 || 150 X 95 X 10 || 58 X 25 X 10
|-
| 50-00060-016 || DECT Headsetcable jack IP61 / IP62 / IP63 || 0,01 || 0,02 || 245 X 130 X 10 || 300 X 20 X 10
|-
| 50-00060-017 || Dect PSU IP1202 / IP1202/4 / IP1202e EU || 0,226 || 0,258 || 130 x 90 x 65 || 96 x 83 x 29
|-
| 50-00060-018 || DECT PSU IP1202 / IP1202/4 / IP1202e UK || 0,230 || 0,266 || 130 x 90 x 62 || 70 x 25 x 45
|-
| 50-00060-021 || Desktop programmer IP62/IP64/IP65 || 0,12 || 0,17 || 140 X 115 X 70 || 140 X 80 X 40
|-
| 50-00060-023 || Dect Battery Multicharger IP65 || 1,5 || 1,72 || 495x165x125 || 455x150x10
|-
| 50-00060-024 || Dect Standard Clip IP65 || 0,006 || 0,01 || 150 X 95 X 10 || 58 X 25 X 10
|-
| 50-00060-025 || Dect Swivel Clip IP65 || 0,02 || 0,02 || 120x80x10 || 50x55x10
|-
| 50-00060-026 || Dect Leathercase IP64 || 0,05 || 0,06 || 240x90x10 || 150x65x15
|-
| 50-00060-027 || Dect Leathercase IP65 || 0,05 || 0,06 || 240x90x10 || 145x65x15
|-
| 50-00060-028 || Dect Battery IP65 || 0,28 || 0,32 || 75 X 70 X 10 || 70 X 45 X 8
|-
| 50-00060-029 || DECT Headsetcable jack IP64 / IP65 || 0,02 || 0,04 || 185x40x30 || 1000x10x5
|-
| 50-00060-030 || Dect Headset mono IP61 / IP62 / IP63 / IP64 / IP65 || 0,04 || 0,18 || 190x145x70 || 1000x45x25
|-
| 50-00060-032 || Dect Adapter for Headset mono IP64 / IP65 || 0,02 || 0,02 || 245x130 || 330x10x5
|-
| 50-00062-001 || IP62 WLAN phone || 0,14 || 0,19 || 145 X 80 X 40 || 133 X 45 X 35
|-
| 50-00064-004 || IP64 || 0,12 || 0,16 || 7,6 x 15,0 x 4,0 || 5,5 x 13,8 x 3,2
|-
| 50-00065-001 || IP65 || 0,12 || 0,17 || 7,6 x 15,0 x 4 || 5,2 x 13,8 x 3,2
|-
| 50-00081-001 || D81 DECT phone || 0,176 || 0,278 || 160 X 70 X 45 || 140 X 55 X 30
|-
| 50-00081-002 || D81 ex. DECT phone || 0,18 || 0,28 || 73 x 163 x 47 || 54 x 140 x 35
|-
| 50-00081-003 || DECT Charger and PSU D81/D81 ex. EU || 0,18 || 0,35 || 145 X 117 X 74 || 90 X 105 X 55
|-
| 50-00081-004 || DECT Charger and PSU D81/I62/D81 ex. UK || 0,31 || 0,40 || 180 X 115 X 70 || 90 X 90 X 60
|-
| 50-00081-005 || battery D81 || 0,03 || 0,03 || 120 X 72 X 11 || 72 X 43 X 9
|-
| 50-00081-006 || battery D81 ex || 0,02 || 0,06 || 65 x 158 x 45 || 40 x 70 x 12
|-
| 50-00081-007 || Battery pack opener D81 ex. || 0,004 || 0,008 || 140 X 100 X 6 || 70 X 40 X 6
|-
| 50-00081-009 || D81 belt Clip || 0,02 || 0,02 || 90 x 148 x 30 || 42 x 78 x 32
|-
| 50-00081-010 || D81 Leathercase || 0,08 || 0,088 || 245 X 165 X 60 || 145 X 55 X 60
|-
| 50-01202-001 || IP1202 || 0,40 || 0,51 || 187 X 175 X 78 || 170 X 165 X 40
|-
| 50-01202-002 || IP1202 (4 Channel) || 0,38 || 0,49 || 185 x 173 x 67 || 162 x 162 x 30
|-
| 50-01202-003 || IP1202e || 0,43 || 0,62 || 187 X 175 X 78 || 170 X 165 X 40
|-
| 50-01202-004 || IP1202e Double directional antenna || 0,15 || 0,32 || 270 X 125 X 45 || 100 X 95 X 35
|-
| 50-01202-005 || IP1202e Single directional antenna || 0,70 || 1,02 || 320 X 145 X 132 || 265 X 140 X 35
|-
| 50-01202-006 || IP1202e Omnidirectional antenna || 0,472 || 0,314 || 440 X 92 X 115 || 1530 X 30 X 40
|-
| 50-01202-007 || IP1202 / IP1202/4 / IP1202e Additional housing transparent || 1,51 || 1,51 || 360 x 254 x 114 || 360 x 254 x 114
|-
| 50-01202-008 || IP1202 / IP1202e Additional housing with trace heating || 6,80 || 7,00 || 410 X 225 X 430 || 390 X 205 X 410
|}

= storage parameters =
Please observe storage parameters:

storage temperature 10°C to +70°C

humidity 10% to 90% noncondensing.

This information is dated January 2019 and is subject to change without notice.

= Number of units in a pallet =

{| border=1
|+
|article number
|article description
|units / pallet
|-
|88-00010-027
|Pallet IP110
|220
|-
|88-00010-028
|Pallet IPPhone 200
|114
|-
|88-00010-029
|Pallet IP230
|114
|-
|88-00010-030
|Pallet IP240
|80
|-
|88-00010-031
|Pallet IP230-X
|60
|-
|88-00010-032
|Pallet IP240-1000
|80
|-
|88-00010-035
|Pallet IP241
|80
|-
|88-00010-037
|Pallet IP222 (Weiß)
|172
|-
|88-00010-038
|Pallet IP222 (Schwarz)
|172
|-
|88-00010-039
|Pallet IP232 (Weiß)
|172
|-
|88-00010-040
|Pallet IP232 (Schwarz)
|172
|-
|88-00010-069
|Pallet IP111
|120
|-
|88-00010-072
|Pallet IP112
|120
|-
|88-00010-087
|Pallet IP101
|150
|-
|88-00010-088
|Pallet IP102
|150
|-

|}

Howto:Dimension and weight for packing

2019-02-22T07:20:57Z

Kti: /* Number of units in a palett */

==More information==
This information applies to innovaphone products including package.


= Dimensions an weight of packaged goods =
For delivery and in tender some times the dimension and weight for the packed single products are requested.

The following table shows weight in kg and dimensions of packaging in mm of some products:

{| {{table}}
{| border="1"
! Item Number !! Description !! Net weight in kg !! Gross weight in kg !! Dimensions with packaging in mm !! Dimensions without packaging in mm
|-
| 01-00011-001 || IP0011 || 0,80 || 1,06 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00029-001 || IP29 || 0,91 || 1,16 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00029-003 || IP29-2 || 0,91 || 1,16 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00029-004 || IP29-4 || 0,91 || 1,16 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00029-005 || IP29-8 || 0,91 || 1,16 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00038-001 || IP38 || 0,69 || 0,94 || 230 X 225 X 80 || 210 X 133 X 37
|-
| 01-00110-002 || IP110A || 0,39 || 0,73 || 225 X 205 X 70 || 190 X 160 X 50
|-
| 01-00111-001 || IP111 || 0,50 || 1,07 || 260 X 230 X 95 || 213 X 160 X 37
|-
| 01-00112-001 || IP112 || 0,50 || 1,07 || 260 X 230 X 95 || 213 X 160 X 37
|-
| 01-00150-001 || IP150 IP Phone|| 1,90 || 2,93 || 385 X 255 X 200 || 270 X 190 X 95
|-
| 01-00150-010 || Ferntel IP HH with Headphones || 3,26 || 6,00 || 400 x 305 x 335 || 195 x 295 x 95
|-
| 01-00200-002 || IPPhone200 || 0,63 || 1,16 || 320 X 224 X 100 || 220 X 220 X 85
|-
| 01-00222-001 || IP222 (Black) || 0,50 || 1,20 || 275 X 195 X 90 || 217 X 155 X 31
|-
| 01-00222-002 || IP222 (White) || 0,46 || 1,18 || 275 X 195 X 90 || 217 X 155 X 31
|-
| 01-00230-001 || IP230-X || 0,23 || 0,40 || 240 X 160 X 70 || 190 X 100 X 50
|-
| 01-00232-001 || IP232 (Black) || 0,50 || 1,20 || 275 X 195 X 90 || 220 X 150 X 30
|-
| 01-00232-002 || IP232 (White) || 0,52 || 1,21 || 275 X 195 X 90 || 220 X 150 X 30
|-
| 01-00240-003 || IP240 || 0,81 || 1,39 || 355 X 240 X 110 || 270 X 190 X 98
|-
| 01-00241-001 || IP241 || 0,80 || 1,36 || 335 X 240 X 110 || 268 X 190 X 100
|-
| 01-002X2-001 || IP2X2-X (Black) || 0,38 || 0,66 || 275 x 195 x 90 || 152 x 89 x 32
|-
| 01-002X2-002 || IP2X2-X (White) || 0,38 || 0,66 || 275 x 195 x 90 || 152 x 89 x 32
|-
| 01-00302-001 || IP302 || 0,69 || 1,03 || 230 X 225 X 85 || 210 X 135 X 33
|-
| 01-00305-001 || IP305 || 0,69 || 1,02 || 230 X 225 X 85 || 210 X 135 X 33
|-
| 01-00311-001 || IP311 || 0,83 || 1,08 || 235x228x85 || 210x149x34
|-
| 01-00411-001 || IP411 || 0,83 || 1,09 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00800-016 || IP800 || 1,30 || 1,80 || 230 X 225 X 85 || 210 X 185 X 33
|-
| 01-00811-001 || IP811 || 0,83 || 1,09 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-00999-001 || IP800-RACK || 1,18 || 1,38 || 510 x 195 x 60 || 483 x 186 x 49
|-
| 01-01130-001 || IP1130 || 1,03 || 1,28 || 235 x 228 x 85 || 210 x 149 x 34
|-
| 01-03011-001 || IP3011 || 1,64 || 1,87 || 235 x 228 x 85 || 210 x 210 x 34
|-
| 01-06010-002 || IP6010 || 1,64 || 1,87 || 230 X 225 X 85 || 210 X 213 X 33
|-
| 03-00010-002 || 12 V PSU with int. Adapter for IP phones || 0,08 || 0,14 || 110 X 94 X 70 || 77 X 35 X 50
|-
| 03-00010-004 || 12 V PSU for IP phones || 0,08 || 0,14 || 105 X 96 X 39 || 73 X 75 X 27
|-
| 03-00010-009 || mSata 32GB || 0,06 || 0,08 || 60 x 60 x 1 || 51 x 30 x 1
|-
| 03-00010-010 || mSata 128GB || 0,06 || 0,08 || 60 x 60 x 1 || 51 x 30 x 1
|-
| 03-00010-011 || mSata 256GB || 0,06 || 0,08 || 60 x 60 x 1 || 51 x 30 x 1
|-
| 03-00010-231 || PoE Adapter Gigabit || 0,34 || 0,42 || 116 X 21 X 56 || 50 X 138 X 35
|-
| 50-00060-001 || DECT Charger and PSU IP61/IP62/IP63/IP64/IP65 EU || 0,23 || 0,32 || 140 X 115 X 70 || 95 X 90 X 60
|-
| 50-00060-002 || DECT Charger and PSU IP61/IP62/IP63/IP64/IP65 UK/US/AUS || 0,31 || 0,39 || 173x115x65 || 90x70x100
|-
| 50-00060-005 || DECT Battery IP61/IP64 || 0,17 || 0,18 || 60 X 55 X 10 || 47 X 35 X 7
|-
| 50-00060-006 || DECT Multicharger IP61/IP62/IP63/IP64/IP65 || 1,66 || 1,88 || 165 x 498 x 130 || 158 x 456 x 103
|-
| 50-00060-007 || DECT Battery Multicharger IP62/IP63 || 1,48 || 1,7 || 165 x 498 x 130 || 158 x 456 x 103
|-
| 50-00060-008 || DECT Battery IP62 / IP63 || 0,28 || 0,32 || 75 X 70 X 10 || 70 X 45 X 8
|-
| 50-00060-009 || Dect Swivel Clip IP62 / IP63 / IP64 || 0,20 || 0,22 || 105 X 80 X 10 || 55 X 50 X 10
|-
| 50-00060-010 || DECT Safety Belt IP61/IP62/IP63/IP64/IP65 || 0,006 || 0,008 || 97 X 60 X 20 || 70 X 45 X 20
|-
| 50-00060-011 || Dect Standard Clip IP61/IP64 || 0,008 || 0,01 || 60 X 25 X 25 || 55 X 23 X 25
|-
| 50-00060-012 || DECT Standard Clip IP62 / IP63 || 0,006 || 0,01 || 150 X 95 X 10 || 58 X 25 X 10
|-
| 50-00060-016 || DECT Headsetcable jack IP61 / IP62 / IP63 || 0,01 || 0,02 || 245 X 130 X 10 || 300 X 20 X 10
|-
| 50-00060-017 || Dect PSU IP1202 / IP1202/4 / IP1202e EU || 0,226 || 0,258 || 130 x 90 x 65 || 96 x 83 x 29
|-
| 50-00060-018 || DECT PSU IP1202 / IP1202/4 / IP1202e UK || 0,230 || 0,266 || 130 x 90 x 62 || 70 x 25 x 45
|-
| 50-00060-021 || Desktop programmer IP62/IP64/IP65 || 0,12 || 0,17 || 140 X 115 X 70 || 140 X 80 X 40
|-
| 50-00060-023 || Dect Battery Multicharger IP65 || 1,5 || 1,72 || 495x165x125 || 455x150x10
|-
| 50-00060-024 || Dect Standard Clip IP65 || 0,006 || 0,01 || 150 X 95 X 10 || 58 X 25 X 10
|-
| 50-00060-025 || Dect Swivel Clip IP65 || 0,02 || 0,02 || 120x80x10 || 50x55x10
|-
| 50-00060-026 || Dect Leathercase IP64 || 0,05 || 0,06 || 240x90x10 || 150x65x15
|-
| 50-00060-027 || Dect Leathercase IP65 || 0,05 || 0,06 || 240x90x10 || 145x65x15
|-
| 50-00060-028 || Dect Battery IP65 || 0,28 || 0,32 || 75 X 70 X 10 || 70 X 45 X 8
|-
| 50-00060-029 || DECT Headsetcable jack IP64 / IP65 || 0,02 || 0,04 || 185x40x30 || 1000x10x5
|-
| 50-00060-030 || Dect Headset mono IP61 / IP62 / IP63 / IP64 / IP65 || 0,04 || 0,18 || 190x145x70 || 1000x45x25
|-
| 50-00060-032 || Dect Adapter for Headset mono IP64 / IP65 || 0,02 || 0,02 || 245x130 || 330x10x5
|-
| 50-00062-001 || IP62 WLAN phone || 0,14 || 0,19 || 145 X 80 X 40 || 133 X 45 X 35
|-
| 50-00064-004 || IP64 || 0,12 || 0,16 || 7,6 x 15,0 x 4,0 || 5,5 x 13,8 x 3,2
|-
| 50-00065-001 || IP65 || 0,12 || 0,17 || 7,6 x 15,0 x 4 || 5,2 x 13,8 x 3,2
|-
| 50-00081-001 || D81 DECT phone || 0,176 || 0,278 || 160 X 70 X 45 || 140 X 55 X 30
|-
| 50-00081-002 || D81 ex. DECT phone || 0,18 || 0,28 || 73 x 163 x 47 || 54 x 140 x 35
|-
| 50-00081-003 || DECT Charger and PSU D81/D81 ex. EU || 0,18 || 0,35 || 145 X 117 X 74 || 90 X 105 X 55
|-
| 50-00081-004 || DECT Charger and PSU D81/I62/D81 ex. UK || 0,31 || 0,40 || 180 X 115 X 70 || 90 X 90 X 60
|-
| 50-00081-005 || battery D81 || 0,03 || 0,03 || 120 X 72 X 11 || 72 X 43 X 9
|-
| 50-00081-006 || battery D81 ex || 0,02 || 0,06 || 65 x 158 x 45 || 40 x 70 x 12
|-
| 50-00081-007 || Battery pack opener D81 ex. || 0,004 || 0,008 || 140 X 100 X 6 || 70 X 40 X 6
|-
| 50-00081-009 || D81 belt Clip || 0,02 || 0,02 || 90 x 148 x 30 || 42 x 78 x 32
|-
| 50-00081-010 || D81 Leathercase || 0,08 || 0,088 || 245 X 165 X 60 || 145 X 55 X 60
|-
| 50-01202-001 || IP1202 || 0,40 || 0,51 || 187 X 175 X 78 || 170 X 165 X 40
|-
| 50-01202-002 || IP1202 (4 Channel) || 0,38 || 0,49 || 185 x 173 x 67 || 162 x 162 x 30
|-
| 50-01202-003 || IP1202e || 0,43 || 0,62 || 187 X 175 X 78 || 170 X 165 X 40
|-
| 50-01202-004 || IP1202e Double directional antenna || 0,15 || 0,32 || 270 X 125 X 45 || 100 X 95 X 35
|-
| 50-01202-005 || IP1202e Single directional antenna || 0,70 || 1,02 || 320 X 145 X 132 || 265 X 140 X 35
|-
| 50-01202-006 || IP1202e Omnidirectional antenna || 0,472 || 0,314 || 440 X 92 X 115 || 1530 X 30 X 40
|-
| 50-01202-007 || IP1202 / IP1202/4 / IP1202e Additional housing transparent || 1,51 || 1,51 || 360 x 254 x 114 || 360 x 254 x 114
|-
| 50-01202-008 || IP1202 / IP1202e Additional housing with trace heating || 6,80 || 7,00 || 410 X 225 X 430 || 390 X 205 X 410
|}

= storage parameters =
Please observe storage parameters:

temperature 10°C to +70°C

humidity 10% to 90% noncondensing.

This information is dated April 2009 and is subject to change without notice.

= Number of units in a pallet =

{| border=1
|+
|article number
|article description
|units / pallet
|-
|88-00010-027
|Pallet IP110
|220
|-
|88-00010-028
|Pallet IPPhone 200
|114
|-
|88-00010-029
|Pallet IP230
|114
|-
|88-00010-030
|Pallet IP240
|80
|-
|88-00010-031
|Pallet IP230-X
|60
|-
|88-00010-032
|Pallet IP240-1000
|80
|-
|88-00010-035
|Pallet IP241
|80
|-
|88-00010-037
|Pallet IP222 (Weiß)
|172
|-
|88-00010-038
|Pallet IP222 (Schwarz)
|172
|-
|88-00010-039
|Pallet IP232 (Weiß)
|172
|-
|88-00010-040
|Pallet IP232 (Schwarz)
|172
|-
|88-00010-069
|Pallet IP111
|120
|-
|88-00010-072
|Pallet IP112
|120
|-
|88-00010-087
|Pallet IP101
|150
|-
|88-00010-088
|Pallet IP102
|150
|-

|}

Reference:My Innovaphone

2018-05-29T08:56:46Z

Kti: /* Company */

==About==
My innovaphone replaces the former license manager.
It will also include the handling of device warranty and software service agreements (only partially implemented yet).

===Project-View===
My innovaphone offers the possibility for several users to be in one company. This company shares its balance of licenses over all users and can have several projects. Projects have their own balance of license types and devices are bound to a project.

===Language===
My innovaphone will support multiple languages. You can select your desired language at the top of the page. 
Currently supported languages:
* English
* German
* Italian
* Dutch
* French

===Guides===

====Quickstart guide====
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_nl.pdf Dutch quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_en.pdf English quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_fr.pdf French quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_de.pdf German quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_it.pdf Italian quickstart guide] 

====SSA guide====
;V10 and greater:
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10nl.pdf Dutch SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10en.pdf English SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10fr.pdf French SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10de.pdf German SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10it.pdf Italian SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10pl.pdf Polish SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10es.pdf Spanish SSA guide] 

;V8 and greater:
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_en.pdf English SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_fr.pdf French SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_de.pdf German SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_it.pdf Italian SSA guide] 

==First steps==
Open [https://my.innovaphone.com my.innovaphone.com] and click the "Register Now" link.
Enter your personal data and register.

You will receive a registration email with an activation link.
After account activation you have two options:
* create a new my innovaphone company (under Licenses->Company)
* ask another user of your company to add your user account to an already existing company

If you accidentally created an own my innovaphone company, just ask another user of your company to import your just created company.

If you create a new company, you can '''optionally''' enter your innovaphone account ID (which is your customer number with innovaphone) with your postal code, to retrieve your company data.

You will see a help link at the right side of the horizontal tab menu.
This link shows the corresponding text of the wiki section, when hovering with the mouse over it,
and redirects to the corresponding wiki menu, if clicked.

It is now possible, that one user is member of serveral companies!

==Search==
At the right top of the page you have a search field. You can search for different things:
* Devices (part of a device name or device comment)
* Projects (part of a project name or project description)
* Own activation keys (part of an activation key or its description)

You have to enter at least '''three''' chars to start a search. To search for activation keys,
you have to enter at least '''five''' chars.
* Search for license types. Enter e.g. "PBX-Port8" to find all devices with Port8 licenses or enter "PBX-Port8=100" to find all devices with Port8 licenses '''>=''' 100.
* Search for products, e.g. 01-00811 für IP811 (such a search may take longer!)

==Licenses==
===Projects===
After creation of an own company, you will have a default project named "DEFAULT". You can rename this project later.
You can also create more projects on the projects page with "Create".
Each project of a company must have a unique name.

Do '''not''' set SSA, if you want to import your devices from your old license manager account first.
If you want SSA and you '''won't import''' devices into this project from your old account, you should set SSA at once.

You can select a certain project by activating it in the project list. This selection is then true for all other pages, as some pages require a selected project.

[[Image:overview.jpg|center|thumb|200px|Projects page]]

By activating a project by clicking on the project name in the project list, you can manage this project and its settings.

====Properties====
Rename the project or/and change its description. 
 
You can configure further CC mail addresses inside your '''License Purchase''' project, if you have one. If you purchase licenses on credit, the emails will be also sent to theses addresses.
 
 
Since version 10, an innovaphone device will automatically connect to http://config.innovaphone.com/init
This script looks at the project properties of the project, where the device exists. 
You can configure an update '''URL''' and a '''trusted certificate'''.

====Software Service====
You can put your project under SSA (software service agreement).
You will be asked to enter a SSA end date. This will be the date, where all SSA licenses of all devices in this project will expire.
The end date mustn't be more than one year in the past. 
Optionally you can enter a maximum SSC amount. The SSA end date will be automatically calculated then. 
If you have entered a maximum SSC amount, you have to use the '''Recalculate''' link to calculate a new SSA end date,
if you change your license selection.
 
You can also calculate SSA over all projects at once. In this mode, you '''won't be able''' to confirm the calculation. You'll just see the necessary SSC amount.

After entering a date/SSC amount, you will get a summary of all licenses, which will be put under SSA and the amount of needed SSC licenses.
The SSC value for each license is calculated by the bind date of the license and the entered SSA end date/SSC amount.

[[Image:Ssa_extend.jpg|center|thumb|200px|SSA summary]]

If you have licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the current license version. 

e.g. you have a V7 PBX-PBX7#15 license with bind date 1/1/2010. Version 8 was released on 7/12/2009, so SSA is
calculated from 7/12/2009 for this license. You will see the calculation date in the list under "bind date"

If licenses already have a SSA date, just the difference between the current SSA date and the entered SSA end date must be paid.
If the bind date of the device lies in the past, the difference between the bind date and the current date must be paided twice (this is the column 'days*2'). 
If your license is under SSA, which is already over, you also have to pay the time between the old SSA date and the current SSA end date twice.

Here is a short example, how the days are calculated:

Bind date: 24/06/2009 
Current date: 31/08/2009 
SSA end date: 12/12/2011 
 
You will have to pay from 24/06/2009 to 31/08/2009 twice for 68 days.
From 31/08/2009 to 12/12/2011 you will then have to pay the normal price for 833 days.

You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

You can preview the SSC calculation for another calculation date. Simply change the dropdown
selection to get the new SSC value.
Of course you can't confirm this calculation for another date, just for the current date!

''You may add additional licenses to the calculation, which you will bind later''. Just click on the '''+''' near this text and you can add
multiple licenses, which will be added to your calculation after using the recalc link. Listed are licenses of the current version and from
your balance.

After confirming your entered SSA end date, each license will have this date as SSA end date and can be downloaded in all versions of this SSA time.

You can now extend the projects SSA end date like as setting a new one.
The resulting summary is the same as above.

If your user account has the right to buy licenses on credit, just check the checkbox.
You may enter an order number, which you can use for your order, if you buy on credit.

=====Past SSA end date=====

You can configure a new SSA end date in the past, if you accidentally configured a wrong date. 
No licenses will be changed, if you configure a date in the past, just the SSA end date of the project!

=====SSA Expiry Mail=====

If project SSA will expire, each company user will receive a reminder mail '''7''' weeks before and
then every week one mail.
You can disable these mails with the checkbox 'Send SSA expiry mails'.
Note that every user can configure, if he wants to receive mails or not in his account settings.

If you want the end user of the project to receive an expiry mail, you can configure a '''reseller''' mail address and end user mail addresses. These end users will then receive an email, 30 days before the project will expire. The default text is:

<code type="text">
Your Software Service Agreement for your innovaphone PBX in project "{$arg[3]}" will expire in {$arg[1]} days.
Please contact your reseller {$arg[2]} to upgrade the license. 
The upgrade of the license is important to secure the phone system!
</code>

You can change this text as you want. You can use placeholders:
* '''{$arg[1]}''': days left
* '''{$arg[2]}''': reseller mail address
* '''{$arg[3]}''': project name
 
You can also define a global text for all projects under your [[Reference:My_Innovaphone#Company | Company settings]].

You can optionally configure to receive project SSA independent reminder mails for each license of a device [[Reference:My_Innovaphone#Company_2|here]].

=====Automatic SSA Extension Service=====

You can request an automatic SSA extension service for a project, which is under SSA. By following this link, you will have the opportunity to request a callback and/or the necessary agreement as PDF file.

All licenses have to be under SSA to use the automatic SSA extension service!

There are some basics to know, if a project is under automatic SSA:
* If you bind new/free licenses, they'll get SSA until the current project SSA date and you will receive an invoice for the SSCs
* If you move devices into this project, their licenses will get SSA until the current project SSA date and you will receive an invoice for the SSCs
* You can't join this project into another project, but you can join another project into this one

====Rights====
=====Own project=====
Add or delete company rights for this project. To add a company right, you have to enter the company id of this company.
Each user of a company with rights on this project can add devices, licenses, activation keys to this specific project, but is restricted in removing devices, editing the project and can't create activation keys with the projects balance.

The company id can be found under Licenses->company and the company tab.

[[Image:Project_rights.jpg|center|thumb|200px|Project rights]]

=====External Project=====
If another company granted access rights to a project to you, you can unsubscribe from this project here.

====Import====
The import has been disabled. All old devices are already imported and can be added to your project manually.

====Join====
Here you can join your currently selected project with another project, which you select from a dropdown box. 
If the other project has SSA, you'll see the current SSA end date, which you might change for the join process and you will get a list of all licenses, which might be updated to the ssa end date/changed date of the other project. The list equals the list shown under [[Reference:My_Innovaphone#Software_Service|Software Service]].

The selected project will be automatically deleted after the join. You can't join a project,
if it grants external rights to another customer. Delete these rights before.

You can't change the SSA end date, if the other project is under automatic SSA! You will receive an invoice for SSCs used for the join.

====Project Move (admin only)====
A company admin can move a project with its devices, activation keys, balance etc. to another company. You have to know the company ID from this company, which can be found under Licenses->Company and the company tab. 
The history won't be moved!

Projects with negative balances can't be moved!

Existing project rights will be deleted.

====Delete====
Delete the project. Only possible if it has no activation keys, project rights, devices or user rights.
 
You may [[Reference:My_Innovaphone#Join|join]] your project into another one, if you can't delete it.

====Project Freed_RMA_licenses====
If you see a project with this name in your project list, you had a RMA device with not yed moved licenses, which was shipped to innovaphone and reshipped to another customer. 
The licenses of such a device have been moved into the pool of free licenses of the project Freed_RMA_licenses, from where you can assign them to another device.

===Balance===
On the balance page you will see the balance of the currently selected project or the balance of all your projects together.
The balance is bound to your company and '''not''' to your user account. The balance is bound to a specific project, but can be shared for license creation or activation key creation if wished. 
Sharing the balance over several projects is not possible in external projects!

[[Image:Balancepage.jpg|center|thumb|200px|Balance page]]

====Free licenses====

Here you see a list of all your free licenses. If you return licenses from one of your devices, the returned licenses are stored in your free licenses pool. You can assign these licenses to another device (see [[#Add licenses from free licenses|'Add licenses from free licenses']]).

[[Image:Balance_free_lics.jpg|center|thumb|200px|Free licenses list]]

The bind date, SSA end date and the external key (like DECT-Multi-Cell-Ari) are stored for each license.

===Activations===

You'll see a list of all your bound activation keys with their licenses here.

[[Image:Activations.jpg|center|thumb|200px|Activation key page]]

====Add an activation key====
To increase your projects balance, select one of your projects, follow the "Add" link and enter the activation key in the corresponding field. You can also enter an optional comment for this key. You will then get a listing of all contained licenses. After commiting this key, your project balance will have been increased by the keys values.

"Deselect the current project" to view all activation keys independent of the selected project.

====Search for an activation key by your order number====
Enter your own order number (or nothing), to view your activation keys for this order.

====License certificate====
You can always download the innovaphone license certificate for activation keys in your projects. Simply press the download link in the list at the right side.

===Own Activations===
Here you'll see a list of all created activation keys in the selected project (or over all projects).

You can create activation keys on the project page for other users/companies or to simply transfer licenses from one project to another. 
You can enter a comment, an order number and an order reference. The '''order number''' is your own order number for the key and the '''order reference''' is the reference number of the customer, who receives the newly created key. 
The order reference and order number will be shown in the innovaphone license certificate.

[[Image:Created_activations.jpg|center|thumb|200px|Created activation keys]]

You have to select an activation key in the activation key list to update or delete it.

Updating and deleting a key is only possible, if this key is not assigned.

====Update====
Add more licenses to this key or change its comment, order number and order reference. 
You can also remove licenses by entering e.g. -2, if you want to remove 2 licenses from the key.

[[Image:Own activations update.jpg|center|thumb|200px|Update own activation keys]]

====Delete====
Delete this key. Its licenses will go back into the balance of the currently selected project.

===Devices===
To view your devices you first have to click on the "Show" button. You can leave the filter field empty if you want to view all your devices.

[[Image:Devices_page.jpg|center|thumb|200px|The Devices Page]]

Red marked device names are devices, which are currently in RMA.

MAC addresses of RMA devices do not longer start with 01-...

====List====
A List of your devices in the currently selected project. 
You can deselect the current project/device to list all your devices.

Select a certain device from the device list, to manage its properties, licenses etc.

Actions on multiple devices:
* Move: move several devices into another project at once (see [[Howto:My_Innovaphone#Move_device|Move Device]])
* Remove: remove several devices at once (see [[Howto:My_Innovaphone#Remove|Remove]])

=====Add=====
Follow the "Add new devices" link on the devices page.

There you have a few options:
* You can add a single new device
* You can add devices according to a mac address range (e.g. from 00-90-33-08-20-00 to 00-90-33-08-22-00), maximum 50 at once
* You can add devices by uploading a text file with mac addresses like this (maximum 50 at once, each line one mac):

00-90-33-08-20-20
00-90-33-08-20-21
00-90-33-08-20-22
00-90-33-24-20-20

* You can add devices according to your received order number. Just enter you order number and you will get a list of all devices bount to this number.

Note: MAC addresses can be always given like this:
* 00-90-33-xx-xx-xx
* 00:90:33:xx:xx:xx
* 009033xxxxxx
* xxxxxx (00-90-33- will then be added automatically)

There might be errors, if you try to add a device. They are explained [[Howto:My_Innovaphone#Image_explanation|here]].

As the device warranty will be handled by licenses now, you can also add telephone devices
to your projects.

=====Add warranty extensions=====

Here you can add warranty extension licenses for all devices in the currently selected project. 
You'll get a list of all devices with the corresponding license type(s) and you can specify the years for each device (or for all devices by entering the number in the list header). 
After confirming your selection, you'll get an overview of all needed licenses, which you have to confirm too.

=====Check licence, SSA and warranty status of a device=====
Here you can list licenses with ssa and the warranty end date of a device, which is not in one of your projects. 
This is just available with the needed right.

=====Download devices of an order as CSV=====
Enter an order number to retrieve all devices for this order in a CSV file.

=====Download devices of an order as PDF with barcodes=====
Enter an order number to retrieve all devices for this order in a PDF file with a barcode for each MAC address. 
Der Barcode ist vom Typ C128B.

====Properties====

Change the name and comment of a device.
You can only change the name, if it's no MAC or IPEI.
 
Here you have also the possibility, to directly request RMA for this device with prefilled values.

====Licenses====
Here you can add, download or move licenses.

=====Add licenses from balance=====
To create new licenses for a device, you have to add this device first on the devices page and then select a version of the license
and whether you want to summate the current licencing. If you select current licenses, then older licenses for example V6 or V7 licenses will also be counted as V8 licenses in the next overview. This is necessary if you want to license a V6 unit with V8 licenses, but still want to use it as V6.
After that click "Next".
On the next page you will see a list of all available license types, which depends on your current available license types, of the selected license version and the device type (IP6000, IP800 e.g.):
[[Image:licenses.jpg|center|thumb|200px|Licenses for an IP3000]]
 
If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses to this SSA end date or you can optionally change this date to another one for the new licenses.
 
You see the available project balance, the balance over all projects (excluding external projects), the currently installed licenses and the maximum amount for this device type. You can now enter the value of the new license.
Base/Upgrade licenses can be selected via dropdown box.
'''Voicemail and Standby lics must always have the same amount as the selected PBX-PBX... license!
The maximum amount of PBX-Registration licenses equals the amount of the selected PBX-PBX... license!'''

The whished overall amount of pbx version 8 and above licenses can be specified here and the concrete amount of license sub types will be requested on the next page.

You can preview the SSC calculation of the wished licenses without having them in your balance.

[[Image:licenses2.jpg|center|thumb|200px|Licenses for an IP800 with V8, step two]]

The best (cheapest) combination of each v8 pbx license type is already filled in, but you might change the amount of sub types if your does not fit and you do not want to purchase new activation keys for the sub types.

The column SSC/Unit is just shown if your project is currently under SSA and you have entered a SSA end date.

The SSC multiplicator is the value, which you have to multiplicate with each license unit to get
the corresponding SSC amount.
E.g. if you have 20 units of PBX-Port8*20 licenses with a SSC value of 54 and a multiplicator of
1.0000 (which equals to 365 days) you have to pay 20*54*1.0000 ~ 1080 SSCs.

 If you create licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the currently selected version twice. 
e.g.: you want to bind licenses for V6 with SSA, so you have to pay SSCs from the release date of V7
 You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

You can't change the SSA end date, if the project is under automatic SSA! You will receive an invoice for SSCs used for the new binding.

Now confirm your new selection. If you have not enough licenses in your current project, but there are still licenses in other projects, you will get a dropdown box with a list of all projects containing the needed licenses. You can now select all desired/needed projects and confirm your selection again.
The balance of all selected projects will then be decreased by the needed amount.
 
 
If your user account has the right to buy licenses on credit, just check the checkbox.
 
You may enter an order number, which you can use for your order, if you buy on credit.

=====Add licenses from free licenses=====

Here you can assign licenses, which you returned from other devices.
You will also have to select the desired version and will than get a list of fitting licenses according to the current device and selected version.

[[Image:licenses_free.jpg|center|thumb|200px|Free Licenses for an IP800 with V8]]

If a license is under SSA, the correct license type is shown in column 'License Type' besides the 'Original Type'.
On confirming the selection, a consistency check is done (e.g. only 4 Relay-PRI licenses on an IP6000).
Bind and SSA end date will be maintained for each license.

As external keys are also maintained, you can select e.g. an old Dect-Multicell-Ari license to have the same ARI on another IP1200.
 

If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses
to this SSA end date or you can optionally change this date to another one for the new licenses.
You will have to confirm this after your first license selection (this is the same calculation as [[Reference:My_Innovaphone#Software_Service|here]]).

You can't change the SSA end date, if the project is under automatic SSA! You will receive an invoice for SSCs used for the binding.

=====Add V7 floating license (slave pbx)=====
Here you can add a V7 floating license for a slave pbx. A device with a floating license can't have V7 pbx licenses and a device with V7 pbx licenses can't have a floating license.

=====Delete V7 floating license=====
Here you can delete an already existing floating license, if you won't use it anymore.

=====Add warranty extension licenses=====
Extend your warranty by adding warranty extension licenses:

[[Image:add_warranty.jpg|center|thumb|200px|Warranty extension]]

If you add the warranty extension immediately after the receipt of your device,
you can add the cheaper warranty extension licenses, otherwise you'll have to add
the more expensive ones.

You can extend the warranty for a maximum of four years.

=====Download licenses=====

[[Image:Device_download.jpg|center|thumb|200px|Download Licenses]]

You will get a dropdown with all available versions. Versions are dependent of your device, your licenses and of the ssa of your licenses. 
'''From V9 on''', you just have one option, which will create a license file, which contains the licenses upgraded to the highest version of their type. 
You are able to download downgraded versions of your licenses. E.g. if you have only V8 licenses, you can download a V7 license file (same restrictions as below).

Downgrades or only possible down to version 6!

If you do not want to download licenses by version, you have to decide whether to download the licenses encrypted or not.
'''If you download the licenses unencrypted, you won't be able to return those licenses anymore.'''
So you won't be able to return licenses for devices with V5-V7 licenses, as licenses for these versions are not encrypted.
To return these licenses, you will have to upgrade to a new bootcode, which prevents firmware downgrades to versions below version 8. 
Encrypted licenses are stored in a xml file, which you can then upload on your V8 (or higher) device.

You can now also download licenses directly from by the web interface of a device.
You just have to enter your account data and start downloading the licenses from my.innovaphone.com
without having to download/upload a license file.

=====Download test licenses=====

[[Image:Device_download_test.jpg|center|thumb|200px|Download test licenses]]

You can also download test licenses if you want to run tests. You will be asked, which version you want to use, whether the device is used as slave and if not used as slave, how many pbx licenses you want to use.

V5 does '''not''' support test licenses!

=====Move licenses to another device=====
If you have the needed account rights or the device is already in RMA, you can move licenses to another device. After moving licenses, the former device will be marked as a RMA device.

You can just move licenses to devices without licenses!

====Move device====
Here you can move the current device or the selected devices to another project. 
If you select a SSA project, you can change the SSA end date for the move process. 

If the other project is under SSA, you will first see a SSC calculation, which you have to confirm,
as the SSA date for each SSA license will be extended until the given SSA end date
(this is the same calculation as adding SSA to an already existing project, see [[Reference:My_Innovaphone#Software_Service|here]]).

You can't change the SSA end date, if the other project is under automatic SSA! You will receive an invoice for SSCs used for the move.

====Invalidation====

=====Requirements=====
* V8 or higher
* access to the webinteraface
* a device certificate
* my.innovaphone login credentials
* '''no IPVA device'''

=====Informations=====

You can invalidate V8 (or higher) licenses by uploading the XML file, you got from your device or by returning your licenses over the web interface of your device ([[Reference8:Configuration/General/License]]), in order to return [[Reference8:Licenses#Gateway_Licenses|PBX licenses]] back to the balance.

V7 licenses can be just returned, if you agree, that you won't be able to downgrade below V8 anymore. You will need a new bootcode, to use this function. '''You need a V8 firmware or higher for invalidation.'''

If your device has access to my.innovaphone.com, you can also invalidate licenses directly
from the web interface of the device.

[[Reference8:Licenses#Gateway_Licenses|gateway licenses]] and warranty extensions won't be returned to the balance and remain to be assigned to the device!

The licenses needn't be present on the local device to perform the invalidation!

SSA it's bound to the license and it's not lost when performing invalidation.

=====Process=====

Steps to invalidate licenses, if your device has internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# enter your my.innovaphone account, the device must be in one of your projects
# click Invalidate
# click Transfer (this might fail, if NTP or DNS is not configured properly or device certificate is not installed)
# reset if asked for

Steps to invalidate licenses, if your device has no internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# click Invalidate
# click Backup and upload this file on my.innovaphone [[Reference:My_Innovaphone#Upload_the_invalidation_document_to_return_licenses|here]]
# you'll get a confirmation file after uploading the saved file
# upload this on the device (under Step1)
# reset if asked for

"Your IP800 does not have a device certificate on it." - In this case you need to download a hardware certification,
please contact the innovaphone [mailto:license@innovaphone.com license].

=====Download confirmation file=====
If you created a new certificate or you invalidated your licenses, you can later download the confirmation file, which you have to upload on the box.

=====Request certificate=====
If you have the needed rights, you can request a new device certificate for your device.

=====Upload the invalidation document to return licenses=====
Upload the invalidation document, which you got from the website of the device to return the licenses of this device.

After uploading you'll get a confirmation file, which you have to upload on your device.

====Remove====
You can always remove devices from a project. If they have licenses, these won't be deleted, so you might add the device to another project again.

===History===
[[Image:history.jpg|center|thumb|200px|History page]]
You can view your history for several contexts:
* Company: history of all actions in your company
* User: history of all actions of the selected user
* Device: history of all actions for the selected device

Each context applies to the currently selected project.
If you deselect the current project, you will see the history over all projects.

You can select to view the history of the last day, week, month, year or from always. Collecting data might take a while...

===Company===
Manage users, import other companies or change your company data.
The first user of a company has automatically company admin rights and can grant this right to other company users after adding their accounts email address. 

====Users====

[[Image:company.jpg|center|thumb|200px|Company page]]
Here you can add other users to your company, optionally with '''company admin rights'''.
You can also '''lock''' a user account or grant company admin rights. 
Locked users can't loggin to my.innovaphone.com any more. 
Instead of locking a user you can also '''remove''' this user from your company. The user itself will still have his my.innovaphone account, but won't belong to your company any more. The history of this user is still available after having removed him.

Non company admin users just get a non editable list of the current company users.

A user can be member of several companies and the users rights, company admin and
locked status can be different for all companies, where this user is in.

=====My innovaphone Viewer=====
If you check this flag for a user, this user won't be able to do any changes to your projects, devices and licenses. He will be just able to view projects, devices, SSA settings etc.

====Join (admin only)====
As admin you can also join another company into your company by entering an admin account of this company. This might be usefull if one user of your company has accidentally created an own company. 
Everything like projects, users, devices, balance, activations etc. will be imported! 
You also have to enter the company id of the company, which is to be imported. You can find this company under Licenses->Company and the company tab.

This is not available for non company admin users.

The joined company will be deleted afterwards!

====Company====
If you do not belong to a my innovaphone company, you can create one here. You can optionally enter an innovaphone account ID with its zip code or you just enter your company data below.

[[Image:company_create.jpg|center|thumb|200px|Company create page]]

Otherwise you can change your company data, but only, if you didn't created your company with your innovaphone account id. In this case, company information is always retrieved from your innovaphone account.
Non company admin users can just view the current company data.

You also see your company id here, which is sometimes needed for adding external project rights or
to be imported by another company.

You can check the '''Device SSA''' checkbox, if you want to receive SSA expiry reminder mails for each device independent of the projects SSA end date.
These mails will be send weekly seven weeks before the SSA for a license a the device expires.
 
 
You can also enter additional email addresses, which should receive SSA emails.
 
You can define a global '''end user expiry mail text''' here, which will be sent to end users, if end users are configured in a [[Reference:My_Innovaphone#SSA_Expiry_Mail | project]]. This text can be overridden by a text in a project under [[Reference:My_Innovaphone#SSA_Expiry_Mail | SSA Expiry Mail]].

====New Company====
If you need several companies for some reasons, you can create another one here. 
You will be an admin user in this new company and you can directly select the newly created company at the top right corner.

==RMA==
Here you can see all your RMA devices, which arrived innovaphone already. The licenses of this macadresses are moveable.
[[Image:rma.jpg|center|thumb|200px|RMA page]]
 
If you want to request RMA for a certain device, go to the device properties and follow the "Request RMA" link.

==Support==
===Mantis===
Here you'll get a list of all open support cases in our mantis system, which are assigned to email addresses of your my.innovaphone users in your company. 
You can click on the ticket number ("ID" column) to open an email prepared with the right emailadress and subject to address this case.

===Announcements===
You can convert audio files into G.7xx files which you can use as announcements. 
 
;Supported input formats:
* mp3
* wav
* ogg
* flac
* ...

;Generated output formats:
* G.711u
* G.711a
* G.729
* G.723
* G.722

==Configurator==
Currently this is just a link to the [http://config.innovaphone.com innovaphone PBX Configurator]

==Account==
Here you can change your personal data, password etc. You always have to enter your current password to change your data. 
You can also configure, if you want to receive SSA expiry mails!

If you change your email address, you'll have to activate your account again.

==Company selection==
If your user account belongs to several companies, you can switch between companies be using the dropdown box at the top right corner of the page. 
You'll get an error, if you try to switch to a company, where your account is locked. 

[[Image:company_selection.jpg|center|thumb|200px|Dropdown box for company selection]]

 
If you loggin, the first found company is selected for your user.

==Image explanation==

===Errors===

====Already In Company====
[[Image:Icon_in_company_inno_01.png]]
* This device already exists in your company and can't be added/imported.
If you want to import this device anyway, you first have to delete your current device from its project.

====Already Imported====
[[Image:Icon_imported_inno_01.png]]
* This device has been already imported.
You can't import it again.

====Not Found====
[[Image:Icon_not_found_inno_01.png]]
* This device was not found in the my innovaphone database.
This should never happen, but if, contact the administrator.

====IPVA MAC exists====
[[Image:Icon_ip_va_exists_inno_01.png]]
* An IPVA MAC address must be unique and can be assigned to just one company. You tried to add an already existing IPVA MAC.
Please assign a new one to your IPVA. For further details, see [[Reference9:Concept_Innovaphone_Virtual_Appliance#License_Configuration]].

===Warnings===

====Several Companies====
[[Image:Icon_several_companies_inno_01.png]]
* This device is already in another company.
This means, that either you do not have the physical device or it once belonged another company.
You can still import/add this device and you will have access to all of its current licenses.

====Several Users====
[[Image:Icon several users inno 01.png]]
* This device has licenses from several users of the old license manager.
This means, that you are not neccessarily the user, who physically owns this device. If you do not own it, do not import it.

===Misc===
====No downgrade====
[[Image:no_downgrade.png]]
* Licenses, which have been downloaded for V5/V6/V7, were returned from this device, so no downgrade to these versions is allowed any more.



==Release dates==
V5: January 1st 2003 
V6: November 2nd 2006 
V7: November 14th 2008 
V8: December 7th 2009 
V9: April 26th 2011 
V10: July 8th 2013 
V11: February 9th 2015 
V12: July 11th 2016 



==External interface==

There is an external interface, which you can use to control some functionality without a login to the my.innovaphone web site. 
You can use the interface with an '''HTTP GET''' request to the following URL: 
 
'''<code>https://my.innovaphone.com/interface.php</code>'''

===General parameters for all commands===
:;cmd: the wished command
:;email: the email address of a user who is registered in my.innovaphone
:;project_id: the project ID of the project where the user has access to (you can find the project ID under [[Reference:My_Innovaphone#Properties | Licenses->Projects->Properties]])
:;hash: an SHA256 hash value which is computed over all GET parameters but the hash parameter itself plus the '''trust''' value of the project (see [[Reference:My_Innovaphone#Properties]])
:;hash: the values of the GET parameters have to be URL encoded before calculation of the hash

;Example: URL <code>https://my.innovaphone.com/interface.php?cmd=addDevice&email=user@example.com&project_id=123456&serial=00-90-33-01-02-03&hash=b62f7948d6383cc365592ed289b6173cd35229cadc347847b953f78c8880d5b9</code>
:;project trust value: 1234567890abcdef
:;the data of the SHA256 hash: ?cmd=addDevice&email=user%40example.com&project_id=123456&serial=00-90-33-01-02-03&trust=1234567890abcdef
:;example PHP function call to generate the hash: hash("sha256", "?cmd=addDevice&email=user%40example.com&project_id=123456&serial=00-90-33-01-02-03&trust=1234567890abcdef");
:;with the current values, the function should return: b62f7948d6383cc365592ed289b6173cd35229cadc347847b953f78c8880d5b9

===Add a device to a project===
;HTTP GET parameters:
:;general parameters
:;cmd: '''addDevice'''
:;serial: the serial number of the device, e.g. 00-90-33-01-02-03

;Return value: a JSON object is returned
:;success: boolean, either '''true''' or '''false'''
:;error: string, a string with an error. Just existent if success is false
:;example success: <code type="javascript">{ "success":true }</code>
:;example error: <code type="javascript">{ "success":false, "error":"the project with ID 123456 doesn't exist" }</code>

===Remove a device from a project===
;HTTP GET parameters:
:;general parameters
:;cmd: '''delDevice'''
:;serial: the serial number of the device, e.g. 00-90-33-01-02-03

;Return value: a JSON object is returned
:;success: boolean, either '''true''' or '''false'''
:;error: string, a string with an error. Just existent if success is false
:;example success: <code type="javascript">{ "success":true }</code>
:;example error: <code type="javascript">{ "success":false, "error":"the project with ID 123456 doesn't exist" }</code>

===Get the warranty of a device===
;HTTP GET parameters:
:;general parameters
:;cmd: '''getWarranty'''
:;serial: the serial number of the device, e.g. 00-90-33-01-02-03

;Return value: a JSON object is returned
:;success: boolean, either '''true''' or '''false'''
:;error: string, a string with an error. Just existent if success is false
:;warranty: a unix timestamp in seconds sind 1970 (timezone Europe/Berlin), e.g. '''1448492400'''
:;warrantyStr: a string like '''"2015-11-26 00:00:00"'''

==Known Issues==
===Smaller issues===
* Devices where imported into a project with SSA. If this happened to you, please move the corresponding devices into a project '''without''' SSA and back into the project '''with''' SSA to extend/add SSA for the licenses until the SSA end date.
* IE7 moves a list under the menu, when a list becomes to wide
===Licenses don't work on a device, where an invalidation has been done===
A possible reason here is, that the invalidation process hasn't been completed.
To resolve this issue, follow these steps:

* Download the Confirmation File (Certificate) from http://my.innovaphone.com under [[Reference:My_Innovaphone#Invalidation|Invalidation]] after selecting the project and the device
* Open [[Reference9:General/License/my.innovaphone|General->License->my.innovaphone.com]] on your device
* Click on "Invalidate" (no my.innovaphone credentials needed)
* Upload the previously downloaded confirmation file newcert-00-90-33-xx-xx-xx.xml as "Confirmation file"
* Reset the box
* Reupload the licenses

Howto:How to obtain a test license

2017-09-29T11:37:47Z

Kti: /* V11 and later */

In Version 5, there were PBX test licenses available for a limited scenario.

Unfortunately, these have been used in questionable ways sometimes so they have been removed starting from V6.

Also, the V6 licensing scheme is much more versatile, so a new scheme has been implemented.

Here is how Test Licenses in V6 and newer Versions do work.

==Applies To==
This information applies to

* V6, V7, V8, V9, V10, V11 devices
Build 07-6040041 and later



==More Information==

===Problem Details===
To satisfy the need for test licenses for the innovaphone devices, a new web based scheme has been implemented.
As opposed to Version 5 firmware, where there were test licenses for PBX Registration licenses only, starting from V6 there are test licenses for any license type.
From V6 on, all licenses are bound to a specific mac address.
Test licenses – as all others - thus must be bound to a specific device.
No “wildcard” licenses are available. As a result, each test license must be requested individually for each device.

V6/V7 test license is requested via a web page found on the innovaphone download area.

For V8 test licenses (and later) the http://my.innovaphone.com portal is used. You can also download V7 and V6 licenses at this portal.

It will contain any possible license type with virtually no limitations in number (e.g. a test license will allow up to 10k PBX registrations).
The only limitation of the test license is that the device will stop functioning after 100 hours.
You can extend the test period though by confirming the test usage on the devices web interface.

The test licenses is structured as a set of multiple, additive licenses.
You are encouraged to tailor the licenses for your test such that it reflect the actual type and number of licenses you intend to purchase later on.
This will ensure that the system will behave as you expect and experienced during the trial! For convenience, you can select to download [[Reference:Licenses|V6]], [[Reference7:Licenses|V7]] or [[Reference8:Licenses|V8]] licenses. Also, you can select to download stand-alone or floating licenses (which require a master to get [[Reference7:Licenses#PBX Floating License|V7 floating licenses]]].

**Note: for V8 no extra floating license is needed see[[Reference8:Licenses#PBX_Floating_mechanism]].

To obtain a test license for V6 and V7, go to the V6/V7 [http://download.innovaphone.com/ice/7.00 download site] and click the respective link on the upper right corner (you cannot link to this page directly, as it will only work once you are authenticated using your ice password).

To obtain a V8/V9/V... or V6/V7 license at http://my.innovaphone.com please read [[Reference:My Innovaphone]]

===Working with a Test License===
A box running with a test license will show a special message on the info screen, indicating the remaining test period:

[[image:How_to_obtain_a_V6_test_license_Lic1.PNG]]

To extend the period, follow the link, accept the test agreement and click OK.

When the test period expires, the box will reset with all test licenses disabled and show the following message on the info screen:

[[image:How_to_obtain_a_V6_test_license_Lic2.PNG]]

You can restart the test period by following the link and proceed as described above.

When your tests are completed, you should remove the test licenses from the configuration and replace them with “real” licenses as needed.

The test licenses will look someting like

Lictype=1,test-00-90-33-06-00-68,,Test-License-for...

that is, the devices mac address wil be prefixed with "test-".

===V11 and later===
In addition to the test period a V11 (and later) test license is valid for three months after the first download. If three months are over, you won't be able to use these test licenses anymore and you won't be able to download new valid test licenses from https://my.innovaphone.com! 
It is not recommended to mix test licenses and regular licenses. If you want to use a test license, delete all licenses from your device and upload the license file including your test licenses afterwards. If you decided to end the test period, you have to delete all test licenses from the device and upload the license file with regular licenses.

[[image:v11_test_license.png]]

A new test mode is also available. See [[Reference11r1:General/License]] for more information.

== Related Articles ==
Licenses differ between the different versions. See [[Reference:Licenses]], [[Reference7:Licenses]], [[Reference8:Licenses]], [[Reference9:Licenses]], [[Reference10:Licenses]], [[Reference11:Licenses]] for details.

[[Category:Howto|{{PAGENAME}}]]

Reference:My Innovaphone

2017-05-18T08:17:22Z

Kti: /* Mantis */

==About==
My innovaphone replaces the former license manager.
It will also include the handling of device warranty and software service agreements (only partially implemented yet).

===Project-View===
My innovaphone offers the possibility for several users to be in one company. This company shares its balance of licenses over all users and can have several projects. Projects have their own balance of license types and devices are bound to a project.

===Language===
My innovaphone will support multiple languages. You can select your desired language at the top of the page. 
Currently supported languages:
* English
* German
* Italian
* Dutch
* French

===Guides===

====Quickstart guide====
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_nl.pdf Dutch quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_en.pdf English quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_fr.pdf French quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_de.pdf German quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_it.pdf Italian quickstart guide] 

====SSA guide====
;V10 and greater:
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10nl.pdf Dutch SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10en.pdf English SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10fr.pdf French SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10de.pdf German SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10it.pdf Italian SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10pl.pdf Polish SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10es.pdf Spanish SSA guide] 

;V8 and greater:
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_en.pdf English SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_fr.pdf French SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_de.pdf German SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_it.pdf Italian SSA guide] 

==First steps==
Open [https://my.innovaphone.com my.innovaphone.com] and click the "Register Now" link.
Enter your personal data and register.

You will receive a registration email with an activation link.
After account activation you have two options:
* create a new my innovaphone company (under Licenses->Company)
* ask another user of your company to add your user account to an already existing company

If you accidentally created an own my innovaphone company, just ask another user of your company to import your just created company.

If you create a new company, you can '''optionally''' enter your innovaphone account ID (which is your customer number with innovaphone) with your postal code, to retrieve your company data.

You will see a help link at the right side of the horizontal tab menu.
This link shows the corresponding text of the wiki section, when hovering with the mouse over it,
and redirects to the corresponding wiki menu, if clicked.

It is now possible, that one user is member of serveral companies!

==Search==
At the right top of the page you have a search field. You can search for different things:
* Devices (part of a device name or device comment)
* Projects (part of a project name or project description)
* Own activation keys (part of an activation key or its description)

You have to enter at least '''three''' chars to start a search. To search for activation keys,
you have to enter at least '''five''' chars.
* Search for license types. Enter e.g. "PBX-Port8" to find all devices with Port8 licenses or enter "PBX-Port8=100" to find all devices with Port8 licenses '''>=''' 100.

==Licenses==
===Projects===
After creation of an own company, you will have a default project named "DEFAULT". You can rename this project later.
You can also create more projects on the projects page with "Create".
Each project of a company must have a unique name.

Do '''not''' set SSA, if you want to import your devices from your old license manager account first.
If you want SSA and you '''won't import''' devices into this project from your old account, you should set SSA at once.

You can select a certain project by activating it in the project list. This selection is then true for all other pages, as some pages require a selected project.

[[Image:overview.jpg|center|thumb|200px|Projects page]]

By activating a project by clicking on the project name in the project list, you can manage this project and its settings.

====Properties====
Rename the project or/and change its description. 
 
You can configure further CC mail addresses inside your '''License Purchase''' project, if you have one. If you purchase licenses on credit, the emails will be also sent to theses addresses.
 
 
Since version 10, an innovaphone device will automatically connect to http://config.innovaphone.com/init
This script looks at the project properties of the project, where the device exists. 
You can configure an update '''URL''' and a '''trusted certificate'''.

====Software Service====
You can put your project under SSA (software service agreement).
You will be asked to enter a SSA end date. This will be the date, where all SSA licenses of all devices in this project will expire.
The end date mustn't be more than one year in the past. 
Optionally you can enter a maximum SSC amount. The SSA end date will be automatically calculated then. 
If you have entered a maximum SSC amount, you have to use the '''Recalculate''' link to calculate a new SSA end date,
if you change your license selection.
 
You can also calculate SSA over all projects at once. In this mode, you '''won't be able''' to confirm the calculation. You'll just see the necessary SSC amount.

After entering a date/SSC amount, you will get a summary of all licenses, which will be put under SSA and the amount of needed SSC licenses.
The SSC value for each license is calculated by the bind date of the license and the entered SSA end date/SSC amount.

[[Image:Ssa_extend.jpg|center|thumb|200px|SSA summary]]

If you have licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the current license version. 

e.g. you have a V7 PBX-PBX7#15 license with bind date 1/1/2010. Version 8 was released on 7/12/2009, so SSA is
calculated from 7/12/2009 for this license. You will see the calculation date in the list under "bind date"

If licenses already have a SSA date, just the difference between the current SSA date and the entered SSA end date must be paid.
If the bind date of the device lies in the past, the difference between the bind date and the current date must be paided twice (this is the column 'days*2'). 
If your license is under SSA, which is already over, you also have to pay the time between the old SSA date and the current SSA end date twice.

Here is a short example, how the days are calculated:

Bind date: 24/06/2009 
Current date: 31/08/2009 
SSA end date: 12/12/2011 
 
You will have to pay from 24/06/2009 to 31/08/2009 twice for 68 days.
From 31/08/2009 to 12/12/2011 you will then have to pay the normal price for 833 days.

You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

You can preview the SSC calculation for another calculation date. Simply change the dropdown
selection to get the new SSC value.
Of course you can't confirm this calculation for another date, just for the current date!

''You may add additional licenses to the calculation, which you will bind later''. Just click on the '''+''' near this text and you can add
multiple licenses, which will be added to your calculation after using the recalc link. Listed are licenses of the current version and from
your balance.

After confirming your entered SSA end date, each license will have this date as SSA end date and can be downloaded in all versions of this SSA time.

You can now extend the projects SSA end date like as setting a new one.
The resulting summary is the same as above.

If your user account has the right to buy licenses on credit, just check the checkbox.
You may enter an order number, which you can use for your order, if you buy on credit.

=====Past SSA end date=====

You can configure a new SSA end date in the past, if you accidentally configured a wrong date. 
No licenses will be changed, if you configure a date in the past, just the SSA end date of the project!

=====SSA Expiry Mail=====

If project SSA will expire, each company user will receive a reminder mail '''7''' weeks before and
then every week one mail.
You can disable these mails with the checkbox 'Send SSA expiry mails'.
Note that every user can configure, if he wants to receive mails or not in his account settings.

If you want the end user of the project to receive an expiry mail, you can configure a '''reseller''' mail address and end user mail addresses. These end users will then receive an email, 30 days before the project will expire. The default text is:

<code type="text">
Your Software Service Agreement for your innovaphone PBX in project "{$arg[3]}" will expire in {$arg[1]} days.
Please contact your reseller {$arg[2]} to upgrade the license. 
The upgrade of the license is important to secure the phone system!
</code>

You can change this text as you want. You can use placeholders:
* '''{$arg[1]}''': days left
* '''{$arg[2]}''': reseller mail address
* '''{$arg[3]}''': project name
 
You can also define a global text for all projects under your [[Reference:My_Innovaphone#Company | Company settings]].

You can optionally configure to receive project SSA independent reminder mails for each license of a device [[Reference:My_Innovaphone#Company_2|here]].

=====Automatic SSA Extension Service=====

You can request an automatic SSA extension service for a project, which is under SSA. By following this link, you will have the opportunity to request a callback and/or the necessary agreement as PDF file.

All licenses have to be under SSA to use the automatic SSA extension service!

There are some basics to know, if a project is under automatic SSA:
* If you bind new/free licenses, they'll get SSA until the current project SSA date and you will receive an invoice for the SSCs
* If you move devices into this project, their licenses will get SSA until the current project SSA date and you will receive an invoice for the SSCs
* You can't join this project into another project, but you can join another project into this one

====Rights====
=====Own project=====
Add or delete company rights for this project. To add a company right, you have to enter the company id of this company.
Each user of a company with rights on this project can add devices, licenses, activation keys to this specific project, but is restricted in removing devices, editing the project and can't create activation keys with the projects balance.

The company id can be found under Licenses->company and the company tab.

[[Image:Project_rights.jpg|center|thumb|200px|Project rights]]

=====External Project=====
If another company granted access rights to a project to you, you can unsubscribe from this project here.

====Import====
The import has been disabled. All old devices are already imported and can be added to your project manually.

====Join====
Here you can join your currently selected project with another project, which you select from a dropdown box. 
If the other project has SSA, you'll see the current SSA end date, which you might change for the join process and you will get a list of all licenses, which might be updated to the ssa end date/changed date of the other project. The list equals the list shown under [[Reference:My_Innovaphone#Software_Service|Software Service]].

The selected project will be automatically deleted after the join. You can't join a project,
if it grants external rights to another customer. Delete these rights before.

You can't change the SSA end date, if the other project is under automatic SSA! You will receive an invoice for SSCs used for the join.

====Project Move (admin only)====
A company admin can move a project with its devices, activation keys, balance etc. to another company. You have to know the company ID from this company, which can be found under Licenses->Company and the company tab. 
The history won't be moved!

Projects with negative balances can't be moved!

Existing project rights will be deleted.

====Delete====
Delete the project. Only possible if it has no activation keys, project rights, devices or user rights.
 
You may [[Reference:My_Innovaphone#Join|join]] your project into another one, if you can't delete it.

====Project Freed_RMA_licenses====
If you see a project with this name in your project list, you had a RMA device with not yed moved licenses, which was shipped to innovaphone and reshipped to another customer. 
The licenses of such a device have been moved into the pool of free licenses of the project Freed_RMA_licenses, from where you can assign them to another device.

===Balance===
On the balance page you will see the balance of the currently selected project or the balance of all your projects together.
The balance is bound to your company and '''not''' to your user account. The balance is bound to a specific project, but can be shared for license creation or activation key creation if wished. 
Sharing the balance over several projects is not possible in external projects!

[[Image:Balancepage.jpg|center|thumb|200px|Balance page]]

====Free licenses====

Here you see a list of all your free licenses. If you return licenses from one of your devices, the returned licenses are stored in your free licenses pool. You can assign these licenses to another device (see [[#Add licenses from free licenses|'Add licenses from free licenses']]).

[[Image:Balance_free_lics.jpg|center|thumb|200px|Free licenses list]]

The bind date, SSA end date and the external key (like DECT-Multi-Cell-Ari) are stored for each license.

===Activations===

You'll see a list of all your bound activation keys with their licenses here.

[[Image:Activations.jpg|center|thumb|200px|Activation key page]]

====Add an activation key====
To increase your projects balance, select one of your projects, follow the "Add" link and enter the activation key in the corresponding field. You can also enter an optional comment for this key. You will then get a listing of all contained licenses. After commiting this key, your project balance will have been increased by the keys values.

"Deselect the current project" to view all activation keys independent of the selected project.

====Search for an activation key by your order number====
Enter your own order number (or nothing), to view your activation keys for this order.

====License certificate====
You can always download the innovaphone license certificate for activation keys in your projects. Simply press the download link in the list at the right side.

===Own Activations===
Here you'll see a list of all created activation keys in the selected project (or over all projects).

You can create activation keys on the project page for other users/companies or to simply transfer licenses from one project to another. 
You can enter a comment, an order number and an order reference. The '''order number''' is your own order number for the key and the '''order reference''' is the reference number of the customer, who receives the newly created key. 
The order reference and order number will be shown in the innovaphone license certificate.

[[Image:Created_activations.jpg|center|thumb|200px|Created activation keys]]

You have to select an activation key in the activation key list to update or delete it.

Updating and deleting a key is only possible, if this key is not assigned.

====Update====
Add more licenses to this key or change its comment, order number and order reference. 
You can also remove licenses by entering e.g. -2, if you want to remove 2 licenses from the key.

[[Image:Own activations update.jpg|center|thumb|200px|Update own activation keys]]

====Delete====
Delete this key. Its licenses will go back into the balance of the currently selected project.

===Devices===
To view your devices you first have to click on the "Show" button. You can leave the filter field empty if you want to view all your devices.

[[Image:Devices_page.jpg|center|thumb|200px|The Devices Page]]

Red marked device names are devices, which are currently in RMA.

MAC addresses of RMA devices do not longer start with 01-...

====List====
A List of your devices in the currently selected project. 
You can deselect the current project/device to list all your devices.

Select a certain device from the device list, to manage its properties, licenses etc.

Actions on multiple devices:
* Move: move several devices into another project at once (see [[Howto:My_Innovaphone#Move_device|Move Device]])
* Remove: remove several devices at once (see [[Howto:My_Innovaphone#Remove|Remove]])

=====Add=====
Follow the "Add new devices" link on the devices page.

There you have a few options:
* You can add a single new device
* You can add devices according to a mac address range (e.g. from 00-90-33-08-20-00 to 00-90-33-08-22-00), maximum 50 at once
* You can add devices by uploading a text file with mac addresses like this (maximum 50 at once, each line one mac):

00-90-33-08-20-20
00-90-33-08-20-21
00-90-33-08-20-22
00-90-33-24-20-20

* You can add devices according to your received order number. Just enter you order number and you will get a list of all devices bount to this number.

Note: MAC addresses can be always given like this:
* 00-90-33-xx-xx-xx
* 00:90:33:xx:xx:xx
* 009033xxxxxx
* xxxxxx (00-90-33- will then be added automatically)

There might be errors, if you try to add a device. They are explained [[Howto:My_Innovaphone#Image_explanation|here]].

As the device warranty will be handled by licenses now, you can also add telephone devices
to your projects.

=====Add warranty extensions=====

Here you can add warranty extension licenses for all devices in the currently selected project. 
You'll get a list of all devices with the corresponding license type(s) and you can specify the years for each device (or for all devices by entering the number in the list header). 
After confirming your selection, you'll get an overview of all needed licenses, which you have to confirm too.

=====Check licence, SSA and warranty status of a device=====
Here you can list licenses with ssa and the warranty end date of a device, which is not in one of your projects. 
This is just available with the needed right.

=====Download devices of an order as CSV=====
Enter an order number to retrieve all devices for this order in a CSV file.

=====Download devices of an order as PDF with barcodes=====
Enter an order number to retrieve all devices for this order in a PDF file with a barcode for each MAC address. 
Der Barcode ist vom Typ C128B.

====Properties====

Change the name and comment of a device.
You can only change the name, if it's no MAC or IPEI.
 
Here you have also the possibility, to directly request RMA for this device with prefilled values.

====Licenses====
Here you can add, download or move licenses.

=====Add licenses from balance=====
To create new licenses for a device, you have to add this device first on the devices page and then select a version of the license
and whether you want to summate the current licencing. If you select current licenses, then older licenses for example V6 or V7 licenses will also be counted as V8 licenses in the next overview. This is necessary if you want to license a V6 unit with V8 licenses, but still want to use it as V6.
After that click "Next".
On the next page you will see a list of all available license types, which depends on your current available license types, of the selected license version and the device type (IP6000, IP800 e.g.):
[[Image:licenses.jpg|center|thumb|200px|Licenses for an IP3000]]
 
If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses to this SSA end date or you can optionally change this date to another one for the new licenses.
 
You see the available project balance, the balance over all projects (excluding external projects), the currently installed licenses and the maximum amount for this device type. You can now enter the value of the new license.
Base/Upgrade licenses can be selected via dropdown box.
'''Voicemail and Standby lics must always have the same amount as the selected PBX-PBX... license!
The maximum amount of PBX-Registration licenses equals the amount of the selected PBX-PBX... license!'''

The whished overall amount of pbx version 8 and above licenses can be specified here and the concrete amount of license sub types will be requested on the next page.

You can preview the SSC calculation of the wished licenses without having them in your balance.

[[Image:licenses2.jpg|center|thumb|200px|Licenses for an IP800 with V8, step two]]

The best (cheapest) combination of each v8 pbx license type is already filled in, but you might change the amount of sub types if your does not fit and you do not want to purchase new activation keys for the sub types.

The column SSC/Unit is just shown if your project is currently under SSA and you have entered a SSA end date.

The SSC multiplicator is the value, which you have to multiplicate with each license unit to get
the corresponding SSC amount.
E.g. if you have 20 units of PBX-Port8*20 licenses with a SSC value of 54 and a multiplicator of
1.0000 (which equals to 365 days) you have to pay 20*54*1.0000 ~ 1080 SSCs.

 If you create licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the currently selected version twice. 
e.g.: you want to bind licenses for V6 with SSA, so you have to pay SSCs from the release date of V7
 You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

You can't change the SSA end date, if the project is under automatic SSA! You will receive an invoice for SSCs used for the new binding.

Now confirm your new selection. If you have not enough licenses in your current project, but there are still licenses in other projects, you will get a dropdown box with a list of all projects containing the needed licenses. You can now select all desired/needed projects and confirm your selection again.
The balance of all selected projects will then be decreased by the needed amount.
 
 
If your user account has the right to buy licenses on credit, just check the checkbox.
 
You may enter an order number, which you can use for your order, if you buy on credit.

=====Add licenses from free licenses=====

Here you can assign licenses, which you returned from other devices.
You will also have to select the desired version and will than get a list of fitting licenses according to the current device and selected version.

[[Image:licenses_free.jpg|center|thumb|200px|Free Licenses for an IP800 with V8]]

If a license is under SSA, the correct license type is shown in column 'License Type' besides the 'Original Type'.
On confirming the selection, a consistency check is done (e.g. only 4 Relay-PRI licenses on an IP6000).
Bind and SSA end date will be maintained for each license.

As external keys are also maintained, you can select e.g. an old Dect-Multicell-Ari license to have the same ARI on another IP1200.
 

If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses
to this SSA end date or you can optionally change this date to another one for the new licenses.
You will have to confirm this after your first license selection (this is the same calculation as [[Reference:My_Innovaphone#Software_Service|here]]).

You can't change the SSA end date, if the project is under automatic SSA! You will receive an invoice for SSCs used for the binding.

=====Add V7 floating license (slave pbx)=====
Here you can add a V7 floating license for a slave pbx. A device with a floating license can't have V7 pbx licenses and a device with V7 pbx licenses can't have a floating license.

=====Delete V7 floating license=====
Here you can delete an already existing floating license, if you won't use it anymore.

=====Add warranty extension licenses=====
Extend your warranty by adding warranty extension licenses:

[[Image:add_warranty.jpg|center|thumb|200px|Warranty extension]]

If you add the warranty extension immediately after the receipt of your device,
you can add the cheaper warranty extension licenses, otherwise you'll have to add
the more expensive ones.

You can extend the warranty for a maximum of four years.

=====Download licenses=====

[[Image:Device_download.jpg|center|thumb|200px|Download Licenses]]

You will get a dropdown with all available versions. Versions are dependent of your device, your licenses and of the ssa of your licenses. 
'''From V9 on''', you just have one option, which will create a license file, which contains the licenses upgraded to the highest version of their type. 
You are able to download downgraded versions of your licenses. E.g. if you have only V8 licenses, you can download a V7 license file (same restrictions as below).

Downgrades or only possible down to version 6!

If you do not want to download licenses by version, you have to decide whether to download the licenses encrypted or not.
'''If you download the licenses unencrypted, you won't be able to return those licenses anymore.'''
So you won't be able to return licenses for devices with V5-V7 licenses, as licenses for these versions are not encrypted.
To return these licenses, you will have to upgrade to a new bootcode, which prevents firmware downgrades to versions below version 8. 
Encrypted licenses are stored in a xml file, which you can then upload on your V8 (or higher) device.

You can now also download licenses directly from by the web interface of a device.
You just have to enter your account data and start downloading the licenses from my.innovaphone.com
without having to download/upload a license file.

=====Download test licenses=====

[[Image:Device_download_test.jpg|center|thumb|200px|Download test licenses]]

You can also download test licenses if you want to run tests. You will be asked, which version you want to use, whether the device is used as slave and if not used as slave, how many pbx licenses you want to use.

V5 does '''not''' support test licenses!

=====Move licenses to another device=====
If you have the needed account rights or the device is already in RMA, you can move licenses to another device. After moving licenses, the former device will be marked as a RMA device.

You can just move licenses to devices without licenses!

====Move device====
Here you can move the current device or the selected devices to another project. 
If you select a SSA project, you can change the SSA end date for the move process. 

If the other project is under SSA, you will first see a SSC calculation, which you have to confirm,
as the SSA date for each SSA license will be extended until the given SSA end date
(this is the same calculation as adding SSA to an already existing project, see [[Reference:My_Innovaphone#Software_Service|here]]).

You can't change the SSA end date, if the other project is under automatic SSA! You will receive an invoice for SSCs used for the move.

====Invalidation====

=====Requirements=====
* V8 or higher
* access to the webinteraface
* a device certificate
* my.innovaphone login credentials
* '''no IPVA device'''

=====Informations=====

You can invalidate V8 (or higher) licenses by uploading the XML file, you got from your device or by returning your licenses over the web interface of your device ([[Reference8:Configuration/General/License]]), in order to return [[Reference8:Licenses#Gateway_Licenses|PBX licenses]] back to the balance.

V7 licenses can be just returned, if you agree, that you won't be able to downgrade below V8 anymore. You will need a new bootcode, to use this function. '''You need a V8 firmware or higher for invalidation.'''

If your device has access to my.innovaphone.com, you can also invalidate licenses directly
from the web interface of the device.

[[Reference8:Licenses#Gateway_Licenses|gateway licenses]] and warranty extensions won't be returned to the balance and remain to be assigned to the device!

The licenses needn't be present on the local device to perform the invalidation!

SSA it's bound to the license and it's not lost when performing invalidation.

=====Process=====

Steps to invalidate licenses, if your device has internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# enter your my.innovaphone account, the device must be in one of your projects
# click Invalidate
# click Transfer (this might fail, if NTP or DNS is not configured properly or device certificate is not installed)
# reset if asked for

Steps to invalidate licenses, if your device has no internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# click Invalidate
# click Backup and upload this file on my.innovaphone [[Reference:My_Innovaphone#Upload_the_invalidation_document_to_return_licenses|here]]
# you'll get a confirmation file after uploading the saved file
# upload this on the device (under Step1)
# reset if asked for

"Your IP800 does not have a device certificate on it." - In this case you need to download a hardware certification,
please contact the innovaphone [mailto:license@innovaphone.com license].

=====Download confirmation file=====
If you created a new certificate or you invalidated your licenses, you can later download the confirmation file, which you have to upload on the box.

=====Request certificate=====
If you have the needed rights, you can request a new device certificate for your device.

=====Upload the invalidation document to return licenses=====
Upload the invalidation document, which you got from the website of the device to return the licenses of this device.

After uploading you'll get a confirmation file, which you have to upload on your device.

====Remove====
You can always remove devices from a project. If they have licenses, these won't be deleted, so you might add the device to another project again.

===History===
[[Image:history.jpg|center|thumb|200px|History page]]
You can view your history for several contexts:
* Company: history of all actions in your company
* User: history of all actions of the selected user
* Device: history of all actions for the selected device

Each context applies to the currently selected project.
If you deselect the current project, you will see the history over all projects.

You can select to view the history of the last day, week, month, year or from always. Collecting data might take a while...

===Company===
Manage users, import other companies or change your company data.
The first user of a company has automatically company admin rights and can grant this right to other company users after adding their accounts email address. 

====Users====

[[Image:company.jpg|center|thumb|200px|Company page]]
Here you can add other users to your company, optionally with '''company admin rights'''.
You can also '''lock''' a user account or grant company admin rights. 
Locked users can't loggin to my.innovaphone.com any more. 
Instead of locking a user you can also '''remove''' this user from your company. The user itself will still have his my.innovaphone account, but won't belong to your company any more. The history of this user is still available after having removed him.

Non company admin users just get a non editable list of the current company users.

A user can be member of several companies and the users rights, company admin and
locked status can be different for all companies, where this user is in.

=====My innovaphone Viewer=====
If you check this flag for a user, this user won't be able to do any changes to your projects, devices and licenses. He will be just able to view projects, devices, SSA settings etc.

====Join (admin only)====
As admin you can also join another company into your company by entering an admin account of this company. This might be usefull if one user of your company has accidentally created an own company. 
Everything like projects, users, devices, balance, activations etc. will be imported! 
You also have to enter the company id of the company, which is to be imported. You can find this company under Licenses->Company and the company tab.

This is not available for non company admin users.

The joined company will be deleted afterwards!

====Company====
If you do not belong to a my innovaphone company, you can create one here. You can optionally enter an innovaphone account ID with its zip code or you just enter your company data below.

[[Image:company_create.jpg|center|thumb|200px|Company create page]]

Otherwise you can change your company data, but only, if you didn't created your company with your innovaphone account id. In this case, company information is always retrieved from your innovaphone account.
Non company admin users can just view the current company data.

You also see your company id here, which is sometimes needed for adding external project rights or
to be imported by another company.

You can check the '''Device SSA''' checkbox, if you want to receive SSA expiry reminder mails for each device independent of the projects SSA end date.
These mails will be send weekly seven weeks before the SSA for a license a the device expires.
 
 
You can also enter additional email addresses, which should receive SSA emails.
 
You can define a global '''end user expiry mail text''' here, which will be sent to end users, if end users are configured in a [[Reference:My_Innovaphone#SSA_Expiry_Mail | project]]. This text can be overridden by a text in a project under [[Reference:My_Innovaphone#SSA_Expiry_Mail | SSA Expiry Mail]].

====Partner Status====
You can review the partner status of the users of your company. 
You also see a list of companies, which granted partner status access to you.

=====Manage Partner Status Access=====
Grant or remove access rights to your own partner status. 
You can enter the [[ Reference:My_Innovaphone#Company_2 | company ID ]] of another my.innovaphone company. Afterwards, this company will have access to '''your''' partner status.

====New Company====
If you need several companies for some reasons, you can create another one here. 
You will be an admin user in this new company and you can directly select the newly created company at the top right corner.

==RMA==
Here you can see all your RMA devices, which arrived innovaphone already. The licenses of this macadresses are moveable.
[[Image:rma.jpg|center|thumb|200px|RMA page]]
 
If you want to request RMA for a certain device, go to the device properties and follow the "Request RMA" link.

==Support==
===Mantis===
Here you'll get a list of all open support cases in our mantis system, which are assigned to email addresses of your my.innovaphone users in your company. 
You can click on the ticket number ("ID" column) to open an email prepared with the right emailadress and subject to address this case.

===Announcements===
You can convert audio files into G.7xx files which you can use as announcements. 
 
;Supported input formats:
* mp3
* wav
* ogg
* flac
* ...

;Generated output formats:
* G.711u
* G.711a
* G.729
* G.723
* G.722

==Configurator==
Currently this is just a link to the [http://config.innovaphone.com innovaphone PBX Configurator]

==Account==
Here you can change your personal data, password etc. You always have to enter your current password to change your data. 
You can also configure, if you want to receive SSA expiry mails!

If you change your email address, you'll have to activate your account again.

==Company selection==
If your user account belongs to several companies, you can switch between companies be using the dropdown box at the top right corner of the page. 
You'll get an error, if you try to switch to a company, where your account is locked. 

[[Image:company_selection.jpg|center|thumb|200px|Dropdown box for company selection]]

 
If you loggin, the first found company is selected for your user.

==Image explanation==

===Errors===

====Already In Company====
[[Image:Icon_in_company_inno_01.png]]
* This device already exists in your company and can't be added/imported.
If you want to import this device anyway, you first have to delete your current device from its project.

====Already Imported====
[[Image:Icon_imported_inno_01.png]]
* This device has been already imported.
You can't import it again.

====Not Found====
[[Image:Icon_not_found_inno_01.png]]
* This device was not found in the my innovaphone database.
This should never happen, but if, contact the administrator.

====IPVA MAC exists====
[[Image:Icon_ip_va_exists_inno_01.png]]
* An IPVA MAC address must be unique and can be assigned to just one company. You tried to add an already existing IPVA MAC.
Please assign a new one to your IPVA. For further details, see [[Reference9:Concept_Innovaphone_Virtual_Appliance#License_Configuration]].

===Warnings===

====Several Companies====
[[Image:Icon_several_companies_inno_01.png]]
* This device is already in another company.
This means, that either you do not have the physical device or it once belonged another company.
You can still import/add this device and you will have access to all of its current licenses.

====Several Users====
[[Image:Icon several users inno 01.png]]
* This device has licenses from several users of the old license manager.
This means, that you are not neccessarily the user, who physically owns this device. If you do not own it, do not import it.

===Misc===
====No downgrade====
[[Image:no_downgrade.png]]
* Licenses, which have been downloaded for V5/V6/V7, were returned from this device, so no downgrade to these versions is allowed any more.



==Release dates==
V5: January 1st 2003 
V6: November 2nd 2006 
V7: November 14th 2008 
V8: December 7th 2009 
V9: April 26th 2011 
V10: July 8th 2013 
V11: February 9th 2015 
V12: July 11th 2016 



==External interface==

There is an external interface, which you can use to control some functionality without a login to the my.innovaphone web site. 
You can use the interface with an '''HTTP GET''' request to the following URL: 
 
'''<code>https://my.innovaphone.com/interface.php</code>'''

===General parameters for all commands===
:;cmd: the wished command
:;email: the email address of a user who is registered in my.innovaphone
:;project_id: the project ID of the project where the user has access to (you can find the project ID under [[Reference:My_Innovaphone#Properties | Licenses->Projects->Properties]])
:;hash: an SHA256 hash value which is computed over all GET parameters but the hash parameter itself plus the '''trust''' value of the project (see [[Reference:My_Innovaphone#Properties]])
:;hash: the values of the GET parameters have to be URL encoded before calculation of the hash

;Example: URL <code>https://my.innovaphone.com/interface.php?cmd=addDevice&email=user@example.com&project_id=123456&serial=00-90-33-01-02-03&hash=b62f7948d6383cc365592ed289b6173cd35229cadc347847b953f78c8880d5b9</code>
:;project trust value: 1234567890abcdef
:;the data of the SHA256 hash: ?cmd=addDevice&email=user%40example.com&project_id=123456&serial=00-90-33-01-02-03&trust=1234567890abcdef
:;example PHP function call to generate the hash: hash("sha256", "?cmd=addDevice&email=user%40example.com&project_id=123456&serial=00-90-33-01-02-03&trust=1234567890abcdef");
:;with the current values, the function should return: b62f7948d6383cc365592ed289b6173cd35229cadc347847b953f78c8880d5b9

===Add a device to a project===
;HTTP GET parameters:
:;general parameters
:;cmd: '''addDevice'''
:;serial: the serial number of the device, e.g. 00-90-33-01-02-03

;Return value: a JSON object is returned
:;success: boolean, either '''true''' or '''false'''
:;error: string, a string with an error. Just existent if success is false
:;example success: <code type="javascript">{ "success":true }</code>
:;example error: <code type="javascript">{ "success":false, "error":"the project with ID 123456 doesn't exist" }</code>

===Get the warranty of a device===
;HTTP GET parameters:
:;general parameters
:;cmd: '''getWarranty'''
:;serial: the serial number of the device, e.g. 00-90-33-01-02-03

;Return value: a JSON object is returned
:;success: boolean, either '''true''' or '''false'''
:;error: string, a string with an error. Just existent if success is false
:;warranty: a unix timestamp in seconds sind 1970 (timezone Europe/Berlin), e.g. '''1448492400'''
:;warrantyStr: a string like '''"2015-11-26 00:00:00"'''

==Known Issues==
===Smaller issues===
* Devices where imported into a project with SSA. If this happened to you, please move the corresponding devices into a project '''without''' SSA and back into the project '''with''' SSA to extend/add SSA for the licenses until the SSA end date.
* IE7 moves a list under the menu, when a list becomes to wide
===Licenses don't work on a device, where an invalidation has been done===
A possible reason here is, that the invalidation process hasn't been completed.
To resolve this issue, follow these steps:

* Download the Confirmation File (Certificate) from http://my.innovaphone.com under [[Reference:My_Innovaphone#Invalidation|Invalidation]] after selecting the project and the device
* Open [[Reference9:General/License/my.innovaphone|General->License->my.innovaphone.com]] on your device
* Click on "Invalidate" (no my.innovaphone credentials needed)
* Upload the previously downloaded confirmation file newcert-00-90-33-xx-xx-xx.xml as "Confirmation file"
* Reset the box
* Reupload the licenses

Reference:My Innovaphone

2017-05-18T08:17:14Z

Kti: /* Mantis */

==About==
My innovaphone replaces the former license manager.
It will also include the handling of device warranty and software service agreements (only partially implemented yet).

===Project-View===
My innovaphone offers the possibility for several users to be in one company. This company shares its balance of licenses over all users and can have several projects. Projects have their own balance of license types and devices are bound to a project.

===Language===
My innovaphone will support multiple languages. You can select your desired language at the top of the page. 
Currently supported languages:
* English
* German
* Italian
* Dutch
* French

===Guides===

====Quickstart guide====
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_nl.pdf Dutch quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_en.pdf English quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_fr.pdf French quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_de.pdf German quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_it.pdf Italian quickstart guide] 

====SSA guide====
;V10 and greater:
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10nl.pdf Dutch SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10en.pdf English SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10fr.pdf French SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10de.pdf German SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10it.pdf Italian SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10pl.pdf Polish SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10es.pdf Spanish SSA guide] 

;V8 and greater:
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_en.pdf English SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_fr.pdf French SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_de.pdf German SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_it.pdf Italian SSA guide] 

==First steps==
Open [https://my.innovaphone.com my.innovaphone.com] and click the "Register Now" link.
Enter your personal data and register.

You will receive a registration email with an activation link.
After account activation you have two options:
* create a new my innovaphone company (under Licenses->Company)
* ask another user of your company to add your user account to an already existing company

If you accidentally created an own my innovaphone company, just ask another user of your company to import your just created company.

If you create a new company, you can '''optionally''' enter your innovaphone account ID (which is your customer number with innovaphone) with your postal code, to retrieve your company data.

You will see a help link at the right side of the horizontal tab menu.
This link shows the corresponding text of the wiki section, when hovering with the mouse over it,
and redirects to the corresponding wiki menu, if clicked.

It is now possible, that one user is member of serveral companies!

==Search==
At the right top of the page you have a search field. You can search for different things:
* Devices (part of a device name or device comment)
* Projects (part of a project name or project description)
* Own activation keys (part of an activation key or its description)

You have to enter at least '''three''' chars to start a search. To search for activation keys,
you have to enter at least '''five''' chars.
* Search for license types. Enter e.g. "PBX-Port8" to find all devices with Port8 licenses or enter "PBX-Port8=100" to find all devices with Port8 licenses '''>=''' 100.

==Licenses==
===Projects===
After creation of an own company, you will have a default project named "DEFAULT". You can rename this project later.
You can also create more projects on the projects page with "Create".
Each project of a company must have a unique name.

Do '''not''' set SSA, if you want to import your devices from your old license manager account first.
If you want SSA and you '''won't import''' devices into this project from your old account, you should set SSA at once.

You can select a certain project by activating it in the project list. This selection is then true for all other pages, as some pages require a selected project.

[[Image:overview.jpg|center|thumb|200px|Projects page]]

By activating a project by clicking on the project name in the project list, you can manage this project and its settings.

====Properties====
Rename the project or/and change its description. 
 
You can configure further CC mail addresses inside your '''License Purchase''' project, if you have one. If you purchase licenses on credit, the emails will be also sent to theses addresses.
 
 
Since version 10, an innovaphone device will automatically connect to http://config.innovaphone.com/init
This script looks at the project properties of the project, where the device exists. 
You can configure an update '''URL''' and a '''trusted certificate'''.

====Software Service====
You can put your project under SSA (software service agreement).
You will be asked to enter a SSA end date. This will be the date, where all SSA licenses of all devices in this project will expire.
The end date mustn't be more than one year in the past. 
Optionally you can enter a maximum SSC amount. The SSA end date will be automatically calculated then. 
If you have entered a maximum SSC amount, you have to use the '''Recalculate''' link to calculate a new SSA end date,
if you change your license selection.
 
You can also calculate SSA over all projects at once. In this mode, you '''won't be able''' to confirm the calculation. You'll just see the necessary SSC amount.

After entering a date/SSC amount, you will get a summary of all licenses, which will be put under SSA and the amount of needed SSC licenses.
The SSC value for each license is calculated by the bind date of the license and the entered SSA end date/SSC amount.

[[Image:Ssa_extend.jpg|center|thumb|200px|SSA summary]]

If you have licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the current license version. 

e.g. you have a V7 PBX-PBX7#15 license with bind date 1/1/2010. Version 8 was released on 7/12/2009, so SSA is
calculated from 7/12/2009 for this license. You will see the calculation date in the list under "bind date"

If licenses already have a SSA date, just the difference between the current SSA date and the entered SSA end date must be paid.
If the bind date of the device lies in the past, the difference between the bind date and the current date must be paided twice (this is the column 'days*2'). 
If your license is under SSA, which is already over, you also have to pay the time between the old SSA date and the current SSA end date twice.

Here is a short example, how the days are calculated:

Bind date: 24/06/2009 
Current date: 31/08/2009 
SSA end date: 12/12/2011 
 
You will have to pay from 24/06/2009 to 31/08/2009 twice for 68 days.
From 31/08/2009 to 12/12/2011 you will then have to pay the normal price for 833 days.

You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

You can preview the SSC calculation for another calculation date. Simply change the dropdown
selection to get the new SSC value.
Of course you can't confirm this calculation for another date, just for the current date!

''You may add additional licenses to the calculation, which you will bind later''. Just click on the '''+''' near this text and you can add
multiple licenses, which will be added to your calculation after using the recalc link. Listed are licenses of the current version and from
your balance.

After confirming your entered SSA end date, each license will have this date as SSA end date and can be downloaded in all versions of this SSA time.

You can now extend the projects SSA end date like as setting a new one.
The resulting summary is the same as above.

If your user account has the right to buy licenses on credit, just check the checkbox.
You may enter an order number, which you can use for your order, if you buy on credit.

=====Past SSA end date=====

You can configure a new SSA end date in the past, if you accidentally configured a wrong date. 
No licenses will be changed, if you configure a date in the past, just the SSA end date of the project!

=====SSA Expiry Mail=====

If project SSA will expire, each company user will receive a reminder mail '''7''' weeks before and
then every week one mail.
You can disable these mails with the checkbox 'Send SSA expiry mails'.
Note that every user can configure, if he wants to receive mails or not in his account settings.

If you want the end user of the project to receive an expiry mail, you can configure a '''reseller''' mail address and end user mail addresses. These end users will then receive an email, 30 days before the project will expire. The default text is:

<code type="text">
Your Software Service Agreement for your innovaphone PBX in project "{$arg[3]}" will expire in {$arg[1]} days.
Please contact your reseller {$arg[2]} to upgrade the license. 
The upgrade of the license is important to secure the phone system!
</code>

You can change this text as you want. You can use placeholders:
* '''{$arg[1]}''': days left
* '''{$arg[2]}''': reseller mail address
* '''{$arg[3]}''': project name
 
You can also define a global text for all projects under your [[Reference:My_Innovaphone#Company | Company settings]].

You can optionally configure to receive project SSA independent reminder mails for each license of a device [[Reference:My_Innovaphone#Company_2|here]].

=====Automatic SSA Extension Service=====

You can request an automatic SSA extension service for a project, which is under SSA. By following this link, you will have the opportunity to request a callback and/or the necessary agreement as PDF file.

All licenses have to be under SSA to use the automatic SSA extension service!

There are some basics to know, if a project is under automatic SSA:
* If you bind new/free licenses, they'll get SSA until the current project SSA date and you will receive an invoice for the SSCs
* If you move devices into this project, their licenses will get SSA until the current project SSA date and you will receive an invoice for the SSCs
* You can't join this project into another project, but you can join another project into this one

====Rights====
=====Own project=====
Add or delete company rights for this project. To add a company right, you have to enter the company id of this company.
Each user of a company with rights on this project can add devices, licenses, activation keys to this specific project, but is restricted in removing devices, editing the project and can't create activation keys with the projects balance.

The company id can be found under Licenses->company and the company tab.

[[Image:Project_rights.jpg|center|thumb|200px|Project rights]]

=====External Project=====
If another company granted access rights to a project to you, you can unsubscribe from this project here.

====Import====
The import has been disabled. All old devices are already imported and can be added to your project manually.

====Join====
Here you can join your currently selected project with another project, which you select from a dropdown box. 
If the other project has SSA, you'll see the current SSA end date, which you might change for the join process and you will get a list of all licenses, which might be updated to the ssa end date/changed date of the other project. The list equals the list shown under [[Reference:My_Innovaphone#Software_Service|Software Service]].

The selected project will be automatically deleted after the join. You can't join a project,
if it grants external rights to another customer. Delete these rights before.

You can't change the SSA end date, if the other project is under automatic SSA! You will receive an invoice for SSCs used for the join.

====Project Move (admin only)====
A company admin can move a project with its devices, activation keys, balance etc. to another company. You have to know the company ID from this company, which can be found under Licenses->Company and the company tab. 
The history won't be moved!

Projects with negative balances can't be moved!

Existing project rights will be deleted.

====Delete====
Delete the project. Only possible if it has no activation keys, project rights, devices or user rights.
 
You may [[Reference:My_Innovaphone#Join|join]] your project into another one, if you can't delete it.

====Project Freed_RMA_licenses====
If you see a project with this name in your project list, you had a RMA device with not yed moved licenses, which was shipped to innovaphone and reshipped to another customer. 
The licenses of such a device have been moved into the pool of free licenses of the project Freed_RMA_licenses, from where you can assign them to another device.

===Balance===
On the balance page you will see the balance of the currently selected project or the balance of all your projects together.
The balance is bound to your company and '''not''' to your user account. The balance is bound to a specific project, but can be shared for license creation or activation key creation if wished. 
Sharing the balance over several projects is not possible in external projects!

[[Image:Balancepage.jpg|center|thumb|200px|Balance page]]

====Free licenses====

Here you see a list of all your free licenses. If you return licenses from one of your devices, the returned licenses are stored in your free licenses pool. You can assign these licenses to another device (see [[#Add licenses from free licenses|'Add licenses from free licenses']]).

[[Image:Balance_free_lics.jpg|center|thumb|200px|Free licenses list]]

The bind date, SSA end date and the external key (like DECT-Multi-Cell-Ari) are stored for each license.

===Activations===

You'll see a list of all your bound activation keys with their licenses here.

[[Image:Activations.jpg|center|thumb|200px|Activation key page]]

====Add an activation key====
To increase your projects balance, select one of your projects, follow the "Add" link and enter the activation key in the corresponding field. You can also enter an optional comment for this key. You will then get a listing of all contained licenses. After commiting this key, your project balance will have been increased by the keys values.

"Deselect the current project" to view all activation keys independent of the selected project.

====Search for an activation key by your order number====
Enter your own order number (or nothing), to view your activation keys for this order.

====License certificate====
You can always download the innovaphone license certificate for activation keys in your projects. Simply press the download link in the list at the right side.

===Own Activations===
Here you'll see a list of all created activation keys in the selected project (or over all projects).

You can create activation keys on the project page for other users/companies or to simply transfer licenses from one project to another. 
You can enter a comment, an order number and an order reference. The '''order number''' is your own order number for the key and the '''order reference''' is the reference number of the customer, who receives the newly created key. 
The order reference and order number will be shown in the innovaphone license certificate.

[[Image:Created_activations.jpg|center|thumb|200px|Created activation keys]]

You have to select an activation key in the activation key list to update or delete it.

Updating and deleting a key is only possible, if this key is not assigned.

====Update====
Add more licenses to this key or change its comment, order number and order reference. 
You can also remove licenses by entering e.g. -2, if you want to remove 2 licenses from the key.

[[Image:Own activations update.jpg|center|thumb|200px|Update own activation keys]]

====Delete====
Delete this key. Its licenses will go back into the balance of the currently selected project.

===Devices===
To view your devices you first have to click on the "Show" button. You can leave the filter field empty if you want to view all your devices.

[[Image:Devices_page.jpg|center|thumb|200px|The Devices Page]]

Red marked device names are devices, which are currently in RMA.

MAC addresses of RMA devices do not longer start with 01-...

====List====
A List of your devices in the currently selected project. 
You can deselect the current project/device to list all your devices.

Select a certain device from the device list, to manage its properties, licenses etc.

Actions on multiple devices:
* Move: move several devices into another project at once (see [[Howto:My_Innovaphone#Move_device|Move Device]])
* Remove: remove several devices at once (see [[Howto:My_Innovaphone#Remove|Remove]])

=====Add=====
Follow the "Add new devices" link on the devices page.

There you have a few options:
* You can add a single new device
* You can add devices according to a mac address range (e.g. from 00-90-33-08-20-00 to 00-90-33-08-22-00), maximum 50 at once
* You can add devices by uploading a text file with mac addresses like this (maximum 50 at once, each line one mac):

00-90-33-08-20-20
00-90-33-08-20-21
00-90-33-08-20-22
00-90-33-24-20-20

* You can add devices according to your received order number. Just enter you order number and you will get a list of all devices bount to this number.

Note: MAC addresses can be always given like this:
* 00-90-33-xx-xx-xx
* 00:90:33:xx:xx:xx
* 009033xxxxxx
* xxxxxx (00-90-33- will then be added automatically)

There might be errors, if you try to add a device. They are explained [[Howto:My_Innovaphone#Image_explanation|here]].

As the device warranty will be handled by licenses now, you can also add telephone devices
to your projects.

=====Add warranty extensions=====

Here you can add warranty extension licenses for all devices in the currently selected project. 
You'll get a list of all devices with the corresponding license type(s) and you can specify the years for each device (or for all devices by entering the number in the list header). 
After confirming your selection, you'll get an overview of all needed licenses, which you have to confirm too.

=====Check licence, SSA and warranty status of a device=====
Here you can list licenses with ssa and the warranty end date of a device, which is not in one of your projects. 
This is just available with the needed right.

=====Download devices of an order as CSV=====
Enter an order number to retrieve all devices for this order in a CSV file.

=====Download devices of an order as PDF with barcodes=====
Enter an order number to retrieve all devices for this order in a PDF file with a barcode for each MAC address. 
Der Barcode ist vom Typ C128B.

====Properties====

Change the name and comment of a device.
You can only change the name, if it's no MAC or IPEI.
 
Here you have also the possibility, to directly request RMA for this device with prefilled values.

====Licenses====
Here you can add, download or move licenses.

=====Add licenses from balance=====
To create new licenses for a device, you have to add this device first on the devices page and then select a version of the license
and whether you want to summate the current licencing. If you select current licenses, then older licenses for example V6 or V7 licenses will also be counted as V8 licenses in the next overview. This is necessary if you want to license a V6 unit with V8 licenses, but still want to use it as V6.
After that click "Next".
On the next page you will see a list of all available license types, which depends on your current available license types, of the selected license version and the device type (IP6000, IP800 e.g.):
[[Image:licenses.jpg|center|thumb|200px|Licenses for an IP3000]]
 
If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses to this SSA end date or you can optionally change this date to another one for the new licenses.
 
You see the available project balance, the balance over all projects (excluding external projects), the currently installed licenses and the maximum amount for this device type. You can now enter the value of the new license.
Base/Upgrade licenses can be selected via dropdown box.
'''Voicemail and Standby lics must always have the same amount as the selected PBX-PBX... license!
The maximum amount of PBX-Registration licenses equals the amount of the selected PBX-PBX... license!'''

The whished overall amount of pbx version 8 and above licenses can be specified here and the concrete amount of license sub types will be requested on the next page.

You can preview the SSC calculation of the wished licenses without having them in your balance.

[[Image:licenses2.jpg|center|thumb|200px|Licenses for an IP800 with V8, step two]]

The best (cheapest) combination of each v8 pbx license type is already filled in, but you might change the amount of sub types if your does not fit and you do not want to purchase new activation keys for the sub types.

The column SSC/Unit is just shown if your project is currently under SSA and you have entered a SSA end date.

The SSC multiplicator is the value, which you have to multiplicate with each license unit to get
the corresponding SSC amount.
E.g. if you have 20 units of PBX-Port8*20 licenses with a SSC value of 54 and a multiplicator of
1.0000 (which equals to 365 days) you have to pay 20*54*1.0000 ~ 1080 SSCs.

 If you create licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the currently selected version twice. 
e.g.: you want to bind licenses for V6 with SSA, so you have to pay SSCs from the release date of V7
 You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

You can't change the SSA end date, if the project is under automatic SSA! You will receive an invoice for SSCs used for the new binding.

Now confirm your new selection. If you have not enough licenses in your current project, but there are still licenses in other projects, you will get a dropdown box with a list of all projects containing the needed licenses. You can now select all desired/needed projects and confirm your selection again.
The balance of all selected projects will then be decreased by the needed amount.
 
 
If your user account has the right to buy licenses on credit, just check the checkbox.
 
You may enter an order number, which you can use for your order, if you buy on credit.

=====Add licenses from free licenses=====

Here you can assign licenses, which you returned from other devices.
You will also have to select the desired version and will than get a list of fitting licenses according to the current device and selected version.

[[Image:licenses_free.jpg|center|thumb|200px|Free Licenses for an IP800 with V8]]

If a license is under SSA, the correct license type is shown in column 'License Type' besides the 'Original Type'.
On confirming the selection, a consistency check is done (e.g. only 4 Relay-PRI licenses on an IP6000).
Bind and SSA end date will be maintained for each license.

As external keys are also maintained, you can select e.g. an old Dect-Multicell-Ari license to have the same ARI on another IP1200.
 

If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses
to this SSA end date or you can optionally change this date to another one for the new licenses.
You will have to confirm this after your first license selection (this is the same calculation as [[Reference:My_Innovaphone#Software_Service|here]]).

You can't change the SSA end date, if the project is under automatic SSA! You will receive an invoice for SSCs used for the binding.

=====Add V7 floating license (slave pbx)=====
Here you can add a V7 floating license for a slave pbx. A device with a floating license can't have V7 pbx licenses and a device with V7 pbx licenses can't have a floating license.

=====Delete V7 floating license=====
Here you can delete an already existing floating license, if you won't use it anymore.

=====Add warranty extension licenses=====
Extend your warranty by adding warranty extension licenses:

[[Image:add_warranty.jpg|center|thumb|200px|Warranty extension]]

If you add the warranty extension immediately after the receipt of your device,
you can add the cheaper warranty extension licenses, otherwise you'll have to add
the more expensive ones.

You can extend the warranty for a maximum of four years.

=====Download licenses=====

[[Image:Device_download.jpg|center|thumb|200px|Download Licenses]]

You will get a dropdown with all available versions. Versions are dependent of your device, your licenses and of the ssa of your licenses. 
'''From V9 on''', you just have one option, which will create a license file, which contains the licenses upgraded to the highest version of their type. 
You are able to download downgraded versions of your licenses. E.g. if you have only V8 licenses, you can download a V7 license file (same restrictions as below).

Downgrades or only possible down to version 6!

If you do not want to download licenses by version, you have to decide whether to download the licenses encrypted or not.
'''If you download the licenses unencrypted, you won't be able to return those licenses anymore.'''
So you won't be able to return licenses for devices with V5-V7 licenses, as licenses for these versions are not encrypted.
To return these licenses, you will have to upgrade to a new bootcode, which prevents firmware downgrades to versions below version 8. 
Encrypted licenses are stored in a xml file, which you can then upload on your V8 (or higher) device.

You can now also download licenses directly from by the web interface of a device.
You just have to enter your account data and start downloading the licenses from my.innovaphone.com
without having to download/upload a license file.

=====Download test licenses=====

[[Image:Device_download_test.jpg|center|thumb|200px|Download test licenses]]

You can also download test licenses if you want to run tests. You will be asked, which version you want to use, whether the device is used as slave and if not used as slave, how many pbx licenses you want to use.

V5 does '''not''' support test licenses!

=====Move licenses to another device=====
If you have the needed account rights or the device is already in RMA, you can move licenses to another device. After moving licenses, the former device will be marked as a RMA device.

You can just move licenses to devices without licenses!

====Move device====
Here you can move the current device or the selected devices to another project. 
If you select a SSA project, you can change the SSA end date for the move process. 

If the other project is under SSA, you will first see a SSC calculation, which you have to confirm,
as the SSA date for each SSA license will be extended until the given SSA end date
(this is the same calculation as adding SSA to an already existing project, see [[Reference:My_Innovaphone#Software_Service|here]]).

You can't change the SSA end date, if the other project is under automatic SSA! You will receive an invoice for SSCs used for the move.

====Invalidation====

=====Requirements=====
* V8 or higher
* access to the webinteraface
* a device certificate
* my.innovaphone login credentials
* '''no IPVA device'''

=====Informations=====

You can invalidate V8 (or higher) licenses by uploading the XML file, you got from your device or by returning your licenses over the web interface of your device ([[Reference8:Configuration/General/License]]), in order to return [[Reference8:Licenses#Gateway_Licenses|PBX licenses]] back to the balance.

V7 licenses can be just returned, if you agree, that you won't be able to downgrade below V8 anymore. You will need a new bootcode, to use this function. '''You need a V8 firmware or higher for invalidation.'''

If your device has access to my.innovaphone.com, you can also invalidate licenses directly
from the web interface of the device.

[[Reference8:Licenses#Gateway_Licenses|gateway licenses]] and warranty extensions won't be returned to the balance and remain to be assigned to the device!

The licenses needn't be present on the local device to perform the invalidation!

SSA it's bound to the license and it's not lost when performing invalidation.

=====Process=====

Steps to invalidate licenses, if your device has internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# enter your my.innovaphone account, the device must be in one of your projects
# click Invalidate
# click Transfer (this might fail, if NTP or DNS is not configured properly or device certificate is not installed)
# reset if asked for

Steps to invalidate licenses, if your device has no internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# click Invalidate
# click Backup and upload this file on my.innovaphone [[Reference:My_Innovaphone#Upload_the_invalidation_document_to_return_licenses|here]]
# you'll get a confirmation file after uploading the saved file
# upload this on the device (under Step1)
# reset if asked for

"Your IP800 does not have a device certificate on it." - In this case you need to download a hardware certification,
please contact the innovaphone [mailto:license@innovaphone.com license].

=====Download confirmation file=====
If you created a new certificate or you invalidated your licenses, you can later download the confirmation file, which you have to upload on the box.

=====Request certificate=====
If you have the needed rights, you can request a new device certificate for your device.

=====Upload the invalidation document to return licenses=====
Upload the invalidation document, which you got from the website of the device to return the licenses of this device.

After uploading you'll get a confirmation file, which you have to upload on your device.

====Remove====
You can always remove devices from a project. If they have licenses, these won't be deleted, so you might add the device to another project again.

===History===
[[Image:history.jpg|center|thumb|200px|History page]]
You can view your history for several contexts:
* Company: history of all actions in your company
* User: history of all actions of the selected user
* Device: history of all actions for the selected device

Each context applies to the currently selected project.
If you deselect the current project, you will see the history over all projects.

You can select to view the history of the last day, week, month, year or from always. Collecting data might take a while...

===Company===
Manage users, import other companies or change your company data.
The first user of a company has automatically company admin rights and can grant this right to other company users after adding their accounts email address. 

====Users====

[[Image:company.jpg|center|thumb|200px|Company page]]
Here you can add other users to your company, optionally with '''company admin rights'''.
You can also '''lock''' a user account or grant company admin rights. 
Locked users can't loggin to my.innovaphone.com any more. 
Instead of locking a user you can also '''remove''' this user from your company. The user itself will still have his my.innovaphone account, but won't belong to your company any more. The history of this user is still available after having removed him.

Non company admin users just get a non editable list of the current company users.

A user can be member of several companies and the users rights, company admin and
locked status can be different for all companies, where this user is in.

=====My innovaphone Viewer=====
If you check this flag for a user, this user won't be able to do any changes to your projects, devices and licenses. He will be just able to view projects, devices, SSA settings etc.

====Join (admin only)====
As admin you can also join another company into your company by entering an admin account of this company. This might be usefull if one user of your company has accidentally created an own company. 
Everything like projects, users, devices, balance, activations etc. will be imported! 
You also have to enter the company id of the company, which is to be imported. You can find this company under Licenses->Company and the company tab.

This is not available for non company admin users.

The joined company will be deleted afterwards!

====Company====
If you do not belong to a my innovaphone company, you can create one here. You can optionally enter an innovaphone account ID with its zip code or you just enter your company data below.

[[Image:company_create.jpg|center|thumb|200px|Company create page]]

Otherwise you can change your company data, but only, if you didn't created your company with your innovaphone account id. In this case, company information is always retrieved from your innovaphone account.
Non company admin users can just view the current company data.

You also see your company id here, which is sometimes needed for adding external project rights or
to be imported by another company.

You can check the '''Device SSA''' checkbox, if you want to receive SSA expiry reminder mails for each device independent of the projects SSA end date.
These mails will be send weekly seven weeks before the SSA for a license a the device expires.
 
 
You can also enter additional email addresses, which should receive SSA emails.
 
You can define a global '''end user expiry mail text''' here, which will be sent to end users, if end users are configured in a [[Reference:My_Innovaphone#SSA_Expiry_Mail | project]]. This text can be overridden by a text in a project under [[Reference:My_Innovaphone#SSA_Expiry_Mail | SSA Expiry Mail]].

====Partner Status====
You can review the partner status of the users of your company. 
You also see a list of companies, which granted partner status access to you.

=====Manage Partner Status Access=====
Grant or remove access rights to your own partner status. 
You can enter the [[ Reference:My_Innovaphone#Company_2 | company ID ]] of another my.innovaphone company. Afterwards, this company will have access to '''your''' partner status.

====New Company====
If you need several companies for some reasons, you can create another one here. 
You will be an admin user in this new company and you can directly select the newly created company at the top right corner.

==RMA==
Here you can see all your RMA devices, which arrived innovaphone already. The licenses of this macadresses are moveable.
[[Image:rma.jpg|center|thumb|200px|RMA page]]
 
If you want to request RMA for a certain device, go to the device properties and follow the "Request RMA" link.

==Support==
===Mantis===
Here you'll get a list of all open support cases in our mantis system, which are assigned to email addresses of your my.innovaphone users in your company.
You can click on the ticket number ("ID" column) to open an email prepared with the right emailadress and subject to address this case.

===Announcements===
You can convert audio files into G.7xx files which you can use as announcements. 
 
;Supported input formats:
* mp3
* wav
* ogg
* flac
* ...

;Generated output formats:
* G.711u
* G.711a
* G.729
* G.723
* G.722

==Configurator==
Currently this is just a link to the [http://config.innovaphone.com innovaphone PBX Configurator]

==Account==
Here you can change your personal data, password etc. You always have to enter your current password to change your data. 
You can also configure, if you want to receive SSA expiry mails!

If you change your email address, you'll have to activate your account again.

==Company selection==
If your user account belongs to several companies, you can switch between companies be using the dropdown box at the top right corner of the page. 
You'll get an error, if you try to switch to a company, where your account is locked. 

[[Image:company_selection.jpg|center|thumb|200px|Dropdown box for company selection]]

 
If you loggin, the first found company is selected for your user.

==Image explanation==

===Errors===

====Already In Company====
[[Image:Icon_in_company_inno_01.png]]
* This device already exists in your company and can't be added/imported.
If you want to import this device anyway, you first have to delete your current device from its project.

====Already Imported====
[[Image:Icon_imported_inno_01.png]]
* This device has been already imported.
You can't import it again.

====Not Found====
[[Image:Icon_not_found_inno_01.png]]
* This device was not found in the my innovaphone database.
This should never happen, but if, contact the administrator.

====IPVA MAC exists====
[[Image:Icon_ip_va_exists_inno_01.png]]
* An IPVA MAC address must be unique and can be assigned to just one company. You tried to add an already existing IPVA MAC.
Please assign a new one to your IPVA. For further details, see [[Reference9:Concept_Innovaphone_Virtual_Appliance#License_Configuration]].

===Warnings===

====Several Companies====
[[Image:Icon_several_companies_inno_01.png]]
* This device is already in another company.
This means, that either you do not have the physical device or it once belonged another company.
You can still import/add this device and you will have access to all of its current licenses.

====Several Users====
[[Image:Icon several users inno 01.png]]
* This device has licenses from several users of the old license manager.
This means, that you are not neccessarily the user, who physically owns this device. If you do not own it, do not import it.

===Misc===
====No downgrade====
[[Image:no_downgrade.png]]
* Licenses, which have been downloaded for V5/V6/V7, were returned from this device, so no downgrade to these versions is allowed any more.



==Release dates==
V5: January 1st 2003 
V6: November 2nd 2006 
V7: November 14th 2008 
V8: December 7th 2009 
V9: April 26th 2011 
V10: July 8th 2013 
V11: February 9th 2015 
V12: July 11th 2016 



==External interface==

There is an external interface, which you can use to control some functionality without a login to the my.innovaphone web site. 
You can use the interface with an '''HTTP GET''' request to the following URL: 
 
'''<code>https://my.innovaphone.com/interface.php</code>'''

===General parameters for all commands===
:;cmd: the wished command
:;email: the email address of a user who is registered in my.innovaphone
:;project_id: the project ID of the project where the user has access to (you can find the project ID under [[Reference:My_Innovaphone#Properties | Licenses->Projects->Properties]])
:;hash: an SHA256 hash value which is computed over all GET parameters but the hash parameter itself plus the '''trust''' value of the project (see [[Reference:My_Innovaphone#Properties]])
:;hash: the values of the GET parameters have to be URL encoded before calculation of the hash

;Example: URL <code>https://my.innovaphone.com/interface.php?cmd=addDevice&email=user@example.com&project_id=123456&serial=00-90-33-01-02-03&hash=b62f7948d6383cc365592ed289b6173cd35229cadc347847b953f78c8880d5b9</code>
:;project trust value: 1234567890abcdef
:;the data of the SHA256 hash: ?cmd=addDevice&email=user%40example.com&project_id=123456&serial=00-90-33-01-02-03&trust=1234567890abcdef
:;example PHP function call to generate the hash: hash("sha256", "?cmd=addDevice&email=user%40example.com&project_id=123456&serial=00-90-33-01-02-03&trust=1234567890abcdef");
:;with the current values, the function should return: b62f7948d6383cc365592ed289b6173cd35229cadc347847b953f78c8880d5b9

===Add a device to a project===
;HTTP GET parameters:
:;general parameters
:;cmd: '''addDevice'''
:;serial: the serial number of the device, e.g. 00-90-33-01-02-03

;Return value: a JSON object is returned
:;success: boolean, either '''true''' or '''false'''
:;error: string, a string with an error. Just existent if success is false
:;example success: <code type="javascript">{ "success":true }</code>
:;example error: <code type="javascript">{ "success":false, "error":"the project with ID 123456 doesn't exist" }</code>

===Get the warranty of a device===
;HTTP GET parameters:
:;general parameters
:;cmd: '''getWarranty'''
:;serial: the serial number of the device, e.g. 00-90-33-01-02-03

;Return value: a JSON object is returned
:;success: boolean, either '''true''' or '''false'''
:;error: string, a string with an error. Just existent if success is false
:;warranty: a unix timestamp in seconds sind 1970 (timezone Europe/Berlin), e.g. '''1448492400'''
:;warrantyStr: a string like '''"2015-11-26 00:00:00"'''

==Known Issues==
===Smaller issues===
* Devices where imported into a project with SSA. If this happened to you, please move the corresponding devices into a project '''without''' SSA and back into the project '''with''' SSA to extend/add SSA for the licenses until the SSA end date.
* IE7 moves a list under the menu, when a list becomes to wide
===Licenses don't work on a device, where an invalidation has been done===
A possible reason here is, that the invalidation process hasn't been completed.
To resolve this issue, follow these steps:

* Download the Confirmation File (Certificate) from http://my.innovaphone.com under [[Reference:My_Innovaphone#Invalidation|Invalidation]] after selecting the project and the device
* Open [[Reference9:General/License/my.innovaphone|General->License->my.innovaphone.com]] on your device
* Click on "Invalidate" (no my.innovaphone credentials needed)
* Upload the previously downloaded confirmation file newcert-00-90-33-xx-xx-xx.xml as "Confirmation file"
* Reset the box
* Reupload the licenses

Reference:My Innovaphone

2017-02-21T08:39:41Z

Kti: /* Release dates */

==About==
My innovaphone replaces the former license manager.
It will also include the handling of device warranty and software service agreements (only partially implemented yet).

===Project-View===
My innovaphone offers the possibility for several users to be in one company. This company shares its balance of licenses over all users and can have several projects. Projects have their own balance of license types and devices are bound to a project.

===Language===
My innovaphone will support multiple languages. You can select your desired language at the top of the page. 
Currently supported languages:
* English
* German
* Italian
* Dutch
* French

===Guides===

====Quickstart guide====
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_nl.pdf Dutch quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_en.pdf English quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_fr.pdf French quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_de.pdf German quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_it.pdf Italian quickstart guide] 

====SSA guide====
;V10 and greater:
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10nl.pdf Dutch SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10en.pdf English SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10fr.pdf French SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10de.pdf German SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10it.pdf Italian SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10pl.pdf Polish SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_V10es.pdf Spanish SSA guide] 

;V8 and greater:
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_en.pdf English SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_fr.pdf French SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_de.pdf German SSA guide] 
* [https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_it.pdf Italian SSA guide] 

==First steps==
Open [https://my.innovaphone.com my.innovaphone.com] and click the "Register Now" link.
Enter your personal data and register.

You will receive a registration email with an activation link.
After account activation you have two options:
* create a new my innovaphone company (under Licenses->Company)
* ask another user of your company to add your user account to an already existing company

If you accidentally created an own my innovaphone company, just ask another user of your company to import your just created company.

If you create a new company, you can '''optionally''' enter your innovaphone account ID (which is your customer number with innovaphone) with your postal code, to retrieve your company data.

You will see a help link at the right side of the horizontal tab menu.
This link shows the corresponding text of the wiki section, when hovering with the mouse over it,
and redirects to the corresponding wiki menu, if clicked.

It is now possible, that one user is member of serveral companies!

==Search==
At the right top of the page you have a search field. You can search for different things:
* Devices (part of a device name or device comment)
* Projects (part of a project name or project description)
* Own activation keys (part of an activation key or its description)

You have to enter at least '''three''' chars to start a search. To search for activation keys,
you have to enter at least '''five''' chars.
* Search for license types. Enter e.g. "PBX-Port8" to find all devices with Port8 licenses or enter "PBX-Port8=100" to find all devices with Port8 licenses '''>=''' 100.

==Licenses==
===Projects===
After creation of an own company, you will have a default project named "DEFAULT". You can rename this project later.
You can also create more projects on the projects page with "Create".
Each project of a company must have a unique name.

Do '''not''' set SSA, if you want to import your devices from your old license manager account first.
If you want SSA and you '''won't import''' devices into this project from your old account, you should set SSA at once.

You can select a certain project by activating it in the project list. This selection is then true for all other pages, as some pages require a selected project.

[[Image:overview.jpg|center|thumb|200px|Projects page]]

By activating a project by clicking on the project name in the project list, you can manage this project and its settings.

====Properties====
Rename the project or/and change its description. 
 
You can configure further CC mail addresses inside your '''License Purchase''' project, if you have one. If you purchase licenses on credit, the emails will be also sent to theses addresses.
 
 
Since version 10, an innovaphone device will automatically connect to http://config.innovaphone.com/init
This script looks at the project properties of the project, where the device exists. 
You can configure an update '''URL''' and a '''trusted certificate'''.

====Software Service====
You can put your project under SSA (software service agreement).
You will be asked to enter a SSA end date. This will be the date, where all SSA licenses of all devices in this project will expire.
The end date mustn't be more than one year in the past. 
Optionally you can enter a maximum SSC amount. The SSA end date will be automatically calculated then. 
If you have entered a maximum SSC amount, you have to use the '''Recalculate''' link to calculate a new SSA end date,
if you change your license selection.
 
You can also calculate SSA over all projects at once. In this mode, you '''won't be able''' to confirm the calculation. You'll just see the necessary SSC amount.

After entering a date/SSC amount, you will get a summary of all licenses, which will be put under SSA and the amount of needed SSC licenses.
The SSC value for each license is calculated by the bind date of the license and the entered SSA end date/SSC amount.

[[Image:Ssa_extend.jpg|center|thumb|200px|SSA summary]]

If you have licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the current license version. 

e.g. you have a V7 PBX-PBX7#15 license with bind date 1/1/2010. Version 8 was released on 7/12/2009, so SSA is
calculated from 7/12/2009 for this license. You will see the calculation date in the list under "bind date"

If licenses already have a SSA date, just the difference between the current SSA date and the entered SSA end date must be paid.
If the bind date of the device lies in the past, the difference between the bind date and the current date must be paided twice (this is the column 'days*2'). 
If your license is under SSA, which is already over, you also have to pay the time between the old SSA date and the current SSA end date twice.

Here is a short example, how the days are calculated:

Bind date: 24/06/2009 
Current date: 31/08/2009 
SSA end date: 12/12/2011 
 
You will have to pay from 24/06/2009 to 31/08/2009 twice for 68 days.
From 31/08/2009 to 12/12/2011 you will then have to pay the normal price for 833 days.

You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

You can preview the SSC calculation for another calculation date. Simply change the dropdown
selection to get the new SSC value.
Of course you can't confirm this calculation for another date, just for the current date!

''You may add additional licenses to the calculation, which you will bind later''. Just click on the '''+''' near this text and you can add
multiple licenses, which will be added to your calculation after using the recalc link. Listed are licenses of the current version and from
your balance.

After confirming your entered SSA end date, each license will have this date as SSA end date and can be downloaded in all versions of this SSA time.

You can now extend the projects SSA end date like as setting a new one.
The resulting summary is the same as above.

If your user account has the right to buy licenses on credit, just check the checkbox.
You may enter an order number, which you can use for your order, if you buy on credit.

=====Past SSA end date=====

You can configure a new SSA end date in the past, if you accidentally configured a wrong date. 
No licenses will be changed, if you configure a date in the past, just the SSA end date of the project!

=====SSA Expiry Mail=====

If project SSA will expire, each company user will receive a reminder mail '''7''' weeks before and
then every week one mail.
You can disable these mails with the checkbox 'Send SSA expiry mails'.
Note that every user can configure, if he wants to receive mails or not in his account settings.

If you want the end user of the project to receive an expiry mail, you can configure a '''reseller''' mail address and end user mail addresses. These end users will then receive an email, 30 days before the project will expire. The default text is:

<code type="text">
Your Software Service Agreement for your innovaphone PBX in project "{$arg[3]}" will expire in {$arg[1]} days.
Please contact your reseller {$arg[2]} to upgrade the license. 
The upgrade of the license is important to secure the phone system!
</code>

You can change this text as you want. You can use placeholders:
* '''{$arg[1]}''': days left
* '''{$arg[2]}''': reseller mail address
* '''{$arg[3]}''': project name
 
You can also define a global text for all projects under your [[Reference:My_Innovaphone#Company | Company settings]].

You can optionally configure to receive project SSA independent reminder mails for each license of a device [[Reference:My_Innovaphone#Company_2|here]].

=====Automatic SSA Extension Service=====

You can request an automatic SSA extension service for a project, which is under SSA. By following this link, you will have the opportunity to request a callback and/or the necessary agreement as PDF file.

All licenses have to be under SSA to use the automatic SSA extension service!

There are some basics to know, if a project is under automatic SSA:
* If you bind new/free licenses, they'll get SSA until the current project SSA date and you will receive an invoice for the SSCs
* If you move devices into this project, their licenses will get SSA until the current project SSA date and you will receive an invoice for the SSCs
* You can't join this project into another project, but you can join another project into this one

====Rights====
=====Own project=====
Add or delete company rights for this project. To add a company right, you have to enter the company id of this company.
Each user of a company with rights on this project can add devices, licenses, activation keys to this specific project, but is restricted in removing devices, editing the project and can't create activation keys with the projects balance.

The company id can be found under Licenses->company and the company tab.

[[Image:Project_rights.jpg|center|thumb|200px|Project rights]]

=====External Project=====
If another company granted access rights to a project to you, you can unsubscribe from this project here.

====Import====
The import has been disabled. All old devices are already imported and can be added to your project manually.

====Join====
Here you can join your currently selected project with another project, which you select from a dropdown box. 
If the other project has SSA, you'll see the current SSA end date, which you might change for the join process and you will get a list of all licenses, which might be updated to the ssa end date/changed date of the other project. The list equals the list shown under [[Reference:My_Innovaphone#Software_Service|Software Service]].

The selected project will be automatically deleted after the join. You can't join a project,
if it grants external rights to another customer. Delete these rights before.

You can't change the SSA end date, if the other project is under automatic SSA! You will receive an invoice for SSCs used for the join.

====Project Move (admin only)====
A company admin can move a project with its devices, activation keys, balance etc. to another company. You have to know the company ID from this company, which can be found under Licenses->Company and the company tab. 
The history won't be moved!

Projects with negative balances can't be moved!

Existing project rights will be deleted.

====Delete====
Delete the project. Only possible if it has no activation keys, project rights, devices or user rights.
 
You may [[Reference:My_Innovaphone#Join|join]] your project into another one, if you can't delete it.

====Project Freed_RMA_licenses====
If you see a project with this name in your project list, you had a RMA device with not yed moved licenses, which was shipped to innovaphone and reshipped to another customer. 
The licenses of such a device have been moved into the pool of free licenses of the project Freed_RMA_licenses, from where you can assign them to another device.

===Balance===
On the balance page you will see the balance of the currently selected project or the balance of all your projects together.
The balance is bound to your company and '''not''' to your user account. The balance is bound to a specific project, but can be shared for license creation or activation key creation if wished. 
Sharing the balance over several projects is not possible in external projects!

[[Image:Balancepage.jpg|center|thumb|200px|Balance page]]

====Free licenses====

Here you see a list of all your free licenses. If you return licenses from one of your devices, the returned licenses are stored in your free licenses pool. You can assign these licenses to another device (see [[#Add licenses from free licenses|'Add licenses from free licenses']]).

[[Image:Balance_free_lics.jpg|center|thumb|200px|Free licenses list]]

The bind date, SSA end date and the external key (like DECT-Multi-Cell-Ari) are stored for each license.

===Activations===

You'll see a list of all your bound activation keys with their licenses here.

[[Image:Activations.jpg|center|thumb|200px|Activation key page]]

====Add an activation key====
To increase your projects balance, select one of your projects, follow the "Add" link and enter the activation key in the corresponding field. You can also enter an optional comment for this key. You will then get a listing of all contained licenses. After commiting this key, your project balance will have been increased by the keys values.

"Deselect the current project" to view all activation keys independent of the selected project.

====Search for an activation key by your order number====
Enter your own order number (or nothing), to view your activation keys for this order.

====License certificate====
You can always download the innovaphone license certificate for activation keys in your projects. Simply press the download link in the list at the right side.

===Own Activations===
Here you'll see a list of all created activation keys in the selected project (or over all projects).

You can create activation keys on the project page for other users/companies or to simply transfer licenses from one project to another. 
You can enter a comment, an order number and an order reference. The '''order number''' is your own order number for the key and the '''order reference''' is the reference number of the customer, who receives the newly created key. 
The order reference and order number will be shown in the innovaphone license certificate.

[[Image:Created_activations.jpg|center|thumb|200px|Created activation keys]]

You have to select an activation key in the activation key list to update or delete it.

Updating and deleting a key is only possible, if this key is not assigned.

====Update====
Add more licenses to this key or change its comment, order number and order reference. 
You can also remove licenses by entering e.g. -2, if you want to remove 2 licenses from the key.

[[Image:Own activations update.jpg|center|thumb|200px|Update own activation keys]]

====Delete====
Delete this key. Its licenses will go back into the balance of the currently selected project.

===Devices===
To view your devices you first have to click on the "Show" button. You can leave the filter field empty if you want to view all your devices.

[[Image:Devices_page.jpg|center|thumb|200px|The Devices Page]]

Red marked device names are devices, which are currently in RMA.

MAC addresses of RMA devices do not longer start with 01-...

====List====
A List of your devices in the currently selected project. 
You can deselect the current project/device to list all your devices.

Select a certain device from the device list, to manage its properties, licenses etc.

Actions on multiple devices:
* Move: move several devices into another project at once (see [[Howto:My_Innovaphone#Move_device|Move Device]])
* Remove: remove several devices at once (see [[Howto:My_Innovaphone#Remove|Remove]])

=====Add=====
Follow the "Add new devices" link on the devices page.

There you have a few options:
* You can add a single new device
* You can add devices according to a mac address range (e.g. from 00-90-33-08-20-00 to 00-90-33-08-22-00), maximum 50 at once
* You can add devices by uploading a text file with mac addresses like this (maximum 50 at once, each line one mac):

00-90-33-08-20-20
00-90-33-08-20-21
00-90-33-08-20-22
00-90-33-24-20-20

* You can add devices according to your received order number. Just enter you order number and you will get a list of all devices bount to this number.

Note: MAC addresses can be always given like this:
* 00-90-33-xx-xx-xx
* 00:90:33:xx:xx:xx
* 009033xxxxxx
* xxxxxx (00-90-33- will then be added automatically)

There might be errors, if you try to add a device. They are explained [[Howto:My_Innovaphone#Image_explanation|here]].

As the device warranty will be handled by licenses now, you can also add telephone devices
to your projects.

=====Add warranty extensions=====

Here you can add warranty extension licenses for all devices in the currently selected project. 
You'll get a list of all devices with the corresponding license type(s) and you can specify the years for each device (or for all devices by entering the number in the list header). 
After confirming your selection, you'll get an overview of all needed licenses, which you have to confirm too.

=====Check licence, SSA and warranty status of a device=====
Here you can list licenses with ssa and the warranty end date of a device, which is not in one of your projects. 
This is just available with the needed right.

=====Download devices of an order as CSV=====
Enter an order number to retrieve all devices for this order in a CSV file.

=====Download devices of an order as PDF with barcodes=====
Enter an order number to retrieve all devices for this order in a PDF file with a barcode for each MAC address. 
Der Barcode ist vom Typ C128B.

====Properties====

Change the name and comment of a device.
You can only change the name, if it's no MAC or IPEI.
 
Here you have also the possibility, to directly request RMA for this device with prefilled values.

====Licenses====
Here you can add, download or move licenses.

=====Add licenses from balance=====
To create new licenses for a device, you have to add this device first on the devices page and then select a version of the license
and whether you want to summate the current licencing. If you select current licenses, then older licenses for example V6 or V7 licenses will also be counted as V8 licenses in the next overview. This is necessary if you want to license a V6 unit with V8 licenses, but still want to use it as V6.
After that click "Next".
On the next page you will see a list of all available license types, which depends on your current available license types, of the selected license version and the device type (IP6000, IP800 e.g.):
[[Image:licenses.jpg|center|thumb|200px|Licenses for an IP3000]]
 
If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses to this SSA end date or you can optionally change this date to another one for the new licenses.
 
You see the available project balance, the balance over all projects (excluding external projects), the currently installed licenses and the maximum amount for this device type. You can now enter the value of the new license.
Base/Upgrade licenses can be selected via dropdown box.
'''Voicemail and Standby lics must always have the same amount as the selected PBX-PBX... license!
The maximum amount of PBX-Registration licenses equals the amount of the selected PBX-PBX... license!'''

The whished overall amount of pbx version 8 and above licenses can be specified here and the concrete amount of license sub types will be requested on the next page.

You can preview the SSC calculation of the wished licenses without having them in your balance.

[[Image:licenses2.jpg|center|thumb|200px|Licenses for an IP800 with V8, step two]]

The best (cheapest) combination of each v8 pbx license type is already filled in, but you might change the amount of sub types if your does not fit and you do not want to purchase new activation keys for the sub types.

The column SSC/Unit is just shown if your project is currently under SSA and you have entered a SSA end date.

The SSC multiplicator is the value, which you have to multiplicate with each license unit to get
the corresponding SSC amount.
E.g. if you have 20 units of PBX-Port8*20 licenses with a SSC value of 54 and a multiplicator of
1.0000 (which equals to 365 days) you have to pay 20*54*1.0000 ~ 1080 SSCs.

 If you create licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the currently selected version twice. 
e.g.: you want to bind licenses for V6 with SSA, so you have to pay SSCs from the release date of V7
 You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

You can't change the SSA end date, if the project is under automatic SSA! You will receive an invoice for SSCs used for the new binding.

Now confirm your new selection. If you have not enough licenses in your current project, but there are still licenses in other projects, you will get a dropdown box with a list of all projects containing the needed licenses. You can now select all desired/needed projects and confirm your selection again.
The balance of all selected projects will then be decreased by the needed amount.
 
 
If your user account has the right to buy licenses on credit, just check the checkbox.
 
You may enter an order number, which you can use for your order, if you buy on credit.

=====Add licenses from free licenses=====

Here you can assign licenses, which you returned from other devices.
You will also have to select the desired version and will than get a list of fitting licenses according to the current device and selected version.

[[Image:licenses_free.jpg|center|thumb|200px|Free Licenses for an IP800 with V8]]

If a license is under SSA, the correct license type is shown in column 'License Type' besides the 'Original Type'.
On confirming the selection, a consistency check is done (e.g. only 4 Relay-PRI licenses on an IP6000).
Bind and SSA end date will be maintained for each license.

As external keys are also maintained, you can select e.g. an old Dect-Multicell-Ari license to have the same ARI on another IP1200.
 

If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses
to this SSA end date or you can optionally change this date to another one for the new licenses.
You will have to confirm this after your first license selection (this is the same calculation as [[Reference:My_Innovaphone#Software_Service|here]]).

You can't change the SSA end date, if the project is under automatic SSA! You will receive an invoice for SSCs used for the binding.

=====Add V7 floating license (slave pbx)=====
Here you can add a V7 floating license for a slave pbx. A device with a floating license can't have V7 pbx licenses and a device with V7 pbx licenses can't have a floating license.

=====Delete V7 floating license=====
Here you can delete an already existing floating license, if you won't use it anymore.

=====Add warranty extension licenses=====
Extend your warranty by adding warranty extension licenses:

[[Image:add_warranty.jpg|center|thumb|200px|Warranty extension]]

If you add the warranty extension immediately after the receipt of your device,
you can add the cheaper warranty extension licenses, otherwise you'll have to add
the more expensive ones.

You can extend the warranty for a maximum of four years.

=====Download licenses=====

[[Image:Device_download.jpg|center|thumb|200px|Download Licenses]]

You will get a dropdown with all available versions. Versions are dependent of your device, your licenses and of the ssa of your licenses. 
'''From V9 on''', you just have one option, which will create a license file, which contains the licenses upgraded to the highest version of their type. 
You are able to download downgraded versions of your licenses. E.g. if you have only V8 licenses, you can download a V7 license file (same restrictions as below).

Downgrades or only possible down to version 6!

If you do not want to download licenses by version, you have to decide whether to download the licenses encrypted or not.
'''If you download the licenses unencrypted, you won't be able to return those licenses anymore.'''
So you won't be able to return licenses for devices with V5-V7 licenses, as licenses for these versions are not encrypted.
To return these licenses, you will have to upgrade to a new bootcode, which prevents firmware downgrades to versions below version 8. 
Encrypted licenses are stored in a xml file, which you can then upload on your V8 (or higher) device.

You can now also download licenses directly from by the web interface of a device.
You just have to enter your account data and start downloading the licenses from my.innovaphone.com
without having to download/upload a license file.

=====Download test licenses=====

[[Image:Device_download_test.jpg|center|thumb|200px|Download test licenses]]

You can also download test licenses if you want to run tests. You will be asked, which version you want to use, whether the device is used as slave and if not used as slave, how many pbx licenses you want to use.

V5 does '''not''' support test licenses!

=====Move licenses to another device=====
If you have the needed account rights or the device is already in RMA, you can move licenses to another device. After moving licenses, the former device will be marked as a RMA device.

You can just move licenses to devices without licenses!

====Move device====
Here you can move the current device or the selected devices to another project. 
If you select a SSA project, you can change the SSA end date for the move process. 

If the other project is under SSA, you will first see a SSC calculation, which you have to confirm,
as the SSA date for each SSA license will be extended until the given SSA end date
(this is the same calculation as adding SSA to an already existing project, see [[Reference:My_Innovaphone#Software_Service|here]]).

You can't change the SSA end date, if the other project is under automatic SSA! You will receive an invoice for SSCs used for the move.

====Invalidation====

=====Requirements=====
* V8 or higher
* access to the webinteraface
* a device certificate
* my.innovaphone login credentials
* '''no IPVA device'''

=====Informations=====

You can invalidate V8 (or higher) licenses by uploading the XML file, you got from your device or by returning your licenses over the web interface of your device ([[Reference8:Configuration/General/License]]), in order to return [[Reference8:Licenses#Gateway_Licenses|PBX licenses]] back to the balance.

V7 licenses can be just returned, if you agree, that you won't be able to downgrade below V8 anymore. You will need a new bootcode, to use this function. '''You need a V8 firmware or higher for invalidation.'''

If your device has access to my.innovaphone.com, you can also invalidate licenses directly
from the web interface of the device.

[[Reference8:Licenses#Gateway_Licenses|gateway licenses]] and warranty extensions won't be returned to the balance and remain to be assigned to the device!

The licenses needn't be present on the local device to perform the invalidation!

SSA it's bound to the license and it's not lost when performing invalidation.

=====Process=====

Steps to invalidate licenses, if your device has internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# enter your my.innovaphone account, the device must be in one of your projects
# click Invalidate
# click Transfer (this might fail, if NTP or DNS is not configured properly or device certificate is not installed)
# reset if asked for

Steps to invalidate licenses, if your device has no internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# click Invalidate
# click Backup and upload this file on my.innovaphone [[Reference:My_Innovaphone#Upload_the_invalidation_document_to_return_licenses|here]]
# you'll get a confirmation file after uploading the saved file
# upload this on the device (under Step1)
# reset if asked for

"Your IP800 does not have a device certificate on it." - In this case you need to download a hardware certification,
please contact the innovaphone [mailto:license@innovaphone.com license].

=====Download confirmation file=====
If you created a new certificate or you invalidated your licenses, you can later download the confirmation file, which you have to upload on the box.

=====Request certificate=====
If you have the needed rights, you can request a new device certificate for your device.

=====Upload the invalidation document to return licenses=====
Upload the invalidation document, which you got from the website of the device to return the licenses of this device.

After uploading you'll get a confirmation file, which you have to upload on your device.

====Remove====
You can always remove devices from a project. If they have licenses, these won't be deleted, so you might add the device to another project again.

===History===
[[Image:history.jpg|center|thumb|200px|History page]]
You can view your history for several contexts:
* Company: history of all actions in your company
* User: history of all actions of the selected user
* Device: history of all actions for the selected device

Each context applies to the currently selected project.
If you deselect the current project, you will see the history over all projects.

You can select to view the history of the last day, week, month, year or from always. Collecting data might take a while...

===Company===
Manage users, import other companies or change your company data.
The first user of a company has automatically company admin rights and can grant this right to other company users after adding their accounts email address. 

====Users====

[[Image:company.jpg|center|thumb|200px|Company page]]
Here you can add other users to your company, optionally with '''company admin rights'''.
You can also '''lock''' a user account or grant company admin rights. 
Locked users can't loggin to my.innovaphone.com any more. 
Instead of locking a user you can also '''remove''' this user from your company. The user itself will still have his my.innovaphone account, but won't belong to your company any more. The history of this user is still available after having removed him.

Non company admin users just get a non editable list of the current company users.

A user can be member of several companies and the users rights, company admin and
locked status can be different for all companies, where this user is in.

=====My innovaphone Viewer=====
If you check this flag for a user, this user won't be able to do any changes to your projects, devices and licenses. He will be just able to view projects, devices, SSA settings etc.

====Join (admin only)====
As admin you can also join another company into your company by entering an admin account of this company. This might be usefull if one user of your company has accidentally created an own company. 
Everything like projects, users, devices, balance, activations etc. will be imported! 
You also have to enter the company id of the company, which is to be imported. You can find this company under Licenses->Company and the company tab.

This is not available for non company admin users.

The joined company will be deleted afterwards!

====Company====
If you do not belong to a my innovaphone company, you can create one here. You can optionally enter an innovaphone account ID with its zip code or you just enter your company data below.

[[Image:company_create.jpg|center|thumb|200px|Company create page]]

Otherwise you can change your company data, but only, if you didn't created your company with your innovaphone account id. In this case, company information is always retrieved from your innovaphone account.
Non company admin users can just view the current company data.

You also see your company id here, which is sometimes needed for adding external project rights or
to be imported by another company.

You can check the '''Device SSA''' checkbox, if you want to receive SSA expiry reminder mails for each device independent of the projects SSA end date.
These mails will be send weekly seven weeks before the SSA for a license a the device expires.
 
 
You can also enter additional email addresses, which should receive SSA emails.
 
You can define a global '''end user expiry mail text''' here, which will be sent to end users, if end users are configured in a [[Reference:My_Innovaphone#SSA_Expiry_Mail | project]]. This text can be overridden by a text in a project under [[Reference:My_Innovaphone#SSA_Expiry_Mail | SSA Expiry Mail]].

====Partner Status====
You can review the partner status of the users of your company. 
You also see a list of companies, which granted partner status access to you.

=====Manage Partner Status Access=====
Grant or remove access rights to your own partner status. 
You can enter the [[ Reference:My_Innovaphone#Company_2 | company ID ]] of another my.innovaphone company. Afterwards, this company will have access to '''your''' partner status.

====New Company====
If you need several companies for some reasons, you can create another one here. 
You will be an admin user in this new company and you can directly select the newly created company at the top right corner.

==RMA==
Here you can see all your RMA devices, which arrived innovaphone already. The licenses of this macadresses are moveable.
[[Image:rma.jpg|center|thumb|200px|RMA page]]
 
If you want to request RMA for a certain device, go to the device properties and follow the "Request RMA" link.

==Support==
===Mantis===
Here you'll get a list of all open support cases in our mantis system, which are assigned to email addresses of your my.innovaphone users in your company.

===Announcements===
You can convert audio files into G.7xx files which you can use as announcements. 
 
;Supported input formats:
* mp3
* wav
* ogg
* flac
* ...

;Generated output formats:
* G.711u
* G.711a
* G.729
* G.723
* G.722

==Configurator==
Currently this is just a link to the [http://config.innovaphone.com innovaphone PBX Configurator]

==Account==
Here you can change your personal data, password etc. You always have to enter your current password to change your data. 
You can also configure, if you want to receive SSA expiry mails!

If you change your email address, you'll have to activate your account again.

==Company selection==
If your user account belongs to several companies, you can switch between companies be using the dropdown box at the top right corner of the page. 
You'll get an error, if you try to switch to a company, where your account is locked. 

[[Image:company_selection.jpg|center|thumb|200px|Dropdown box for company selection]]

 
If you loggin, the first found company is selected for your user.

==Image explanation==

===Errors===

====Already In Company====
[[Image:Icon_in_company_inno_01.png]]
* This device already exists in your company and can't be added/imported.
If you want to import this device anyway, you first have to delete your current device from its project.

====Already Imported====
[[Image:Icon_imported_inno_01.png]]
* This device has been already imported.
You can't import it again.

====Not Found====
[[Image:Icon_not_found_inno_01.png]]
* This device was not found in the my innovaphone database.
This should never happen, but if, contact the administrator.

====IPVA MAC exists====
[[Image:Icon_ip_va_exists_inno_01.png]]
* An IPVA MAC address must be unique and can be assigned to just one company. You tried to add an already existing IPVA MAC.
Please assign a new one to your IPVA. For further details, see [[Reference9:Concept_Innovaphone_Virtual_Appliance#License_Configuration]].

===Warnings===

====Several Companies====
[[Image:Icon_several_companies_inno_01.png]]
* This device is already in another company.
This means, that either you do not have the physical device or it once belonged another company.
You can still import/add this device and you will have access to all of its current licenses.

====Several Users====
[[Image:Icon several users inno 01.png]]
* This device has licenses from several users of the old license manager.
This means, that you are not neccessarily the user, who physically owns this device. If you do not own it, do not import it.

===Misc===
====No downgrade====
[[Image:no_downgrade.png]]
* Licenses, which have been downloaded for V5/V6/V7, were returned from this device, so no downgrade to these versions is allowed any more.



==Release dates==
V5: January 1st 2003 
V6: November 2nd 2006 
V7: November 14th 2008 
V8: December 7th 2009 
V9: April 26th 2011 
V10: July 8th 2013 
V11: February 9th 2015 
V12: July 11th 2016 



==External interface==

There is an external interface, which you can use to control some functionality without a login to the my.innovaphone web site. 
You can use the interface with an '''HTTP GET''' request to the following URL: 
 
'''<code>https://my.innovaphone.com/interface.php</code>'''

===General parameters for all commands===
:;cmd: the wished command
:;email: the email address of a user who is registered in my.innovaphone
:;project_id: the project ID of the project where the user has access to (you can find the project ID under [[Reference:My_Innovaphone#Properties | Licenses->Projects->Properties]])
:;hash: an SHA256 hash value which is computed over all GET parameters but the hash parameter itself plus the '''trust''' value of the project (see [[Reference:My_Innovaphone#Properties]])
:;hash: the values of the GET parameters have to be URL encoded before calculation of the hash

;Example: URL <code>https://my.innovaphone.com/interface.php?cmd=addDevice&email=user@example.com&project_id=123456&serial=00-90-33-01-02-03&hash=b62f7948d6383cc365592ed289b6173cd35229cadc347847b953f78c8880d5b9</code>
:;project trust value: 1234567890abcdef
:;the data of the SHA256 hash: ?cmd=addDevice&email=user%40example.com&project_id=123456&serial=00-90-33-01-02-03&trust=1234567890abcdef
:;example PHP function call to generate the hash: hash("sha256", "?cmd=addDevice&email=user%40example.com&project_id=123456&serial=00-90-33-01-02-03&trust=1234567890abcdef");
:;with the current values, the function should return: b62f7948d6383cc365592ed289b6173cd35229cadc347847b953f78c8880d5b9

===Add a device to a project===
;HTTP GET parameters:
:;general parameters
:;cmd: '''addDevice'''
:;serial: the serial number of the device, e.g. 00-90-33-01-02-03

;Return value: a JSON object is returned
:;success: boolean, either '''true''' or '''false'''
:;error: string, a string with an error. Just existent if success is false
:;example success: <code type="javascript">{ "success":true }</code>
:;example error: <code type="javascript">{ "success":false, "error":"the project with ID 123456 doesn't exist" }</code>

===Get the warranty of a device===
;HTTP GET parameters:
:;general parameters
:;cmd: '''getWarranty'''
:;serial: the serial number of the device, e.g. 00-90-33-01-02-03

;Return value: a JSON object is returned
:;success: boolean, either '''true''' or '''false'''
:;error: string, a string with an error. Just existent if success is false
:;warranty: a unix timestamp in seconds sind 1970 (timezone Europe/Berlin), e.g. '''1448492400'''
:;warrantyStr: a string like '''"2015-11-26 00:00:00"'''

==Known Issues==
===Smaller issues===
* Devices where imported into a project with SSA. If this happened to you, please move the corresponding devices into a project '''without''' SSA and back into the project '''with''' SSA to extend/add SSA for the licenses until the SSA end date.
* IE7 moves a list under the menu, when a list becomes to wide
===Licenses don't work on a device, where an invalidation has been done===
A possible reason here is, that the invalidation process hasn't been completed.
To resolve this issue, follow these steps:

* Download the Confirmation File (Certificate) from http://my.innovaphone.com under [[Reference:My_Innovaphone#Invalidation|Invalidation]] after selecting the project and the device
* Open [[Reference9:General/License/my.innovaphone|General->License->my.innovaphone.com]] on your device
* Click on "Invalidate" (no my.innovaphone credentials needed)
* Upload the previously downloaded confirmation file newcert-00-90-33-xx-xx-xx.xml as "Confirmation file"
* Reset the box
* Reupload the licenses

Howto:Feature List in English

2016-03-24T10:37:04Z

Kti: /* Applies to */

innovaphone feature list


==Applies to==

This information applies to

- All innovaphone products based on V7, V8, V9 and V10

Starting with V11, this list is discontinued. PBX feature documentation is available via the [https://www.innovaphone.com/en/services/downloads/data-sheets.html innovaphone homepage].



==More information==

=== PBX System Features ===

* Access to exchange via group number
* Access to separate exchange via individual number
* ACD groups
* Active Directory Replication
* Administration via uniform interface
* Alarm and error events
* Alternate route selection
* Announcement before pickup (*)
* Announcements (*)
* Authorisation groups (class of service)
* Automatic break through for call protection for preferred numbers
* Automatic call distribution (ACD)
* Automatic night switching with week clock
* Automatic route selection (ARS)
* Bootcode with minifirmware (not supported with IP3000)
* Branches (virtual central PBX)
* Bunched circuit
* Call back
* Call back also if internal call
* Call detail records (CDR)
* Calling line identification restriction (CLIR)
* Calling party identification (CLIP)
* Calling to E.164
* Calling via ENUM (H.323 and SIP)
* centralized backup /firmware/config upload
* Circle call with circle call query (#)
* Clock synchronization via IP
* Config templates for PBX User
* Configurable tones
* Configure / change / delete call diversion via web
* Conversation return to operator
* Cross connection via IP
* Cross connection via ISDN
* Different call (external, internal)
* Direct dial (with and without number reassessment)
* Door bell interface with door opener function (#)
* DTMF detection disabling
* DTMF-post dial/direct dial
* Emigration of endpoint
* Enhanced error reporting (SIP, QOS parameter, router error reporting)
* Enhanced H.323 features according to H.450.x
* Extended DTMF Object (feature set via DTMF dial)
* External communication
* Firmware upload in DRAM (not supported with IP3000)
* Floating license model
* Flexible dial plan
* General night switching
* Group call (all, circular)
* Hide Objects from LDAP
* Home office integration
* HTTP/ HTTPS allowed stations
* Incoming direct call to subscriber or group
* Interactive call acceptance (*)
* Interface for external announcement construction (#)
* Internal communication
* Internal music on hold
* Least cost routing (LCR)
* Log forwarding
* LDAP replication
* Message center (H.450.7 or DTMF)
* Message Waiting Indication (MWI)
* Messaging (SIP and H.323)
* Mixed dial method (overlap and en-block dialing)
* MS-chap V1/V2
* Multi conferencing (IP800, IP6000, IP0010, IP1060, IP3010, IP6010)
* Multi protocol (H.323, SIP)
* Multilevel admin access (detailed multilevel user rights for the PBX configuration)
* Multiple system admin (multiple admin and viewer rights possible for the whole system)
* Multistage login (multi-user)
* Music / announcement in standby from analogue resource (#)
* Music / announcement in standby from HTTP resource (*)
* Network wide features (Master/slave with virtual PBX)
* Only calling to registered subscribers (passive control)
* Overflow of subscribers and cross connection
* Overlapped sending
* PBX directory search (LDAP search via DTMF)
* Phonebook either from internal or from external source (LDAP)
* QSIG
* QSIG inter-working
* QSIG trunking (point to point and point to multipoint)
* Redundancy of the ISDN-lines
* Redundancy of the PBX
* Remote monitoring and remote diagnostics
* Remote software upgrade
* RTP Proxy
* SDP Transit (for video and other codecs)
* Short dial (individual, group, system wide)
* Silent intrusion
* SIP/H.323 Media Relay (RTP stream routing via gateway)
* SIP trunking
* SIP via TCP
* SIPS (SIP-Secure) – SIP via TCP/TLS (not supported with IP3000)
* SNMP Traps (alarm events)
* SOAP-API
* SRTP (Voice encryption) for H.323 and SIP (not supported with IP3000)
* Subscriber authorisation
* Standard protocols to the endpoint
* Subscriber groups with progressive call (parallel, circular, sequential)
* Switch between day/night with code digit from subscribers
* System time/date via timeserver (LAN or web)
* TAPI / Multi line TAPI (via several PBX’s / locations)
* Telephone number assignment
* Time based subscriber authorisation
* Twin Phones
* US standard (T1 and CAS)
* VoIP-CAPI
* Waiting queue – call busy operators / CFU disable operators
* 802.1x
* Active Directory Replication/More detail information in error situations

==== New in V8 ====
* Announcing the queue position in a waiting queue
* Call completion on busy/free to ISDN
* Customized Visual Appearance (individually designable user interface)
* Dual Forking (OCS compatible)
* Dynamic PBX (more PBXs on one Device ) PBX hosting / PBX virtualization
* Kerberos based authentication and Cross Realm authentication
* Mobility (GSM integration)
** Call-waiting
** hold
** transfer
** park
** group login/logout
** mobility on/off
** setting presence status

* Off load Dialtone (external gateway)
* Off load Media Relay (external gateway)
* Off load MOH (external gateway)
* Presence
* Recording at the ISDN and analogue interfaces
* Roaming Phone Profiles
* RSTP (Rapid Spanning Tree)
* Send Message to group
* SIP error detection (alarm/event updated)
* SIP Federation
* SIP video multisite support

====New in V9====
* Executive/secretary enhancements
** Secretary can initiate calls with the CLIP from the executive.
** Executive can see if the secretary is joined or unjoined in the primary secretary group.
** Executive sees if a call diversion is set at the secretary.
** Breakthrough disabled call waiting at secretary.

* Reporting
** Based on internal or external Linux Application Platform
** Based on PBX CDR´s
** Predefined filter
** Reports (export as PDF, XML) from filter, combined filter, date and time

* Emergency calls priority
* Import/Export PBX user database (CSV/XML)
* Individual MOH (context sensitive based on object, node or PBX)
* IP filter for registrations with or without password
* IPv6 support (IPv6 routing, 6to4 routing and http access, telnet)
* LDAP via TLS
* MTLS
* NTP redundancy
* Partnerkeys via separate Pbx´s
* Wideband audio
* Enhanced Boolean (call forward, filter and diversion filter) based also on date
* Maximum call duration

==== New in V10 ====
* Show video calls on page PBX/Calls
* Show video capability of registrations on page PBX/Registrations
* Tone type for PBX generated tones (e.g. for Mobility) configurable
* Explicit assignement of licenses to users
* Server based myPBX call lists included with myPBX licenses at no extra charge
* per user Voicemail license scheme
* Support for cloud setup
* Ability to correct calendar-driven presence information manually
* 'do-not-disturb' presence
* Support for Mobility client using data for call-control features (hold, retrieve etc.)
* configurable default visibility (presence/dialog) for group members
* Disconnect other ringing endpoints if call is rejected on one in a twin-phone configuration
* Broadcast Conference object supports chat conferences
* Offload-able media interface for voicemail (Hosting)
* Waiting Queue supports mobile operators
* Conditional Mobility/Forking (via ''Boolean'' object)
* Kerberos with AES (Windows 2008R2 compatibility)

===Features IP Phones – IP110 / IP200 / IP230 / IP240 / IP240-1000 / IP241 / IP222 / IP232===
* Adjustable loudness
* Adjustable ringing tones also possible, import RTTTL and midi files
* Alphanumeric phonebook
* Announcement via loudspeaker
* Automatic callback on busy and free
* Automatic redialing
* Automatic redialing to busy bunched circuit
* Blind transfer
* Call diversion to internal phone number
* Call hold / retrieve call diversion to external phone number
* Call intrusion
* Call list (outgoing, incoming, combined, not reached, not answered)
* Call park and enquiry from other subscribers
* Call prevention
* Call transfer / pickup (selective and from a group)
* Call waiting (acoustical and optical signaling of waiting calls)
* Caller identification (name/number)
* Changeover of the assigned partners
* Conference (3 way)
* Configuration of the voice recording via HTTP
* Connect to busy and free subscribers without notification
* Counter and list of missed calls
* Date and time display (automatic summer/winter time adjustment)
* Delete call back
* Delete variable call diversion
* Dialing an IP address (with and without RAS)
* Dialing with code key from an unauthorized phone
* Direct dialing (immediate, internal/external)
* Display duration of call
* Display calling number
* Emigration of subscriber/endpoint
* Fixed call diversion (unconditional, no answer (time adjustable) on busy)
* Forced announcement (priority call)
* Function keys – multitude possible – exact list can be found in the technical specification of each IP phone
* Hands free
* Headset
* Individual configuration
* Individual phonebook
* Intercom with automatic call pick up
* Interlinked and limitless multiple conference
* Manager/assistant feature
* Message waiting indication (MWI)
* Messaging
* Multi language
* Multi-protocol and multi-registration (SIP and H.323 concurrent)
* Multiple registrations with selective de-registration
* Mute (switch off the microphone)
* Name dialing
* Open listening
* Over plugging (connect call to a busy subscriber)
* Phone lock
* Preferred subscribers
* Project code
* Redialing of the last 100 dialed numbers
* Silent Intrusion
* SIP via TCP
* SIPS (Secure SIP via TCP/TLS)
* SRTP (SIP and H.323)
* Status indication of the subscriber (free/busy/call)
* Subscriber with several lines
* Subscriber with several numbers
* Transfer with consultation
* Variable call diversion
* 802.1x

==== New in V9 ====
* Colour display (IP241 / IP222 / IP232)
* Individual background picture (IP241 / IP222 / IP232)
* Individual audible signal for announcement calls /multicast announcements and messaging
* 802.3az (IP222 / IP232)
* Wideband audio (IP222 / IP232)

==== New in V10 ====
* Russian and Slovenian languages

===Features 3rd party Phones connected to analogue (POTS) port, DECT Phones IP52 / IP54 / IP55 / IP61 / IP63 / IP65 ===
* Call completion on busy
* Call completion on free
* Call diversion to internal/external number
* Call hold/retrieve
* Call park and enquiry from other subscribers
* Call protection
* Call transfer/pickup (selective and from a group)
* Call waiting (acoustic signalling of the waiting call)
* Clip to an analogue phone
* Confirmation tone (positive and negative)
* Connect to a free and busy subscriber without notification
* Delete variable call diversion
* Dial with code key from an unauthorized phone
* Direct dial immediate (internal, external)
* Do not disturb (internal and external calls)
* Fixed call diversion; unconditional, no answer (time adjustable), on busy
* Lock phone
* Message Waiting Indication (MWI) on DECT Phones
* Preferred subscriber
* Project code
* Special tone when active feature
* Transfer with consultation

==== New in V10 ====
* DECT: pass the DECT Security certification

===Features innovaphone Voice mail (*)===
* ''Languages supported: German / English / Italian / French / Dutch / Spanish / Norwegian / Danish / Polish /Swedish / Czech – additional languages on demand.''
* ''Voicemail runs on Compact Flash (CF slot in IP800, IP305, IP302, IP2000, IP6000, IP1060, IP3010, IP6010) or on external Web Server''
* Email notification (with or without attachment)
* Listen to/delete /store voice mails by means of DTMF input
* MWI (according to H.450.7)
* Personal greeting message
* Voice recording

==== New in V9 ====
* Voicemail support SRTP

=== Features myPBX ===
UC client (myPBX) web-based and Windows launcher
* ''Languages supported: Danish / English / Estonian / Finnish / French / Italian / Latvian / Dutch / Norwegian / Polish / Portuguese / Spanish / Swedish / Czech – additional languages on demand.''
** CTI (initiate call, accept call, terminate call, hold call, retrieve call, transfer call, park call, 3PTY conference)
** Manage own call diversions
** Call list
** Presence (manage own presence state)
** Buddylist (including partners presence and call status)
** Chat (multiparty chat)
** Audioconference (via innovaphone audio conference Interface)
** Videoconferece (via integration of Webex or Microsoft Livemeeting)
** Application sharing (via integration of Webex or Microsoft Livemeeting)

==== New in V10 ====
* Improved usability, new look, single-window design
* Intuitive LDAP search (arbitrary search string input, results from different sources are merged)
* Possibility to display additional info from the directory in the LDAP search
* Support for LDAPS (LDAP over TLS)
* Improved instant messaging (subject, list of participants, messages are received before the chat is accepted, window can be closed and opened again without terminating the session)
* Simplified call diversion configuration (synchonized with the favourite call diversions on the phone)
* Simplified visibility settings
* Do not disturb (new presence activity, chats are rejected if DND is set)
* Pickup calls from favourites
* Unpark calls from favourites
* Unlimited length of call list (using a paging mechanism).
* Configure language in launcher
* Translated launcher user interface
* Auto appear offline, after an idle timeout that can be configured in the launcher
* MSI-Parameters for deployment of the launcher
* Launcher can dock to the left or right screen border
* Launcher can write trace files for debugging purposes and support
* Audio conferencing from the chat window has been removed
* Desktop notifications and notification sounds for calls and instant messaging. Accept and reject calls directly from the notification window. Visibility requests using desktop notifications.
* Configure mobility
* Tool that dials or starts chats in myPBX. This tool is registered in windows as an handler for tel: sip: and im: URIs.
* Display diverting info at incoming alerting calls
* Display causes at disconnecting calls
*Video calls between two myPBX Launchers is now possible (runs on Windows 7 and Windows 8, see [[Reference10:Concept myPBX Video]] for details)
*3 party Video conference
*Webcam selection if several webcams present
*Webcam preview of the selected webcam
*Webcam menu to control settings like brightness or contrast. Adjustable at webcam preview or even during the video call
*Webcam is configured to deliver 352x288 or 320x240 resolutions and the maximun frame rate available, usually 30 fps
*H264 encoder configured to deliver an average rate of 250 kbps
*H264 video stream compatible with other vendors like LifeSize or Polycom

=== Microsoft Office 2010/2013 integration (introduced in V10) ===
allows to see the presence of a user inside a Microsoft Office 2010 application
* Presence visibility inside an Office application
* Start of a chat from inside an Office application
* Start of a call from inside an Office application

=== Exchange Calender Connector (introduced in V10) ===
Replicates Exchange Calendar information to PBX user presence
(Linux Application Platform)
* Presence is set to busy during calendar appointments
* The appointment subject is provided as presence note
* later appointments the same day are indicated as presence note, if presence is 'available'

=== Fax Server (introduced in V10)===
(Linux Application Platform)
* email-to-fax and fax-to-email gateway
* Each PBX user has an own fax number: personal fax
* Fax source formats
** plain text
** HTML
** PDF files
** all other file formats which can be converted by OpenOffice
* Cover page
* e-mail delivery/non-delivery report
* Incoming fax documents delivered as PDF

===Features Operator (V8) software based===
* ''Localized versions: German / English / Italian / Dutch – additional languages on demand''
* Busylampfield (divided into groups)
* Call journal
* Call transfer (with/without consultation (blind))
* Drag&Drop or with keypad use
* Integrated help
* Monitor blind transferred calls
* Monitor of waiting queue
* Name display for incoming calls in LDAP directory
* Park/unpark
* Send messages to PBX users
* Searching within a LDAP directory
* Searching for PBX users in all PBX´s
* Set/change call forward for all PBX users
* Set/change presence status for all PBX users
* Show busy state
* Show call forward
* Show current call
* Show presence status
* State-of-the-art user interface
* Support of Master/Slave scenarios

===Features Interactive Voice Response (IVR) (*)===
* Call handling according to lines and/or calling number (CLI)
* Listen to the menu also from internal subscribers
* Multi level menu
* Overflow from the operator to an automatic operator
* Voice menu at extension (if no answer, busy, unconditional)
* Voice menu with information and automatic dialing
* Voice menu with predefined destinations
* Voice menu with manual dialing of the destination (DTMF)

==== New in V8====
* Announcing the queue position in a waiting queue

* Note:
* (*) External or internal (CF-card) web server required
* (#) innovaphone IP21 required

== Related Information ==
[[Reference10:Concept_Phone_Firmware_10]]

See the [http://www.innovaphone.com/en/services/downloads.html ''Downloads'' section on www.innovaphone.com] for further information

[[Howto:Feature Liste in Deutsch]]

[[Category:News|{{PAGENAME}}]]
[[Category:Features|{{PAGENAME}}]]

Reference:My Innovaphone

2015-02-18T09:47:23Z

Kti: /* Release dates */

==About==
My innovaphone replaces the former license manager.
It will also include the handling of device warranty and software service agreements (only partially implemented yet).

===Project-View===
My innovaphone offers the possibility for several users to be in one company. This company shares its balance of licenses over all users and can have several projects. Projects have their own balance of license types and devices are bound to a project.

===Language===
My innovaphone will support multiple languages. You can select your desired language at the top of the page. 
Currently supported languages:
* English
* German
* Italian
* Dutch
* French

===Guides===

====Quickstart guide====
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_nl.pdf Dutch quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_en.pdf English quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_fr.pdf French quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_de.pdf German quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_it.pdf Italian quickstart guide] 

====SSA guide====
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_en.pdf English SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_fr.pdf French SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_de.pdf German SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_it.pdf Italian SSA guide] 

==First steps==
Open [https://my.innovaphone.com my.innovaphone.com] and click the "Register Now" link.
Enter your personal data and register.

You will receive a registration email with an activation link.
After account activation you have two options:
* create a new my innovaphone company (under Licenses->Company)
* ask another user of your company to add your user account to an already existing company

If you accidentally created an own my innovaphone company, just ask another user of your company to import your just created company.

If you create a new company, you can '''optionally''' enter your innovaphone account ID (which is your customer number with innovaphone) with your postal code, to retrieve your company data.

You will see a help link at the right side of the horizontal tab menu.
This link shows the corresponding text of the wiki section, when hovering with the mouse over it,
and redirects to the corresponding wiki menu, if clicked.

It is now possible, that one user is member of serveral companies!

==Search==
At the right top of the page you have a search field. You can search for different things:
* Devices (part of a device name or device comment)
* Projects (part of a project name or project description)
* Own activation keys (part of an activation key or its description)

You have to enter at least '''three''' chars to start a search. To search for activation keys,
you have to enter at least '''five''' chars.
* Search for license types. Enter e.g. "PBX-Port8" to find all devices with Port8 licenses or enter "PBX-Port8=100" to find all devices with Port8 licenses '''>=''' 100.

==Licenses==
===Projects===
After creation of an own company, you will have a default project named "DEFAULT". You can rename this project later.
You can also create more projects on the projects page with "Create".
Each project of a company must have a unique name.

Do '''not''' set SSA, if you want to import your devices from your old license manager account first.
If you want SSA and you '''won't import''' devices into this project from your old account, you should set SSA at once.

You can select a certain project by activating it in the project list. This selection is then true for all other pages, as some pages require a selected project.

[[Image:overview.jpg|center|thumb|200px|Projects page]]

By activating a project by clicking on the project name in the project list, you can manage this project and its settings.

====Properties====
Rename the project or/and change its description. 
 
Since version 10, an innovaphone device will automatically connect to http://config.innovaphone.com/init
This script looks at the project properties of the project, where the device exists. 
You can configure an update '''URL''' and a '''trusted certificate'''.

====Software Service====
You can put your project under SSA (software service agreement).
You will be asked to enter a SSA end date. This will be the date, where all SSA licenses of all devices in this project will expire.
The end date mustn't be more than one year in the past. 
Optionally you can enter a maximum SSC amount. The SSA end date will be automatically calculated then. 
If you have entered a maximum SSC amount, you have to use the '''Recalculate''' link to calculate a new SSA end date,
if you change your license selection.
 
You can also calculate SSA over all projects at once. In this mode, you '''won't be able''' to confirm the calculation. You'll just see the necessary SSC amount.

After entering a date/SSC amount, you will get a summary of all licenses, which will be put under SSA and the amount of needed SSC licenses.
The SSC value for each license is calculated by the bind date of the license and the entered SSA end date/SSC amount.

[[Image:Ssa_extend.jpg|center|thumb|200px|SSA summary]]

If you have licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the current license version. 

e.g. you have a V7 PBX-PBX7#15 license with bind date 1/1/2010. Version 8 was released on 7/12/2009, so SSA is
calculated from 7/12/2009 for this license. You will see the calculation date in the list under "bind date"

If licenses already have a SSA date, just the difference between the current SSA date and the entered SSA end date must be paid.
If the bind date of the device lies in the past, the difference between the bind date and the current date must be paided twice (this is the column 'days*2'). 
If your license is under SSA, which is already over, you also have to pay the time between the old SSA date and the current SSA end date twice.

Here is a short example, how the days are calculated:

Bind date: 24/06/2009 
Current date: 31/08/2009 
SSA end date: 12/12/2011 
 
You will have to pay from 24/06/2009 to 31/08/2009 twice for 68 days.
From 31/08/2009 to 12/12/2011 you will then have to pay the normal price for 833 days.

You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

You can preview the SSC calculation for another calculation date. Simply change the dropdown
selection to get the new SSC value.
Of course you can't confirm this calculation for another date, just for the current date!

''You may add additional licenses to the calculation, which you will bind later''. Just click on the '''+''' near this text and you can add
multiple licenses, which will be added to your calculation after using the recalc link. Listed are licenses of the current version and from
your balance.

After confirming your entered SSA end date, each license will have this date as SSA end date and can be downloaded in all versions of this SSA time.

You can now extend the projects SSA end date like as setting a new one.
The resulting summary is the same as above.

If your user account has the right to buy licenses on credit, just check the checkbox.
You may enter an order number, which you can use for your order, if you buy on credit.

=====Past SSA end date=====

You can configure a new SSA end date in the past, if you accidentally configured a wrong date. 
No licenses will be changed, if you configure a date in the past, just the SSA end date of the project!

=====SSA Expiry Mail=====

If project SSA will expire, each company user will receive a reminder mail '''7''' weeks before and
then every week one mail.
You can disable these mails with the checkbox 'Send SSA expiry mails'.
Note that every user can configure, if he wants to receive mails or not in his account settings.

If you want the end user of the project to receive an expiry mail, you can configure a '''reseller''' mail address and end user mail addresses. These end users will then receive an email, 30 days before the project will expire. The default text is:

<code type="text">
Your Software Service Agreement for your innovaphone PBX in project "{$arg[3]}" will expire in {$arg[1]} days.
Please contact your reseller {$arg[2]} to upgrade the license. 
The upgrade of the license is important to secure the phone system!
</code>

You can change this text as you want. You can use placeholders:
* '''{$arg[1]}''': days left
* '''{$arg[2]}''': reseller mail address
* '''{$arg[3]}''': project name
 
You can also define a global text for all projects under your [[Reference:My_Innovaphone#Company | Company settings]].

You can optionally configure to receive project SSA independent reminder mails for each license of a device [[Reference:My_Innovaphone#Company_2|here]].

=====Automatic SSA Extension Service=====

You can request an automatic SSA extension service for a project, which is under SSA. By following this link, you will have the opportunity to request a callback and/or the necessary agreement as PDF file.

All licenses have to be under SSA to use the automatic SSA extension service!

There are some basics to know, if a project is under automatic SSA:
* If you bind new/free licenses, they'll get SSA until the current project SSA date and you will receive an invoice for the SSCs
* If you move devices into this project, their licenses will get SSA until the current project SSA date and you will receive an invoice for the SSCs
* You can't join this project into another project, but you can join another project into this one

====Rights====
=====Own project=====
Add or delete company rights for this project. To add a company right, you have to enter the company id of this company.
Each user of a company with rights on this project can add devices, licenses, activation keys to this specific project, but is restricted in removing devices, editing the project and can't create activation keys with the projects balance.

The company id can be found under Licenses->company and the company tab.

[[Image:Project_rights.jpg|center|thumb|200px|Project rights]]

=====External Project=====
If another company granted access rights to a project to you, you can unsubscribe from this project here.

====Import====
The import has been disabled. All old devices are already imported and can be added to your project manually.

====Join====
Here you can join your currently selected project with another project, which you select from a dropdown box. 
If the other project has SSA, you'll see the current SSA end date, which you might change for the join process and you will get a list of all licenses, which might be updated to the ssa end date/changed date of the other project. The list equals the list shown under [[Reference:My_Innovaphone#Software_Service|Software Service]].

The selected project will be automatically deleted after the join. You can't join a project,
if it grants external rights to another customer. Delete these rights before.

You can't change the SSA end date, if the other project is under automatic SSA! You will receive an invoice for SSCs used for the join.

====Project Move (admin only)====
A company admin can move a project with its devices, activation keys, balance etc. to another company. You have to know the company ID from this company, which can be found under Licenses->Company and the company tab. 
The history won't be moved!

Projects with negative balances can't be moved!

Existing project rights will be deleted.

====Delete====
Delete the project. Only possible if it has no activation keys, project rights, devices or user rights.
 
You may [[Reference:My_Innovaphone#Join|join]] your project into another one, if you can't delete it.

====Project Freed_RMA_licenses====
If you see a project with this name in your project list, you had a RMA device with not yed moved licenses, which was shipped to innovaphone and reshipped to another customer. 
The licenses of such a device have been moved into the pool of free licenses of the project Freed_RMA_licenses, from where you can assign them to another device.

===Balance===
On the balance page you will see the balance of the currently selected project or the balance of all your projects together.
The balance is bound to your company and '''not''' to your user account. The balance is bound to a specific project, but can be shared for license creation or activation key creation if wished. 
Sharing the balance over several projects is not possible in external projects!

[[Image:Balancepage.jpg|center|thumb|200px|Balance page]]

====Free licenses====

Here you see a list of all your free licenses. If you return licenses from one of your devices, the returned licenses are stored in your free licenses pool. You can assign these licenses to another device (see [[#Add licenses from free licenses|'Add licenses from free licenses']]) or convert them to your balance.

[[Image:Balance_free_lics.jpg|center|thumb|200px|Free licenses list]]

The bind date, SSA end date and the external key (like DECT-Multi-Cell-Ari) are stored for each license.

===Activations===

You'll see a list of all your bound activation keys with their licenses here.

[[Image:Activations.jpg|center|thumb|200px|Activation key page]]

====Add an activation key====
To increase your projects balance, select one of your projects, follow the "Add" link and enter the activation key in the corresponding field. You can also enter an optional comment for this key. You will then get a listing of all contained licenses. After commiting this key, your project balance will have been increased by the keys values.

"Deselect the current project" to view all activation keys independent of the selected project.

====Search for an activation key by your order number====
Enter your own order number (or nothing), to view your activation keys for this order.

====License certificate====
You can always download the innovaphone license certificate for activation keys in your projects. Simply press the download link in the list at the right side.

===Own Activations===
Here you'll see a list of all created activation keys in the selected project (or over all projects).

You can create activation keys on the project page for other users/companies or to simply transfer licenses from one project to another. 
You can enter a comment, an order number and an order reference. The '''order number''' is your own order number for the key and the '''order reference''' is the reference number of the customer, who receives the newly created key. 
The order reference and order number will be shown in the innovaphone license certificate.

[[Image:Created_activations.jpg|center|thumb|200px|Created activation keys]]

You have to select an activation key in the activation key list to update or delete it.

Updating and deleting a key is only possible, if this key is not assigned.

====Update====
Add more licenses to this key or change its comment, order number and order reference. 
You can also remove licenses by entering e.g. -2, if you want to remove 2 licenses from the key.

[[Image:Own activations update.jpg|center|thumb|200px|Update own activation keys]]

====Delete====
Delete this key. Its licenses will go back into the balance of the currently selected project.

===Devices===
To view your devices you first have to click on the "Show" button. You can leave the filter field empty if you want to view all your devices.

[[Image:Devices_page.jpg|center|thumb|200px|The Devices Page]]

Red marked device names are devices, which are currently in RMA.

MAC addresses of RMA devices do not longer start with 01-...

====List====
A List of your devices in the currently selected project. 
You can deselect the current project/device to list all your devices.

Select a certain device from the device list, to manage its properties, licenses etc.

Actions on multiple devices:
* Move: move several devices into another project at once (see [[Howto:My_Innovaphone#Move_device|Move Device]])
* Remove: remove several devices at once (see [[Howto:My_Innovaphone#Remove|Remove]])

=====Add=====
Follow the "Add new devices" link on the devices page.

There you have a few options:
* You can add a single new device
* You can add devices according to a mac address range (e.g. from 00-90-33-08-20-00 to 00-90-33-08-22-00), maximum 50 at once
* You can add devices by uploading a text file with mac addresses like this (maximum 50 at once, each line one mac):

00-90-33-08-20-20
00-90-33-08-20-21
00-90-33-08-20-22
00-90-33-24-20-20

* You can add devices according to your received order number. Just enter you order number and you will get a list of all devices bount to this number.

Note: MAC addresses can be always given like this:
* 00-90-33-xx-xx-xx
* 00:90:33:xx:xx:xx
* 009033xxxxxx
* xxxxxx (00-90-33- will then be added automatically)

There might be errors, if you try to add a device. They are explained [[Howto:My_Innovaphone#Image_explanation|here]].

As the device warranty will be handled by licenses now, you can also add telephone devices
to your projects.

=====Add warranty extensions=====

Here you can add warranty extension licenses for all devices in the currently selected project. 
You'll get a list of all devices with the corresponding license type(s) and you can specify the years for each device (or for all devices by entering the number in the list header). 
After confirming your selection, you'll get an overview of all needed licenses, which you have to confirm too.

=====Check licence, SSA and warranty status of a device=====
Here you can list licenses with ssa and the warranty end date of a device, which is not in one of your projects. 
This is just available with the needed right.

=====Download devices of an order as CSV=====
Enter an order number to retrieve all devices for this order in a CSV file.

=====Download devices of an order as PDF with barcodes=====
Enter an order number to retrieve all devices for this order in a PDF file with a barcode for each MAC address. 
Der Barcode ist vom Typ C128B.

====Properties====

Change the name and comment of a device.
You can only change the name, if it's no MAC or IPEI.
 
Here you have also the possibility, to directly request RMA for this device with prefilled values.

====Licenses====
Here you can add, download or move licenses.

=====Add licenses from balance=====
To create new licenses for a device, you have to add this device first on the devices page and then select a version of the license
and whether you want to summate the current licencing. If you select current licenses, then older licenses for example V6 or V7 licenses will also be counted as V8 licenses in the next overview. This is necessary if you want to license a V6 unit with V8 licenses, but still want to use it as V6.
After that click "Next".
On the next page you will see a list of all available license types, which depends on your current available license types, of the selected license version and the device type (IP6000, IP800 e.g.):
[[Image:licenses.jpg|center|thumb|200px|Licenses for an IP3000]]
 
If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses to this SSA end date or you can optionally change this date to another one for the new licenses.
 
You see the available project balance, the balance over all projects (excluding external projects), the currently installed licenses and the maximum amount for this device type. You can now enter the value of the new license.
Base/Upgrade licenses can be selected via dropdown box.
'''Voicemail and Standby lics must always have the same amount as the selected PBX-PBX... license!
The maximum amount of PBX-Registration licenses equals the amount of the selected PBX-PBX... license!'''

The whished overall amount of pbx version 8 and above licenses can be specified here and the concrete amount of license sub types will be requested on the next page.

You can preview the SSC calculation of the wished licenses without having them in your balance.

[[Image:licenses2.jpg|center|thumb|200px|Licenses for an IP800 with V8, step two]]

The best (cheapest) combination of each v8 pbx license type is already filled in, but you might change the amount of sub types if your does not fit and you do not want to purchase new activation keys for the sub types.

The column SSC/Unit is just shown if your project is currently under SSA and you have entered a SSA end date.

The SSC multiplicator is the value, which you have to multiplicate with each license unit to get
the corresponding SSC amount.
E.g. if you have 20 units of PBX-Port8*20 licenses with a SSC value of 54 and a multiplicator of
1.0000 (which equals to 365 days) you have to pay 20*54*1.0000 ~ 1080 SSCs.

 If you create licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the currently selected version twice. 
e.g.: you want to bind licenses for V6 with SSA, so you have to pay SSCs from the release date of V7
 You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

You can't change the SSA end date, if the project is under automatic SSA! You will receive an invoice for SSCs used for the new binding.

Now confirm your new selection. If you have not enough licenses in your current project, but there are still licenses in other projects, you will get a dropdown box with a list of all projects containing the needed licenses. You can now select all desired/needed projects and confirm your selection again.
The balance of all selected projects will then be decreased by the needed amount.
 
 
If your user account has the right to buy licenses on credit, just check the checkbox.
 
You may enter an order number, which you can use for your order, if you buy on credit.

=====Add licenses from free licenses=====

Here you can assign licenses, which you returned from other devices.
You will also have to select the desired version and will than get a list of fitting licenses according to the current device and selected version.

[[Image:licenses_free.jpg|center|thumb|200px|Free Licenses for an IP800 with V8]]

If a license is under SSA, the correct license type is shown in column 'License Type' besides the 'Original Type'.
On confirming the selection, a consistency check is done (e.g. only 4 Relay-PRI licenses on an IP6000).
Bind and SSA end date will be maintained for each license.

As external keys are also maintained, you can select e.g. an old Dect-Multicell-Ari license to have the same ARI on another IP1200.
 

If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses
to this SSA end date or you can optionally change this date to another one for the new licenses.
You will have to confirm this after your first license selection (this is the same calculation as [[Reference:My_Innovaphone#Software_Service|here]]).

You can't change the SSA end date, if the project is under automatic SSA! You will receive an invoice for SSCs used for the binding.

=====Add V7 floating license (slave pbx)=====
Here you can add a V7 floating license for a slave pbx. A device with a floating license can't have V7 pbx licenses and a device with V7 pbx licenses can't have a floating license.

=====Delete V7 floating license=====
Here you can delete an already existing floating license, if you won't use it anymore.

=====Add warranty extension licenses=====
Extend your warranty by adding warranty extension licenses:

[[Image:add_warranty.jpg|center|thumb|200px|Warranty extension]]

If you add the warranty extension immediately after the receipt of your device,
you can add the cheaper warranty extension licenses, otherwise you'll have to add
the more expensive ones.

You can extend the warranty for a maximum of four years.

=====Download licenses=====

[[Image:Device_download.jpg|center|thumb|200px|Download Licenses]]

You will get a dropdown with all available versions. Versions are dependent of your device, your licenses and of the ssa of your licenses. 
'''From V9 on''', you just have one option, which will create a license file, which contains the licenses upgraded to the highest version of their type. 
You are able to download downgraded versions of your licenses. E.g. if you have only V8 licenses, you can download a V7 license file (same restrictions as below).

Downgrades or only possible down to version 6!

If you do not want to download licenses by version, you have to decide whether to download the licenses encrypted or not.
'''If you download the licenses unencrypted, you won't be able to return those licenses anymore.'''
So you won't be able to return licenses for devices with V5-V7 licenses, as licenses for these versions are not encrypted.
To return these licenses, you will have to upgrade to a new bootcode, which prevents firmware downgrades to versions below version 8. 
Encrypted licenses are stored in a xml file, which you can then upload on your V8 (or higher) device.

You can now also download licenses directly from by the web interface of a device.
You just have to enter your account data and start downloading the licenses from my.innovaphone.com
without having to download/upload a license file.

=====Download test licenses=====

[[Image:Device_download_test.jpg|center|thumb|200px|Download test licenses]]

You can also download test licenses if you want to run tests. You will be asked, which version you want to use, whether the device is used as slave and if not used as slave, how many pbx licenses you want to use.

V5 does '''not''' support test licenses!

=====Move licenses to another device=====
If you have the needed account rights or the device is already in RMA, you can move licenses to another device. After moving licenses, the former device will be marked as a RMA device.

You can just move licenses to devices without licenses!

====Move device====
Here you can move the current device or the selected devices to another project. 
If you select a SSA project, you can change the SSA end date for the move process. 

If the other project is under SSA, you will first see a SSC calculation, which you have to confirm,
as the SSA date for each SSA license will be extended until the given SSA end date
(this is the same calculation as adding SSA to an already existing project, see [[Reference:My_Innovaphone#Software_Service|here]]).

You can't change the SSA end date, if the other project is under automatic SSA! You will receive an invoice for SSCs used for the move.

====Invalidation====

=====Requirements=====
* V8 or higher
* access to the webinteraface
* a device certificate
* my.innovaphone login credentials
* '''no IPVA device'''

=====Informations=====

You can invalidate V8 (or higher) licenses by uploading the XML file, you got from your device or by returning your licenses over the web interface of your device ([[Reference8:Configuration/General/License]]), in order to return [[Reference8:Licenses#Gateway_Licenses|PBX licenses]] back to the balance.

V7 licenses can be just returned, if you agree, that you won't be able to downgrade below V8 anymore. You will need a new bootcode, to use this function. '''You need a V8 firmware or higher for invalidation.'''

If your device has access to my.innovaphone.com, you can also invalidate licenses directly
from the web interface of the device.

[[Reference8:Licenses#Gateway_Licenses|gateway licenses]] and warranty extensions won't be returned to the balance and remain to be assigned to the device!

The licenses needn't be present on the device to perform the invalidation!

=====Process=====

Steps to invalidate licenses, if your device has internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# enter your my.innovaphone account, the device must be in one of your projects
# click Invalidate
# click Transfer (this might fail, if NTP or DNS is not configured properly or device certificate is not installed)
# reset if asked for

Steps to invalidate licenses, if your device has no internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# click Invalidate
# click Backup and upload this file on my.innovaphone [[Reference:My_Innovaphone#Upload_the_invalidation_document_to_return_licenses|here]]
# you'll get a confirmation file after uploading the saved file
# upload this on the device (under Step1)
# reset if asked for

"Your IP800 does not have a device certificate on it." - In this case you need to download a hardware certification,
please contact the innovaphone [mailto:license@innovaphone.com license].

=====Download confirmation file=====
If you created a new certificate or you invalidated your licenses, you can later download the confirmation file, which you have to upload on the box.

=====Request certificate=====
If you have the needed rights, you can request a new device certificate for your device.

=====Upload the invalidation document to return licenses=====
Upload the invalidation document, which you got from the website of the device to return the licenses of this device.

After uploading you'll get a confirmation file, which you have to upload on your device.

====Remove====
You can always remove devices from a project. If they have licenses, these won't be deleted, so you might add the device to another project again.

===History===
[[Image:history.jpg|center|thumb|200px|History page]]
You can view your history for several contexts:
* Company: history of all actions in your company
* User: history of all actions of the selected user
* Device: history of all actions for the selected device

Each context applies to the currently selected project.
If you deselect the current project, you will see the history over all projects.

You can select to view the history of the last day, week, month, year or from always. Collecting data might take a while...

===Company===
Manage users, import other companies or change your company data.
The first user of a company has automatically company admin rights and can grant this right to other company users after adding their accounts email address. 

====Users====

[[Image:company.jpg|center|thumb|200px|Company page]]
Here you can add other users to your company, optionally with '''company admin rights'''.
You can also '''lock''' a user account or grant company admin rights. 
Locked users can't loggin to my.innovaphone.com any more. 
Instead of locking a user you can also '''remove''' this user from your company. The user itself will still have his my.innovaphone account, but won't belong to your company any more. The history of this user is still available after having removed him.

Non company admin users just get a non editable list of the current company users.

A user can be member of several companies and the users rights, company admin and
locked status can be different for all companies, where this user is in.

=====My innovaphone Viewer=====
If you check this flag for a user, this user won't be able to do any changes to your projects, devices and licenses. He will be just able to view projects, devices, SSA settings etc.

====Join (admin only)====
As admin you can also join another company into your company by entering an admin account of this company. This might be usefull if one user of your company has accidentally created an own company. 
Everything like projects, users, devices, balance, activations etc. will be imported! 
You also have to enter the company id of the company, which is to be imported. You can find this company under Licenses->Company and the company tab.

This is not available for non company admin users.

The joined company will be deleted afterwards!

====Company====
If you do not belong to a my innovaphone company, you can create one here. You can optionally enter an innovaphone account ID with its zip code or you just enter your company data below.

[[Image:company_create.jpg|center|thumb|200px|Company create page]]

Otherwise you can change your company data, but only, if you didn't created your company with your innovaphone account id. In this case, company information is always retrieved from your innovaphone account.
Non company admin users can just view the current company data.

You also see your company id here, which is sometimes needed for adding external project rights or
to be imported by another company.

You can check the '''Device SSA''' checkbox, if you want to receive SSA expiry reminder mails for each device independent of the projects SSA end date.
These mails will be send weekly seven weeks before the SSA for a license a the device expires.
 
 
You can also enter additional email addresses, which should receive SSA emails.
 
You can define a global '''end user expiry mail text''' here, which will be sent to end users, if end users are configured in a [[Reference:My_Innovaphone#SSA_Expiry_Mail | project]]. This text can be overridden by a text in a project under [[Reference:My_Innovaphone#SSA_Expiry_Mail | SSA Expiry Mail]].

====Partner Status====
You can review the partner status of the users of your company. 
You also see a list of companies, which granted partner status access to you.

=====Manage Partner Status Access=====
Grant or remove access rights to your own partner status. 
You can enter the [[ Reference:My_Innovaphone#Company_2 | company ID ]] of another my.innovaphone company. Afterwards, this company will have access to '''your''' partner status.

====New Company====
If you need several companies for some reasons, you can create another one here. 
You will be an admin user in this new company and you can directly select the newly created company at the top right corner.

==RMA==
Here you can see all your RMA devices, which arrived innovaphone already. The licenses of this macadresses are moveable.
[[Image:rma.jpg|center|thumb|200px|RMA page]]
 
If you want to request RMA for a certain device, go to the device properties and follow the "Request RMA" link.

==Support==
===Mantis===
Here you'll get a list of all open support cases in our mantis system, which are assigned to email addresses of your my.innovaphone users in your company.

===Announcements===
You can convert audio files into G.7xx files which you can use as announcements. 
 
;Supported input formats:
* mp3
* wav
* ogg
* flac
* ...

;Generated output formats:
* G.711u
* G.711a
* G.729
* G.723
* G.722

==Configurator==
Currently this is just a link to the [http://config.innovaphone.com innovaphone PBX Configurator]

==Account==
Here you can change your personal data, password etc. You always have to enter your current password to change your data. 
You can also configure, if you want to receive SSA expiry mails!

If you change your email address, you'll have to activate your account again.

==Company selection==
If your user account belongs to several companies, you can switch between companies be using the dropdown box at the top right corner of the page. 
You'll get an error, if you try to switch to a company, where your account is locked. 

[[Image:company_selection.jpg|center|thumb|200px|Dropdown box for company selection]]

 
If you loggin, the first found company is selected for your user.

==Image explanation==

===Errors===

====Already In Company====
[[Image:Icon_in_company_inno_01.png]]
* This device already exists in your company and can't be added/imported.
If you want to import this device anyway, you first have to delete your current device from its project.

====Already Imported====
[[Image:Icon_imported_inno_01.png]]
* This device has been already imported.
You can't import it again.

====Not Found====
[[Image:Icon_not_found_inno_01.png]]
* This device was not found in the my innovaphone database.
This should never happen, but if, contact the administrator.

====IPVA MAC exists====
[[Image:Icon_ip_va_exists_inno_01.png]]
* An IPVA MAC address must be unique and can be assigned to just one company. You tried to add an already existing IPVA MAC.
Please assign a new one to your IPVA. For further details, see [[Reference9:Concept_Innovaphone_Virtual_Appliance#License_Configuration]].

===Warnings===

====Several Companies====
[[Image:Icon_several_companies_inno_01.png]]
* This device is already in another company.
This means, that either you do not have the physical device or it once belonged another company.
You can still import/add this device and you will have access to all of its current licenses.

====Several Users====
[[Image:Icon several users inno 01.png]]
* This device has licenses from several users of the old license manager.
This means, that you are not neccessarily the user, who physically owns this device. If you do not own it, do not import it.

===Misc===
====No downgrade====
[[Image:no_downgrade.png]]
* Licenses, which have been downloaded for V5/V6/V7, were returned from this device, so no downgrade to these versions is allowed any more.



==Release dates==
V5: 01/01/2003 
V6: 02/11/2006 
V7: 14/11/2008 
V8: 07/12/2009 
V9: 26/04/2011 
V10: 08/07/2013 
V11: 09/02/2015 



==Known Issues==
===Smaller issues===
* Devices where imported into a project with SSA. If this happened to you, please move the corresponding devices into a project '''without''' SSA and back into the project '''with''' SSA to extend/add SSA for the licenses until the SSA end date.
* IE7 moves a list under the menu, when a list becomes to wide
===Licenses don't work on a device, where an invalidation has been done===
A possible reason here is, that the invalidation process hasn't been completed.
To resolve this issue, follow these steps:

* Download the Confirmation File (Certificate) from http://my.innovaphone.com under [[Reference:My_Innovaphone#Invalidation|Invalidation]] after selecting the project and the device
* Open [[Reference9:General/License/my.innovaphone|General->License->my.innovaphone.com]] on your device
* Click on "Invalidate" (no my.innovaphone credentials needed)
* Upload the previously downloaded confirmation file newcert-00-90-33-xx-xx-xx.xml as "Confirmation file"
* Reset the box
* Reupload the licenses

RMA

2014-10-20T13:35:36Z

Kti: /* Procedure */

==Applies To==
This information applies to the innovaphone device repair procedure.



==More Information==

===Problem Details===
innovaphone entertains a repair service for devices acquired from or through innovaphone. This service is available to innovaphone customers with valid innovaphone account id. Resellers will usually refer to their distributor, end customers to their reseller.

This article describes the access to the new RMA web interface.

===System Requirements===
You need to have a valid innovaphone account id. You will find this e.g. on any invoice received from innovaphone. If you don't have an account, refer to your reseller or distributor for repair.

===Procedure===
To have a device repaired (regardless of warranty), you need to request a returned material autorization (RMA). Devices returned to us without RMA-Id will not be repaired and will returned to you on your expense.

To apply for an RMA-ID, you will visit [http://rma.innovaphone.com rma.innovaphone.com].

This is the information you need to have at hand:

* your innovaphone account id
* the device serial number
* the detailed defect description
* contact data for the person handling the request from an administrational perspective
* contact data for the person handling the request from a technical perspective
* the shipping address for the replacement unit
* if you have received it from your sales representative, a ''good will id''
* if you want to move the licenses directly to a new device, you need the serial number of the new device too (The move is possible only if no licenses, except warranty licenses, are on the new device.)

Normally, you need to apply for a separate RMA-Id for each individual device. Bulk submissions with only a single RMA-Id are not accepted.

If you want to move licenses to a new device within the RMA application, you need to know the my.innovaphone login details of an user who is part of the my.innovaphone company with the stated innovaphone account id.

Upon submission of your request you will receive the RMA-ID. This will be used in all communications to you regarding the issue. The RMA-Id in fact is an issue-ID and you will see all RMA issues in your weekly status overview.

You can send the defective device to us right away! Please note the RMA-ID on the package or delivery note.
After we receivd the device, you have the possiblity to move the licenses to a new device of your choise. This is possible only if no licenses, except warranty licenses, are on the new device.

In most cases, the defective unit will be repaired. In some cases we will send you a replacement unit. Advance Replacement may be available under special support agreement. Contact [mailto:inside-sales@innovaphone.com innovaphone representative] for details.

===Hints===
You can bookmark the RMA website at any stage, so you can resume it later or avoid typing your standard data (such as account-id etc.) every time.

When you have completed data entry for one device, you can click on 'Restart' and you will be asked only for the device specific data again for the next device.

If the device in question does not have a serial number (e.g. a headset), then you leave the serial number field empty and enter the description into the '''Device Type''' (not less than four characters) field.

If you only want to return part of a device and have it exchanged with a spare part (e.g. a telephone handset), then you would still enter the affected devices serial number into the serial number field and note this in the '''Detailed defect description''' field.

===Known Problems===
To protect the privacy of your account data, you must enter both matching account number ''and'' ZIP code. However, the ZIP code obviously has to match the ZIP code we have in our records. If this is incorrect for some reasons, this will create a problem. If the form complains about non-matchig account and ZIP code, please try different format (e.g. no spaces at all) or try to leave out parts of the ZIP (e.g. if your ZIP code is '''1234 BC''', try '''1234''' instead).


[[Category:Howto|{{PAGENAME}}]]

RMA

2014-10-20T13:31:00Z

Kti: /* Procedure */

==Applies To==
This information applies to the innovaphone device repair procedure.



==More Information==

===Problem Details===
innovaphone entertains a repair service for devices acquired from or through innovaphone. This service is available to innovaphone customers with valid innovaphone account id. Resellers will usually refer to their distributor, end customers to their reseller.

This article describes the access to the new RMA web interface.

===System Requirements===
You need to have a valid innovaphone account id. You will find this e.g. on any invoice received from innovaphone. If you don't have an account, refer to your reseller or distributor for repair.

===Procedure===
To have a device repaired (regardless of warranty), you need to request a returned material autorization (RMA). Devices returned to us without RMA-Id will not be repaired and will returned to you on your expense.

To apply for an RMA-ID, you will visit [http://rma.innovaphone.com rma.innovaphone.com].

This is the information you need to have at hand:

* your innovaphone account id
* the device serial number
* the detailed defect description
* contact data for the person handling the request from an administrational perspective
* contact data for the person handling the request from a technical perspective
* the shipping address for the replacement unit
* if you have received it from your sales representative, a ''good will id''
* if you want to move the licenses directly to a new device, you need the serial number of the new device too

Normally, you need to apply for a separate RMA-Id for each individual device. Bulk submissions with only a single RMA-Id are not accepted.

If you want to move licenses to a new device within the RMA application, you need to know the my.innovaphone login details of an user who is part of the my.innovaphone company with the stated innovaphone account id.

Upon submission of your request you will receive the RMA-ID. This will be used in all communications to you regarding the issue. The RMA-Id in fact is an issue-ID and you will see all RMA issues in your weekly status overview.

You can send the defective device to us right away (previously, we forced you to wait for support to contact you and validate the RMA request. This is no longer necessary)!

In most cases, the defective unit will be repaired. In some cases we will send you a replacement unit. Advance Replacement may be available under special support agreement. Contact [mailto:inside-sales@innovaphone.com innovaphone representative] for details.

===Hints===
You can bookmark the RMA website at any stage, so you can resume it later or avoid typing your standard data (such as account-id etc.) every time.

When you have completed data entry for one device, you can click on 'Restart' and you will be asked only for the device specific data again for the next device.

If the device in question does not have a serial number (e.g. a headset), then you leave the serial number field empty and enter the description into the '''Device Type''' (not less than four characters) field.

If you only want to return part of a device and have it exchanged with a spare part (e.g. a telephone handset), then you would still enter the affected devices serial number into the serial number field and note this in the '''Detailed defect description''' field.

===Known Problems===
To protect the privacy of your account data, you must enter both matching account number ''and'' ZIP code. However, the ZIP code obviously has to match the ZIP code we have in our records. If this is incorrect for some reasons, this will create a problem. If the form complains about non-matchig account and ZIP code, please try different format (e.g. no spaces at all) or try to leave out parts of the ZIP (e.g. if your ZIP code is '''1234 BC''', try '''1234''' instead).


[[Category:Howto|{{PAGENAME}}]]

Reference9:Concept Innovaphone Virtual Appliance (IPVA)

2014-05-21T09:01:56Z

Kti:

[[Category:Concept9|{{PAGENAME}}]]
==Applies To==
This information applies to:
*V9
*innovaphone Virtual Appliance
*Intel/AMD CPUs
*VMware
**Workstation 7.1
**Player 3.x <ref>VMware Player Download(free): http://vmware.com/download/player/</ref>
**vSphere 4.1
**vSphere 5.x
***[[User:Inno-mst|Inno-mst]] 14:25, 16 October 2013 (CEST): vSphere '''5.5''' compatibility has been reported
**Fusion 5.x (Mac OS X 10.7)

==More Information==
The innovaphone Virtual Appliance (IPVA) is a virtual machine to be run on a virtualization platform.
Whereby, VMware<ref>http://www.vmware.com</ref> is is the solely supported virtualization platform to-date.

The IPVA is a software-only solution. It appears as and performs as an innovaphone "hard-box" excluding DSP-, ISDN-/AB-resources.

The following core-components are contained within the IPVA:
*innovaphone PBX
*innovaphone Gateway (a.k.a ''Relay'')
*integrated mass-storage (alike innovaphones' CF-card support)


==Configuration==
[[#Download|Download]] the IPVA.

*The compressed archive ''ipva-vmx.zip'' contains 1 virtual machine configuration file (*.vmx) and 4 virtual machine disk files (*.vmdk):
**ipva.vmx: The virtual machine configuration file
**hd-boot.vmdk: The virtual boot harddisk (hd)
**hd-cf.vmdk: The hd for emulation of a Compact Flash card
**hd-flash.vmdk: The hd for emulation of flash memory
**hd-dump.vmdk: The hd serving as a store for a crash dump

The file ''ipva.bin'' is the firmware file, which is only needed for update purposes.

===VMware Player===
*Copy the IPVA to e.g. your desktop
*Double-click on ipva.vmx
The IPVA is going to be started.

A shortcut (*.lnk file) to the vmx-file will start the IPVA without additional user interaction. Such a shortcut may also be copied into the Windows ''Autostart'' program folder, in order to have the IPVA started automatically on windows startup.
===VMware Workstation===
*Copy the IPVA to e.g. your desktop
*Double-click on ipva.vmx
The IPVA is going to be started.

The ''Workstation 7'' directory comprises the command line utility ''vmrun.exe''. A batch file according to the following pattern may be crafted to programmatically start the IPVA.
<pre>
"D:\Programme\VMware\VMware Workstation\vmrun" start "C:\Users\Tester\Desktop\ipva\ipva.vmx"
</pre>
'''Note''': By altering ''start'' into ''stop'' a virtual machine may be stopped.
===VMware vSphere===
This applies to vSphere 4.x and later (such as e.g. vSphere 5.5). 

====VMware vCenter Converter Standalone====
The IPVA offered for downloading must be converted into a vSphere-processable form.
The IPVA can be converted by means of the tool ''VMware vCenter Converter Standalone''<ref>VMware vCenter Converter Standalone: https://www.vmware.com/tryvmware/?p=converter</ref>.
*A step-by-step guide may be found [http://blog.lewan.com/2009/12/22/vmware-vsphere-using-vmware-converter-to-import-vms-or-vmdks-from-other-vmware-products/ here].
Make sure you ''always use the latest VMware converter'' to convert your IPVA.

See [[#Why_Isn.27t_There_An_OVA.2FOVF_File_Made_Available.3F | here]] for a discussion why the conversion is needed.

===Network Configuration===
Manufacturer-configured as DHCP client only. I.e. a DHCP server must be available. Afterwards the network configuration may be administrated as used to within the web ui of other innovaphone boxes. If there's in no case a DHCP server available for the 1st-time configuration, read through [[#What_Is_The_Console_Good_For?|What Is The Console Good For?]].

===License Configuration===
For the IPVA9 license see [[Reference9:Licenses]].

The licensing procedure is the same as for other innovaphone products, except for one peculiarity: The MAC address, generated by VMware, may have been assigned already to another customer/installation. Such a conflict must be settled manually as explained below.

If, while generating licenses within ''my.innovaphone.com'', a message ([[Reference:My_Innovaphone#IP-VA_MAC_exists|My_Innovaphone#IP-VA_MAC_exists]]) is displayed:
<pre>
IP-VA MAC exists
</pre>
then a new MAC address must be assigned manually to the affected installation.

'''Note:''' We recommend to not use auto-generated MAC Address for the IPVA machine. Please assign a static MAC address like '00-50-56-...' to prevent license issues if the machine must be rebuild since you will assign the same MAC address after and not the auto-generated MAC.

====VMWare Player and Workstation====
In order to assign a new MAC address on a VMWare Workstation or VMWare Player:
*Power-off the virtual machine
*Open the file ipva.vmx for editing within a text editor.
*Edit the last 3 hex-values of the lines starting with ''ethernet0.generatedAddress'' & ''uuid.bios'' from e.g.
<pre>
ethernet0.generatedAddress = "00:0c:29:f4:c6:d9"
uuid.bios = "56 4d 64 b9 52 ce 38 57-66 29 e8 f2 77 f4 c6 d9"
</pre>
into e.g
<pre>
ethernet0.generatedAddress = "00:0c:29:f4:c6:da"
uuid.bios = "56 4d 64 b9 52 ce 38 57-66 29 e8 f2 77 f4 c6 da"
</pre>
(Note: in this example just the very last hex-value '''d9''' is going to be altered into '''da''')
*Within my.innovaphone.com try once again to generate licenses for the virtual machine with the new MAC address.

====VMWare vSphere, ESX/ESXi 4.1 and ESXi====
For information related to vSphere, ESX/ESXi 4.1 and ESXi 5.x, see the Mac Addresses section of the [https://www.vmware.com/support/pubs/vsphere-esxi-vcenter-server-pubs.html vSphere Networking Guide] for your version of ESX/ESXi.

==Provision Of External Resources==
External Resources are required, in order to provide:
*Access to ISDN interfaces
*DSP conferencing channels

The IP1060<ref>[http://www.innovaphone.com/fileadmin/download/newsletter/EINLEGER_IP1060_Produktkatalog2009_2010_DE_ENG.pdf IP1060 Product Information]</ref> media gateway may be considered as a suitable complement for such purposes.
==Download==

[http://download.innovaphone.com/ice/9.00/#firmware IPVA.zip from http://download.innovaphone.com/ice/9.00/#firmware]

==Troubleshooting==
Support procedures are commonly identical to the ones known from innovaphones' physical appliances. Except for:
*'''Post-Mortem Logs''' A post-mortem log must be retrieved by clicking on ''Admistration/Diagnostics/'''trace(crash-dump)''''' (alternatively: http://a.b.c.d/crash_dump.txt).
**Note: Deviating from innovaphones' physical appliances, the DRAM-content(with may be post-mortem info) does not survive a CPU-reset. This is why post-mortem information is going to be stored persistent on the 4th disk, named ''hd-dump.vmdk''.

Some known issues are listed further below under [[#FAQ | FAQ]].

==Known Issues==
===ESX 3.x is unsupported===
The IPVA does not run under ESX 3.x and below, since virtual IDE disks aren't supported.

===Don't use Maintenance/Upload/DRAM on vSphere 4===
Until further notice this way of uploading a new firmware is currently not supported. The VMM detects and assumes the guest (IPVA) is going to shutting-off. All the virtual harddisks may get lost in the aftermath.
vmware.log shows:
<pre>
...

Mar 02 13:02:25.439: vcpu-0| Vix: [4864986 vmxCommands.c:9609]: VMAutomation_HandleCLIHLTEvent. Do nothing.
Mar 02 13:02:25.462: vcpu-0| MsgHint: msg.monitorevent.halt (sent)
Mar 02 13:02:25.462: vcpu-0| The CPU has been disabled by the guest operating system. Power off or reset the virtual machine.

...and then when trying to power-on later...

Mar 03 08:37:00.260: vmx| Destroying virtual dev for ide0:1 vscsi=8303
Mar 03 08:37:00.260: vmx| VMMon_VSCSIStopVports: Invalid handle
Mar 03 08:37:00.260: vmx| VMMon_VSCSIDestroyDev: Not found
Mar 03 08:37:00.260: vmx| Destroying virtual dev for ide1:0 vscsi=8304
Mar 03 08:37:00.261: vmx| VMMon_VSCSIStopVports: Invalid handle
Mar 03 08:37:00.261: vmx| VMMon_VSCSIDestroyDev: Not found
...
</pre>

===Release Note For V9HF1===
This Note refers to the fix [[Support:DVL-Roadmap_Firmware_V9#IPVA.2C_RAM-Dependent_Flash_Limitation | Support:DVL-Roadmap Firmware V9#IPVA RAM-Dependent Flash Limitation]]
*From on V9HF1 the available flash directory<ref>Flash Directory: Storage for PBX objects</ref> space will be constrained, depending on the available RAM. A loss of PBX objects may occur after an upgrade to V9HF1. In order to prevent such a loss perform the upgrade as follows:
**1)Download and save the current configuration of the affected IPVA.
**2)Upload the new firmware file and reboot.
**3)Upload the config from step 1).
*From on V9HF1 an administrative reduction of the available RAM may lead into a loss of PBX objects. I.e. increasing the RAM isn't critical, while in contrast lowering the amount of RAM lowers the amount of flash directory space.

===V9HF4 Needed For vSphere 5===
V9 Hotfix4 is needed, in order to run the IPVA under vSphere 5.

==FAQ==
===Are Firmware Updates Possible?===
Yes, alike the well-known *.bin firmware files for other innovaphone products (ip6000.bin, ip2000.bin,..) , there's a similar bin-file (ipva.bin) for the IPVA. The file is contained on the boot-hd and can be found by browsing to e.g. http://192.168.0.5/drive/HD-BOOT . The versioning of ipva.bin is the same as for the other products. The firmware file may exactly be uploaded as for other products:
* by ''Upload/Firmware''
* by ''Upload/Dram''
* by a script for the innovaphone Update Process

===What is the ipva default password?===
*user: admin
*password: ipva

===Do I Always Need To Download The Entire IPVA?===
No, after the 1st-time deployment of an entire IPVA only the firmware file ''ipva.bin'' needs to be downloaded from ''download.innovaphone.com''. See [[#Are_Firmware_Updates_Possible.3F| Are Firmware Updates Possible?]] for how to proceed further.
===How Is The Network Connection Being Handled?===
The network connection is pre-configured to: ''Bridged: Connected directly to the physical network''
===What Is The Size Of the Emulated CompactFlash?===
1GB

===Can The Emulated CompactFlash Be Increased In Size?===
Yes, from within the ''Edit Virtual Machine'' dialog. Doing so just increases the size of the virtual harddisk. The emulated CompactFlash must be formatted afterwards and accordingly to benefit from the increased size. That step can be administrated from ''Administration/Compact Flash/Format''. Note: A recommendation for an upper size limit is not given.

'''vSphere / vSphere Client'''

1. At first backup all of your files from CF card 
2. Shutdown the corresponding IPVA 
3. Choose "Properties" of the IPVA 
4. Delete "Harddrive 2" (Hardrive file xxx/xxx_1.vmdk) 

hd-boot.vmdk > xxx.vmdk
hd-cf.vmdk > xxx_1.vmdk
hd-flash.vmdk > xxx_2.vmdk
hd-dump.vmdk > xxx_3.vmdk

5. Create new harddrive 
6. Configure the required size 
7. As "Node of virtual device" select "IDE(0:1)" 
8. Start the IPVA. 
9. "Format" the CF Card and "mount" it (General/Compact-Flash/General)

===What Is The Size Of the emulated Flash Storage on the IPVA?===
The virtual flash storage used to store configuration file of the IPVA and LDAP directory of the PBX is defined with 64 MB and can not be changed. This is two times more than on IP6010. The VMDK-File hd-flash.vmdk is allocated with 100 MB, because VMWare can not handle smaller virtual disks.

===How Much RAM Is Required Per IPVA Instance?===
The downloadable virtual appliance comes preconfigured with 64MB RAM. This amount is seen as a good trade-off for the majority of all installations.
The RAM-size can be administrated by VMware-means.

The minimum RAM size allocatable to an IPVA in VMware is 20MB. This results in a DRAM size seen by the IPVA of 17MB and roughly 8MB allocatable runtime memory after boot. Note though that even a small IP302 model has 17MB allocatable runtime memory after boot.

===What Is The Maximum Amount Of RAM?===
The maximum meaningful RAM setting is 3GB. Memory space beyond that limit will be left unused. Assigning more than 3GB to an IPVA instance doesn't provide any benefit.

===Why Does ''General/Info/DRAM'' Show Less Than the Configured Memory?===
Not all of the configured memory is available to the IPVA. E.g. a bit of memory is occupied by the VMM<ref>Virtual Machine Monitor: A component belonging to the virtualization platform</ref>. The indicator ''General/Info/DRAM'' displays the memory available to the IPVA and is truncated down to a whole number. A boot-trace reveals a bit more about IPVA-available memory as shown in the following excerpt:
<pre>
...
0:0000:030:4 - Intel(R) Core(TM)2 Duo CPU E8400 @ 3.00GHz
0:0000:030:4 - mem(64946176)=61.93MB ...
</pre>

===How Many IPVA Instances Are Possible Per Host?===
There's no worst-case estimate available. For a best-case calculation,
*see [http://www.vmware.com/pdf/vsphere4/r41/vsp_41_config_max.pdf Configuration Maximums VMware vSphere 4.1]
*see [[#How_Much_RAM_Is_Required_Per_IPVA_Instance.3F | How Much RAM Is Required Per IPVA Instance?]]
Additional preformance reflections
*see [[HOWTO:A_rough_estimate_of_IPVA_Performance | A rough estimate of IPVA Performance]]

===Where Has PPP-Functionality Gone?===
PPP-scenarios (PPTP, PPPoE) are not envisaged with the IPVA, because it has only one network interface controller.

'''Update'''(07.Mar.2011), from on 90468:
*PPP has been integrated
*a second network interface is available (now ETH0 and ETH1)
**ETH1 comes pre-configured: ''host-only, disconnected''. I.e. it must be reconfigured manually and by VMware means to become functional.

===Does The IPVA Support Non-VMware Hypervisor Products?===
No, currently it doesn't.

===How do I perform a factory reset?===

replace the 3rd disk, served on IDE 1:0, named hd-flash.vmdk with an empty disk:

[[Image:VM_Settings.png]]

1)download the IPVA and watch out for the file hd-flash.vmdk

2)Power-off the IPVA instance

3)Replace hd-flash.vmdk with the one downloaded in step 1). If on vsphere it may have been assigned a different name. Ensure it’s the one on IDE 1:0.

4)Power-on the IPVA instance

===Is VMWare Fault Tolerance (FT) supported by IPVA?===

Yes, we have successfully tested<ref>[[Howto:Implement_PBX_with_zero_downtime_using_IPVA_and_VMWare_Fault_Tolerance | Howto:Implement PBX with zero downtime using IPVA and VMWare Fault Tolerance]]</ref> VMWare Fault Tolerance<ref>VMWare Fault Tolerance: http://www.vmware.com/products/fault-tolerance/overview.html</ref> with a virtual machine running IPVA on VMWare vSphere 4.1.

===What About VMware Tools?===
VMware Tools are not supported.

===What Is The Console Good For?===
The console is a remains of the early development phase. It resembles the IP3000's serial console. It doesn't offer any convenience like command history or backspace funtionality. Nevertheless may the console be of help in exceptional situations where e.g. the required DHCP server isn't available for 1st-time configuration or in situations where the ip configuration was misconfigured. Thereby any command from a device's config is acceptable.

For instance to configure the static IP address 1.2.3.4/24 on ETH0:
*Click into the console
*Press ENTER
*Enter credentials
*Enter
<pre>
config change IP0 ETH0 /addr 1.2.3.4 /mask 255.255.255.0
config change DHCP0 /mode off
config write
reset
</pre>
Since no backspace is offered it may become a daring task to enter a single line without typos. In case of a typo hit ENTER and input the same line again.
The keyboard layout is the US layout.
[[Image:Ip-via-console.png|center|thumb|200px|Console-edit of IP address]]

Display the IP configuration for ETH0:
<pre>
config show IP0 ETH0
</pre>

Display the DHCP configuration for ETH0:
<pre>
config show DHCP0
</pre>

Additional the DNS-server(s) and the default gateway can be configured:
<pre>
config change IP0 ETH0 /addr 1.2.3.4 /mask 255.255.255.0 /dns 8.8.8.8 /dns2 8.8.4.4
config change IP0 RT0 /gateway 1.2.3.254
config change DHCP0 /mode off
config write
reset
</pre>

Also some simple diagnostics (ping and traceroute) are possible via the console (output is given in the console):
<pre>
mod cmd PING0 tracert 8.8.8.8
mod cmd PING0 ping 8.8.8.8
</pre>

Resetting the entire FLASH space - '''Note, all configuration will get lost'''. this is similar method to the manufacturer reset method from above [[#How_do_I_perform_a_factory_reset.3F|How do I perform a factory reset?]]
<pre>
mod cmd FLASHMAN0 reset all
reset
</pre>

===What Can I Do In Case Of A Checksum Boot Error?===
This paragraph applies, if you experience the following start-up problem.

'''Symptom'''
*the IPVA doesn't start properly
*the console displays
<pre>
checksum wrong! Loading failed for image=IPVA BIN
</pre>
[[Image:ipva-crc-wrong.jpg|center|thumb|200px|Console displays CRC boot error]]

'''Solution'''
*Power-off the IPVA
*Replace the boot harddisk by a fresh one. The boot harddisk is the 1st hd(originally named ''hd-boot.vmdk'').

'''Remarks'''

This problem may occur on a system crash while a firmware update is taking place.

===What Can I Do In Case Of Boot-Problem: ''NIC unavailable!''===
This paragraph applies, if you experience the following start-up problem.

'''Symptom'''
*the IPVA doesn't start properly
*the console displays
<pre>
NIC unavailable!
</pre>
[[Image:ipva-nic-unavailable.jpg|center|thumb|200px|Console displays ''NIC unavailable!'']]

'''Solution'''
*Power-off the IPVA
*Administrate by VMware means: Ensure the correct/expected type of network interface controller(NIC) is going to be offered by the hypervisor.

The IPVA offers driver support for:
*AMD NIC: Am79C970A PCnet-PCI II Single-Chip Full-Duplex Ethernet Controller
**a.k.a ''PCNet32''
**a.k.a ''Vlance''

The AMD-NIC is kind of default. However, the NIC type may be overriden manually and accordingly within the configuration file ipva.vmx as follows
<pre>
ethernet0.virtualDev = "vlance"
</pre>

'''Remarks'''

This problem may occur after a VMware re-configuration of the network settings.

===What Can I Do In Case Of Boot-Problem: ''perf-counter not enabled!''===
This paragraph applies, if you experience the following start-up problem.

'''Symptom'''
*the IPVA doesn't start properly
*the console displays
<pre>
perfcounter-not enabled!!!
</pre>
[[Image:screenshot-ipva-perfcounter-nok.jpg|center|thumb|200px|Console displays ''perfcounter-not enabled!!!'']]

'''Solution''' 
This problem is likely caused by a faulty configuration file ''ipva.vmx''. Such a situation will definitely occur after importing the appliance into vSphere without importing the appliance's configuration file ''ipva.vmx''.
*The solution therefore is a complete conversion of the IPVA as outlined above [[#VMware vSphere | VMware vSphere]].

'''Remarks''' 
The IPVA utilizes a VMware proprietary mechanism for its internal timekeeping<ref>Timekeeping in Virtual Machines http://www.vmware.com/pdf/vmware_timekeeping.pdf</ref>. That mechanism is only available after adding the following line to the configuration file ''ipva.vmx'':
<pre>
monitor_control.pseudo_perfctr = TRUE
</pre>
If that line is not present, the hypervisor is going to throw a CPU exception.

===Why Isn't There An OVA/OVF File Made Available?===
Simply because of the feature discussed in [[##What_Can_I_Do_In_Case_Of_Boot-Problem:_perf-counter_not_enabled.21 | What Can I Do In Case Of Boot-Problem: ''perf-counter not enabled!'']]. That feature can only be described in VMX files and is not projectable onto an OVA/OVF file.

===Are Additional vCPUs useful?===
No, the innovaphone OS is a single task OS. Additional virtual CPUs(vCPUs) cannot be utilized.

==Notes==
<references/>

==Related Articles==
[[Reference9:Licenses]]

[[#A_rough_estimate_of_IPVA_Performance | A rough estimate of IPVA Performance]]

[[Category:Concept|Innovaphone Virtual Appliance]]

Reference10:Concept Innovaphone Virtual Appliance (IPVA)

2014-05-21T09:00:19Z

Kti: /* VMWare Player and Workstation */

[[Category:Concept9|{{PAGENAME}}]]
==Applies To==
This information applies to:
*V10
*innovaphone Virtual Appliance
*Intel/AMD CPUs
*VMware
**Workstation 7.1
**Player 3.x <ref>VMware Player Download(free): http://vmware.com/download/player/</ref>
**vSphere 4.1
**vSphere 5.x
***[[User:Inno-mst|Inno-mst]] 14:25, 16 October 2013 (CEST): vSphere '''5.5''' compatibility has been reported
**Fusion 5.x (Mac OS X 10.7)

==More Information==
The innovaphone Virtual Appliance (IPVA) is a virtual machine to be run on a virtualization platform.
Whereby, VMware<ref>http://www.vmware.com</ref> is is the solely supported virtualization platform to-date.

The IPVA is a software-only solution. It appears as and performs as an innovaphone "hard-box" excluding DSP-, ISDN-/AB-resources.

The following core-components are contained within the IPVA:
*innovaphone PBX
*innovaphone Gateway (a.k.a ''Relay'')
*integrated mass-storage (alike innovaphones' CF-card support)


==Configuration==
[[#Download|Download]] the IPVA.

*The compressed archive ''ipva-vmx.zip'' contains 1 virtual machine configuration file (*.vmx) and 4 virtual machine disk files (*.vmdk):
**ipva.vmx: The virtual machine configuration file
**hd-boot.vmdk: The virtual boot harddisk (hd)
**hd-cf.vmdk: The hd for emulation of a Compact Flash card
**hd-flash.vmdk: The hd for emulation of flash memory
**hd-dump.vmdk: The hd serving as a store for a crash dump

The file ''ipva.bin'' is the firmware file, which is only needed for update purposes.

===VMware Player===
*Copy the IPVA to e.g. your desktop
*Double-click on ipva.vmx
The IPVA is going to be started.

A shortcut (*.lnk file) to the vmx-file will start the IPVA without additional user interaction. Such a shortcut may also be copied into the Windows ''Autostart'' program folder, in order to have the IPVA started automatically on windows startup.
===VMware Workstation===
*Copy the IPVA to e.g. your desktop
*Double-click on ipva.vmx
The IPVA is going to be started.

The ''Workstation 7'' directory comprises the command line utility ''vmrun.exe''. A batch file according to the following pattern may be crafted to programmatically start the IPVA.
<pre>
"D:\Programme\VMware\VMware Workstation\vmrun" start "C:\Users\Tester\Desktop\ipva\ipva.vmx"
</pre>
'''Note''': By altering ''start'' into ''stop'' a virtual machine may be stopped.
===VMware vSphere===
This applies to vSphere 4.x and later (such as e.g. vSphere 5.5). 

====VMware vCenter Converter Standalone====
The IPVA offered for downloading must be converted into a vSphere-processable form.
The IPVA can be converted by means of the tool ''VMware vCenter Converter Standalone''<ref>VMware vCenter Converter Standalone: https://www.vmware.com/tryvmware/?p=converter</ref>.
*A step-by-step guide may be found [http://blog.lewan.com/2009/12/22/vmware-vsphere-using-vmware-converter-to-import-vms-or-vmdks-from-other-vmware-products/ here].
Make sure you ''always use the latest VMware converter'' to convert your IPVA.

See [[#Why_Isn.27t_There_An_OVA.2FOVF_File_Made_Available.3F | here]] for a discussion why the conversion is needed.

===Network Configuration===
Manufacturer-configured as DHCP client only. I.e. a DHCP server must be available. Afterwards the network configuration may be administrated as used to within the web ui of other innovaphone boxes. If there's in no case a DHCP server available for the 1st-time configuration, read through [[#What_Is_The_Console_Good_For?|What Is The Console Good For?]].

====VMWare Player and Workstation====
In order to assign a new MAC address on a VMWare Workstation or VMWare Player:
*Power-off the virtual machine
*Open the file ipva.vmx for editing within a text editor.
*Edit the last 3 hex-values of the lines starting with ''ethernet0.generatedAddress'' & ''uuid.bios'' from e.g.
<pre>
ethernet0.generatedAddress = "00:0c:29:f4:c6:d9"
uuid.bios = "56 4d 64 b9 52 ce 38 57-66 29 e8 f2 77 f4 c6 d9"
</pre>
into e.g
<pre>
ethernet0.generatedAddress = "00:0c:29:f4:c6:da"
uuid.bios = "56 4d 64 b9 52 ce 38 57-66 29 e8 f2 77 f4 c6 da"
</pre>
(Note: in this example just the very last hex-value '''d9''' is going to be altered into '''da''')
*Within my.innovaphone.com try once again to generate licenses for the virtual machine with the new MAC address.

===License Configuration===
For the IPVA10 license see [[Reference10:Licenses]].

The licensing procedure is the same as for other innovaphone products, except for one peculiarity: The MAC address, generated by VMware, may have been assigned already to another customer/installation. Such a conflict must be settled manually as explained below.

If, while generating licenses within ''my.innovaphone.com'', a message ([[Reference:My_Innovaphone#IP-VA_MAC_exists|My_Innovaphone#IP-VA_MAC_exists]]) is displayed:
<pre>
IP-VA MAC exists
</pre>
then a new MAC address must be assigned manually to the affected installation.

'''Note:''' We recommend to not use auto-generated MAC Address for the IPVA machine. Please assign a static MAC address like '00-50-56-...' to prevent license issues if the machine must be rebuild since you will assign the same MAC address after and not the auto-generated MAC.

====VMWare vSphere, ESX/ESXi 4.1 and ESXi====
For information related to vSphere, ESX/ESXi 4.1 and ESXi 5.x, see the Mac Addresses section of the [https://www.vmware.com/support/pubs/vsphere-esxi-vcenter-server-pubs.html vSphere Networking Guide] for your version of ESX/ESXi.

==Provision Of External Resources==
External Resources are required, in order to provide:
*Access to ISDN interfaces
*DSP conferencing channels

The IP1060<ref>[http://www.innovaphone.com/fileadmin/download/newsletter/EINLEGER_IP1060_Produktkatalog2009_2010_DE_ENG.pdf IP1060 Product Information]</ref> media gateway may be considered as a suitable complement for such purposes.
==Download==

[http://download.innovaphone.com/ice/9.00/#firmware IPVA.zip from http://download.innovaphone.com/ice/9.00/#firmware]

==Troubleshooting==
Support procedures are commonly identical to the ones known from innovaphones' physical appliances. Except for:
*'''Post-Mortem Logs''' A post-mortem log must be retrieved by clicking on ''Admistration/Diagnostics/'''trace(crash-dump)''''' (alternatively: http://a.b.c.d/crash_dump.txt).
**Note: Deviating from innovaphones' physical appliances, the DRAM-content(with may be post-mortem info) does not survive a CPU-reset. This is why post-mortem information is going to be stored persistent on the 4th disk, named ''hd-dump.vmdk''.

Some known issues are listed further below under [[#FAQ | FAQ]].

==Known Issues==
===ESX 3.x is unsupported===
The IPVA does not run under ESX 3.x and below, since virtual IDE disks aren't supported.

===Don't use Maintenance/Upload/DRAM on vSphere 4===
Until further notice this way of uploading a new firmware is currently not supported. The VMM detects and assumes the guest (IPVA) is going to shutting-off. All the virtual harddisks may get lost in the aftermath.
vmware.log shows:
<pre>
...

Mar 02 13:02:25.439: vcpu-0| Vix: [4864986 vmxCommands.c:9609]: VMAutomation_HandleCLIHLTEvent. Do nothing.
Mar 02 13:02:25.462: vcpu-0| MsgHint: msg.monitorevent.halt (sent)
Mar 02 13:02:25.462: vcpu-0| The CPU has been disabled by the guest operating system. Power off or reset the virtual machine.

...and then when trying to power-on later...

Mar 03 08:37:00.260: vmx| Destroying virtual dev for ide0:1 vscsi=8303
Mar 03 08:37:00.260: vmx| VMMon_VSCSIStopVports: Invalid handle
Mar 03 08:37:00.260: vmx| VMMon_VSCSIDestroyDev: Not found
Mar 03 08:37:00.260: vmx| Destroying virtual dev for ide1:0 vscsi=8304
Mar 03 08:37:00.261: vmx| VMMon_VSCSIStopVports: Invalid handle
Mar 03 08:37:00.261: vmx| VMMon_VSCSIDestroyDev: Not found
...
</pre>



==FAQ==
===Are Firmware Updates Possible?===
Yes, alike the well-known *.bin firmware files for other innovaphone products (ip6000.bin, ip2000.bin,..) , there's a similar bin-file (ipva.bin) for the IPVA. The file is contained on the boot-hd and can be found by browsing to e.g. http://192.168.0.5/drive/HD-BOOT . The versioning of ipva.bin is the same as for the other products. The firmware file may exactly be uploaded as for other products:
* by ''Upload/Firmware''
* by ''Upload/Dram''
* by a script for the innovaphone Update Process

===What is the ipva default password?===
*user: admin
*password: ipva

===Do I Always Need To Download The Entire IPVA?===
No, after the 1st-time deployment of an entire IPVA only the firmware file ''ipva.bin'' needs to be downloaded from ''download.innovaphone.com''. See [[#Are_Firmware_Updates_Possible.3F| Are Firmware Updates Possible?]] for how to proceed further.
===How Is The Network Connection Being Handled?===
The network connection is pre-configured to: ''Bridged: Connected directly to the physical network''
===What Is The Size Of the Emulated CompactFlash?===
1GB

===Can The Emulated CompactFlash Be Increased In Size?===
Yes, from within the ''Edit Virtual Machine'' dialog. Doing so just increases the size of the virtual harddisk. The emulated CompactFlash must be formatted afterwards and accordingly to benefit from the increased size. That step can be administrated from ''Administration/Compact Flash/Format''. Note: A recommendation for an upper size limit is not given.

'''vSphere / vSphere Client'''

1. At first backup all of your files from CF card 
2. Shutdown the corresponding IPVA 
3. Choose "Properties" of the IPVA 
4. Delete "Harddrive 2" (Hardrive file xxx/xxx_1.vmdk) 

hd-boot.vmdk > xxx.vmdk
hd-cf.vmdk > xxx_1.vmdk
hd-flash.vmdk > xxx_2.vmdk
hd-dump.vmdk > xxx_3.vmdk

5. Create new harddrive 
6. Configure the required size 
7. As "Node of virtual device" select "IDE(0:1)" 
8. Start the IPVA. 
9. "Format" the CF Card and "mount" it (General/Compact-Flash/General)

===What Is The Size Of the emulated Flash Storage on the IPVA?===
The virtual flash storage used to store configuration file of the IPVA and LDAP directory of the PBX is defined with 64 MB and can not be changed. This is two times more than on IP6010. The VMDK-File hd-flash.vmdk is allocated with 100 MB, because VMWare can not handle smaller virtual disks.

===How Much RAM Is Required Per IPVA Instance?===
The downloadable virtual appliance comes preconfigured with 64MB RAM. This amount is seen as a good trade-off for the majority of all installations.
The RAM-size can be administrated by VMware-means.

The minimum RAM size allocatable to an IPVA in VMware is 20MB. This results in a DRAM size seen by the IPVA of 17MB and roughly 8MB allocatable runtime memory after boot. Note though that even a small IP302 model has 17MB allocatable runtime memory after boot.

===What Is The Maximum Amount Of RAM?===
The maximum meaningful RAM setting is 3GB. Memory space beyond that limit will be left unused. Assigning more than 3GB to an IPVA instance doesn't provide any benefit.

===Why Does ''General/Info/DRAM'' Show Less Than the Configured Memory?===
Not all of the configured memory is available to the IPVA. E.g. a bit of memory is occupied by the VMM<ref>Virtual Machine Monitor: A component belonging to the virtualization platform</ref>. The indicator ''General/Info/DRAM'' displays the memory available to the IPVA and is truncated down to a whole number. A boot-trace reveals a bit more about IPVA-available memory as shown in the following excerpt:
<pre>
...
0:0000:030:4 - Intel(R) Core(TM)2 Duo CPU E8400 @ 3.00GHz
0:0000:030:4 - mem(64946176)=61.93MB ...
</pre>

===How Many IPVA Instances Are Possible Per Host?===
There's no worst-case estimate available. For a best-case calculation,
*see [http://www.vmware.com/pdf/vsphere4/r41/vsp_41_config_max.pdf Configuration Maximums VMware vSphere 4.1]
*see [[#How_Much_RAM_Is_Required_Per_IPVA_Instance.3F | How Much RAM Is Required Per IPVA Instance?]]
Additional preformance reflections
*see [[HOWTO:A_rough_estimate_of_IPVA_Performance | A rough estimate of IPVA Performance]]

===Where Has PPP-Functionality Gone?===
PPP-scenarios (PPTP, PPPoE) are not envisaged with the IPVA, because it has only one network interface controller.

'''Update'''(07.Mar.2011), from on 90468:
*PPP has been integrated
*a second network interface is available (now ETH0 and ETH1)
**ETH1 comes pre-configured: ''host-only, disconnected''. I.e. it must be reconfigured manually and by VMware means to become functional.

===Does The IPVA Support Non-VMware Hypervisor Products?===
No, currently it doesn't.

===How do I perform a factory reset?===

replace the 3rd disk, served on IDE 1:0, named hd-flash.vmdk with an empty disk:

[[Image:VM_Settings.png]]

1)download the IPVA and watch out for the file hd-flash.vmdk

2)Power-off the IPVA instance

3)Replace hd-flash.vmdk with the one downloaded in step 1). If on vsphere it may have been assigned a different name. Ensure it’s the one on IDE 1:0.

4)Power-on the IPVA instance

===Is VMWare Fault Tolerance (FT) supported by IPVA?===

Yes, we have successfully tested<ref>[[Howto:Implement_PBX_with_zero_downtime_using_IPVA_and_VMWare_Fault_Tolerance | Howto:Implement PBX with zero downtime using IPVA and VMWare Fault Tolerance]]</ref> VMWare Fault Tolerance<ref>VMWare Fault Tolerance: http://www.vmware.com/products/fault-tolerance/overview.html</ref> with a virtual machine running IPVA on VMWare vSphere 4.1.

===What About VMware Tools?===
VMware Tools are not supported.

===What Is The Console Good For?===
The console is a remains of the early development phase. It resembles the IP3000's serial console. It doesn't offer any convenience like command history or backspace funtionality. Nevertheless may the console be of help in exceptional situations where e.g. the required DHCP server isn't available for 1st-time configuration or in situations where the ip configuration was misconfigured. Thereby any command from a device's config is acceptable.

For instance to configure the static IP address 1.2.3.4/24 on ETH0:
*Click into the console
*Press ENTER
*Enter credentials
*Enter
<pre>
config change IP0 ETH0 /addr 1.2.3.4 /mask 255.255.255.0
config change DHCP0 /mode off
config write
reset
</pre>
Since no backspace is offered it may become a daring task to enter a single line without typos. In case of a typo hit ENTER and input the same line again.
The keyboard layout is the US layout.
[[Image:Ip-via-console.png|center|thumb|200px|Console-edit of IP address]]

Display the IP configuration for ETH0:
<pre>
config show IP0 ETH0
</pre>

Display the DHCP configuration for ETH0:
<pre>
config show DHCP0
</pre>

Additional the DNS-server(s) and the default gateway can be configured:
<pre>
config change IP0 ETH0 /addr 1.2.3.4 /mask 255.255.255.0 /dns 8.8.8.8 /dns2 8.8.4.4
config change IP0 RT0 /gateway 1.2.3.254
config change DHCP0 /mode off
config write
reset
</pre>

Also some simple diagnostics (ping and traceroute) are possible via the console (output is given in the console):
<pre>
mod cmd PING0 tracert 8.8.8.8
mod cmd PING0 ping 8.8.8.8
</pre>

Resetting the entire FLASH space - '''Note, all configuration will get lost'''. this is similar method to the manufacturer reset method from above [[#How_do_I_perform_a_factory_reset.3F|How do I perform a factory reset?]]
<pre>
mod cmd FLASHMAN0 reset all
reset
</pre>

===What Can I Do In Case Of A Checksum Boot Error?===
This paragraph applies, if you experience the following start-up problem.

'''Symptom'''
*the IPVA doesn't start properly
*the console displays
<pre>
checksum wrong! Loading failed for image=IPVA BIN
</pre>
[[Image:ipva-crc-wrong.jpg|center|thumb|200px|Console displays CRC boot error]]

'''Solution'''
*Power-off the IPVA
*Replace the boot harddisk by a fresh one. The boot harddisk is the 1st hd(originally named ''hd-boot.vmdk'').

'''Remarks'''

This problem may occur on a system crash while a firmware update is taking place.

===What Can I Do In Case Of Boot-Problem: ''NIC unavailable!''===
This paragraph applies, if you experience the following start-up problem.

'''Symptom'''
*the IPVA doesn't start properly
*the console displays
<pre>
NIC unavailable!
</pre>
[[Image:ipva-nic-unavailable.jpg|center|thumb|200px|Console displays ''NIC unavailable!'']]

'''Solution'''
*Power-off the IPVA
*Administrate by VMware means: Ensure the correct/expected type of network interface controller(NIC) is going to be offered by the hypervisor.

The IPVA offers driver support for:
*AMD NIC: Am79C970A PCnet-PCI II Single-Chip Full-Duplex Ethernet Controller
**a.k.a ''PCNet32''
**a.k.a ''Vlance''

The AMD-NIC is kind of default. However, the NIC type may be overriden manually and accordingly within the configuration file ipva.vmx as follows
<pre>
ethernet0.virtualDev = "vlance"
</pre>

'''Remarks'''

This problem may occur after a VMware re-configuration of the network settings.

===What Can I Do In Case Of Boot-Problem: ''perf-counter not enabled!''===
This paragraph applies, if you experience the following start-up problem.

'''Symptom'''
*the IPVA doesn't start properly
*the console displays
<pre>
perfcounter-not enabled!!!
</pre>
[[Image:screenshot-ipva-perfcounter-nok.jpg|center|thumb|200px|Console displays ''perfcounter-not enabled!!!'']]

'''Solution''' 
This problem is likely caused by a faulty configuration file ''ipva.vmx''. Such a situation will definitely occur after importing the appliance into vSphere without importing the appliance's configuration file ''ipva.vmx''.
*The solution therefore is a complete conversion of the IPVA as outlined above [[#VMware vSphere | VMware vSphere]].

'''Remarks''' 
The IPVA utilizes a VMware proprietary mechanism for its internal timekeeping<ref>Timekeeping in Virtual Machines http://www.vmware.com/pdf/vmware_timekeeping.pdf</ref>. That mechanism is only available after adding the following line to the configuration file ''ipva.vmx'':
<pre>
monitor_control.pseudo_perfctr = TRUE
</pre>
If that line is not present, the hypervisor is going to throw a CPU exception.

===Why Isn't There An OVA/OVF File Made Available?===
Simply because of the feature discussed in [[##What_Can_I_Do_In_Case_Of_Boot-Problem:_perf-counter_not_enabled.21 | What Can I Do In Case Of Boot-Problem: ''perf-counter not enabled!'']]. That feature can only be described in VMX files and is not projectable onto an OVA/OVF file.

===Are Additional vCPUs useful?===
No, the innovaphone OS is a single task OS. Additional virtual CPUs(vCPUs) cannot be utilized.

==Notes==
<references/>

==Related Articles==
[[Reference9:Licenses]]

[[#A_rough_estimate_of_IPVA_Performance | A rough estimate of IPVA Performance]]

[[Category:Concept|Innovaphone Virtual Appliance]]

Reference9:Concept Innovaphone Virtual Appliance (IPVA)

2014-05-21T08:26:41Z

Kti: /* VMWare Player and Workstation */

[[Category:Concept9|{{PAGENAME}}]]
==Applies To==
This information applies to:
*V9
*innovaphone Virtual Appliance
*Intel/AMD CPUs
*VMware
**Workstation 7.1
**Player 3.x <ref>VMware Player Download(free): http://vmware.com/download/player/</ref>
**vSphere 4.1
**vSphere 5.x
***[[User:Inno-mst|Inno-mst]] 14:25, 16 October 2013 (CEST): vSphere '''5.5''' compatibility has been reported
**Fusion 5.x (Mac OS X 10.7)

==More Information==
The innovaphone Virtual Appliance (IPVA) is a virtual machine to be run on a virtualization platform.
Whereby, VMware<ref>http://www.vmware.com</ref> is is the solely supported virtualization platform to-date.

The IPVA is a software-only solution. It appears as and performs as an innovaphone "hard-box" excluding DSP-, ISDN-/AB-resources.

The following core-components are contained within the IPVA:
*innovaphone PBX
*innovaphone Gateway (a.k.a ''Relay'')
*integrated mass-storage (alike innovaphones' CF-card support)


==Configuration==
[[#Download|Download]] the IPVA.

*The compressed archive ''ipva-vmx.zip'' contains 1 virtual machine configuration file (*.vmx) and 4 virtual machine disk files (*.vmdk):
**ipva.vmx: The virtual machine configuration file
**hd-boot.vmdk: The virtual boot harddisk (hd)
**hd-cf.vmdk: The hd for emulation of a Compact Flash card
**hd-flash.vmdk: The hd for emulation of flash memory
**hd-dump.vmdk: The hd serving as a store for a crash dump

The file ''ipva.bin'' is the firmware file, which is only needed for update purposes.

===VMware Player===
*Copy the IPVA to e.g. your desktop
*Double-click on ipva.vmx
The IPVA is going to be started.

A shortcut (*.lnk file) to the vmx-file will start the IPVA without additional user interaction. Such a shortcut may also be copied into the Windows ''Autostart'' program folder, in order to have the IPVA started automatically on windows startup.
===VMware Workstation===
*Copy the IPVA to e.g. your desktop
*Double-click on ipva.vmx
The IPVA is going to be started.

The ''Workstation 7'' directory comprises the command line utility ''vmrun.exe''. A batch file according to the following pattern may be crafted to programmatically start the IPVA.
<pre>
"D:\Programme\VMware\VMware Workstation\vmrun" start "C:\Users\Tester\Desktop\ipva\ipva.vmx"
</pre>
'''Note''': By altering ''start'' into ''stop'' a virtual machine may be stopped.
===VMware vSphere===
This applies to vSphere 4.x and later (such as e.g. vSphere 5.5). 

====VMware vCenter Converter Standalone====
The IPVA offered for downloading must be converted into a vSphere-processable form.
The IPVA can be converted by means of the tool ''VMware vCenter Converter Standalone''<ref>VMware vCenter Converter Standalone: https://www.vmware.com/tryvmware/?p=converter</ref>.
*A step-by-step guide may be found [http://blog.lewan.com/2009/12/22/vmware-vsphere-using-vmware-converter-to-import-vms-or-vmdks-from-other-vmware-products/ here].
Make sure you ''always use the latest VMware converter'' to convert your IPVA.

See [[#Why_Isn.27t_There_An_OVA.2FOVF_File_Made_Available.3F | here]] for a discussion why the conversion is needed.

===Network Configuration===
Manufacturer-configured as DHCP client only. I.e. a DHCP server must be available. Afterwards the network configuration may be administrated as used to within the web ui of other innovaphone boxes. If there's in no case a DHCP server available for the 1st-time configuration, read through [[#What_Is_The_Console_Good_For?|What Is The Console Good For?]].

===License Configuration===
For the IPVA9 license see [[Reference9:Licenses]].

The licensing procedure is the same as for other innovaphone products, except for one peculiarity: The MAC address, generated by VMware, may have been assigned already to another customer/installation. Such a conflict must be settled manually as explained below.

If, while generating licenses within ''my.innovaphone.com'', a message ([[Reference:My_Innovaphone#IP-VA_MAC_exists|My_Innovaphone#IP-VA_MAC_exists]]) is displayed:
<pre>
IP-VA MAC exists
</pre>
then a new MAC address must be assigned manually to the affected installation.

====VMWare Player and Workstation====
In order to assign a new MAC address (it has to start with 00-0c-29 to be recognized as IPVA in my.innovaphone) on a VMWare Workstation or VMWare Player:
*Power-off the virtual machine
*Open the file ipva.vmx for editing within a text editor.
*Edit the last 3 hex-values of the lines starting with ''ethernet0.generatedAddress'' & ''uuid.bios'' from e.g.
<pre>
ethernet0.generatedAddress = "00:0c:29:f4:c6:d9"
uuid.bios = "56 4d 64 b9 52 ce 38 57-66 29 e8 f2 77 f4 c6 d9"
</pre>
into e.g
<pre>
ethernet0.generatedAddress = "00:0c:29:f4:c6:da"
uuid.bios = "56 4d 64 b9 52 ce 38 57-66 29 e8 f2 77 f4 c6 da"
</pre>
(Note: in this example just the very last hex-value '''d9''' is going to be altered into '''da''')
*Within my.innovaphone.com try once again to generate licenses for the virtual machine with the new MAC address.

====VMWare vSphere, ESX/ESXi 4.1 and ESXi====
For information related to vSphere, ESX/ESXi 4.1 and ESXi 5.x, see the Mac Addresses section of the [https://www.vmware.com/support/pubs/vsphere-esxi-vcenter-server-pubs.html vSphere Networking Guide] for your version of ESX/ESXi.

==Provision Of External Resources==
External Resources are required, in order to provide:
*Access to ISDN interfaces
*DSP conferencing channels

The IP1060<ref>[http://www.innovaphone.com/fileadmin/download/newsletter/EINLEGER_IP1060_Produktkatalog2009_2010_DE_ENG.pdf IP1060 Product Information]</ref> media gateway may be considered as a suitable complement for such purposes.
==Download==

[http://download.innovaphone.com/ice/9.00/#firmware IPVA.zip from http://download.innovaphone.com/ice/9.00/#firmware]

==Troubleshooting==
Support procedures are commonly identical to the ones known from innovaphones' physical appliances. Except for:
*'''Post-Mortem Logs''' A post-mortem log must be retrieved by clicking on ''Admistration/Diagnostics/'''trace(crash-dump)''''' (alternatively: http://a.b.c.d/crash_dump.txt).
**Note: Deviating from innovaphones' physical appliances, the DRAM-content(with may be post-mortem info) does not survive a CPU-reset. This is why post-mortem information is going to be stored persistent on the 4th disk, named ''hd-dump.vmdk''.

Some known issues are listed further below under [[#FAQ | FAQ]].

==Known Issues==
===ESX 3.x is unsupported===
The IPVA does not run under ESX 3.x and below, since virtual IDE disks aren't supported.

===Don't use Maintenance/Upload/DRAM on vSphere 4===
Until further notice this way of uploading a new firmware is currently not supported. The VMM detects and assumes the guest (IPVA) is going to shutting-off. All the virtual harddisks may get lost in the aftermath.
vmware.log shows:
<pre>
...

Mar 02 13:02:25.439: vcpu-0| Vix: [4864986 vmxCommands.c:9609]: VMAutomation_HandleCLIHLTEvent. Do nothing.
Mar 02 13:02:25.462: vcpu-0| MsgHint: msg.monitorevent.halt (sent)
Mar 02 13:02:25.462: vcpu-0| The CPU has been disabled by the guest operating system. Power off or reset the virtual machine.

...and then when trying to power-on later...

Mar 03 08:37:00.260: vmx| Destroying virtual dev for ide0:1 vscsi=8303
Mar 03 08:37:00.260: vmx| VMMon_VSCSIStopVports: Invalid handle
Mar 03 08:37:00.260: vmx| VMMon_VSCSIDestroyDev: Not found
Mar 03 08:37:00.260: vmx| Destroying virtual dev for ide1:0 vscsi=8304
Mar 03 08:37:00.261: vmx| VMMon_VSCSIStopVports: Invalid handle
Mar 03 08:37:00.261: vmx| VMMon_VSCSIDestroyDev: Not found
...
</pre>

===Release Note For V9HF1===
This Note refers to the fix [[Support:DVL-Roadmap_Firmware_V9#IPVA.2C_RAM-Dependent_Flash_Limitation | Support:DVL-Roadmap Firmware V9#IPVA RAM-Dependent Flash Limitation]]
*From on V9HF1 the available flash directory<ref>Flash Directory: Storage for PBX objects</ref> space will be constrained, depending on the available RAM. A loss of PBX objects may occur after an upgrade to V9HF1. In order to prevent such a loss perform the upgrade as follows:
**1)Download and save the current configuration of the affected IPVA.
**2)Upload the new firmware file and reboot.
**3)Upload the config from step 1).
*From on V9HF1 an administrative reduction of the available RAM may lead into a loss of PBX objects. I.e. increasing the RAM isn't critical, while in contrast lowering the amount of RAM lowers the amount of flash directory space.

===V9HF4 Needed For vSphere 5===
V9 Hotfix4 is needed, in order to run the IPVA under vSphere 5.

==FAQ==
===Are Firmware Updates Possible?===
Yes, alike the well-known *.bin firmware files for other innovaphone products (ip6000.bin, ip2000.bin,..) , there's a similar bin-file (ipva.bin) for the IPVA. The file is contained on the boot-hd and can be found by browsing to e.g. http://192.168.0.5/drive/HD-BOOT . The versioning of ipva.bin is the same as for the other products. The firmware file may exactly be uploaded as for other products:
* by ''Upload/Firmware''
* by ''Upload/Dram''
* by a script for the innovaphone Update Process

===What is the ipva default password?===
*user: admin
*password: ipva

===Do I Always Need To Download The Entire IPVA?===
No, after the 1st-time deployment of an entire IPVA only the firmware file ''ipva.bin'' needs to be downloaded from ''download.innovaphone.com''. See [[#Are_Firmware_Updates_Possible.3F| Are Firmware Updates Possible?]] for how to proceed further.
===How Is The Network Connection Being Handled?===
The network connection is pre-configured to: ''Bridged: Connected directly to the physical network''
===What Is The Size Of the Emulated CompactFlash?===
1GB

===Can The Emulated CompactFlash Be Increased In Size?===
Yes, from within the ''Edit Virtual Machine'' dialog. Doing so just increases the size of the virtual harddisk. The emulated CompactFlash must be formatted afterwards and accordingly to benefit from the increased size. That step can be administrated from ''Administration/Compact Flash/Format''. Note: A recommendation for an upper size limit is not given.

'''vSphere / vSphere Client'''

1. At first backup all of your files from CF card 
2. Shutdown the corresponding IPVA 
3. Choose "Properties" of the IPVA 
4. Delete "Harddrive 2" (Hardrive file xxx/xxx_1.vmdk) 

hd-boot.vmdk > xxx.vmdk
hd-cf.vmdk > xxx_1.vmdk
hd-flash.vmdk > xxx_2.vmdk
hd-dump.vmdk > xxx_3.vmdk

5. Create new harddrive 
6. Configure the required size 
7. As "Node of virtual device" select "IDE(0:1)" 
8. Start the IPVA. 
9. "Format" the CF Card and "mount" it (General/Compact-Flash/General)

===What Is The Size Of the emulated Flash Storage on the IPVA?===
The virtual flash storage used to store configuration file of the IPVA and LDAP directory of the PBX is defined with 64 MB and can not be changed. This is two times more than on IP6010. The VMDK-File hd-flash.vmdk is allocated with 100 MB, because VMWare can not handle smaller virtual disks.

===How Much RAM Is Required Per IPVA Instance?===
The downloadable virtual appliance comes preconfigured with 64MB RAM. This amount is seen as a good trade-off for the majority of all installations.
The RAM-size can be administrated by VMware-means.

The minimum RAM size allocatable to an IPVA in VMware is 20MB. This results in a DRAM size seen by the IPVA of 17MB and roughly 8MB allocatable runtime memory after boot. Note though that even a small IP302 model has 17MB allocatable runtime memory after boot.

===What Is The Maximum Amount Of RAM?===
The maximum meaningful RAM setting is 3GB. Memory space beyond that limit will be left unused. Assigning more than 3GB to an IPVA instance doesn't provide any benefit.

===Why Does ''General/Info/DRAM'' Show Less Than the Configured Memory?===
Not all of the configured memory is available to the IPVA. E.g. a bit of memory is occupied by the VMM<ref>Virtual Machine Monitor: A component belonging to the virtualization platform</ref>. The indicator ''General/Info/DRAM'' displays the memory available to the IPVA and is truncated down to a whole number. A boot-trace reveals a bit more about IPVA-available memory as shown in the following excerpt:
<pre>
...
0:0000:030:4 - Intel(R) Core(TM)2 Duo CPU E8400 @ 3.00GHz
0:0000:030:4 - mem(64946176)=61.93MB ...
</pre>

===How Many IPVA Instances Are Possible Per Host?===
There's no worst-case estimate available. For a best-case calculation,
*see [http://www.vmware.com/pdf/vsphere4/r41/vsp_41_config_max.pdf Configuration Maximums VMware vSphere 4.1]
*see [[#How_Much_RAM_Is_Required_Per_IPVA_Instance.3F | How Much RAM Is Required Per IPVA Instance?]]
Additional preformance reflections
*see [[HOWTO:A_rough_estimate_of_IPVA_Performance | A rough estimate of IPVA Performance]]

===Where Has PPP-Functionality Gone?===
PPP-scenarios (PPTP, PPPoE) are not envisaged with the IPVA, because it has only one network interface controller.

'''Update'''(07.Mar.2011), from on 90468:
*PPP has been integrated
*a second network interface is available (now ETH0 and ETH1)
**ETH1 comes pre-configured: ''host-only, disconnected''. I.e. it must be reconfigured manually and by VMware means to become functional.

===Does The IPVA Support Non-VMware Hypervisor Products?===
No, currently it doesn't.

===How do I perform a factory reset?===

replace the 3rd disk, served on IDE 1:0, named hd-flash.vmdk with an empty disk:

[[Image:VM_Settings.png]]

1)download the IPVA and watch out for the file hd-flash.vmdk

2)Power-off the IPVA instance

3)Replace hd-flash.vmdk with the one downloaded in step 1). If on vsphere it may have been assigned a different name. Ensure it’s the one on IDE 1:0.

4)Power-on the IPVA instance

===Is VMWare Fault Tolerance (FT) supported by IPVA?===

Yes, we have successfully tested<ref>[[Howto:Implement_PBX_with_zero_downtime_using_IPVA_and_VMWare_Fault_Tolerance | Howto:Implement PBX with zero downtime using IPVA and VMWare Fault Tolerance]]</ref> VMWare Fault Tolerance<ref>VMWare Fault Tolerance: http://www.vmware.com/products/fault-tolerance/overview.html</ref> with a virtual machine running IPVA on VMWare vSphere 4.1.

===What About VMware Tools?===
VMware Tools are not supported.

===What Is The Console Good For?===
The console is a remains of the early development phase. It resembles the IP3000's serial console. It doesn't offer any convenience like command history or backspace funtionality. Nevertheless may the console be of help in exceptional situations where e.g. the required DHCP server isn't available for 1st-time configuration or in situations where the ip configuration was misconfigured. Thereby any command from a device's config is acceptable.

For instance to configure the static IP address 1.2.3.4/24 on ETH0:
*Click into the console
*Press ENTER
*Enter credentials
*Enter
<pre>
config change IP0 ETH0 /addr 1.2.3.4 /mask 255.255.255.0
config change DHCP0 /mode off
config write
reset
</pre>
Since no backspace is offered it may become a daring task to enter a single line without typos. In case of a typo hit ENTER and input the same line again.
The keyboard layout is the US layout.
[[Image:Ip-via-console.png|center|thumb|200px|Console-edit of IP address]]

Display the IP configuration for ETH0:
<pre>
config show IP0 ETH0
</pre>

Display the DHCP configuration for ETH0:
<pre>
config show DHCP0
</pre>

Additional the DNS-server(s) and the default gateway can be configured:
<pre>
config change IP0 ETH0 /addr 1.2.3.4 /mask 255.255.255.0 /dns 8.8.8.8 /dns2 8.8.4.4
config change IP0 RT0 /gateway 1.2.3.254
config change DHCP0 /mode off
config write
reset
</pre>

Also some simple diagnostics (ping and traceroute) are possible via the console (output is given in the console):
<pre>
mod cmd PING0 tracert 8.8.8.8
mod cmd PING0 ping 8.8.8.8
</pre>

Resetting the entire FLASH space - '''Note, all configuration will get lost'''. this is similar method to the manufacturer reset method from above [[#How_do_I_perform_a_factory_reset.3F|How do I perform a factory reset?]]
<pre>
mod cmd FLASHMAN0 reset all
reset
</pre>

===What Can I Do In Case Of A Checksum Boot Error?===
This paragraph applies, if you experience the following start-up problem.

'''Symptom'''
*the IPVA doesn't start properly
*the console displays
<pre>
checksum wrong! Loading failed for image=IPVA BIN
</pre>
[[Image:ipva-crc-wrong.jpg|center|thumb|200px|Console displays CRC boot error]]

'''Solution'''
*Power-off the IPVA
*Replace the boot harddisk by a fresh one. The boot harddisk is the 1st hd(originally named ''hd-boot.vmdk'').

'''Remarks'''

This problem may occur on a system crash while a firmware update is taking place.

===What Can I Do In Case Of Boot-Problem: ''NIC unavailable!''===
This paragraph applies, if you experience the following start-up problem.

'''Symptom'''
*the IPVA doesn't start properly
*the console displays
<pre>
NIC unavailable!
</pre>
[[Image:ipva-nic-unavailable.jpg|center|thumb|200px|Console displays ''NIC unavailable!'']]

'''Solution'''
*Power-off the IPVA
*Administrate by VMware means: Ensure the correct/expected type of network interface controller(NIC) is going to be offered by the hypervisor.

The IPVA offers driver support for:
*AMD NIC: Am79C970A PCnet-PCI II Single-Chip Full-Duplex Ethernet Controller
**a.k.a ''PCNet32''
**a.k.a ''Vlance''

The AMD-NIC is kind of default. However, the NIC type may be overriden manually and accordingly within the configuration file ipva.vmx as follows
<pre>
ethernet0.virtualDev = "vlance"
</pre>

'''Remarks'''

This problem may occur after a VMware re-configuration of the network settings.

===What Can I Do In Case Of Boot-Problem: ''perf-counter not enabled!''===
This paragraph applies, if you experience the following start-up problem.

'''Symptom'''
*the IPVA doesn't start properly
*the console displays
<pre>
perfcounter-not enabled!!!
</pre>
[[Image:screenshot-ipva-perfcounter-nok.jpg|center|thumb|200px|Console displays ''perfcounter-not enabled!!!'']]

'''Solution''' 
This problem is likely caused by a faulty configuration file ''ipva.vmx''. Such a situation will definitely occur after importing the appliance into vSphere without importing the appliance's configuration file ''ipva.vmx''.
*The solution therefore is a complete conversion of the IPVA as outlined above [[#VMware vSphere | VMware vSphere]].

'''Remarks''' 
The IPVA utilizes a VMware proprietary mechanism for its internal timekeeping<ref>Timekeeping in Virtual Machines http://www.vmware.com/pdf/vmware_timekeeping.pdf</ref>. That mechanism is only available after adding the following line to the configuration file ''ipva.vmx'':
<pre>
monitor_control.pseudo_perfctr = TRUE
</pre>
If that line is not present, the hypervisor is going to throw a CPU exception.

===Why Isn't There An OVA/OVF File Made Available?===
Simply because of the feature discussed in [[##What_Can_I_Do_In_Case_Of_Boot-Problem:_perf-counter_not_enabled.21 | What Can I Do In Case Of Boot-Problem: ''perf-counter not enabled!'']]. That feature can only be described in VMX files and is not projectable onto an OVA/OVF file.

===Are Additional vCPUs useful?===
No, the innovaphone OS is a single task OS. Additional virtual CPUs(vCPUs) cannot be utilized.

==Notes==
<references/>

==Related Articles==
[[Reference9:Licenses]]

[[#A_rough_estimate_of_IPVA_Performance | A rough estimate of IPVA Performance]]

[[Category:Concept|Innovaphone Virtual Appliance]]

Reference10:Concept Innovaphone Virtual Appliance (IPVA)

2014-05-21T08:26:13Z

Kti:

[[Category:Concept9|{{PAGENAME}}]]
==Applies To==
This information applies to:
*V10
*innovaphone Virtual Appliance
*Intel/AMD CPUs
*VMware
**Workstation 7.1
**Player 3.x <ref>VMware Player Download(free): http://vmware.com/download/player/</ref>
**vSphere 4.1
**vSphere 5.x
***[[User:Inno-mst|Inno-mst]] 14:25, 16 October 2013 (CEST): vSphere '''5.5''' compatibility has been reported
**Fusion 5.x (Mac OS X 10.7)

==More Information==
The innovaphone Virtual Appliance (IPVA) is a virtual machine to be run on a virtualization platform.
Whereby, VMware<ref>http://www.vmware.com</ref> is is the solely supported virtualization platform to-date.

The IPVA is a software-only solution. It appears as and performs as an innovaphone "hard-box" excluding DSP-, ISDN-/AB-resources.

The following core-components are contained within the IPVA:
*innovaphone PBX
*innovaphone Gateway (a.k.a ''Relay'')
*integrated mass-storage (alike innovaphones' CF-card support)


==Configuration==
[[#Download|Download]] the IPVA.

*The compressed archive ''ipva-vmx.zip'' contains 1 virtual machine configuration file (*.vmx) and 4 virtual machine disk files (*.vmdk):
**ipva.vmx: The virtual machine configuration file
**hd-boot.vmdk: The virtual boot harddisk (hd)
**hd-cf.vmdk: The hd for emulation of a Compact Flash card
**hd-flash.vmdk: The hd for emulation of flash memory
**hd-dump.vmdk: The hd serving as a store for a crash dump

The file ''ipva.bin'' is the firmware file, which is only needed for update purposes.

===VMware Player===
*Copy the IPVA to e.g. your desktop
*Double-click on ipva.vmx
The IPVA is going to be started.

A shortcut (*.lnk file) to the vmx-file will start the IPVA without additional user interaction. Such a shortcut may also be copied into the Windows ''Autostart'' program folder, in order to have the IPVA started automatically on windows startup.
===VMware Workstation===
*Copy the IPVA to e.g. your desktop
*Double-click on ipva.vmx
The IPVA is going to be started.

The ''Workstation 7'' directory comprises the command line utility ''vmrun.exe''. A batch file according to the following pattern may be crafted to programmatically start the IPVA.
<pre>
"D:\Programme\VMware\VMware Workstation\vmrun" start "C:\Users\Tester\Desktop\ipva\ipva.vmx"
</pre>
'''Note''': By altering ''start'' into ''stop'' a virtual machine may be stopped.
===VMware vSphere===
This applies to vSphere 4.x and later (such as e.g. vSphere 5.5). 

====VMware vCenter Converter Standalone====
The IPVA offered for downloading must be converted into a vSphere-processable form.
The IPVA can be converted by means of the tool ''VMware vCenter Converter Standalone''<ref>VMware vCenter Converter Standalone: https://www.vmware.com/tryvmware/?p=converter</ref>.
*A step-by-step guide may be found [http://blog.lewan.com/2009/12/22/vmware-vsphere-using-vmware-converter-to-import-vms-or-vmdks-from-other-vmware-products/ here].
Make sure you ''always use the latest VMware converter'' to convert your IPVA.

See [[#Why_Isn.27t_There_An_OVA.2FOVF_File_Made_Available.3F | here]] for a discussion why the conversion is needed.

===Network Configuration===
Manufacturer-configured as DHCP client only. I.e. a DHCP server must be available. Afterwards the network configuration may be administrated as used to within the web ui of other innovaphone boxes. If there's in no case a DHCP server available for the 1st-time configuration, read through [[#What_Is_The_Console_Good_For?|What Is The Console Good For?]].

====VMWare Player and Workstation====
In order to assign a new MAC address (it has to start with 00:0c:29 to be recognized as IPVA in my.innovaphone) on a VMWare Workstation or VMWare Player:
*Power-off the virtual machine
*Open the file ipva.vmx for editing within a text editor.
*Edit the last 3 hex-values of the lines starting with ''ethernet0.generatedAddress'' & ''uuid.bios'' from e.g.
<pre>
ethernet0.generatedAddress = "00:0c:29:f4:c6:d9"
uuid.bios = "56 4d 64 b9 52 ce 38 57-66 29 e8 f2 77 f4 c6 d9"
</pre>
into e.g
<pre>
ethernet0.generatedAddress = "00:0c:29:f4:c6:da"
uuid.bios = "56 4d 64 b9 52 ce 38 57-66 29 e8 f2 77 f4 c6 da"
</pre>
(Note: in this example just the very last hex-value '''d9''' is going to be altered into '''da''')
*Within my.innovaphone.com try once again to generate licenses for the virtual machine with the new MAC address.

===License Configuration===
For the IPVA10 license see [[Reference10:Licenses]].

The licensing procedure is the same as for other innovaphone products, except for one peculiarity: The MAC address, generated by VMware, may have been assigned already to another customer/installation. Such a conflict must be settled manually as explained below.

If, while generating licenses within ''my.innovaphone.com'', a message ([[Reference:My_Innovaphone#IP-VA_MAC_exists|My_Innovaphone#IP-VA_MAC_exists]]) is displayed:
<pre>
IP-VA MAC exists
</pre>
then a new MAC address must be assigned manually to the affected installation.

'''Note:''' We recommend to not use auto-generated MAC Address for the IPVA machine. Please assign a static MAC address like '00-50-56-...' to prevent license issues if the machine must be rebuild since you will assign the same MAC address after and not the auto-generated MAC.

====VMWare vSphere, ESX/ESXi 4.1 and ESXi====
For information related to vSphere, ESX/ESXi 4.1 and ESXi 5.x, see the Mac Addresses section of the [https://www.vmware.com/support/pubs/vsphere-esxi-vcenter-server-pubs.html vSphere Networking Guide] for your version of ESX/ESXi.

==Provision Of External Resources==
External Resources are required, in order to provide:
*Access to ISDN interfaces
*DSP conferencing channels

The IP1060<ref>[http://www.innovaphone.com/fileadmin/download/newsletter/EINLEGER_IP1060_Produktkatalog2009_2010_DE_ENG.pdf IP1060 Product Information]</ref> media gateway may be considered as a suitable complement for such purposes.
==Download==

[http://download.innovaphone.com/ice/9.00/#firmware IPVA.zip from http://download.innovaphone.com/ice/9.00/#firmware]

==Troubleshooting==
Support procedures are commonly identical to the ones known from innovaphones' physical appliances. Except for:
*'''Post-Mortem Logs''' A post-mortem log must be retrieved by clicking on ''Admistration/Diagnostics/'''trace(crash-dump)''''' (alternatively: http://a.b.c.d/crash_dump.txt).
**Note: Deviating from innovaphones' physical appliances, the DRAM-content(with may be post-mortem info) does not survive a CPU-reset. This is why post-mortem information is going to be stored persistent on the 4th disk, named ''hd-dump.vmdk''.

Some known issues are listed further below under [[#FAQ | FAQ]].

==Known Issues==
===ESX 3.x is unsupported===
The IPVA does not run under ESX 3.x and below, since virtual IDE disks aren't supported.

===Don't use Maintenance/Upload/DRAM on vSphere 4===
Until further notice this way of uploading a new firmware is currently not supported. The VMM detects and assumes the guest (IPVA) is going to shutting-off. All the virtual harddisks may get lost in the aftermath.
vmware.log shows:
<pre>
...

Mar 02 13:02:25.439: vcpu-0| Vix: [4864986 vmxCommands.c:9609]: VMAutomation_HandleCLIHLTEvent. Do nothing.
Mar 02 13:02:25.462: vcpu-0| MsgHint: msg.monitorevent.halt (sent)
Mar 02 13:02:25.462: vcpu-0| The CPU has been disabled by the guest operating system. Power off or reset the virtual machine.

...and then when trying to power-on later...

Mar 03 08:37:00.260: vmx| Destroying virtual dev for ide0:1 vscsi=8303
Mar 03 08:37:00.260: vmx| VMMon_VSCSIStopVports: Invalid handle
Mar 03 08:37:00.260: vmx| VMMon_VSCSIDestroyDev: Not found
Mar 03 08:37:00.260: vmx| Destroying virtual dev for ide1:0 vscsi=8304
Mar 03 08:37:00.261: vmx| VMMon_VSCSIStopVports: Invalid handle
Mar 03 08:37:00.261: vmx| VMMon_VSCSIDestroyDev: Not found
...
</pre>



==FAQ==
===Are Firmware Updates Possible?===
Yes, alike the well-known *.bin firmware files for other innovaphone products (ip6000.bin, ip2000.bin,..) , there's a similar bin-file (ipva.bin) for the IPVA. The file is contained on the boot-hd and can be found by browsing to e.g. http://192.168.0.5/drive/HD-BOOT . The versioning of ipva.bin is the same as for the other products. The firmware file may exactly be uploaded as for other products:
* by ''Upload/Firmware''
* by ''Upload/Dram''
* by a script for the innovaphone Update Process

===What is the ipva default password?===
*user: admin
*password: ipva

===Do I Always Need To Download The Entire IPVA?===
No, after the 1st-time deployment of an entire IPVA only the firmware file ''ipva.bin'' needs to be downloaded from ''download.innovaphone.com''. See [[#Are_Firmware_Updates_Possible.3F| Are Firmware Updates Possible?]] for how to proceed further.
===How Is The Network Connection Being Handled?===
The network connection is pre-configured to: ''Bridged: Connected directly to the physical network''
===What Is The Size Of the Emulated CompactFlash?===
1GB

===Can The Emulated CompactFlash Be Increased In Size?===
Yes, from within the ''Edit Virtual Machine'' dialog. Doing so just increases the size of the virtual harddisk. The emulated CompactFlash must be formatted afterwards and accordingly to benefit from the increased size. That step can be administrated from ''Administration/Compact Flash/Format''. Note: A recommendation for an upper size limit is not given.

'''vSphere / vSphere Client'''

1. At first backup all of your files from CF card 
2. Shutdown the corresponding IPVA 
3. Choose "Properties" of the IPVA 
4. Delete "Harddrive 2" (Hardrive file xxx/xxx_1.vmdk) 

hd-boot.vmdk > xxx.vmdk
hd-cf.vmdk > xxx_1.vmdk
hd-flash.vmdk > xxx_2.vmdk
hd-dump.vmdk > xxx_3.vmdk

5. Create new harddrive 
6. Configure the required size 
7. As "Node of virtual device" select "IDE(0:1)" 
8. Start the IPVA. 
9. "Format" the CF Card and "mount" it (General/Compact-Flash/General)

===What Is The Size Of the emulated Flash Storage on the IPVA?===
The virtual flash storage used to store configuration file of the IPVA and LDAP directory of the PBX is defined with 64 MB and can not be changed. This is two times more than on IP6010. The VMDK-File hd-flash.vmdk is allocated with 100 MB, because VMWare can not handle smaller virtual disks.

===How Much RAM Is Required Per IPVA Instance?===
The downloadable virtual appliance comes preconfigured with 64MB RAM. This amount is seen as a good trade-off for the majority of all installations.
The RAM-size can be administrated by VMware-means.

The minimum RAM size allocatable to an IPVA in VMware is 20MB. This results in a DRAM size seen by the IPVA of 17MB and roughly 8MB allocatable runtime memory after boot. Note though that even a small IP302 model has 17MB allocatable runtime memory after boot.

===What Is The Maximum Amount Of RAM?===
The maximum meaningful RAM setting is 3GB. Memory space beyond that limit will be left unused. Assigning more than 3GB to an IPVA instance doesn't provide any benefit.

===Why Does ''General/Info/DRAM'' Show Less Than the Configured Memory?===
Not all of the configured memory is available to the IPVA. E.g. a bit of memory is occupied by the VMM<ref>Virtual Machine Monitor: A component belonging to the virtualization platform</ref>. The indicator ''General/Info/DRAM'' displays the memory available to the IPVA and is truncated down to a whole number. A boot-trace reveals a bit more about IPVA-available memory as shown in the following excerpt:
<pre>
...
0:0000:030:4 - Intel(R) Core(TM)2 Duo CPU E8400 @ 3.00GHz
0:0000:030:4 - mem(64946176)=61.93MB ...
</pre>

===How Many IPVA Instances Are Possible Per Host?===
There's no worst-case estimate available. For a best-case calculation,
*see [http://www.vmware.com/pdf/vsphere4/r41/vsp_41_config_max.pdf Configuration Maximums VMware vSphere 4.1]
*see [[#How_Much_RAM_Is_Required_Per_IPVA_Instance.3F | How Much RAM Is Required Per IPVA Instance?]]
Additional preformance reflections
*see [[HOWTO:A_rough_estimate_of_IPVA_Performance | A rough estimate of IPVA Performance]]

===Where Has PPP-Functionality Gone?===
PPP-scenarios (PPTP, PPPoE) are not envisaged with the IPVA, because it has only one network interface controller.

'''Update'''(07.Mar.2011), from on 90468:
*PPP has been integrated
*a second network interface is available (now ETH0 and ETH1)
**ETH1 comes pre-configured: ''host-only, disconnected''. I.e. it must be reconfigured manually and by VMware means to become functional.

===Does The IPVA Support Non-VMware Hypervisor Products?===
No, currently it doesn't.

===How do I perform a factory reset?===

replace the 3rd disk, served on IDE 1:0, named hd-flash.vmdk with an empty disk:

[[Image:VM_Settings.png]]

1)download the IPVA and watch out for the file hd-flash.vmdk

2)Power-off the IPVA instance

3)Replace hd-flash.vmdk with the one downloaded in step 1). If on vsphere it may have been assigned a different name. Ensure it’s the one on IDE 1:0.

4)Power-on the IPVA instance

===Is VMWare Fault Tolerance (FT) supported by IPVA?===

Yes, we have successfully tested<ref>[[Howto:Implement_PBX_with_zero_downtime_using_IPVA_and_VMWare_Fault_Tolerance | Howto:Implement PBX with zero downtime using IPVA and VMWare Fault Tolerance]]</ref> VMWare Fault Tolerance<ref>VMWare Fault Tolerance: http://www.vmware.com/products/fault-tolerance/overview.html</ref> with a virtual machine running IPVA on VMWare vSphere 4.1.

===What About VMware Tools?===
VMware Tools are not supported.

===What Is The Console Good For?===
The console is a remains of the early development phase. It resembles the IP3000's serial console. It doesn't offer any convenience like command history or backspace funtionality. Nevertheless may the console be of help in exceptional situations where e.g. the required DHCP server isn't available for 1st-time configuration or in situations where the ip configuration was misconfigured. Thereby any command from a device's config is acceptable.

For instance to configure the static IP address 1.2.3.4/24 on ETH0:
*Click into the console
*Press ENTER
*Enter credentials
*Enter
<pre>
config change IP0 ETH0 /addr 1.2.3.4 /mask 255.255.255.0
config change DHCP0 /mode off
config write
reset
</pre>
Since no backspace is offered it may become a daring task to enter a single line without typos. In case of a typo hit ENTER and input the same line again.
The keyboard layout is the US layout.
[[Image:Ip-via-console.png|center|thumb|200px|Console-edit of IP address]]

Display the IP configuration for ETH0:
<pre>
config show IP0 ETH0
</pre>

Display the DHCP configuration for ETH0:
<pre>
config show DHCP0
</pre>

Additional the DNS-server(s) and the default gateway can be configured:
<pre>
config change IP0 ETH0 /addr 1.2.3.4 /mask 255.255.255.0 /dns 8.8.8.8 /dns2 8.8.4.4
config change IP0 RT0 /gateway 1.2.3.254
config change DHCP0 /mode off
config write
reset
</pre>

Also some simple diagnostics (ping and traceroute) are possible via the console (output is given in the console):
<pre>
mod cmd PING0 tracert 8.8.8.8
mod cmd PING0 ping 8.8.8.8
</pre>

Resetting the entire FLASH space - '''Note, all configuration will get lost'''. this is similar method to the manufacturer reset method from above [[#How_do_I_perform_a_factory_reset.3F|How do I perform a factory reset?]]
<pre>
mod cmd FLASHMAN0 reset all
reset
</pre>

===What Can I Do In Case Of A Checksum Boot Error?===
This paragraph applies, if you experience the following start-up problem.

'''Symptom'''
*the IPVA doesn't start properly
*the console displays
<pre>
checksum wrong! Loading failed for image=IPVA BIN
</pre>
[[Image:ipva-crc-wrong.jpg|center|thumb|200px|Console displays CRC boot error]]

'''Solution'''
*Power-off the IPVA
*Replace the boot harddisk by a fresh one. The boot harddisk is the 1st hd(originally named ''hd-boot.vmdk'').

'''Remarks'''

This problem may occur on a system crash while a firmware update is taking place.

===What Can I Do In Case Of Boot-Problem: ''NIC unavailable!''===
This paragraph applies, if you experience the following start-up problem.

'''Symptom'''
*the IPVA doesn't start properly
*the console displays
<pre>
NIC unavailable!
</pre>
[[Image:ipva-nic-unavailable.jpg|center|thumb|200px|Console displays ''NIC unavailable!'']]

'''Solution'''
*Power-off the IPVA
*Administrate by VMware means: Ensure the correct/expected type of network interface controller(NIC) is going to be offered by the hypervisor.

The IPVA offers driver support for:
*AMD NIC: Am79C970A PCnet-PCI II Single-Chip Full-Duplex Ethernet Controller
**a.k.a ''PCNet32''
**a.k.a ''Vlance''

The AMD-NIC is kind of default. However, the NIC type may be overriden manually and accordingly within the configuration file ipva.vmx as follows
<pre>
ethernet0.virtualDev = "vlance"
</pre>

'''Remarks'''

This problem may occur after a VMware re-configuration of the network settings.

===What Can I Do In Case Of Boot-Problem: ''perf-counter not enabled!''===
This paragraph applies, if you experience the following start-up problem.

'''Symptom'''
*the IPVA doesn't start properly
*the console displays
<pre>
perfcounter-not enabled!!!
</pre>
[[Image:screenshot-ipva-perfcounter-nok.jpg|center|thumb|200px|Console displays ''perfcounter-not enabled!!!'']]

'''Solution''' 
This problem is likely caused by a faulty configuration file ''ipva.vmx''. Such a situation will definitely occur after importing the appliance into vSphere without importing the appliance's configuration file ''ipva.vmx''.
*The solution therefore is a complete conversion of the IPVA as outlined above [[#VMware vSphere | VMware vSphere]].

'''Remarks''' 
The IPVA utilizes a VMware proprietary mechanism for its internal timekeeping<ref>Timekeeping in Virtual Machines http://www.vmware.com/pdf/vmware_timekeeping.pdf</ref>. That mechanism is only available after adding the following line to the configuration file ''ipva.vmx'':
<pre>
monitor_control.pseudo_perfctr = TRUE
</pre>
If that line is not present, the hypervisor is going to throw a CPU exception.

===Why Isn't There An OVA/OVF File Made Available?===
Simply because of the feature discussed in [[##What_Can_I_Do_In_Case_Of_Boot-Problem:_perf-counter_not_enabled.21 | What Can I Do In Case Of Boot-Problem: ''perf-counter not enabled!'']]. That feature can only be described in VMX files and is not projectable onto an OVA/OVF file.

===Are Additional vCPUs useful?===
No, the innovaphone OS is a single task OS. Additional virtual CPUs(vCPUs) cannot be utilized.

==Notes==
<references/>

==Related Articles==
[[Reference9:Licenses]]

[[#A_rough_estimate_of_IPVA_Performance | A rough estimate of IPVA Performance]]

[[Category:Concept|Innovaphone Virtual Appliance]]

Reference10:Licenses

2014-02-06T13:15:02Z

Kti:

Reference:My Innovaphone

2013-08-09T07:43:56Z

Kti: /* Release dates */

==About==
My innovaphone replaces the former license manager.
It will also include the handling of device warranty and software service agreements (only partially implemented yet).

===Project-View===
My innovaphone offers the possibility for several users to be in one company. This company shares its balance of licenses over all users and can have several projects. Projects have their own balance of license types and devices are bound to a project.

===Language===
My innovaphone will support multiple languages. You can select your desired language at the top of the page. 
Currently supported languages:
* English
* German
* Italian
* Dutch
* French

===Guides===

====Quickstart guide====
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_nl.pdf Dutch quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_en.pdf English quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_fr.pdf French quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_de.pdf German quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_it.pdf Italian quickstart guide] 

====SSA guide====
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_en.pdf English SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_fr.pdf French SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_de.pdf German SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_it.pdf Italian SSA guide] 

==First steps==
Open [https://my.innovaphone.com my.innovaphone.com] and click the "Register Now" link.
Enter your personal data and register.

You will receive a registration email with an activation link.
After account activation you have two options:
* create a new my innovaphone company (under Licenses->Company)
* ask another user of your company to add your user account to an already existing company

If you accidentally created an own my innovaphone company, just ask another user of your company to import your just created company.

If you create a new company, you can '''optionally''' enter your innovaphone account ID (which is your customer number with innovaphone) with your postal code, to retrieve your company data.

You will see a help link at the right side of the horizontal tab menu.
This link shows the corresponding text of the wiki section, when hovering with the mouse over it,
and redirects to the corresponding wiki menu, if clicked.

It is now possible, that one user is member of serveral companies!

==Search==
At the right top of the page you have a search field. You can search for different things:
* Devices (part of a device name or device comment)
* Projects (part of a project name or project description)
* Own activation keys (part of an activation key or its description)

You have to enter at least '''three''' chars to start a search. To search for activation keys,
you have to enter at least '''five''' chars.
* Search for license types. Enter e.g. "PBX-Port8" to find all devices with Port8 licenses or enter "PBX-Port8=100" to find all devices with Port8 licenses '''>=''' 100.

==Licenses==
===Projects===
After creation of an own company, you will have a default project named "DEFAULT". You can rename this project later.
You can also create more projects on the projects page with "Create".
Each project of a company must have a unique name.

Do '''not''' set SSA, if you want to import your devices from your old license manager account first.
If you want SSA and you '''won't import''' devices into this project from your old account, you should set SSA at once.

You can select a certain project by activating it in the project list. This selection is then true for all other pages, as some pages require a selected project.

[[Image:overview.jpg|center|thumb|200px|Projects page]]

By activating a project by clicking on the project name in the project list, you can manage this project and its settings.

====Properties====
Rename the project or/and change its description. 
 
Since version 10, an innovaphone device will automatically connect to http://config.innovaphone.com/init
This script looks at the project properties of the project, where the device exists. 
You can configure an update '''URL''' and a '''trusted certificate'''.

====Software Service====
You can put your project under SSA (software service agreement).
You will be asked to enter a SSA end date. This will be the date, where all SSA licenses of all devices in this project will expire.
The end date mustn't be more than one year in the past. 
Optionally you can enter a maximum SSC amount. The SSA end date will be automatically calculated then. 
If you have entered a maximum SSC amount, you have to use the '''Recalculate''' link to calculate a new SSA end date,
if you change your license selection.
 
You can also calculate SSA over all projects at once. In this mode, you '''won't be able''' to confirm the calculation. You'll just see the necessary SSC amount.

After entering a date/SSC amount, you will get a summary of all licenses, which will be put under SSA and the amount of needed SSC licenses.
The SSC value for each license is calculated by the bind date of the license and the entered SSA end date/SSC amount.

[[Image:Ssa_extend.jpg|center|thumb|200px|SSA summary]]

If you have licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the current license version. 

e.g. you have a V7 PBX-PBX7#15 license with bind date 1/1/2010. Version 8 was released on 7/12/2009, so SSA is
calculated from 7/12/2009 for this license. You will see the calculation date in the list under "bind date"

If licenses already have a SSA date, just the difference between the current SSA date and the entered SSA end date must be paid.
If the bind date of the device lies in the past, the difference between the bind date and the current date must be paided twice (this is the column 'days*2'). 
If your license is under SSA, which is already over, you also have to pay the time between the old SSA date and the current SSA end date twice.

Here is a short example, how the days are calculated:

Bind date: 24/06/2009 
Current date: 31/08/2009 
SSA end date: 12/12/2011 
 
You will have to pay from 24/06/2009 to 31/08/2009 twice for 68 days.
From 31/08/2009 to 12/12/2011 you will then have to pay the normal price for 833 days.

You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

You can preview the SSC calculation for another calculation date. Simply change the dropdown
selection to get the new SSC value.
Of course you can't confirm this calculation for another date, just for the current date!

''You may add additional licenses to the calculation, which you will bind later''. Just click on the '''+''' near this text and you can add
multiple licenses, which will be added to your calculation after using the recalc link. Listed are licenses of the current version and from
your balance.

After confirming your entered SSA end date, each license will have this date as SSA end date and can be downloaded in all versions of this SSA time.

You can now extend the projects SSA end date like as setting a new one.
The resulting summary is the same as above.

If your user account has the right to buy licenses on credit, just check the checkbox.
You may enter an order number, which you can use for your order, if you buy on credit.

=====Past SSA end date=====

You can configure a new SSA end date in the past, if you accidentally configured a wrong date. 
No licenses will be changed, if you configure a date in the past, just the SSA end date of the project!

=====SSA Expiry Mail=====

If project SSA will expire, each company user will receive a reminder mail '''7''' weeks before and
then every week one mail.
You can disable these mails with the checkbox 'Send SSA expiry mails'.
Note that every user can configure, if he wants to receive mails or not in his account settings.

If you want the end user of the project to receive an expiry mail, you can configure a '''reseller''' mail address and end user mail addresses. These end users will then receive an email, 30 days before the project will expire. The default text is:

<code type="text">
Your Software Service Agreement for your innovaphone PBX in project "{$arg[3]}" will expire in {$arg[1]} days.
Please contact your reseller {$arg[2]} to upgrade the license. 
The upgrade of the license is important to secure the phone system!
</code>

You can change this text as you want. You can use placeholders:
* '''{$arg[1]}''': days left
* '''{$arg[2]}''': reseller mail address
* '''{$arg[3]}''': project name
 
You can also define a global text for all projects under your [[Reference:My_Innovaphone#Company | Company settings]].

You can optionally configure to receive project SSA independent reminder mails for each license of a device [[Reference:My_Innovaphone#Company_2|here]].

=====Automatic SSA Extension Service=====

You can request an automatic SSA extension service for a project, which is under SSA. By following this link, you will have the opportunity to request a callback and/or the necessary agreement as PDF file.

All licenses have to be under SSA to use the automatic SSA extension service!

There are some basics to know, if a project is under automatic SSA:
* If you bind new/free licenses, they'll get SSA until the current project SSA date and you will receive an invoice for the SSCs
* If you move devices into this project, their licenses will get SSA until the current project SSA date and you will receive an invoice for the SSCs
* You can't join this project into another project, but you can join another project into this one

====Rights====
=====Own project=====
Add or delete company rights for this project. To add a company right, you have to enter the company id of this company.
Each user of a company with rights on this project can add devices, licenses, activation keys to this specific project, but is restricted in removing devices, editing the project and can't create activation keys with the projects balance.

The company id can be found under Licenses->company and the company tab.

[[Image:Project_rights.jpg|center|thumb|200px|Project rights]]

=====External Project=====
If another company granted access rights to a project to you, you can unsubscribe from this project here.

====Import====
To download old licenses created with an old license manager account and to use your old balance, you have to import your old account data.
You will have to enter your old account login from license.innovaphone.com. Afterwards you will get a list of your balance and of all your devices with their licenses.
The shown balance is the balance of all users, which belong to your old group (if you belonged to a group).
You can now select all devices which you want to import to the currently selected project.
There might be errors, if you try to add a device. They are explained [[Howto:My_Innovaphone#Image_explanation|here]].

By confirming this import, all users of your group will be locked in the old license manager.

You can import all not yet imported devices to another project, if you want.

Importing of your old balance and devices might take a while!

You can also import just one mac address, if you are the owner of the device, but haven't created any licenses in the old account. Your old account and its balance won't be affected then.

====Join====
Here you can join your currently selected project with another project, which you select from a dropdown box. 
If the other project has SSA, you'll see the current SSA end date, which you might change for the join process and you will get a list of all licenses, which might be updated to the ssa end date/changed date of the other project. The list equals the list shown under [[Reference:My_Innovaphone#Software_Service|Software Service]].

The selected project will be automatically deleted after the join. You can't join a project,
if it grants external rights to another customer. Delete these rights before.

You can't change the SSA end date, if the other project is under automatic SSA! You will receive an invoice for SSCs used for the join.

====Project Move (admin only)====
A company admin can move a project with its devices, activation keys, balance etc. to another company. You have to know the company ID from this company, which can be found under Licenses->Company and the company tab. 
The history won't be moved!

Projects with negative balances can't be moved!

Existing project rights will be deleted.

====Delete====
Delete the project. Only possible if it has no activation keys, project rights, devices or user rights.
 
You may [[Reference:My_Innovaphone#Join|join]] your project into another one, if you can't delete it.

====Project Freed_RMA_licenses====
If you see a project with this name in your project list, you had a RMA device with not yed moved licenses, which was shipped to innovaphone and reshipped to another customer. 
The licenses of such a device have been moved into the pool of free licenses of the project Freed_RMA_licenses, from where you can assign them to another device.

===Balance===
On the balance page you will see the balance of the currently selected project or the balance of all your projects together.
The balance is bound to your company and '''not''' to your user account. The balance is bound to a specific project, but can be shared for license creation or activation key creation if wished. 
Sharing the balance over several projects is not possible in external projects!

[[Image:Balancepage.jpg|center|thumb|200px|Balance page]]

====Free licenses====

Here you see a list of all your free licenses. If you return licenses from one of your devices, the returned licenses are stored in your free licenses pool. You can assign these licenses to another device (see [[#Add licenses from free licenses|'Add licenses from free licenses']]) or convert them to your balance.

[[Image:Balance_free_lics.jpg|center|thumb|200px|Free licenses list]]

The bind date, SSA end date and the external key (like DECT-Multi-Cell-Ari) are stored for each license.

If you want to convert these licenses to your balance, you will have to pay one year SSC for each unit and all external key bindings and the current SSA will be lost. 
If the license you convert is under SSA, you will be able to select the version to convert the license to.

===Activations===

You'll see a list of all your bound activation keys with their licenses here.

[[Image:Activations.jpg|center|thumb|200px|Activation key page]]

====Add an activation key====
To increase your projects balance, select one of your projects, follow the "Add" link and enter the activation key in the corresponding field. You can also enter an optional comment for this key. You will then get a listing of all contained licenses. After commiting this key, your project balance will have been increased by the keys values.

"Deselect the current project" to view all activation keys independent of the selected project.

====Search for an activation key by your order number====
Enter your own order number (or nothing), to view your activation keys for this order.

====License certificate====
You can always download the innovaphone license certificate for activation keys in your projects. Simply press the download link in the list at the right side.

===Own Activations===
Here you'll see a list of all created activation keys in the selected project (or over all projects).

You can create activation keys on the project page for other users/companies or to simply transfer licenses from one project to another. 
You can enter a comment, an order number and an order reference. The '''order number''' is your own order number for the key and the '''order reference''' is the reference number of the customer, who receives the newly created key. 
The order reference and order number will be shown in the innovaphone license certificate.

[[Image:Created_activations.jpg|center|thumb|200px|Created activation keys]]

You have to select an activation key in the activation key list to update or delete it.

Updating and deleting a key is only possible, if this key is not assigned.

====Update====
Add more licenses to this key or change its comment, order number and order reference. 
You can also remove licenses by entering e.g. -2, if you want to remove 2 licenses from the key.

[[Image:Own activations update.jpg|center|thumb|200px|Update own activation keys]]

====Delete====
Delete this key. Its licenses will go back into the balance of the currently selected project.

===Devices===
To view your devices you first have to click on the "Show" button. You can leave the filter field empty if you want to view all your devices.

[[Image:Devices_page.jpg|center|thumb|200px|The Devices Page]]

Red marked device names are devices, which are currently in RMA.

MAC addresses of RMA devices do not longer start with 01-...

====List====
A List of your devices in the currently selected project. 
You can deselect the current project/device to list all your devices.

Select a certain device from the device list, to manage its properties, licenses etc.

Actions on multiple devices:
* Move: move several devices into another project at once (see [[Howto:My_Innovaphone#Move_device|Move Device]])
* Remove: remove several devices at once (see [[Howto:My_Innovaphone#Remove|Remove]])

=====Add=====
Follow the "Add new devices" link on the devices page.

There you have a few options:
* You can add a single new device
* You can add devices according to a mac address range (e.g. from 00-90-33-08-20-00 to 00-90-33-08-22-00), maximum 50 at once
* You can add devices by uploading a text file with mac addresses like this (maximum 50 at once, each line one mac):

00-90-33-08-20-20
00-90-33-08-20-21
00-90-33-08-20-22
00-90-33-24-20-20

* You can add devices according to your received order number. Just enter you order number and you will get a list of all devices bount to this number.

Note: MAC addresses can be always given like this:
* 00-90-33-xx-xx-xx
* 00:90:33:xx:xx:xx
* 009033xxxxxx
* xxxxxx (00-90-33- will then be added automatically)

There might be errors, if you try to add a device. They are explained [[Howto:My_Innovaphone#Image_explanation|here]].

As the device warranty will be handled by licenses now, you can also add telephone devices
to your projects.

=====Add warranty extensions=====

Here you can add warranty extension licenses for all devices in the currently selected project. 
You'll get a list of all devices with the corresponding license type(s) and you can specify the years for each device (or for all devices by entering the number in the list header). 
After confirming your selection, you'll get an overview of all needed licenses, which you have to confirm too.

=====Check licence, SSA and warranty status of a device=====
Here you can list licenses with ssa and the warranty end date of a device, which is not in one of your projects. 
This is just available with the needed right.

=====Download devices of an order as CSV=====
Enter an order number to retrieve all devices for this order in a CSV file.

=====V7 master/slave scenario to V8 floating calculation=====

This gives you the possibility to calculate the SSCs for the change from a V7 master/slave scenario to a V8 floating installation. 
The calculation date is the date for which the calculation is valid. The final SSA date is an option to calculate SSA for the final masters licenses, if wished. 
Then you select the master and the slaves. 
If you want to have Standby/Voicemail licenses on the master, you have to select 'Yes' on the corresponding radio button. Maybe some new licenses must be bought depending on your setup. Theses licenses will be shown on the next page. 
At last you have the possibility to add further PBX port licenses, if you want to extend your installation and calculate SSCs for the new licenses.

====Properties====

Change the name and comment of a device.
You can only change the name, if it's no MAC or IPEI.
 
Here you have also the possibility, to directly request RMA for this device with prefilled values.

====Licenses====
Here you can add, download or move licenses.

=====Add licenses from balance=====
To create new licenses for a device, you have to add this device first on the devices page and then select a version of the license
and whether you want to summate the current licencing. If you select current licenses, then older licenses for example V6 or V7 licenses will also be counted as V8 licenses in the next overview. This is necessary if you want to license a V6 unit with V8 licenses, but still want to use it as V6.
After that click "Next".
On the next page you will see a list of all available license types, which depends on your current available license types, of the selected license version and the device type (IP6000, IP800 e.g.):
[[Image:licenses.jpg|center|thumb|200px|Licenses for an IP3000]]
 
If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses to this SSA end date or you can optionally change this date to another one for the new licenses.
 
You see the available project balance, the balance over all projects (excluding external projects), the currently installed licenses and the maximum amount for this device type. You can now enter the value of the new license.
Base/Upgrade licenses can be selected via dropdown box.
'''Voicemail and Standby lics must always have the same amount as the selected PBX-PBX... license!
The maximum amount of PBX-Registration licenses equals the amount of the selected PBX-PBX... license!'''

The whished overall amount of pbx version 8 and above licenses can be specified here and the concrete amount of license sub types will be requested on the next page.

You can preview the SSC calculation of the wished licenses without having them in your balance.

[[Image:licenses2.jpg|center|thumb|200px|Licenses for an IP800 with V8, step two]]

The best (cheapest) combination of each v8 pbx license type is already filled in, but you might change the amount of sub types if your does not fit and you do not want to purchase new activation keys for the sub types.

The column SSC/Unit is just shown if your project is currently under SSA and you have entered a SSA end date.

The SSC multiplicator is the value, which you have to multiplicate with each license unit to get
the corresponding SSC amount.
E.g. if you have 20 units of PBX-Port8*20 licenses with a SSC value of 54 and a multiplicator of
1.0000 (which equals to 365 days) you have to pay 20*54*1.0000 ~ 1080 SSCs.

 If you create licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the currently selected version twice. 
e.g.: you want to bind licenses for V6 with SSA, so you have to pay SSCs from the release date of V7
 You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

You can't change the SSA end date, if the project is under automatic SSA! You will receive an invoice for SSCs used for the new binding.

Now confirm your new selection. If you have not enough licenses in your current project, but there are still licenses in other projects, you will get a dropdown box with a list of all projects containing the needed licenses. You can now select all desired/needed projects and confirm your selection again.
The balance of all selected projects will then be decreased by the needed amount.
 
 
If your user account has the right to buy licenses on credit, just check the checkbox.
 
You may enter an order number, which you can use for your order, if you buy on credit.

=====Add licenses from free licenses=====

Here you can assign licenses, which you returned from other devices.
You will also have to select the desired version and will than get a list of fitting licenses according to the current device and selected version.

[[Image:licenses_free.jpg|center|thumb|200px|Free Licenses for an IP800 with V8]]

If a license is under SSA, the correct license type is shown in column 'License Type' besides the 'Original Type'.
On confirming the selection, a consistency check is done (e.g. only 4 Relay-PRI licenses on an IP6000).
Bind and SSA end date will be maintained for each license.

As external keys are also maintained, you can select e.g. an old Dect-Multicell-Ari license to have the same ARI on another IP1200.
 

If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses
to this SSA end date or you can optionally change this date to another one for the new licenses.
You will have to confirm this after your first license selection (this is the same calculation as [[Reference:My_Innovaphone#Software_Service|here]]).

You can't change the SSA end date, if the project is under automatic SSA! You will receive an invoice for SSCs used for the binding.

=====Add V7 floating license (slave pbx)=====
Here you can add a V7 floating license for a slave pbx. A device with a floating license can't have V7 pbx licenses and a device with V7 pbx licenses can't have a floating license.

=====Delete V7 floating license=====
Here you can delete an already existing floating license, if you won't use it anymore.

=====Add warranty extension licenses=====
Extend your warranty by adding warranty extension licenses:

[[Image:add_warranty.jpg|center|thumb|200px|Warranty extension]]

If you add the warranty extension immediately after the receipt of your device,
you can add the cheaper warranty extension licenses, otherwise you'll have to add
the more expensive ones.

You can extend the warranty for a maximum of four years.

=====Download licenses=====

[[Image:Device_download.jpg|center|thumb|200px|Download Licenses]]

You will get a dropdown with all available versions. Versions are dependent of your device, your licenses and of the ssa of your licenses. 
'''From V9 on''', you just have one option, which will create a license file, which contains the licenses upgraded to the highest version of their type. 
You are able to download downgraded versions of your licenses. E.g. if you have only V8 licenses, you can download a V7 license file (same restrictions as below).

Downgrades or only possible down to version 6!

If you do not want to download licenses by version, you have to decide whether to download the licenses encrypted or not.
'''If you download the licenses unencrypted, you won't be able to return those licenses anymore.'''
So you won't be able to return licenses for devices with V5-V7 licenses, as licenses for these versions are not encrypted.
To return these licenses, you will have to upgrade to a new bootcode, which prevents firmware downgrades to versions below version 8. 
Encrypted licenses are stored in a xml file, which you can then upload on your V8 (or higher) device.

You can now also download licenses directly from by the web interface of a device.
You just have to enter your account data and start downloading the licenses from my.innovaphone.com
without having to download/upload a license file.

=====Download test licenses=====

[[Image:Device_download_test.jpg|center|thumb|200px|Download test licenses]]

You can also download test licenses if you want to run tests. You will be asked, which version you want to use, whether the device is used as slave and if not used as slave, how many pbx licenses you want to use.

V5 does '''not''' support test licenses!

=====Move licenses to another device=====
If you have the needed account rights or the device is already in RMA, you can move licenses to another device. After moving licenses, the former device will be marked as a RMA device.

You can just move licenses to devices without licenses!

====Move device====
Here you can move the current device or the selected devices to another project. 
If you select a SSA project, you can change the SSA end date for the move process. 

If the other project is under SSA, you will first see a SSC calculation, which you have to confirm,
as the SSA date for each SSA license will be extended until the given SSA end date
(this is the same calculation as adding SSA to an already existing project, see [[Reference:My_Innovaphone#Software_Service|here]]).

You can't change the SSA end date, if the other project is under automatic SSA! You will receive an invoice for SSCs used for the move.

====Invalidation====

=====Requirements=====
* V8 or higher
* access to the webinteraface
* a device certificate
* my.innovaphone login credentials
* '''no IPVA device'''

=====Informations=====

You can invalidate V8 (or higher) licenses by uploading the XML file, you got from your device or by returning your licenses over the web interface of your device ([[Reference8:Configuration/General/License]]), in order to return [[Reference8:Licenses#Gateway_Licenses|PBX licenses]] back to the balance.

V7 licenses can be just returned, if you agree, that you won't be able to downgrade below V8 anymore. You will need a new bootcode, to use this function. '''You need a V8 firmware or higher for invalidation.'''

If your device has access to my.innovaphone.com, you can also invalidate licenses directly
from the web interface of the device.

[[Reference8:Licenses#Gateway_Licenses|gateway licenses]] and warranty extensions won't be returned to the balance and remain to be assigned to the device!

The licenses needn't be present on the device to perform the invalidation!

=====Process=====

Steps to invalidate licenses, if your device has internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# enter your my.innovaphone account, the device must be in one of your projects
# click Invalidate
# click Transfer (this might fail, if NTP or DNS is not configured properly or device certificate is not installed)
# reset if asked for

Steps to invalidate licenses, if your device has no internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# click Invalidate
# click Backup and upload this file on my.innovaphone [[Reference:My_Innovaphone#Upload_the_invalidation_document_to_return_licenses|here]]
# you'll get a confirmation file after uploading the saved file
# upload this on the device (under Step1)
# reset if asked for

"Your IP800 does not have a device certificate on it." - In this case you need to download a hardware certification,
please contact the innovaphone [mailto:support@innovaphone.com support].

=====Download confirmation file=====
If you created a new certificate or you invalidated your licenses, you can later download the confirmation file, which you have to upload on the box.

=====Request certificate=====
If you have the needed rights, you can request a new device certificate for your device.

=====Upload the invalidation document to return licenses=====
Upload the invalidation document, which you got from the website of the device to return the licenses of this device.

After uploading you'll get a confirmation file, which you have to upload on your device.

====Remove====
You can always remove devices from a project. If they have licenses, these won't be deleted, so you might add the device to another project again.

===History===
[[Image:history.jpg|center|thumb|200px|History page]]
You can view your history for several contexts:
* Company: history of all actions in your company
* User: history of all actions of the selected user
* Device: history of all actions for the selected device

Each context applies to the currently selected project.
If you deselect the current project, you will see the history over all projects.

You can select to view the history of the last day, week, month, year or from always. Collecting data might take a while...

===Company===
Manage users, import other companies or change your company data.
The first user of a company has automatically company admin rights and can grant this right to other company users after adding their accounts email address. 

====Users====

[[Image:company.jpg|center|thumb|200px|Company page]]
Here you can add other users to your company, optionally with '''company admin rights'''.
You can also '''lock''' a user account or grant company admin rights. 
Locked users can't loggin to my.innovaphone.com any more. 
Instead of locking a user you can also '''remove''' this user from your company. The user itself will still have his my.innovaphone account, but won't belong to your company any more. The history of this user is still available after having removed him.

Non company admin users just get a non editable list of the current company users.

A user can be member of several companies and the users rights, company admin and
locked status can be different for all companies, where this user is in.

=====My innovaphone Viewer=====
If you check this flag for a user, this user won't be able to do any changes to your projects, devices and licenses. He will be just able to view projects, devices, SSA settings etc.

====Join (admin only)====
As admin you can also join another company into your company by entering an admin account of this company. This might be usefull if one user of your company has accidentally created an own company. 
Everything like projects, users, devices, balance, activations etc. will be imported! 
You also have to enter the company id of the company, which is to be imported. You can find this company under Licenses->Company and the company tab.

This is not available for non company admin users.

The joined company will be deleted afterwards!

====Company====
If you do not belong to a my innovaphone company, you can create one here. You can optionally enter an innovaphone account ID with its zip code or you just enter your company data below.

[[Image:company_create.jpg|center|thumb|200px|Company create page]]

Otherwise you can change your company data, but only, if you didn't created your company with your innovaphone account id. In this case, company information is always retrieved from your innovaphone account.
Non company admin users can just view the current company data.

You also see your company id here, which is sometimes needed for adding external project rights or
to be imported by another company.

You can check the '''Device SSA''' checkbox, if you want to receive SSA expiry reminder mails for each device independent of the projects SSA end date.
These mails will be send weekly seven weeks before the SSA for a license a the device expires.
 
 
You can also enter additional email addresses, which should receive SSA emails.
 
You can define a global '''end user expiry mail text''' here, which will be sent to end users, if end users are configured in a [[Reference:My_Innovaphone#SSA_Expiry_Mail | project]]. This text can be overridden by a text in a project under [[Reference:My_Innovaphone#SSA_Expiry_Mail | SSA Expiry Mail]].

====Partner Status====
You can review the partner status of the users of your company. 
You also see a list of companies, which granted partner status access to you.

=====Manage Partner Status Access=====
Grant or remove access rights to your own partner status. 
You can enter the [[ Reference:My_Innovaphone#Company_2 | company ID ]] of another my.innovaphone company. Afterwards, this company will have access to '''your''' partner status.

====New Company====
If you need several companies for some reasons, you can create another one here. 
You will be an admin user in this new company and you can directly select the newly created company at the top right corner.

==RMA==
Here you can see all your RMA devices, which arrived innovaphone already. The licenses of this macadresses are moveable.
[[Image:rma.jpg|center|thumb|200px|RMA page]]
 
If you want to request RMA for a certain device, go to the device properties and follow the "Request RMA" link.

==Mantis==
Here you'll get a list of all open support cases in our mantis system, which are assigned to email addresses of your my.innovaphone users in your company.

==Configurator==
Currently this is just a link to the [http://config.innovaphone.com innovaphone PBX Configurator]

==Account==
Here you can change your personal data, password etc. You always have to enter your current password to change your data. 
You can also configure, if you want to receive SSA expiry mails!

If you change your email address, you'll have to activate your account again.

==Company selection==
If your user account belongs to several companies, you can switch between companies be using the dropdown box at the top right corner of the page. 
You'll get an error, if you try to switch to a company, where your account is locked. 

[[Image:company_selection.jpg|center|thumb|200px|Dropdown box for company selection]]

 
If you loggin, the first found company is selected for your user.

==Image explanation==

===Errors===

====Already In Company====
[[Image:Icon_in_company_inno_01.png]]
* This device already exists in your company and can't be added/imported.
If you want to import this device anyway, you first have to delete your current device from its project.

====Already Imported====
[[Image:Icon_imported_inno_01.png]]
* This device has been already imported.
You can't import it again.

====Not Found====
[[Image:Icon_not_found_inno_01.png]]
* This device was not found in the my innovaphone database.
This should never happen, but if, contact the administrator.

====IPVA MAC exists====
[[Image:Icon_ip_va_exists_inno_01.png]]
* An IPVA MAC address must be unique and can be assigned to just one company. You tried to add an already existing IPVA MAC.
Please assign a new one to your IPVA. For further details, see [[Reference9:Concept_Innovaphone_Virtual_Appliance#License_Configuration]].

===Warnings===

====Several Companies====
[[Image:Icon_several_companies_inno_01.png]]
* This device is already in another company.
This means, that either you do not have the physical device or it once belonged another company.
You can still import/add this device and you will have access to all of its current licenses.

====Several Users====
[[Image:Icon several users inno 01.png]]
* This device has licenses from several users of the old license manager.
This means, that you are not neccessarily the user, who physically owns this device. If you do not own it, do not import it.

===Misc===
====No downgrade====
[[Image:no_downgrade.png]]
* Licenses, which have been downloaded for V5/V6/V7, were returned from this device, so no downgrade to these versions is allowed any more.



==Release dates==
V5: 01/01/2003 
V6: 02/11/2006 
V7: 14/11/2008 
V8: 07/12/2009 
V9: 26/04/2011 
V10: 08/07/2013 



==Known Issues==
===Smaller issues===
* Devices where imported into a project with SSA. If this happened to you, please move the corresponding devices into a project '''without''' SSA and back into the project '''with''' SSA to extend/add SSA for the licenses until the SSA end date.
* IE7 moves a list under the menu, when a list becomes to wide
===Licenses don't work on a device, where an invalidation has been done===
A possible reason here is, that the invalidation process hasn't been completed.
To resolve this issue, follow these steps:

* Download the Confirmation File (Certificate) from http://my.innovaphone.com under [[Reference:My_Innovaphone#Invalidation|Invalidation]] after selecting the project and the device
* Open [[Reference9:General/License/my.innovaphone|General->License->my.innovaphone.com]] on your device
* Click on "Invalidate" (no my.innovaphone credentials needed)
* Upload the previously downloaded confirmation file newcert-00-90-33-xx-xx-xx.xml as "Confirmation file"
* Reset the box
* Reupload the licenses

Reference9:Licenses

2011-10-25T12:34:09Z

Kti: /* PBX Floating mechanism */

Licenses are used on the innovaphone gateways to enable specific features so that the customers have to pay for features only, which they actually use. There are 3 different types of licenses: For the Gateway (Relay), the PBX and DECT.

== Gateway Licenses ==

;Channels: Enables the use of the number of DSP channels as specified in the license. A DSP channel is needed for each call to a ISDN interface, an analog Interface or a conference interface. If no license is availabe the call is rejected.

;BRIs: Enables the use of a ISDN Basic Rate Interface. Only licensed interfaces are displayed in the user interface and can be used for calls. Which interface is enabled is chosen by a default sequence. If other interfaces are desired, interfaces can be disabled, which means they do not consume a license.

;PRIs: Enables the use of a ISDN Primary Rate Interface. Only licensed interfaces are displayed in the user interface and can be used for calls. Which interface is enabled is chosen by a default sequence. If other interfaces are desired, interfaces can be disabled, which means they do not consume a license.

;Gatekeeper7: Enables the gatekeeper functionality on version 7,8 and version 9. Which means the gateway VOIP interface type 'Gatekeeper/Registrar' is available.

===Built in Licenses===

Since the release of version 7 some hardware platforms already come fully equipped with all necessary interface licenses. The units are:

* IP22
* IP24
* IP28
* IP302

This includes also the required ''Channel'' licenses. Built-in licenses are not shown in the ''Licenses'' table in [[Reference7:Administration/Gateway/General|''Gateway / General'']].

== PBX Licenses ==

All PBX licenses contain a version number, which is indicated by <v> in the follwing text (Example: Port<v> for Version 9 is Port9).

If on a PBX licenses of the same type but with different versions are installed, the lowest version is used for all licenses of this type (Example: If Port8=50, Port9=100 and Port10=50 is installed, the effektive license is Port8=200).

For licenses used on the PBX itself (Port, IPVA, Mobility, Voicemail, Standby) the version must be at least the version of the PBX (Example on a PBX Version 9, Port8 cannot be used, but Port9, Port10, ...).

For licenses used by external applications (SoftwarePhones, Operator, QueueMonitor, Reporting), the version of the external applications defines which license is needed. (Example: On a PBX Version 9, an Operator8 license maybe installed).

;Port<v>: Port License. To register endpoints at PBX objects. Multiple endpoints can register at one object and only one port license is used. A port license gets used when an object has at least one registration. Objects without registration do not use licenses.

;Port<v>*20: Port License. To register endpoints at PBX objects. This SMB version can not be installed at a slave PBX and can only be used for one device/project. Maximum 20 Ports of this SMB version are possible, for more ports normal port licenses must be added.

;IPVA<v>: IPVA License. To allow registrations at the PBX running on IPVA, this license is needed in combination with the '''PORT9''' ('''PORT9*20''') license. As much as PORT9 licenses are in use as much IPVA9 licenses are needed. There may be less IPVA9 licenses installed then Port9 licenses, because with slave obtaining their license from a Master PBX some Ports may be used on IPVA and some on Gateways.

;Mobility<v>: License to enable Mobility function for a user object.

;Voicemail<v>: License to use the innovaphone voicemail script. Must be at least the same as the port license.

;Standby<v>: License to enable Standby operation. Must be at least the same as the port license. With this license a PBX accepts registrations from endpoints not configured for this PBX, which should happen only if the PBX where the endpoint is configured for, is not available. A standby license installed without a port license does not do anything.

;SoftwarePhones<v>: License to use a innovaphone software phone (not for the Bria softphone)

;Operator<v>: License to use the innovaphone operator software.

;QueueMonitor<v>: License to use the [[Howto:PBX-QueueMonitor |PBX queue monitor ]], one license needed per queue monitor.

;Reporting<v>: License to use the [[Reference9:Concept Reporting |reporting application]]. For each object that reports are generated for, a license is needed. The reporting license must not be the same size as the port license.

Port licenses are used for trunk, executive, gateway ,user and PBX objects (for registering slave and dyn PBXs).

** Note : If you do any License changing, adding or deleting, the PBX needs a reboot so that the license changes become effective.

==== Example IPVA====

Running a PBX on IPVA with 100 port licenses, 90 port licenses are in use (there are registrations on 90 objects), then also 90 IPVA licenses are needed. When a new endpoint tries to register at a new object, the registration will be denied. There are enough port licenses that a endpoint could register, but not enough ipva licenses. If there are more registrations on one user object only one port license is in use and thus only one ipva license needed.

===== VMware HA and FT =====

Using the VMware HA (high availability solution) or the FA (Fault Tolerance) with the innovaphone IPVA, no extra innovaphone licenses are needed (even no standby license).
* Note : This VWware features are not yet tested by innovaphone

==== Example PBX-QueueMonitor====

This is a concurrent licence, means if one queue monitor connects at the PBX one license is consumed, if the queue monitor is off the licence gets released. Example 1: One waiting queue should be monitored by 5 PBX-queue monitor, so 5 licenses are needed. Example 2: 3 waiting queues, on the first waiting queue 3 PBX queue monitor ,on the second one PBX monitor and on the third no PBX monitor.
So 4 licenses are needed.

====Example Reporting====

A PBX with 100 port licenses, but only for the waiting queue and 10 user objects reports should be done. Therefore only 11 reporting licenses need to be purchased.
On the waiting queue and the 10 user objects the reporting chek-mark must be set, then the innovaphone reporting can generate reports for that objects.

====Example Mobility====

A user object requires a Port license if there is at least one registration on it. A user using a mobility object (that is, a forking destination and a mobility object is defined) requires a Mobility license per destination. A forking destination with no mobility object defined require no Mobility license. The mobility client (which is to be installed on the mobile phone) will require a GSM license.

So if you create a user object with a VoIP terminal registration and a forking destination with mobility, then you will need 1 Port license and 1 Mobility license. If on the user object there are no registrations but a forking destination with mobility enabled, then it will need 1 Mobility license but no Port license. If there are no registrations and a forking destination without mobility, then no license at all is required.

The standard configuration (a user object with registrations and a mobility enabled forking destination and a mobile phone with mobile client installed) requires 1 Port plus 1 Mobility plus 1 GSM license.

In summary you also can have more Mobility lics than you have port lics.

=== PBX Floating mechanism===

If no Port license is installed locally on a slave/standby PBX it obtains automatically all PBX licenses from the master. If this option is used, Port licenses need to be installed for the total number of endpoints in the system on the master.

Slaves with locally installed licenses can be mixed with Slaves obtaining their licenses from the master.

A slave/standby stores the received license in flash memory so it can still operate even if the master is not available.

License updates between master and slaves are sent in intervals of approximately 10min to limit the bandwidth usage. Because of this it may happen that temporarily more licenses can be used than actually available.

It is not necessary/possible to buy floating licenses. You can use them without a balance in my.innovaphone.com. There is no license needed at all to use the floating mechanism.

It is possible to use a V8 Slave and a V9 Master Firmware.

=== Licensing for Standby operation ===

If a PBX shall operate as standby (either as dedicated standby or as a master being standby for a slave, or as a slave being standby for a master), a standby license with at least the value of the Port license must be available. This Standby license can be obtained from the Master by the use of the Floating mechanism.

==== Examples ====

'''Dedicated Standby (Standby/Standby-Slave)'''

No PBX licenses should be installed on the Standby, to obtain the licenses from the master and a Standby license of the correct size has to be installed on the master.

'''Master acting as Standby'''

If a master should accept registrations which are configured for slaves, in case the slaves are not available a Standby license of at least the size of the Port licenses needs to be installed on this master.

'''Slave acting as Standby for Master'''

If a slave should accept registrations which are not configured for this slave, in case the master is not available, a standby license of at least the size of the Port license must be available on the slave. If the licenses are obtained from the master by the use of the Floating mechanism the Standby license must be installed on the master, if local licenses are used, the standby license must be installed on the slave.

== DECT Licenses ==

{|
|valign=top nowrap=true|'''Multicell'''
|The Multicell license enables the Multicell master and defines the System Identification (ARI) on the wireless side, installed on the IP1200.
|}

Reference9:General/License/my.innovaphone

2011-10-12T13:07:35Z

Kti: /* Error codes */

= Config account =
Here you can enter and save your authorization credentials.

= Download licenses =
Here you can make the IPxxx download pre-generated licenses from [http://my.innovaphone.com my.innovaphone.com].
Only licenses that match the serial number of the IP800 will be downloaded.

After successful download the licenses are displayed for inspection.
You can verify the licenses and save permanently on the IP800.

= Download Certificate =
If your device has no hardware certificate, you can't invalidated licenses, until you download one from my.innovaphone. 
The device '''must''' have access to the internet and your my.innovaphone account '''must''' have rights (granted by innovaphone) to download a new certificate. 
After a successful download, you just have to reset the device and you can invalidate your licenses.

= Invalidate licenses =
Here you can invalidate your current licenses irrevocably in order to re-create new [[Reference8:Licenses#Gateway_Licenses|PBX licenses]] for this or another hardware. The license invalidation is a two-step process:
*In a first step the installed licenses and the device certificate are invalidated.
*In a second step the invalidation document in transferred to [http://my.innovaphone.com my.innovaphone.com].
Upon successful transfer the returned [[Reference8:Licenses#Gateway_Licenses|PBX licenses]] are booked to your account balance. The [[Reference8:Licenses#Gateway_Licenses|gateway licenses]] remain to be assigned to the device, since it is not possible to return [[Reference8:Licenses#Gateway_Licenses|gateway licenses]] back to the balance.

If you invalidate licenses prior V8 or licenses, which you already downloaded unencrypted from my.innovaphone,
downgrading to versions '''prior''' V8 '''won't be possible''' any more!

= Error codes =

== DNS failed ==
Your IPxxx failed to resolve the license manager's domain name.
Check the IP configuration of your IPxxx.

== Server unreachable ==
DNS lookup for license manager's domain name was successful, but connection establishment failed anyway.
Check the IP configuration of your IPxxx.

== Server certificate rejected ==
Server has been connected, but server's certificated has been rejected.
Open the certificate manager on your IPxxx and make the server's certificated trusted.

== You do not have access rights to this device ==
License manager rejected IPxxx due to failed client authentication. Enter or double check the configured account.

== No licenses available ==
No licenses have been prepared for your IPxxx. Visit the license manager web interface and prepare licenses for your IPxxx.

== Invalid user credentials ==
Check your login information.

== Transport Error ==
No NTP time set.

Reference9:Phone/Protect

2011-09-26T15:13:05Z

Kti:

* '''Protect configuration at phone''': Password protect changes of the administrative, phone and user configurations at the phone.
* '''Hide configuration at phone''': Do not display the administrative, phone and user configurations at the phone, these can be changed only via the WEB interface. The “Administration” menu displays version info only. The “User Setup”, “Phone Setup”, “User Setup” and “User list” are hidden.
* '''Hide private call information''': Show only calls from/to the currently active registration in call lists.
* '''[[Reference7:Fine grained function locking|Numbers for emergency calls]]''': Comma separated list of numbers (including any necessary prefix) permitted to call when the phone is locked. An empty list means that no calls are permitted when the phone is locked.
* '''[[Reference7:Fine grained function locking|Prefixes for External Calls]]''': Comma separated list of prefixes not permitted to dial when the phone is disabled for external calls via lock mask.
* '''[[Reference7:Fine grained function locking|Fine grained function locking]]''': Bit mask to selectively disable certain functions when the phone is not locked.
* '''[[Reference7:Fine grained function locking|Functions to lock via PIN]]''': Bit mask to define the functions disabled when the phone is locked by PIN, by default everything except emergency calls.
* '''[[Reference9:Concept_Fine_grained_function_hiding|Fine grained function hiding]]''' : Bit mask to define the functions hidden from phone menus
* '''[[Howto:Disable_Function_Key_Modification_On_Phone_UI|Function keys not modifiable on the phone]]''' : Bit mask to define which function keys are not modifiable on the phone User Interface.

==Related Articels==
[[Reference:Fine grained function locking ]]

Howto:Download BRIA

2011-09-23T09:10:34Z

Kti:

To download the BRIA softphone installer go to [http://download.innovaphone.com/ice/download/p/3rd-party-sw/Bria/ download.innovaphone.com/ice/download/p/3rd-party-sw/Bria/].

[[Category:Faq|{{PAGENAME}}]]

Howto:Pcap

2011-07-27T10:05:47Z

Kti: /* Requirements */

With remote PCAP, network traffic can be captured directly from another network device, instead of capturing the network traffic from the own device.

==Remote PCAP==
===Requirements===

* You should have installed the latest wireshark release >= 1.6 with the latest innovaphone dll [http://www.wireshark.org/download.html Wireshark Download]
* Required and optional tools (innovaphone_winXX.dll and log2pcap.exe): open the [http://download.innovaphone.com/ice/download/p/6.00/apps/6000041%20(Voice%20Mail,%20TAPI,%20SoftwarePhone,%20Operator%20final)/tools.zip V6 application folder] and download the tools.zip. You will just need the innovaphone_win32.dll or innovaphone_win64.dll, depending on your installed wireshark version, 32 bit or 64 bit. Older wireshark versions won't work with the latest innovaphone_winXX.dll!
* To view the standard debug output, you have to install the innovaphone_winXX.dll, which you'll find in the tools package. Just copy the dll to your wireshark plugin directory and pay attention on your currently used version (e.g.: c:\programme\wireshark\plugins\1.6.0\).
* To view ISDN LAPD/Q.931 packets, you also have to install the innovaphone.dll.
* Open the [http://wiki.innovaphone.com/index.php?title=Image:Pcap_example_isdn.zip example pcap file with lapd and q.931 packets] to check your current installation. It should look like this, if you have the innovaphone_winXX.dll correctly installed:

[[Image:Pcap_sample_isdn.jpg|center|thumb|200px|PCAP ISDN example]]

===Setting up the rpcap server===

* The rpcap server can be any innovaphone device.
* The remote pcap server is disabled per default. To enable it, just go to Diagnostics->Tracing and check the "Enable" flag in the "Remote PCAP" group. If you are experiencing problems, also enable the trace flag with "config add PCAP /trace".
* To capture all ip traffic (udp and tcp), enable the "IP (all tcp/udp traffic)" flag in the group "IP". Otherwise just enable all the trace flags on the modules you want to capture.

===Capturing with wireshark===

Open your wireshark and the capture options dialogue.
Type "rpcap://IP/TRACE" into the interface field.

It should look like this:
[[Image:Wireshark_capture_options.jpg|center|thumb|200px|Wireshark capture options]]

Then just click on "Start" to start capturing.

===Supported protocols===

* ISDN: LAPD L2/L3 with dissector innovaphone.dll (enable Diagnostics->Tracing TELX/PRIX/PPP)
* AC DSP: dsp with dissector Ac49xPacketRecording.dll (enable Diagnostics->Tracing->VOIP DSP)
* PPPoE: flag "/pcap" on module(s) PPPOE0/PPPOE1 enables pcap tracing

* All TCP/UDP protocols which are supported by native wireshark dissectors or other dissectors which can be found searching the internet.
e.g.:
SIP
H.323
H.245

Enable the corresponding flags under Diagnostics->Tracing, if you only want to see specific UDP/TCP protocols. To see all, enable the "All TCP/UDP Traffic" flag under Diagnostics->Tracing.

==PCAP Log==

Another possibility to get a pcap log file is to open http://IP/log.pcap
This file has a limited size just as the normal log file.

==log2pcap==

You need the tool log2pcap from the tools package, if you have a log.txt file, which contains pcap packets and you want to view them in wireshark. You can find the tool in the apps tool package (see above).

Usage:
# log2pcap.exe input1 input2 ... inputX
# drag&drop one or more files on the log2pcap.exe
# use an asterix like "log2pcap c:\*.txt" to convert all txt files into pcap files. Things like c:\test*.txt are not supported.

* The resulting file name is always inputx.pcap (e.g. log.txt is converted into log.txt.pcap).

Note: if you have a trace of a little endian box (e.g. IP3000, IP21) with V6 SR1 or SR2, you have to use the "-srlefix" switch (available since 08-1007):

log2pcap.exe input1 -srlefix

==General Informations==

===Reading PCAP Traces===

Non-IP Pcap packets will nevertheless show source and destination IP addresses. 127.0.0.1 stand in for the traced device. So if for example a Q.931 SETUP messages is sent from 127.0.0.0 to 127.0.0.1, then it is an incoming setup.

===Disabling PCAP traces===

You can disable the whole pcap tracing. Just configure a /disable-pcap to the CMD0 module. This can be useful if you do not want to see pcap traces in your log file.

===Used ports===

* The debug traces are encapsulated in UDP packets with port 4.
* The isdn traces are encapsulated in UDP packets with port 4.
* The ac dsp traces are encapsulated in UDP packets with port 50001.
* Wireshark uses port 2002 to connect to the running rpcap-server
* rpcap packets are transfered over a dynamically assigned port between server and client

===Additional Remote PCAP trace===

You can trace the remote pcap protocol with adding the trace flag by "config add PCAP /trace" if you are experiencing connection issues.

===Timestamps===

Since V7 Hotfix 26 and V8 Hotfix 13, the ntp timestamp is used instead of the uptime in rpcap packages. In converted log files with log2pcap, uptime is still used.

==Known Problems==

* Converting a log from a little endian box (like IP3000 and IP21) with firmware V6 SR1 or SR2 with the tool log2pcap will only work with log2pcap 08-1007 or higher and the switch "-srlefix", see [[:#log2pcap|log2pcap]].
* Ac49xPacketRecording.dll works only with 0.99.7. Higher versions of wireshark won't start, if this dll was copied to the dll folder!
* Also some other dlls, contained in the tools package, won't work with each wireshark version. Just innovaphone.dll is always working.
* Even though ''All TCP/UDP Traffic'' is turned on, packets sent to the box acting as rpcap provider to a port that is not handled by the box (that is, where no listening socket is active) will currently not be shown
* If you use a 64-bit Windows Pc then you will need another innovaphone.dll, which is also contained in the latest tool package.
* The custom IP header from captured innovaphone packets contains dummy values for TOS (0), id (0), fragment offset (0) and TTL (128)

==Related Articles==

[[Category:Howto|{{PAGENAME}}]]

Reference:My Innovaphone

2011-03-07T10:55:33Z

Kti: /* Process */

==About==
My innovaphone replaces the former license manager.
It will also include the handling of device warranty and software service agreements (only partially implemented yet).

===Project-View===
My innovaphone offers the possibility for several users to be in one company. This company shares its balance of licenses over all users and can have several projects. Projects have their own balance of license types and devices are bound to a project.

===Language===
My innovaphone will support multiple languages. You can select your desired language at the top of the page. 
Currently supported languages:
* English
* German
* Italian
* Dutch
* French

===Guides===

====Quickstart guide====
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_nl.pdf Dutch quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_en.pdf English quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_fr.pdf French quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_de.pdf German quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_it.pdf Italian quickstart guide] 

====SSA guide====
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_en.pdf English SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_fr.pdf French SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_de.pdf German SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_it.pdf Italian SSA guide] 

==First steps==
Open [https://my.innovaphone.com my.innovaphone.com] and click the "Register Now" link.
Enter your personal data and register.

You will receive a registration email with an activation link.
After account activation you have two options:
* create a new my innovaphone company (under Licenses->Company)
* ask another user of your company to add your user account to an already existing company

If you accidentally created an own my innovaphone company, just ask another user of your company to import your just created company.

If you create a new company, you can '''optionally''' enter your innovaphone account ID (which is your customer number with innovaphone) with your postal code, to retrieve your company data.

You will see a help link at the right side of the horizontal tab menu.
This link shows the corresponding text of the wiki section, when hovering with the mouse over it,
and redirects to the corresponding wiki menu, if clicked.

It is now possible, that one user is member of serveral companies!

==Search==
At the right top of the page you have a search field. You can search for different things:
* Devices (part of a device name or device comment)
* Projects (part of a project name or project description)
* Own activation keys (part of an activation key or its description)

You have to enter at least '''three''' chars to start a search. To search for activation keys,
you have to enter at least '''five''' chars.
* Search for license types. Enter e.g. "PBX-Port8" to find all devices with Port8 licenses or enter "PBX-Port8=100" to find all devices with Port8 licenses '''>=''' 100.

==Licenses==
===Projects===
After creation of an own company, you will have a default project named "DEFAULT". You can rename this project later.
You can also create more projects on the projects page with "Create".
Each project of a company must have a unique name.

Do '''not''' set SSA, if you want to import your devices from your old license manager account first.
If you want SSA and you '''won't import''' devices into this project from your old account, you should set SSA at once.

You can select a certain project by activating it in the project list. This selection is then true for all other pages, as some pages require a selected project.

[[Image:overview.jpg|center|thumb|200px|Projects page]]

By activating a project by clicking on the project name in the project list, you can manage this project and its settings.

====Properties====
Rename the project or/and change its description.

====SSA====
You can put your project under SSA (software service agreement).
You will be asked to enter a SSA end date. This will be the date, where all SSA licenses of all devices in this project will expire.
The end date mustn't be in the past.

After entering a date, you will get a summary of all licenses, which will be put under SSA and the amount of needed SSC licenses.
The SSC value for each license is calculated by the bind date of the license and the entered SSA end date.

[[Image:Ssa_extend.jpg|center|thumb|200px|SSA summary]]

If you have licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the current license version. 

e.g. you have a V7 PBX-PBX7#15 license with bind date 1/1/2010. Version 8 was released on 7/12/2009, so SSA is
calculated from 7/12/2009 for this license. You will see the calculation date in the list under "bind date"

If licenses already have a SSA date, just the difference between the current SSA date and the entered SSA end date must be paid.
If the bind date of the device lies in the past, the difference between the bind date and the current date must be paided twice (this is the column 'days*2'). 
If your license is under SSA, which is already over, you also have to pay the time between the old SSA date and the current SSA end date twice.

Here is a short example, how the days are calculated:

Bind date: 24/06/2009 
Current date: 31/08/2009 
SSA end date: 12/12/2011 
 
You will have to pay from 24/06/2009 to 31/08/2009 twice for 68 days.
From 31/08/2009 to 12/12/2011 you will then have to pay the normal price for 833 days.

You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

You can preview the SSC calculation for another calculation date. Simply change the dropdown
selection to get the new SSC value.
Of course you can't confirm this calculation for another date, just for the current date!

After confirming your entered SSA end date, each license will have this date as SSA end date and can be downloaded in all versions of this SSA time.

You can now extend the projects SSA end date like as setting a new one.
The resulting summary is the same as above.

If your user account has the right to buy licenses on credit, just check the checkbox.
You may enter an order number, which you can use for your order, if you buy on credit.

If project SSA will expire, each company user will receive a reminder mail '''7''' weeks before and
then every week one mail.
You can disable these mails with the checkbox 'Send SSA expiry mails'.
Note that every user can configure, if he wants to receive mails or not in his account settings.

You can optionally configure to receive project SSA independent reminder mails for each license of a device [[Reference:My_Innovaphone#Company_2|here]].

====Rights====
Add or delete company rights for this project. To add a company right, you have to enter the company id of this company.
Each user of a company with rights on this project can add devices, licenses, activation keys to this specific project, but is restricted in removing devices, editing the project and can't create activation keys with the projects balance.

The company id can be found under Licenses->company and the company tab.

[[Image:Project_rights.jpg|center|thumb|200px|Project rights]]

====Import====
To download old licenses created with an old license manager account and to use your old balance, you have to import your old account data.
You will have to enter your old account login from license.innovaphone.com. Afterwards you will get a list of your balance and of all your devices with their licenses.
The shown balance is the balance of all users, which belong to your old group (if you belonged to a group).
You can now select all devices which you want to import to the currently selected project.
There might be errors, if you try to add a device. They are explained [[Howto:My_Innovaphone#Image_explanation|here]].

By confirming this import, all users of your group will be locked in the old license manager.

You can import all not yet imported devices to another project, if you want.

Importing of your old balance and devices might take a while!

You can also import just one mac address, if you are the owner of the device, but haven't created any licenses in the old account. Your old account and its balance won't be affected then.

====Join====
Here you can join your currently selected project with another project, which you select from a dropdown box. 
If the other project has SSA, you'll see the current SSA end date, which you might change for the join process and you will get a list of all licenses, which might be updated to the ssa end date/changed date of the other project. The list equals the list shown under [[Reference:My_Innovaphone#SSA|SSA]].

The selected project will be automatically deleted after the join. You can't join a project,
if it grants external rights to another customer. Delete these rights before.

====Delete====
Delete the project. Only possible if it has no activation keys, project rights, devices or user rights.
 
You may [[Reference:My_Innovaphone#Join|join]] your project into another one, if you can't delete it.

====Project Freed_RMA_licenses====
If you see a project with this name in your project list, you had a RMA device with not yed moved licenses, which was shipped to innovaphone and reshipped to another customer. 
The licenses of such a device have been moved into the pool of free licenses of the project Freed_RMA_licenses, from where you can assign them to another device.

===Balance===
On the balance page you will see the balance of the currently selected project or the balance of all your projects together.
The balance is bound to your company and '''not''' to your user account. The balance is bound to a specific project, but can be shared for license creation or activation key creation if wished. 
Sharing the balance over several projects is not possible in external projects!

[[Image:Balancepage.jpg|center|thumb|200px|Balance page]]

====Free licenses====

Here you see a list of all your free licenses. If you return licenses from one of your devices, the returned licenses are stored in your free licenses pool. You can assign these licenses to another device (see [[#Add licenses from free licenses|'Add licenses from free licenses']]) or convert them to your balance.

[[Image:Balance_free_lics.jpg|center|thumb|200px|Free licenses list]]

The bind date, SSA end date and the external key (like DECT-Multi-Cell-Ari) are stored for each license.

If you want to convert these licenses to your balance, you will have to pay one year SSC for each unit and all external key bindings and the current SSA will be lost. 
If the license you convert is under SSA, you will be able to select the version to convert the license to.

===Activations===
To increase your projects balance, select one of your projects, follow the "Add" link and enter the activation key in the corresponding field. You can also enter an optional comment for this key. You will then get a listing of all contained licenses. After commiting this key, your project balance will have been increased by the keys values.

"Deselect the current project" to view all activation keys independent of the selected project.

[[Image:Activations.jpg|center|thumb|200px|Activation key page]]

====License certificate====
You can always download the innovaphone license certificate for activation keys in your projects. Simply press the download link in the list at the right side.

===Own Activations===
Here you'll see a list of all created activation keys in the selected project (or over all projects).

You can create activation keys on the project page for other users/companies or to simply transfer licenses from one project to another. 
You can enter a comment, an order number and an order reference. The '''order number''' is your own order number for the key and the '''order reference''' is the reference number of the customer, who receives the newly created key. 
The order reference and order number will be shown in the innovaphone license certificate.

[[Image:Created_activations.jpg|center|thumb|200px|Created activation keys]]

You have to select an activation key in the activation key list to update or delete it.

Updating and deleting a key is only possible, if this key is not assigned.

====Update====
Add more licenses to this key or change its comment, order number and order reference. 
You can also remove licenses by entering e.g. -2, if you want to remove 2 licenses from the key.

[[Image:Own activations update.jpg|center|thumb|200px|Update own activation keys]]

====Delete====
Delete this key. Its licenses will go back into the balance of the currently selected project.

===Devices===
To view your devices you first have to click on the "Show" button. You can leave the filter field empty if you want to view all your devices.

[[Image:Devices_page.jpg|center|thumb|200px|The Devices Page]]

Red marked device names are devices, which are currently in RMA.

MAC addresses of RMA devices do not longer start with 01-...

====List====
A List of your devices in the currently selected project. 
You can deselect the current project/device to list all your devices.

Select a certain device from the device list, to manage its properties, licenses etc.

Actions on multiple devices:
* Move: move several devices into another project at once (see [[Howto:My_Innovaphone#Move_device|Move Device]])
* Remove: remove several devices at once (see [[Howto:My_Innovaphone#Remove|Remove]])

=====Add=====
Follow the "Add new devices" link on the devices page.

There you have a few options:
* You can add a single new device
* You can add devices according to a mac address range (e.g. from 00-90-33-08-20-00 to 00-90-33-08-22-00), maximum 50 at once
* You can add devices by uploading a text file with mac addresses like this (maximum 50 at once, each line one mac):

00-90-33-08-20-20
00-90-33-08-20-21
00-90-33-08-20-22
00-90-33-24-20-20

* You can add devices according to your received order number. Just enter you order number and you will get a list of all devices bount to this number.

Note: MAC addresses can be always given like this:
* 00-90-33-xx-xx-xx
* 00:90:33:xx:xx:xx
* 009033xxxxxx
* xxxxxx (00-90-33- will then be added automatically)

There might be errors, if you try to add a device. They are explained [[Howto:My_Innovaphone#Image_explanation|here]].

As the device warranty will be handled by licenses now, you can also add telephone devices
to your projects.

=====Add warranty extensions=====

Here you can add warranty extension licenses for all devices in the currently selected project. 
You'll get a list of all devices with the corresponding license type(s) and you can specify the years for each device (or for all devices by entering the number in the list header). 
After confirming your selection, you'll get an overview of all needed licenses, which you have to confirm too.

=====Check licence, SSA and warranty status of a device=====
Here you can list licenses with ssa and the warranty end date of a device, which is not in one of your projects. 
This is just available with the needed right.

=====Download devices of an order as CSV=====
Enter an order number to retrieve all devices for this order in a CSV file.

=====V7 master/slave scenario to V8 floating calculation=====

This gives you the possibility to calculate the SSCs for the change from a V7 master/slave scenario to a V8 floating installation. 
The calculation date is the date for which the calculation is valid. The final SSA date is an option to calculate SSA for the final masters licenses, if wished. 
Then you select the master and the slaves. 
If you want to have Standby/Voicemail licenses on the master, you have to select 'Yes' on the corresponding radio button. Maybe some new licenses must be bought depending on your setup. Theses licenses will be shown on the next page. 
At last you have the possibility to add further PBX port licenses, if you want to extend your installation and calculate SSCs for the new licenses.

====Properties====

Change the name and comment of a device.
You can only change the name, if it's no MAC or IPEI.
 
Here you have also the possibility, to directly request RMA for this device with prefilled values.

====Licenses====
Here you can add, download or move licenses.

=====Add licenses from balance=====
To create new licenses for a device, you have to add this device first on the devices page and then select a version of the license
and whether you want to summate the current licencing. If you select current licenses, then older licenses for example V6 or V7 licenses will also be counted as V8 licenses in the next overview. This is necessary if you want to license a V6 unit with V8 licenses, but still want to use it as V6.
After that click "Next".
On the next page you will see a list of all available license types, which depends on your current available license types, of the selected license version and the device type (IP6000, IP800 e.g.):
[[Image:licenses.jpg|center|thumb|200px|Licenses for an IP3000]]
 
If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses to this SSA end date or you can optionally change this date to another one for the new licenses.
 
You see the available project balance, the balance over all projects (excluding external projects), the currently installed licenses and the maximum amount for this device type. You can now enter the value of the new license.
Base/Upgrade licenses can be selected via dropdown box.
'''Voicemail and Standby lics must always have the same amount as the selected PBX-PBX... license!
The maximum amount of PBX-Registration licenses equals the amount of the selected PBX-PBX... license!'''

The whished overall amount of pbx version 8 and above licenses can be specified here and the concrete amount of license sub types will be requested on the next page.

[[Image:licenses2.jpg|center|thumb|200px|Licenses for an IP800 with V8, step two]]

The best (cheapest) combination of each v8 pbx license type is already filled in, but you might change the amount of sub types if your does not fit and you do not want to purchase new activation keys for the sub types.

The column SSC/Unit is just shown if your project is currently under SSA and you have entered a SSA end date.

The SSC multiplicator is the value, which you have to multiplicate with each license unit to get
the corresponding SSC amount.
E.g. if you have 20 units of PBX-Port8*20 licenses with a SSC value of 54 and a multiplicator of
1.0000 (which equals to 365 days) you have to pay 20*54*1.0000 ~ 1080 SSCs.

 If you create licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the currently selected version twice. 
e.g.: you want to bind licenses for V6 with SSA, so you have to pay SSCs from the release date of V7
 You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

Now confirm your new selection. If you have not enough licenses in your current project, but there are still licenses in other projects, you will get a dropdown box with a list of all projects containing the needed licenses. You can now select all desired/needed projects and confirm your selection again.
The balance of all selected projects will then be decreased by the needed amount.
 
 
If your user account has the right to buy licenses on credit, just check the checkbox.
 
You may enter an order number, which you can use for your order, if you buy on credit.

=====Add licenses from free licenses=====

Here you can assign licenses, which you returned from other devices.
You will also have to select the desired version and will than get a list of fitting licenses according to the current device and selected version.

[[Image:licenses_free.jpg|center|thumb|200px|Free Licenses for an IP800 with V8]]

If a license is under SSA, the correct license type is shown in column 'License Type' besides the 'Original Type'.
On confirming the selection, a consistency check is done (e.g. only 4 Relay-PRI licenses on an IP6000).
Bind and SSA end date will be maintained for each license.

As external keys are also maintained, you can select e.g. an old Dect-Multicell-Ari license to have the same ARI on another IP1200.
 

If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses
to this SSA end date or you can optionally change this date to another one for the new licenses.
You will have to confirm this after your first license selection (this is the same calculation as [[Reference:My_Innovaphone#SSA|here]]).

=====Add V7 floating license (slave pbx)=====
Here you can add a V7 floating license for a slave pbx. A device with a floating license can't have V7 pbx licenses and a device with V7 pbx licenses can't have a floating license.

=====Delete V7 floating license=====
Here you can delete an already existing floating license, if you won't use it anymore.

=====Add warranty extension licenses=====
Extend your warranty by adding warranty extension licenses:

[[Image:add_warranty.jpg|center|thumb|200px|Warranty extension]]

If you add the warranty extension immediately after the receipt of your device,
you can add the cheaper warranty extension licenses, otherwise you'll have to add
the more expensive ones.

You can extend the warranty for a maximum of four years.

=====Download licenses=====

[[Image:Device_download.jpg|center|thumb|200px|Download Licenses]]

You will get a dropdown with all available versions. Versions are dependent of your device, your licenses and of the ssa of your licenses. 
You are able to download downgraded versions of your licenses. E.g. if you have only V8 licenses, you can download a V7 license file (same restrictions as below).

Downgrades or only possible down to version 6!

If you do not want to download licenses by version, you have to decide whether to download the licenses encrypted or not.
'''If you download the licenses unencrypted, you won't be able to return those licenses anymore.'''
So you won't be able to return licenses for devices with V5-V7 licenses, as licenses for this versions are not encrypted.
To return these licenses, you will have to upgrade to a new bootcode, which prevents firmware downgrades to versions below version 8. 
Encrypted licenses are stored in a xml file, which you can then upload on your V8 (or higher) device.

You can now also download licenses directly from by the web interface of a device.
You just have to enter your account data and start downloading the licenses from my.innovaphone.com
without having to download/upload a license file.

=====Download test licenses=====

[[Image:Device_download_test.jpg|center|thumb|200px|Download test licenses]]

You can also download test licenses if you want to run tests. You will be asked, which version you want to use, whether the device is used as slave and if not used as slave, how many pbx licenses you want to use.

=====Move licenses to another device=====
If you have the needed account rights or the device is already in RMA, you can move licenses to another device. After moving licenses, the former device will be marked as a RMA device.

You can just move licenses to devices without licenses!

====Move device====
Here you can move the current device or the selected devices to another project. 
If you select a SSA project, you can change the SSA end date for the move process. 

If the other project is under SSA, you will first see a SSC calculation, which you have to confirm,
as the SSA date for each SSA license will be extended until the given SSA end date
(this is the same calculation as adding SSA to an already existing project, see [[Reference:My_Innovaphone#SSA|here]]).

====Invalidation====

=====Requirements=====
* V8 or higher
* access to the webinteraface
* a device certificate
* my.innovaphone login credentials

=====Informations=====

You can invalidate V8 (or higher) licenses by uploading the XML file, you got from your device or by returning your licenses over the web interface of your device ([[Reference8:Configuration/General/License]]), in order to return [[Reference8:Licenses#Gateway_Licenses|PBX licenses]] back to the balance.

V7 licenses can be just returned, if you agree, that you won't be able to downgrade below V8 anymore. You will need a new bootcode, to use this function. '''You need a V8 firmware or higher for invalidation.'''

If your device has access to my.innovaphone.com, you can also invalidate licenses directly
from the web interface of the device.

[[Reference8:Licenses#Gateway_Licenses|gateway licenses]] and warranty extensions won't be returned to the balance and remain to be assigned to the device!

=====Process=====

Steps to invalidate licenses, if your device has internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# enter your my.innovaphone account, the device must be in one of your projects
# click Invalidate
# click Transfer (this might fail, if NTP or DNS is not configured properly or device certificate is not installed)
# reset if asked for

Steps to invalidate licenses, if your device has no internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# click Invalidate
# click Backup and upload this file on my.innovaphone [[Reference:My_Innovaphone#Upload_the_invalidation_document_to_return_licenses|here]]
# you'll get a confirmation file after uploading the saved file
# upload this on the device (under Step1)
# reset if asked for

"Your IP800 does not have a device certificate on it." - In this case you need to download a hardware certification,
please contact the innovaphone [mailto:support@innovaphone.com support].

=====Download confirmation file=====
If you created a new certificate or you invalidated your licenses, you can later download the confirmation file, which you have to upload on the box.

=====Request certificate=====
If you have the needed rights, you can request a new device certificate for your device.

=====Upload the invalidation document to return licenses=====
Upload the invalidation document, which you got from the website of the device to return the licenses of this device.

After uploading you'll get a confirmation file, which you have to upload on your device.

====Remove====
You can always remove devices from a project. If they have licenses, these won't be deleted, so you might add the device to another project again.

===History===
[[Image:history.jpg|center|thumb|200px|History page]]
You can view your history for several contexts:
* Company: history of all actions in your company
* User: history of all actions of the selected user
* Device: history of all actions for the selected device

Each context applies to the currently selected project.
If you deselect the current project, you will see the history over all projects.

You can select to view the history of the last day, week, month, year or from always. Collecting data might take a while...

===Company===
Manage users, import other companies or change your company data.
The first user of a company has automatically company admin rights and can grant this right to other company users after adding their accounts email address. 

====Users====

[[Image:company.jpg|center|thumb|200px|Company page]]
Here you can add other users to your company, optionally with company admin rights.
You can also lock a user account or grant company admin rights. 
Locked users can't loggin to my.innovaphone.com any more. 
Instead of locking a user you can also remove this user from your company. The user itself will still have his my.innovaphone account, but won't belong to your company any more. The history of this user is still available after having removed him.

Non company admin users just get a non editable list of the current company users.

A user can be member of several companies and the users rights, company admin and
locked status can be different for all companies, where this user is in.

====Join (admin only)====
As admin you can also join another company into your company by entering an admin account of this company. This might be usefull if one user of your company has accidentally created an own company. 
Everything like projects, users, devices, balance, activations etc. will be imported! 
You also have to enter the company id of the company, which is to be imported. You can find this company under Licenses->Company and the company tab.

This is not available for non company admin users.

The joined company will be deleted afterwards!

====Company====
If you do not belong to a my innovaphone company, you can create one here. You can optionally enter an innovaphone account ID with its zip code or you just enter your company data below.

[[Image:company_create.jpg|center|thumb|200px|Company create page]]

Otherwise you can change your company data, but only, if you didn't created your company with your innovaphone account id. In this case, company information is always retrieved from your innovaphone account.
Non company admin users can just view the current company data.

You also see your company id here, which is sometimes needed for adding external project rights or
to be imported by another company.

You can check the '''Device SSA''' checkbox, if you want to receive SSA expiry reminder mails for each device independent of the projects SSA end date.
These mails will be send weekly seven weeks before the SSA for a license a the device expires.

====New Company====
If you need several companies for some reasons, you can create another one here. 
You will be an admin user in this new company and you can directly select the newly created company at the top right corner.

==RMA==
Here you can see all your RMA devices, which arrived innovaphone already. The licenses of this macadresses are moveable.
[[Image:rma.jpg|center|thumb|200px|RMA page]]
 
If you want to request RMA for a certain device, go to the device properties and follow the "Request RMA" link.

==Mantis==
Here you'll get a list of all open support cases in our mantis system, which are assigned to email addresses of your my.innovaphone users in your company.

==Configurator==
Currently this is just a link to the [http://config.innovaphone.com innovaphone PBX Configurator]

==Account==
Here you can change your personal data, password etc. You always have to enter your current password to change your data.

If you change your email address, you'll have to activate your account again.

==Company selection==
If your user account belongs to several companies, you can switch between companies be using the dropdown box at the top right corner of the page. 
You'll get an error, if you try to switch to a company, where your account is locked. 

[[Image:company_selection.jpg|center|thumb|200px|Dropdown box for company selection]]

 
If you loggin, the first found company is selected for your user.

==Image explanation==

===Errors===

====Already In Company====
[[Image:Icon_in_company_inno_01.png]]
* This device already exists in your company and can't be added/imported.
If you want to import this device anyway, you first have to delete your current device from its project.

====Already Imported====
[[Image:Icon_imported_inno_01.png]]
* This device has been already imported.
You can't import it again.

====Not Found====
[[Image:Icon_not_found_inno_01.png]]
* This device was not found in the my innovaphone database.
This should never happen, but if, contact the administrator.

====IPVA MAC exists====
[[Image:Icon_ip_va_exists_inno_01.png]]
* An IPVA MAC address must be unique and can be assigned to just one company. You tried to add an already existing IPVA MAC.
Please assign a new one to your IPVA. For further details, see [[Reference9:Concept_Innovaphone_Virtual_Appliance#License_Configuration]].

===Warnings===

====Several Companies====
[[Image:Icon_several_companies_inno_01.png]]
* This device is already in another company.
This means, that either you do not have the physical device or it once belonged another company.
You can still import/add this device and you will have access to all of its current licenses.

====Several Users====
[[Image:Icon several users inno 01.png]]
* This device has licenses from several users of the old license manager.
This means, that you are not neccessarily the user, who physically owns this device. If you do not own it, do not import it.

===Misc===
====No downgrade====
[[Image:no_downgrade.png]]
* Licenses, which have been downloaded for V5/V6/V7, were returned from this device, so no downgrade to these versions is allowed any more.



==Release dates==
V5: 01/01/2003 
V6: 02/11/2006 
V7: 14/11/2008 
V8: 07/12/2009 

==myplay==
[[https://myplay.innovaphone.com myplay]] offers a platform to test all my.innovaphone related content. You can create activation keys, licenses, accounts, projects and so on to learn it or to calculate possible scenarios.

===Base===
The base of the database is the my.innovaphone database from the 13.8.2010. All accounts, companies and projects have been imported and are available until this date. 
From this date on the databases won't be synchronised any more (despite of the device table)!

===Balance===
You can change your balance by yourself. Simply select the license type in the dropdown box on the balance page, enter the desired amount and your balance will be increased by this type.

===Activation keys===
You can create own activation keys. These will have the prefix "PLAY-" to identify them as play activation keys. You won't be able to upload them on my.innovaphone.com.

===Licenses===
After having selected a device under Licenses->Devices, you can add/change licenses as you want by selecting new ones in the dropdown box or changing existing ones.

====Download====
You will always just download test licenses here!

====Invalidation====
Won't be possible here, because this is hardware related and can't be simulated.

====Checkbox editing via list====
* 'D' Deletes the license
* 'B' Puts the license back into the projects balance
* 'F' Puts the license into the pool of free licenses

===Device RMA===
You can put a device under RMA to test this scenario (Licenses->Devices, select a device and ->Properties). You can also remove the RMA status here.

==Known Issues==
* Devices where imported into a project with SSA. If this happened to you, please move the corresponding devices into a project '''without''' SSA and back into the project '''with''' SSA to extend/add SSA for the licenses until the SSA end date.
* IE7 moves a list under the menu, when a list becomes to wide

Reference:My Innovaphone

2010-12-15T10:16:54Z

Kti: /* Process */

==About==
My innovaphone replaces the former license manager.
It will also include the handling of device warranty and software service agreements (only partially implemented yet).

===Project-View===
My innovaphone offers the possibility for several users to be in one company. This company shares its balance of licenses over all users and can have several projects. Projects have their own balance of license types and devices are bound to a project.

===Language===
My innovaphone will support multiple languages. You can select your desired language at the top of the page. 
Currently supported languages:
* English
* German
* Italian
* Dutch
* French

===Guides===

====Quickstart guide====
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_nl.pdf Dutch quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_en.pdf English quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_fr.pdf French quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_de.pdf German quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_it.pdf Italian quickstart guide] 

====SSA guide====
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_en.pdf English SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_fr.pdf French SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_de.pdf German SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_it.pdf Italian SSA guide] 

==First steps==
Open [https://my.innovaphone.com my.innovaphone.com] and click the "Register Now" link.
Enter your personal data and register.

You will receive a registration email with an activation link.
After account activation you have two options:
* create a new my innovaphone company (under Licenses->Company)
* ask another user of your company to add your user account to an already existing company

If you accidentally created an own my innovaphone company, just ask another user of your company to import your just created company.

If you create a new company, you can '''optionally''' enter your innovaphone account ID (which is your customer number with innovaphone) with your postal code, to retrieve your company data.

You will see a help link at the right side of the horizontal tab menu.
This link shows the corresponding text of the wiki section, when hovering with the mouse over it,
and redirects to the corresponding wiki menu, if clicked.

It is now possible, that one user is member of serveral companies!

==Search==
At the right top of the page you have a search field. You can search for different things:
* Devices (part of a device name or device comment)
* Projects (part of a project name or project description)
* Own activation keys (part of an activation key or its description)

You have to enter at least '''three''' chars to start a search. To search for activation keys,
you have to enter at least '''five''' chars.
* Search for license types. Enter e.g. "PBX-Port8" to find all devices with Port8 licenses or enter "PBX-Port8=100" to find all devices with Port8 licenses '''>=''' 100.

==Licenses==
===Projects===
After creation of an own company, you will have a default project named "DEFAULT". You can rename this project later.
You can also create more projects on the projects page with "Create".
Each project of a company must have a unique name.

Do '''not''' set SSA, if you want to import your devices from your old license manager account first.
If you want SSA and you '''won't import''' devices into this project from your old account, you should set SSA at once.

You can select a certain project by activating it in the project list. This selection is then true for all other pages, as some pages require a selected project.

[[Image:overview.jpg|center|thumb|200px|Projects page]]

By activating a project by clicking on the project name in the project list, you can manage this project and its settings.

====Properties====
Rename the project or/and change its description.

====SSA====
You can put your project under SSA (software service agreement).
You will be asked to enter a SSA end date. This will be the date, where all SSA licenses of all devices in this project will expire.
The end date mustn't be in the past.

After entering a date, you will get a summary of all licenses, which will be put under SSA and the amount of needed SSC licenses.
The SSC value for each license is calculated by the bind date of the license and the entered SSA end date.

[[Image:Ssa_extend.jpg|center|thumb|200px|SSA summary]]

If you have licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the current license version. 

e.g. you have a V7 PBX-PBX7#15 license with bind date 1/1/2010. Version 8 was released on 7/12/2009, so SSA is
calculated from 7/12/2009 for this license. You will see the calculation date in the list under "bind date"

If licenses already have a SSA date, just the difference between the current SSA date and the entered SSA end date must be paid.
If the bind date of the device lies in the past, the difference between the bind date and the current date must be paided twice (this is the column 'days*2'). 
If your license is under SSA, which is already over, you also have to pay the time between the old SSA date and the current SSA end date twice.

Here is a short example, how the days are calculated:

Bind date: 24/06/2009 
Current date: 31/08/2009 
SSA end date: 12/12/2011 
 
You will have to pay from 24/06/2009 to 31/08/2009 twice for 68 days.
From 31/08/2009 to 12/12/2011 you will then have to pay the normal price for 833 days.

You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

You can preview the SSC calculation for another calculation date. Simply change the dropdown
selection to get the new SSC value.
Of course you can't confirm this calculation for another date, just for the current date!

After confirming your entered SSA end date, each license will have this date as SSA end date and can be downloaded in all versions of this SSA time.

You can now extend the projects SSA end date like as setting a new one.
The resulting summary is the same as above.

If your user account has the right to buy licenses on credit, just check the checkbox.
You may enter an order number, which you can use for your order, if you buy on credit.

If project SSA will expire, each company user will receive a reminder mail '''7''' weeks before and
then every week one mail.
You can disable these mails with the checkbox 'Send SSA expiry mails'.
Note that every user can configure, if he wants to receive mails or not in his account settings.

You can optionally configure to receive project SSA independent reminder mails for each license of a device [[Reference:My_Innovaphone#Company_2|here]].

====Rights====
Add or delete company rights for this project. To add a company right, you have to enter the company id of this company.
Each user of a company with rights on this project can add devices, licenses, activation keys to this specific project, but is restricted in removing devices, editing the project and can't create activation keys with the projects balance.

The company id can be found under Licenses->company and the company tab.

[[Image:Project_rights.jpg|center|thumb|200px|Project rights]]

====Import====
To download old licenses created with an old license manager account and to use your old balance, you have to import your old account data.
You will have to enter your old account login from license.innovaphone.com. Afterwards you will get a list of your balance and of all your devices with their licenses.
The shown balance is the balance of all users, which belong to your old group (if you belonged to a group).
You can now select all devices which you want to import to the currently selected project.
There might be errors, if you try to add a device. They are explained [[Howto:My_Innovaphone#Image_explanation|here]].

By confirming this import, all users of your group will be locked in the old license manager.

You can import all not yet imported devices to another project, if you want.

Importing of your old balance and devices might take a while!

You can also import just one mac address, if you are the owner of the device, but haven't created any licenses in the old account. Your old account and its balance won't be affected then.

====Join====
Here you can join your currently selected project with another project, which you select from a dropdown box. 
If the other project has SSA, you'll see the current SSA end date, which you might change for the join process and you will get a list of all licenses, which might be updated to the ssa end date/changed date of the other project. The list equals the list shown under [[Reference:My_Innovaphone#SSA|SSA]].

The selected project will be automatically deleted after the join. You can't join a project,
if it grants external rights to another customer. Delete these rights before.

====Delete====
Delete the project. Only possible if it has no activation keys, project rights, devices or user rights.
 
You may [[Reference:My_Innovaphone#Join|join]] your project into another one, if you can't delete it.

====Project Freed_RMA_licenses====
If you see a project with this name in your project list, you had a RMA device with not yed moved licenses, which was shipped to innovaphone and reshipped to another customer. 
The licenses of such a device have been moved into the pool of free licenses of the project Freed_RMA_licenses, from where you can assign them to another device.

===Balance===
On the balance page you will see the balance of the currently selected project or the balance of all your projects together.
The balance is bound to your company and '''not''' to your user account. The balance is bound to a specific project, but can be shared for license creation or activation key creation if wished. 
Sharing the balance over several projects is not possible in external projects!

[[Image:Balancepage.jpg|center|thumb|200px|Balance page]]

====Free licenses====

Here you see a list of all your free licenses. If you return licenses from one of your devices, the returned licenses are stored in your free licenses pool. You can assign these licenses to another device (see [[#Add licenses from free licenses|'Add licenses from free licenses']]) or convert them to your balance.

[[Image:Balance_free_lics.jpg|center|thumb|200px|Free licenses list]]

The bind date, SSA end date and the external key (like DECT-Multi-Cell-Ari) are stored for each license.

If you want to convert these licenses to your balance, you will have to pay one year SSC for each unit and all external key bindings and the current SSA will be lost. 
If the license you convert is under SSA, you will be able to select the version to convert the license to.

===Activations===
To increase your projects balance, select one of your projects, follow the "Add" link and enter the activation key in the corresponding field. You can also enter an optional comment for this key. You will then get a listing of all contained licenses. After commiting this key, your project balance will have been increased by the keys values.

"Deselect the current project" to view all activation keys independent of the selected project.

[[Image:Activations.jpg|center|thumb|200px|Activation key page]]

====License certificate====
You can always download the innovaphone license certificate for activation keys in your projects. Simply press the download link in the list at the right side.

===Own Activations===
Here you'll see a list of all created activation keys in the selected project (or over all projects).

You can create activation keys on the project page for other users/companies or to simply transfer licenses from one project to another. 
You can enter a comment, an order number and an order reference. The '''order number''' is your own order number for the key and the '''order reference''' is the reference number of the customer, who receives the newly created key. 
The order reference and order number will be shown in the innovaphone license certificate.

[[Image:Created_activations.jpg|center|thumb|200px|Created activation keys]]

You have to select an activation key in the activation key list to update or delete it.

Updating and deleting a key is only possible, if this key is not assigned.

====Update====
Add more licenses to this key or change its comment, order number and order reference. 
You can also remove licenses by entering e.g. -2, if you want to remove 2 licenses from the key.

[[Image:Own activations update.jpg|center|thumb|200px|Update own activation keys]]

====Delete====
Delete this key. Its licenses will go back into the balance of the currently selected project.

===Devices===
To view your devices you first have to click on the "Show" button. You can leave the filter field empty if you want to view all your devices.

[[Image:Devices_page.jpg|center|thumb|200px|The Devices Page]]

Red marked device names are devices, which are currently in RMA.

MAC addresses of RMA devices do not longer start with 01-...

====List====
A List of your devices in the currently selected project. 
You can deselect the current project/device to list all your devices.

Select a certain device from the device list, to manage its properties, licenses etc.

Actions on multiple devices:
* Move: move several devices into another project at once (see [[Howto:My_Innovaphone#Move_device|Move Device]])
* Remove: remove several devices at once (see [[Howto:My_Innovaphone#Remove|Remove]])

=====Add=====
Follow the "Add new devices" link on the devices page.

There you have a few options:
* You can add a single new device
* You can add devices according to a mac address range (e.g. from 00-90-33-08-20-00 to 00-90-33-08-22-00), maximum 50 at once
* You can add devices by uploading a text file with mac addresses like this (maximum 50 at once, each line one mac):

00-90-33-08-20-20
00-90-33-08-20-21
00-90-33-08-20-22
00-90-33-24-20-20

* You can add devices according to your received order number. Just enter you order number and you will get a list of all devices bount to this number.

Note: MAC addresses can be always given like this:
* 00-90-33-xx-xx-xx
* 00:90:33:xx:xx:xx
* 009033xxxxxx
* xxxxxx (00-90-33- will then be added automatically)

There might be errors, if you try to add a device. They are explained [[Howto:My_Innovaphone#Image_explanation|here]].

As the device warranty will be handled by licenses now, you can also add telephone devices
to your projects.

=====Add warranty extensions=====

Here you can add warranty extension licenses for all devices in the currently selected project. 
You'll get a list of all devices with the corresponding license type(s) and you can specify the years for each device (or for all devices by entering the number in the list header). 
After confirming your selection, you'll get an overview of all needed licenses, which you have to confirm too.

=====Check licence, SSA and warranty status of a device=====
Here you can list licenses with ssa and the warranty end date of a device, which is not in one of your projects. 
This is just available with the needed right.

=====Download devices of an order as CSV=====
Enter an order number to retrieve all devices for this order in a CSV file.

=====V7 master/slave scenario to V8 floating calculation=====

This gives you the possibility to calculate the SSCs for the change from a V7 master/slave scenario to a V8 floating installation. 
The calculation date is the date for which the calculation is valid. The final SSA date is an option to calculate SSA for the final masters licenses, if wished. 
Then you select the master and the slaves. 
If you want to have Standby/Voicemail licenses on the master, you have to select 'Yes' on the corresponding radio button. Maybe some new licenses must be bought depending on your setup. Theses licenses will be shown on the next page. 
At last you have the possibility to add further PBX port licenses, if you want to extend your installation and calculate SSCs for the new licenses.

====Properties====

Change the name and comment of a device.
You can only change the name, if it's no MAC or IPEI.
 
Here you have also the possibility, to directly request RMA for this device with prefilled values.

====Licenses====
Here you can add, download or move licenses.

=====Add licenses from balance=====
To create new licenses for a device, you have to add this device first on the devices page and then select a version of the license
and whether you want to summate the current licencing. If you select current licenses, then older licenses for example V6 or V7 licenses will also be counted as V8 licenses in the next overview. This is necessary if you want to license a V6 unit with V8 licenses, but still want to use it as V6.
After that click "Next".
On the next page you will see a list of all available license types, which depends on your current available license types, of the selected license version and the device type (IP6000, IP800 e.g.):
[[Image:licenses.jpg|center|thumb|200px|Licenses for an IP3000]]
 
If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses to this SSA end date or you can optionally change this date to another one for the new licenses.
 
You see the available project balance, the balance over all projects (excluding external projects), the currently installed licenses and the maximum amount for this device type. You can now enter the value of the new license.
Base/Upgrade licenses can be selected via dropdown box.
'''Voicemail and Standby lics must always have the same amount as the selected PBX-PBX... license!
The maximum amount of PBX-Registration licenses equals the amount of the selected PBX-PBX... license!'''

The whished overall amount of pbx version 8 and above licenses can be specified here and the concrete amount of license sub types will be requested on the next page.

[[Image:licenses2.jpg|center|thumb|200px|Licenses for an IP800 with V8, step two]]

The best (cheapest) combination of each v8 pbx license type is already filled in, but you might change the amount of sub types if your does not fit and you do not want to purchase new activation keys for the sub types.

The column SSC/Unit is just shown if your project is currently under SSA and you have entered a SSA end date.

The SSC multiplicator is the value, which you have to multiplicate with each license unit to get
the corresponding SSC amount.
E.g. if you have 20 units of PBX-Port8*20 licenses with a SSC value of 54 and a multiplicator of
1.0000 (which equals to 365 days) you have to pay 20*54*1.0000 ~ 1080 SSCs.

 If you create licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the currently selected version twice. 
e.g.: you want to bind licenses for V6 with SSA, so you have to pay SSCs from the release date of V7
 You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

Now confirm your new selection. If you have not enough licenses in your current project, but there are still licenses in other projects, you will get a dropdown box with a list of all projects containing the needed licenses. You can now select all desired/needed projects and confirm your selection again.
The balance of all selected projects will then be decreased by the needed amount.
 
 
If your user account has the right to buy licenses on credit, just check the checkbox.
 
You may enter an order number, which you can use for your order, if you buy on credit.

=====Add licenses from free licenses=====

Here you can assign licenses, which you returned from other devices.
You will also have to select the desired version and will than get a list of fitting licenses according to the current device and selected version.

[[Image:licenses_free.jpg|center|thumb|200px|Free Licenses for an IP800 with V8]]

If a license is under SSA, the correct license type is shown in column 'License Type' besides the 'Original Type'.
On confirming the selection, a consistency check is done (e.g. only 4 Relay-PRI licenses on an IP6000).
Bind and SSA end date will be maintained for each license.

As external keys are also maintained, you can select e.g. an old Dect-Multicell-Ari license to have the same ARI on another IP1200.
 

If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses
to this SSA end date or you can optionally change this date to another one for the new licenses.
You will have to confirm this after your first license selection (this is the same calculation as [[Reference:My_Innovaphone#SSA|here]]).

=====Add V7 floating license (slave pbx)=====
Here you can add a V7 floating license for a slave pbx. A device with a floating license can't have V7 pbx licenses and a device with V7 pbx licenses can't have a floating license.

=====Delete V7 floating license=====
Here you can delete an already existing floating license, if you won't use it anymore.

=====Add warranty extension licenses=====
Extend your warranty by adding warranty extension licenses:

[[Image:add_warranty.jpg|center|thumb|200px|Warranty extension]]

If you add the warranty extension immediately after the receipt of your device,
you can add the cheaper warranty extension licenses, otherwise you'll have to add
the more expensive ones.

You can extend the warranty for a maximum of four years.

=====Download licenses=====

[[Image:Device_download.jpg|center|thumb|200px|Download Licenses]]

You will get a dropdown with all available versions. Versions are dependent of your device, your licenses and of the ssa of your licenses. 
You are able to download downgraded versions of your licenses. E.g. if you have only V8 licenses, you can download a V7 license file (same restrictions as below).

Downgrades or only possible down to version 6!

If you do not want to download licenses by version, you have to decide whether to download the licenses encrypted or not.
'''If you download the licenses unencrypted, you won't be able to return those licenses anymore.'''
So you won't be able to return licenses for devices with V5-V7 licenses, as licenses for this versions are not encrypted.
To return these licenses, you will have to upgrade to a new bootcode, which prevents firmware downgrades to versions below version 8. 
Encrypted licenses are stored in a xml file, which you can then upload on your V8 (or higher) device.

You can now also download licenses directly from by the web interface of a device.
You just have to enter your account data and start downloading the licenses from my.innovaphone.com
without having to download/upload a license file.

=====Download test licenses=====

[[Image:Device_download_test.jpg|center|thumb|200px|Download test licenses]]

You can also download test licenses if you want to run tests. You will be asked, which version you want to use, whether the device is used as slave and if not used as slave, how many pbx licenses you want to use.

=====Move licenses to another device=====
If you have the needed account rights or the device is already in RMA, you can move licenses to another device. After moving licenses, the former device will be marked as a RMA device.

You can just move licenses to devices without licenses!

====Move device====
Here you can move the current device or the selected devices to another project. 
If you select a SSA project, you can change the SSA end date for the move process. 

If the other project is under SSA, you will first see a SSC calculation, which you have to confirm,
as the SSA date for each SSA license will be extended until the given SSA end date
(this is the same calculation as adding SSA to an already existing project, see [[Reference:My_Innovaphone#SSA|here]]).

====Invalidation====

=====Requirements=====
* V8 or higher
* access to the webinteraface
* a device certificate
* my.innovaphone login credentials

=====Informations=====

You can invalidate V8 (or higher) licenses by uploading the XML file, you got from your device or by returning your licenses over the web interface of your device ([[Reference8:Configuration/General/License]]), in order to return [[Reference8:Licenses#Gateway_Licenses|PBX licenses]] back to the balance.

V7 licenses can be just returned, if you agree, that you won't be able to downgrade below V8 anymore. You will need a new bootcode, to use this function. '''You need a V8 firmware or higher for invalidation.'''

If your device has access to my.innovaphone.com, you can also invalidate licenses directly
from the web interface of the device.

[[Reference8:Licenses#Gateway_Licenses|gateway licenses]] and warranty extensions won't be returned to the balance and remain to be assigned to the device!

=====Process=====

Steps to invalidate licenses, if your device has internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# enter your my.innovaphone account, the device must be in one of your projects
# click Invalidate
# click Transfer (this might fail, if NTP or DNS is not configured properly or device certificate is not installed)
# reset if asked for

Steps to invalidate licenses, if your device has no internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# enter your my.innovaphone account, the device must be in one of your projects
# click Invalidate
# click Backup and upload this file on my.innovaphone [[Reference:My_Innovaphone#Upload_the_invalidation_document_to_return_licenses|here]]
# you'll get a confirmation file after uploading the saved file
# upload this on the device (under Step1)
# reset if asked for

"Your IP800 does not have a device certificate on it." - In this case you need to download a hardware certification,
please contact the innovaphone [mailto:support@innovaphone.com support].

=====Download confirmation file=====
If you created a new certificate or you invalidated your licenses, you can later download the confirmation file, which you have to upload on the box.

=====Request certificate=====
If you have the needed rights, you can request a new device certificate for your device.

=====Upload the invalidation document to return licenses=====
Upload the invalidation document, which you got from the website of the device to return the licenses of this device.

After uploading you'll get a confirmation file, which you have to upload on your device.

====Remove====
You can always remove devices from a project. If they have licenses, these won't be deleted, so you might add the device to another project again.

===History===
[[Image:history.jpg|center|thumb|200px|History page]]
You can view your history for several contexts:
* Company: history of all actions in your company
* User: history of all actions of the selected user
* Device: history of all actions for the selected device

Each context applies to the currently selected project.
If you deselect the current project, you will see the history over all projects.

You can select to view the history of the last day, week, month, year or from always. Collecting data might take a while...

===Company===
Manage users, import other companies or change your company data.
The first user of a company has automatically company admin rights and can grant this right to other company users after adding their accounts email address. 

====Users====

[[Image:company.jpg|center|thumb|200px|Company page]]
Here you can add other users to your company, optionally with company admin rights.
You can also lock a user account or grant company admin rights. 
Locked users can't loggin to my.innovaphone.com any more. 
Instead of locking a user you can also remove this user from your company. The user itself will still have his my.innovaphone account, but won't belong to your company any more. The history of this user is still available after having removed him.

Non company admin users just get a non editable list of the current company users.

A user can be member of several companies and the users rights, company admin and
locked status can be different for all companies, where this user is in.

====Join (admin only)====
As admin you can also join another company into your company by entering an admin account of this company. This might be usefull if one user of your company has accidentally created an own company. 
Everything like projects, users, devices, balance, activations etc. will be imported! 
You also have to enter the company id of the company, which is to be imported. You can find this company under Licenses->Company and the company tab.

This is not available for non company admin users.

The joined company will be deleted afterwards!

====Company====
If you do not belong to a my innovaphone company, you can create one here. You can optionally enter an innovaphone account ID with its zip code or you just enter your company data below.

[[Image:company_create.jpg|center|thumb|200px|Company create page]]

Otherwise you can change your company data, but only, if you didn't created your company with your innovaphone account id. In this case, company information is always retrieved from your innovaphone account.
Non company admin users can just view the current company data.

You also see your company id here, which is sometimes needed for adding external project rights or
to be imported by another company.

You can check the '''Device SSA''' checkbox, if you want to receive SSA expiry reminder mails for each device independent of the projects SSA end date.
These mails will be send weekly seven weeks before the SSA for a license a the device expires.

====New Company====
If you need several companies for some reasons, you can create another one here. 
You will be an admin user in this new company and you can directly select the newly created company at the top right corner.

==RMA==
Here you can see all your RMA devices, which arrived innovaphone already. The licenses of this macadresses are moveable.
[[Image:rma.jpg|center|thumb|200px|RMA page]]
 
If you want to request RMA for a certain device, go to the device properties and follow the "Request RMA" link.

==Mantis==
Here you'll get a list of all open support cases in our mantis system, which are assigned to email addresses of your my.innovaphone users in your company.

==Configurator==
Currently this is just a link to the [http://config.innovaphone.com innovaphone PBX Configurator]

==Account==
Here you can change your personal data, password etc. You always have to enter your current password to change your data.

If you change your email address, you'll have to activate your account again.

==Company selection==
If your user account belongs to several companies, you can switch between companies be using the dropdown box at the top right corner of the page. 
You'll get an error, if you try to switch to a company, where your account is locked. 

[[Image:company_selection.jpg|center|thumb|200px|Dropdown box for company selection]]

 
If you loggin, the first found company is selected for your user.

==Image explanation==

===Errors===

====Already In Company====
[[Image:Icon_in_company_inno_01.png]]
* This device already exists in your company and can't be added/imported.
If you want to import this device anyway, you first have to delete your current device from its project.

====Already Imported====
[[Image:Icon_imported_inno_01.png]]
* This device has been already imported.
You can't import it again.

====Not Found====
[[Image:Icon_not_found_inno_01.png]]
* This device was not found in the my innovaphone database.
This should never happen, but if, contact the administrator.

====IPVA MAC exists====
[[Image:Icon_ip_va_exists_inno_01.png]]
* An IPVA MAC address must be unique and can be assigned to just one company. You tried to add an already existing IPVA MAC.
Please assign a new one to your IPVA. For further details, see [[Reference9:Innovaphone_Virtual_Appliance#License_Configuration]].

===Warnings===

====Several Companies====
[[Image:Icon_several_companies_inno_01.png]]
* This device is already in another company.
This means, that either you do not have the physical device or it once belonged another company.
You can still import/add this device and you will have access to all of its current licenses.

====Several Users====
[[Image:Icon several users inno 01.png]]
* This device has licenses from several users of the old license manager.
This means, that you are not neccessarily the user, who physically owns this device. If you do not own it, do not import it.

===Misc===
====No downgrade====
[[Image:no_downgrade.png]]
* Licenses, which have been downloaded for V5/V6/V7, were returned from this device, so no downgrade to these versions is allowed any more.



==Release dates==
V5: 01/01/2003 
V6: 02/11/2006 
V7: 14/11/2008 
V8: 07/12/2009 

==myplay==
[[https://myplay.innovaphone.com myplay]] offers a platform to test all my.innovaphone related content. You can create activation keys, licenses, accounts, projects and so on to learn it or to calculate possible scenarios.

===Base===
The base of the database is the my.innovaphone database from the 13.8.2010. All accounts, companies and projects have been imported and are available until this date. 
From this date on the databases won't be synchronised any more (despite of the device table)!

===Balance===
You can change your balance by yourself. Simply select the license type in the dropdown box on the balance page, enter the desired amount and your balance will be increased by this type.

===Activation keys===
You can create own activation keys. These will have the prefix "PLAY-" to identify them as play activation keys. You won't be able to upload them on my.innovaphone.com.

===Licenses===
After having selected a device under Licenses->Devices, you can add/change licenses as you want by selecting new ones in the dropdown box or changing existing ones.

====Download====
You will always just download test licenses here!

====Invalidation====
Won't be possible here, because this is hardware related and can't be simulated.

====Checkbox editing via list====
* 'D' Deletes the license
* 'B' Puts the license back into the projects balance
* 'F' Puts the license into the pool of free licenses

===Device RMA===
You can put a device under RMA to test this scenario (Licenses->Devices, select a device and ->Properties). You can also remove the RMA status here.

==Known Issues==
* Devices where imported into a project with SSA. If this happened to you, please move the corresponding devices into a project '''without''' SSA and back into the project '''with''' SSA to extend/add SSA for the licenses until the SSA end date.
* IE7 moves a list under the menu, when a list becomes to wide

Reference:My Innovaphone

2010-12-15T10:15:52Z

Kti: /* Process */

==About==
My innovaphone replaces the former license manager.
It will also include the handling of device warranty and software service agreements (only partially implemented yet).

===Project-View===
My innovaphone offers the possibility for several users to be in one company. This company shares its balance of licenses over all users and can have several projects. Projects have their own balance of license types and devices are bound to a project.

===Language===
My innovaphone will support multiple languages. You can select your desired language at the top of the page. 
Currently supported languages:
* English
* German
* Italian
* Dutch
* French

===Guides===

====Quickstart guide====
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_nl.pdf Dutch quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_en.pdf English quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_fr.pdf French quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_de.pdf German quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_it.pdf Italian quickstart guide] 

====SSA guide====
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_en.pdf English SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_fr.pdf French SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_de.pdf German SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_it.pdf Italian SSA guide] 

==First steps==
Open [https://my.innovaphone.com my.innovaphone.com] and click the "Register Now" link.
Enter your personal data and register.

You will receive a registration email with an activation link.
After account activation you have two options:
* create a new my innovaphone company (under Licenses->Company)
* ask another user of your company to add your user account to an already existing company

If you accidentally created an own my innovaphone company, just ask another user of your company to import your just created company.

If you create a new company, you can '''optionally''' enter your innovaphone account ID (which is your customer number with innovaphone) with your postal code, to retrieve your company data.

You will see a help link at the right side of the horizontal tab menu.
This link shows the corresponding text of the wiki section, when hovering with the mouse over it,
and redirects to the corresponding wiki menu, if clicked.

It is now possible, that one user is member of serveral companies!

==Search==
At the right top of the page you have a search field. You can search for different things:
* Devices (part of a device name or device comment)
* Projects (part of a project name or project description)
* Own activation keys (part of an activation key or its description)

You have to enter at least '''three''' chars to start a search. To search for activation keys,
you have to enter at least '''five''' chars.
* Search for license types. Enter e.g. "PBX-Port8" to find all devices with Port8 licenses or enter "PBX-Port8=100" to find all devices with Port8 licenses '''>=''' 100.

==Licenses==
===Projects===
After creation of an own company, you will have a default project named "DEFAULT". You can rename this project later.
You can also create more projects on the projects page with "Create".
Each project of a company must have a unique name.

Do '''not''' set SSA, if you want to import your devices from your old license manager account first.
If you want SSA and you '''won't import''' devices into this project from your old account, you should set SSA at once.

You can select a certain project by activating it in the project list. This selection is then true for all other pages, as some pages require a selected project.

[[Image:overview.jpg|center|thumb|200px|Projects page]]

By activating a project by clicking on the project name in the project list, you can manage this project and its settings.

====Properties====
Rename the project or/and change its description.

====SSA====
You can put your project under SSA (software service agreement).
You will be asked to enter a SSA end date. This will be the date, where all SSA licenses of all devices in this project will expire.
The end date mustn't be in the past.

After entering a date, you will get a summary of all licenses, which will be put under SSA and the amount of needed SSC licenses.
The SSC value for each license is calculated by the bind date of the license and the entered SSA end date.

[[Image:Ssa_extend.jpg|center|thumb|200px|SSA summary]]

If you have licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the current license version. 

e.g. you have a V7 PBX-PBX7#15 license with bind date 1/1/2010. Version 8 was released on 7/12/2009, so SSA is
calculated from 7/12/2009 for this license. You will see the calculation date in the list under "bind date"

If licenses already have a SSA date, just the difference between the current SSA date and the entered SSA end date must be paid.
If the bind date of the device lies in the past, the difference between the bind date and the current date must be paided twice (this is the column 'days*2'). 
If your license is under SSA, which is already over, you also have to pay the time between the old SSA date and the current SSA end date twice.

Here is a short example, how the days are calculated:

Bind date: 24/06/2009 
Current date: 31/08/2009 
SSA end date: 12/12/2011 
 
You will have to pay from 24/06/2009 to 31/08/2009 twice for 68 days.
From 31/08/2009 to 12/12/2011 you will then have to pay the normal price for 833 days.

You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

You can preview the SSC calculation for another calculation date. Simply change the dropdown
selection to get the new SSC value.
Of course you can't confirm this calculation for another date, just for the current date!

After confirming your entered SSA end date, each license will have this date as SSA end date and can be downloaded in all versions of this SSA time.

You can now extend the projects SSA end date like as setting a new one.
The resulting summary is the same as above.

If your user account has the right to buy licenses on credit, just check the checkbox.
You may enter an order number, which you can use for your order, if you buy on credit.

If project SSA will expire, each company user will receive a reminder mail '''7''' weeks before and
then every week one mail.
You can disable these mails with the checkbox 'Send SSA expiry mails'.
Note that every user can configure, if he wants to receive mails or not in his account settings.

You can optionally configure to receive project SSA independent reminder mails for each license of a device [[Reference:My_Innovaphone#Company_2|here]].

====Rights====
Add or delete company rights for this project. To add a company right, you have to enter the company id of this company.
Each user of a company with rights on this project can add devices, licenses, activation keys to this specific project, but is restricted in removing devices, editing the project and can't create activation keys with the projects balance.

The company id can be found under Licenses->company and the company tab.

[[Image:Project_rights.jpg|center|thumb|200px|Project rights]]

====Import====
To download old licenses created with an old license manager account and to use your old balance, you have to import your old account data.
You will have to enter your old account login from license.innovaphone.com. Afterwards you will get a list of your balance and of all your devices with their licenses.
The shown balance is the balance of all users, which belong to your old group (if you belonged to a group).
You can now select all devices which you want to import to the currently selected project.
There might be errors, if you try to add a device. They are explained [[Howto:My_Innovaphone#Image_explanation|here]].

By confirming this import, all users of your group will be locked in the old license manager.

You can import all not yet imported devices to another project, if you want.

Importing of your old balance and devices might take a while!

You can also import just one mac address, if you are the owner of the device, but haven't created any licenses in the old account. Your old account and its balance won't be affected then.

====Join====
Here you can join your currently selected project with another project, which you select from a dropdown box. 
If the other project has SSA, you'll see the current SSA end date, which you might change for the join process and you will get a list of all licenses, which might be updated to the ssa end date/changed date of the other project. The list equals the list shown under [[Reference:My_Innovaphone#SSA|SSA]].

The selected project will be automatically deleted after the join. You can't join a project,
if it grants external rights to another customer. Delete these rights before.

====Delete====
Delete the project. Only possible if it has no activation keys, project rights, devices or user rights.
 
You may [[Reference:My_Innovaphone#Join|join]] your project into another one, if you can't delete it.

====Project Freed_RMA_licenses====
If you see a project with this name in your project list, you had a RMA device with not yed moved licenses, which was shipped to innovaphone and reshipped to another customer. 
The licenses of such a device have been moved into the pool of free licenses of the project Freed_RMA_licenses, from where you can assign them to another device.

===Balance===
On the balance page you will see the balance of the currently selected project or the balance of all your projects together.
The balance is bound to your company and '''not''' to your user account. The balance is bound to a specific project, but can be shared for license creation or activation key creation if wished. 
Sharing the balance over several projects is not possible in external projects!

[[Image:Balancepage.jpg|center|thumb|200px|Balance page]]

====Free licenses====

Here you see a list of all your free licenses. If you return licenses from one of your devices, the returned licenses are stored in your free licenses pool. You can assign these licenses to another device (see [[#Add licenses from free licenses|'Add licenses from free licenses']]) or convert them to your balance.

[[Image:Balance_free_lics.jpg|center|thumb|200px|Free licenses list]]

The bind date, SSA end date and the external key (like DECT-Multi-Cell-Ari) are stored for each license.

If you want to convert these licenses to your balance, you will have to pay one year SSC for each unit and all external key bindings and the current SSA will be lost. 
If the license you convert is under SSA, you will be able to select the version to convert the license to.

===Activations===
To increase your projects balance, select one of your projects, follow the "Add" link and enter the activation key in the corresponding field. You can also enter an optional comment for this key. You will then get a listing of all contained licenses. After commiting this key, your project balance will have been increased by the keys values.

"Deselect the current project" to view all activation keys independent of the selected project.

[[Image:Activations.jpg|center|thumb|200px|Activation key page]]

====License certificate====
You can always download the innovaphone license certificate for activation keys in your projects. Simply press the download link in the list at the right side.

===Own Activations===
Here you'll see a list of all created activation keys in the selected project (or over all projects).

You can create activation keys on the project page for other users/companies or to simply transfer licenses from one project to another. 
You can enter a comment, an order number and an order reference. The '''order number''' is your own order number for the key and the '''order reference''' is the reference number of the customer, who receives the newly created key. 
The order reference and order number will be shown in the innovaphone license certificate.

[[Image:Created_activations.jpg|center|thumb|200px|Created activation keys]]

You have to select an activation key in the activation key list to update or delete it.

Updating and deleting a key is only possible, if this key is not assigned.

====Update====
Add more licenses to this key or change its comment, order number and order reference. 
You can also remove licenses by entering e.g. -2, if you want to remove 2 licenses from the key.

[[Image:Own activations update.jpg|center|thumb|200px|Update own activation keys]]

====Delete====
Delete this key. Its licenses will go back into the balance of the currently selected project.

===Devices===
To view your devices you first have to click on the "Show" button. You can leave the filter field empty if you want to view all your devices.

[[Image:Devices_page.jpg|center|thumb|200px|The Devices Page]]

Red marked device names are devices, which are currently in RMA.

MAC addresses of RMA devices do not longer start with 01-...

====List====
A List of your devices in the currently selected project. 
You can deselect the current project/device to list all your devices.

Select a certain device from the device list, to manage its properties, licenses etc.

Actions on multiple devices:
* Move: move several devices into another project at once (see [[Howto:My_Innovaphone#Move_device|Move Device]])
* Remove: remove several devices at once (see [[Howto:My_Innovaphone#Remove|Remove]])

=====Add=====
Follow the "Add new devices" link on the devices page.

There you have a few options:
* You can add a single new device
* You can add devices according to a mac address range (e.g. from 00-90-33-08-20-00 to 00-90-33-08-22-00), maximum 50 at once
* You can add devices by uploading a text file with mac addresses like this (maximum 50 at once, each line one mac):

00-90-33-08-20-20
00-90-33-08-20-21
00-90-33-08-20-22
00-90-33-24-20-20

* You can add devices according to your received order number. Just enter you order number and you will get a list of all devices bount to this number.

Note: MAC addresses can be always given like this:
* 00-90-33-xx-xx-xx
* 00:90:33:xx:xx:xx
* 009033xxxxxx
* xxxxxx (00-90-33- will then be added automatically)

There might be errors, if you try to add a device. They are explained [[Howto:My_Innovaphone#Image_explanation|here]].

As the device warranty will be handled by licenses now, you can also add telephone devices
to your projects.

=====Add warranty extensions=====

Here you can add warranty extension licenses for all devices in the currently selected project. 
You'll get a list of all devices with the corresponding license type(s) and you can specify the years for each device (or for all devices by entering the number in the list header). 
After confirming your selection, you'll get an overview of all needed licenses, which you have to confirm too.

=====Check licence, SSA and warranty status of a device=====
Here you can list licenses with ssa and the warranty end date of a device, which is not in one of your projects. 
This is just available with the needed right.

=====Download devices of an order as CSV=====
Enter an order number to retrieve all devices for this order in a CSV file.

=====V7 master/slave scenario to V8 floating calculation=====

This gives you the possibility to calculate the SSCs for the change from a V7 master/slave scenario to a V8 floating installation. 
The calculation date is the date for which the calculation is valid. The final SSA date is an option to calculate SSA for the final masters licenses, if wished. 
Then you select the master and the slaves. 
If you want to have Standby/Voicemail licenses on the master, you have to select 'Yes' on the corresponding radio button. Maybe some new licenses must be bought depending on your setup. Theses licenses will be shown on the next page. 
At last you have the possibility to add further PBX port licenses, if you want to extend your installation and calculate SSCs for the new licenses.

====Properties====

Change the name and comment of a device.
You can only change the name, if it's no MAC or IPEI.
 
Here you have also the possibility, to directly request RMA for this device with prefilled values.

====Licenses====
Here you can add, download or move licenses.

=====Add licenses from balance=====
To create new licenses for a device, you have to add this device first on the devices page and then select a version of the license
and whether you want to summate the current licencing. If you select current licenses, then older licenses for example V6 or V7 licenses will also be counted as V8 licenses in the next overview. This is necessary if you want to license a V6 unit with V8 licenses, but still want to use it as V6.
After that click "Next".
On the next page you will see a list of all available license types, which depends on your current available license types, of the selected license version and the device type (IP6000, IP800 e.g.):
[[Image:licenses.jpg|center|thumb|200px|Licenses for an IP3000]]
 
If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses to this SSA end date or you can optionally change this date to another one for the new licenses.
 
You see the available project balance, the balance over all projects (excluding external projects), the currently installed licenses and the maximum amount for this device type. You can now enter the value of the new license.
Base/Upgrade licenses can be selected via dropdown box.
'''Voicemail and Standby lics must always have the same amount as the selected PBX-PBX... license!
The maximum amount of PBX-Registration licenses equals the amount of the selected PBX-PBX... license!'''

The whished overall amount of pbx version 8 and above licenses can be specified here and the concrete amount of license sub types will be requested on the next page.

[[Image:licenses2.jpg|center|thumb|200px|Licenses for an IP800 with V8, step two]]

The best (cheapest) combination of each v8 pbx license type is already filled in, but you might change the amount of sub types if your does not fit and you do not want to purchase new activation keys for the sub types.

The column SSC/Unit is just shown if your project is currently under SSA and you have entered a SSA end date.

The SSC multiplicator is the value, which you have to multiplicate with each license unit to get
the corresponding SSC amount.
E.g. if you have 20 units of PBX-Port8*20 licenses with a SSC value of 54 and a multiplicator of
1.0000 (which equals to 365 days) you have to pay 20*54*1.0000 ~ 1080 SSCs.

 If you create licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the currently selected version twice. 
e.g.: you want to bind licenses for V6 with SSA, so you have to pay SSCs from the release date of V7
 You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

Now confirm your new selection. If you have not enough licenses in your current project, but there are still licenses in other projects, you will get a dropdown box with a list of all projects containing the needed licenses. You can now select all desired/needed projects and confirm your selection again.
The balance of all selected projects will then be decreased by the needed amount.
 
 
If your user account has the right to buy licenses on credit, just check the checkbox.
 
You may enter an order number, which you can use for your order, if you buy on credit.

=====Add licenses from free licenses=====

Here you can assign licenses, which you returned from other devices.
You will also have to select the desired version and will than get a list of fitting licenses according to the current device and selected version.

[[Image:licenses_free.jpg|center|thumb|200px|Free Licenses for an IP800 with V8]]

If a license is under SSA, the correct license type is shown in column 'License Type' besides the 'Original Type'.
On confirming the selection, a consistency check is done (e.g. only 4 Relay-PRI licenses on an IP6000).
Bind and SSA end date will be maintained for each license.

As external keys are also maintained, you can select e.g. an old Dect-Multicell-Ari license to have the same ARI on another IP1200.
 

If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses
to this SSA end date or you can optionally change this date to another one for the new licenses.
You will have to confirm this after your first license selection (this is the same calculation as [[Reference:My_Innovaphone#SSA|here]]).

=====Add V7 floating license (slave pbx)=====
Here you can add a V7 floating license for a slave pbx. A device with a floating license can't have V7 pbx licenses and a device with V7 pbx licenses can't have a floating license.

=====Delete V7 floating license=====
Here you can delete an already existing floating license, if you won't use it anymore.

=====Add warranty extension licenses=====
Extend your warranty by adding warranty extension licenses:

[[Image:add_warranty.jpg|center|thumb|200px|Warranty extension]]

If you add the warranty extension immediately after the receipt of your device,
you can add the cheaper warranty extension licenses, otherwise you'll have to add
the more expensive ones.

You can extend the warranty for a maximum of four years.

=====Download licenses=====

[[Image:Device_download.jpg|center|thumb|200px|Download Licenses]]

You will get a dropdown with all available versions. Versions are dependent of your device, your licenses and of the ssa of your licenses. 
You are able to download downgraded versions of your licenses. E.g. if you have only V8 licenses, you can download a V7 license file (same restrictions as below).

Downgrades or only possible down to version 6!

If you do not want to download licenses by version, you have to decide whether to download the licenses encrypted or not.
'''If you download the licenses unencrypted, you won't be able to return those licenses anymore.'''
So you won't be able to return licenses for devices with V5-V7 licenses, as licenses for this versions are not encrypted.
To return these licenses, you will have to upgrade to a new bootcode, which prevents firmware downgrades to versions below version 8. 
Encrypted licenses are stored in a xml file, which you can then upload on your V8 (or higher) device.

You can now also download licenses directly from by the web interface of a device.
You just have to enter your account data and start downloading the licenses from my.innovaphone.com
without having to download/upload a license file.

=====Download test licenses=====

[[Image:Device_download_test.jpg|center|thumb|200px|Download test licenses]]

You can also download test licenses if you want to run tests. You will be asked, which version you want to use, whether the device is used as slave and if not used as slave, how many pbx licenses you want to use.

=====Move licenses to another device=====
If you have the needed account rights or the device is already in RMA, you can move licenses to another device. After moving licenses, the former device will be marked as a RMA device.

You can just move licenses to devices without licenses!

====Move device====
Here you can move the current device or the selected devices to another project. 
If you select a SSA project, you can change the SSA end date for the move process. 

If the other project is under SSA, you will first see a SSC calculation, which you have to confirm,
as the SSA date for each SSA license will be extended until the given SSA end date
(this is the same calculation as adding SSA to an already existing project, see [[Reference:My_Innovaphone#SSA|here]]).

====Invalidation====

=====Requirements=====
* V8 or higher
* access to the webinteraface
* a device certificate
* my.innovaphone login credentials

=====Informations=====

You can invalidate V8 (or higher) licenses by uploading the XML file, you got from your device or by returning your licenses over the web interface of your device ([[Reference8:Configuration/General/License]]), in order to return [[Reference8:Licenses#Gateway_Licenses|PBX licenses]] back to the balance.

V7 licenses can be just returned, if you agree, that you won't be able to downgrade below V8 anymore. You will need a new bootcode, to use this function. '''You need a V8 firmware or higher for invalidation.'''

If your device has access to my.innovaphone.com, you can also invalidate licenses directly
from the web interface of the device.

[[Reference8:Licenses#Gateway_Licenses|gateway licenses]] and warranty extensions won't be returned to the balance and remain to be assigned to the device!

=====Process=====

Steps to invalidate licenses, if your device has internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# enter your my.innovaphone account, the device must be in one of your projects
# click Invalidate
# click Transfer (this might fail, if NTP or DNS is not configured properly or device certificate is not installed)
# reset if asked for

Steps to invalidate licenses, if your device has no internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# enter your my.innovaphone account, the device must be in one of your projects
# click Invalidate
# click Backup and upload this file on my.innovaphone [[Reference:My_Innovaphone#Upload_the_invalidation_document_to_return_licenses|here]]
# you'll get a confirmation file after uploading the saved file
# upload this on the device (under Step1)
# reset if asked for

"Your IP800 does not have a device certificate on it." - In this case you need to download a hardware certification, please contact the innovaphone [mailto:support@innovaphone.com support].

=====Download confirmation file=====
If you created a new certificate or you invalidated your licenses, you can later download the confirmation file, which you have to upload on the box.

=====Request certificate=====
If you have the needed rights, you can request a new device certificate for your device.

=====Upload the invalidation document to return licenses=====
Upload the invalidation document, which you got from the website of the device to return the licenses of this device.

After uploading you'll get a confirmation file, which you have to upload on your device.

====Remove====
You can always remove devices from a project. If they have licenses, these won't be deleted, so you might add the device to another project again.

===History===
[[Image:history.jpg|center|thumb|200px|History page]]
You can view your history for several contexts:
* Company: history of all actions in your company
* User: history of all actions of the selected user
* Device: history of all actions for the selected device

Each context applies to the currently selected project.
If you deselect the current project, you will see the history over all projects.

You can select to view the history of the last day, week, month, year or from always. Collecting data might take a while...

===Company===
Manage users, import other companies or change your company data.
The first user of a company has automatically company admin rights and can grant this right to other company users after adding their accounts email address. 

====Users====

[[Image:company.jpg|center|thumb|200px|Company page]]
Here you can add other users to your company, optionally with company admin rights.
You can also lock a user account or grant company admin rights. 
Locked users can't loggin to my.innovaphone.com any more. 
Instead of locking a user you can also remove this user from your company. The user itself will still have his my.innovaphone account, but won't belong to your company any more. The history of this user is still available after having removed him.

Non company admin users just get a non editable list of the current company users.

A user can be member of several companies and the users rights, company admin and
locked status can be different for all companies, where this user is in.

====Join (admin only)====
As admin you can also join another company into your company by entering an admin account of this company. This might be usefull if one user of your company has accidentally created an own company. 
Everything like projects, users, devices, balance, activations etc. will be imported! 
You also have to enter the company id of the company, which is to be imported. You can find this company under Licenses->Company and the company tab.

This is not available for non company admin users.

The joined company will be deleted afterwards!

====Company====
If you do not belong to a my innovaphone company, you can create one here. You can optionally enter an innovaphone account ID with its zip code or you just enter your company data below.

[[Image:company_create.jpg|center|thumb|200px|Company create page]]

Otherwise you can change your company data, but only, if you didn't created your company with your innovaphone account id. In this case, company information is always retrieved from your innovaphone account.
Non company admin users can just view the current company data.

You also see your company id here, which is sometimes needed for adding external project rights or
to be imported by another company.

You can check the '''Device SSA''' checkbox, if you want to receive SSA expiry reminder mails for each device independent of the projects SSA end date.
These mails will be send weekly seven weeks before the SSA for a license a the device expires.

====New Company====
If you need several companies for some reasons, you can create another one here. 
You will be an admin user in this new company and you can directly select the newly created company at the top right corner.

==RMA==
Here you can see all your RMA devices, which arrived innovaphone already. The licenses of this macadresses are moveable.
[[Image:rma.jpg|center|thumb|200px|RMA page]]
 
If you want to request RMA for a certain device, go to the device properties and follow the "Request RMA" link.

==Mantis==
Here you'll get a list of all open support cases in our mantis system, which are assigned to email addresses of your my.innovaphone users in your company.

==Configurator==
Currently this is just a link to the [http://config.innovaphone.com innovaphone PBX Configurator]

==Account==
Here you can change your personal data, password etc. You always have to enter your current password to change your data.

If you change your email address, you'll have to activate your account again.

==Company selection==
If your user account belongs to several companies, you can switch between companies be using the dropdown box at the top right corner of the page. 
You'll get an error, if you try to switch to a company, where your account is locked. 

[[Image:company_selection.jpg|center|thumb|200px|Dropdown box for company selection]]

 
If you loggin, the first found company is selected for your user.

==Image explanation==

===Errors===

====Already In Company====
[[Image:Icon_in_company_inno_01.png]]
* This device already exists in your company and can't be added/imported.
If you want to import this device anyway, you first have to delete your current device from its project.

====Already Imported====
[[Image:Icon_imported_inno_01.png]]
* This device has been already imported.
You can't import it again.

====Not Found====
[[Image:Icon_not_found_inno_01.png]]
* This device was not found in the my innovaphone database.
This should never happen, but if, contact the administrator.

====IPVA MAC exists====
[[Image:Icon_ip_va_exists_inno_01.png]]
* An IPVA MAC address must be unique and can be assigned to just one company. You tried to add an already existing IPVA MAC.
Please assign a new one to your IPVA. For further details, see [[Reference9:Innovaphone_Virtual_Appliance#License_Configuration]].

===Warnings===

====Several Companies====
[[Image:Icon_several_companies_inno_01.png]]
* This device is already in another company.
This means, that either you do not have the physical device or it once belonged another company.
You can still import/add this device and you will have access to all of its current licenses.

====Several Users====
[[Image:Icon several users inno 01.png]]
* This device has licenses from several users of the old license manager.
This means, that you are not neccessarily the user, who physically owns this device. If you do not own it, do not import it.

===Misc===
====No downgrade====
[[Image:no_downgrade.png]]
* Licenses, which have been downloaded for V5/V6/V7, were returned from this device, so no downgrade to these versions is allowed any more.



==Release dates==
V5: 01/01/2003 
V6: 02/11/2006 
V7: 14/11/2008 
V8: 07/12/2009 

==myplay==
[[https://myplay.innovaphone.com myplay]] offers a platform to test all my.innovaphone related content. You can create activation keys, licenses, accounts, projects and so on to learn it or to calculate possible scenarios.

===Base===
The base of the database is the my.innovaphone database from the 13.8.2010. All accounts, companies and projects have been imported and are available until this date. 
From this date on the databases won't be synchronised any more (despite of the device table)!

===Balance===
You can change your balance by yourself. Simply select the license type in the dropdown box on the balance page, enter the desired amount and your balance will be increased by this type.

===Activation keys===
You can create own activation keys. These will have the prefix "PLAY-" to identify them as play activation keys. You won't be able to upload them on my.innovaphone.com.

===Licenses===
After having selected a device under Licenses->Devices, you can add/change licenses as you want by selecting new ones in the dropdown box or changing existing ones.

====Download====
You will always just download test licenses here!

====Invalidation====
Won't be possible here, because this is hardware related and can't be simulated.

====Checkbox editing via list====
* 'D' Deletes the license
* 'B' Puts the license back into the projects balance
* 'F' Puts the license into the pool of free licenses

===Device RMA===
You can put a device under RMA to test this scenario (Licenses->Devices, select a device and ->Properties). You can also remove the RMA status here.

==Known Issues==
* Devices where imported into a project with SSA. If this happened to you, please move the corresponding devices into a project '''without''' SSA and back into the project '''with''' SSA to extend/add SSA for the licenses until the SSA end date.
* IE7 moves a list under the menu, when a list becomes to wide

Reference:My Innovaphone

2010-09-10T10:22:18Z

Kti: /* Invalidation */

==About==
My innovaphone replaces the former license manager.
It will also include the handling of device warranty and software service agreements (only partially implemented yet).

===Project-View===
My innovaphone offers the possibility for several users to be in one company. This company shares its balance of licenses over all users and can have several projects. Projects have their own balance of license types and devices are bound to a project.

===Language===
My innovaphone will support multiple languages. You can select your desired language at the top of the page. 
Currently supported languages:
* English
* German
* Italian
* Dutch
* French

===Guides===

====Quickstart guide====
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_nl.pdf Dutch quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_en.pdf English quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_fr.pdf French quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_de.pdf German quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_it.pdf Italian quickstart guide] 

====SSA guide====
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_en.pdf English SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_fr.pdf French SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_de.pdf German SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_it.pdf Italian SSA guide] 

==First steps==
Open [https://my.innovaphone.com my.innovaphone.com] and click the "Register Now" link.
Enter your personal data and register.

You will receive a registration email with an activation link.
After account activation you have two options:
* create a new my innovaphone company (under Licenses->Company)
* ask another user of your company to add your user account to an already existing company

If you accidentally created an own my innovaphone company, just ask another user of your company to import your just created company.

If you create a new company, you can '''optionally''' enter your innovaphone account ID (which is your customer number with innovaphone) with your postal code, to retrieve your company data.

You will see a help link at the right side of the horizontal tab menu.
This link shows the corresponding text of the wiki section, when hovering with the mouse over it,
and redirects to the corresponding wiki menu, if clicked.

It is now possible, that one user is member of serveral companies!

==Search==
At the right top of the page you have a search field. You can search for different things:
* Devices (part of a device name or device comment)
* Projects (part of a project name or project description)
* Own activation keys (part of an activation key or its description)

You have to enter at least '''three''' chars to start a search. To search for activation keys,
you have to enter at least '''five''' chars.
* Search for license types. Enter e.g. "PBX-Port8" to find all devices with Port8 licenses or enter "PBX-Port8=100" to find all devices with Port8 licenses '''>=''' 100.

==Licenses==
===Projects===
After creation of an own company, you will have a default project named "DEFAULT". You can rename this project later.
You can also create more projects on the projects page with "Create".
Each project of a company must have a unique name.

Do '''not''' set SSA, if you want to import your devices from your old license manager account first.
If you want SSA and you '''won't import''' devices into this project from your old account, you should set SSA at once.

You can select a certain project by activating it in the project list. This selection is then true for all other pages, as some pages require a selected project.

[[Image:overview.jpg|center|thumb|200px|Projects page]]

By activating a project by clicking on the project name in the project list, you can manage this project and its settings.

====Properties====
Rename the project or/and change its description.

====SSA====
You can put your project under SSA (software service agreement).
You will be asked to enter a SSA end date. This will be the date, where all SSA licenses of all devices in this project will expire.
The end date mustn't be in the past.

After entering a date, you will get a summary of all licenses, which will be put under SSA and the amount of needed SSC licenses.
The SSC value for each license is calculated by the bind date of the license and the entered SSA end date.

[[Image:Ssa_extend.jpg|center|thumb|200px|SSA summary]]

If you have licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the current license version. 

e.g. you have a V7 PBX-PBX7#15 license with bind date 1/1/2010. Version 8 was released on 7/12/2009, so SSA is
calculated from 7/12/2009 for this license. You will see the calculation date in the list under "bind date"

If licenses already have a SSA date, just the difference between the current SSA date and the entered SSA end date must be paid.
If the bind date of the device lies in the past, the difference between the bind date and the current date must be paided twice (this is the column 'days*2'). 
If your license is under SSA, which is already over, you also have to pay the time between the old SSA date and the current SSA end date twice.

Here is a short example, how the days are calculated:

Bind date: 24/06/2009 
Current date: 31/08/2009 
SSA end date: 12/12/2011 
 
You will have to pay from 24/06/2009 to 31/08/2009 twice for 68 days.
From 31/08/2009 to 12/12/2011 you will then have to pay the normal price for 833 days.

You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

You can preview the SSC calculation for another calculation date. Simply change the dropdown
selection to get the new SSC value.
Of course you can't confirm this calculation for another date, just for the current date!

After confirming your entered SSA end date, each license will have this date as SSA end date and can be downloaded in all versions of this SSA time.

You can now extend the projects SSA end date like as setting a new one.
The resulting summary is the same as above.

If your user account has the right to buy licenses on credit, just check the checkbox.
You may enter an order number, which you can use for your order, if you buy on credit.

If project SSA will expire, each company user will receive a reminder mail '''7''' weeks before and
then every week one mail.
You can disable these mails with the checkbox 'Send SSA expiry mails'.
Note that every user can configure, if he wants to receive mails or not in his account settings.

====Rights====
Add or delete company rights for this project. To add a company right, you have to enter the company id of this company.
Each user of a company with rights on this project can add devices, licenses, activation keys to this specific project, but is restricted in removing devices, editing the project and can't create activation keys with the projects balance.

The company id can be found under Licenses->company and the company tab.

[[Image:Project_rights.jpg|center|thumb|200px|Project rights]]

====Import====
To download old licenses created with an old license manager account and to use your old balance, you have to import your old account data.
You will have to enter your old account login from license.innovaphone.com. Afterwards you will get a list of your balance and of all your devices with their licenses.
The shown balance is the balance of all users, which belong to your old group (if you belonged to a group).
You can now select all devices which you want to import to the currently selected project.
There might be errors, if you try to add a device. They are explained [[Howto:My_Innovaphone#Image_explanation|here]].

By confirming this import, all users of your group will be locked in the old license manager.

You can import all not yet imported devices to another project, if you want.

Importing of your old balance and devices might take a while!

You can also import just one mac address, if you are the owner of the device, but haven't created any licenses in the old account. Your old account and its balance won't be affected then.

====Join====
Here you can join your currently selected project with another project, which you select from a dropdown box. 
If the other project has SSA, you'll see the current SSA end date, which you might change for the join process and you will get a list of all licenses, which might be updated to the ssa end date/changed date of the other project. The list equals the list shown under [[Reference:My_Innovaphone#SSA|SSA]].

The selected project will be automatically deleted after the join. You can't join a project,
if it grants external rights to another customer. Delete these rights before.

====Delete====
Delete the project. Only possible if it has no activation keys, project rights, devices or user rights.
 
You may [[Reference:My_Innovaphone#Join|join]] your project into another one, if you can't delete it.

====Project Freed_RMA_licenses====
If you see a project with this name in your project list, you had a RMA device with not yed moved licenses, which was shipped to innovaphone and reshipped to another customer. 
The licenses of such a device have been moved into the pool of free licenses of the project Freed_RMA_licenses, from where you can assign them to another device.

===Balance===
On the balance page you will see the balance of the currently selected project or the balance of all your projects together.
The balance is bound to your company and '''not''' to your user account. The balance is bound to a specific project, but can be shared for license creation or activation key creation if wished. 
Sharing the balance over several projects is not possible in external projects!

[[Image:Balancepage.jpg|center|thumb|200px|Balance page]]

====Free licenses====

Here you see a list of all your free licenses. If you return licenses from one of your devices, the returned licenses are stored in your free licenses pool. You can assign these licenses to another device (see [[#Add licenses from free licenses|'Add licenses from free licenses']]) or convert them to your balance.

[[Image:Balance_free_lics.jpg|center|thumb|200px|Free licenses list]]

The bind date, SSA end date and the external key (like DECT-Multi-Cell-Ari) are stored for each license.

If you want to convert these licenses to your balance, you will have to pay one year SSC for each unit and all external key bindings and the current SSA will be lost. 
If the license you convert is under SSA, you will be able to select the version to convert the license to.

===Activations===
To increase your projects balance, select one of your projects, follow the "Add" link and enter the activation key in the corresponding field. You can also enter an optional comment for this key. You will then get a listing of all contained licenses. After commiting this key, your project balance will have been increased by the keys values.

"Deselect the current project" to view all activation keys independent of the selected project.

[[Image:Activations.jpg|center|thumb|200px|Activation key page]]

====License certificate====
You can always download the innovaphone license certificate for activation keys in your projects. Simply press the download link in the list at the right side.

===Own Activations===
Here you'll see a list of all created activation keys in the selected project (or over all projects).

You can create activation keys on the project page for other users/companies or to simply transfer licenses from one project to another. 
You can enter a comment, an order number and an order reference. The '''order number''' is your own order number for the key and the '''order reference''' is the reference number of the customer, who receives the newly created key. 
The order reference and order number will be shown in the innovaphone license certificate.

[[Image:Created_activations.jpg|center|thumb|200px|Created activation keys]]

You have to select an activation key in the activation key list to update or delete it.

Updating and deleting a key is only possible, if this key is not assigned.

====Update====
Add more licenses to this key or change its comment, order number and order reference. 
You can also remove licenses by entering e.g. -2, if you want to remove 2 licenses from the key.

[[Image:Own activations update.jpg|center|thumb|200px|Update own activation keys]]

====Delete====
Delete this key. Its licenses will go back into the balance of the currently selected project.

===Devices===
To view your devices you first have to click on the "Show" button. You can leave the filter field empty if you want to view all your devices.

[[Image:Devices_page.jpg|center|thumb|200px|The Devices Page]]

Red marked device names are devices, which are currently in RMA.

MAC addresses of RMA devices do not longer start with 01-...

====List====
A List of your devices in the currently selected project. 
You can deselect the current project/device to list all your devices.

Select a certain device from the device list, to manage its properties, licenses etc.

Actions on multiple devices:
* Move: move several devices into another project at once (see [[Howto:My_Innovaphone#Move_device|Move Device]])
* Remove: remove several devices at once (see [[Howto:My_Innovaphone#Remove|Remove]])

=====Add=====
Follow the "Add new devices" link on the devices page.

There you have a few options:
* You can add a single new device
* You can add devices according to a mac address range (e.g. from 00-90-33-08-20-00 to 00-90-33-08-22-00), maximum 50 at once
* You can add devices by uploading a text file with mac addresses like this (maximum 50 at once, each line one mac):

00-90-33-08-20-20
00-90-33-08-20-21
00-90-33-08-20-22
00-90-33-24-20-20

* You can add devices according to your received order number. Just enter you order number and you will get a list of all devices bount to this number.

Note: MAC addresses can be always given like this:
* 00-90-33-xx-xx-xx
* 00:90:33:xx:xx:xx
* 009033xxxxxx
* xxxxxx (00-90-33- will then be added automatically)

There might be errors, if you try to add a device. They are explained [[Howto:My_Innovaphone#Image_explanation|here]].

As the device warranty will be handled by licenses now, you can also add telephone devices
to your projects.

=====Add warranty extensions=====

Here you can add warranty extension licenses for all devices in the currently selected project. 
You'll get a list of all devices with the corresponding license type(s) and you can specify the years for each device (or for all devices by entering the number in the list header). 
After confirming your selection, you'll get an overview of all needed licenses, which you have to confirm too.

=====Check licence, SSA and warranty status of a device=====
Here you can list licenses with ssa and the warranty end date of a device, which is not in one of your projects. 
This is just available with the needed right.

=====Download devices of an order as CSV=====
Enter an order number to retrieve all devices for this order in a CSV file.

====Properties====

Change the name and comment of a device.
You can only change the name, if it's no MAC or IPEI.
 
Here you have also the possibility, to directly request RMA for this device with prefilled values.

====Licenses====
Here you can add, download or move licenses.

=====Add licenses from balance=====
To create new licenses for a device, you have to add this device first on the devices page and then select a version of the license
and whether you want to summate the current licencing. If you select current licenses, then older licenses for example V6 or V7 licenses will also be counted as V8 licenses in the next overview. This is necessary if you want to license a V6 unit with V8 licenses, but still want to use it as V6.
After that click "Next".
On the next page you will see a list of all available license types, which depends on your current available license types, of the selected license version and the device type (IP6000, IP800 e.g.):
[[Image:licenses.jpg|center|thumb|200px|Licenses for an IP3000]]
 
If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses to this SSA end date or you can optionally change this date to another one for the new licenses.
 
You see the available project balance, the balance over all projects (excluding external projects), the currently installed licenses and the maximum amount for this device type. You can now enter the value of the new license.
Base/Upgrade licenses can be selected via dropdown box.
'''Voicemail and Standby lics must always have the same amount as the selected PBX-PBX... license!
The maximum amount of PBX-Registration licenses equals the amount of the selected PBX-PBX... license!'''

The whished overall amount of pbx version 8 and above licenses can be specified here and the concrete amount of license sub types will be requested on the next page.

[[Image:licenses2.jpg|center|thumb|200px|Licenses for an IP800 with V8, step two]]

The best (cheapest) combination of each v8 pbx license type is already filled in, but you might change the amount of sub types if your does not fit and you do not want to purchase new activation keys for the sub types.

The column SSC/Unit is just shown if your project is currently under SSA and you have entered a SSA end date.

The SSC multiplicator is the value, which you have to multiplicate with each license unit to get
the corresponding SSC amount.
E.g. if you have 20 units of PBX-Port8*20 licenses with a SSC value of 54 and a multiplicator of
1.0000 (which equals to 365 days) you have to pay 20*54*1.0000 ~ 1080 SSCs.

 If you create licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the currently selected version twice. 
e.g.: you want to bind licenses for V6 with SSA, so you have to pay SSCs from the release date of V7
 You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

Now confirm your new selection. If you have not enough licenses in your current project, but there are still licenses in other projects, you will get a dropdown box with a list of all projects containing the needed licenses. You can now select all desired/needed projects and confirm your selection again.
The balance of all selected projects will then be decreased by the needed amount.
 
 
If your user account has the right to buy licenses on credit, just check the checkbox.
 
You may enter an order number, which you can use for your order, if you buy on credit.

=====Add licenses from free licenses=====

Here you can assign licenses, which you returned from other devices.
You will also have to select the desired version and will than get a list of fitting licenses according to the current device and selected version.

[[Image:licenses_free.jpg|center|thumb|200px|Free Licenses for an IP800 with V8]]

If a license is under SSA, the correct license type is shown in column 'License Type' besides the 'Original Type'.
On confirming the selection, a consistency check is done (e.g. only 4 Relay-PRI licenses on an IP6000).
Bind and SSA end date will be maintained for each license.

As external keys are also maintained, you can select e.g. an old Dect-Multicell-Ari license to have the same ARI on another IP1200.
 

If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses
to this SSA end date or you can optionally change this date to another one for the new licenses.
You will have to confirm this after your first license selection (this is the same calculation as [[Reference:My_Innovaphone#SSA|here]]).

=====Add V7 floating license (slave pbx)=====
Here you can add a V7 floating license for a slave pbx. A device with a floating license can't have V7 pbx licenses and a device with V7 pbx licenses can't have a floating license.

=====Delete V7 floating license=====
Here you can delete an already existing floating license, if you won't use it anymore.

=====Add warranty extension licenses=====
Extend your warranty by adding warranty extension licenses:

[[Image:add_warranty.jpg|center|thumb|200px|Warranty extension]]

If you add the warranty extension immediately after the receipt of your device,
you can add the cheaper warranty extension licenses, otherwise you'll have to add
the more expensive ones.

You can extend the warranty for a maximum of four years.

=====Download licenses=====

[[Image:Device_download.jpg|center|thumb|200px|Download Licenses]]

You will get a dropdown with all available versions. Versions are dependent of your device, your licenses and of the ssa of your licenses. 
You are able to download downgraded versions of your licenses. E.g. if you have only V8 licenses, you can download a V7 license file (same restrictions as below).

Downgrades or only possible down to version 6!

If you do not want to download licenses by version, you have to decide whether to download the licenses encrypted or not.
'''If you download the licenses unencrypted, you won't be able to return those licenses anymore.'''
So you won't be able to return licenses for devices with V5-V7 licenses, as licenses for this versions are not encrypted.
To return these licenses, you will have to upgrade to a new bootcode, which prevents firmware downgrades to versions below version 8. 
Encrypted licenses are stored in a xml file, which you can then upload on your V8 (or higher) device.

You can now also download licenses directly from by the web interface of a device.
You just have to enter your account data and start downloading the licenses from my.innovaphone.com
without having to download/upload a license file.

=====Download test licenses=====

[[Image:Device_download_test.jpg|center|thumb|200px|Download test licenses]]

You can also download test licenses if you want to run tests. You will be asked, which version you want to use, whether the device is used as slave and if not used as slave, how many pbx licenses you want to use.

=====Move licenses to another device=====
If you have the needed account rights or the device is already in RMA, you can move licenses to another device. After moving licenses, the former device will be marked as a RMA device.

You can just move licenses to devices without licenses!

====Move device====
Here you can move the current device or the selected devices to another project. 
If you select a SSA project, you can change the SSA end date for the move process. 

If the other project is under SSA, you will first see a SSC calculation, which you have to confirm,
as the SSA date for each SSA license will be extended until the given SSA end date
(this is the same calculation as adding SSA to an already existing project, see [[Reference:My_Innovaphone#SSA|here]]).

====Invalidation====

=====Requirements=====
* V8 or higher
* access to the webinteraface
* a device certificate
* my.innovaphone login credentials

=====Informations=====

You can invalidate V8 (or higher) licenses by uploading the XML file, you got from your device or by returning your licenses over the web interface of your device ([[Reference8:Configuration/General/License]]), in order to return [[Reference8:Licenses#Gateway_Licenses|PBX licenses]] back to the balance.

V7 licenses can be just returned, if you agree, that you won't be able to downgrade below V8 anymore. You will need a new bootcode, to use this function. '''You need a V8 firmware or higher for invalidation.'''

If your device has access to my.innovaphone.com, you can also invalidate licenses directly
from the web interface of the device.

[[Reference8:Licenses#Gateway_Licenses|gateway licenses]] and warranty extensions won't be returned to the balance and remain to be assigned to the device!

=====Process=====

Steps to invalidate licenses, if your device has internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# enter your my.innovaphone account, the device must be in one of your projects
# click Invalidate
# click Transfer (this might fail, if NTP or DNS is not configured properly or device certificate is not installed)
# reset if asked for

Steps to invalidate licenses, if your device has no internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# enter your my.innovaphone account, the device must be in one of your projects
# click Invalidate
# click Backup and upload this file on my.innovaphone [[Reference:My_Innovaphone#Upload_the_invalidation_document_to_return_licenses|here]]
# you'll get a confirmation file after uploading the saved file
# upload this on the device (under Step1)
# reset if asked for

=====Download confirmation file=====
If you created a new certificate or you invalidated your licenses, you can later download the confirmation file, which you have to upload on the box.

=====Request certificate=====
If you have the needed rights, you can request a new device certificate for your device.

=====Upload the invalidation document to return licenses=====
Upload the invalidation document, which you got from the website of the device to return the licenses of this device.

After uploading you'll get a confirmation file, which you have to upload on your device.

====Remove====
You can always remove devices from a project. If they have licenses, these won't be deleted, so you might add the device to another project again.

===History===
[[Image:history.jpg|center|thumb|200px|History page]]
You can view your history for several contexts:
* Company: history of all actions in your company
* User: history of all actions of the selected user
* Device: history of all actions for the selected device

Each context applies to the currently selected project.
If you deselect the current project, you will see the history over all projects.

You can select to view the history of the last day, week, month, year or from always. Collecting data might take a while...

===Company===
Manage users, import other companies or change your company data.
The first user of a company has automatically company admin rights and can grant this right to other company users after adding their accounts email address. 

====Users====

[[Image:company.jpg|center|thumb|200px|Company page]]
Here you can add other users to your company, optionally with company admin rights.
You can also lock a user account or grant company admin rights. 
Locked users can't loggin to my.innovaphone.com any more. 
Instead of locking a user you can also remove this user from your company. The user itself will still have his my.innovaphone account, but won't belong to your company any more. The history of this user is still available after having removed him.

Non company admin users just get a non editable list of the current company users.

A user can be member of several companies and the users rights, company admin and
locked status can be different for all companies, where this user is in.

====Join (admin only)====
As admin you can also join another company into your company by entering an admin account of this company. This might be usefull if one user of your company has accidentally created an own company. 
Everything like projects, users, devices, balance, activations etc. will be imported! 
You also have to enter the company id of the company, which is to be imported. You can find this company under Licenses->Company and the company tab.

This is not available for non company admin users.

The joined company will be deleted afterwards!

====Company====
If you do not belong to a my innovaphone company, you can create one here. You can optionally enter an innovaphone account ID with its zip code or you just enter your company data below.

[[Image:company_create.jpg|center|thumb|200px|Company create page]]

Otherwise you can change your company data, but only, if you didn't created your company with your innovaphone account id. In this case, company information is always retrieved from your innovaphone account.
Non company admin users can just view the current company data.

You also see your company id here, which is sometimes needed for adding external project rights or
to be imported by another company.

====New Company====
If you need several companies for some reasons, you can create another one here. 
You will be an admin user in this new company and you can directly select the newly created company at the top right corner.

==RMA==
Here you can see all your RMA devices, which arrived innovaphone already. The licenses of this macadresses are moveable.
[[Image:rma.jpg|center|thumb|200px|RMA page]]
 
If you want to request RMA for a certain device, go to the device properties and follow the "Request RMA" link.

==Mantis==
Here you'll get a list of all open support cases in our mantis system, which are assigned to email addresses of your my.innovaphone users in your company.

==Configurator==
Currently this is just a link to the [http://config.innovaphone.com innovaphone PBX Configurator]

==Account==
Here you can change your personal data, password etc. You always have to enter your current password to change your data.

If you change your email address, you'll have to activate your account again.

==Company selection==
If your user account belongs to several companies, you can switch between companies be using the dropdown box at the top right corner of the page. 
You'll get an error, if you try to switch to a company, where your account is locked. 

[[Image:company_selection.jpg|center|thumb|200px|Dropdown box for company selection]]

 
If you loggin, the first found company is selected for your user.

==Image explanation==

===Errors===

====Already In Company====
[[Image:Icon_in_company_inno_01.png]]
* This device already exists in your company and can't be added/imported.
If you want to import this device anyway, you first have to delete your current device from its project.

====Already Imported====
[[Image:Icon_imported_inno_01.png]]
* This device has been already imported.
You can't import it again.

====Not Found====
[[Image:Icon_not_found_inno_01.png]]
* This device was not found in the my innovaphone database.
This should never happen, but if, contact the administrator.

===Warnings===

====Several Companies====
[[Image:Icon_several_companies_inno_01.png]]
* This device is already in another company.
This means, that either you do not have the physical device or it once belonged another company.
You can still import/add this device and you will have access to all of its current licenses.

====Several Users====
[[Image:Icon several users inno 01.png]]
* This device has licenses from several users of the old license manager.
This means, that you are not neccessarily the user, who physically owns this device. If you do not own it, do not import it.

===Misc===
====No downgrade====
[[Image:no_downgrade.png]]
* Licenses, which have been downloaded for V5/V6/V7, were returned from this device, so no downgrade to these versions is allowed any more.



==Release dates==
V5: 01/01/2003 
V6: 02/11/2006 
V7: 14/11/2008 
V8: 07/12/2009 

==myplay==
[[https://myplay.innovaphone.com myplay]] offers a platform to test all my.innovaphone related content. You can create activation keys, licenses, accounts, projects and so on to learn it or to calculate possible scenarios.

===Base===
The base of the database is the my.innovaphone database from the 13.8.2010. All accounts, companies and projects have been imported and are available until this date. 
From this date on the databases won't be synchronised any more (despite of the device table)!

===Balance===
You can change your balance by yourself. Simply select the license type in the dropdown box on the balance page, enter the desired amount and your balance will be increased by this type.

===Activation keys===
You can create own activation keys. These will have the prefix "PLAY-" to identify them as play activation keys. You won't be able to upload them on my.innovaphone.com.

===Licenses===
After having selected a device under Licenses->Devices, you can add/change licenses as you want by selecting new ones in the dropdown box or changing existing ones.

====Download====
You will always just download test licenses here!

====Invalidation====
Won't be possible here, because this is hardware related and can't be simulated.

====Checkbox editing via list====
* 'D' Deletes the license
* 'B' Puts the license back into the projects balance
* 'F' Puts the license into the pool of free licenses

===Device RMA===
You can put a device under RMA to test this scenario (Licenses->Devices, select a device and ->Properties). You can also remove the RMA status here.

==Known Issues==
* Devices where imported into a project with SSA. If this happened to you, please move the corresponding devices into a project '''without''' SSA and back into the project '''with''' SSA to extend/add SSA for the licenses until the SSA end date.
* IE7 moves a list under the menu, when a list becomes to wide

Reference:My Innovaphone

2010-07-28T13:59:34Z

Kti: /* Add licenses from balance */

==About==
My innovaphone replaces the former license manager.
It will also include the handling of device warranty and software service agreements (only partially implemented yet).

===Project-View===
My innovaphone offers the possibility for several users to be in one company. This company shares its balance of licenses over all users and can have several projects. Projects have their own balance of license types and devices are bound to a project.

===Language===
My innovaphone will support multiple languages. You can select your desired language at the top of the page. 
Currently supported languages:
* English
* German
* Italian
* Dutch
* French

===Guides===

====Quickstart guide====
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_nl.pdf Dutch quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_en.pdf English quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_fr.pdf French quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_de.pdf German quickstart guide] 
[https://my.innovaphone.com/docs/my_innovaphone_Quick_Start_Guide_it.pdf Italian quickstart guide] 

====SSA guide====
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_en.pdf English SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_fr.pdf French SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_de.pdf German SSA guide] 
[https://my.innovaphone.com/docs/innovaphone_SSA_Leitfaden_it.pdf Italian SSA guide] 

==First steps==
Open [https://my.innovaphone.com my.innovaphone.com] and click the "Register Now" link.
Enter your personal data and register.

You will receive a registration email with an activation link.
After account activation you have two options:
* create a new my innovaphone company (under Licenses->Company)
* ask another user of your company to add your user account to an already existing company

If you accidentally created an own my innovaphone company, just ask another user of your company to import your just created company.

If you create a new company, you can '''optionally''' enter your innovaphone account ID (which is your customer number with innovaphone) with your postal code, to retrieve your company data.

You will see a help link at the right side of the horizontal tab menu.
This link shows the corresponding text of the wiki section, when hovering with the mouse over it,
and redirects to the corresponding wiki menu, if clicked.

It is now possible, that one user is member of serveral companies!

==Search==
At the right top of the page you have a search field. You can search for different things:
* Devices (part of a device name or device comment)
* Projects (part of a project name or project description)
* Own activation keys (part of an activation key or its description)

You have to enter at least '''three''' chars to start a search. To search for activation keys,
you have to enter at least '''five''' chars.
* Search for license types. Enter e.g. "PBX-Port8" to find all devices with Port8 licenses or enter "PBX-Port8=100" to find all devices with Port8 licenses '''>=''' 100.

==Licenses==
===Projects===
After creation of an own company, you will have a default project named "DEFAULT". You can rename this project later.
You can also create more projects on the projects page with "Create".
Each project of a company must have a unique name.

Do '''not''' set SSA, if you want to import your devices from your old license manager account first.
If you want SSA and you '''won't import''' devices into this project from your old account, you should set SSA at once.

You can select a certain project by activating it in the project list. This selection is then true for all other pages, as some pages require a selected project.

[[Image:overview.jpg|center|thumb|200px|Projects page]]

By activating a project by clicking on the project name in the project list, you can manage this project and its settings.

====Properties====
Rename the project or/and change its description.

====SSA====
You can put your project under SSA (software service agreement).
You will be asked to enter a SSA end date. This will be the date, where all SSA licenses of all devices in this project will expire.
The end date mustn't be in the past.

After entering a date, you will get a summary of all licenses, which will be put under SSA and the amount of needed SSC licenses.
The SSC value for each license is calculated by the bind date of the license and the entered SSA end date.

[[Image:Ssa_extend.jpg|center|thumb|200px|SSA summary]]

If you have licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the current license version. 

e.g. you have a V7 PBX-PBX7#15 license with bind date 1/1/2010. Version 8 was released on 7/12/2009, so SSA is
calculated from 7/12/2009 for this license. You will see the calculation date in the list under "bind date"

If licenses already have a SSA date, just the difference between the current SSA date and the entered SSA end date must be paid.
If the bind date of the device lies in the past, the difference between the bind date and the current date must be paided twice (this is the column 'days*2'). 
If your license is under SSA, which is already over, you also have to pay the time between the old SSA date and the current SSA end date twice.

Here is a short example, how the days are calculated:

Bind date: 24/06/2009 
Current date: 31/08/2009 
SSA end date: 12/12/2011 
 
You will have to pay from 24/06/2009 to 31/08/2009 twice for 68 days.
From 31/08/2009 to 12/12/2011 you will then have to pay the normal price for 833 days.

You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

You can preview the SSC calculation for another calculation date. Simply change the dropdown
selection to get the new SSC value.
Of course you can't confirm this calculation for another date, just for the current date!

After confirming your entered SSA end date, each license will have this date as SSA end date and can be downloaded in all versions of this SSA time.

You can now extend the projects SSA end date like as setting a new one.
The resulting summary is the same as above.

If your user account has the right to buy licenses on credit, just check the checkbox.
You may enter an order number, which you can use for your order, if you buy on credit.

If project SSA will expire, each company user will receive a reminder mail '''7''' weeks before and
then every week one mail.
You can disable these mails with the checkbox 'Send SSA expiry mails'.
Note that every user can configure, if he wants to receive mails or not in his account settings.

====Rights====
Add or delete company rights for this project. To add a company right, you have to enter the company id of this company.
Each user of a company with rights on this project can add devices, licenses, activation keys to this specific project, but is restricted in removing devices, editing the project and can't create activation keys with the projects balance.

The company id can be found under Licenses->company and the company tab.

[[Image:Project_rights.jpg|center|thumb|200px|Project rights]]

====Import====
To download old licenses created with an old license manager account and to use your old balance, you have to import your old account data.
You will have to enter your old account login from license.innovaphone.com. Afterwards you will get a list of your balance and of all your devices with their licenses.
The shown balance is the balance of all users, which belong to your old group (if you belonged to a group).
You can now select all devices which you want to import to the currently selected project.
There might be errors, if you try to add a device. They are explained [[Howto:My_Innovaphone#Image_explanation|here]].

By confirming this import, all users of your group will be locked in the old license manager.

You can import all not yet imported devices to another project, if you want.

Importing of your old balance and devices might take a while!

You can also import just one mac address, if you are the owner of the device, but haven't created any licenses in the old account. Your old account and its balance won't be affected then.

====Join====
Here you can join your currently selected project with another project, which you select from a dropdown box. 
If the other project has SSA, you'll see the current SSA end date, which you might change for the join process and you will get a list of all licenses, which might be updated to the ssa end date/changed date of the other project. The list equals the list shown under [[Reference:My_Innovaphone#SSA|SSA]].

The selected project will be automatically deleted after the join. You can't join a project,
if it grants external rights to another customer. Delete these rights before.

====Delete====
Delete the project. Only possible if it has no activation keys, project rights, devices or user rights.
 
You may [[Reference:My_Innovaphone#Join|join]] your project into another one, if you can't delete it.

====Project Freed_RMA_licenses====
If you see a project with this name in your project list, you had a RMA device with not yed moved licenses, which was shipped to innovaphone and reshipped to another customer. 
The licenses of such a device have been moved into the pool of free licenses of the project Freed_RMA_licenses, from where you can assign them to another device.

===Balance===
On the balance page you will see the balance of the currently selected project or the balance of all your projects together.
The balance is bound to your company and '''not''' to your user account. The balance is bound to a specific project, but can be shared for license creation or activation key creation if wished. 
Sharing the balance over several projects is not possible in external projects!

[[Image:Balancepage.jpg|center|thumb|200px|Balance page]]

====Free licenses====

Here you see a list of all your free licenses. If you return licenses from one of your devices, the returned licenses are stored in your free licenses pool. You can assign these licenses to another device (see [[#Add licenses from free licenses|'Add licenses from free licenses']]) or convert them to your balance.

[[Image:Balance_free_lics.jpg|center|thumb|200px|Free licenses list]]

The bind date, SSA end date and the external key (like DECT-Multi-Cell-Ari) are stored for each license.

If you want to convert these licenses to your balance, you will have to pay one year SSC for each unit and all external key bindings and the current SSA will be lost. 
If the license you convert is under SSA, you will be able to select the version to convert the license to.

===Activations===
To increase your projects balance, select one of your projects, follow the "Add" link and enter the activation key in the corresponding field. You can also enter an optional comment for this key. You will then get a listing of all contained licenses. After commiting this key, your project balance will have been increased by the keys values.

"Deselect the current project" to view all activation keys independent of the selected project.

[[Image:Activations.jpg|center|thumb|200px|Activation key page]]

====License certificate====
You can always download the innovaphone license certificate for activation keys in your projects. Simply press the download link in the list at the right side.

===Own Activations===
Here you'll see a list of all created activation keys in the selected project (or over all projects).

You can create activation keys on the project page for other users/companies or to simply transfer licenses from one project to another. 
You can enter a comment, an order number and an order reference. The '''order number''' is your own order number for the key and the '''order reference''' is the reference number of the customer, who receives the newly created key. 
The order reference and order number will be shown in the innovaphone license certificate.

[[Image:Created_activations.jpg|center|thumb|200px|Created activation keys]]

You have to select an activation key in the activation key list to update or delete it.

Updating and deleting a key is only possible, if this key is not assigned.

====Update====
Add more licenses to this key (removing licenses is not possible, delete the key instead) or change its comment, order number and order reference.

[[Image:Own activations update.jpg|center|thumb|200px|Update own activation keys]]

====Delete====
Delete this key. Its licenses will go back into the balance of the currently selected project.

===Devices===
To view your devices you first have to click on the "Show" button. You can leave the filter field empty if you want to view all your devices.

[[Image:Devices_page.jpg|center|thumb|200px|The Devices Page]]

Red marked device names are devices, which are currently in RMA.

MAC addresses of RMA devices do not longer start with 01-...

====List====
A List of your devices in the currently selected project. 
You can deselect the current project/device to list all your devices.

Select a certain device from the device list, to manage its properties, licenses etc.

Actions on multiple devices:
* Move: move several devices into another project at once (see [[Howto:My_Innovaphone#Move_device|Move Device]])
* Remove: remove several devices at once (see [[Howto:My_Innovaphone#Remove|Remove]])

=====Add=====
Follow the "Add new devices" link on the devices page.

There you have a few options:
* You can add a single new device
* You can add devices according to a mac address range (e.g. from 00-90-33-08-20-00 to 00-90-33-08-22-00), maximum 50 at once
* You can add devices by uploading a text file with mac addresses like this (maximum 50 at once, each line one mac):

00-90-33-08-20-20
00-90-33-08-20-21
00-90-33-08-20-22
00-90-33-24-20-20

* You can add devices according to your received order number. Just enter you order number and you will get a list of all devices bount to this number.

Note: MAC addresses can be always given like this:
* 00-90-33-xx-xx-xx
* 00:90:33:xx:xx:xx
* 009033xxxxxx
* xxxxxx (00-90-33- will then be added automatically)

There might be errors, if you try to add a device. They are explained [[Howto:My_Innovaphone#Image_explanation|here]].

As the device warranty will be handled by licenses now, you can also add telephone devices
to your projects.

=====Add warranty extensions=====

Here you can add warranty extension licenses for all devices in the currently selected project. 
You'll get a list of all devices with the corresponding license type(s) and you can specify the years for each device (or for all devices by entering the number in the list header). 
After confirming your selection, you'll get an overview of all needed licenses, which you have to confirm too.

=====Check licence, SSA and warranty status of a device=====
Here you can list licenses with ssa and the warranty end date of a device, which is not in one of your projects. 
This is just available with the needed right.

=====Download devices of an order as CSV=====
Enter an order number to retrieve all devices for this order in a CSV file.

====Properties====

Change the name and comment of a device.
You can only change the name, if it's no MAC or IPEI.
 
Here you have also the possibility, to directly request RMA for this device with prefilled values.

====Licenses====
Here you can add, download or move licenses.

=====Add licenses from balance=====
To create new licenses for a device, you have to add this device first on the devices page and then select a version of the license
and whether you want to summate the current licencing. If you select current licenses, then older licenses for example V6 or V7 licenses will also be counted as V8 licenses in the next overview. This is necessary if you want to license a V6 unit with V8 licenses, but still want to use it as V6.
After that click "Next".
On the next page you will see a list of all available license types, which depends on your current available license types, of the selected license version and the device type (IP6000, IP800 e.g.):
[[Image:licenses.jpg|center|thumb|200px|Licenses for an IP3000]]
 
If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses to this SSA end date or you can optionally change this date to another one for the new licenses.
 
You see the available project balance, the balance over all projects (excluding external projects), the currently installed licenses and the maximum amount for this device type. You can now enter the value of the new license.
Base/Upgrade licenses can be selected via dropdown box.
'''Voicemail and Standby lics must always have the same amount as the selected PBX-PBX... license!
The maximum amount of PBX-Registration licenses equals the amount of the selected PBX-PBX... license!'''

The whished overall amount of pbx version 8 and above licenses can be specified here and the concrete amount of license sub types will be requested on the next page.

[[Image:licenses2.jpg|center|thumb|200px|Licenses for an IP800 with V8, step two]]

The best (cheapest) combination of each v8 pbx license type is already filled in, but you might change the amount of sub types if your does not fit and you do not want to purchase new activation keys for the sub types.

The column SSC/Unit is just shown if your project is currently under SSA and you have entered a SSA end date.

The SSC multiplicator is the value, which you have to multiplicate with each license unit to get
the corresponding SSC amount.
E.g. if you have 20 units of PBX-Port8*20 licenses with a SSC value of 54 and a multiplicator of
1.0000 (which equals to 365 days) you have to pay 20*54*1.0000 ~ 1080 SSCs.

 If you create licenses for an older version than the current version, you have to pay SSCs from the [[Reference:My_Innovaphone#Release_dates|release date]] of the next version of the currently selected version twice. 
e.g.: you want to bind licenses for V6 with SSA, so you have to pay SSCs from the release date of V7
 You can also select for each license, if you want SSA for it or not. If not, no SSC is needed and no (new) SSA end date is set for this license. 

Now confirm your new selection. If you have not enough licenses in your current project, but there are still licenses in other projects, you will get a dropdown box with a list of all projects containing the needed licenses. You can now select all desired/needed projects and confirm your selection again.
The balance of all selected projects will then be decreased by the needed amount.
 
 
If your user account has the right to buy licenses on credit, just check the checkbox.
 
You may enter an order number, which you can use for your order, if you buy on credit.

=====Add licenses from free licenses=====

Here you can assign licenses, which you returned from other devices.
You will also have to select the desired version and will than get a list of fitting licenses according to the current device and selected version.

[[Image:licenses_free.jpg|center|thumb|200px|Free Licenses for an IP800 with V8]]

If a license is under SSA, the correct license type is shown in column 'License Type' besides the 'Original Type'.
On confirming the selection, a consistency check is done (e.g. only 4 Relay-PRI licenses on an IP6000).
Bind and SSA end date will be maintained for each license.

As external keys are also maintained, you can select e.g. an old Dect-Multicell-Ari license to have the same ARI on another IP1200.
 

If your project has a SSA end date, which is not yet over, you'll have the possibility to set SSA for the new licenses
to this SSA end date or you can optionally change this date to another one for the new licenses.
You will have to confirm this after your first license selection (this is the same calculation as [[Reference:My_Innovaphone#SSA|here]]).

=====Add V7 floating license (slave pbx)=====
Here you can add a V7 floating license for a slave pbx. A device with a floating license can't have V7 pbx licenses and a device with V7 pbx licenses can't have a floating license.

=====Delete V7 floating license=====
Here you can delete an already existing floating license, if you won't use it anymore.

=====Add warranty extension licenses=====
Extend your warranty by adding warranty extension licenses:

[[Image:add_warranty.jpg|center|thumb|200px|Warranty extension]]

If you add the warranty extension immediately after the receipt of your device,
you can add the cheaper warranty extension licenses, otherwise you'll have to add
the more expensive ones.

You can extend the warranty for a maximum of four years.

=====Download licenses=====

[[Image:Device_download.jpg|center|thumb|200px|Download Licenses]]

You will get a dropdown with all available versions. Versions are dependent of your device, your licenses and of the ssa of your licenses. 
You are able to download downgraded versions of your licenses. E.g. if you have only V8 licenses, you can download a V7 license file (same restrictions as below).

Downgrades or only possible down to version 6!

If you do not want to download licenses by version, you have to decide whether to download the licenses encrypted or not.
'''If you download the licenses unencrypted, you won't be able to return those licenses anymore.'''
So you won't be able to return licenses for devices with V5-V7 licenses, as licenses for this versions are not encrypted.
To return these licenses, you will have to upgrade to a new bootcode, which prevents firmware downgrades to versions below version 8. 
Encrypted licenses are stored in a xml file, which you can then upload on your V8 (or higher) device.

You can now also download licenses directly from by the web interface of a device.
You just have to enter your account data and start downloading the licenses from my.innovaphone.com
without having to download/upload a license file.

=====Download test licenses=====

[[Image:Device_download_test.jpg|center|thumb|200px|Download test licenses]]

You can also download test licenses if you want to run tests. You will be asked, which version you want to use, whether the device is used as slave and if not used as slave, how many pbx licenses you want to use.

=====Move licenses to another device=====
If you have the needed account rights or the device is already in RMA, you can move licenses to another device. After moving licenses, the former device will be marked as a RMA device.

You can just move licenses to devices without licenses!

====Move device====
Here you can move the current device or the selected devices to another project. 
If you select a SSA project, you can change the SSA end date for the move process. 

If the other project is under SSA, you will first see a SSC calculation, which you have to confirm,
as the SSA date for each SSA license will be extended until the given SSA end date
(this is the same calculation as adding SSA to an already existing project, see [[Reference:My_Innovaphone#SSA|here]]).

====Invalidation====
You can invalidate V8 (or higher) licenses by uploading the XML file, you got from your device or by returning your licenses over the web interface of your device ([[Reference8:Configuration/General/License]]), in order to return [[Reference8:Licenses#Gateway_Licenses|PBX licenses]] back to the balance.

V7 licenses can be just returned, if you agree, that you won't be able to downgrade below V8 anymore. You will need a new bootcode, to use this function. '''You need a V8 firmware or higher for invalidation.'''

If your device has access to my.innovaphone.com, you can also invalidate licenses directly
from the web interface of the device.

[[Reference8:Licenses#Gateway_Licenses|gateway licenses]] and warranty extensions won't be returned to the balance and remain to be assigned to the device!

You need a device certificate!

Steps to invalidate licenses, if your device has internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# enter your my.innovaphone account, the device must be in one of your projects
# click Invalidate
# click Transfer (this might fail, if NTP or DNS is not configured properly or device certificate is not installed)
# reset if asked for

Steps to invalidate licenses, if your device has no internet connectivity:
# on the web interface of the device go to General->License and follow the my.innovaphone link
# enter your my.innovaphone account, the device must be in one of your projects
# click Invalidate
# click Backup and upload this file on my.innovaphone [[Reference:My_Innovaphone#Upload_the_invalidation_document_to_return_licenses|here]]
# you'll get a confirmation file after uploading the saved file
# upload this on the device (under Step1)
# reset if asked for

=====Download confirmation file=====
If you created a new certificate or you invalidated your licenses, you can later download the confirmation file, which you have to upload on the box.

=====Request certificate=====
If you have the needed rights, you can request a new device certificate for your device.

=====Upload the invalidation document to return licenses=====
Upload the invalidation document, which you got from the website of the device to return the licenses of this device.

After uploading you'll get a confirmation file, which you have to upload on your device.

====Remove====
You can always remove devices from a project. If they have licenses, these won't be deleted, so you might add the device to another project again.

===History===
[[Image:history.jpg|center|thumb|200px|History page]]
You can view your history for several contexts:
* Company: history of all actions in your company
* User: history of all actions of the selected user
* Device: history of all actions for the selected device

Each context applies to the currently selected project.
If you deselect the current project, you will see the history over all projects.

You can select to view the history of the last day, week, month, year or from always. Collecting data might take a while...

===Company===
Manage users, import other companies or change your company data.
The first user of a company has automatically company admin rights and can grant this right to other company users after adding their accounts email address. 

====Users====

[[Image:company.jpg|center|thumb|200px|Company page]]
Here you can add other users to your company, optionally with company admin rights.
You can also lock a user account or grant company admin rights. 
Locked users can't loggin to my.innovaphone.com any more. 
Instead of locking a user you can also remove this user from your company. The user itself will still have his my.innovaphone account, but won't belong to your company any more. The history of this user is still available after having removed him.

Non company admin users just get a non editable list of the current company users.

A user can be member of several companies and the users rights, company admin and
locked status can be different for all companies, where this user is in.

====Join (admin only)====
As admin you can also join another company into your company by entering an admin account of this company. This might be usefull if one user of your company has accidentally created an own company. 
Everything like projects, users, devices, balance, activations etc. will be imported! 
You also have to enter the company id of the company, which is to be imported. You can find this company under Licenses->Company and the company tab.

This is not available for non company admin users.

The joined company will be deleted afterwards!

====Company====
If you do not belong to a my innovaphone company, you can create one here. You can optionally enter an innovaphone account ID with its zip code or you just enter your company data below.

[[Image:company_create.jpg|center|thumb|200px|Company create page]]

Otherwise you can change your company data, but only, if you didn't created your company with your innovaphone account id. In this case, company information is always retrieved from your innovaphone account.
Non company admin users can just view the current company data.

You also see your company id here, which is sometimes needed for adding external project rights or
to be imported by another company.

====New Company====
If you need several companies for some reasons, you can create another one here. 
You will be an admin user in this new company and you can directly select the newly created company at the top right corner.

==RMA==
Here you can see all your RMA devices, which arrived innovaphone already. The licenses of this macadresses are moveable.
[[Image:rma.jpg|center|thumb|200px|RMA page]]
 
If you want to request RMA for a certain device, go to the device properties and follow the "Request RMA" link.

==Mantis==
Here you'll get a list of all open support cases in our mantis system, which are assigned to email addresses of your my.innovaphone users in your company.

==Configurator==
Currently this is just a link to the [http://config.innovaphone.com innovaphone PBX Configurator]

==Account==
Here you can change your personal data, password etc. You always have to enter your current password to change your data.

If you change your email address, you'll have to activate your account again.

==Company selection==
If your user account belongs to several companies, you can switch between companies be using the dropdown box at the top right corner of the page. 
You'll get an error, if you try to switch to a company, where your account is locked. 

[[Image:company_selection.jpg|center|thumb|200px|Dropdown box for company selection]]

 
If you loggin, the first found company is selected for your user.

==Image explanation==

===Errors===

====Already In Company====
[[Image:Icon_in_company_inno_01.png]]
* This device already exists in your company and can't be added/imported.
If you want to import this device anyway, you first have to delete your current device from its project.

====Already Imported====
[[Image:Icon_imported_inno_01.png]]
* This device has been already imported.
You can't import it again.

====Not Found====
[[Image:Icon_not_found_inno_01.png]]
* This device was not found in the my innovaphone database.
This should never happen, but if, contact the administrator.

===Warnings===

====Several Companies====
[[Image:Icon_several_companies_inno_01.png]]
* This device is already in another company.
This means, that either you do not have the physical device or it once belonged another company.
You can still import/add this device and you will have access to all of its current licenses.

====Several Users====
[[Image:Icon several users inno 01.png]]
* This device has licenses from several users of the old license manager.
This means, that you are not neccessarily the user, who physically owns this device. If you do not own it, do not import it.

===Misc===
====No downgrade====
[[Image:no_downgrade.png]]
* Licenses, which have been downloaded for V5/V6/V7, were returned from this device, so no downgrade to these versions is allowed any more.



==Release dates==
V5: 01/01/2003 
V6: 02/11/2006 
V7: 14/11/2008 
V8: 07/12/2009 

==Known Issues==
* Devices where imported into a project with SSA. If this happened to you, please move the corresponding devices into a project '''without''' SSA and back into the project '''with''' SSA to extend/add SSA for the licenses until the SSA end date.
* IE7 moves a list under the menu, when a list becomes to wide

Howto:Multi-Party Conferencing with early IP6000

2010-07-12T13:30:17Z

Kti:

==Applies To==
This information applies to

* IP6000, Hardware builds less than 202



==More Information==
Various innovaphone hardware platforms, including the IP6000, do support [[Reference:Administration/Gateway/Interfaces#Conferencing_interface_.28CONF.29|multi-party conferencing]]. However, early hardware version of the IP6000 do not.

=== IP6000 versions that support multi-party conferencing ===
Hardware builds 202 and up do support it.

=== IP6000 versions that do not support multi-party conferencing ===
Hardware builds prior to 104 do not support it.

=== IP6000 versions that can be upgraded to support multi-party conferencing ===
Hardware builds 104 up to and not including 202, do not support it. However, they can be upgradet to support it.

If you are interested in having your device upgraded, then you need to order item no. 06-06000-001. The price is 290,- € plus shipping. Contact your innovaphone sales representative for details.

==== Procedure ====
To have a box upgraded, send an order for item 06-06000-001. Then submit an [http://rma.innovaphone.com RMA request] and refer to your order within the description field. Tick the "I want this device back" check-button.

== Related Articles ==
[[Reference:Administration/Gateway/Interfaces]]

[[Reference:Administration/PBX/Objects/Call Broadcast Conference]]



[[Category:Faq|{{PAGENAME}}]]

Reference:My Innovaphone

2010-02-02T12:03:48Z

Kti: /* RMA */

Reference:My Innovaphone

2009-12-15T09:34:06Z

Kti: /* Invalidation */

Reference7:Licenses

2009-07-09T12:50:20Z

Kti:

Howto:IP72 Battery, Charger Information and Headset Jack

2009-01-22T14:17:30Z

Kti: /* Chargers */

This article clarifies question about different types of available batteries and chargers for IP72 WiFi Phone.
==Applies To==
This information applies to

*IP72



==Batteries==
There two types of batteries availiable for IP72: standard and extended. For most purposes the standard battery is sufficient. Be awared that extra equipment is required to charge extended batteries (see [[Howto:IP72_Battery_and_Charger_Information#Chargers|Chargers]] for more information).

{| border=1
!width=60|
!width=20|Standard
!width=20|Extended
|----
|
|align="center"|[[Image:IP72_charging_howto_01.PNG]]
|align="center"|[[Image:IP72_charging_howto_02.PNG]]
|----
|'''Art-Number'''
|50-00999-031
|50-00999-030
|----
|'''Voltage'''
|3,7 V
|3,7 V
|----
|'''Capacity'''
|1000 mAh
|1800 mAh
|}

==Chargers==
Several solutions for charging IP72 are provided. See the table below to find appropriate solution for you.

There no single user desktop solution for extended batteries available. Standard battery fully suffices needs for this type of users.

{| border=1
!
!Desktop Charger
!USB Programmer
!IP72 Charging Rack
!Battery Pack Charging Rack
!Power Supply for Charging Racks
|----
|
|align="center"|[[Image:IP72_charging_howto_03.PNG]]
|align="center"|[[Image:IP72_charging_howto_03.PNG]]
|align="center"|[[Image:IP72_charging_howto_04.PNG]]
|align="center"|[[Image:IP72_charging_howto_05.PNG]]
|
|----
|'''Art-Number'''
|50-00999-026
|50-00999-027
|50-00999-038
|50-00999-033
|50-00999-034
|----
|'''Purpose'''
|Single user desktop charger for standard battery only
|Used to update firmware and configure IP72 via USB. Can NOT be used to charge the IP72, cause USB Port provides max. 500 mA, what is the half of a standard desktop chager.
|Solution for bigger pools of IP72 with standard battery.
|Solution for 24/7/365 usage of IP72 with standard or extended batteries.
|Provides electical power to max. 3 charging racks.
|----
|'''Capacity'''
|1 IP72 with standard battery
|1 IP72 with standard battery, NO CHARGING
|4 IP72 with standard battery
|8 standard or extended batteries
|3 Racks
|----
|'''Required Accesories'''
|nothing (power supply included)
|USB device driver
|Power Supply for Charging Racks required
|Power Supply for Charging Racks required
|Electrical worker(or two) for on wall mount required
|}





[[Category:Faq|{{PAGENAME}}]]

Howto:Upgrade DECT handset firmware

2008-10-28T15:06:23Z

Kti:

==Applies To==
This information applies to

* IP50
* IP52
* IP54
* IP55

==More Information==

===Problem Details===
For problems relating to upgrading firmware on DECT handsets, please contact the KIRK support team using the following email address: emeadksupport@polycom.com

To speed up the support process, you should send the current firmware version within your support request.

Please use the *99984* service code to determine the firmware number.

== Related Articles ==
[[Howto:Service_codes_for_the_innovaphone_IP_Dect_handsets]]

[[Category:Howto|{{PAGENAME}}]]

Howto:Where to find SNMP MIB for innovaphone gateways

2008-08-06T08:09:17Z

Kti:

The MIB is always part of the latest firmware pack ,in the folder tools.

Please go to the related articels below.

== Related Articles ==

[http://download.innovaphone.com/ice/6.00/ download site]



[[Category:Faq|{{PAGENAME}}]]

Reference:What are the Release Notes Documents?

2008-03-12T15:08:40Z

Kti:

innovaphone publishes the then-current [[Support:DVL-Roadmap|development roadmap]] on a daily basis in this wiki.

This document reflects the current status of development and planning. It thus may change without notice (except that any changes will be published in an update of this roadmap). All entries reflect current thinking. '''In no way are they intended as a commitment, neither with respect to planned functionality, nor to delivery dates'''.

Then again, the roadmap contains most valuable information to our partners. It shows what our current thinking is, which feature requests did make it into the roadmap and what priority is assigned to it. Also, it will indicate if or if not an item is being worked on, or has been completed even.

If you need to know what is going on with innovaphone's product development, this is the right source. If you need to give commitment to your customers, it is not.

== Format and Structure ==
The roadmap is structured in chapters, each describing a forthcoming major milestone. This is usually
* the hotfixes for the current (service) release (for a more complete definition of these terms, see the [[Howto:How the build number scheme works|description of the build numbering scheme]])
* the upcoming service release and releases
* planned hardware releases

For each item, there may be a deadline, indicated in the chapters headline (such as ''07/44'' (year/week) in [[Support:DVL-Roadmap#07/44_SR2:_Diagnostics|07/44 SR2: Diagnostics]]). This is our best estimate as of now, again it is not intended as a delivery date commitment.

Each chapter has a number of subchapters describing items that we think are of major interest to everyone. However, there will allways be a number of issues that are not of general interest, but may be nonetheless of utmost importance to some of our partners. Those items are summarized briefly under the [[Support:DVL-Roadmap#Other Items for 07/44 SR2: Diagnostics|Other Items for ''xxx'']] heading.

Each issue shows the following properties:

{|
| Assigned || user
|-
| Status || <nowiki>{ Assigned | Feedback | Resolved | Closed }</nowiki>
|-
| Priority || <nowiki> { low | </nowiki>''none'' <nowiki>| normal | high | urgent | immediate }</nowiki>
|-
| Id || ''number''
|-
| ''description''
|}

A ''Feedback'' status indicates some clarification that is still required. ''Resolved'' and ''Closed'' indicate that the issue has been completed.

An ''immediate'' priority indicates an item that is currently being worked on (unless it is ''Resolved'' or ''Closed'').

== Related Articles ==
[[Support:DVL-Roadmap]]

Reference:What are the Release Notes Documents?

2008-03-12T15:08:14Z

Kti:

innovaphone publishes the then-current [[Support:DVL-Roadmap|development roadmap]] on a daily basis in this wiki.

This document reflects the current status of development and planning. It thus may change without notice (except that any changes will be published in an update of this roadmap). All entries reflect current thinking. '''In no way are they intended as a commitment, neither with respect to planned functionality, nor to delivery dates'''.

Then again, the roadmap contains most valuable information to our partners. It shows what our current thinking is, which feature requests did make it into the roadmap and what priority is assigned to it. Also, it will indicate if or if not an item is being worked on, or has been completed even.

If you need to know what is going on with innovaphone's product development, this is the right source. If you need to give commitment to your customers, it is not.

== Format and Structure ==
The roadmap is structured in chapters, each describing a forthcoming major milestone. This is usually
* the hotfixes for the current (service) release (for a more complete definition of these terms, see the [[Howto:How the build number scheme works|description of the build numbering scheme]])
* the upcoming service release and releases
* planned hardware releases

For each item, there may be a deadline, indicated in the chapters headline (such as ''07/44'' (jear/week) in [[Support:DVL-Roadmap#07/44_SR2:_Diagnostics|07/44 SR2: Diagnostics]]). This is our best estimate as of now, again it is not intended as a delivery date commitment.

Each chapter has a number of subchapters describing items that we think are of major interest to everyone. However, there will allways be a number of issues that are not of general interest, but may be nonetheless of utmost importance to some of our partners. Those items are summarized briefly under the [[Support:DVL-Roadmap#Other Items for 07/44 SR2: Diagnostics|Other Items for ''xxx'']] heading.

Each issue shows the following properties:

{|
| Assigned || user
|-
| Status || <nowiki>{ Assigned | Feedback | Resolved | Closed }</nowiki>
|-
| Priority || <nowiki> { low | </nowiki>''none'' <nowiki>| normal | high | urgent | immediate }</nowiki>
|-
| Id || ''number''
|-
| ''description''
|}

A ''Feedback'' status indicates some clarification that is still required. ''Resolved'' and ''Closed'' indicate that the issue has been completed.

An ''immediate'' priority indicates an item that is currently being worked on (unless it is ''Resolved'' or ''Closed'').

== Related Articles ==
[[Support:DVL-Roadmap]]

Howto:V6 and V7 on IP21, IP200 (old), IP202 and IP400

2008-03-10T14:03:07Z

Kti:

Due to flash and dram memory limitations, full the V6 feature set is not available on some older innovaphone platforms. You should generally consider replacing IP400 by IP305, as well as IP202 by a combination of IP110/IP200 and IP302.

==Applies To==
This information applies to

* IP400
* IP21
* IP200 (the old one, not IP200A, see label on the back)
* IP202

==More Information==
=== Running V6 up to and including V6 SR1 ===
On all IP400, all IP21 and IP202 with 8 MB Ram and 2MB Flash (see the info screen for details on how much memory your IP202 features), the V6 PBX will not run. The IP400 and IP21 firmware thus does not include the PBX at all.
For the IP202, there are 2 downloads available, '''ip202.bin''' which includes the PBX and '''ip202phone.bin''' which does not. '''ip202.bin''' will not work on older IP202 platforms with only 2MB flash memory.

The V6 Gateway/Gatekeeper - aka “Relay” - will still work on IP400 and IP21, but not on the smaller IP202 (in fact, the '''ip202phone.bin''' is identical to the '''ip200.bin''').

You can check the size of flash/dram at the webinterface of your unit (General -> Info). A line like '''Version V5.01 sr1-hotfix IP202[05-5874], Bootcode[336], HW[224] ''4096''/''8192''''' indicates 4MB flash and 8MB dram.

<center>
{| border=1
|+V6 PBX compatibility for old devices
!width=160|
!width=150|V5 Gateway and PBX
!width=100|V6 Gateway
!width=100|V6 PBX
|----
|IP21
|Yes
|Yes
|No
|----
|IP400
|Yes
|Yes
|No
|----
|IP202 with 2MB Flash
|Yes
|Yes
|No
|----
|IP202 with 4MB Flash
|Yes
|Yes
|Yes
|}
</center>

=== Running V6 SR2 ===
From V6 SR2, there are addtional limitations.

The IP200 (not IP200A) and IP202 with 2 MB Flash will include neither PPP nor NAT (this means no PPTP and PPPoE either). The phone can thus not be used as a router anymore.

The IP400 does not include PPP (and thus no PPTP or PPPoE either), NAT, Telnet, Update, Aping, TCP-SIP und - as before - the PBX.

[[Category:Faq|{{PAGENAME}}]]

Reference:Feature Codes

2007-12-06T10:00:10Z

Kti: /* Group Join */

On anlog lines and on DECT handsets multiple features can be invoked by dialing feature codes.
In general this has to be enabled by configuration so that it can be used. For all features a default for the invocation code
is defined, but this default can be changed on a per system basis. The following features are available:

== CFU activate/deactivate ==

These codes allows to activate and deactivate unconditional call forward for a given endpoint. For H.323 this call forwarding is set
in the PBX using H.450 operations. For SIP the call forwarding is set locally.

The default codes are *21*$# to activate and #21# to deactivate. $ stands for the number to which calls are forwarded.

== CFB activate/deactivate ==

These codes allows to activate and deactivate call forward on busy for a given endpoint. For H.323 this call forwarding is set
in the PBX using H.450 operations. For SIP the call forwarding is set locally.

The default codes are *67*$# to activate and #67# to deactivate. $ stands for the number to which calls are forwarded.

== CFNR activate/deactivate ==

These codes allows to activate and deactivate call forward on no response for a given endpoint. For H.323 this call forwarding is set
in the PBX using H.450 operations. For SIP the call forwarding is set locally.

The default codes are *61*$# to activate and #61# to deactivate. $ stands for the number to which calls are forwarded.

== Set Pin ==

This code allows to set a pin which can be used to lock/unlock the endpoint.

The default code for this is *99*$*$*$#. The $ stand for the three argument this feature code requires: The old pin and two times the new pin.
The default for the pin is '0000'.

== Lock/Unlock ==

These codes allow to Lock and Unlock the phone. If the phone is locked no calls can be made.

The default codes are *33*$# to lock and #33*$# to unlock. $ stands for the PIN.

== Do not Disturb ==

These codes allow to turn on and off "Do not Disturb" for all calls. If "Do not Disturb" is on, all incoming calls are rejected with Cause "User Busy".

The default codes are *42# to turn on and #42# to turn off "Do not Disturb".

== Do not Disturb internal calls ==

These codes allow to turn on and off "Do not Disturb" for internal calls. If "Do not Disturb" is on, all internal incoming calls are rejected with Cause "User Busy".

The default codes are *421# to turn on and #421# to turn off "Do not Disturb".

== Do not Disturb external calls ==

These codes allow to turn on and off "Do not Disturb" for external calls. If "Do not Disturb" is on, all external incoming calls are rejected with Cause "User Busy".

The default codes are *422# to turn on and #422# to turn off "Do not Disturb".

== Call Waiting ==

These codes allow to turn on and off "Call Waiting". If "Call Waiting" is on, an additional call is alerting to the calling user and is indicated inband
with a call waiting tone. The waiting call can be accepted using R-2 or rejected using R-1. By default call waiting is off.

The default codes are *43# to turn on and #43# to turn off "Call Waiting".

== Clear Local Settings ==

This code clears all locally stored settings. These are
*Do not Disturb (internal/external)
*CFU,CFB,CFNR if stored locally (SIP)
*Call Waiting

The default code is *00#

== Pickup Group ==

With this feature code any call which is ringing within the configured groups can be picked.

The default code is *0#

== Pickup Directed ==

With this feature code a call which is ringing at a indicated extension number can be picked.

The default code is *0*$#. $ stands for the extension number from which the call shall be picked.

== Park ==

These codes allow to park and uppark a call at the own extension number to a specified parking position.

The default code is *16$(1) to park and #16$(1) to unpark. $(1) stands for the single digit park position.

To dial the code for the park a consultation call has to be initiated with R (Flash).

== Park To ==

These codes allow to park and unpark a call to a specified park position at an specified extension number.

The default code is *17$(1)$# to park and #17$(1)$# to unpark. $(1) stands for the one digit park position and $ for the extension number.

To dial the code for the park a consultation call has to be initiated with R (Flash).

== Call Completion ==

This code has to be dialed to initiate call completion either in ringback state (CCNR, call completion no response) or when receiving a busy tone (CCB, call completion busy) preceeded by R.

The default code for call completion is 5.

== Group Join ==

These codes allow to join and leave a preconfigured group.

The default code is *31# to join and #31# to leave the group.

(Not availible on IP1200 at the moment)

== Local Clear of MWI ==

For interoperability with message centers which indicate activation of message waiting indication but no deactivation a number can be configured which when dialed locally clears the message waiting indication. Typically the number of the message center (e.g. voicemail system) is configured. This way when calling the message center (e.g. voicemail) to listen to the new messages the message waiting indication is cleared.

[[Category:Concept|{{PAGENAME}}]]

Howto:How to use the R-key handling on the IP1200 DECT system

2007-09-04T15:16:54Z

Kti: /* Usage */

The IP1200 could enable or disable the R-Key handling which is necessary for transferring calls.

===Applies To===
This information applies to

* IP 1200

Build V6 and later

==More Information==
===Problem Details===
Unknown flash codes for transferring, holding or changing between calls.

===Configuration===
Enable the “local R-key handling” at the IP1200.

===Usage===
To use the R-key functions press the R-key during a call followed by the appropriate number.

A single R-key press sets the first call on hold.

Use the following codes:

* 1 – disconnect held call

* 2 – change between call 1 and call 2

* 4 – transfer call 1 to call 2

e.g. incoming call, transferred to another extension.

* accept incoming call

* press R once

* dial the second extension

* press R2 to change between call 1 and call 2

* press R4 to transfer both calls

To get back to the base call after pressing R-Key use:

R+1 - return back to base call after pressing the R-Key

To get back to the base call after forwarding the base call to another extension also use R+1.

R+1 - disconnects current call and return back to base call

To switch between two established call connections use:

R+2 – change between call 1 and call 2

To transfer the base call to another call extension use:

R+4 – transfers call 1 to call 2

==Known Problems==
[[Category:Howto|{{PAGENAME}}]]

Howto:How to use the R-key handling on the IP1200 DECT system

2007-09-04T15:16:37Z

Kti: /* Known Problems */

Howto:V6 and V7 on IP21, IP200 (old), IP202 and IP400

2007-07-20T07:12:26Z

Kti: /* More Information */

==Summary==
Running V6 PBX on IP202 ,IP400 and IP21

==Applies To==
This information applies to

* IP400

* IP21

* IP202

==More Information==
Due to memory reasons it is not possible to run V6 PBX on IP400, IP21 and IP202 with 8 MB Ram and 2MB Flash.

Normal V6 Gateway/Gatekeeper (Protocols H.323/SIP) – aka “Relay” will still work on IP400 and IP21.

It is not possible to run V6 Pbx on IP202 with 8MB Ram and 2 MB Flash.

With V6 you can run the IP202 with 8 MB Ram and 2 MB Flash only as Phone.

If you have an IP202 with 8MB Ram and 4 MB Flash (newer generation) you can run it with V6 as Phone,

Gateway/Gatekeeper and V6 Pbx (as it was in V5).

V6 Pbx needs minimum 4 MB Flash because of Firmware image, Vars and directory.

Minimum of 8Mb Ram because the V6 Pbx Code needs for itself minimum of 4 MB Ram

You can check the size of Flash/Ram at the Webinterface of your unit (General -> Info).
There you'll see a line like this "Version V5.01 sr1-hotfix IP202[05-5874], Bootcode[336], HW[224] 4096/8192".
The two numbers after HW[224] describe the size of the Flash/Ram. In this example the unit got a 4 MB Flash and a 8 MB Ram.

[[Category:Faq|{{PAGENAME}}]]

Howto:V6 and V7 on IP21, IP200 (old), IP202 and IP400

2007-07-20T07:11:21Z

Kti: /* More Information */

==Summary==
Running V6 PBX on IP202 ,IP400 and IP21

==Applies To==
This information applies to

* IP400

* IP21

* IP202

==More Information==
Due to memory reasons it is not possible to run V6 PBX on IP400, IP21 and IP202 with 8 MB Ram and 2MB Flash.

Normal V6 Gateway/Gatekeeper (Protocols H.323/SIP) – aka “Relay” will still work on IP400 and IP21.

It is not possible to run V6 Pbx on IP202 with 8MB Ram and 2 MB Flash.

With V6 you can run the IP202 with 8 MB Ram and 2 MB Flash only as Phone.

If you have an IP202 with 8MB Ram and 4 MB Flash (newer generation) you can run it with V6 as Phone,

Gateway/Gatekeeper and V6 Pbx (as it was in V5).

V6 Pbx needs minimum 4 MB Flash because of Firmware image, Vars and directory.

Minimum of 8Mb Ram because the V6 Pbx Code needs for itself minimum of 4 MB Ram

You can check the size of Flash/Ram at the Webinterface of your unit (General -> Info).
There you'll see a line like this "Version V5.01 sr1-hotfix IP202[05-5874], Bootcode[336], HW[224] 4096/8192"
The two numbers after HW[224] describe the size of the Flash/Ram. In this example the unit got a 4 MB Flash and a 8 MB Ram.

[[Category:Faq|{{PAGENAME}}]]