<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> <HTML> <HEAD> <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21"> <TITLE>OpenH323 Gatekeeper - The GNU Gatekeeper: Introduction</TITLE> <LINK HREF="manual-2.html" REL=next> <LINK HREF="manual.html#toc1" REL=contents> </HEAD> <BODY> <A HREF="manual-2.html">Next</A> Previous <A HREF="manual.html#toc1">Contents</A> <HR> <H2><A NAME="s1">1.</A> <A HREF="manual.html#toc1">Introduction</A></H2> <H2><A NAME="ss1.1">1.1</A> <A HREF="manual.html#toc1.1">About</A> </H2> <P><B> <A HREF="http://www.gnugk.org/">OpenH323 Gatekeeper - The GNU Gatekeeper</A></B> is an open-source project that implements an H.323 gatekeeper. A gatekeeper provides call control services to the H.323 endpoints. It is an integral part of most useful internet telephony installations that are based on the H.323 standard.</P> <P>According to Recommendation H.323, a gatekeeper shall provide the following services: <UL> <LI>Address Translation</LI> <LI>Admissions Control</LI> <LI>Bandwidth Control</LI> <LI>Zone Management</LI> <LI>Call Control Signaling</LI> <LI>Call Authorization</LI> <LI>Bandwidth Management</LI> <LI>Call Management</LI> </UL> </P> <P>The GNU Gatekeeper implements most of these functions based on the <A HREF="http://sourceforge.net/projects/openh323">OpenH323</A> protocol stack.</P> <P>Recommendation H.323 is an international standard published by the <A HREF="http://www.itu.int/">ITU</A>. It is a communications standard for audio, video, and data over the Internet. See also Paul Jones' <A HREF="http://www.packetizer.com/voip/h323/papers/primer/">A Primer on the H.323 Series Standard</A>.</P> <P>For a detailed description of what a gatekeeper does, see <A HREF="http://www.iec.org/online/tutorials/h323/topic06.html">here</A>.</P> <H2><A NAME="ss1.2">1.2</A> <A HREF="manual.html#toc1.2">Copyright</A> </H2> <P>It is covered by the <A HREF="http://www.fsf.org/licensing/licenses/gpl.html">GNU General Public License</A> (GNU GPL). In addition to that, we explicitly grant the right to link this code to the OpenH323 and OpenSSL library.</P> <P>Generally speaking, the GNU GPL allows you to copy, distribute, resell or modify the software, but it requires that all derived works must be published under GNU GPL also. That means that you must publish full source for all extensions to the gatekeeper and for all programs you include the gatekeeper into. See the file COPYING for details.</P> <P>If that's not what you want, you must interface to the gatekeeper through the status port and communicate via TCP with it. That way you only have to integrate the basic functionality into the gatekeeper (and provide source for that) and can keep other parts of your application private.</P> <H2><A NAME="ss1.3">1.3</A> <A HREF="manual.html#toc1.3">Name</A> </H2> <P>The formal name of this project is <EM>OpenH323 Gatekeeper - The GNU Gatekeeper</EM>, short <EM>GnuGk</EM>. Please don't confuse it with other gatekeeper projects.</P> <P>There are several open-source gatekeeper projects based on the OpenH323 protocol stack. <UL> <LI> <A HREF="http://opengatekeeper.sourceforge.net/">OpenGatekeeper</A> <BLOCKQUOTE> A gatekeeper available under MPL. The project has been inactive for a period of time now. </BLOCKQUOTE> </LI> <LI> <A HREF="http://sourceforge.net/projects/openh323">OpenGK</A> <BLOCKQUOTE> Only in a very primary grades. </BLOCKQUOTE> </LI> <LI> <A HREF="http://www.gnugk.org/">OpenH323 Gatekeeper - The GNU Gatekeeper</A> <BLOCKQUOTE> This one, also called GnuGk. </BLOCKQUOTE> </LI> </UL> </P> <P>To have different gatekeepers with very similar names is really confusing for most users. Since our "OpenH323 Gatekeeper" was the first on the scene, it is not our fault that others have chosen similar names. But to make the distinction a little more clear without confusing people even more, we have decided to give the project a subtitle "OpenH323 Gatekeeper - The GNU Gatekeeper" and start using <CODE>gnugk</CODE> as name for executables.</P> <H2><A NAME="download"></A> <A NAME="ss1.4">1.4</A> <A HREF="manual.html#toc1.4">Download</A> </H2> <P>The newest stable and a development version are available at <A HREF="http://www.gnugk.org/h323download.html">the download page</A>.</P> <P>The very latest source code is in the CVS at <A HREF="http://openh323gk.cvs.sourceforge.net/openh323gk/openh323gk/">Sourceforge Web-GUI</A>. Beware - that's the bleeding edge.</P> <P>You can also download some executables from <A HREF="http://www.gnugk.org/h323download.html">the download page</A>.</P> <H2><A NAME="ss1.5">1.5</A> <A HREF="manual.html#toc1.5">Mailing Lists</A> </H2> <P>There are two mailing list for the project, one for the developers and one for the users.</P> <P>General user questions should be send to the <A HREF="mailto:Openh323gk-users@sourceforge.net">users mailing list</A>. You can find the list archive <A HREF="https://sourceforge.net/mailarchive/forum.php?forum_id=8549">here</A>. To join this mailing list, click <A HREF="https://lists.sourceforge.net/lists/listinfo/openh323gk-users">here</A>.</P> <P>To report problems or submit bugs/patches, send mails to the <A HREF="mailto:Openh323gk-developer@sourceforge.net">developers mailing list</A>. The list archive is <A HREF="http://sourceforge.net/mailarchive/forum.php?forum_id=3079">here</A>. Please send user questions to the users mailing list and keep this list to development! If you want to contribute to the project, please <A HREF="http://lists.sourceforge.net/lists/listinfo/openh323gk-developer">join the mailing list</A>.</P> <P><B>Note</B>: Please don't send your questions as private emails to individual developer. We are usually busy. We would <B>not</B> like to be your private consultant, unless you'd like to pay us. Send your problems to the appropriate public mailing list so everybody can help you.</P> <P>Also please don't send the GnuGk specific problems to the OpenH323 mailing list, or vice verse. They are different projects, though closely related.</P> <P>Before you sending an email, make sure you have read the related documents carefully. Describe your problems clearly and precisely. Show us the error messages or logs if there is any.</P> <H2><A NAME="ss1.6">1.6</A> <A HREF="manual.html#toc1.6">Contributors</A> </H2> <P>The current project coordinator is <A HREF="http://www.willamowius.de/">Jan Willamowius</A> <CODE> <A HREF="mailto:jan@willamowius.de"><jan@willamowius.de></A></CODE></P> <P>The main features and functions of version 2.0 are contributed by Chih-Wei Huang <CODE> <A HREF="mailto:cwhuang@linux.org.tw"><cwhuang@linux.org.tw></A></CODE> and <A HREF="http://www.citron.com.tw/">Citron Network Inc.</A>, including thread-safe registration and call tables, new routed mode architecture, H.323 proxy, H.235 authentication and MySQL backend.</P> <P>Michal Zygmuntowicz <CODE> <A HREF="mailto:m.zygmuntowicz@onet.pl"><m.zygmuntowicz@onet.pl></A></CODE> has done some great work on Radius support and other improvements.</P> <P>The initial version of the gatekeeper has been developed by Xiang Ping Chen, Joe Metzger and Rajat Todi.</P> <HR> <A HREF="manual-2.html">Next</A> Previous <A HREF="manual.html#toc1">Contents</A> </BODY> </HTML>