Nortel Page 1 of 13
Date: 2 May 2012
Release for 2050 IP Softphone
i2050ConfigurationTool.exe
R
EVISION HISTORY
Date Revision # Summary of Changes
1-May-06 Original This is the original publication
18-Jan-08 Revision #1 2050Settings.ini file has been changed
New section [HardwareID] is added.
Values of section [Skin] are changed
22-Jan-08 Revision #2 2050Settings.ini file has been changed.
New section [LicenseServer] is added.
22-Jan-08 Revision #3 Updated to fix errors in Examples.
2-May-2012 Revision #4
Document is updated in accordance to i2050
Rls 4.3
Introduction
The i2050ConfigurationTool.exe is a utility which can be run to configure a IP Softphone
2050.
To use this utility:
1. Install the IP Softphone 2050 on the user’s computer
2. Edit the 2050Settings.ini file to define the configuration required for the end user
3. Download the i2050ConfigurationTool.exe and the 2050Settings.ini file to the user’s
computer
4. In the user’s runtime context, open a command prompt, change current directory to
the folder with the tool and run the i2050ConfigurationTool.exe specifying the
2050Settings.ini file as the parameter.
For example:
Nortel Page 2 of 13
i2050ConfigurationTool.exe 2050Settings.ini
i2050ConfigurationTool writes the settings defined in the input file to the registry where the
IP Softphone 2050 will subsequently read them.
Each 2050Settings.ini file contains settings for one profile for an IP Softphone 2050 user. If
the registry settings in the .ini file have not been previously assigned, the utility will create
them. If the registry settings in the .ini file have been previously assigned, the utility will
overwrite them with the new values. If an administrator wishes to create more than one
profile for a user, then additional .ini files must be created and the
i2050ConfigurationTool.exe must be launched multiple times, one for each profile. The last
.ini file used with a setting “Default=1” defines the profile which will be the default profile for
the user.
The settings in the 2050Settings.ini file are assumed to be correct. Since this is an
administration utility little error checking is performed.
The .ini file is divided into sections for collections of various attributes. These sections, in
general, correspond to the various settings pages in IP Softphone 2050 Settings (Start >
Programs > Avaya > 2050 IP Softphone > 2050 IP Softphone Settings). An example
2050settings.ini file is provided and is included below. The file format is subsequently
described in detail below.
==== START OF 2050Settings.ini file example ====
[Profile]
Name=Lab M1
Default=1
ShowProfilesOnStartup=1
RunInBackgroundOnStartup=0
[UserPIN]
Node=4001
TN=63-5
[Server1]
; set address=0 to use DHCP
address=47.9.11.70
symposium=0
name=
port=4100
retries=10
DTLS=0
; Meridian 1, BCM, CS 1000, CS 1000M, CS2000/CS2100
type=CS 1000
[Server2]
address=47.9.11.71
symposium=0
name=
port=7000
retries=11
; Meridian 1, BCM, CS 1000, CS 1000M, CS2000/CS2100
type=BCM
Nortel Page 3 of 13
[LicenseServer]
; Count is the total count of the specified license servers
Count=2
Server0=47.9.11.72
Server1=47.9.11.73
[ListenerIP]
IP=
Port=5000
[HardwareID]
HWID=00-50-04-0f-85-94
[Skin]
; 1100, 1100L, 1100XL, i2050_Silver, i2050_Black
Name=1100
Accessibility=0
[Language]
; Arabic Chineses Chineset Czech Danish Dutch English Finnish French
; German Greek Hebrew Hungarian Italian Japanese Korean Latvian Norwegian
; Polish Portuguese Russian Spanish Swedish Turkish
Name=English
[KeyType]
Line1=1
Line2=0
Line3=0
Line4=0
Line5=0
Line6=0
[USBHeadset]
; GN Netcom DuraPlus Binaural Headset
; GN Netcom DuraPlus Monaural Headset
; GN Netcom GN2100 Monaural Headset
; GN Netcom GN2115 ST Binaural Headset
; GN Netcom GN2117 ST Monaural Headset
; GN Netcom GN2125 NC Binaural Headset
; GN Netcom GN2220 NC Monaural Headset
; GN Netcom GN2225 NC Binaural Headset
; Nortel Networks Handset
; Nortel Networks Mobility Kit
HeadsetType=DuraPlus Monaural Headset
; None = 0, On = 1, Flash = 2, Flicker = 3, Blink = 4
AlertConditionIndication=
; None = 0, On = 1, Flash = 2, Flicker = 3, Blink = 4
ActiveCallIndication=
; None = 0, On = 1, Flash = 2, Flicker = 3, Blink = 4
MessageWaitingIndication=
; None = 0, On = 1, Flash = 2, Flicker = 3, Blink = 4
HeadsetDisconnectedIndication=
UseBacklight=0
[SecureCallRecording]
; mscr: mirror mode configuration
; same as primary stream - y
; not to be encrypted - n
mscr=y
; crtype: Call recorder vendor type
; c ; Cyber tech call recorder
; I ; Nice call recorder
; n ; Avaya call recorder
Nortel Page 4 of 13
; o ; Other call recorder
crtype=i
[Provisioning]
;Example:
;URL=tftp://user:[email protected]:1234/filestorage
URL=
[SoundDevices]
; Sound input sampling rate, kHz. Possible values: 48, 32, 8.
InputRate=48
==== END OF 2050Settings.ini file example ====
Section: [Profile]
Settings Attribute Name: Name
Settings Tab: Profile
Description: The name of the profile. All other attributes in the file will
be applied for this profile.
Format/Values: String
Example: Name=Lab M1
Notes: Default value is My Server
Settings Attribute Name: Default
Settings Tab: Profile
Description: Is this profile to be used as the default profile?
Format/Values: 1 - for True
0 - for False
Example: Default=1
Settings Attribute Name: ShowProfilesOnStartup
Settings Tab: Profile
Description: Allow the user to select a profile at startup
Format/Values: 1 - for True
0 - for False
Example: ShowProfilesOnStartup=0
Settings Attribute Name: RunInBackgroundOnStartup
Settings Tab: Profile
Description: Starts i2050 minimized in tray
Format/Values: 1 - for True
0 - for False
Example: RunInBackgroundOnStartup =0
Sub-Section: [UserPIN]
Settings Attribute Name: Node
Settings Tab: None
Description: CS1000 Node id
Format/Values: Numeric
Example: Node=4001
Nortel Page 5 of 13
Settings Attribute Name: TN
Settings Tab: None
Description: CS1000 TN value
Format/Values: Numeric - use the same format in which CS1000
displays/requests the TN
Example: TN=63-5
TN=096-00-01-05
Section: [Server1]
Settings Attribute Name: address
Settings Tab: Server: Primary
Description: IP Address
Format/Values: IP Address format
Example: address=47.9.11.70
Notes: To use DHCP to provide an address, use address=0
Settings Attribute Name: symposium
Settings Tab: Server: Primary
Description: Is this client is connecting to a CS1000 server and is being
used as a symposium client? Ie: should the client report
the handset as being off-hook.
Format/Values: 1 - for True
0 - for False
Example: symposium=0
Settings Attribute Name: name
Settings Tab: Server: Primary
Description: DNS Name. This can be used instead of the IP Address
Format/Values: DNS name string
Example: name=cs1000.us.nortel.com
Settings Attribute Name: port
Settings Tab: Server: Primary
Description: The TPS connection port.
Format/Values: Numeric
Example: port=4100
Settings Attribute Name: retries
Settings Tab: Server: Primary
Description: If a connection with a TPS fails, the client will retry this
number of times before attempting to connect to [Server2]
Format/Values: Numeric
Example: retries=10
Settings Attribute Name: type
Settings Tab: Server: Primary
Nortel Page 6 of 13
Description: TPS server type
Values: Meridian 1, BCM, CS 1000, CS 1000M
Example: type=CS 1000
Settings Attribute Name: action
Settings Tab: Server: Primary
Description: TPS connection action byte
Format/Values: Numeric
Example: action=1
Settings Attribute Name: DTLS
Settings Tab: Server: Primary
Description: Must be enabled for secure connection to the server over
DTLS
Format/Values: 1 - for True
0 - for False
Example: DTLS=1
Section: [Server2]
Server 2 is the alternate server. This is called S2 for the 1004/2004. If connection to Server1
(S1) fails, the client will attempt to connect to this server.
Settings Attribute Name: address
Settings Tab: Server: Secondary
Description: See [Server1] address
Settings Attribute Name: symposium
Settings Tab: Server: Secondary
Description: See [Server1] symposium
Settings Attribute Name: name
Settings Tab: Server: Secondary
Description: See [Server1] name
Settings Attribute Name: port
Settings Tab: Server: Secondary
Description: See [Server1] port
Settings Attribute Name: retries
Settings Tab: Server: Secondary
Description: See [Server1] retries
Settings Attribute Name: type
Settings Tab: Server: Secondary
Description: See [Server1] type
Settings Attribute Name: action
Nortel Page 7 of 13
Settings Tab: Server: Secondary
Description: See [Server1] type
Settings Attribute Name: DTLS
Settings Tab: Server: Secondary
Description: See [Server1] type
Section: [ServerApp]
XAS/GXAS server configuration.
Settings Attribute Name: address
Settings Tab: Server: Application
Description: See [Server1] address
Settings Attribute Name: name
Settings Tab: Server: Application
Description: See [Server1] name
Settings Attribute Name: port
Settings Tab: Server: Application
Description: See [Server1] port
Section: [LicenseServer]
Settings Attribute Name: Count
Settings Tab: None
Description: Number of configured license servers
Format/Values: Numeric
Example: Count=2
Settings Attribute Name: Server<number>
Settings Tab: License Servers
Description: The IP address of License Server.
Format/Values: IP address format
Example: Server0=47.25.89.123
Note: <number> should be substituted with specific number.
Numbers should start counting from 0.
Section: [ListenerIP]
Listener IP can be used to override port assignments when the IP Softphone 2050
application conflicts with another application on your computer.
Under normal operation, the IP Softphone 2050 listens for UNIStim traffic on all IP
addresses and IP ports. You can set the IP Softphone 2050 to listen to only one specific IP
address and/or port.
Settings Attribute Name: IP
Settings Tab: ListenerIP
Nortel Page 8 of 13
Description: The IP address where the IP Softphone 2050 will listen for
UNIstim (signaling) traffic. This must be an IP address on
the client’s computer.
Format/Values: IP address format
Example: IP=47.25.89.123
Settings Attribute Name: port
Settings Tab: ListenerIP
Description: The port where the IP Softphone 2050 will listen for
UNIstim (signaling) traffic.
Format/Values: Numeric
Example: port=5000
Section: [Skin]
Settings Attribute Name: Name
Settings Tab: Skin
Description: The user interface selection
Format/Values: 1100, 1100L, 1100XL, Silver, Black
Example: Name=1100
Settings Attribute Name: Accessibility
Settings Tab: Skin
Description: Should the accessibility interface be used? Setting this
value to True will ignore the Skin Name above.
Format/Values: 1 - for True
0 - for False
Example: Accessibility=0
Section: [Language]
Settings Attribute Name: Name
Settings Tab: Language
Description: Select the interface language. Note: this does not affect
the language used in the server display area.
Format/Values: Arabic, Chineses, Chineset, Czech, Danish, Dutch, English
Finnish, French, German, Greek, Hebrew, Hungarian,
Italian, Japanese, Korean, Latvian, Norwegian, Polish,
Portuguese, Russian, Spanish, Swedish, Turkish
Example: Name=English
Note: Chineses – Simplified Chinese, Chineset – Triditional
Chinese
Section: [KeyType]
These are the line keys which are used for calls (ie: not keys which are configured as
feature keys).
Settings Attribute Name: Line1
Settings Tab: KeyType
Nortel Page 9 of 13
Description: Is this line used for calls?
Format/Values: 1 - for True
0 - for False
Example: Line1=1
Settings Attribute Name: Line2
Settings Tab: KeyType
Description: Is this line used for calls?
Format/Values: 1 - for True
0 - for False
Example: Line2=0
Settings Attribute Name: Line3
Settings Tab: KeyType
Description: Is this line used for calls?
Format/Values: 1 - for True
0 - for False
Example: Line3=0
Settings Attribute Name: Line4
Settings Tab: KeyType
Description: Is this line used for calls?
Format/Values: 1 - for True
0 - for False
Example: Line4=0
Settings Attribute Name: Line5
Settings Tab: KeyType
Description: Is this line used for calls?
Format/Values: 1 - for True
0 - for False
Example: Line5=0
Settings Attribute Name: Line6
Settings Tab: KeyType
Description: Is this line used for calls?
Format/Values: 1 - for True
0 - for False
Example: Line6=0
Section: [USBHeadset]
Settings Attribute Name: HeadsetType
Settings Tab: USBHeadset
Description: Which headset is being used?
Format/Values: GN Netcom DuraPlus Binaural Headset
GN Netcom DuraPlus Monaural Headset
GN Netcom GN2020 NC Monaural Headset
Nortel Page 10 of 13
GN Netcom GN2100 Monaural Headset
GN Netcom GN2115 ST Binaural Headset
GN Netcom GN2117 ST Monaural Headset
GN Netcom GN2125 NC Binaural Headset
GN Netcom GN2220 NC Monaural Headset
GN Netcom GN2225 NC Binaural Headset
Avaya Handset
Avaya Mobility Kit
Example: HeadsetType=GN Netcom DuraPlus Binaural Headset
Settings Attribute Name: AlertConditionIndication
Settings Tab: USBHeadset
Description: When an external lamp is in use, this value defines the
flash frequency of that lamp - when a call is alerting. Note
that this functionality requires an optional Nortel certified
third party lamp module.
Format/Values: 0 – None
1 – On
2 – Flash
3 – Flicker
4 – Blink
Example: AlertConditionIndication=2
Settings Attribute Name: ActiveCallIndication
Settings Tab: USBHeadset
Description: When an external lamp is in use, this value defines the
flash frequency of that lamp - when a call (speech path) is
active. Note that this functionality requires an optional
Nortel certified third party lamp module.
Format/Values: None, On, Flash, Flicker, Blink
Example: ActiveCallIndication=On
Settings Attribute Name: MessageWaitingIndication
Settings Tab: USBHeadset
Description: When an external lamp is in use, this value defines the
flash frequency of that lamp - when the message waiting
lamp is on. Note that this functionality requires an optional
Nortel certified third party lamp module.
Format/Values: 0 – None
1 – On
2 – Flash
3 – Flicker
4 – Blink
Example: MessageWaitingIndication=2
Settings Attribute Name: HeadsetDisconnectedIndication
Settings Tab: USBHeadset
Nortel Page 11 of 13
Description: When an external lamp is in use, this value defines the
flash frequency of that lamp - when the headset is
disconnected from the USB adapter. Note that this
functionality requires an optional Nortel certified third party
lamp module.
Format/Values: 0 – None
1 – On
2 – Flash
3 – Flicker
4 – Blink
Example: HeadsetDisconnectedIndication=4
Settings Attribute Name: UseBacklight=0
Settings Tab: USBHeadset
Description: Turn the USB adapter’s lamp on when the IP Softphone
2050 is connected to a server.
Format/Values: 1 - for True
0 - for False
Example: UseBacklight=0
Section: [HardwareID]
Settings Attribute Name: HWID
Settings Tab: Hardware ID
Description: The hardware ID of the set which is used during set
registration on server.
Format/Values: xx-xx-xx-xx-xx-xx
Example: HWID=00-50-04-0f-85-94
Section: [SecureCallRecording]
Secure call recording configuration.
Settings Attribute Name: mscr
Settings Tab: Audio
Description: Enable secure call recording in “mirror” mode.
Format/Values: y – The same as primary stream
n – Never encrypted
Example: mscr=y
Settings Attribute Name: crtype
Settings Tab: Audio
Description: Call recorder vendor type.
Format/Values: c or C – Cybertech call recorder
i or I – Nice call recorder
n or N – Avaya call recorder
o or O – Other call recorder
Example: crtype =I
Nortel Page 12 of 13
Section: [Provisioning]
Address of the FTP/TFTP/HTTP server to download Node Locked license file.
Settings Attribute Name: URL
Settings Tab: Server
Description: Address of the server to download Node Locked license
file.
Format/Values: String
Example: URL=tftp://user:[email protected]:123/files
Section: [SoundDevices]
Settings Attribute Name: InputRate
Settings Tab: Sound devices
Description: Sampling rate for audio streams. Correctly chosen
sampling rate may improve audio quality.
Format/Values: 8 – for use 8 kHz
32 – for use 32 kHz
48 – for use 48 kHz
Example: InputRate=48
IP Phone Compatibility
This utility (i2050ConfigurationTool.exe) is applicable to 2050 IP Softphone Rls 2.x (also
known as IP Softphone 2050 Version 2), Rls 3.x and Rls 4.x.
However some sections are applicable only to Release 3.x and newer or even 4.x.
Call Server Compatibility and Requirements
The Node and TN attributes are applicable only to CS1000, CS1000M and Meridian 1
servers.
All other attributes are applicable to all server types and versions which support 2050 IP
Softphone.
Nortel Page 13 of 13
Avaya is a recognized leader in delivering communications capabilities that enhance the
human experience, ignite and power global commerce, and secure and protect the world’s
most critical information. Serving both service provider and enterprise customers, Avaya
delivers innovative technology solutions encompassing end-to-end broadband, Voice over
IP, multimedia services and applications, and wireless broadband designed to help people
solve the world’s greatest challenges. Avaya does business in more than 150 countries. For
more information, visit Avaya on the Web at www.avaya.com
.
/
