

 H.323 support for ASTERISK soft PBX
-------------------------------------

 The source files and the procedure described below
 incorporate OpenH323 support into the ASTERISK
 software PBX.

 This distribution is broken down into two components:

  1: "wrapper" (a library)
  2: "asterisk-driver" (a ASTERISK channel driver)

 In order to build the ASTERISK PBX with OpenH323
 support, you will need some source packages. These
 are the following:

  o PWlib (Portable Text and GUI C/C++ Class Library)
    download from http://www.openh323.org. (v1.5.0)
    (required)

  o OpenH323 (Class Library implementing the H.323 protocol)
    download from http://www.openh323.org (v1.12.0)
    (required)

  o Asterisk PBX (Open Source Linux PBX)
    download from http://www.asteriskpbx.com (latest CVS version)
    (required)

  o OhPhone (Command line H.323 client)
    download from http://www.openh323.org (v1.3.7)
    (optional, used for testing)

  o OpenH323 Gatekeeper (H.323 Gatekeeper)
    download from http://www.gnugk.org (v2.0.5)
    (optional, used for testing)
	Although the usage of a gatekeeper is optional, it is
	recommended for easier address translation.

 This software has been developed and tested with the 
 aforementioned versions of the above packages. Using other versions
 may break things, so try these versions first.

 Download
----------

 Since this software is still under development, you should
 always check that you use the latest version. This can
 be downloaded from:

   http://www.inaccessnetworks.com/projects/asterisk-oh323

 
 Compiling
-----------

 First of all you must download and install the above REQUIRED
 packages. Then, edit "Makefile" inside the "asterisk-oh323"
 directory and set the paths/options according to your system. 

 Type "make" to build the oh323wrap library and the 
 ASTERISK oh323 channel driver.

 Type "make install" to install the binaries. This will also
 install a sample configuration file, if there isn't one.

 Next, add to your LD_LIBRARY_PATH the path where the oh323wrap
 library was installed (or edit your /etc/ld.so.conf file, add
 the library path, and run "ldconfig").

 Then, you would like to edit the driver's configuration
 file (see below).

 Finally, run "asterisk" and try it with a H.323 IP phone
 like "ohphone" from OpenH323 site or Netmeeting. See also
 the file "TESTS" for detailed configuration and setup.


 Configuration of OpenH323 channel driver
------------------------------------------

 Configuration info can be found in file "CONFIGURATION".


 Console commands
------------------

 The following commands are supported from within the ASTERISK's
 console:

 "oh323 show stats" - Displays statistics for the OpenH323 channel
                      driver (incoming calls, outgoing calls,
					  dropped calls, blocked calls, call errors, ...)

 "oh323 show info" - Displays information about all active H.323 calls
                     (state, direction, format, ...)

 "oh323 show conf" - Displays configuration information about the
                     OpenH323 channel driver.

 "oh323 debug toggle" - Toggle OpenH323 channel driver's internal debug
                        flag on/off (very verbose!).


 Licensing
-----------

 "H323 support for ASTERISK" copyright (c) 2002,2003 InAccess Networks 

 "H323 support for ASTERISK" is free software;
 you can redistribute it and/or modify it 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. 

 "H323 support for ASTERISK" is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty
 of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 See the GNU General Public License for more details. 

 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. 

 In addition, specific permission is granted to OpenSSL, OpenH323 and PWLib
 libraries to link to the wrapper library and the channel driver
 of this software.


 Credits
---------

 Thanks to the following people for providing help with regard to 
 this software:
  - Mark Spencer for providing Asterisk (of course) and for several 
    suggestions and improvements,
  - Oliver Daudey for some bug fixes,
  - Lubomir Christov for extensive testing,
  - Pawel Golaszewski for minor additions in the make process


Enjoy,

Michalis Manousos
Dimitris S. Economou

inAccess Networks S.A.
www.inaccessnetworks.com


