SipInstallation

Version 45 (Adrian Georgescu, 03/13/2009 11:58 am) → Version 46/212 (Adrian Georgescu, 03/13/2009 11:59 am)

= Installation guide =

[[TOC(WikiStart, Sip*, depth=3)]]

== Supported platforms ==

Currently i386, amd64 and ppc architectures have been tested and are fully supported on the following operating systems:

* Linux
* MacOSX
* FreeBSD

Porting to other operating systems (like Windows, Symbian and iPhone) should be possible as long as Python environment and [http://www.pjsip.org/sip_media_features.htm#platforms PJSIP] are supported by
that platform. The MSRP library is not yet fully working on ARM processors.

== Debian package ==

For people running Debian 5.0 or Ubuntu 8.10 there is a debian package ready for use available from the public repository provided by AG Projects. To install the debian package add these lines in /etc/apt/sources.list

{{{
# AG Projects software
deb http://ag-projects.com/debian unstable main
deb-src http://ag-projects.com/debian unstable main
}}}

Install the AG Projects debian software signing key:

{{{
wget http://download.ag-projects.com/agp-debian-gpg.key
apt-key add agp-debian-gpg.key
}}}

After that, run:

{{{
apt-get update
apt-get install sipclient
}}}

== Development version ==

The source code is managed using [http://darcs.net darcs] version control tool. The darcs repository can be fetched with:

{{{
darcs get http://devel.ag-projects.com/repositories/python-sipsimple
}}}

To obtain the incremental changes after the initial get, go to the sipsimpleclient directory and run:

{{{
cd python-sipsimple
darcs pull
}}}

== Building instructions ==

Building instructions for the corresponding platforms are available at:

* [source:docs/INSTALL.linux INSTALL.linux]
* [source:docs/INSTALL.osx INSTALL.osx]
* [source:docs/INSTALL.freebsd INSTALL.freebsd]

The build process can be fine-tuned for various options (like for using a specific version of underlying pjsip library):

{{{
adigeo@ag-imac3:python setup.py build_ext --help
Common commands: (see '--help-commands' for more)

setup.py build will build the package underneath 'build/'
setup.py install will install the package

Global options:
--verbose (-v) run verbosely (default)
--quiet (-q) run quietly (turns verbosity off)
--dry-run (-n) don't actually do anything
--help (-h) show detailed help message

Options for 'PJSIP_build_ext' command:
--build-lib (-b) directory for compiled extension modules
--build-temp (-t) directory for temporary files (build by-products)
--inplace (-i) ignore build-lib and put compiled extensions into
the source directory alongside your pure Python
modules
--include-dirs (-I) list of directories to search for header files
(separated by ':')
--define (-D) C preprocessor macros to define
--undef (-U) C preprocessor macros to undefine
--libraries (-l) external C libraries to link with
--library-dirs (-L) directories to search for external C libraries
(separated by ':')
--rpath (-R) directories to search for shared C libraries at
runtime
--link-objects (-O) extra explicit link objects to include in the link
--debug (-g) compile/link with debugging information
--force (-f) forcibly build everything (ignore file timestamps)
--compiler (-c) specify the compiler type
--swig-cpp make SWIG create C++ files (default is C)
--swig-opts list of SWIG command line options
--swig path to the SWIG executable
--pyrex-cplus generate C++ source files
--pyrex-create-listing write errors to a listing file
--pyrex-include-dirs path to the Cython include files (separated by ':')
--pyrex-c-in-temp put generated C files in temp directory
--pyrex-gen-pxi generate .pxi file for public declarations
--pjsip-svn-repo PJSIP SVN repository to checkout from
--pjsip-svn-revision PJSIP SVN revision to fetch
--pjsip-clean-compile Clean PJSIP tree before compilation
--help-compiler list available compilers

usage: setup.py [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...]
or: setup.py --help [cmd1 cmd2 ...]
or: setup.py --help-commands
or: setup.py cmd --help

}}}

== Upgrade instructions ==

* [browser:docs/Upgrade.txt Upgrade guide]

== How to un-install ==

* [browser:docs/UnINSTALL.txt Uninstall guide]