STARFACE PBX system User manual

PDF

Documento

Anúncio

Manual - for STARFACE Version 2.0
Congratulations, and thank you for choosing STARFACE PBX!
STARFACE PBX is an innovative, software-based Voice over IP (VoIP) solution that is designed to handle
all of your company’s voice communications needs, both now and in the future.
But STARFACE PBX offers you more by also supporting all other conventional voice transmission
methods—ISDN, analog, and even GSM (cellular)—allowing you to decide which technologies (even several
in parallel) you will use to connect to the public telephone network.
STARFACE PBX is characterized by operating convenience, user-friendly maintenance and administration,
as well as a broad functionality that is based on practicality. Easily customized and offering numerous
interfaces for integration into your existing IT landscape, STARFACE PBX will quickly become a central
component within your IT and telecommunications infrastructure.
We have found that most people do not need any special technical knowledge or training to customize and
use their system. Installation and administration of the STARFACE PBX server are also intuitively designed
and normally pose no problem for experienced computer users.
However, if questions do arise STARFACE PBX offers context-sensitive online help that opens directly from
the user interface for the specific function or element where help is needed.
This manual provides users and administrators with a comprehensive introduction to the system. It includes
step-by-step installation and configuration instructions for the STARFACE PBX server, as well as detailed
technical explanations and parameter settings. This document also explains all operating elements and
functions, as well as their attributes.
If you have additional questions or require more information, especially regarding customization or
expansion of your STARFACE PBX system, please contact one of our certified STARFACE partners.
Please note that STARFACE PBX is a software product that is being continually developed and improved.
Therefore, you might find that the version of this manual supplied with your product does not precisely match
the product software version. The installation of updates or patches can also affect the scope of functions or
the appearance of certain operating elements. We therefore recommend that when in doubt, you use the
online help provided by the STARFACE PBX system. We reserve the right to make changes and
enhancements to our product without prior notification. Your feedback is very important to us. Therefore,
please do not hesitate and contact us, whether regarding errors you might have found or other comments
you might wish to communicate.
We are happy to welcome you as the newest member of our growing STARFACE community, and wish you
much fun and success in your daily work with your STARFACE PBX.
vertico software GmbH
1
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
CONTENTS
1
STARFACE Basics .......................................................................................................................5
1.1
1.2
2
FUNCTIONS...........................................................................................................................................5
THE MOST IMPORTANT OPERATING ELEMENTS AND SYMBOLS ................................................................7
Installation .....................................................................................................................................8
2.1
MINIMUM HARDWARE REQUIREMENTS ...................................................................................................8
2.1.1
Installation Prerequisites ............................................................................................................8
2.1.2
Install the Software on the Computer .........................................................................................9
2.1.2.1
2.1.2.2
2.1.2.3
2.1.2.4
2.1.2.5
2.1.2.6
2.1.2.7
2.1.2.8
2.1.2.9
Starting the Installation Process............................................................................................................9
Selecting the Language ......................................................................................................................10
Selecting the Keyboard Layout ...........................................................................................................10
Partitioning the Hard Drive ..................................................................................................................11
Configuring Network Settings..............................................................................................................14
Selecting the Time Zone .....................................................................................................................15
Entering the root Password.................................................................................................................15
Completing the Installation..................................................................................................................16
Using the Adminshell ..........................................................................................................................17
2.2
INITIAL CONFIGURATION OF THE STARFACE SERVER .........................................................................19
2.2.1
Step 1: Detect and Set Up Telephones....................................................................................19
2.2.1.1
2.2.1.2
2.2.1.3
2.2.2
2.2.2.1
2.2.2.2
2.2.3
2.2.3.1
2.2.3.2
2.2.4
3
Automatic Telephone Detection and Configuration.............................................................................20
Manual Telephone Configuration ........................................................................................................22
List of Defined Telephones .................................................................................................................25
Step 2: Configure Lines ............................................................................................................27
General Configuration .........................................................................................................................27
Lines ...................................................................................................................................................28
Step 3: Configure the STARFACE Users.................................................................................33
The STARFACE User Concept...........................................................................................................33
Create Users.......................................................................................................................................34
Complete the Initial Configuration ............................................................................................34
System Configuration..................................................................................................................35
3.1
CONFIGURATION MENU .......................................................................................................................35
3.2
ADD / EDIT USERS ..............................................................................................................................36
3.2.1
Selecting from User List / Adding Users...................................................................................36
3.2.2
Defining Redirecting Rules .......................................................................................................36
3.2.3
Assigning Telephones ..............................................................................................................37
3.2.4
Assigning DNs ..........................................................................................................................38
3.2.5
Assigning Groups .....................................................................................................................40
3.2.6
Assigning Access Rights ..........................................................................................................40
3.3
CREATE AND EDIT GROUPS .................................................................................................................40
3.3.1
Editing Group Settings..............................................................................................................41
3.4
SET UP TELEPHONES ..........................................................................................................................42
3.5
BASIC SETTINGS FOR VIRTUAL CONFERENCE ROOMS...........................................................................43
3.6
CONFIGURE THE ADDRESS BOOK ........................................................................................................44
3.6.1
LDAP Server and Folder Configuration....................................................................................44
3.6.2
Layout .......................................................................................................................................44
3.6.2.1
3.6.2.2
Order of LDAP Fields ..........................................................................................................................44
Definition of LDAP Fields ....................................................................................................................44
3.7
CREATE VOICEMAIL BOX .....................................................................................................................45
3.7.1
Creating and Editing Voicemail Boxes .....................................................................................45
3.7.1.1
3.7.1.2
3.8
Recording Announcements.................................................................................................................46
Listening to Announcements...............................................................................................................47
DEFINE ROUTING RULES .....................................................................................................................47
2
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
3.9
CONFIGURE LINES ..............................................................................................................................49
3.10 CONFIGURE THE SERVER ....................................................................................................................49
3.10.1
Software Updates .....................................................................................................................49
3.10.2
NTP and the Time.....................................................................................................................51
3.10.3
Network.....................................................................................................................................51
3.10.3.1
3.10.3.2
3.10.3.3
3.10.4
3.10.5
3.10.5.1
3.10.5.2
3.10.6
3.10.6.1
3.10.6.2
SIP Settings....................................................................................................................................52
Network Settings ............................................................................................................................53
Network Adapter.............................................................................................................................53
Setting Up the Mail Server........................................................................................................54
Configuring the Web Server .....................................................................................................54
Creating a Server Certificate ..........................................................................................................54
Loading Certificates ........................................................................................................................55
Backup and Restore .................................................................................................................55
Creating the Backup .......................................................................................................................55
Restoring a Backup ........................................................................................................................58
3.10.7
Viewing Log Files......................................................................................................................59
3.11 STATISTICAL ANALYSIS........................................................................................................................59
3.11.1
Exporting Lists ..........................................................................................................................59
3.11.2
Statistics ...................................................................................................................................60
3.12 ADVANCED SETTINGS..........................................................................................................................61
4
The User Interface ......................................................................................................................63
4.1
INTRODUCTION ...................................................................................................................................63
4.2
SYSTEM LOGIN ...................................................................................................................................63
4.2.1
Accessing the System ..............................................................................................................63
4.3
MENU BAR IN THE MAIN WINDOW ........................................................................................................64
5
Function Windows.......................................................................................................................65
5.1
CALL MANAGER ..................................................................................................................................65
5.1.1
Placing Calls .............................................................................................................................65
5.1.2
Handling Incoming Calls...........................................................................................................68
5.1.3
Handling Consultation Calls from the Call Manager.................................................................70
5.1.4
Starting an Ad-Hoc Conference................................................................................................72
5.2
REDIRECT CALLS ................................................................................................................................74
5.3
CALL LISTS .........................................................................................................................................75
5.4
ADDRESS BOOK ..................................................................................................................................75
5.4.1
LDAP View................................................................................................................................77
5.5
VOICEMAIL ..........................................................................................................................................78
5.6
FUNCTION KEYS .................................................................................................................................79
5.6.1
Key Assignment........................................................................................................................79
5.6.2
Dialing with Function Keys .......................................................................................................81
5.6.3
Answering Calls ........................................................................................................................81
5.6.4
Call Pick-Up ..............................................................................................................................81
5.7
PHONE CONFERENCES........................................................................................................................82
5.7.1
Scheduling ................................................................................................................................82
5.7.2
Managing Conferences ............................................................................................................83
5.8
USER SETTINGS..................................................................................................................................84
5.8.1
Groups ......................................................................................................................................84
5.8.2
Telephones ...............................................................................................................................85
5.8.3
Voicemail ..................................................................................................................................86
5.8.4
Redirect Calls ...........................................................................................................................87
5.8.5
Plugin-Phone ............................................................................................................................87
5.8.6
Add-Ons....................................................................................................................................88
5.8.6.1
5.8.6.2
5.8.6.3
STARFACE Dialer for Mozilla Firefox .................................................................................................88
STARFACE WinClient / TAPI Driver ...................................................................................................89
Address Book Plug-In for Mac ............................................................................................................91
3
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
6
Instant Messaging with the Jabber Server ..................................................................................91
7
Troubleshooting ..........................................................................................................................93
7.1
7.2
8
I RECEIVED A HARDWARE ERROR MESSAGE AT THE START OF THE INSTALLATION. ...................................93
MY ISDN CARD WAS NOT RECOGNIZED. ...............................................................................................93
Appendix .....................................................................................................................................94
4
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
1
1.1
STARFACE Basics
Functions
Call Manager
•
Use the integrated Plugin-Phone / place calls without external hardware or additional software
•
View incoming calls on the display, with caller name and number
•
Answer calls, forward calls (to voicemail box or another phone), or reject calls
•
Dial calls manually or from a redial list of most recently called numbers
•
Switch between multiple active calls
Call Lists
•
Use name lookup
•
View the log of all calls, with display of call status: incoming, outgoing, missed, answered
•
See who called with display of calling party name and number, date/time/duration of call, and whether a
message was left
•
Sort the call list by name, number, date, time, or duration of call
•
Interactively return a call by clicking an entry
•
Listen to voicemails by clicking an entry
•
Delete unneeded entries
•
Optional: Individually connect to CRM system
Function Keys
•
Individually define with a user’s name and number
•
Place calls by clicking a key
•
Pick up calls to other users
•
Optionally transfer key assignments to ‘snom’ telephones
Voicemail
•
Define unlimited voicemail boxes
•
Configure multiple folders and greetings
•
Forward messages via email, or retrieve messages in web browser
5
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Address Book
•
Administer and view all contacts with name, number, and speed dial number
•
Define multiple address books (public/private)
•
Link to and manage LDAP address books
Virtual Conference Rooms
•
View scheduled and completed conferences
•
Set up new telephone conference: one-time, weekly, monthly
•
Schedule conference date and time
•
Invite internal and external participants via email
•
Invite using standard text or personalized notifications
•
Modify conferences with automatic notification of participants via e-mail
•
Start conferences via telephone or software
•
Moderate conferences with mute/unmute controls
•
Limit access with PIN codes
•
Allow conference visualization via web front-end
•
See all participants and their conference status
•
Allow external participants to call in
Administration
•
Configure and administer entirely via web interface
•
Automatically detect and configure telephones
•
Configure lines for ISDN cards and VoIP providers
•
Manage services (NTP, web, mail, network)
•
Assign numbers for CallThrough, CallBack, and CallBack Internal
•
Define individualized routing for outgoing calls
•
Use the integrated mail system to send system messages and voicemails
•
Define groups and hunt groups
•
Back up and restore data automatically or manually
•
Update your software
•
Analyze and export telephone statistics
6
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
•
Import and manage LDAP directories
•
View log files from the application and telephony servers
•
Define dial plan extensions using the special editor
•
Manage user rights
•
Use the integrated Jabber server for Instant Messaging
•
Optional TAPI integration
1.2
The Most Important Operating Elements and Symbols
•
Open help topics
•
Call from a list
•
Listen to voicemails
•
Browse forward and backward in a list
•
Sort list
•
Edit
•
Delete entries
•
Listen to greetings
•
Open advanced functions
•
Open/close submenus
•
Function/attribute activated
•
Function/attribute not completely activated
•
Select address book entries
•
Select user entries
•
Close window
7
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
2
Installation
Minimum Hardware Requirements
2.1
To ensure trouble-free operation, even under high loads, the computer hardware should meet the following
minimum requirements:
•
Intel-compatible processor with minimum 1 GHz clock frequency
•
512 MByte RAM
•
20 GByte hard drive (recommended: RAID-1 System)
•
Bootable CD-ROM drive
•
Network card
If you have special needs, or to find out if your existing equipment is sized appropriately for STARFACE,
please contact your STARFACE dealer.
The following sections describe the process to install STARFACE PBX using the supplied CD-ROM. If
you are using STARFACE APPLIANCE or STARFACE HOSTED PBX, you can skip this step and go
directly to 2.2 Initial Configuration of the STARFACE Server.
2.1.1
Installation Prerequisites
The software must generally be loaded onto a “bare” system, i.e., all partitions must have been deleted.
Otherwise, they are automatically and completely deleted during the installation process. Therefore, any data
present on the computer before installation should be backed up, as they will be lost during the installation
process. It is not possible to install in parallel to existing partitions or data. The computer on which the
software will be installed must be connected via its network card to the local network within the firewall
during the initial installation.
After the hardware and installation requirements are met, the actual installation takes place in two steps:
•
Load the software onto the computer
•
Use the web browser to configure the STARFACE system
8
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
2.1.2
Install the Software on the Computer
The server must be connected via a network connector to the company-internal LAN. In addition, if ISDN will
be used to connect to the fixed network, the server must also be connected to the ISDN terminal via an ISDN
adapter and an ISDN cable. Finally, the server must be capable of either obtaining an IP address
automatically via a DHCP server or be manually assigned an available IP address during installation.
Ensure that the hard drive does not have any operating system installed on it and that the CD-ROM drive is
entered into the BIOS as the first boot medium (or the second boot medium after the first hard drive on the
first controller). Please note that you can change this setting so that the server boots from the hard drive only
after STARFACE is installed successfully. Access to the BIOS should be secured with a password.
2.1.2.1 Starting the Installation Process
Place the CD containing the STARFACE software into the CD drive and boot the server.
At this time, a customized version of the Fedora-Linux operating system is installed based on an automatic
hardware recognition process. Typically, all commercially available components are recognized by this
process.
The installation start screen is displayed.
Press Return or Enter to start the installation process. The installer will detect the graphical input/output
components of your system before launching the graphical installation wizard.
If installation is not being carried out on a STARFACE APPLIANCE:
When installing from CD-ROM, an error can occur with the boot loader at this point, and the boot process will
be terminated. Refer to 7 Troubleshooting.
Figure: Detecting Graphic Card, Monitor, and Mouse
After the hardware is detected, the graphical installation wizard launches.
9
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
2.1.2.2 Selecting the Language
Choose the language setting of the operating system. This language will guide you during the installation
and will be used in system messages and the console of the server. The language used in STARFACE will
be determined later and is not affected by this setting.
2.1.2.3 Selecting the Keyboard Layout
This selection is particularly important when setting the root password because the English keyboard layout
switches some keys (in particular ‘y’ and ‘z’) compared to the German keyboard.
The default selection “Deutsch (latin1 ohne ‘tote’ Taste/Akzente)” [=German (Latin1 without ‘dead’
keys/accents)] is the most common setting for the German language area.
10
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
2.1.2.4 Partitioning the Hard Drive
The hard drive can now be partitioned. You can partition the hard drive either manually or automatically.
Settings for Automatic Partitioning:
You can choose one of three partitioning settings:
•
Retain the existing partition.
•
Remove all partitions from the system.
•
Retain partitions and use free disk space.
In this screen, you also choose the hard drive to be partitioned.
11
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Figure: Selections for Automatic Partitioning
Caution!
During partitioning, all data present in the partition is lost and cannot be restored. If you are
partitioning a hard drive that already contains data, you should first back up the data to another
medium. There is no warranty for loss of data during partitioning.
The option “Review the partitions created” is already selected. It serves to open an overview of the partitions
during the next step. At that time, you can make any necessary changes to the partitioning. Clear this option
to skip the partitioning check and continue with 2.1.2.5 Configuring Network Settings.
12
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Manual Partitioning
If you choose manual partitioning, you can perform several activities on this screen, such as creating logical
volumes or software RAIDs, as well as increasing or reducing the size of partitions.
Figure: Setting Options for Manual Partitioning
You should deviate from the suggested partitioning only if you have a particular need based on your
configuration. For normal STARFACE installations, the recommended partitioning should be used.
13
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
2.1.2.5 Configuring Network Settings
You will now configure the network. In this step, you can assign an IP address and subnet mask to the
individual network cards if the computer is not connected to a DHCP server or if you do not want the network
address to be assigned dynamically. If you are going to enter the server name manually, you must also
define the gateway and the various DNS servers.
The gateway defines the IP address of the computer or router that will function as the network’s interface to
the Internet.
Figure: Network Configuration with DHCP
14
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
2.1.2.6 Selecting the Time Zone
The next step involves defining the computer’s time zone. Use your mouse to select the yellow dot on the
world map closest to your location. You can also define the time zone by selecting from the list. Select the
UTC option (Universal Time Coordinated) to convert automatically to summer time.
2.1.2.7 Entering the root Password
The administrator on a Linux system is always assigned the user name “root“. The password for root must
be at least six characters in length. You must type in the password two times. If the two entries do not match,
you will be asked to repeat both entries.
15
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
The password for root should be secure. A secure password consists of a combination of ciphers as well as
upper- and lower-case letters that do not form words (example of a secure password: Atz38ppj). Please note
that passwords are case sensitive.
Once you have entered the root password, you have completed the initial configuration of the operating
system. Confirm that you want to start installation and the system files will start to copy to your hard drive.
2.1.2.8 Completing the Installation
Before the transfer process starts, you will see a summary of the installation. A complete installation log can
be viewed after the system restarts (in the file “./root/install.log“).
Note: The console commands to open the installation log and the &quot;kickstart&quot; file are
less /root/install.log and less /root/anaconda-ks.cfg, respectively.
16
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
After successful installation, the computer must be restarted. First remove the installation CD from the drive.
After the restart, STARFACE can be configured and operated from any computer within the local network via
the web browser by typing “http://&lt;server_IP_address &gt;“ into the address line of the browser.
2.1.2.9 Using the Adminshell
After the server restart, the Adminshell is displayed. This is a useful tool for system diagnosis and
monitoring.
17
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
18
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Initial Configuration of the STARFACE Server
2.2
As soon as the operating system and server have been installed, you can configure STARFACE from any
computer via a web browser.
STARFACE should either be assigned a fixed IP address or have obtained a dynamic IP address via DHCP.
This IP address is output to the browser console after the boot procedure is completed. To start the
configuration process, type the IP address of the STARFACE server into the address line of the web browser
in the following format:
http://123.123.123.123/
where 123.123.123.123 represents the IP address.
The configuration menu opens in the browser.
Note: At this point, you can select the language to be used by STARFACE from the list at the top
right-hand side of the page.
Initial configuration consists of three steps:
Click
•
Detect and set up telephones and adapters in the local network that will communicate via the
server.
•
Configure the lines the server will use to connect to the telephone network.
•
Set up the administrator account.
to start the initial configuration.
Note: All initial configuration tasks can also be carried out at a later time, with the sole exception of the
administrator account setup.
2.2.1
Step 1: Detect and Set Up Telephones
In this first step, all telephones and other equipment, such as fax and ATA adapters, are set up. There are
two methods of completing this task:
•
Automatic telephone detection and configuration
•
Manual telephone setup
19
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Important: Every user account that is created is automatically assigned a Plugin-Phone (the
softphone integrated into STARFACE). This means that Plugin-Phones do not have to be configured
by the administrator in order for users to place telephone calls!
2.2.1.1 Automatic Telephone Detection and Configuration
As long as you have standard brand, commercially available Voice-over-IP telephones, they will be detected
and configured automatically during the installation process.
IP-Telephones
Manufacturer
Aastra
Allnet
Allnet
Sipura/Linksys
snom
Model
Firmware
480i
1.3.1.1095
7910
V.02.09.03
ALL7950 SIP
V.02.09.03
SPA-841
3.1.3.
190 SIP
3.60i
220 SIP
3.56z
300 SIP
6.0.3
320 SIP
4.0
360 SIP
4.x; 5.x
Thomson
SpeedTouch 2030
1.33F
ATA-Adapters
Manufacturer
Model
Firmware
Grand Stream
HandyTone ATA286 1.0.8.32
Sipura/Linksys
SPA-1001
2.0.13
SPA-2000
3.1.2.
SPA-2002
3.1.2.
Figure: Predefined device types that STARFACE detects automatically.
Click
to search for and configure all telephones that are present in the local network but
have NOT YET BEEN CONFIGURED.
The search progress is indicated and
Once the search completes, the button returns to
changes to
.
and the search process can be restarted.
Figure: If devices are found that are already configured, you can choose whether to overwrite the existing
configuration.
20
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
The detected device types are listed under
“Configured Devices“.
After the search, the number of detected and
configured telephones of each type is listed.
If you do not want to search the entire network for telephones, you can limit the range of IP addresses to be
searched. Click
to open the subnet dialog box.
Figure: Limiting the Range of IP Addresses to be Searched
Type in the starting and ending IP address to be searched. This causes the subnet to be searched for
devices starting with the IP address in the “Start“ field (e.g. 192.168.2.120) through to the IP address in
the “End“ field (e.g. 192.168.2.180).
If the server has multiple IP addresses or network cards, select the desired subnet from the list.
Click
to accept the restricted IP address range.
The search can then be restarted with
.
21
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
2.2.1.2 Manual Telephone Configuration
The button
opens a dialog box for defining new telephones.
Enter the type of device (the drop-down list offers all standard telephones currently supported by
STARFACE) as well as the user name and password for the device. Depending on the telephone type (e.g.,
snom 190) the newly defined telephone is automatically configured with the predefined data for this
telephone type as soon as it is saved.
Note: If devices are not detected during the automatic search, the configuration data (user name,
password, server IP) must be entered manually into the settings for the device and the device then
restarted.
2.2.1.2.1
Advanced Configuration
If the telephone is not located within the local network, you must set NAT “yes” to allow the voice information
to be sent over the firewall/router.
Important: To operate external devices, some ports must be opened in the firewall between the local
network and the Internet (not the firewall for the STARFACE server). The following ports are affected:
5060 UDP (for the SIP protocol), 4569 UDP (for the IAX protocol), and 10000-20000 UDP (for data
transmission via RTP).
“restr. to IP“ restricts the device operation to the specified address.
Codecs allow the conversion of analog (voice) information to digital data and back (encoding and decoding).
It is possible to assign a codec explicitly to a device. Although STARFACE supports many of the usual
codecs, we recommend that you use Codec G.711 alaw or ulaw. G.711 has been recognized as having the
best voice quality (comparable with ISDN) and a very small latency at 2 ms, although it does require a
22
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
(relatively) high bitrate of up to 84 Kbps. In comparison, Codecs such as G.729 require a bitrate of only 8
Kbps, but have a latency of between 25 and 35 ms.
Note: Some Codecs must be licensed separately. For example, although G.729 is integrated into
STARFACE, it must be registered before use. The application to do this is located at
/usr/lib/asterisk/modules/g729/ and can be started with ./register-g729-32-bit.
2.2.1.2.2
Define New Device Type
If your device type is not in the list of standard devices,
you can create new device types. To do this, select
“new” from the list.
The “New Phone” screen allows you to configure the new device type. Assign a unique name to the device
type. In the lower portion of the screen, the fields “type”, “dtmfmode”, “canreinvit”, and “qualify“ are
predefined and usually do not need to be changed. All other fields are optional.
23
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Options for Device Configuration:
type: The connection type for the device
peer: Can receive calls via the STARFACE server.
user: Can initiate calls via the STARFACE server.
friend: Can receive as well as initiate calls. This is the most common and in most cases
the recommended setting.
host: IP address (or DNS name) of the device, or “dynamic“ if the device does not have a static IP; i.e., if the
device is in a network with a DHCP server.
dtmfmode: Identifies the default tone dial method to be used. This is dependent on the telephone type being
defined (refer to the manufacturer documentation).
permit: IP address(es) that the client can use to register with the server. Use either an IP address (e.g.,
192.168.0.1) or a combined IP address/network mask (e.g., 192.168.0.2/255.255.255.0). Separate multiple
entries with commas.
24
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
deny: This field is the opposite of “permit&quot;. IP addresses entered here will be denied access.
auth: Encoding method to be used during authentication.
canreinvite: &quot;yes&quot; allows clients to exchange data directly once the connection is set up (without
involvement of the server). Because some hardware components will fail with this setting, the default value
“no” should be retained.
disallow: We recommend that you disallow all Codecs by entering &quot;all&quot; here and then explicitly allow the
desired Codecs in the allow field. Multiple Codecs can be separated by commas; for example, alaw,ulaw.
insecure: &quot;very&quot; – Once the host is registered, it can place calls without further authentication.
&quot;yes&quot; – A peer can register just with an IP address (without defining a specific port).
port: Port number 5060 is predefined for the SIP protocol on the STARFACE server. This setting can be
replaced with a different port number that will be used exclusively for SIP.
qualify: Enter either &quot;yes&quot;, &quot;no&quot;, or a value in milliseconds. If &quot;yes&quot; is used, the server will check at regular
intervals whether the client can still be reached, whereby each query lasts 2000 ms. If the client does not
respond within this timeframe, STARFACE will consider it to be unavailable and will not forward any further
calls to it.
defaultip: Default IP address for an IAX client. If the value “dynamic” is set for the host field, STARFACE will
attempt to forward incoming calls for a previously unregistered IAX client to this IP address.
rtptimeout: Number of seconds after which a call is automatically ended if there is no data (RTP) traffic. This
is useful in cases where the user forgets to hang up the handset, for example.
rtpholdtimeout: Because rtptimeout does not react to a held call, this option lets you specify how long (in
seconds) a call may be on hold. This value must be greater than rtptimeout.
Click
to finish the configuration of a new telephone. The new telephone appears in the list of
defined telephones, and the configuration you have set up is added to the list of device types.
You can open and edit the configuration at any time by clicking
in the list of telephones.
2.2.1.3 List of Defined Telephones
This page shows all previously defined telephones. Note: This list does not contain the IAX-Clients / PluginPhones. These are preconfigured by the system and cannot be edited. Each user is assigned a PluginPhone which he or she can activate by himself. The Plugin-Phone gets activated in the user’s phone
preferences and is labeled „IAX2/...“ (Refer to 5.8.5 Plugin-Phone).
25
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Note: The status of the telephones is often not updated immediately after being successfully
configured; i.e., the status often shows “aus“ (off). Click to sort the list by “Status” to update the
display.
The list view can be limited by clicking on the alphabet tabs. The number of shown telephones can also be
defined in the “Display” list. Depending on how many telephones are displayed per page, the list might
extend over several pages. Use the browse function
to navigate to additional
pages. To find a specific device type, enter a search term (such as the device name) in the input field and
click
to start a detailed search. The list displays the device type, device name, and if applicable
the IP address for every telephone.
Click the Edit symbol
to open and modify the detailed settings for a telephone. Click
telephone entry from the list and from the system.
to remove the
and
can be used to add telephones. During the initial configuration, it is not
necessary to configure all telephones that will eventually be connected to the server. Additional telephones
can be configured at a later time.
Click the
button to complete step 1 of the initial configuration.
26
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
2.2.2
Step 2: Configure Lines
2.2.2.1 General Configuration
Prefix: To distinguish between internal and external numbers, you can prefix a digit to the number to be
entered during dialing. This is important when three-digit internal numbers are assigned because they can’t
be distinguished from three-digit external numbers during dialing (for example, the emergency number 110 is
prefixed with a 0 and thus is clearly differentiated from the internal extension 100). If your previous telephone
system had a defined prefix for accessing outside lines, it can be retained for reasons of continuity.
The Deposit field defines a number where all calls not reaching an extension are sent; for example, calls to
unassigned numbers or to numbers for which no forwarding rules have been defined. By setting up an
attendant number, you prevent incoming calls from being “lost”.
The Number Range defines the locally assigned extension numbers (“internal numbers”) that users can dial
to communicate with other users within a STARFACE network. The numbers can, but need not, be identical
to the numbers dialed from outside the network to reach those extensions.
Click
to open the directory number (DN) identification. The internal DNs can be assigned names or other
identification to be displayed in place of the number in the Call Manager. For example, if the Marketing
department has multiple numbers, all of them can be identified simply as “Marketing”.
27
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
2.2.2.2 Lines
Lines refer to the connections used by the STARFACE server for telephony.
These are:
•
Direct Internet connections via a Voice-over-IP provider.
•
Connections to an ISDN network via an ISDN provider.
•
Connections via a GSM adapter to a cellular network.
•
Connection to an analog device or to the analog telephone network.
Each line can be one of the following types:
•
Provider
•
GSM card
•
ISDN card external / ISDN card internal
•
Analog FXS
•
Analog FXO
If no cards are installed in the computer, or if they are not recognized, only the provider connection will be
available for selection. At this point, each line must be assigned a line name.
2.2.2.2.1
Provider Connection
Several VoIP providers are predefined in the STARFACE menu. However, you can also add new definitions.
Refer to your provider documentation for the directory number, user names, and password to use to
authenticate the line with the provider. Successful authentication is indicated when the line status symbol
turns green and the status changes to “Registered”.
2.2.2.2.2
Add New Provider or Edit Provider
You add new providers in the same way that you add new telephones. Refer to Section 2.2.1.2 Manual
Telephone Configuration.
Note! Only the providers you create can be edited.
2.2.2.2.3
Using Cards / Adapters
Installed cards are usually detected by STARFACE and can be selected from the “Card Type” menu. You
can assign any name to the line; however, it should be a name that allows you to identify the line later. For
example, you can name the line with the name of the ISDN provider
28
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Note: If you want to assign the connectors of a single card to different lines, you must add each line
individually with
or
.
Select the check box under a connector to assign it. Connected lines - i.e., those that are physically plugged
in - are identified with a green icon. Configured connectors that are not yet plugged in are yellow. Connectors
that are neither configured nor plugged in are dark-grey. If a connection has already been assigned to
another line, it is identified with a light-grey icon and does not have a check box. This allows you to instantly
identify the status of all the connectors on a card.
Note: To assign the multiple cards to the same line/number range, click
individually.
to add each card
In these two figures, two connectors on the ISDN card have been assigned to different lines.
29
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
2.2.2.2.4
ISDN Connection (external/internal)
When configuring ISDN lines, the first step is to distinguish between external and internal connections. The
external connection is the “typical” method of connecting to the telephone network, and the internal
connection is used for ISDN fax devices, ISDN telephones, or connection to an existing telephone system.
Note: To assign multiple connectors on an ISDN card to the same line/number range, click
each connector individually.
to add
Important: After the ISDN configuration is changed, the telephony subsystem must be restarted. This
will terminate all calls in progress!
2.2.2.2.5
GSM Adapter
Each SIM card can be assigned exactly one line of the GSM adapter. The line is activated by selecting its
check box. In the case of dual or quad GSM cards, a separate SIM card is needed for each line to be used.
Once you have entered the PIN of the SIM card, enter the cellular number as an individual DN in the
“Number Area” tab and save it.
Important: If you enter and save an incorrect PIN three times, the card will be blocked. You must
have the PUK (Personal Unlocking Key) supplied by the provider to unlock the card.
30
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
2.2.2.2.6
Number Area
Number Area for providers: In this field, select the format that providers will use to transmit Dial numbers to
STARFACE. This field does not affect calls originating from the server.
The options in “Connection” for ISDN cards: Device Connection defines a DN range consisting of a base
number and a block of usually two-digit DDI numbers. Multi-device Connection consists of single DNs (called
multiple or MSN numbers, see examples below).
Important: The connection setting is crucial for call setup as well as for the functioning of the ISDN
line. Please refer to your ISDN provider documentation to determine the correct connection type!
You can enter your DNs either as Single Number or as a Number Block i.e., multiple MSN numbers can also
be entered as a block with base number plus DDI numbers. Of course, this is only practical if the DNs are
31
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
sequential. Thus, the differentiation between Single Number and Number Block merely suits the purpose of
the comfortable entry of dial numbers and is not depending on your connection type.
Examples:
Device Connection: Your provider has assigned DNs 23453245-0 through 23453245-99 to you. Enter
23453245 as the base number and then 0 to 99 as the DN range.
Multi-device Connection: You have individual DNs 2345-11, 2345-12, 2345-13, and 2345-14. Because the
numbers are sequential, you can choose to enter them as a DN block. Enter base number 2345 and DN
range 11 to 14.
Multi-device Connection: You have individual DNs 2345-11, 2345-13, and 2345-15. Because the numbers
are not sequential, you should select the individual DN entry and add each number by clicking the
icon to
the right.
2.2.2.2.7
Advanced Settings
On this page, you can make changes to the general settings for individual lines.
If multiple lines have been configured, use the “Line Prefix” field to define a prefix that will allow calls to be
set up directly via a specific line. Please note that you should use only single digits as a prefix. The
characters preceding and following the prefix **_ * must also be entered during dialing.
For every line, an internal DN can be defined as an alternative deposit for unanswered calls. If “Default“ is
selected, the general settings are used.
In the case of provider lines, the maximum number of calls per line should be entered manually in the “Max
Connection” field. This is dependent on your provider/contract. The predefined value of 0 sets the limit to
“unlimited”!
Important: After changing the ISDN configuration, you must restart the telephony subsystem. This will
terminate all calls in progress!
32
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
2.2.3
Step 3: Configure the STARFACE Users
2.2.3.1 The STARFACE User Concept
A distinction is made between two types of logins to the STARFACE system:
•
User login via the web interface using a login ID and password. This user can register/unregister on
various telephones ( *77 ), can be assigned telephones and DNs, and can be a member of one or more
groups.
•
Login of a telephone or software telephone (more precisely: one or more lines on a telephone) on the
system (called a SIP account).
The second type of login is of internal significance only and is not of interest to users.
Users can register themselves on a telephone via the keypad:
*
7
7
+ &lt;user ID&gt;
to register the user on this telephone
*
7
8
+ &lt;user ID&gt;
to unregister the user from this telephone
*
7
9
to unregister all users from this telephone
Note: If a user unregisters from a telephone with *
7
no longer assigned to that user until he registers again with
8
*
+ &lt;user ID&gt;, the telephone is
7
7
+ &lt;user ID&gt;, or
until an administrator assigns the device to the user again in STARFACE.
The telephone “belongs” to the first user registered on the phone; i.e., for outgoing calls, that user’s DN is
signaled and the call is allocated to him.
A user is identified in the STARFACE system by the following attributes:
•
Login ID
•
Password
•
First Name
•
Last Name
•
E-mail Address
33
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
2.2.3.2 Create Users
Login IDs must be unique. In other words, two users cannot have the same login ID. The login ID should
consist of at least 4 characters. Only the digits 0 through 9 may be used, as the user must be able to log in
via the telephone keypad!
Note: The automatic field completion function available in most web browsers should always be
deactivated, because otherwise the password field for new users will automatically be predefined with
a previously used password.
The password must be at least 6 characters in length. All lower-case and upper-case letters of the German
alphabet, including the umlauted characters, as well as the digits 0 through 9, hyphen, underscore, period,
pound (#) and asterisk, may be used. The secure password rules as defined for the root password (refer to
2.1.2.7 Entering the root Password) also apply here.
The login ID and password are automatically e-mailed to the user. Therefore, the e-mail address entered for
the user should be a valid one. Save the user account and the Initial Configuration is complete.
2.2.4
Complete the Initial Configuration
After initial configuration is successfully completed the login dialog is opened by which you get access to the
main menu with your user ID and password. You can make detailed settings in the configuration area of
STARFACE like creating accounts for users and groups, configuring additional lines and telephones etc..
You can get to the configuration area by clicking
and the administration symbol
.
Note: To operate STARFACE via the web browser, you must allow cookies and pop-ups, and you
must also activate JavaScript.
34
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
3
3.1
System Configuration
Configuration Menu
The menu bar provides an overview of the items that can be configured:
•
Create new users and edit existing users
•
Define and modify groups
•
Add telephones and ATA adapters
•
Configure moderated conferences
•
Define settings for STARFACE or LDAP address books
•
Set up voicemail boxes
•
Define routing rules for numbers, lines, and specific time periods
•
Configure lines to VoIP providers/ISDN devices
•
Modify server settings and update server software
•
View and export call statistics
•
Define advanced settings
35
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
3.2
3.2.1
Add / Edit Users
Selecting from User List / Adding Users
When you enter the user management area, you will see a list of existing users. Click
to add a user. The process is the same as during the initial configuration.
To edit a user entry, click
or
.
Note: The automatic field completion function available in most web browsers should always be
deactivated, because otherwise the password field for new users will automatically be predefined with
a previously used password.
3.2.2
Defining Redirecting Rules
Use this tab to define forwarding rules for the DNs assigned to this user. These redirection rules can be
always active, or they can be triggered if the number is busy or the call is not answered after a defined time
period.
To activate forwarding for a DN, select the check box to the left of the DN. Type in a forwarding destination.
This may be any number, including external or cellular numbers. If the user has a voicemail box, it can also
be used as a destination. Forwarding rules for a group DN can be defined only on the “Always” tab. If no
forwarding rules are defined in the “Timeout” tab, unanswered calls are forwarded to the attendant after 30
seconds. The DN of the attendant is defined in the general line configuration or in an individual line’s
configuration (refer to 2.2.2 Step 2: Configure Lines and 2.2.2.2.7 Advanced Settings).
Note: Users can also make/change these settings in their preferences.
36
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
3.2.3
Assigning Telephones
Click
or
to select an available telephone. Once the telephone is selected, all DNs for
this user are available on this device.
The “Primary Phone” setting is defined as follows when multiple devices are assigned:
•
The primary telephone setting defines which device is displayed as available/unavailable/busy on the
function keys of other users. This means that if the user is placing a call on another device, the user’s
busy status will not be visible to other users in the system (for more information on function keys, refer to
5.6 Function Keys).
•
The Call Manager sets up calls on the primary telephone as a default.
Use the device list to activate or deactivate the individual DNs for a device. As an example, one telephone
might be available only for internal calls and a second telephone only for external calls. This restricted
availability is indicated with the icon.
Important: The name „IAX2/...“ indicates a Plugin-Phone integrated in STARFACE. This has to be
activated by each user, even though the setting here says „Active“ . This activation only refers to the
use of the selected call numbers with this phone. For activation of the Plugin-Phone, please refer to
5.8.5 Plugin-Phone.
37
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
3.2.4
Assigning DNs
Figure:
or
opens the list of available internal and external DNs. Select the desired DN to
use it. The new DN is automatically activated for all telephones assigned to the user.
If a user is assigned multiple external DNs, use the menu to the left to select the DN to be displayed to the
other party. As a default, the number display is suppressed; i.e., the other party is identified in the display as
“anonymous”.
Note: Users can also make/change this setting in their preferences.
If a user has multiple internal DNs, the primary DN defined at the top of the page determines which number
is used by the function keys. The function keys display the call status for this number and are used for call
setup. For more information, refer to 5.6 Function Keys.
The settings of each DN can be modified by selecting the “Default Rule”.
38
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
The options are defined as follows:
Call-Through Function / Call via STARFACE: The number is used to forward calls from outside the network.
So, for example, it is possible to dial this number from a cell phone, then enter the desired destination
number (fixed or cellular network) and have the call connected. This means that only the connection costs to
STARFACE are charged to the cell phone, and not to the destination number in the fixed network or another
cellular network.
Call back also makes use of forwarding: The caller dials the DN but the call is not completed. Instead,
STARFACE calls back immediately, after which the caller enters the desired destination number. This means
there are no costs for the caller because the original call was not answered, but rather simply “registered”.
Call back internal is the callback function for forwarding to internal DNs.
Conference Room permanently reserves a DN as a virtual conference room. This option is independent of
the scheduled conferences feature (refer to 5.7 Phone Conferences). The conferences held via this DN
cannot be moderated or followed in the web browser like normal conferences.
Important: By changing the default rules to one of the four options described above, the number is no
longer available to the user because it is no longer a “normal” DN.
39
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
3.2.5
Assigning Groups
The field on the left lists the available groups. Use the arrows to assign/unassign group membership.
3.2.6
Assigning Access Rights
Select or clear the individual check boxes to assign or unassign access rights for the user. The rights are not
changed until the next time the user logs into the STARFACE. Functions that are made available to the user
are then visible in the user’s menu, while functions that are unassigned for that user are no longer visible.
3.3
Create and Edit Groups
Groups serve to define teams where any member can answer a call, and groups also serve to define
functionality.
Note: The automatic field completion function available in most web browsers should always be
deactivated, because otherwise the password field for new users will automatically be predefined with
a previously used password.
40
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Example: To receive customer service calls for hardware products, a group “Support Hardware” is created.
This group is assigned external extension number –76. On the company website, this number is listed as the
customer service number for hardware service. Calls to this number are sent to all telephones/softphones
registered as members of this group. Any one of these users can answer the call.
Important: In contrast to a user’s individual password, group members need a “passcode” consisting
of the digits 0-9.
3.3.1
Editing Group Settings
Groups are administered in almost the same way as users. Like users, groups have DNs (refer to 3.2.4
Assigning DNs), Redirect Calls (refer to 5.8.4), voicemail boxes (refer to 3.7 Create Voicemail Box), and
so on.
41
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Ringing Strategy: In addition to the conventional ring pattern, in which the telephones ring simultaneously for
all group members who are currently logged in, you can also choose to have the telephones ring in a “call
hunting group” pattern, in which the telephones ring one after another until the call is answered.
The availability of group members can be set by selecting or clearing the “Angemeldet“ (registered) check
box. This activation/deactivation corresponds to the setting users make in their own preferences. When a
member is registered or unregistered here, that user’s preferences are automatically updated as well. Refer
also to 5.8.1 Groups
3.4
Set Up Telephones
Telephones are detected and configured as defined in the initial configuration (refer to 2.2.1 Step 1: Detect
and Set Up Telephones).
42
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
3.5
Basic Settings for Virtual Conference Rooms
Before the moderated conference function can be used, several basic settings must be made.
First, define the DNs that invited participants will use to join the conference. During individual conference
scheduling from the main menu, PIN codes are generated automatically for invitees. This PIN code will be
required to join the conference.
The web server address is an IP address that is inserted into the invitation e-mail as a web link. Participants
use this address to follow the conference in their web browser. Refer to 5.7 Phone Conferences .
The predefined invitation text is a general template and can be customized later for individual conferences.
Variables can also be used to generate invitation e-mails automatically. When the e-mail is sent, these
variables are dynamically replaced with values such as PIN, call-in number, date, time, and so on.
43
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
3.6
3.6.1
Configure the Address Book
LDAP Server and Folder Configuration
Instead of creating a new address directory in STARFACE, you can link to existing directories on an LDAP
server.
To do this, you need the IP address of the server, a valid user name and password, as well as the base
directory of the LDAP server to be accessed. The format of these values must match the LDAP syntax. Once
a link to the server exists, you can use the lower half of the page (folder configuration) to select the
directories to be displayed in the STARFACE address book. In the left-hand column, you assign the names
to these directories that will be used from that point on in the address book view.
Important: If write access is allowed for a directory, then users will be able to edit and delete contact
entries in that directory!
Note: To use the LDAP address book, you must also make some view settings in the “Layout” tab.
3.6.2
Layout
Two designs are available for the layout. You can choose the LDAP view or the MS Active Directory 2003
view. Depending on the view you choose, you can make some customized settings.
3.6.2.1 Order of LDAP Fields
Define the entries users will see in the opened address book. Column 4 is reserved for telephone numbers.
STARFACE uses the numbers defined here to get the names—that is, to assign names to DNs. If one of
these fields is removed from the view (for example, “mobile”), the associated name cannot be displayed in
the call lists or in the Call Manager.
3.6.2.2 Definition of LDAP Fields
On this page, define the blocks of fields that will be seen in the detailed view. All detailed entries added here
will be visible to users in the “index card” view and (if write access was allowed) will be editable by users.
44
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Montage: The block name assigned to the left becomes a section title in the index card (to the right), under
which the individual field names and their contents are listed. Any number of blocks can be configured,
depending on which information should be available to users.
3.7
Create Voicemail Box
This page displays all previously created voicemail boxes. Use this page to sort, search, list alphabetically,
and so on. You can also create new voicemail boxes, delete them, or edit them.
When you edit a voicemail box, you can add or remove users and user groups, as well as set up, edit, or
listen to greetings. Greetings created here are saved as system-wide greetings; i.e., they are visible and
available to all users, and they can also be edited by any user with administrator rights. Personal greetings
should always be set up in the user’s individual settings (refer to 5.8.3 Voicemail).
If voicemail was already set up when the user or group account was created, then the user or group account
names will already be assigned to the appropriate voicemail box.
3.7.1
Creating and Editing Voicemail Boxes
45
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Note: After a new voicemail box is saved, an ID is generated for it automatically. Use this ID in the key
combination *
9 + &lt;voicemail box ID&gt; to listen to voicemails directly on the telephone.
In the example below, the administrator clicked
and assigned John Smith to the voicemail
box by selecting him from the list.
Optionally, you can specify that received voicemails are to be sent to the user as an email attachment. To do
this, simply select the appropriate check box. Users can also make or change this setting in their
preferences.
3.7.1.1 Recording Announcements
Click
to open the greetings list, then click
page for recording new greetings.
Click
to open the
. The telephone will ring. Pick up the phone and listen to the brief instructions, then record
your greeting. When you are finished, click the pound key (#) to end the recording. Click
the new greeting in STARFACE.
to save
46
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
3.7.1.2 Listening to Announcements
Click
to open the greetings list.
to select the telephone on which you will listen to the greeting. The telephone will ring. Pick up the
Click
phone and listen to the greeting.
3.8
Define Routing Rules
STARFACE allows you to set up “Least Cost Routing” (LCR).
Every least-cost route has a unique DN range. For every outgoing call, a search is made for an appropriate
LCR rule. The rule whose DN range comes as close as possible to the dialed DN is selected. For example,
two separate LCR rules might be defined for the DN ranges 0123 and 01234. A user initiates an outgoing
call to DN 0123456. In this case, the dialing rule for DN range 01234 is selected because it has more
matching digits than the rule for DN range 0123.
Note: If DN suppression is selected in the user’s preferences, the user’s DN is always suppressed
regardless of the settings made here.
Figure: If the DN defined as the display number in a user’s preferences is always to be displayed to the
called party for outgoing calls, then the priority must be set to “Line”. An attempt is then made to use the line
associated with this DN. If this is not possible - e.g., if the line is not available - the LCR is used but the DN
display is suppressed. If the “LCR” option is selected, the DN of the line currently being routed is sent. In this
case, the displayed DN changes depending on the routing and the line used. This behavior could
47
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
theoretically be suppressed by selecting “No Screening” in the advanced line configuration, but that feature
is currently supported by only a very few providers.
Every LCR rule has defined time periods during which it is valid. For a dialing rule, you can define zero, one
or multiple time periods. The only requirement is that time periods may not overlap. If you attempt to create a
dialing rule with overlapping time periods, you will receive an error message and the affected lines will be
highlighted.
For each time period, you can define zero, one, or multiple outbound lines. Lines are listed in order of
priority; i.e., the first line is used for the first attempt to set up a call, then the second line, and so on until all
lines have been tried. If the call fails on all defined lines, then all available system lines are tried to set up the
call.
The “Pre-Preselection” (Call-By-Call) field can be defined for every outbound line. This number is prefixed to
the actual DN. For example, the number 01234567 is dialed. This number is prefixed with 01019, so that
STARFACE actually dials 0101901234567.
Important: Call-By-Call numbers set up calls via the providers who make these numbers available.
You will be responsible for their telephone tariffs, and not those of the provider of the line used by the
routing.
Example: This LCR rule is used for international calls (in Germany by prefixing the DN with 00).
48
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
3.9
Configure Lines
The lines are configured in the same way as during initial configuration (refer to 2.2.2 Step 2: Configure
Lines).
3.10 Configure the Server
Use the server page to manage all STARFACE services. These include network settings for the DNS server,
NTP, and mail and web server. It also provides the data backup and restore function as well as the software
update function.
On this page you can restart individual services or the entire server.
Note! After a restart, users must log into the system again.
3.10.1
Software Updates
Only versions later than and compatible with the existing installation are listed. The latest available version is
preselected. You can also choose a different update from the list to use.
49
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Figure: This is the last chance to stop an update before all running processes are terminated.
Step 1 backs up the system before starting the update. If an error were to arise during the update, the
current system status could be restored without loss of data. Depending on the size of the update, the server
might require a restart. This process can take several minutes.
50
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
3.10.2
NTP and the Time
NTP (Network Time Protocol) is used to synchronize the system time of a computer with an NTP server. This
server can keep the time for the computer with an accuracy of between 10 ms and 20μs, depending on
whether it is located within or outside of the local network. The NTP server field lists available NTP servers
on the Internet. Alternatively, you can enter a different server address, or you can define the time manually. If
you define the time manually, the system clock on the server will maintain the date/time information.
If you make NTP available for the network segment, STARFACE becomes an NTP server from which the
telephones and client computers connected to this segment pull their system time. However, this option must
also be selected on the individual computers.
Caution: After the time settings are changed, the web server will restart!
3.10.3
Network
This tab provides an overview of the configuration settings defined during the initial installation. These
settings can be modified here.
Note: Any changes to the fields on this tab require a restart of the server.
51
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
3.10.3.1
SIP Settings
SIP (Session Initiation Protocol) is an open network protocol standard for call setup between two or more
SIP-ready VoIP devices. An important attribute of SIP is the use of RTP (Realtime Transport Protocol). RTP
“packs” the audio and video data of the call and sends it via UDP (User Datagram Protocol). Because the
ports are assigned dynamically for UDP, routers that use NAT cannot allocate the ports to the appropriate
data packs. If the server is in a network that uses NAT (e.g., via a router), you might need to select the check
box for NAT.
NAT (Network Address Translation) “masks” the individual internal IP addresses “outside” the system
(toward the Internet) by replacing them with one or more public IP addresses. Often, “masquerading” (PAT,
NAPT) is also used, which additionally replaces the port numbers of a data transmission. The settings for
NAT must be taken into account if the STARFACE server is connected via a provider line or if external
telephones are connected (refer also to the advanced line configuration in Section 2.2.1.2.1 Advanced
Configuration).
Important: To operate external devices, the following ports must be opened in the firewall: 5060 UDP
(for SIP), 4569 UDP (for IAX), and 10000-20000 UDP (for RTP).
The interaction between STARFACE and NAT is strongly dependent on the network architecture. Therefore,
these settings should not be changed once the system (or more accurately, telephony) is functioning
correctly. On the other hand, it is possible that if connections are not functioning correctly, the cause could lie
in the interaction among firewalls, routers, and the server.
You can find a more detailed discussion of NAT and its various forms, as well as the complex
interdependencies, at http://www.asteriskguru.com.
The field „External adress“ is especially important: Both the server for Instant Messaging and the
STARFACE WinClient depend on this entry. Click the corresponding button on the right to use the
automatically detected IP address. Alternatively, you may enter the domain name of your STARFACE
server. In case STARFACE is behind a NAT and consequential problems occur the „STUN“ field might be
helpful.
STUN (Simple Traversal of UDP over NATs ) is also a network protocol. Via STUN, the external IP address
of the server can get detected. To do so, fill in the address of a free STUN server, e.g.
stun.sipgate.net. For a list of further STUN servers refert to http://www.voip-info.org/wiki-STUN.
52
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
3.10.3.2
Network Settings
The function of DNS servers (Domain Name Service) is to resolve URLs into IP addresses; for example,
www.starface.de resolves to 85.214.20.166. Simply put, this principle is analogous to the relationship
between telephone numbers and names in the telephone book. The server addresses defined during
installation are entered here and are automatically updated.
3.10.3.3
Network Adapter
Please note that after changing the IP address of the network card, STARFACE must be opened again by
typing the new IP address in the web browser, as the server will no longer be available under the old IP
address. It is therefore recommended that the setting “Protocol“ be set to static so that the server can always
be reached at the defined address (as long as this address is not assigned differently by the DHCP server).
53
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
3.10.4
Setting Up the Mail Server
STARFACE uses an integrated mail server to send system messages (e.g., changes made to user data by
administrators) and voicemails to users via e-mail. If you wish to use an external mail server for this purpose,
the login and connection data are entered here. Details such as the name of the SMTP server can be
obtained from the provider.
3.10.5
Configuring the Web Server
HTTPS (HyperText Transfer Protocol Secure) is a network protocol for encoded data transfer via SSL/TLS.
It offers:
•
Data privacy (data cannot be seen by third parties)
•
Data integrity (data cannot be manipulated)
•
Authentication (the knowledge that you are connected with the server you want to be connected to)
If HTTPS is activated, all HTTP queries can be diverted to HTTPS.
To use HTTPS, you must create a certificate for the web server. A provisional certificate is already stored in
STARFACE.
3.10.5.1
Click
required:
Creating a Server Certificate
to open the page where you will create the certificate. The following fields are
1. The server name. This is the domain that the certificate will apply to.
2. The number of days that the certificate will be valid.
The domain name must be complete; for example, www.yourcompany.net (without &quot;http://&quot;). A
certificate is not valid for any subdomains, so each and every domain or subdomain requires its own
certificate.
For a server certificate to have any value, it should be signed by a Certificate Authority (CA). You can find a
selection of CAs in your browser settings (in Internet Explorer, go to Tools &gt; Internet Options -&gt; Content; in
54
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Firefox, go to Tools &gt; Options &gt; Advanced &gt; Encryption). Refer to the individual CAs for details on what
requirements you must meet to create a certificate.
to generate an encoded certificate file. The contents of this page can
Click
then be copied and e-mailed to the CA. The CA then reviews the request and returns the signed certificate
via email.
3.10.5.2
Loading Certificates
to open a new window with two text fields. Copy the signed
Click
certificate from the e-mail into the upper field and the root certificate from the CA into the lower field.
3.10.6
Backup and Restore
Every 24 hours, STARFACE automatically generates a data backup of the user, group, and configuration
settings, as well as all call lists, voicemails, and greetings. The backup can be saved either directly on the
server or to an external USB storage medium/SD card that is connected to the server. These must be
formatted with the file system FAT32, VFAT, or ext2. The data is saved to the automatically generated
directory “starface-backup“.
The previous seven backup files are saved; in other words, data from the last seven days are available.
Naturally, with this amount of data, it is possible to exceed the available storage space on external data
carriers. In this case, the previous backups are overwritten, oldest to newest.
If you want to make your own backup files at other storage locations, follow the instructions here to complete
the backup via the web interface.
3.10.6.1
Creating the Backup
In addition to storage on the server, you can select any of several options for saving the backup file. For
example, the file can be attached to an e-mail and sent to an address you define. It is also possible to
download the backup to the hard drive of a client computer.
55
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
A minimum data backup consists of the core data, including users, groups, and settings. In addition, received
voice messages, recorded announcements, and the call detail record (CDR) can also be saved.
The CDR is the data record of all communications and can be used for billing. It includes information about
telephone calls, including the subscribers involved, time of call, call duration, and so on.
56
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
The size of the backup file is dependent on the number of core data records and how much additional data is
to be backed up. If you select to have the backup sent as an attachment to an email address, the system will
give you a warning if the backup is too large for this option. At that time, you can change the storage method.
to start the data backup. The progress is indicated. Once the progress reaches 100%, the
Click
data backup will have completed successfully.
If you selected the option to download the backup file after completion (in step 1/3), a browser dialog box will
open at this time allowing you to save the file to a location you specify.
57
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
3.10.6.2
Restoring a Backup
This page lists all backup files available on the server, in chronological order from oldest to newest. If a file
was uploaded to the server (from a local computer), it is added to the list in the correct chronological
sequence and must be explicitly selected.
58
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
If the backup file includes greetings, voicemails, and call detail record (CDR) in addition to the core data, use
this page to specify whether these data records are also to be restored. The CDR is the data record of all
communications and can be used for billing. It includes information about telephone calls.
Important: When restoring the data records, the existing and the newer data is not compared. That
means that greetings recorded after the backup file was created are deleted during the restore
process and are no longer available.
The option “Ignore IP “ is of significance if the backup is to be imported from another STARFACE server. In
this case, this option MUST be selected.
Click
. This opens a list showing the number of logged in users and active telephone calls.
Because the restore process will terminate all of these processes, you must decide at this point whether to
continue with the restore process or cancel it.
3.10.7
Viewing Log Files
The STARFACE interface maintains two separate log files, the log file for the telephony server (PBX log file)
and the log file for the web server (application log file).
In the application log file, you can define what data will be logged by setting the log level. The log levels are
organized hierarchically in the menu. This means that each higher level includes the data from all lower
levels. For example, if the “warn” level is selected, then all entries from the “error” level as well as from the
“fatal” level will be saved and displayed. A change to the log level must be saved and confirmed before the
view can be updated. However, a change in log level affects only future logging; the existing entries remain
in the file as well as in the display.
3.11 Statistical Analysis
3.11.1
Exporting Lists
, you can choose to have the call data for individual users and
Exported as a CSV file using
groups . This data can then be processed using an external application, such as MS Office Excel, and used
for accounting purposes.
59
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
3.11.2
Statistics
You can change how the call data is displayed. For example, you can generate individual views for each
user and each group spanning any time period.
In addition to the number and duration of calls, you can also choose to view a
graphical display of the load on the ISDN lines for the available time periods.
Click
to output the selected data graphically in a table.
60
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
3.12 Advanced Settings
This editor is used to create your own dial plan extensions or macros. Simply put, the dial plan is the entire
set of rules and routines defined for handling all VoIP connections.
In the first field, you can define global variables that are then available when defining macros in the lower
input field. The syntax is kept intentionally simple: Enter each variable and its value in a separate line in the
format variablename=value. However, predefined variables are not absolutely necessary when defining
macros, so this field can also remain empty.
Sample Macro Definition:
This is an extension that allows incoming faxes to be forwarded as e-mails. You will also require the shell
script “fax2mail”, written by Michelle Dupuis and available for download (along with its companion
“mail2fax”) on the Internet at www.generationd.com. The script is called in the final line of code with the
command System().
Code:
[[macro-fax2mail3]]; {fax2mail3}
exten =&gt; s,1,Goto(fax,1)
exten =&gt; fax,1,SetVar(FAXFILE=/var/spool/asterisk/fax/${CALLERIDNUM}.tif)
exten =&gt; fax,n,SetVar(FAXFILENOEXT=/var/spool/asterisk/fax/${CALLERIDNUM})
exten =&gt; fax,n,rxfax(${FAXFILE})
exten =&gt; fax,n,System('/usr/bin/fax2mail ${CALLERIDNUM} &quot;${CALLERIDNAME}&quot; FaxNum
RecipName [email protected] ${FAXFILENOEXT} p')
Macros you define here are available in the
menu by editing an account
and going to the
then opening the tab
column.
Figure: Assigning the macro to a fax DN in the user administration
61
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
This requires that the name of the macro is entered (in contrast to the official notation!) in the following way:
[[macro-...]]; {...}
Refer to the example above, where [[macro-fax2mail3]]; {fax2mail3} is defined.
For examples, detailed instructions, and tips for creating your own macros, as well as for the dial plan syntax,
go to voip-info.org.
62
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
4
The User Interface
4.1
Introduction
The user interface provides an easily learned, quick access to the entire system functionality. It is optimized
for Microsoft&reg; Internet Explorer starting with Version 5.5 as well as for Mozilla Firefox starting with Version
1.5.
STARFACE consists of three core interfaces: The Main Window for all functions not directly related to a
telephone call, the Call Manager, which visually displays and allows access to all functions directly related to
telephone calls, and an Administrations Window for easy configuration of the STARFACE system.
There are also separate windows for help topics that can be reached at any time with the icon. These
information pages are not located directly within STARFACE, but rather are loaded from the Internet; i.e.,
they are available only if a connection exists to the Internet. The help pages grow with the development of
the software and often offer more up-to-date information than a manual can.
4.2
4.2.1
System Login
Accessing the System
The login data (login ID and password) as well as the server address are sent to the user automatically via
email after the user account is created. Entering the system URL (e.g., http://tel.server.de) or the IP
address of the STARFACE server into the address line of the Internet browser to open the login dialog. Of
course, you can always add the address to your browser’s Favorites/Bookmarks for faster access.
When starting the application, you can log into the system by entering your login ID and password. Once you
are authenticated, you will see the main window of the application.
63
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
If you select the automatic login option, you will be logged in automatically the next time you open the web
interface. This login will remain in effect until you explicitly log out by clicking
”Logout” in the menu bar.
Note: To run STARFACE via the web browser, you must allow cookies and pop-ups, and JavaScript
must be activated.
4.3
Menu Bar in the Main Window
The menu bar allows you to access the core functions of STARFACE.
Call:
Open the Call Manager
Redirect:
Define redirection of calls for your own telephone numbers
Call Lists:
Display incoming, outgoing, and missed calls
Addressbook: Access stored telephone numbers and names
Voicemail:
Access stored voice messages
Keys:
Directly call and display the status of other users
Conference:
Schedule and configure moderated conferences
Preferences:
Administer your own account and the STARFACE system
Logout:
Exit STARFACE
64
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
5
Function Windows
Every STARFACE function is displayed in its own window. Click the function key in the menu bar to open the
appropriate function window.
Within the main window, you can open several function windows. Click and hold the left mouse button at the
very top of them to freely position the windows.
Call Manager
5.1
The Call Manager is a separate window within STARFACE. It shows incoming and outgoing telephone calls.
In the Call Manager, you can place calls via SIP telephone, telephone software, and naturally also via the
softphone integrated directly into STARFACE.
Note: You must allow STARFACE pop-ups in the browser to open the Call Manager.
Regardless of whether calls are set up from the 5.3 Call Lists, 5.4 Address Book, or 5.6 Function Keys, the
Call Manager gives you access to all of the functionality you would have during a telephone call.
•
Forwarding to other DNs or voicemail boxes
•
Consultation call
•
Switching between multiple callers
•
Ad-hoc telephone conferences
5.1.1
Placing Calls
STARFACE allows calls to be placed in several different ways. This section explains call setup directly within
the Call Manager.
Click
in the menu bar to open the Call Manager. If the user has multiple telephones, select the
telephone to be used from the list. As a default, the primary telephone will always be used. The primary
telephone is defined in the user’s preferences (refer to 5.8.2 Telephones).
Figure: Selecting the phone to use for the call
65
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
You can enter the number to be dialed in one of the following ways:
•
By hovering the cursor over
number, then click
. Use the clickable keypad displayed on the screen to enter the
or press the “Enter“ key to start dialing.
•
By typing the numbers in on the computer keyboard. Then click
start dialing.
•
By hovering the cursor over
to start dialing.
or press the “Enter“ key to
to open a list of the most recently dialed numbers. Click a number
66
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Click the icon in the “Call Number“ field to delete an incomplete or wrong number. Of course, a call
number can also be copied and then pasted into the input field.
When dialing starts, a call module called
the “Call Task” opens. Each call task
represents one phone call. The
icon
indicates that this is an outgoing call.
If the call is answered, the status of the call
task changes. The call is now active and
you can commence talking. You can also
initiate consultation calls and conferences
from this active call (refer to 0
Handling Consultation Calls from the Call Manager and 5.1.4 Starting an Ad-Hoc Conference).
Click the
icon or hang up the handset to end the call. The Call Manager closes automatically.
67
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
5.1.2
Handling Incoming Calls
When calls are received, a call module
called the “Call Task” opens in the Call
Manager. Each call task represents one
phone call. The icon indicates that this
is an incoming call.
An incoming call is answered in the following ways:
•
By clicking
inactive).
•
By lifting the handset.
if the Plugin-Phone is used (this symbol is not available if the Plugin-Phone is
If the call is answered, the status of the call
task changes. The call is now active and
you can commence talking. You can also
initiate consultation calls and conferences
from this active call (refer to 0
68
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Handling Consultation Calls from the Call Manager and 5.1.4 Starting an Ad-Hoc Conference).
Click the
icon or hang up the handset to end the call. The Call Manager closes automatically.
If you do not want to answer a call, you can forward it directly to a different number.
, then enter the telephone number in the field or select from
To do this, position the cursor over
the list of contacts. This list shows all function keys and their status (refer to 5.6 Function Keys).
Click an entry in the list to forward the call immediately. Alternatively, enter a directory number into the text
field and click
automatically.
or press the “Enter” key. When the call is forwarded, the Call Manager closes
An incoming call can also be forwarded directly to the voicemail box.
69
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
To do this, position the cursor over
to open a list of assigned voicemail boxes. Click an entry in the
list to forward the call. The Call Manager closes automatically.
5.1.3
Handling Consultation Calls from the Call Manager
You can initiate a consultation call to internal or external subscribers during an active call.
, then enter the telephone number in the field or select from
To do this, position the cursor over
the list of contacts. This list shows all function keys and their status (refer to 5.6 Function Keys).
70
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Click an entry in the list to start the consultation call immediately. Alternatively, enter a directory number into
the text field and click
or press the “Enter” key.
When the consultation call starts, the active call is placed on hold.
The held call is then transferred to the consulted subscriber by clicking
the call tasks close and the line is available again.
. After the call is transferred,
icon in the Inquiry call and hang up the
To return to a held call without completing the transfer, click the
handset. The telephone will ring and the held subscriber will again be on the line. You can also start an adhoc conference with the consulted call and the held call.
71
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
To do this, click
in the Inquiry call.
Figure: Conference with two external subscribers
5.1.4
Starting an Ad-Hoc Conference
From an active or held call, position the cursor over
to start an ad-hoc conference. This opens
an input field where you can enter the DN of the conference participant. Click
to place the call.
72
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Figure: Enter the number of the conference participant.
For this conference call, a separate call task opens and the previously active call is placed on hold.
Figure: Conference request in a new call task
Click
conference.
in the conference call task to connect the new participant and the held call into a
Figure: The Conference task with two external subscribers
73
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Click
to remove an individual participant from the current conference without ending the entire
conference.
Note: The user who started the conference can exit it in one of two ways:
End the conference with
.
Hang up. The conference remains intact for the remaining participants.
5.2
Redirect Calls
The call forwarding function forwards calls to a different telephone number or to a voicemail box. Click the
“Umleitung” (forwarding) button in the menu to open the corresponding window. This window contains all
telephone numbers assigned to the current user. The call forwarding rules activated here apply all the time,
not only when the user cannot be reached.
Note: The “Preferences“ window allows detailed forwarding rules to be defined for busy line or
unanswered calls (refer to 5.8.4 Redirect Calls).
In this example, the telephone number 12365426 is forwarded to the external number 01733771 and the
internal number 21 is redirected to voicemail box 21. Calls to the external number 12365436 are allowed
through.
The
icon indicates that this number is assigned to a group. Forwarding for this number will apply to all
group members, and the group can now be reached only via the forwarded number (in this example, via a
cell phone number).
Important: Call redirection rules are active only if the check box under “On / Off” is selected. This means that
you can predefine call forwarding rules and then activate or deactivate them as needed. Click
enter the redirection rule into the system.
Note: Call redirection rules for all telephone numbers can be activated on the telephone with *
+ &lt;destination number&gt; and deactivated with
*
5
to
5
.
74
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
5.3
Call Lists
Call lists display the telephone numbers and times of incoming, outgoing, answered, and missed calls for the
current user.
The first column shows the directory number of the calling party (for incoming and missed calls) or of the
called party (for outgoing calls). The second column shows the called number (e.g., if a user can be reached
under multiple numbers). If the caller or called party is listed in the address book or the user list, the name
from the address book/user list is displayed here in place of the number.
The
icon identifies calls to a group, and the group number is shown in the second column.
Click the column headers to sort the call list. As a default, the list is sorted by date and time.
Click
to place a call to that number. If a message is stored in the voicemail box from that call, click
to listen to it. To remove a call entry from the list, click the
5.4
icon.
Address Book
The address book allows you to centrally store important or frequently used telephone numbers.
75
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Contacts can be called directly from the address book. Click the
telephones.
icon to open the list of available
Important: When dialing speed dial numbers on the telephone, you must first dial
*
6
and
then the speed dial number!
icon. The details for this contact are displayed in the text field and the privacy
To edit an entry, click the
level of the contact is defined in the pull-down list. Entries defined as private are visible only to the user who
created the entry, while public entries are visible to all users in the system.
76
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
5.4.1
LDAP View
Refer to 3.6 Configure the Address Book for information on configuring the address book for LDAP.
Use the “Display“ field to switch between linked LDAP directories. All DNs stored for a contact can then be
called simply by clicking the desired
number.
Click the
index card
icon to the left
of the name column to open the index
card view.
77
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
The displayed data record does not refer directly to the simple address book view, but rather to the index
card view for a contact. This is because only the fields defined in the LDAP configuration can be edited (refer
to 3.6.2.2 Definition of LDAP Fields).
5.5
Voicemail
Under the tab “Inbox”, all messages received that day that have not yet been listened to are displayed
chronologically.
78
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Click the
icon to play a message. Click
to move the messages to other tabs (private, old).
Note: You can also listen to voicemails directly on the telephone:
*
9
+ &lt;voicemail box ID&gt; to listen to a specific voicemail box. The ID for the voicemail box is
available from
in the tab
.
Function Keys
5.6
5.6.1
Key Assignment
This function window represents the available function keys of an ISDN telephone. You can use the function
keys even if your telephone does not have these keys. The function key block can be configured individually
by every user. Click the
icon and select “Edit“ to open the key field configuration.
Function keys can be assigned in one of three ways:
•
•
•
All data, i.e., name and telephone number, can be entered manually.
An entry can be selected from the telephone book.
A STARFACE system user can be selected. In this case, the input field for the telephone number
cannot be edited.
79
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Figure: A function key is assigned to an internal contact.
Function key entries can be moved to the desired position by using the arrows to move the entry up or down
in the list.
Figure: If you have an snom telephone, use this option to copy the first n internal numbers to the telephone
keys, where n is the number of function keys on the device (for example, 5 keys on the snom190).
80
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
5.6.2
Dialing with Function Keys
The red availability icon on the function key for “Stefan”
shows that his line is busy.
Place Call
The call is placed by clicking the handset symbol (if there is
more than one telephone, the user can select the device to
call on).
5.6.3
Answering Calls
Incoming Call
The status display flashes red and green to indicate that
your colleague Stefan has an incoming call. If he is not at
his desk or is otherwise unavailable to answer the call, you
can answer the call for him on your own telephone by using
the pick-up function.
5.6.4
Call Pick-Up
Position the cursor over the
icon to display the called
line as well as the caller’s number (suppressed in the
example).
Click to answer have the Call Manager answer the call
(refer to 5.1 Call Manager).
81
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
5.7
5.7.1
Phone Conferences
Scheduling
Choose
from the main menu and
schedule regularly occurring conferences in the “Period“ menu.
in the opening overview. You can
The text template created by the administrator can then be customized for the conference. The placeholders
(%...%) allow dynamic generation of invitations via e-mail and are listed separately in the menu on the right.
Additional variables can be added to the text by selecting them from the list.
Participants are selected from the address book
, the user list , or by entering their names into the
participant field. Select the “Call“ check box to have the system call the user at the start of the conference.
This function can also serve as a reminder if a participant forgets to call into the conference.
The moderator is a participant who can mute or unmute participants, as well as add or remove participants
from the conference.
82
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
The scheduled conference can also be started before the scheduled time by clicking
. This causes
STARFACE to contact participants for whom the option “Call” has been selected. However, starting a
conference in this way if none of the participants has the “call” option selected will have no effect.
5.7.2
Managing Conferences
Moderators are identified with the
participants is displayed.
The individual states are:
icon. In the ”Privileges“ (mute/unmute) column, the current status of the
The participant may speak.
The participant is muted.
A muted participant is asking for permission to speak.
The participant’s status is changed by the moderator by clicking the corresponding icon. Click
allow only this one participant to speak, or click
to
to unmute all participants. Moderators can use a
to control whether participants may hear the conference. This control is independent of the
separate icon
mute/unmute control.
83
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
User Settings
5.8
Users can modify the following settings in their accounts on seven separate tabs:
•
Personal Data and Language Selection
•
Group Assignment
•
Assigned Telephones and Telephone Numbers
•
Voicemail Box
•
Call Forwarding
•
Plugin-Phone
•
Add-Ons
5.8.1
Groups
On this page, the user can see all group assignments and can also unregister from groups by clearing the
appropriate check box (after being assigned to a group by an administrator, the user is always automatically
registered with the group). However, unregistering from a group does not mean that the user is removed
from the group, but rather is more of a temporary logout; for example, if the user cannot or does not want to
answer calls for the group for a period of time.
Note: Alternatively, you can log into or out of the group via the telephone keypad:
*
3
2
+ &lt;group ID&gt;
Register with the group
*
3
3
+ &lt;group ID&gt;
Unregister with the group
84
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
5.8.2
Telephones
The following applies for the “Primary Phone“ if multiple devices are assigned:
•
The selection of the primary telephone defines which device will be displayed in the function keys of
other users as available/unavailable/busy. If a call is in progress on another device, this busy status will
not be visible to the other users in the system (for detailed information on function keys, refer to 5.6
Function Keys).
•
As a default, the Call Manager places calls via the primary telephone.
Use the device list to activate or deactivate the individual DNs for a device. As an example, one telephone
might be available only for internal calls and a second telephone only for external calls. This restricted
availability is indicated with the icon.
The “Call Waiting” function informs the user if another call is received during a call. The user can then decide
whether to accept the call, place the call on hold, or call the caller back later.
Important: The device name “IAX2/...” identifies a Plugin-Phone integrated into STARFACE. This
must be activated by every user individually, even if “active“ is set here. Activation here means only
that the selected DN will be used on this device. It means that the device (if it is being used) will
respond to calls for this DN. Refer to 5.8.5 Plugin-Phone for information on activating the PluginPhone.
85
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
5.8.3
Voicemail
This page lists all voicemail boxes assigned to the current user either directly or indirectly via a user group.
There are two types of entries:
•
User mailbox with full configuration rights.
•
Group mailbox with limited configuration rights.
Group mailboxes are identified with the icon
.
Voicemail boxes can be assigned multiple names in the system. A name is assigned by the administrator or
the system when the mailbox is created. Every assigned user can also assign a name to the voicemail box.
The user-defined name for a voicemail box is used throughout the user’s profile. If “Send by E-Mail“ is
selected, new voice messages are sent as attachments in an e-mail. By entering the number of a voicemail
box (
in the example) on the telephone keypad, voice messages can also be heard directly on the
telephone.
The user can select, record, listen to, or edit the greetings for the various user mailboxes. However, the
following restrictions apply:
86
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
•
Only greetings created by the user can be deleted or edited. System-wide greetings created by an
administrator are write-protected and can only be listened to.
•
Only individual user mailboxes may be password-protected by the user. Passcodes for group voicemail
boxes are assigned by the administrator (refer to 3.7 Create Voicemail Box).
•
In the case of group boxes, only the name of the box displayed to the current user may be edited.
5.8.4
Redirect Calls
This page allows the user to define detailed call forwarding rules. Separate tabs allow different rules to be
defined depending on whether
•
The line is busy.
•
The call was not answered after a defined time period.
Figure: Selecting the time period after which a call should be forwarded.
Note: Calls to group DNs can be set only for “Always” forwarding.
5.8.5
Plugin-Phone
The Plugin-Phone is the browser-based variant of a softphone. While softphones are proprietary software
applications that must be additionally installed on each client computer, the Plugin-Phone is integrated into
the Call Manager. It uses platform-independent web technologies and requires only the audio component of
the client computer. This means that an external hard or softphone is not required for placing calls via
STARFACE. All calls can be handled with a headset/loudspeaker and the Call Manager.
Every user account is automatically assigned a Plugin-Phone (the device name always starts with “IAX2/...“).
However, the user is responsible for activating and using the Plugin-Phone. The functioning of the PluginPhone is dependent on the audio hardware (sound card) installed on the computer. If the user accesses
STARFACE from several different work places, the input/output device options will vary.
87
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
Once the Plugin-Phone is activated by selecting the appropriate check box, all phone calls can be handled
via a headset connected to the input/output of the sound card. The Plugin-Phone can be used as the only
telephone or in addition to other telephones (even as the primary telephone).
Note: To use the Plugin-Phone, Java must be allowed in the browser.
5.8.6
Add-Ons
Depending on the software installed on the client computers, various add-ons to the standard installation are
offered: The STARFACE Dialer for Mozilla Firefox, the STARFACE WinClient for MS Windows
(Windows2000/SP3 and higher), and the “Address Book” plug-in for Apple/Mac.
5.8.6.1 STARFACE Dialer for Mozilla Firefox
This add-on allows users to click a telephone number on any Internet page and place a call to that number.
After the add-on is installed and Firefox has been restarted, open “Tools“, then click “Configure STARFACE
Dialer“. In the dialog box, enter the IP address of the STARFACE server, your login ID and password.
The add-on is displayed with the STARFACE telephone handset symbol in the Firefox status bar (bottom
right).
Using the STARFACE Dialer: Select a telephone number with the mouse and then right-click the number to
open the context menu. Click the option “Starface: &lt;Number&gt; waehlen“ (dial &lt;number&gt;) to place the call.
If you left-click the telephone handset icon, all telephone numbers found on the web page are highlighted in
yellow. You can then click any of the highlighted numbers to have STARFACE place the call.
88
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
5.8.6.2 STARFACE WinClient / TAPI Driver
TAPI (Telephony Application Programming Interface ) is a software interface for supporting telephony
services on computers (Computer Telephony Integration / CTI) for the Windows operating system.
Computers can use the STARFACE WinClient to control functions such as call setup, forwarding, etc., via
the TAPI interface. To set up calls, the STARFACE WinClient can be started directly from the taskbar, or it
can be integrated into an application like MS Outlook in order to use telephony services directly in the
application.
Save the file STARFACE-WinClient-TSP-Setup.exe on the local computer and open it. The installation
starts. Follow the dialogue of the installation routine. Depending on your MS Windows (minimum Windows
2000 with Service Pack 3) an update of the WinInstaller and/or the additional installation of „.NET“Framework 2.0 is required. You only need to confirm these steps and the latest versions of these
components will automatically be installed.
After the WinClient has been successfully installed, start it by double-clicking the desktop icon. The
STARFACE icon appears as an active application in the notification area of the toolbar on the Windows
desktop.
1. Right-click the icon to open the context menu, then select “Settings“.
2. Copy the settings from the figure above. Exceptions are server address and network host. Put in here the
entry of the field “External address” from your server settings. Please refer to 3.10.3.1 SIP Settings.
89
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
3. Enter your STARFACE login
data as the user name and
password. The connection ID must
be a unique name. As a default, the
user’s computer name is entered.
4. Activate the interface to finish configuration of the
WinClient. Then click “OK“ .
90
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
5. You can now enter a DN using the “Quick dial“
option (confirm with the Enter key) and the call is
placed. You do not need to be logged into the web
interface to use the WinClient.
5.8.6.3 Address Book Plug-In for Mac
Copy both downloaded files (application and configuration) to
the folder “Address Book Plug-Ins“ of the Mac address book
(if this folder is not present, you must create it!). Restart the
address book and the plug-in is ready for use.
Click a contact’s number to open the context menu with the STARFACE dial option, then click this option to
make the call.
6
Instant Messaging with the Jabber Server
Your STARFACE system has an Instant Messaging server integrated as an additional feature. This server
allows network-internal, written communication (“chat”) in real-time. The name of the server software is
Wildfire, a free product from Jive Software, and uses the Jabber protocol. This server program is
automatically started with STARFACE and accesses its user accounts. Thus, every user is registered with
both servers with the same login data.
However, individual users require an IM client program on their local computers. A free, proven software is
the “PSI Jabber Client“, which is available for download at psi-im.org.
Note: When creating a user account, rights must be explicitly given for Instant Messaging, even if the
user is configured as an administrator.
91
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
After an IM client has been installed, the user must register with Jabber server.
In PSI this is done via the “Account Setup” where you create an new account with
name and confirm with
. Choose a
.
The “Account Properties” dialog opens. As
“Jabber ID” , give your login ID and the
STARFACE server address, separated only by
@. The server address is found in the field
“External address” in the server settings of
STARFACE (Refer to 3.10.3.1 SIP Settings).
Save the configuration. Right-click on your user
name or on the icon in the toolbar will open the
context menu. Select “Status” -&gt; “Online” and
you are being registered with the server.
92
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
7
7.1
Troubleshooting
I received a hardware error message at the start of the installation.
Does not apply to STARFACE APPLIANCE
In rare cases, a hardware error message can occur during installation from CD-ROM the first time “Enter“ is
pressed to confirm the installation step. This error is not caused by the STARFACE software, but rather is a
result of the boot loader of the Linux distribution being used. We assume that this error will be cleared in
future versions of the operating system.
If this error does occur, restart the computer and before you press “Enter” to confirm the first installation step,
enter a random character (it does not matter which one) after “boot:” and then confirm twice. The installation
process should then start without problem. We recommend that you do this the first time you try to install to
prevent the error from happening in the first place.
7.2
My ISDN card was not recognized.
If an installed ISDN card is not recognized by STARFACE, send an email to
mailto:[email protected] with the following information:
•
Name of the card
•
Manufacturer
•
Card specifications. To find this information, log onto the server as root and type in the command lspci
to output the detailed information.
•
Loaded kernel modules. Type in the command lsmod to output a list of loaded modules.
My phone echoes during telephone calls.
The cause of noisy echoes during telephone calls lies in the conversion of digital signals to analog, or in the
wiring of analog devices where two-wire subscriber lines are converted to four-wire telephone lines. While
STARFACE and VoIP telephones implement echo compensation to prevent the echo, it is not possible to
resolve the problem on analog devices because of the wiring. Echo can be minimized by not allowing
acoustic feedback. This can occur, for example, when the voice of the other subscriber echoes from the
headset or telephone loudspeaker into the microphone and the user hears his or her own voice as an echo.
To prevent this, the headset or telephone loudspeaker should be set at a lower volume.
93
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
8
Appendix
Ports that ought to be open in the firewall of the LAN:
Port
4569
5060
10000 bis 20000
5222
5223
Protokoll
UDP
UDP
UDP
TCP
TCP
Ben&ouml;tigt f&uuml;r
IAX-Pakete -&gt; z.B. Webphone / IAX-Telefone
SIP-Pakete -&gt; SIP-Telefone
RTP-Pakete -&gt; Sprachpakete
Unverschl&uuml;sselte XMPP-Pakete -&gt;WinClient / Jabber-Client
Verschl&uuml;sselte XMPP-Pakete -&gt;WinClient / Jabber-Client
Devices Automatically Detected by STARFACE:
IP-Telephones
ATA Adapters
ISDN Cards
Manufacturer
Aastra
Allnet
Allnet
Sipura/Linksys
snom
Thomson
Manufacturer
Grand Stream
Sipura/Linksys
Manufacturer
Asustek Computer, Inc.
Digium
Junghanns
Sirrix
GSM Cards
sitecom
Swyx
N.N.
Manufacturer
Junghanns
Model
480i
7910
ALL7950 SIP
SPA-841
190 SIP
220 SIP
300 SIP
320 SIP
360 SIP
SpeedTouch 2030
Model
HandyTone ATA286
SPA-1001
SPA-2000
SPA-2002
Firmware
1.3.1.1095
V.02.09.03
V.02.09.03
3.1.3.
3.60i
3.56z
6.0.3
4.0
4.x; 5.x
1.33F
Firmware
1.0.8.32
2.0.13
3.1.2.
3.1.2.
Model
ISDNLink P-IN100_ST-D (rev 02)
TE410P s2mBRI ISDN
TE210P s2mBRI ISDN
TE110P s2mBRI ISDN
B410P ISDN
OctoBRI
QuadBRI
SRX PCI4S0 (ab starface 2.0.5)
SRX PCI2E1 (ab starface 2.0.5)
DC-105
SX2 QuadBRI
HFC-Cologne ISDN-Network-controller
Model
unoGSM PCI
duoGSM PCI
quadGSM PCI
94
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
A selection of other devices (tested and manually configurable for STARFACE):
IP Telephones
Manufacturer
Model
Firmware
Siemens
Gigaset SL75 WLAN
Gigaset C450 IP
PSTN-Gateway
Manufacturer
Model
Firmware
Digium
Wildcard TDM400P
DECT Controllers Manufacturer
Model
Firmware
Multitone
CS100IP
Key Shortcuts on the Telephone:
*
3
2
+ &lt;group ID&gt;
Register a device in a group
*
3
3
+ &lt;group ID&gt;
Unregister a device from a group
*
5
*
5
*
6
*
7
7
+ &lt;user ID&gt;
Register a user on a device
*
7
8
+ &lt;user ID&gt;
Unregister a user from a device
*
7
9
*
9
*
* + &lt;number&gt; + *
+ &lt;DN&gt;
Forward all calls to this number
Cancel the call forwarding
+ &lt;speed dial number from address book &gt;
Unregister all users from a device
+ &lt;voicemail box ID&gt;
Retrieve messages from a voicemail box
Set up a call via a specific line if a line prefix was defined in the line
configuration.
95
STARFACE &copy;2007 by vertico software GmbH
Manual - for STARFACE Version 2.0
STARFACE - Manual - Release 1.1 - January 2007
The content of this manual is subject to change without notice. No part of this publication may be reproduced
or transmitted in any form or by any means, electronic or mechanical, without the prior written permission of
vertico software GmbH. &copy; 2006 vertico software GmbH. All rights reserved. Kriegsstr.236, 76135 Karlsruhe,
http://www.vertico-software.com
Limitation of Liability: No warranty is made for the accuracy of the contents of this manual. We welcome your
comments regarding any errors you might find.
Regarding Internet Links to sites outside of the vertico software GmbH website: The third parties who offer
these sites bear the sole responsibility for the contents of these sites and especially for damages resulting
from the use or non-use of the information offered. These links are provided “as-is” and without any
warranty, express or implied. We want to state explicitly that we do not have any control over the link text,
the webpage design, the contents of the linked pages, or the infringement of any rights, including marketing
and branding rights. For this reason, we are stating unambiguously that we are in no way associated with
and bear no responsibility for the link formulations or any of the contents of any linked pages in this manual.
This declaration applies to any and all links found in this manual. By reading and using the links, you agree
to these terms.
STARFACE is a registered trademark of vertico software GmbH. All other brand names, trademarks, and
company names are copyrighted by the respective company. Company and brand names are used here
without verification of any rights. The lack of a registered trademark or copyright symbol does not in any way
allow the assumption that these names or symbols are not subject to the rights of third parties.
96
STARFACE &copy;2007 by vertico software GmbH
">

Olá! Eu sou um chatbot de IA especificamente treinado para ajudá-lo com o Starface PBX system Manual do usuário. Já revisei cuidadosamente o documento e posso ajudá-lo a localizar as informações exatas de que precisa ou explicar o conteúdo de maneira clara e simples. Quer você esteja procurando orientação sobre recursos específicos, etapas de solução de problemas ou uso geral, fique à vontade para fazer suas perguntas. Quanto mais detalhes você fornecer sobre suas preocupações ou necessidades, mais precisamente e eficazmente poderei ajudá-lo!

Assistente digitando

O assistente está fora do teclado. Por favor, tente novamente mais tarde.

Parece que você acessou um documento escrito em vários idiomas, incluindo um que não é seu idioma nativo. Você pode usar os links a seguir para ocultar temporariamente as páginas sem o idioma de sua preferência.