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