-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.txt
79 lines (47 loc) · 1.92 KB
/
README.txt
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
==============
zopache.webapp
==============
(Document the zopache.webapp project here.)
This project has been initially created with ZTFY.webapp version 1.1.4
Installation
============
Run the following steps::
$ python bootstrap.py
$ bin/buildout
If you have an error during the buildout process, you probably miss some
dependencies (development libs, tools and headers).
Tests
=====
Run::
$ bin/test
Debugging
=========
To start a python interpreter with the same environment as your project, run::
$ bin/ztpy
To start a python interpreter with the same environment as your project and
with access to the ZODB database, run::
$ bin/paster shell debug.ini # or deploy.ini
Here, you can access the root folder through the `root` variable, and a debugger
object through variable `debugger` or `app`. This object allows you to simulate
requests to the application and to access the ZODB root object.
Startup
=======
Check the WSGI configuration in deploy.ini and debug.ini
During development, run the following command to run the server::
$ bin/paster serve debug.ini
For deployment, run::
$ bin/paster serve --daemon deploy.ini
and use a process monitoring tool such as supervisord.
mod_wsgi
========
A configuration file is available in etc/mod_wsgi/zopache.webapp file.
It allows you to deploy your site under apache2 with mod_wsgi module, and
already contains required options for mod_ssl and mod_upload_progress modules
if they are available.
Under Debian, you just have to check this file to verify that hostname and
virtual host root are OK and to create a link in /etc/apache2/site-enabled
directory before restarting Apache to make your site available.
SSL settings are defined with default Debian's self-signed certificate; don't
forget to check and update these settings if you use a real signed certificate.
This file is not rebuild by buildout, so you can freely customize it according
to your own needs !