SipInstallation

Version 63 (Adrian Georgescu, 04/16/2009 09:55 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 63 Adrian Georgescu
 * [wiki:InstallFreeBSD FreeBSD]
12 23 Adrian Georgescu
13 54 Adrian Georgescu
Porting to other operating systems (like Windows, Symbian and iPhone) is possible as the Python environment and PJSIP are supported by [http://www.pjsip.org/sip_media_features.htm#platforms these platforms].
14 1 Adrian Georgescu
15 50 Adrian Georgescu
== Debian package ==
16 37 Adrian Georgescu
17 58 Adrian Georgescu
For people running Debian 5.0 or Ubuntu 8.10 a debian package with the [wiki:SipProjectStatus last 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 61 Adrian Georgescu
sudo apt-get update
36 61 Adrian Georgescu
sudo apt-get install python-sipsimple sipsimple-cli
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 52 Adrian Georgescu
To obtain the incremental changes after the initial get, go to the python-sipsimple directory and run:
55 1 Adrian Georgescu
56 1 Adrian Georgescu
{{{
57 14 Adrian Georgescu
cd python-sipsimple
58 59 Adrian Georgescu
darcs pull -a
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 62 Adrian Georgescu
 * [source:docs/Install.linux Install.linux] - Debian/Ubuntu package or manual installation 
66 62 Adrian Georgescu
 * [source:docs/Install.osx Install.osx] - Mac ports or manual installation
67 55 Adrian Georgescu
 
68 45 Adrian Georgescu
The build process can be fine-tuned for various options (like for using a specific version of underlying pjsip library):
69 45 Adrian Georgescu
70 45 Adrian Georgescu
{{{
71 45 Adrian Georgescu
adigeo@ag-imac3:python setup.py build_ext --help
72 45 Adrian Georgescu
Common commands: (see '--help-commands' for more)
73 45 Adrian Georgescu
74 45 Adrian Georgescu
  setup.py build      will build the package underneath 'build/'
75 45 Adrian Georgescu
  setup.py install    will install the package
76 45 Adrian Georgescu
77 45 Adrian Georgescu
Global options:
78 45 Adrian Georgescu
  --verbose (-v)  run verbosely (default)
79 45 Adrian Georgescu
  --quiet (-q)    run quietly (turns verbosity off)
80 45 Adrian Georgescu
  --dry-run (-n)  don't actually do anything
81 45 Adrian Georgescu
  --help (-h)     show detailed help message
82 45 Adrian Georgescu
83 45 Adrian Georgescu
Options for 'PJSIP_build_ext' command:
84 45 Adrian Georgescu
  --build-lib (-b)        directory for compiled extension modules
85 45 Adrian Georgescu
  --build-temp (-t)       directory for temporary files (build by-products)
86 45 Adrian Georgescu
  --inplace (-i)          ignore build-lib and put compiled extensions into
87 45 Adrian Georgescu
                          the source directory alongside your pure Python
88 45 Adrian Georgescu
                          modules
89 45 Adrian Georgescu
  --include-dirs (-I)     list of directories to search for header files
90 45 Adrian Georgescu
                          (separated by ':')
91 45 Adrian Georgescu
  --define (-D)           C preprocessor macros to define
92 45 Adrian Georgescu
  --undef (-U)            C preprocessor macros to undefine
93 45 Adrian Georgescu
  --libraries (-l)        external C libraries to link with
94 45 Adrian Georgescu
  --library-dirs (-L)     directories to search for external C libraries
95 45 Adrian Georgescu
                          (separated by ':')
96 45 Adrian Georgescu
  --rpath (-R)            directories to search for shared C libraries at
97 45 Adrian Georgescu
                          runtime
98 45 Adrian Georgescu
  --link-objects (-O)     extra explicit link objects to include in the link
99 45 Adrian Georgescu
  --debug (-g)            compile/link with debugging information
100 45 Adrian Georgescu
  --force (-f)            forcibly build everything (ignore file timestamps)
101 45 Adrian Georgescu
  --compiler (-c)         specify the compiler type
102 45 Adrian Georgescu
  --swig-cpp              make SWIG create C++ files (default is C)
103 45 Adrian Georgescu
  --swig-opts             list of SWIG command line options
104 45 Adrian Georgescu
  --swig                  path to the SWIG executable
105 45 Adrian Georgescu
  --pyrex-cplus           generate C++ source files
106 45 Adrian Georgescu
  --pyrex-create-listing  write errors to a listing file
107 45 Adrian Georgescu
  --pyrex-include-dirs    path to the Cython include files (separated by ':')
108 45 Adrian Georgescu
  --pyrex-c-in-temp       put generated C files in temp directory
109 45 Adrian Georgescu
  --pyrex-gen-pxi         generate .pxi file for public declarations
110 45 Adrian Georgescu
  --pjsip-svn-repo        PJSIP SVN repository to checkout from
111 45 Adrian Georgescu
  --pjsip-svn-revision    PJSIP SVN revision to fetch
112 45 Adrian Georgescu
  --pjsip-clean-compile   Clean PJSIP tree before compilation
113 45 Adrian Georgescu
  --help-compiler         list available compilers
114 45 Adrian Georgescu
115 45 Adrian Georgescu
}}}
116 45 Adrian Georgescu
117 45 Adrian Georgescu
118 15 Adrian Georgescu
 * [wiki:SipUpgrade Upgrade guide]
119 57 Adrian Georgescu
 * [wiki:SipUninstall Uninstall guide]