Building the OpenH323 Bootstrap Code

Building the OpenH323 Code

Mailing list
How to join
Archive

Mirrors
   Primary site
   Australia #1
   Australia #2
   US #1
   US #2
   Russia
   Germany
   Austria

Other Sites
   Voxilla.org
   OpenSource.org
   openphone.org
   LinuxTelephony
   SpeakFreely.org

This page describes how to compile the OpenH323 code release. Note these instructions will always refer to the latest snapshot available on the download page.

Normally, the OpenH323 source will have been compiled and tested under Linux x86, and Windows NT. However, it should also compile on Windows 95/98, BeOS (thanks !), Linux PPC, FreeBSD x86 and Solaris Sparc & x86. Note that not all of these platforms may have ports of the sound interface.

We are also happy to port it to other Unix flavours providing people out there can provide an account and a fair bit of disk space!

These instructions should contain all of the steps need. If you have a problem, please double check that you have performed ALL of the steps below, particularly setting the include file paths under MSVC.

If you get a lot of compile or link errors, then the chances are that you have missed something in the list. If you are positive that something is wrong and you have followed the instructions, then send an e-mail to the , and we'll answer it for everyone to see.

Instructions for Windows
Instructions for Unix

Windows

1.	Download the `pwlib_1.xx.zip` and `openh323_1.x.zip` files from the OpenH323 download page.
2.	Extract the `pwlib_1.xx.zip` file somewhere eg c:\, making sure the directory structure is preserved.
3.	Start MSVC (v5 or v6). If you have another compiler you are on your own! Go into the Tools menu, Options item, Directories tab and add to the Include files path (note the order is important!): `C:\PWLib\Include\PwLib\MSWIN C:\PWLib\Include\PtLib\MSOS C:\PWLib\Include` and add to the Lib Files path and the Executable Files path the following: `C:\PWLib\Lib` Also make sure this directory is in your PATH environment variable.
4.	Note you will need `bison` and `flex` to compile the system. You can get a copy from here, follow the instructions included in that package for setting it up and put the executables (`bison.exe` and `flex.exe`) somewhere in your path.
5.	Open the `pwlib.dsw` file in the pwlib top directory.
6.	Use the Batch Build command and build the "ASNParser - Win32 Release", "pwtest - Win32 Release" and "pwtest - Win32 Debug" targets. make sure all other targets are not checked.
7.	Extract the contents of the `openh323_1.x.zip` file somewhere.
8.	Use the `OpenH323.dsw` file to build the voxilla and/or openphone code.
9.	Run the program, and you are on your own!

Unix

1.	Download the `pwlib_min_1.xx.tar.gz` and `openh323_0.xx.tar.gz` files from the OpenH323 download page.
2.	Extract the `pwlib_min_1.xx.tar.gz` somewhere, preferably in your home directory, eg: `cd tar -xzvf ~/pwlib_min_1.02.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).
4.	Build the debug and release versions of the PWLib library as follows: `cd $(PWLIBDIR)/pwlib make both` This may take some time. Note, you will need GNU `make` (>=3.75)`, bison`(>=1.25) and `flex` (>=2.5.4) for this to compile, most Unix systems have these packages. *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. 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_1.x.tar.gz` file somewhere, eg: `cd tar -xzvf openh323_1.0alpha1.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).
7.	Build the H323 bootstrap code. This will automatically build the ASN compiler (in the `$PWLIBDIR/pwlib/tools/asnparser` directory), though this should have already been built previously. Enter: `cd $(OPENH323DIR)/openh323 make opt` This may take some time, especially with the h225_.cxx and h245.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 h225_*.cxx and h245.cxx, then increase your swap space.
8.	The result should be an executable called `voxilla`, which will be located in a directory dependent on the platform, eg `test/obj_linux_x86_d`. To run it, use the following command: `./test/obj_linux_x86_r/voxilla` and you should get the usage help text.
9.	Now you're on your own!

Top

Maintained by
Logo and site design by jip
Last Modified: 16 Feb 2000 11:04