Skip to content
Find file
Fetching contributors…
Cannot retrieve contributors at this time
137 lines (100 sloc) 4.36 KB
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
-----
Linux 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
Something went wrong with that request. Please try again.