OpenH323 For Linux

OpenH323 is a project that provides fully featured, interoperable, Open Source implementation of the ITU H.323 teleconferencing protocol. It can be used by personal developers and commercial users without charge.

Requirements:

� GNU make (>=3.75) � bison (>=1.25) � flex (>=2.5.4)

INSTALLATION:

1. Download the pwlib_min_x.xx.tar.gz and openh323_1.xx.tar.gz files.

2. Extract the pwlib_min_x.xx.tar.gz somewhere, preferably in your home directory, eg: cd tar -xzvf pwlib_min_1.14.tar.gz

This should result in a ./pwlib directory tree.

3. If you have not installed PWLib in your home directory (~/pwlib) then you will have to define the environment variable PWLIBDIR to point to the correct directory. Also make sure you have added the $PWLIBDIR/lib directory to your LD_LIBRARY_PATH environment variable if you intend to use shared libraries (the default under Linux). There are examples for sh/bash and csh/tcsh.

4. Build the debug and release versions of the PWLib library as follows: cd $PWLIBDIR make both

This may take some time.

WARNING: there is a bug in most of the bison.simple files. If you are getting huge numbers of errors from make then you are probably not using the GNU make. FreeBSD and OpenBSD users must install gmake and use gmake instead of make in these instructions. If the errors are during the compile, then it is likely your platform is not supported, or you have incorrectly set the OSTYPE and MACHTYPE variables. There will be a large warning printed about this, don't ignore it!

5. Extract the contents of the openh323_x.x.tar.gz file somewhere, eg: cd tar -xzvf openh323_1.1alpha1.tar.gz

6. If you have not installed OpenH323 in your home directory (~/openh323) then you will have to define the environment variable OPENH323DIR to point to the correct directory. Also make sure you have added the $OPENH323DIR/lib directory to your LD_LIBRARY_PATH environment variable if you intend to use shared libraries (the default under Linux). There are examples for sh/bash and csh/tcsh.

7. Build the H323 bootstrap code. This will automatically build the ASN compiler (in the $PWLIBDIR/tools/asnparser directory), though this should have already been built previously. Enter:

cd $OPENH323DIR make opt

This may take some time, especially with the h245_*.cxx and h225.cxx files. You may also need to add more swap space - 64M of real memory and 64M of swap might just be enough, if your machine does nothing else! Some people have reported needing as much as 128M of swap - if your compiler bombs out with a "virtual memory exhausted" error compiling h245_*.cxx and h225.cxx, then increase your swap space.

8. The result should be an executable called simph323, which will be built in a directory dependent on the platform, eg obj_linux_x86_d. To run it, use the following command:

./samples/simple/obj_linux_x86_r/simph323

and you should get the usage help text.

9. Now you're on your own!