SipInstallation

Version 51 (Adrian Georgescu, 03/24/2009 09:52 am)

1 1 Adrian Georgescu
= Installation guide =
2 20 Adrian Georgescu
3 22 Adrian Georgescu
[[TOC(WikiStart, Sip*, depth=3)]]
4 1 Adrian Georgescu
 
5 23 Adrian Georgescu
== Supported platforms ==
6 23 Adrian Georgescu
7 33 Adrian Georgescu
Currently i386, amd64 and ppc architectures have been tested and are fully supported on the following operating systems:
8 23 Adrian Georgescu
9 28 Adrian Georgescu
 * Linux
10 28 Adrian Georgescu
 * MacOSX
11 28 Adrian Georgescu
 * FreeBSD
12 23 Adrian Georgescu
13 49 Adrian Georgescu
Porting to other operating systems (like Windows, Symbian and iPhone) is possible as the Python environment and [http://www.pjsip.org/sip_media_features.htm#platforms PJSIP] are supported by these platform.
14 1 Adrian Georgescu
15 50 Adrian Georgescu
== Debian package ==
16 37 Adrian Georgescu
17 50 Adrian Georgescu
For people running Debian 5.0 or Ubuntu 8.10 a debian package with the stable version is available in the public repository provided by AG Projects. To install the debian package  add these lines in /etc/apt/sources.list
18 37 Adrian Georgescu
19 37 Adrian Georgescu
{{{
20 37 Adrian Georgescu
# AG Projects software
21 37 Adrian Georgescu
deb     http://ag-projects.com/debian unstable main
22 37 Adrian Georgescu
deb-src http://ag-projects.com/debian unstable main
23 37 Adrian Georgescu
}}}
24 37 Adrian Georgescu
25 37 Adrian Georgescu
Install the AG Projects debian software signing key:
26 37 Adrian Georgescu
27 37 Adrian Georgescu
{{{
28 37 Adrian Georgescu
wget http://download.ag-projects.com/agp-debian-gpg.key
29 37 Adrian Georgescu
apt-key add agp-debian-gpg.key
30 37 Adrian Georgescu
}}}
31 37 Adrian Georgescu
32 37 Adrian Georgescu
After that, run:
33 37 Adrian Georgescu
34 37 Adrian Georgescu
{{{
35 1 Adrian Georgescu
apt-get update
36 1 Adrian Georgescu
apt-get install sipclient
37 1 Adrian Georgescu
}}}
38 49 Adrian Georgescu
39 51 Adrian Georgescu
== Tar archive ==
40 49 Adrian Georgescu
41 49 Adrian Georgescu
A tar archive with the current stable version is available at:
42 49 Adrian Georgescu
43 49 Adrian Georgescu
http://download.ag-projects.com/SipClient/
44 37 Adrian Georgescu
45 37 Adrian Georgescu
46 38 Adrian Georgescu
== Development version ==
47 1 Adrian Georgescu
48 35 Adrian Georgescu
The source code is managed using [http://darcs.net darcs] version control tool. The darcs repository can be fetched with:
49 1 Adrian Georgescu
50 1 Adrian Georgescu
{{{
51 14 Adrian Georgescu
darcs get http://devel.ag-projects.com/repositories/python-sipsimple
52 1 Adrian Georgescu
}}}
53 1 Adrian Georgescu
54 1 Adrian Georgescu
To obtain the incremental changes after the initial get, go to the sipsimpleclient directory and run:
55 1 Adrian Georgescu
56 1 Adrian Georgescu
{{{
57 14 Adrian Georgescu
cd python-sipsimple
58 1 Adrian Georgescu
darcs pull
59 1 Adrian Georgescu
}}}
60 1 Adrian Georgescu
61 25 Adrian Georgescu
== Building instructions ==
62 1 Adrian Georgescu
63 1 Adrian Georgescu
Building instructions for the corresponding platforms are available at:
64 1 Adrian Georgescu
65 1 Adrian Georgescu
 * [source:docs/INSTALL.linux INSTALL.linux]
66 1 Adrian Georgescu
 * [source:docs/INSTALL.osx INSTALL.osx]
67 1 Adrian Georgescu
 * [source:docs/INSTALL.freebsd INSTALL.freebsd]
68 17 Adrian Georgescu
69 45 Adrian Georgescu
The build process can be fine-tuned for various options (like for using a specific version of underlying pjsip library):
70 45 Adrian Georgescu
71 45 Adrian Georgescu
{{{
72 45 Adrian Georgescu
adigeo@ag-imac3:python setup.py build_ext --help
73 45 Adrian Georgescu
Common commands: (see '--help-commands' for more)
74 45 Adrian Georgescu
75 45 Adrian Georgescu
  setup.py build      will build the package underneath 'build/'
76 45 Adrian Georgescu
  setup.py install    will install the package
77 45 Adrian Georgescu
78 45 Adrian Georgescu
Global options:
79 45 Adrian Georgescu
  --verbose (-v)  run verbosely (default)
80 45 Adrian Georgescu
  --quiet (-q)    run quietly (turns verbosity off)
81 45 Adrian Georgescu
  --dry-run (-n)  don't actually do anything
82 45 Adrian Georgescu
  --help (-h)     show detailed help message
83 45 Adrian Georgescu
84 45 Adrian Georgescu
Options for 'PJSIP_build_ext' command:
85 45 Adrian Georgescu
  --build-lib (-b)        directory for compiled extension modules
86 45 Adrian Georgescu
  --build-temp (-t)       directory for temporary files (build by-products)
87 45 Adrian Georgescu
  --inplace (-i)          ignore build-lib and put compiled extensions into
88 45 Adrian Georgescu
                          the source directory alongside your pure Python
89 45 Adrian Georgescu
                          modules
90 45 Adrian Georgescu
  --include-dirs (-I)     list of directories to search for header files
91 45 Adrian Georgescu
                          (separated by ':')
92 45 Adrian Georgescu
  --define (-D)           C preprocessor macros to define
93 45 Adrian Georgescu
  --undef (-U)            C preprocessor macros to undefine
94 45 Adrian Georgescu
  --libraries (-l)        external C libraries to link with
95 45 Adrian Georgescu
  --library-dirs (-L)     directories to search for external C libraries
96 45 Adrian Georgescu
                          (separated by ':')
97 45 Adrian Georgescu
  --rpath (-R)            directories to search for shared C libraries at
98 45 Adrian Georgescu
                          runtime
99 45 Adrian Georgescu
  --link-objects (-O)     extra explicit link objects to include in the link
100 45 Adrian Georgescu
  --debug (-g)            compile/link with debugging information
101 45 Adrian Georgescu
  --force (-f)            forcibly build everything (ignore file timestamps)
102 45 Adrian Georgescu
  --compiler (-c)         specify the compiler type
103 45 Adrian Georgescu
  --swig-cpp              make SWIG create C++ files (default is C)
104 45 Adrian Georgescu
  --swig-opts             list of SWIG command line options
105 45 Adrian Georgescu
  --swig                  path to the SWIG executable
106 45 Adrian Georgescu
  --pyrex-cplus           generate C++ source files
107 45 Adrian Georgescu
  --pyrex-create-listing  write errors to a listing file
108 45 Adrian Georgescu
  --pyrex-include-dirs    path to the Cython include files (separated by ':')
109 45 Adrian Georgescu
  --pyrex-c-in-temp       put generated C files in temp directory
110 45 Adrian Georgescu
  --pyrex-gen-pxi         generate .pxi file for public declarations
111 45 Adrian Georgescu
  --pjsip-svn-repo        PJSIP SVN repository to checkout from
112 45 Adrian Georgescu
  --pjsip-svn-revision    PJSIP SVN revision to fetch
113 45 Adrian Georgescu
  --pjsip-clean-compile   Clean PJSIP tree before compilation
114 45 Adrian Georgescu
  --help-compiler         list available compilers
115 45 Adrian Georgescu
116 45 Adrian Georgescu
}}}
117 45 Adrian Georgescu
118 45 Adrian Georgescu
119 19 Adrian Georgescu
== Upgrade instructions ==
120 15 Adrian Georgescu
121 15 Adrian Georgescu
 * [browser:docs/Upgrade.txt Upgrade guide]
122 1 Adrian Georgescu
123 26 Adrian Georgescu
== How to un-install ==
124 15 Adrian Georgescu
125 15 Adrian Georgescu
 * [browser:docs/UnINSTALL.txt Uninstall guide]