forked from wimleers/fileconveyor
-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL.txt
136 lines (100 loc) · 4.36 KB
/
INSTALL.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
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
Installation process
--------------------
The installation process is as installing `git` and `pip`, after which you
will only need to perform a single command:
pip install -e git+https://github.com/wimleers/fileconveyor@master#egg=fileconveyor
This automatically also installs all Python dependencies.
However, some processors also require non-Python dependencies. For details on
those, please see below.
Notes:
- Make sure you've got Python 2.5 (or newer) installed. If you've got an older
version, you can install Python 2.5 next to it.
-
- Installing `pip`: http://www.pip-installer.org/en/latest/installing.html; or
curl http://python-distribute.org/distribute_setup.py | python
curl https://raw.github.com/pypa/pip/master/contrib/get-pip.py | python
Upgrade process
---------------
The upgrade process is very similar to the installation process:
1. stop File Conveyor (see README)
2. copy your config.xml and all .db files to a safe location
3. delete File Conveyor
4. re-install File Conveyor with `pip`
5. copy back your config.xml and all .db files.
6. start File Conveyor again; it will resume from where it has left off
The essence is this: as long as you have your config.xml and all .db files,
you haven't lost anything!
One exception: upgrading from a version of File Conveyor of before August 2011
requires running an upgrade script: `fileconveyor/upgrade.py` (a DB schema
change was introduced).
==============================================================================
| OS-specific additional instructions |
==============================================================================
Linux
-----
Mac OS X is fully supported and requires no additional setup.
Mac OS X
---------
Mac OS X is fully supported and requires no additional setup.
Windows
-------
Windows is not yet supported.
The necessary abstractions for Windows are built in, but the daemon has not
yet been tested in it.
==============================================================================
| Known problematic set-ups. |
==============================================================================
SQLite + GFS
------------
SQLite does not appear to work well when its databases are stored on GFS
mounts (Global File System):
http://drupal.org/node/723750#comment-2647816
NFS
---
inotify doesn't work on NFS file systems.
==============================================================================
| Per-processor module additional instructions |
==============================================================================
Processor module: yui_compressor
--------------------------------
* instructions:
1. download from http://www.julienlecomte.net/yuicompressor/
2. copy the executable from the "build" directory to the "processors" directory of the daemon
3. rename the executable from e.g. "yuicompressor-2.4.2.jar" to "yuicompressor.jar"
Processor module: google_closure_compiler
-----------------------------------------
* instructions:
1. download from http://closure-compiler.googlecode.com/files/compiler-latest.zip
2. copy the executable to the "processors" directory of the daemon
3. rename the executable from e.g. "compiler-x.y.z.jar" to "compiler.jar"
Processor module: image_optimizer
---------------------------------
You only have to install these libraries if you don't have them already. This
processor only works on UNIX, at least for now.
- imagemagick
* homepage: http://imagemagick.org
* instructions:
- Debian/Ubuntu: already installed
- Other:
1. download the binary release from http://imagemagick.org/script/binary-releases.php
2. copy the executables from the "bin" directory to a directory that is referenced by $PATH
- pngcrush
* homepage: http://pmt.sourceforge.net/pngcrush/
* instructions:
- Debian/Ubuntu: sudo apt-get install pngcrush
- Other:
1. download the source
2. make
3. copy the executable into a directory that is referenced by $PATH
- jpegtran
* homepage: http://jpegclub.org/
* instructions: http://www.phpied.com/installing-jpegtran-mac-unix-linux/
- gifsicle
* homepage: http://www.lcdf.org/gifsicle/
* instructions:
- Debian/Ubuntu: sudo apt-get install gifsicle
- Other:
1. download the source
2. ./configure
3. make
4. make install