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. Older versions will NOT work, but newer
  27 versions ~should~ work.
  28
  29
  30 Most common compile error:
  31
  32 If you receive anything that says 'undefined symbol' you are experiencing
  33 typical version skew.  For example:
  34
  35 libh323_linux_x86_r.so.1: undefined symbol: GetNumberValueAt__C14PAbstractArrayi
  36
  37 You need to search and destroy every version of libh323 and libpt then
  38 completely recompile everything
  39
  40 Example commands to make sure everything gets cleaned and then
  41 rebult in proper order:
  42
  43 cd /path/to/pwlib
  44 make clean opt
  45 cd /path/to/openh323
  46 make clean opt
  47 cd asterisk/channels/h323
  48 make clean install
  49
  50 (Note: Open H.323 or PWLib never get a 'make install')
  51
  52
  53 Most common run-time error:
  54
  55 libpt_linux_x86_r.so.1: cannot open shared object file: No such
  56 file or directory
  57
  58 You have not set the LD_LIBRARY_PATH environment variable.
  59
  60 Example environment for sh/bash:
  61
  62 PWLIBDIR=$HOME/pwlib
  63 export PWLIBDIR
  64 OPENH323DIR=$HOME/openh323
  65 export OPENH323DIR
  66 LD_LIBRARY_PATH=$PWLIBDIR/lib:$OPENH323DIR/lib
  67 export LD_LIBRARY_PATH
  68
  69 We recomend puting the above directives into your /etc/profile so
  70 you do not have to remember to export those values every time you
  71 want to recompile.
  72
  73
  74 If you still have trouble please contact 'JerJer' in #Asterisk on
  75 irc.freenode.net or send and email to jj@indie.org
  76
  77 If you happen to be lucky enough to segfault this code please run a
  78 backtrace  and send me the gory details. Segmentation faults are not
  79  tolerated!
  80
  81 bt example:
  82
  83 # /usr/sbin/asterisk -vvvgc
  84 ...
  85 [chan_h323.so]
  86 Segmentation Fault (core dumped)
  87
  88 # ls core.*
  89 core.1976
  90
  91 # gdb /usr/sbin/asterisk core.1976
  92 ...
  93 (gdb) bt
  94
  95 Send whatever shows up right after the 'bt'
  96
  97
  98 Also, a full debug screen output is almost needed. Make sure you are
  99 in the full console mode (-c) and turn on 'h.323  debug'. A nice way
 100 to capture everything is to use the utility called 'script' (man script)
 101
 102
 103 Jeremy McNamara, President
 104 The NuFone Network