diff --git a/INSTALL b/INSTALL index 2a2d0de..fdb19ca 100644 --- a/INSTALL +++ b/INSTALL @@ -1,75 +1,97 @@ SylkServer Installation ----------------------- Copyright (c) 2010-2012 AG Projects http://ag-projects.com Home page: http://sylkserver.com +Ths software can be installed manually from it source tree or as a Debian +package on Debian and Ubuntu systems. -Configure Repository --------------------- + +Configure Repositories +---------------------- Install the AG Projects debian software signing key: wget http://download.ag-projects.com/agp-debian-gpg.key sudo apt-key add agp-debian-gpg.key Add these lines to /etc/apt/sources.list: Ubuntu Natty (11.04) -------------------- deb http://ag-projects.com/ubuntu natty main deb-src http://ag-projects.com/ubuntu natty main Ubuntu Maverick (10.10) ----------------------- deb http://ag-projects.com/ubuntu maverick main deb-src http://ag-projects.com/ubuntu maverick main Ubuntu Lucid (10.04) -------------------- deb http://ag-projects.com/ubuntu lucid main deb-src http://ag-projects.com/ubuntu lucid main Update the list of available packages: sudo apt-get update Install SylkServer: sudo apt-get install sylkserver Enable SylkServer: Edit /etc/default/sylkserver and set RUN_SYLKSERVER=yes Configure SylkServer: Edit /etc/sylkserver/config.ini Run SylkServer: /etc/init.d/sylkserver start High level application logs are logged to syslog. Detail protocol traces are logged in /var/log/sylkserver/ -You can also run the software for debugging purpose from its local -directory: + +Manual installation +------------------- + +The source code is managed using darcs version control tool. The darcs +repository can be fetched with: + +darcs get http://devel.ag-projects.com/repositories/sylkserver + +To obtain the incremental changes after the initial get run: + +darcs pull -a + +Install the required dependencies: + + * python-sipsimple (>= 0.20.0) http://sipsimpleclient.com + * python-sqlobject (>= 0.12.4) + * python-twisted-words + * python-wokkel + +To run SylkServer in the foreground: ./sylk-server --no-fork -The high level application logs are logged to the console and the detail -protocol traces are logged in files located in ./var/log/sylkserver folder -relative to the sylkserver source code tree. +To install SylkServer manually system wide: + +sudo python setup.py install