channels/h323/README

   1                 Open H.323 Channel Driver for Asterisk
   2                         By Jeremy McNamara
   3                         For The NuFone Network
   4
   5              First public release on November 10th, 2002
   6
   7
   8         Developed using:        RedHat 7.2/7.3/8.0
   9                                 Open H.323 v1.11.7
  10                                 PWLib      v1.4.11
  11                                 GCC       2.96/3.1
  12
  13         Dependancies:           openssl-0.9.6b
  14                                 openssl-devel-0.9.6b
  15                                 expat-1.95
  16                                 expat-dev-1.95
  17
  18 We have implemented this driver using Asterisk's RTP stack insted of trying
  19 to implement a pseudo sound card driver.
  20
  21 NOTICE: Whatever you do, DO NOT USE distrubution specific installs
  22 of Open H.323 and PWLib. In fact you should check to make sure
  23 your distro didn't install them for you without your knowledge.
  24 Check everything out of CVS. If you dont know how to deal with cvs, learn.
  25 Also, if you are not using the listed versions of Open H.323 or PWlib
  26 you are on your own, sorry.
  27
  28 Warning: Older versions than listed will NOT work, but newer  versions
  29 ~should~ work but are untested and you would be on your own.
  30
  31 As of June 16th, 2003 the release version of Open H.323 does not compile
  32 due to the G729Capability is missing. If you want G.729 support see
  33 the Makefile.
  34
  35 Some chan_h323 users have reported success and others have reported dramatic
  36 failures when using newer versions of Open H.323. We haven't personally tested
  37 this and will not be able to assist you if you have 'issues'. Sorry.
  38
  39 IN OTHER WORDS: Run Open H.323 v1.11.7 nothing newer nothing older if u want
  40 this to work.
  41
  42
  43
  44 Most common compile error:
  45
  46 If you receive anything that says 'undefined symbol' you are experiencing
  47 typical version skew.  For example:
  48
  49 libh323_linux_x86_r.so.1: undefined symbol: GetNumberValueAt__C14PAbstractArrayi
  50
  51 You need to search and destroy every version of libh323 and libpt then
  52 completely recompile everything
  53
  54 Example commands to make sure everything gets cleaned and then
  55 rebult in proper order:
  56
  57 cd /path/to/pwlib
  58 make clean opt
  59 cd /path/to/openh323
  60 make clean opt
  61 cd asterisk/channels/h323
  62 make clean install
  63
  64 (Note: Open H.323 or PWLib never get a 'make install' so don't do it)
  65
  66
  67 Most common run-time error:
  68
  69 libpt_linux_x86_r.so.1: cannot open shared object file: No such
  70 file or directory
  71
  72 You have not set the LD_LIBRARY_PATH environment variable.
  73
  74 Example environment for sh/bash:
  75
  76 PWLIBDIR=$HOME/pwlib
  77 export PWLIBDIR
  78 OPENH323DIR=$HOME/openh323
  79 export OPENH323DIR
  80 LD_LIBRARY_PATH=$PWLIBDIR/lib:$OPENH323DIR/lib
  81 export LD_LIBRARY_PATH
  82
  83 We recomend puting the above directives into your /etc/profile so
  84 you do not have to remember to export those values every time you
  85 want to recompile.
  86
  87
  88 If you still have trouble please contact 'JerJer' in #Asterisk on
  89 irc.freenode.net or send and email to jj@nufone.net
  90
  91 If you happen to be lucky enough to segfault this code please run a
  92 backtrace  and send me the gory details. Segmentation faults are not
  93 tolerated, no matter what Distro you run!
  94
  95 bt example:
  96
  97 # /usr/sbin/asterisk -vvvgc
  98 ...
  99 [chan_h323.so]
 100 Segmentation Fault (core dumped)
 101
 102 # ls core.*
 103 core.1976
 104
 105 # gdb /usr/sbin/asterisk core.1976
 106 ...lots of useless garbage here..
 107 (gdb) bt
 108
 109 Send whatever shows up right after the 'bt'
 110
 111
 112 Also, a full debug screen output is almost needed. Make sure you are
 113 in the full console mode (-c) and turn on 'h.323  debug'. A nice way
 114 to capture everything is to use the utility called 'script' (man script)
 115
 116
 117
 118 Jeremy McNamara
 119 Chief Cook and Bottle Washer
 120 The NuFone Network