File: Guide.rst

package info (click to toggle)
calendarserver 9.2%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 25,688 kB
  • sloc: python: 195,037; sql: 78,794; xml: 16,936; sh: 2,502; ansic: 66; makefile: 26
file content (89 lines) | stat: -rw-r--r-- 2,468 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
**************************************************
Calendar and Contacts Server Administrator's Guide
**************************************************

#. Install_

     #) Requirements_
     #) Local or system installation

#. Configure

     #) Overview
     #) Sample config files
     #) Layered configuration with ``Includes``

#. Prepare database

     #) Create database and user
     #) Apply schema

#. Run

     #) Runtime dependency graph
     #) Start and stop
     #) Reload

#. Monitor

     #) Important resources
     #) Logs
     #) Processes
     #) Stats socket
     #) Included tools

#. Maintain

     #) Backup and restore
     #) Upgrade
     #) Prune and purge


Install
=======

Requirements
------------
Calendar and Contacts Server (CCS) can be used on any unix-like platform that
fulfills the below requirements, and is most commonly deployed on OS X or Linux. 
CCS is written in python, and requires various 3rd party software written in C 
and python. The external dependencies effectively limit portability of CCS to a 
smaller number of platforms than are supported by python.

Package management systems may provide an easier means for installing CCS and
its dependencies. This documentation is targeted at package authors, and anyone
else who wishes to install "from source".

Software dependencies can be classified into two groups: software that must be
available prior to using CCS, and software that can be obtained by the included 
setup script (``bin/develop``).

Before getting started with CCS, you need:

* python 2.7.x, with development files
* python setuptools
* python virtualenv
* pip
* C compiler
* git client
* curl
* OpenSSL libraries and development files
* Readline libraries and development files
* Kerberos libraries and development files


The exact process for installing the above is beyond the scope of this document,
and varies by platform. Try to use a package management system if you can. As a
convenience, the following command will install the missing dependencies on
Ubuntu 13.10 server:

::

 sudo apt-get install build-essential git python-setuptools curl \
 libssl-dev libreadline6-dev python-dev libkrb5-dev libffi-dev \
 libldap2-dev libsasl2-dev zlib1g-dev

Next, run ``bin/develop`` to get the remaining dependencies (note that for some releases on some distributions it may be necessary to run ``/bin/bash bin/develop`` to force the script to run under the bash shell)

(to be continued...)