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">
4
<!ENTITY appversion "2.00">
5
<!ENTITY manrevision "2.00">
8
8
<article id="index" lang="uk">
10
<title><application>GnomeMeeting</application> Manual 1.2</title>
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:
19
<holder>ME-THE-TRANSLATOR (Latin translation)</holder>
26
<revnumber>GnomeMeeting Manual 1.0</revnumber>
27
<date>2004-02-19</date>
29
<para role="author">Christopher Warner</para>
35
<publishername>Christopher Warner</publishername>
36
<address><email>zanee@kernelcode.com</email></address>
39
<publishername>Damien Sandras</publishername>
40
<address><email>dsandras@seconix.com</email></address>
43
<publishername>Matthias Redlich</publishername>
44
<address><email>m-redlich@t-online.de</email></address>
48
<author role="maintainer">
49
<firstname>Christopher</firstname>
50
<surname>Warner</surname>
51
<othername>zanee</othername>
54
<firstname>Matthias</firstname>
55
<surname>Redlich</surname>
58
<firstname>Damien</firstname>
59
<surname>Sandras</surname>
63
<releaseinfo>This documentation is for version 1.2 of GnomeMeeting.</releaseinfo>
65
<abstract role="description">
66
<para>User manual for the GnomeMeeting videoconferencing, IP Telephony and VoIP application</para>
10
<title><application>Ekiga</application> Manual 2.00</title>
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:
19
<holder>ME-THE-TRANSLATOR (Latin translation)</holder>
26
<revnumber>Ekiga Manual 2.0</revnumber>
27
<date>2006-01-22</date>
29
<para role="author">Damien Sandras</para>
35
<publishername>Damien Sandras</publishername>
36
<address><email>dsandras@seconix.com</email></address>
39
<publishername>Christopher Warner</publishername>
40
<address><email>zanee@kernelcode.com</email></address>
43
<publishername>Matthias Redlich</publishername>
44
<address><email>m-redlich@t-online.de</email></address>
49
<firstname>Damien</firstname>
50
<surname>Sandras</surname>
52
<author role="maintainer">
53
<firstname>Christopher</firstname>
54
<surname>Warner</surname>
55
<othername>zanee</othername>
58
<firstname>Matthias</firstname>
59
<surname>Redlich</surname>
63
<releaseinfo>This documentation is for version 2.00 of Ekiga.</releaseinfo>
65
<abstract role="description">
66
<para>User manual for the Ekiga Voice over IP, IP Telephony and Video-Conferencing application</para>
70
70
<indexterm zone="index">
71
<primary>GnomeMeeting</primary>
73
<indexterm zone="index">
74
<primary>gnomemeeting</primary>
76
<indexterm zone="index">
77
<primary>Gnomemeeting</primary>
71
<primary>Ekiga</primary>
73
<indexterm zone="index">
74
<primary>Ekiga</primary>
76
<indexterm zone="index">
77
<primary>Ekiga</primary>
80
80
<!-- INTODUCTION -->
81
81
<!-- What is &app; -->
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>
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>
89
<graphic fileref="figures/lumi.png"/>
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>
97
<tip><title>Tip</title><para>All settings can be changed via the preferences window at anytime.</para></tip>
101
<graphic fileref="figures/config_d1.png"/>
103
<para><emphasis>Configuration Assistant Introduction</emphasis></para>
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>
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>
112
<graphic fileref="figures/config_d2.png"/>
115
<para><emphasis>Personal information</emphasis></para>
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>
121
<graphic fileref="figures/config_d3.png"/>
124
<para><emphasis>Callto URL</emphasis></para>
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>
131
<graphic fileref="figures/config_d4.png"/>
134
<para><emphasis>Connection Type</emphasis></para>
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>
140
<graphic fileref="figures/config_d5.png"/>
143
<para><emphasis>NAT Type</emphasis></para>
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>
149
<graphic fileref="figures/config_d6.png"/>
152
<para><emphasis>Audio Manager</emphasis></para>
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>
159
<graphic fileref="figures/config_d7.png"/>
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>
167
<graphic fileref="figures/config_d8.png"/>
170
<para><emphasis>Video Manager</emphasis></para>
172
<para>Please select the Video Manager from the list. It can be Video4Linux to manage webcams, or AVC / DC for Firewire cameras.</para>
177
<graphic fileref="figures/config_d9.png"/>
180
<para><emphasis>Video Devices</emphasis></para>
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>
184
<para>If you have a webcam or video device in the list you may select it here.</para>
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>
191
<graphic fileref="figures/config_d10.png"/>
193
<para><emphasis>Configuration Complete</emphasis></para>
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>
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>
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>
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>
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>
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>
95
<graphic fileref="figures/lumi.png"/>
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>
103
<tip><title>Tip</title><para>All settings can be changed via the preferences window at anytime.</para></tip>
107
<graphic fileref="figures/config_d1.png"/>
109
<para><emphasis>Configuration Assistant Introduction</emphasis></para>
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>
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>
118
<graphic fileref="figures/config_d2.png"/>
121
<para><emphasis>Personal information</emphasis></para>
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>
127
<graphic fileref="figures/config_d3.png"/>
130
<para><emphasis>ekiga.net Account</emphasis></para>
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>
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>
139
<graphic fileref="figures/config_d4.png"/>
142
<para><emphasis>Connection Type</emphasis></para>
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>
149
<graphic fileref="figures/config_d5.png"/>
152
<para><emphasis>NAT Type</emphasis></para>
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>
159
<graphic fileref="figures/config_d6.png"/>
162
<para><emphasis>Audio Manager</emphasis></para>
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>
169
<graphic fileref="figures/config_d7.png"/>
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>
178
<graphic fileref="figures/config_d8.png"/>
181
<para><emphasis>Video Manager</emphasis></para>
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>
188
<graphic fileref="figures/config_d9.png"/>
191
<para><emphasis>Video Devices</emphasis></para>
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>
195
<para>If you have a webcam or video device in the list you may select it here.</para>
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>
202
<graphic fileref="figures/config_d10.png"/>
204
<para><emphasis>Configuration Complete</emphasis></para>
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>
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>
213
<sect1 id="ekiga-basic-usage">
202
214
<title>Basic Usage</title>
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>
207
219
<graphic fileref="figures/call_d1.png"/>
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>
211
223
<para><emphasis>H.323 URL's</emphasis></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>
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>
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>
417
429
<para><emphasis>Basics of the Address Book</emphasis></para>
418
<para>To open the Address Book select Tools -> 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>
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>
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>
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>
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>
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 -> 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>
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>
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>
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>
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>
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>
430
442
<para><emphasis>Managing servers, groups and contacts</emphasis></para>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
450
462
<para><emphasis>Busy mode</emphasis></para>
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>
454
466
<para>This mode can be enabled by selecting Call -> Busy in the main window.</para>
456
468
<para><emphasis>Free for Chat mode</emphasis></para>
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>
460
472
<para>This mode can be enabled by selecting Call -> Free For Chat in the main window menu.</para>
462
474
<para><emphasis>Forward</emphasis></para>
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>
466
478
<para>Call Forwarding can be configured by selecting Call -> 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 -> 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>
471
<sect1 id="gnomemeeting-advanced-usage">
483
<sect1 id="ekiga-advanced-usage">
472
484
<title>Advanced Usage</title>
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>
520
532
<para><emphasis>Doing calls using a gateway</emphasis></para>
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>
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>
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>
534
<sect2 id="gnomemeeting-video-bandwidth">
546
<sect2 id="ekiga-video-bandwidth">
535
547
<title>To Control the Video Bandwidth</title>
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>
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>
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>
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"/>
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>
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>