~ubuntu-branches/ubuntu/gutsy/ekiga/gutsy

« back to all changes in this revision

Viewing changes to help/uk/ekiga.xml

  • Committer: Bazaar Package Importer
  • Author(s): Daniel Holbach
  • Date: 2006-02-13 22:43:18 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20060213224318-1dn5o31239l0e3hg
Tags: 1.99.1-0ubuntu1
* [Kilian Krause <kilian@debian.org>]
  - New upstream release (2.0 BETA 2).
  - Name changed from GnomeMeeting to Ekiga.
* [Daniel Holbach]:
  - adjusted versions.
  - debian/control.in:
    - added liblaunchpad-integration-dev.
  - debian/patches/01_lpi.dpatch,
    debian/patches/02_autoconf.dpatch:
    - re-added, updated.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
<?xml version="1.0" encoding="utf-8" standalone="no"?>
2
2
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd" [
3
 
<!ENTITY app "GnomeMeeting">
4
 
<!ENTITY appversion "1.2">
5
 
<!ENTITY manrevision "1.2">
 
3
<!ENTITY app "Ekiga">
 
4
<!ENTITY appversion "2.00">
 
5
<!ENTITY manrevision "2.00">
6
6
]>
7
7
<!-- Begin -->
8
8
<article id="index" lang="uk">
9
9
<articleinfo>
10
 
  <title><application>GnomeMeeting</application> Manual 1.2</title>
11
 
 
12
 
  <copyright><year>2003-2004</year><holder>Matthias Redlich</holder></copyright>
13
 
  <copyright><year>2003-2004</year><holder>Damien Sandras</holder></copyright>
14
 
  <copyright><year>2003-2004</year><holder>Christopher Warner</holder></copyright>
15
 
  <!-- translators: uncomment this:
16
 
 
17
 
  <copyright>
18
 
  <year>2002</year>
19
 
  <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
20
 
  </copyright>
21
 
 
22
 
  -->
23
 
 
24
 
  <revhistory>
25
 
    <revision> 
26
 
        <revnumber>GnomeMeeting Manual 1.0</revnumber> 
27
 
        <date>2004-02-19</date> 
28
 
        <revdescription> 
29
 
                <para role="author">Christopher Warner</para> 
30
 
        </revdescription> 
31
 
    </revision>
32
 
  </revhistory>
33
 
 
34
 
  <publisher>
35
 
    <publishername>Christopher Warner</publishername>
36
 
    <address><email>zanee@kernelcode.com</email></address>
37
 
  </publisher>
38
 
  <publisher>
39
 
    <publishername>Damien Sandras</publishername>
40
 
    <address><email>dsandras@seconix.com</email></address>
41
 
  </publisher>
42
 
  <publisher>
43
 
    <publishername>Matthias Redlich</publishername>
44
 
    <address><email>m-redlich@t-online.de</email></address>
45
 
  </publisher>
46
 
 
47
 
  <authorgroup>
48
 
    <author role="maintainer">
49
 
        <firstname>Christopher</firstname>
50
 
        <surname>Warner</surname>
51
 
        <othername>zanee</othername>
52
 
    </author>
53
 
    <author>
54
 
        <firstname>Matthias</firstname>
55
 
        <surname>Redlich</surname>
56
 
    </author>
57
 
    <author>
58
 
        <firstname>Damien</firstname>
59
 
        <surname>Sandras</surname>
60
 
    </author>
61
 
  </authorgroup>
62
 
 
63
 
  <releaseinfo>This documentation is for version 1.2 of GnomeMeeting.</releaseinfo>
64
 
 
65
 
  <abstract role="description">
66
 
    <para>User manual for the GnomeMeeting videoconferencing, IP Telephony and VoIP application</para>
67
 
  </abstract>
 
10
<title><application>Ekiga</application> Manual 2.00</title>
 
11
 
 
12
<copyright><year>2003-2006</year><holder>Damien Sandras</holder></copyright>
 
13
<copyright><year>2003-2004</year><holder>Matthias Redlich</holder></copyright>
 
14
<copyright><year>2003-2004</year><holder>Christopher Warner</holder></copyright>
 
15
<!-- translators: uncomment this:
 
16
 
 
17
<copyright>
 
18
<year>2002</year>
 
19
<holder>ME-THE-TRANSLATOR (Latin translation)</holder>
 
20
</copyright>
 
21
 
 
22
-->
 
23
 
 
24
<revhistory>
 
25
<revision> 
 
26
<revnumber>Ekiga Manual 2.0</revnumber> 
 
27
<date>2006-01-22</date> 
 
28
<revdescription> 
 
29
<para role="author">Damien Sandras</para> 
 
30
</revdescription> 
 
31
</revision>
 
32
</revhistory>
 
33
 
 
34
<publisher>
 
35
<publishername>Damien Sandras</publishername>
 
36
<address><email>dsandras@seconix.com</email></address>
 
37
</publisher>
 
38
<publisher>
 
39
<publishername>Christopher Warner</publishername>
 
40
<address><email>zanee@kernelcode.com</email></address>
 
41
</publisher>
 
42
<publisher>
 
43
<publishername>Matthias Redlich</publishername>
 
44
<address><email>m-redlich@t-online.de</email></address>
 
45
</publisher>
 
46
 
 
47
<authorgroup>
 
48
<author>
 
49
<firstname>Damien</firstname>
 
50
<surname>Sandras</surname>
 
51
</author>
 
52
<author role="maintainer">
 
53
<firstname>Christopher</firstname>
 
54
<surname>Warner</surname>
 
55
<othername>zanee</othername>
 
56
</author>
 
57
<author>
 
58
<firstname>Matthias</firstname>
 
59
<surname>Redlich</surname>
 
60
</author>
 
61
</authorgroup>
 
62
 
 
63
<releaseinfo>This documentation is for version 2.00 of Ekiga.</releaseinfo>
 
64
 
 
65
<abstract role="description">
 
66
<para>User manual for the Ekiga Voice over IP, IP Telephony and Video-Conferencing application</para>
 
67
</abstract>
68
68
</articleinfo>
69
69
 
70
70
<indexterm zone="index">
71
 
  <primary>GnomeMeeting</primary>
72
 
</indexterm>
73
 
<indexterm zone="index">
74
 
  <primary>gnomemeeting</primary>
75
 
</indexterm>
76
 
<indexterm zone="index">
77
 
  <primary>Gnomemeeting</primary>
 
71
<primary>Ekiga</primary>
 
72
</indexterm>
 
73
<indexterm zone="index">
 
74
<primary>Ekiga</primary>
 
75
</indexterm>
 
76
<indexterm zone="index">
 
77
<primary>Ekiga</primary>
78
78
</indexterm>
79
79
 
80
80
<!-- INTODUCTION          -->
81
81
<!-- What is &app; -->
82
82
 
83
 
<sect1 id="gnomemeeting-introduction">
84
 
    <title>Introduction</title>
85
 
    <para><application>GnomeMeeting</application> is a free audio/video-conferencing application for Linux and other Unices (e.g BSD or MacOSX). It was written by Damien Sandras and is licensed under the GNU/GPL.</para>
86
 
 
87
 
    <para>It is based on the H.323 ITU standard and allows you to make audio and video calls to remote users with H.323 hardware or software (such as Microsoft Netmeeting). It also supports all modern videoconferencing features, such as registering to an Internet Locator Service (ILS) directory, gatekeeper support, making multi-user conference calls using an external Multipoint Control Unit (MCU), using modern Quicknet telephony cards and making PC-To-Phone calls.</para>
88
 
    <para>
89
 
    <graphic fileref="figures/lumi.png"/> 
90
 
    </para>
91
 
</sect1>
92
 
 
93
 
<sect1 id="gnomemeeting-getting-started">
94
 
        <title>Getting Started</title>
95
 
        <para>When starting <application>GnomeMeeting</application> for the first time the configuration assistant will show automatically. The Configuration Assistant is a step-by-step questionnaire that will guide you through all the steps involved in creating the basic configuration you will need to operate <application>GnomeMeeting</application>. You should go through all of these steps properly, otherwise the assistant will re-appear (when it has not been completed) or Gnomemeeting will not function appropriately (if some of your answers have not been correct). You may run the Configuration Assistant at any time from the Edit menu.</para>
96
 
 
97
 
        <tip><title>Tip</title><para>All settings can be changed via the preferences window at anytime.</para></tip>
98
 
 
99
 
        <figure>
100
 
         <title/>
101
 
         <graphic fileref="figures/config_d1.png"/>
102
 
        </figure>
103
 
        <para><emphasis>Configuration Assistant Introduction</emphasis></para>
104
 
 
105
 
        <para>Throughout the entire configuration process navigation is available at the bottom of the window. You will be able to navigate through the questions using Back, Forward and Cancel. If you hit Cancel during the setup Gnomemeeting will not be affected by your changes and all entered information will be discarded.</para>
106
 
 
107
 
        <para>This page welcomes you to the Configuration Assistant. There is nothing to change or edit here. Press the 'Forward' button towards the bottom of the window to start the configuration.</para>
108
 
 
109
 
 
110
 
         <figure>
111
 
         <title/>
112
 
         <graphic fileref="figures/config_d2.png"/>
113
 
        </figure>
114
 
 
115
 
        <para><emphasis>Personal information</emphasis></para>
116
 
 
117
 
        <para>The Personal Information window requires you to supply personal information for GM usage. This information is necessary for basic functionality when connecting to other audio/video conferencing applications, as well as additional services such as user directories or gatekeepers. As user directories do require a First Name, Surname and Email-Address, you must enter them here, before proceeding.</para>
118
 
 
119
 
         <figure>
120
 
         <title/>
121
 
         <graphic fileref="figures/config_d3.png"/>
122
 
        </figure>
123
 
 
124
 
        <para><emphasis>Callto URL</emphasis></para>
125
 
 
126
 
        <para>The Callto URL; Enter an email address for a callto://address (eg: callto:ils.seconix.com/user@domain.com). If you leave the checkbox unchecked, your personal information will be published on the user directory of online Gnomemeeting users and you will be visible to other Gnomemeeting users. If checked then you will not be registered and other users will have to know your IP address to contact you. Please press 'Forward' after having entered all required information to continue.</para>
127
 
 
128
 
 
129
 
        <figure>
130
 
         <title/>
131
 
         <graphic fileref="figures/config_d4.png"/>
132
 
        </figure>
133
 
 
134
 
        <para><emphasis>Connection Type</emphasis></para>
135
 
 
136
 
        <para><application>GnomeMeeting</application> supports several audio and video codecs. It includes codecs with excellent quality as well as codecs with medium to good quality. The higher the quality of a codec, the more bandwidth it requires. Thus, not every codec will work properly with a very slow network connection. This option is necessary in the initial configuration of Gnomemeeting so that it chooses the optimal codec suited for your network connection and so that it adjusts the video quality settings. If your connection type is not mentioned in the list you should select the one closest to your network connect and adjust Gnomemeeting manually with the preferences window (codecs section) later on.</para> 
137
 
 
138
 
        <figure>
139
 
         <title/>
140
 
         <graphic fileref="figures/config_d5.png"/>
141
 
        </figure>
142
 
        
143
 
        <para><emphasis>NAT Type</emphasis></para>
144
 
 
145
 
        <para>The NAT Type detection page will allow you to detect which type of NAT you are using (if any) and help configure GnomeMeeting appropriately. Clicking on the detection button will bring a popup indicating which type of NAT was detected. This will help to describe the most appropriate way to configure GnomeMeeting allowing it to operate best with your NAT configuration. No configuration should be required in most cases, however some NAT routers will require the administrator to forward a few TCP and UDP ports to the internal computer running GnomeMeeting. Please refer to the GnomeMeeting <ulink url="http://www.gnomemeeting.org" type="http">FAQ</ulink> for configuration examples.</para>
146
 
        
147
 
        <figure>
148
 
         <title/>
149
 
         <graphic fileref="figures/config_d6.png"/>
150
 
        </figure>
151
 
        
152
 
        <para><emphasis>Audio Manager</emphasis></para>
153
 
 
154
 
        <para>The Audio manager manages everything audio. It can be ALSA, OSS or even Quicknet to manage a Quicknet card. The recommended Audio Manager is ALSA.</para>
155
 
 
156
 
 
157
 
        <figure>
158
 
         <title/>
159
 
         <graphic fileref="figures/config_d7.png"/>
160
 
        </figure>
161
 
 
162
 
        <para><emphasis>Audio Devices</emphasis></para>
163
 
        <para>Gnomemeeting requires audio devices to play and record sound. The audio output device ouputs the incoming sound stream during a call. Please select the device that your headset or speakers are connected to. The audio input device is where your microphone is connected to. These settings might be the same as the settings for the audio player if you have only one soundcard. But please note that it is also possible to record sound via another device (e.g. internal microphone in a webcam) too. It is generally recommended that you test your settings after having selected all the appropriate devices. Please press the 'Test those settings' button on the right. If this test was successful you can continue on to the next page in the Configuration Assistant. Otherwise you should change your devices and test your configuration again until you have a setup that works for you.</para>
164
 
 
165
 
        <figure>
166
 
         <title/>
167
 
         <graphic fileref="figures/config_d8.png"/>
168
 
        </figure>
169
 
 
170
 
        <para><emphasis>Video Manager</emphasis></para>
171
 
 
172
 
        <para>Please select the Video Manager from the list. It can be Video4Linux to manage webcams, or AVC / DC for Firewire cameras.</para>
173
 
 
174
 
 
175
 
        <figure>
176
 
         <title/>
177
 
         <graphic fileref="figures/config_d9.png"/>
178
 
        </figure>
179
 
 
180
 
        <para><emphasis>Video Devices</emphasis></para>
181
 
 
182
 
        <para>This step is optional and concerns users with video devices (e.g. webcams) only. If you do not have any video devices you may skip this page. If you have a video device but it's not showing up in the selection list or you want help in setting up your video device you may refer to the following links.</para>
183
 
 
184
 
        <para>If you have a webcam or video device in the list you may select it here.</para>
185
 
 
186
 
        <para>Please hit the "Test those settings" button to ensure that your device works with <application>GnomeMeeting</application> if so, continue on with the Configuration.</para>
187
 
 
188
 
 
189
 
        <figure>
190
 
         <title/>
191
 
         <graphic fileref="figures/config_d10.png"/>
192
 
        </figure>
193
 
        <para><emphasis>Configuration Complete</emphasis></para>
194
 
 
195
 
        <para>The configuration of Gnomemeeting is now completed. The last window only shows a short configuration summary of the settings you have chosen. Please verify that all these settings are correct. If something is incorrect you may use the 'Back' button in the lower right hand corner of the window to move to any page of the assistant and correct the mistake.</para>
196
 
 
197
 
        <para>If everything is correct please press the 'Apply' button to save the configuration. The assistant will be closed and the Main Window of Gnomemeeting will now appear. Remember, all settings can be changed via the preferences window at anytime.</para>   
198
 
 
199
 
</sect1>
200
 
 
201
 
<sect1 id="gnomemeeting-basic-usage">
 
83
<sect1 id="ekiga-introduction">
 
84
<title>Introduction</title>
 
85
<para><emphasis>Ekiga</emphasis></para>
 
86
<para><application>Ekiga</application> is a free Voice over IP, IP Telephony and Video-Conferencing application for Linux and other Unices (e.g BSD, OpenSolaris or MacOSX). It was written by Damien Sandras and is licensed under the GNU/GPL.</para>
 
87
 
 
88
<para>Ekiga is able to use modern Voice over IP protocols like SIP, and H.323. It supports all major features defined by those protocols like <emphasis>call hold</emphasis>, <emphasis>call transfer</emphasis>, <emphasis>call forwarding</emphasis>, ... It also supports basic <emphasis>instant messaging</emphasis>, and has advanced support for <emphasis>NAT traversal</emphasis>. Ekiga supports the best <emphasis>free</emphasis> audio and video codecs, and has wideband support for a superior audio quality, together with echo cancellation.</para>
 
89
 
 
90
<para><emphasis>SIP and H.323</emphasis></para>
 
91
<para>The Session Initiation Protocol (SIP) is a protocol developed by the IETF MMUSIC Working Group and proposed standard for initiating, modifying, and terminating an interactive user session that involves multimedia elements such as video, voice, instant messaging, online games, and virtual reality. In November 2000, SIP was accepted as a 3GPP signaling protocol and permanent element of the IMS architecture. It is one of the leading signalling protocols for Voice over IP.</para>
 
92
 
 
93
<para>H.323 was originally created to provide a mechanism for transporting multimedia applications over LANs but it has rapidly evolved to address the growing needs of VoIP networks. One strength of H.323 was the relatively early availability of a set of standards, not only defining the basic call model, but in addition the supplementary services, needed to address business communication expectations. H.323 was the first VoIP standard to adopt the IETF standard RTP to transport audio and video over IP networks. H.323 is based on the ISDN Q.931 protocol and is suited for interworking scenarios between IP and ISDN, respectively between IP and QSIG. A call model, similar to the ISDN call model, eases the introduction of IP Telephony into existing networks of ISDN based PBX systems.</para>
 
94
<para>
 
95
<graphic fileref="figures/lumi.png"/> 
 
96
</para>
 
97
</sect1>
 
98
 
 
99
<sect1 id="ekiga-getting-started">
 
100
<title>Getting Started</title>
 
101
<para>When starting <application>Ekiga</application> for the first time the configuration assistant will show automatically. The Configuration Assistant is a step-by-step questionnaire that will guide you through all the steps involved in creating the basic configuration you will need to operate <application>Ekiga</application>. You should go through all of these steps properly, otherwise the assistant will re-appear (when it has not been completed) or <application>Ekiga</application> will not function appropriately (if some of your answers have not been correct). You may run the Configuration Assistant at any time from the Edit menu.</para>
 
102
 
 
103
<tip><title>Tip</title><para>All settings can be changed via the preferences window at anytime.</para></tip>
 
104
 
 
105
<figure>
 
106
<title/>
 
107
<graphic fileref="figures/config_d1.png"/>
 
108
</figure>
 
109
<para><emphasis>Configuration Assistant Introduction</emphasis></para>
 
110
 
 
111
<para>Throughout the entire configuration process navigation is available at the bottom of the window. You will be able to navigate through the questions using Back, Forward and Cancel. If you hit Cancel during the setup <application>Ekiga</application> will not be affected by your changes and all entered information will be discarded.</para>
 
112
 
 
113
<para>This page welcomes you to the Configuration Assistant. There is nothing to change or edit here. Press the 'Forward' button towards the bottom of the window to start the configuration.</para>
 
114
 
 
115
 
 
116
<figure>
 
117
<title/>
 
118
<graphic fileref="figures/config_d2.png"/>
 
119
</figure>
 
120
 
 
121
<para><emphasis>Personal information</emphasis></para>
 
122
 
 
123
<para>The Personal Information window requires you to supply personal information to use <application>Ekiga</application>. This information is displayed when connecting to other audio/video applications.</para>
 
124
 
 
125
<figure>
 
126
<title/>
 
127
<graphic fileref="figures/config_d3.png"/>
 
128
</figure>
 
129
 
 
130
<para><emphasis>ekiga.net Account</emphasis></para>
 
131
 
 
132
<para>ekiga.net is a free SIP services platform provided to <application>Ekiga</application> users. It will provide you a SIP address that your friends and family can use to call you with any SIP compliant software or hardware. ekiga.net also offers additional services like conference rooms, voice mail or online white pages. Please see <ulink url="http://www.ekiga.net" type="http">http://www.ekiga.net</ulink> for more information.</para>
 
133
 
 
134
<para>Just follow the link given in the dialog to get an account if you do not have one, then fill in your username and password. Please press 'Forward' after having entered all required information to continue.</para>
 
135
 
 
136
 
 
137
<figure>
 
138
<title/>
 
139
<graphic fileref="figures/config_d4.png"/>
 
140
</figure>
 
141
 
 
142
<para><emphasis>Connection Type</emphasis></para>
 
143
 
 
144
<para><application>Ekiga</application> supports several audio and video codecs. It includes codecs with excellent quality as well as codecs with medium to good quality. The higher the quality of a codec, the more bandwidth it requires. Moreover, video codecs can adapt their quality to the available bandwidth. This option is necessary in the initial configuration of <application>Ekiga</application> so that it chooses the optimal codec suited to your network connection and so that it adjusts the video quality settings. If your connection type is not mentioned in the list you should select the one closest to your network connection and adjust <application>Ekiga</application> manually with the preferences window (codecs section) later on.</para> 
 
145
 
 
146
 
 
147
<figure>
 
148
<title/>
 
149
<graphic fileref="figures/config_d5.png"/>
 
150
</figure>
 
151
 
 
152
<para><emphasis>NAT Type</emphasis></para>
 
153
 
 
154
<para><application>Ekiga</application> has extended support for NAT. The NAT Type detection page will allow you to detect which type of NAT you are using (if any) and help configuring <application>Ekiga</application> appropriately. Clicking on the detection button will bring a popup indicating which type of NAT was detected and automatically configure <application>Ekiga</application> to transparently cross your router. In most of the cases, it will be totally transparent. Please refer to the <application>Ekiga</application><ulink url="http://www.ekiga.org" type="http">FAQ</ulink> for more information.</para>
 
155
 
 
156
 
 
157
<figure>
 
158
<title/>
 
159
<graphic fileref="figures/config_d6.png"/>
 
160
</figure>
 
161
 
 
162
<para><emphasis>Audio Manager</emphasis></para>
 
163
 
 
164
<para>The Audio manager manages everything audio. It is dependant on the operating system on which <application>Ekiga</application> is running, and some operating systems offer different alternatives.</para>
 
165
 
 
166
 
 
167
<figure>
 
168
<title/>
 
169
<graphic fileref="figures/config_d7.png"/>
 
170
</figure>
 
171
 
 
172
<para><emphasis>Audio Devices</emphasis></para>
 
173
<para><application>Ekiga</application> requires audio devices to play and record sound. The audio output device ouputs the incoming sound stream during a call. Please select the device that your headset or speakers are connected to. The audio input device is where your microphone is connected to. These settings might be the same as the settings for the audio player if you have only one soundcard. But please note that it is also possible to record sound via another device (e.g. internal microphone in a webcam) too. It is generally recommended that you test your settings after having selected all the appropriate devices. Please press the 'Test Settings' button on the right. If this test was successful you can continue on to the next page in the Configuration Assistant. Otherwise you should change your devices and test your configuration again until you have a setup that works for you.</para>
 
174
 
 
175
 
 
176
<figure>
 
177
<title/>
 
178
<graphic fileref="figures/config_d8.png"/>
 
179
</figure>
 
180
 
 
181
<para><emphasis>Video Manager</emphasis></para>
 
182
 
 
183
<para>Please select the Video Manager from the list. It can be Video4Linux to manage webcams, or AVC / DC for Firewire cameras, or any other choice depending on the operating system on which <application>Ekiga</application> is running.</para>
 
184
 
 
185
 
 
186
<figure>
 
187
<title/>
 
188
<graphic fileref="figures/config_d9.png"/>
 
189
</figure>
 
190
 
 
191
<para><emphasis>Video Devices</emphasis></para>
 
192
 
 
193
<para>This step is optional and concerns users with video devices (e.g. webcams) only. If you do not have any video devices you may skip this page.</para>
 
194
 
 
195
<para>If you have a webcam or video device in the list you may select it here.</para>
 
196
 
 
197
<para>Please hit the "Test Settings" button to ensure that your device works with <application>Ekiga</application>, if so, continue on with the Configuration.</para>
 
198
 
 
199
 
 
200
<figure>
 
201
<title/>
 
202
<graphic fileref="figures/config_d10.png"/>
 
203
</figure>
 
204
<para><emphasis>Configuration Complete</emphasis></para>
 
205
 
 
206
<para>The configuration of <application>Ekiga</application> is now completed. The last window only shows a short configuration summary of the settings you have chosen. Please verify that all these settings are correct. If something is incorrect you may use the 'Back' button in the lower right hand corner of the window to move to any page of the assistant and correct the mistake.</para>
 
207
 
 
208
<para>If everything is correct please press the 'Apply' button to save the configuration. The assistant will be closed and the main Window of <application>Ekiga</application> will now appear. Remember, all settings can be changed via the preferences window at anytime.</para>   
 
209
 
 
210
 
 
211
</sect1>
 
212
 
 
213
<sect1 id="ekiga-basic-usage">
202
214
<title>Basic Usage</title>
203
215
 
204
 
 <sect2 id="gnomemeeting-call-other-users">
205
 
 <title>To Call Other Users</title>
 
216
<sect2 id="ekiga-call-other-users">
 
217
<title>To Call Other Users</title>
206
218
 
207
219
<graphic fileref="figures/call_d1.png"/>
208
220
 
209
 
<para>Calling other users via Gnomemeeting is available in different forms and is done primarily through the use of URL's. <application>GnomeMeeting</application> supports two different kinds of URLs: h323:// and callto://. Callto URL's were used by Microsoft for Netmeeting, and H.323 URLs respect the H.323 standard and are thus the default for <application>GnomeMeeting</application>.</para>
 
221
<para>Calling other users via <application>Ekiga</application> is available in different forms and is done primarily through the use of URL's. <application>Ekiga</application> supports two different kinds of URLs: h323:// and callto://. Callto URL's were used by Microsoft for Netmeeting, and H.323 URLs respect the H.323 standard and are thus the default for <application>Ekiga</application>.</para>
210
222
 
211
223
<para><emphasis>H.323 URL's</emphasis></para>
212
224
 
222
234
 
223
235
<para>For example, calling <emphasis>callto:ils.seconix.com/joe.user@somedomain.com</emphasis> will look for the user with the joe.user@somedomain.com email address on the ILS server ils.seconix.com and proceed to initate a call.</para>
224
236
 
225
 
<para>Callto URL's also support more advanced parameters that are also supported by <application>GnomeMeeting</application>, all parameters are defined in the Microsoft documentation and should be seperated by a '+' in the URL.</para>
 
237
<para>Callto URL's also support more advanced parameters that are also supported by <application>Ekiga</application>, all parameters are defined in the Microsoft documentation and should be seperated by a '+' in the URL.</para>
226
238
 
227
 
<para>There are for example five different ways using <application>GnomeMeeting</application> to call the user joe on the gateway gw.seconix.com: <itemizedlist><listitem><para>callto:joe@gw.seconix.com</para></listitem><listitem><para>callto:joe+gateway=gw.seconix.com</para></listitem><listitem><para>h323:joe@gw.seconix.com</para></listitem><listitem><para>callto:joe if you specified gw.seconix.com as gateway in the <application>GnomeMeeting</application> preferences</para></listitem><listitem><para>h323:joe if you specified gw.seconix.com as gateway in the <application>GnomeMeeting</application> preferences</para></listitem></itemizedlist></para>
 
239
<para>There are for example five different ways using <application>Ekiga</application> to call the user joe on the gateway gw.seconix.com: <itemizedlist><listitem><para>callto:joe@gw.seconix.com</para></listitem><listitem><para>callto:joe+gateway=gw.seconix.com</para></listitem><listitem><para>h323:joe@gw.seconix.com</para></listitem><listitem><para>callto:joe if you specified gw.seconix.com as gateway in the <application>Ekiga</application> preferences</para></listitem><listitem><para>h323:joe if you specified gw.seconix.com as gateway in the <application>Ekiga</application> preferences</para></listitem></itemizedlist></para>
228
240
 
229
241
<para><emphasis>Speed dials</emphasis></para>
230
242
 
231
 
<para><application>GnomeMeeting</application> is able to associate speed dials with URLs using the address book. You can thus for example associate the speed dial <emphasis>1</emphasis> to the URL <emphasis>callto:ils.seconix.com/jonita@jxys.net</emphasis>. That speed dial can then be used as an H.323 or as a callto URL provided that it ends with <emphasis>#</emphasis>. For example, calling <emphasis>callto:1#</emphasis> will call <emphasis>callto:ils.seconix.com/jonita@jxys.net</emphasis> provided that both are associated together in the address book. Quicknet cards users will just have to dial 1 then hit the # key on the phone keypad to trigger the call to the associated URL.</para>
 
243
<para><application>Ekiga</application> is able to associate speed dials with URLs using the address book. You can thus for example associate the speed dial <emphasis>1</emphasis> to the URL <emphasis>callto:ils.seconix.com/jonita@jxys.net</emphasis>. That speed dial can then be used as an H.323 or as a callto URL provided that it ends with <emphasis>#</emphasis>. For example, calling <emphasis>callto:1#</emphasis> will call <emphasis>callto:ils.seconix.com/jonita@jxys.net</emphasis> provided that both are associated together in the address book. Quicknet cards users will just have to dial 1 then hit the # key on the phone keypad to trigger the call to the associated URL.</para>
232
244
 
233
245
<para><emphasis>Calling URLs</emphasis></para>
234
246
 
236
248
 
237
249
<tip><title>Tip</title><para>If you use literal IPv6-addresses, square brackets are required around them so that the last part of the address won't be mistaken for a port: h323:[2001:638:500:200:210:5aff:fe4c:cfd1] or h323:[2001:638:500:200:210:5aff:fe4c:cfd1]:1740</para></tip>
238
250
 
239
 
<!--<para>If you don't know the IP address of the party that you wish to call but have connected to an appropriate ILS (Internet Locator Server) server you may use the Gnomemeeting Address Book 
 
251
<!--<para>If you don't know the IP address of the party that you wish to call but have connected to an appropriate ILS (Internet Locator Server) server you may use the <application>&app;</application> Address Book 
240
252
which is available via Tools -> Address Book. Once selected, a window should appear. At the bottom of the new window will be a drop down box with "Find all contacts" selected, here you
241
253
have the option to display all contacts by clicking the Find Button, you can select from the drop down list to search for a person by First Name, Surname or Email adress. The text box to 
242
254
the right of the drop down list will then allow you to enter your search details, once entered press the Find button. You will then see a list of people connected to that server who you 
258
270
<para>The calls history remembers the callto and h323 URLs that have been used when giving or receiving calls. You can call any user again that is already present in your calls history by double-clicking on his entry in the history.</para>
259
271
</sect2>
260
272
 
261
 
<sect2 id="gnomemeeting-callable-other-users">
 
273
<sect2 id="ekiga-callable-other-users">
262
274
<title>To be Reached by Other Users</title>
263
275
 
264
276
<para>There are several ways to get a universally reachable address that other clients can use to call you. The most classical ones will be described here.</para>
270
282
<para>You can also register to a service providing DNS services for dynamic IP's. That way, your machine will always be associated to the registered hostname. This way other users will not need to know your IP address to be able to call you.</para>
271
283
 
272
284
<para><emphasis>Using a gatekeeper</emphasis></para>
273
 
<para>If your company is running an H.323 gatekeeper on a public IP, it can be configured to accept calls and redirect them to the correct GnomeMeeting client based on the called URL. For example, if a gatekeeper is installed on <emphasis>example.com</emphasis> and user <emphasis>joe</emphasis> is registered to that gatekeeper, then other users will be able to call <emphasis>joe</emphasis> using the following URL: <emphasis>h323:joe@example.com</emphasis>.</para>
 
285
<para>If your company is running an H.323 gatekeeper on a public IP, it can be configured to accept calls and redirect them to the correct <application>Ekiga</application> client based on the called URL. For example, if a gatekeeper is installed on <emphasis>example.com</emphasis> and user <emphasis>joe</emphasis> is registered to that gatekeeper, then other users will be able to call <emphasis>joe</emphasis> using the following URL: <emphasis>h323:joe@example.com</emphasis>.</para>
274
286
 
275
287
<para><emphasis>Using an ENUM record</emphasis></para>
276
288
<para>You can register an ENUM record on <ulink url="http://www.e164.org" type="http">www.e164.org</ulink>. That will permit you to associate your real phone number to any valid H.323 URL, and other users will be able to call you using your real phone number. For example, <emphasis>+3210444555</emphasis> will be directly linked to <emphasis>h323:myhostname.com</emphasis> and other users will be able to call you using <emphasis>h323:3210444555</emphasis>.</para>
278
290
</sect2>
279
291
 
280
292
 
281
 
<sect2 id="gnomemeeting-manage-calls">
 
293
<sect2 id="ekiga-manage-calls">
282
294
<title>To Manage Calls</title>
283
295
 
284
296
<para><emphasis>Understanding the statistics</emphasis></para>
287
299
 
288
300
<para>To view the statistics, please select the Statistics tab in the control panel.</para>
289
301
 
290
 
<para>The statistic visualizes the network traffic caused by <application>GnomeMeeting</application>. It draws a graph for each RTP stream. This means that - if audio and video are enabled in <application>GnomeMeeting</application> and the client of the remote party - you will see four different graphs. (incoming audio stream, incoming video stream, outgoing audio stream, outgoing video stream)</para>
 
302
<para>The statistic visualizes the network traffic caused by <application>Ekiga</application>. It draws a graph for each RTP stream. This means that - if audio and video are enabled in <application>Ekiga</application> and the client of the remote party - you will see four different graphs. (incoming audio stream, incoming video stream, outgoing audio stream, outgoing video stream)</para>
291
303
 
292
304
<itemizedlist>
293
305
<listitem>
295
307
</listitem>
296
308
 
297
309
<listitem>
298
 
<para>Late packets: The percentage of late packets, ie of packets from the remote user that you received but too late to be taken into account, <application>GnomeMeeting</application> being sending and receiving real-time video and audio.</para>
 
310
<para>Late packets: The percentage of late packets, ie of packets from the remote user that you received but too late to be taken into account, <application>Ekiga</application> being sending and receiving real-time video and audio.</para>
299
311
</listitem>
300
312
 
301
313
<listitem>
313
325
 
314
326
<para><emphasis>Using text chat</emphasis></para>
315
327
 
316
 
<para>Besides the communication through live audio and video streams <application>GnomeMeeting</application> also provides a text chat interface. This panel is opened via the text chat button in the control bar of the main window. Enter your message into the text entry box under the chat window and press enter to send it to the remote party. <tip><title>Tip</title><para>Text chat works with <application>GnomeMeeting</application> to <application>GnomeMeeting</application> clients only.</para></tip></para>
 
328
<para>Besides the communication through live audio and video streams <application>Ekiga</application> also provides a text chat interface. This panel is opened via the text chat button in the control bar of the main window. Enter your message into the text entry box under the chat window and press enter to send it to the remote party. <tip><title>Tip</title><para>Text chat works with <application>Ekiga</application> to <application>Ekiga</application> clients only.</para></tip></para>
317
329
 
318
330
<para><emphasis>Controlling the call</emphasis></para>
319
331
 
320
 
<para><application>GnomeMeeting</application> supports several actions which can be performed when in a call. These actions enable you to control active sessions.</para>
 
332
<para><application>Ekiga</application> supports several actions which can be performed when in a call. These actions enable you to control active sessions.</para>
321
333
 
322
334
<itemizedlist>
323
335
<listitem>
341
353
</listitem>
342
354
</itemizedlist>
343
355
 
344
 
<tip><title>Tip</title><para>All URLs supported by <application>GnomeMeeting</application> (H.323, CALLTO and Speed Dials) can be used for call transfer.</para></tip>
 
356
<tip><title>Tip</title><para>All URLs supported by <application>Ekiga</application> (H.323, CALLTO and Speed Dials) can be used for call transfer.</para></tip>
345
357
 
346
358
<para><emphasis>Taking a snapshot</emphasis></para>
347
359
 
348
 
<para>While in a call you can take a snapshot of the remote party via Call -&gt; Save Current Picture. A PNG-file will be saved in the current directory. The filename consists of three parts: the save_prefix, date and current time. (e.g. gnomemeeting-snap-2003_06_19-024316.png).</para>
 
360
<para>While in a call you can take a snapshot of the remote party via Call -&gt; Save Current Picture. A PNG-file will be saved in the current directory. The filename consists of three parts: the save_prefix, date and current time. (e.g. <application>Ekiga</application>-snap-2003_06_19-024316.png).</para>
349
361
 
350
362
<para><emphasis>Watching calls execution using the history windows</emphasis></para>
351
363
 
352
 
<para>History windows in <application>GnomeMeeting</application> are comparable to logfiles. They keep chronological track of actions performed by <application>GnomeMeeting</application> and provide additional information to the user.</para>
 
364
<para>History windows in <application>Ekiga</application> are comparable to logfiles. They keep chronological track of actions performed by <application>Ekiga</application> and provide additional information to the user.</para>
353
365
 
354
366
<para><emphasis>General History</emphasis></para>
355
367
 
357
369
 
358
370
<para><emphasis>Calls History</emphasis></para>
359
371
 
360
 
<para>The Calls History window stores information (date, duration, URL, Software, Remote user) about all outgoing and incoming calls. They are divided into three groups - Received calls, Given calls and Unanswered calls. <itemizedlist><listitem><para>Received calls contains all incoming calls which were accepted by <application>GnomeMeeting</application></para></listitem><listitem><para>Given calls keeps track of all attempts - succesful or not - to call another user.</para></listitem><listitem><para>Unanswered calls shows incoming calls which timed out or were rejected (if Do Not Disturb is enabled, for instance) by <application>GnomeMeeting</application>.</para></listitem></itemizedlist></para>
 
372
<para>The Calls History window stores information (date, duration, URL, Software, Remote user) about all outgoing and incoming calls. They are divided into three groups - Received calls, Given calls and Unanswered calls. <itemizedlist><listitem><para>Received calls contains all incoming calls which were accepted by <application>Ekiga</application></para></listitem><listitem><para>Given calls keeps track of all attempts - succesful or not - to call another user.</para></listitem><listitem><para>Unanswered calls shows incoming calls which timed out or were rejected (if Do Not Disturb is enabled, for instance) by <application>Ekiga</application>.</para></listitem></itemizedlist></para>
361
373
 
362
374
<tip><title>Tip</title><para>Double-clicking on a row in the Calls History will call the selected URL or transfer any active call to that URL. Notice that you can also drag and drop entries from the Calls History into the address book.</para></tip>
363
375
 
364
376
<para>This information can be accessed by opening Tools-&gt;Calls History and by switching between the three tabs.</para>
365
377
</sect2>
366
378
 
367
 
<sect2 id="gnomemeeting-register-ils">
 
379
<sect2 id="ekiga-register-ils">
368
380
<title>To Register to ILS Directories</title>
369
381
<para><emphasis>Registering to ILS directories</emphasis></para>
370
382
 
374
386
 
375
387
<para>The Internet Locator Service (ILS) is a directory similar to a telephone directory. Think of it as a phone book, when you want to call someone you just look up the number for that particular person and dial away. The ILS directory operates on the same concept except in this case the number you're looking up is an IP address.</para>
376
388
 
377
 
<para>The default ILS directory for Gnomemeeting users is ils.seconix.com, you can use any ILS directory of your choice.</para>
 
389
<para>The default ILS directory for <application>Ekiga</application> users is ils.seconix.com, you can use any ILS directory of your choice.</para>
378
390
 
379
391
<para><emphasis>Registering to an ILS directory</emphasis></para>
380
392
 
381
 
<para><application>GnomeMeeting</application> allows you to register to one ILS directory at a time. All settings can be configured with the preferences window. You can register to an ILS server with the following steps:</para>
 
393
<para><application>Ekiga</application> allows you to register to one ILS directory at a time. All settings can be configured with the preferences window. You can register to an ILS server with the following steps:</para>
382
394
 
383
395
<para><itemizedlist>
384
396
<listitem>
385
 
<para>Start Gnomemeeting</para>
 
397
<para>Start <application>Ekiga</application></para>
386
398
</listitem>
387
399
<listitem>
388
400
<para>Select Edit -&gt; Preferences and choose "Directory Settings" (located in the General subcategory) to your left.</para>
408
420
<para>The address book can be searched on the first name, last name and email address fields. Select the field you wish to search, enter the search query and press enter.</para>
409
421
</sect2>
410
422
 
411
 
<sect2 id="gnomemeeting-manage-contacts">
 
423
<sect2 id="ekiga-manage-contacts">
412
424
<title>To Manage Contacts</title>
413
425
<para><emphasis>Managing my contacts with the Address Book</emphasis></para>
414
426
 
415
 
        <para>The Address Book is a feature which allows you to find users to call and/or to save your list of persons that you call on a regular basis in a 'Group'. It loads the list of users from the ILS directory and will store locally CALLTO and H.323 URLS and associated speed dials as well as addresses of ILS directories.</para>
 
427
<para>The Address Book is a feature which allows you to find users to call and/or to save your list of persons that you call on a regular basis in a 'Group'. It loads the list of users from the ILS directory and will store locally CALLTO and H.323 URLS and associated speed dials as well as addresses of ILS directories.</para>
416
428
 
417
429
<para><emphasis>Basics of the Address Book</emphasis></para>
418
 
        <para>To open the Address Book select Tools -&gt; Address Book and the GnomeMeeting Addressbook window should appear. To your left there will be a list dialog showing the Servers you have added to the list as well as a list of Groups. The defaults are ils.seconix.com for Servers and the Personal address book.</para>
419
 
 
420
 
        <para>GnomeMeeting is able to use several types of address books. The most common address book type is the ILS directory where you can find information about registered users. GnomeMeeting is also able to browse real LDAP directories and use a specific attribute as calling URL. For example, you could have a gatekeeper in your company where all users are registering using their email address. All users would also be listed in the company's LDAP server, and a double-click on a specific user would trigger a call through the gatekeeper using the selected user's e-mail address.</para>
421
 
 
422
 
        <para>GnomeMeeting is also able to detect other GnomeMeeting users on the LAN using Rendez-Vous technology popularized by Apple (tm). That supposes you have a local mDNSResponder daemon running on your computer. Finally, GnomeMeeting is able to bookmark contacts in the local address book, shared with the Evolution suite.</para>
423
 
        
424
 
        <para>To receive a list of users on a certain ILS or LDAP server, right click on the server in question and select 'Refresh'. This will contact the server, eg: ils.seconix.com and fetch its user list. It will then sort the user list by callto:// URL and you can now begin to contact people by double clicking on their highlighted field. You can also Drag-N-Drop to call a specific party by selecting the highlighted field and dragging it into the Main Window.</para>
425
 
 
426
 
        <para>If the persons name is in the color 'gray' it means that this person is in Busy mode or currently already involved in a Gnomemeeting call with another user, the Status field 'S' will show a phone that is off the hook.</para>
427
 
 
428
 
        <para>In certain cases you'll want to search specifically for a persons name or email on a ILS directory. For instance an ILS directory might have a large amount of people and to scroll through each and every single name looking for the one you wish to call would be time consuming. With the Addressbook you can do this by selecting from the drop down list the persons First Name, Last Name or What their Email Contains and entering the appropriate search item into the input box then select 'Refresh'.</para>
 
430
<para>To open the Address Book select Tools -&gt; Address Book and the <application>Ekiga</application> Addressbook window should appear. To your left there will be a list dialog showing the Servers you have added to the list as well as a list of Groups. The defaults are ils.seconix.com for Servers and the Personal address book.</para>
 
431
 
 
432
<para><application>Ekiga</application> is able to use several types of address books. The most common address book type is the ILS directory where you can find information about registered users. <application>Ekiga</application> is also able to browse real LDAP directories and use a specific attribute as calling URL. For example, you could have a gatekeeper in your company where all users are registering using their email address. All users would also be listed in the company's LDAP server, and a double-click on a specific user would trigger a call through the gatekeeper using the selected user's e-mail address.</para>
 
433
 
 
434
<para><application>Ekiga</application> is also able to detect other <application>Ekiga</application> users on the LAN using Rendez-Vous technology popularized by Apple (tm). That supposes you have a local mDNSResponder daemon running on your computer. Finally, <application>Ekiga</application> is able to bookmark contacts in the local address book, shared with the Evolution suite.</para>
 
435
 
 
436
<para>To receive a list of users on a certain ILS or LDAP server, right click on the server in question and select 'Refresh'. This will contact the server, eg: ils.seconix.com and fetch its user list. It will then sort the user list by callto:// URL and you can now begin to contact people by double clicking on their highlighted field. You can also Drag-N-Drop to call a specific party by selecting the highlighted field and dragging it into the Main Window.</para>
 
437
 
 
438
<para>If the persons name is in the color 'gray' it means that this person is in Busy mode or currently already involved in a <application>Ekiga</application> call with another user, the Status field 'S' will show a phone that is off the hook.</para>
 
439
 
 
440
<para>In certain cases you'll want to search specifically for a persons name or email on a ILS directory. For instance an ILS directory might have a large amount of people and to scroll through each and every single name looking for the one you wish to call would be time consuming. With the Addressbook you can do this by selecting from the drop down list the persons First Name, Last Name or What their Email Contains and entering the appropriate search item into the input box then select 'Refresh'.</para>
429
441
 
430
442
<para><emphasis>Managing servers, groups and contacts</emphasis></para>
431
443
 
432
 
        <para>To add a server, highlight 'Servers' and right click. The option of adding a New server will appear. You then click on 'New Server' and at this point a dialog will appear asking you to enter the server name. Enter the name and select 'OK' and the new server should now appear in the Servers list.</para>
433
 
 
434
 
        <para>To add a group, highlight 'Groups' and right click. The option of adding a New group will appear. You then click on 'New group' and at this point a dialog will appear asking you to enter the group name. Enter the name and select 'OK' and the new group should now appear in the Groups list.</para>
435
 
 
436
 
        <para>To add a contact to one of your Groups you would select the Group you wish to add the contact to and right click. The option of adding a New Contact will appear and you may now enter the Contacts name and CALLTO or H.323 URL. After complete select 'OK' and now your contact is added to the list in that group.</para>
437
 
 
438
 
        <para>You can also add a contact from the ILS directory list by selecting the highlighted Contact and dragging them to the specific group you wish to add them to or by using the right-click menu when selecting that contact.</para>
439
 
 
440
 
        <para>Finally, you can edit the groups your users belong to using the User Properties dialog from the main menu or from the right-click menu, or using drag-and-drop between groups.</para>
 
444
<para>To add a server, highlight 'Servers' and right click. The option of adding a New server will appear. You then click on 'New Server' and at this point a dialog will appear asking you to enter the server name. Enter the name and select 'OK' and the new server should now appear in the Servers list.</para>
 
445
 
 
446
<para>To add a group, highlight 'Groups' and right click. The option of adding a New group will appear. You then click on 'New group' and at this point a dialog will appear asking you to enter the group name. Enter the name and select 'OK' and the new group should now appear in the Groups list.</para>
 
447
 
 
448
<para>To add a contact to one of your Groups you would select the Group you wish to add the contact to and right click. The option of adding a New Contact will appear and you may now enter the Contacts name and CALLTO or H.323 URL. After complete select 'OK' and now your contact is added to the list in that group.</para>
 
449
 
 
450
<para>You can also add a contact from the ILS directory list by selecting the highlighted Contact and dragging them to the specific group you wish to add them to or by using the right-click menu when selecting that contact.</para>
 
451
 
 
452
<para>Finally, you can edit the groups your users belong to using the User Properties dialog from the main menu or from the right-click menu, or using drag-and-drop between groups.</para>
441
453
 
442
454
</sect2>
443
455
 
444
 
<sect2 id="gnomemeeting-manage-incoming-calls">
 
456
<sect2 id="ekiga-manage-incoming-calls">
445
457
<title>To Manage Incoming Calls</title>
446
458
<para><emphasis>Managing incoming calls</emphasis></para>
447
459
 
448
 
        <para><application>GnomeMeeting</application> supports different policies for incoming calls. Per default it displays a popup window which allows you to decide whether you want to refuse or accept the request for an incoming call. Furthermore Gnomemeeting offers three additional behaviors: Busy mode, Free for Chat and Forward.</para>
 
460
<para><application>Ekiga</application> supports different policies for incoming calls. Per default it displays a popup window which allows you to decide whether you want to refuse or accept the request for an incoming call. Furthermore <application>Ekiga</application> offers three additional behaviors: Busy mode, Free for Chat and Forward.</para>
449
461
 
450
462
<para><emphasis>Busy mode</emphasis></para>
451
463
 
452
 
<para>If this mode is enabled Gnomemeeting refuses all incoming requests and only allows outgoing calls. You are not able to receive any call and do not notice if another user tries to contact you except when looking at the Calls History.</para>
 
464
<para>If this mode is enabled <application>Ekiga</application> refuses all incoming requests and only allows outgoing calls. You are not able to receive any call and do not notice if another user tries to contact you except when looking at the Calls History.</para>
453
465
 
454
466
<para>This mode can be enabled by selecting Call -&gt; Busy in the main window.</para>
455
467
 
456
468
<para><emphasis>Free for Chat mode</emphasis></para>
457
469
 
458
 
<para>If this behavior is activated Gnomemeeting accepts all incoming calls. It does not display a popup window but tries to establish the connection to the remote party immediately.</para>
 
470
<para>If this behavior is activated <application>Ekiga</application> accepts all incoming calls. It does not display a popup window but tries to establish the connection to the remote party immediately.</para>
459
471
 
460
472
<para>This mode can be enabled by selecting Call -&gt; Free For Chat in the main window menu.</para>
461
473
 
462
474
<para><emphasis>Forward</emphasis></para>
463
475
 
464
 
<para>Gnomemeeting has the ability to forward calls (H.323 Call Forwarding) to another host. Which allows you to configure Gnomemeeting to forward all incoming calls to a specified URL. Furthermore it is able to forward calls interactively when you do not answer the call after a configurable amount of time or when you are busy.</para>
 
476
<para><application>Ekiga</application> has the ability to forward calls (H.323 Call Forwarding) to another host. Which allows you to configure <application>Ekiga</application> to forward all incoming calls to a specified URL. Furthermore it is able to forward calls interactively when you do not answer the call after a configurable amount of time or when you are busy.</para>
465
477
 
466
478
<para>Call Forwarding can be configured by selecting Call -&gt; Forward in the main menu or through the preferences window. Notice that you need to specify an URL where to forward calls in the preferences to be able to activate tht option. Open the preferences window by choosing Edit -&gt; Preferences in the main window and select Call Forwarding on the left. You will now see the appropriate section. It contains three checkboxes for the three cases described above and one textfield for the IP address/hostname of the host the calls shall be forwarded to.</para>
467
479
 
468
480
</sect2>
469
481
</sect1>
470
482
 
471
 
<sect1 id="gnomemeeting-advanced-usage">
 
483
<sect1 id="ekiga-advanced-usage">
472
484
<title>Advanced Usage</title>
473
485
 
474
 
<sect2 id="gnomemeeting-register-gatekeeper">
 
486
<sect2 id="ekiga-register-gatekeeper">
475
487
<title>To Register to Gatekeepers</title>
476
488
<para><emphasis>Registering to Gatekeepers</emphasis></para>
477
489
 
479
491
 
480
492
<para><emphasis>What is a gatekeeper?</emphasis></para>
481
493
 
482
 
<para>A H.323 gatekeeper controls all H.323 clients (e.g. <application>GnomeMeeting</application> or NetMeeting) in its zone. Although gatekeepers have a large range of different features, one of their most important functions is to perform address translation between symbolic alias addresses and IP addresses. This means that you can use aliases instead of IP addresses to call another user.</para>
 
494
<para>A H.323 gatekeeper controls all H.323 clients (e.g. <application>Ekiga</application> or NetMeeting) in its zone. Although gatekeepers have a large range of different features, one of their most important functions is to perform address translation between symbolic alias addresses and IP addresses. This means that you can use aliases instead of IP addresses to call another user.</para>
483
495
 
484
496
<para>For instance, if you want to call the user "Damien" but you do not know his current IP address (dynamic IP addresses) you can easily use his alias at the gatekeeper. The gatekeeper will now direct your call to the correct IP address.</para>
485
497
 
487
499
 
488
500
<para><emphasis>Registering to gatekeepers</emphasis></para>
489
501
 
490
 
<para><application>GnomeMeeting</application> allows you to register to one gatekeeper. All settings can be configured with the preferences window. Please select Edit-&gt; Preferences and choose Gatekeeper Settings (located in the H.323 Settings subcategory) on the left. The display window contains all information necessary for a correct registration to a gatekeeper.</para>
 
502
<para><application>Ekiga</application> allows you to register to one gatekeeper. All settings can be configured with the preferences window. Please select Edit-&gt; Preferences and choose Gatekeeper Settings (located in the H.323 Settings subcategory) on the left. The display window contains all information necessary for a correct registration to a gatekeeper.</para>
491
503
 
492
 
<para><application>GnomeMeeting</application> provides three different methods to register to a gatekeeper. Available values for the Registration method are as follows:</para>
 
504
<para><application>Ekiga</application> provides three different methods to register to a gatekeeper. Available values for the Registration method are as follows:</para>
493
505
 
494
506
<itemizedlist>
495
 
    <listitem><para>Gatekeeper host - This method should be chosen when you know the hostname or IP address of the gatekeeper. <application>GnomeMeeting</application> will directly connect to the gatekeeper.</para></listitem>
496
 
    <listitem><para>Gatekeeper ID - This method should be used when you have a valid ID at a gatekeeper but you do not its hostname or IP address. In this case <application>GnomeMeeting</application> broadcasts a message and registers to the gatekeeper which answers to your ID.</para></listitem>
497
 
    <listitem><para>Automatically discover - If you are not sure which method to choose you can select this method. But please be aware that this method does not always work and is not recommended.</para></listitem>
 
507
<listitem><para>Gatekeeper host - This method should be chosen when you know the hostname or IP address of the gatekeeper. <application>Ekiga</application> will directly connect to the gatekeeper.</para></listitem>
 
508
<listitem><para>Gatekeeper ID - This method should be used when you have a valid ID at a gatekeeper but you do not its hostname or IP address. In this case <application>Ekiga</application> broadcasts a message and registers to the gatekeeper which answers to your ID.</para></listitem>
 
509
<listitem><para>Automatically discover - If you are not sure which method to choose you can select this method. But please be aware that this method does not always work and is not recommended.</para></listitem>
498
510
</itemizedlist>
499
511
 
500
512
<para>After having chosen the Registration method there are still four further fields - Gatekeeper ID, Gatekeeper host, Gatekeeper alias and Gatekeeper password. The four fields should contain the following information:</para>
501
513
 
502
514
<itemizedlist>
503
 
   <listitem><para>Gatekeeper ID - The Gatekeeper identifier to register with. This field is required when you have chosen Gatekeeper ID as the Registration method.</para></listitem>
504
 
   <listitem><para>Gatekeeper host - Hostname or IP address of the gatekeeper. This field is required when you have chosen Gatekeeper host as the Registration method.</para></listitem>
505
 
   <listitem><para>Gatekeeper alias - Gatekeeper alias to use when registering.</para></listitem>
506
 
   <listitem><para>Gatekeeper password - Password to use for H.235 authentication when registering to the gatekeeper.</para></listitem>
 
515
<listitem><para>Gatekeeper ID - The Gatekeeper identifier to register with. This field is required when you have chosen Gatekeeper ID as the Registration method.</para></listitem>
 
516
<listitem><para>Gatekeeper host - Hostname or IP address of the gatekeeper. This field is required when you have chosen Gatekeeper host as the Registration method.</para></listitem>
 
517
<listitem><para>Gatekeeper alias - Gatekeeper alias to use when registering.</para></listitem>
 
518
<listitem><para>Gatekeeper password - Password to use for H.235 authentication when registering to the gatekeeper.</para></listitem>
507
519
</itemizedlist>
508
520
 
509
 
<para>Gnomemeeting will automatically register/unregister to the gatekeeper when it is started/closed.</para>
 
521
<para><application>Ekiga</application> will automatically register/unregister to the gatekeeper when it is started/closed.</para>
510
522
</sect2>
511
523
 
512
524
 
513
 
<sect2 id="gnomemeeting-proxy">
 
525
<sect2 id="ekiga-proxy">
514
526
<title>To Do Calls Using a Gateway/Proxy</title>
515
527
 
516
528
<para><emphasis>What is a gateway/proxy?</emphasis></para>
519
531
 
520
532
<para><emphasis>Doing calls using a gateway</emphasis></para>
521
533
 
522
 
<para>Doing calls using a gateway is very simple. You can fill in the gateway hostname or IP address in the Gateway/Proxy section of the <application>GnomeMeeting</application> preferences, and then simply use classical H.323 or CALLTO URL's to call users using your gateway or proxy. <tip><title>Tip</title><para>You can not use CALLTO URLs looking on an ILS server when using a gateway or proxy. Notice also that it might be conflicting with your Gatekeeper following your Gatekeeper configuration.</para></tip></para>
 
534
<para>Doing calls using a gateway is very simple. You can fill in the gateway hostname or IP address in the Gateway/Proxy section of the <application>Ekiga</application> preferences, and then simply use classical H.323 or CALLTO URL's to call users using your gateway or proxy. <tip><title>Tip</title><para>You can not use CALLTO URLs looking on an ILS server when using a gateway or proxy. Notice also that it might be conflicting with your Gatekeeper following your Gatekeeper configuration.</para></tip></para>
523
535
</sect2>
524
536
 
525
537
 
526
 
<sect2 id="gnomemeeting-quicknet">
 
538
<sect2 id="ekiga-quicknet">
527
539
<title>To Use a Quicknet Card</title>
528
540
<para>A Quicknet card is hardware that can be used to replace your soundcard. It has several features that are not available to normal soundcard users like echo cancellation, G.723.1 audio codec support, POTS - Plain Old Telephone System - management.</para>
529
541
 
530
 
<para>When using a Quicknet card, you can use either an old phone plugged into the card or an headset. You will need to select Quicknet as plugin in the Audio Devices section of the preferences, select the required Audio Input Device and then indicate if you are using a POTS or a headset with your Quicknet card. If you are using a phone, simply plug its cable into the Quicknet card and you are ready to do <application>GnomeMeeting</application>-managed calls with your phone. <tip><title>Tip</title><para>You can use the '*' sign of the keypad of your phone to replace the '.' if you want to dial IPv4 addresses. Notice also that if you want to dial complex URLs, you can associate them to speed dials in the address book, and simply dial the given speed dial followed by '#' to immediately start calling that URL.</para></tip></para>
 
542
<para>When using a Quicknet card, you can use either an old phone plugged into the card or an headset. You will need to select Quicknet as plugin in the Audio Devices section of the preferences, select the required Audio Input Device and then indicate if you are using a POTS or a headset with your Quicknet card. If you are using a phone, simply plug its cable into the Quicknet card and you are ready to do <application>Ekiga</application>-managed calls with your phone. <tip><title>Tip</title><para>You can use the '*' sign of the keypad of your phone to replace the '.' if you want to dial IPv4 addresses. Notice also that if you want to dial complex URLs, you can associate them to speed dials in the address book, and simply dial the given speed dial followed by '#' to immediately start calling that URL.</para></tip></para>
531
543
</sect2>
532
544
 
533
545
 
534
 
<sect2 id="gnomemeeting-video-bandwidth">
 
546
<sect2 id="ekiga-video-bandwidth">
535
547
<title>To Control the Video Bandwidth</title>
536
548
 
537
 
<para><application>GnomeMeeting</application> is using a best-effort algorithm to maintain a low bandwidth when transmitting video. You can adjust the video quality between 1 and 100%, and the number of transmitted images per second in the Video Codecs section of the preferences. It will permit <application>GnomeMeeting</application> to dynamically adjust the video bandwidth and the number of transmitted images per second during a call while trying to respect the requested video bandwidth.</para>
 
549
<para><application>Ekiga</application> is using a best-effort algorithm to maintain a low bandwidth when transmitting video. You can adjust the video quality between 1 and 100%, and the number of transmitted images per second in the Video Codecs section of the preferences. It will permit <application>Ekiga</application> to dynamically adjust the video bandwidth and the number of transmitted images per second during a call while trying to respect the requested video bandwidth.</para>
538
550
 
539
 
<para>Notice that the algorithm is a best-effort algorithm, which means that if you are giving too high values for the minimum video quality and frames per seconds to transmit, it will be impossible to respect the requested video bandwidth. However, if the video bandwidth permits to transmit with a better quality, or faster than the requested values, then <application>GnomeMeeting</application> will dynamically increase them so that the quality and the framerate are always the best possible.</para>
 
551
<para>Notice that the algorithm is a best-effort algorithm, which means that if you are giving too high values for the minimum video quality and frames per seconds to transmit, it will be impossible to respect the requested video bandwidth. However, if the video bandwidth permits to transmit with a better quality, or faster than the requested values, then <application>Ekiga</application> will dynamically increase them so that the quality and the framerate are always the best possible.</para>
540
552
 
541
553
<para>Choosing a higher framerate and a lower quality will have the same result in terms of video bandwidth than choosing a higher quality with a lower framerate. It depends if you prefer using your bandwidth to transmit more lower quality images or fewer big quality images.</para>
542
554
</sect2>
543
555
 
544
556
 
545
 
<sect2 id="gnomemeeting-audio-codecs">
 
557
<sect2 id="ekiga-audio-codecs">
546
558
<title>To Manage Codecs</title>
547
559
<graphic fileref="figures/audio_codecs.png"/>
548
560
 
549
561
<para><emphasis>Audio Codecs</emphasis></para>
550
 
<para>The <application>GnomeMeeting</application> audio codecs table in the preferences permits you to change the codecs order as well as disabling the codecs you don't want to use. Each codec has strong and weak points. For example, G.711 will give the best voice quality but will use the most bandwidth while Speex-8k will give an average voice quality but requiring a very low bandwidth usage.</para>
 
562
<para>The <application>Ekiga</application> audio codecs table in the preferences permits you to change the codecs order as well as disabling the codecs you don't want to use. Each codec has strong and weak points. For example, G.711 will give the best voice quality but will use the most bandwidth while Speex-8k will give an average voice quality but requiring a very low bandwidth usage.</para>
551
563
 
552
564
<para><emphasis>Reordering the codecs</emphasis></para>
553
565
<para>When you reorder the codecs, you are reordering the local capabilities table, ie the codecs you will use for sending. You will always transmit audio using the first codec in the table that is in common with the remote user. The remote user will transmit audio using the first codec in his table that is common with you.</para>
560
572
</sect2>
561
573
 
562
574
 
563
 
<sect2 id="gnomemeeting-defining-ports">
 
575
<sect2 id="ekiga-defining-ports">
564
576
<title>To Define Ports</title>
565
577
 
566
 
<para><emphasis>Setting <application>GnomeMeeting</application> up to use Different Ports</emphasis></para>
567
 
<para>The main port listening for incoming connections in <application>GnomeMeeting</application> is port 1720, to change this port you need to load "gconf-editor". Open gconf-editor, select apps from the left hand side menu and then select gnomemeeting. Then select "ports" it should give you a list in the corresponding window to your right. Select listen_port and change it to your desired value. You can also change the UDP/RTP port range, The TCP port range and the UDP port range used to register to a gatekeeper. These are described in detail below.</para>
 
578
<para><emphasis>Setting <application>Ekiga</application> up to use Different Ports</emphasis></para>
 
579
<para>The main port listening for incoming connections in <application>Ekiga</application> is port 1720, to change this port you need to load "gconf-editor". Open gconf-editor, select apps from the left hand side menu and then select <application>Ekiga</application>. Then select "ports" it should give you a list in the corresponding window to your right. Select listen_port and change it to your desired value. You can also change the UDP/RTP port range, The TCP port range and the UDP port range used to register to a gatekeeper. These are described in detail below.</para>
568
580
 
569
581
<para><emphasis>Explanation of Port Ranges</emphasis></para>
570
582
 
571
 
    <para>1. The "listen_port" value is the port <application>GnomeMeeting</application> will listen for incoming connections on.</para>
572
 
 
573
 
    <para>2. The "rtp_port_range" value is the range of UDP ports that <application>GnomeMeeting</application> will use for RTP (audio and video communication channels). You can change the UDP port range if you are using IP translation and if you need to have several <application>GnomeMeeting</application> running behind your NAT/PAT router. <application>GnomeMeeting</application> needs to be restarted for the new values to take effect.</para>
574
 
 
575
 
    <para>3. The "tcp_port_range" value is the range of TCP ports beside the listen_port that <application>GnomeMeeting</application> will use for the H.245 channel. You can change the TCP port range if you are using IP translation and if you need to have several <application>GnomeMeeting</application> running behind your NAT/PAT router. <application>GnomeMeeting</application> needs to be restarted for the new values to take effect. This port range has no effect if both participants to the conference are using H.245 Tunneling.</para>
576
 
 
577
 
    <para>4. The "udp_port_range" value is the range of UDP ports that <application>GnomeMeeting</application> will use when registering to gatekeepers. You can change the UDP port range if you are using IP translation and if you need to have several <application>GnomeMeeting</application> running behind your NAT/PAT router. <application>GnomeMeeting</application> needs to be restarted for the new values to take effect. This port range has no effect if you are not registering to a gatekeeper.</para>
 
583
<para>1. The "listen_port" value is the port <application>Ekiga</application> will listen for incoming connections on.</para>
 
584
 
 
585
<para>2. The "rtp_port_range" value is the range of UDP ports that <application>Ekiga</application> will use for RTP (audio and video communication channels). You can change the UDP port range if you are using IP translation and if you need to have several <application>Ekiga</application> running behind your NAT/PAT router. <application>Ekiga</application> needs to be restarted for the new values to take effect.</para>
 
586
 
 
587
<para>3. The "tcp_port_range" value is the range of TCP ports beside the listen_port that <application>Ekiga</application> will use for the H.245 channel. You can change the TCP port range if you are using IP translation and if you need to have several <application>Ekiga</application> running behind your NAT/PAT router. <application>Ekiga</application> needs to be restarted for the new values to take effect. This port range has no effect if both participants to the conference are using H.245 Tunneling.</para>
 
588
 
 
589
<para>4. The "udp_port_range" value is the range of UDP ports that <application>Ekiga</application> will use when registering to gatekeepers. You can change the UDP port range if you are using IP translation and if you need to have several <application>Ekiga</application> running behind your NAT/PAT router. <application>Ekiga</application> needs to be restarted for the new values to take effect. This port range has no effect if you are not registering to a gatekeeper.</para>
578
590
</sect2>
579
591
 
580
 
<sect2 id="gnomemeeting-h323">
 
592
<sect2 id="ekiga-h323">
581
593
<title>To Control the H.323 Advanced Settings</title>
582
594
 
583
 
<para><application>GnomeMeeting</application> permits a fine control of the H.323 settings in the Advanced H.323 Settings section of the preferences. You can enable H.245 Tunneling, Early H.245 and Fast Start.</para>
 
595
<para><application>Ekiga</application> permits a fine control of the H.323 settings in the Advanced H.323 Settings section of the preferences. You can enable H.245 Tunneling, Early H.245 and Fast Start.</para>
584
596
 
585
597
<para><emphasis>H.245 Tunneling</emphasis></para>
586
598
 
598
610
</sect1>
599
611
 
600
612
 
601
 
<sect1 id="gnomemeeting-about">
602
 
  <title>About <application>GnomeMeeting</application></title>
603
 
  <para><application>GnomeMeeting</application> is written by Damien Sandras (<email>dsandras@seconix.com</email>). To find more information about <application>GnomeMeeting</application>, please visit the <ulink url="http://www.gnomemeeting.org" type="http"><application>GnomeMeeting</application> Home Page</ulink>.</para>
604
 
  
605
 
  <para>To report a bug or make a suggestion regarding this application or this manual, follow the directions in this <ulink url="ghelp:gnome-feedback" type="help">document</ulink>.</para>
606
 
  
607
 
  <para>This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found at this <ulink url="ghelp:gpl" type="help">link</ulink>, or in the file COPYING included with the source code of this program.</para>                          </sect1>
608
 
 
609
 
 
610
 
 
611
 
<sect1 id="gnomemeeting-appendix">
 
613
<sect1 id="ekiga-about">
 
614
<title>About <application>Ekiga</application></title>
 
615
<para><application>Ekiga</application> is written by Damien Sandras (<email>dsandras@seconix.com</email>). To find more information about <application>Ekiga</application>, please visit the <ulink url="http://www.ekiga.org" type="http"><application>Ekiga</application> Home Page</ulink>.</para>
 
616
 
 
617
<para>To report a bug or make a suggestion regarding this application or this manual, follow the directions in this <ulink url="ghelp:gnome-feedback" type="help">document</ulink>.</para>
 
618
 
 
619
<para>This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found at this <ulink url="ghelp:gpl" type="help">link</ulink>, or in the file COPYING included with the source code of this program.</para>                          </sect1>
 
620
 
 
621
 
 
622
 
 
623
<sect1 id="ekiga-appendix">
612
624
<title>Appendix</title>
613
625
 
614
 
<sect2 id="gnomemeeting-related">
 
626
<sect2 id="ekiga-related">
615
627
<title>Related Software</title>
616
628
 
617
629
<para><emphasis>Gatekeepers, Gateways and Proxies</emphasis></para>