innovaphone wiki - User contributions [en]

Howto talk:Pin-code for trunk access

2010-10-06T14:39:55Z

Taxfree: New page: You can also configure the trunk to have the number 01234 (or any other) instead of just 0.

You can also configure the trunk to have the number 01234 (or any other) instead of just 0.

Howto:A Simple Recording Solution On-Top of The innovaphone Voicemail

2010-09-13T08:59:46Z

Taxfree: changed some Denglisch to English

==Applies To==
This information applies to

* innovaphone PBX, V6,V7
* innovaphone Voicemail 07-60044 and later
* all innovaphone Phones V6 and V7
* innovaphone BRIA softphone

==More Information==
This article explains how a simple recording solution could be set up on-top of an innovaphone Voicemail (VM).
In the second part you will find an enhanced version with clearer file names.

Please note, that this recording solution is exemplary and free. It can be adapted in such, that it doesn't require the VM. It(record.xml) does not require VM-licensing, at all.

The recording works on-demand an stores G.711a files into the "stored messages"-area of a user's voicebox. Recorded messages can be listened to by calling a user's voicebox and by proceeding into the main menu option ''2'' for stored messages.

Please be informed, that recording usually requires the agreement of the calling peer and as such must be indicated to the peer.
===Configuration===
The outline for the following configuration scenario shall be as follows:
* The VM is pre-installed on a CompactFlash card and is available at the number ''66''.
* The confgured URL for the VM is ''http://127.0.0.1/drive/CF0/vm/vm.xml''.
* An IP phone ''49:Klaus'' may exist.
* Klaus has a voicebox configured which is available at ''http://127.0.0.1/drive/CF0/vm/Klaus/''
* The recording solution requires an additional voicemail object, which shall be available as 67:vm-record.

Open up a new file within a text editor.
* Paste the following content into it:
<code xml>
<?xml version="1.0" encoding="utf-8" ?>
<voicemail xmlns="http://www.innovaphone.com/xsd/voicemail6.xsd">
<function define="Main">
<pbx-getcallinfo out-cgpn="$cgpn" out-leg2="$leg2"/>
<pbx-finduser-e164 e164="$cgpn" out-cn="$cn" />
<if cond="$cn">
<if cond="$leg2">

<lib-strcat string="$cn" string2="/store" out-string="$sub" />
<store-getnew root="$sub" out-url="$ctrl"/>
<lib-strcat string="$ctrl" string2="-" out-string="$ctrl" />
<lib-strcat string="$ctrl" string2="$leg2" out-string="$ctrl" />
<lib-strcat string="$ctrl" string2=".g711a" out-string="$ctrl" />
</if>
<else>

<lib-strcat string="$cn" string2="/store" out-string="$sub" />
<store-getnew root="$sub" ext=".g711a" out-url="$ctrl"/>
</else>
<pbx-record url="$ctrl" barge-in="false"/>
</if>
<pbx-disc/>
</function>
</voicemail>

</code>
* Save the file as record.xml into the VM directory, such that record.xml resides in the same directory of the VM's vm.xml and becomes HTTP-available as http://127.0.0.1/drive/CF0/vm/record.xml.

Create a new Voicemail Object at ''Administration/PBX/Objects/New''
* Enter ''vm-record'' as ''Long Name'' and ''Name''.
* Enter ''67'' as ''Number''
* Enter ''http://127.0.0.1/drive/CF0/vm/record.xml'' as ''URL''.

Browse to the phone's Web UI: ''Configuration/RegistrationX/Recording''
* As ''Mode'' enter ''manual''.
* As ''Number'' enter ''67''.

===Testing===
Klaus is engaged in call.
* During the call press the redial-button. The phone's display should now indicate something like "Recording".

After the call has been finished Klaus calls his voicebox 6649. He enters main menu option ''2''. The recorded message should now be among the stored messages.

== Enhanced version ==
You will find the enhanced version in the [[Howto:A_Simple_Recording_Solution_On-Top_of_The_innovaphone_Voicemail#Download|download section]].

Please note that this version requires at least innovaphone PBX V7. Of course you have to modify the filename or the url.

Using this version the name of the voice files have the following format:

<Username>/<Record>+<cdpn>+<cgpn>+<date>+<time>+<NumberInMinute>+.g711a

Where
<Username> = separate directory for each user
<Record> = fix text field
<cdpn> = extension which did the recording
<cgpn> = the remote party
<date> = system (PBX) date
<time> = system (PBX) time
<NumberInMinute> = Record in this minute
.g711a = coding

Example:
Record_37-24-01.08.2009-09.03_1.g711a

Extension 37 did voice recording, the far partner was extension 24, date 01.08.2009 at 09:03, the first record in this minute.

Please note that the date and time format always has the format DD.MM.JJJJ and hh:mm.
The file name of course must be unique. In the rare occasion that a user would start a second recording with the same remote party in the same minute (for example if he is toggling with the recording key), an incremental number is added.

Example:

Record_37-24-31.07.2009-13.58_1.g711a
Record_37-24-31.07.2009-13.58_2.g711a
Record_37-24-31.07.2009-13.58_3.g711a

Normally all recordings will end with “_1”.

Please feel free to modify the xml, for example using other separators.

== Known Problems ==
none

== Download ==
*[http://download.innovaphone.com/ice/wiki-src#simplerec http://download.innovaphone.com/ice/wiki-src/] - download the complete file package of scripts and files described in this article.

== Related Articles ==
[[Howto:How_to_Configure_the_innovaphone_Voicemail|How to Configure the innovaphone Voicemail]]

[[Howto:Voice recording solution with e-mail on-top of the innovaphone voicemail object]]

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

Howto:How to program repeaters for DECT systems

2009-10-07T10:12:00Z

Taxfree: /* Method A – Service Tool */

Repeaters could be programmed in two ways. Choose the appropriate one below

==Applies To==
This information applies to

* IP 600, V5

* IP 1200, V6

* IP 1500, V5

==More Information==
===Problem Details===
Programming of the repeater.

===System Requirements===
Depending on the method used:

A. Kirk Service Tool

1) Repeater incl. PSU

2) Repeater Programming Kit (cable & splitter)

3) PC with serial port

4) Kirk Service Tool

B. without PC and Tools

1) Repeater incl. PSU

2) handset

==Configuration==
===Method A – Service Tool===

Download the Kirk Service Tool from http://downloads.polycom.com/voice/KIRK/Repeater/ServiceTool_4_19_6_35.zip and install the application.

Start the Service Tool and klick “help” in the menu bar.

Read the documentation carefully to avoid wrong setups and follow the instructions.

For repeaters used in multi cell systems, like IP1500 and IP1200 (multi cell) take a closer look at this point:

Repeater programming - system 1500 / 1.8GHz

You will need the following data for the setup:

1. System ARI

a. could be found on the info screen

2. ID of the base station/repeater to synchronize on

a. on the IP1500 the base station id belongs to the connected cable, check your wiring or use the handset deployment mode to gather this information

b. on the IP1200 check Configuration->DECT->Radio->Radio-ID

3. ID for the repeater itself

a. choose an id between 1 and 255, add a gap of 64 between sync id and repeater id to get faster handovers

The programming of repeaters used in single cell systems, like IP600 and IP1200 (single cell) take a closer look at this point:

Repeater programming - system 500 & KCS system

You will need the following data for the setup:

1. System ARI

a. could be found on the info screen

2. ID of the base station/repeater to synchronize on

a. on the IP600 the base station id is always 1

b. on the IP1200 check Configuration->DECT->Radio->Radio-ID

3. ID for the repeater itself

a. choose an id between 2 and 7

===Method B – without PC===

You can use these instructions for alternatively configuration method (if you do not have access to the tool and a PC)

1) Turn on the base station and a subscribed handset.

2) Turn on the Repeater (WRFP) for more than 1 second and less than 5 seconds (note 1). Turn off the WRFP and turn it on again. The WRFP is now in subscription mode.
This is indicated by a flashing LED immediately after power is switched on. In this mode the WRFP is searching for a Fixed Part in subscription mode.
This mode is active for maximum 5 minutes. If the subscription procedure is not completed within this time, the WRFP restarts in normal mode with previous subscription data.

3) (if the base station is an innovaphone IP1200: skip 3) and go to 4)) Start subscription mode in the base station. The usual procedure is pressing the button on the base station for some seconds. This is the mode normally used when subscribing a handset to the base station (note 2).

4) The WRFP is synchronised with a base station in subscription mode. This is indicated by a fast flashing LED.

5) Verify that the WRFP is synchronised with the requested base station. This is done by pressing the Hook-key or INT-key on the handset.
The LED on the WRFP (visible at the front center of the WRFP) should light up steadily. If the LED does not light up after pressing the Hook-key or INT-key a few times, the WRFP is probably synchronised with another base station. If this is the case the subscription procedure has to be repeated from step 2.

6) Select Radio Part Number (RPN). Hook off and press a number on the handset in the range 000-250 (note 3). When the number is accepted by the WRFP this is acknowledged by the LED flashing the number of times corresponding to the digit. Digits may be entered several times. Only the last accepted digit is recorded.

If you are using more WRFPs on the same base station they must have different RPNs.

7) Accept subscription identities by hook off and pressing the *-key.When the key is accepted by the WRFP the LED indicates that the key is turned off for 2 seconds.
Alternatively the subscription can be accepted by pressing the #-key (note 4).

8) The WRFP now restarts with the new subscription identities in normal mode. The LED is turned on steady for 5 seconds and the WRFP is then ready to use.

Note 1: In normal operation mode the LED will light up steadily for the first 5 seconds after powering up.

Afterwards the LED is flashing when the WRFP is un-synchronised and the LED becomes steady when synchronised to a base station.

Whenever a connection is established via the WRFP a short flash appears on the LED.

Note 2: Subscription mode is indicated by broadcasting wireless FP-Capabilities (bit a44=1)

Note 3: When the Base Station is a residential single Base Station the valid RPN is in the range 2 - 7. When the WRFP is used on the PBX or public system the RPN may be in the range 0 - 255. In this case the WRFP accepts up to 3 digits to be entered. The last 3 valid digits are recorded only.
So: Single Cell installation: RPN: 2 - 7 (1 is the Base station); Multi-Cell Installation: RPN: 000 - 250.

Note 4: If the #-key is used to accept the subscription identities an inspection tone is enabled. The WRFP will then, when relaying connections, insert a short tone every 2 seconds in the audio path to Handsets. This feature can be used for inspection and verification of the WRFP placement. When the operation has been verified the inspection tone should be disabled. Performing step 2 only of the subscription procedure will disable the inspection tone. When the LED has started flashing in subscription mode, just turn off the WRFP and then on again. The WRFP is then back in normal mode without affecting the subscription identities and the inspection tone has been disabled.

==Related Articles==

[[media:Howto-How_to_program_repeaters_for_DECT_systems_KIRK_Repeater_Deployment.pdf|repeater deployment]]

[[media:Howto-How_to_program_repeaters_for_DECT_systems_KIRK_Repeater.pdf|Repeater intstalling instructions]]

[[Howto:Rules for successful IP1200 deployment]]

[[Howto:How to configure IP1200]]

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

Howto:Configure the innovaphone Voicemail

2007-07-25T10:22:15Z

Taxfree:

The innovaphone voicemail (VM) is implemented as a PBX object.
An answering machine can be assigned to each PBX user.
The VM is script-driven and controlled by means of DTMF touchtones.
It features a built-in WebDAV client, enabling the VM to communicate to an external WebDAV server, which serves as the mass-storage for audio files, script files and user-directories.
The VM script and pre-recorded audio files are subject to be provided by innovaphone.
Message Waiting Indication (MWI) is supported.

==Applies To==
This information applies to

* innovaphone PBX, V6
==More Information==

===System Requirements===
A Voicemail License

WebDAV server, e.g.: Apache 2.x, IIS W2K, IIS W3K, or with V6 sr1 the compat flash drive (no external WebDAV server needed)

Innovaphone will provide you with an XML script, that represents the actual voicemail.

In addition you will get a set of files with *.g711a and *.g729 extensions.

These files contain the audio snippets and the menu prompts, that the voicemail requires.

==Installation, WebDAV==
A few preconditions are assumed as basis for the following few installation and configuration steps:

* The number of the VM object is 66.

* The number of a sample user test is 49.

* The IP address of the WebDAV server is 192.168.0.5.

* The root directory, that contains the VM script and the pre-recorded audio files is c:\Inetpub\webdav\vm\en which corresponds to the URL http://192.168.0.5/webdav/vm/.

* The file name of the voicemail XML script is vm.xml.

===Creating the Voicemail Object===
Proceed to Administration/PBX/Objects.

Select Voicemail from the drop-down list and click on new.

Enter Long Name, Name.

Enter 66 as Number.

Enter the Script URL as http://192.168.0.5/webdav/vm/vm.xml.

===Distributing the Voicemail Script and Pre-Recorded Audio Files===
Download the installation program for the ''innovaphone voicemail'' from the [http://download.innovaphone.com innovaphone download area].

Start the installer program (innovaphone-voicemail-install.exe).

The installer will be asking for a target directory. Enter ''c:\Inetpub\webdav\vm\''.
Now, the installer will copy all of the localized voicemail files into language specific sub-directories. The english files will remain under the absolute path ''c:\Inetpub\webdav\vm\en\''.

===Configuration===
Please note, that a user's VM number is the number of the VM object, that you

assigned here, plus the user's number.

Example: If a user has the number 49 and the number of the VM object is 66, then the user's corresponding VM number will be 6649.

===IP Phone Configuration===
A user may wish to manually activate or deactivate a CFU diversion to his VM.

Browse to the IP phone of the user 49:test:

Proceed to Configuration/RegistrationX/Function Keys.

Select a free function key, choose Call Forwarding and click on new.

A new window will open.

Enter AM-on under Idle State/Text.

Enter AM-off under Active State [1]/Text.

Enter 6649 into Active State [1]/Text/Always/Number.

Click on OK.

An additional function key is required to present the MWI and to quick-dial the VM:

Proceed to Configuration/RegistrationX/Function Keys.

Select a free function key, choose Message Waiting and click on new.

A new window will open.

Enter AM under Idle State/Text.

Select the letter icon under Active State/Icon.

If you desire, then choose LED/blink.

Enter 6649 into Message Center Account/Number.

Click on OK.

===Webserver Aspects===
WebDAV in Common: As stated above, WebDAV is required for the VM to work.

What is WebDAV?

In its long form it reads "Web-based Distributed Authoring And Versioning" and is specified in RFC2518.
Technically is WebDAV a set of protocol extensions to the HTTP protocol.
These extensions allow for some file i/o operations,that aren't covered by HTTP:

Properties: That is, information retrieval about a certain file. E.g. the file creation time.

Renaming, moving, copying a file file.

===Apache Webserver 2.x===
The Apache supports WebDAV from on version 2.0 natively.

However, WebDAV must be enabled to be run.

Please find the respective documentation page at apache.org

under

http://httpd.apache.org/docs/2.0/mod/mod_dav.html .

Test Environment: Our test environment was a RedHat Linux 8.x.

The configuration file for httpd resides under /etc/httpd/conf/httpd.conf .

The voicemail is located underneath /var/www/webdav/vm/.

Open httpd.conf with a text editor.

Ensure the modules required for WebDAV are being loaded

LoadModule dav_module modules/mod_dav.so
LoadModule dav_fs_module modules/mod_dav_fs.so

Ensure, that WebDAV is enabled and that an alias is being created for webdav

Dav On
Alias /webdav "/var/www/webdav"

In our test environment we didn't restrict access to the webdav directory

Options Indexes MultiViews
Allow from all

An important aspect is the fact, that we had to apply chmod -R 766 to the /var/www/webdav directory. chmod -R 666 didn't suffice.

Without doing so, i.e. granting the read-/write-/execute-access, we received Forbidden responses when e.g.
trying to read the filenames within a directory.

A potential delay source can be reverse DNS lookups.

A webserver is trying to retrieve a DNS name for every source address it receives requests from.

The drawback is, that every HTTP request is being delayed by the amount of time it takes
to complete the reverse DNS lookup.

Within httpd.conf we therefore wrote HostNameLookups Off, in order to avoid DNS requests for logging purposes.

Please note further that access restrictions with DNS names, instead of IP addresses, will
bypass this setting, i.e. will make the "HostNameLookups Off" -setting ineffective.

===Microsoft Internet Information Server (IIS), W2K===

As a testbed an IIS 5.0 was utilized on a Windows 2000 server.

By default WebDAV is already enabled within IIS 5.0.

However, no data is published.

To publish data simply.

Create a new virtual directory webdav within the default website by means of the IIS Admin.

Allow read, write and browse operations being executed on that directory and underneath.

Use the Windows Explorer to modify the security settings of the directory (and underneath) and set it to full access for everyone (It is left up to the Windows experts how to restrict this further).

===Microsoft Internet Information Server (IIS6), W2003 ===

In contrast to Windows 2000 Server, Windows Server 2003 does not come with WebDAV being already enabled.

In addition File extensions with *.g711a and *.g729 must be configured as a new Mime-Type.

You must enable WebDAV from within the IIS Admin first.

Files with the extension *.g711a and *.g729 will not be returned.

You must add *.g711a *.g729 as a Mime-Type, otherwise the audio files won't be accessible.

Pls. see:

MS KB article Q326965 http://support.microsoft.com/kb/326965/en-us,respectively

http://support.microsoft.com/kb/326965/de-de for how to do this.

Browse to http://192.168.0.5/webdav/vm/ and try to download a g711a-file and a g729-file from within your browser.

This step will ensure, that the Mime-Types were successfully added.

Note: After the new Mime-Types were added an IIS6 restart seemed to be a MUST.

===innovaphone own WebDav Server (Compact flash card slot)===

please see the related articels below

compact flash slot is supported from release V6 service release 1

===Testing WebDAV Access===

From within the Windows Explorer go to Tools/Map Network Drive.

Select Web folder or FTP site.

Enter the URL

http://192.168.0.5/webdav/ and proceed.

No authentication dialog shall be prompted.

Now you may test whether you can read files, write files, delete files, create directories.

===User-Related Files And Directories===

Our sample user has the number 49 and the name test. When this user calls his box

6649 for the first time, the VM will create a directory for him and underneath a pair of

additional directories. The new directories for the user test are:

…/webdav/vm/test/. New voicemails will be copied here.

…/webdav/vm/test/personal. The personal greeting message resides here.

…/webdav/vm/test/store. When a message is stored, it is copied into this location.

If the directory creation fails, the call to the VM will be forcedly disconnected.

===PIN Administration===
Initially, there is a default PIN active. When being asked for a PIN,

enter 8765. The PIN can be changed by means of menu option 4.

===URL Query String Variables===

URL Query String Variables are generally passed on to a script.

The following variables control the script's behaviour and may be applied within the configured script-URL alike: http://192.168.0.5/webdav/vm/vm.xml?$_nopin=true.

Multiple variables can be combined by an ampersand (&) alike: http://192.168.0.5/webdav/vm/vm.xml?$_nopin=true&$_pbxcoder=g711a.

* $_nopin. Controls, whether a PIN must be entered.
**true: Voicemail owner doesn't need to enter a PIN when calling from his extension.
**false (default): A PIN must be entered

* $_pbxcoder. Allows to restrain the offered coder list, when executing <pbx-prompt> for files with "*.$coder" extensions.
** The internal default is: $_pbxcoder=g729,g711a,g711u,g723

* $_pbxfwd
** true: diversions will be executed on <pbx-fwd>
** false (default): diversions won't be executed on <pbx-fwd>

* $_pbxmwidir. Allows to configure a parent directory for all user sub-directories and for all MWI operations. As default there is no such directory active.

* $_pbxremhold
** true (default): Rules whether caller will be sent a REMOTE-HOLD while executing <pbx-fwd>.
** false: No REMOTE-HOLD is sent

* $_trace, decimal number: Controls verbosity of tracing outputs. The following values can be added.
** 1: errors, 2: interpreter, 4: parsing, 8: code, 16: store operations, 32: http operations (during <exec>)

==Installation, CompactFlash Card==
Instead of using a WebDAV server you may want to use the local CompactFlash card as mass storage device. This section outlines how this can be accomplished.
=== Installing the Voicemail on a CompactFlash Card ===
Please see the article [[Howto:Installing the voicemail/music on hold on a compact flash card|Howto:Installing the voicemail on a compact flash card]].

The aforementioned configuration scenario, within the above chapter: [[#Installation, WebDAV|Installation, WebDav]], does also apply for an installation on a CompactFlash card. Please, refer to that chapter if you look for informations on how to generally configure a basic voicemail scenario, including the affected ip phone configuration.

==Advanced Configuration==

===Sending of additional MWIs===
* [[Howto:How To Send Additional MWIs within a PBX|How To Send Additional MWIs within a PBX]]
The article deals with the question how a single voicemail box can be shared among a few users.

==Known Problems==
The VM makes use of V6’s media negotiation capabilities.
This is why V5 endpoints are not supported.

SIP endpoints are basically supported, however not in all aspects.

== Related Articles ==
[[Howto:How To Send Additional MWIs within a PBX|How To Send Additional MWIs within a PBX]]

[http://wiki.innovaphone.com/index.php?title=Howto:General_information_for_compact_flash_cards general information compact flash]

[http://wiki.innovaphone.com/index.php?title=Howto:Installing_the_voicemail/music_on_hold_on_a_compact_flash_card installing voice mail on compact flash]

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