Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

150 lines (109 sloc) 6.231 kB
A more comprehensive (but not always up to date!) install guide can be found at
http://en.flossmanuals.net/Plumi/Introduction
Before you start
================
* install gcc/g++ dev tools
e.g. sudo apt-get install build-essential pkg-config
* install git
e.g. sudo apt-get install git-core
* install python2.6 and header files
e.g. sudo apt-get install python2.6-dev
* install libjpeg, zlib, libpcre, libxslt header files
e.g. sudo apt-get install libjpeg62-dev zlib1g-dev, libxslt1-dev
or for Ubuntu 11.04 jpeg support: sudo apt-get install libjpeg8-dev
for png support in Ubuntu 11.04 you may have to install zlib from source
* install groff-base
e.g. sudo apt-get install groff-base
Initial configuration
======================
This step is optional for testing/development builds. However, even in those
cases you may wish to customize some of the options inside site.cfg, especially
if ports 8080, 8888, 8021, 8000, 8100 or 8890 are already used by other apps in
your system.
If you're deploying for production you should have 2 different hostnames
available, one for your Plumi site (e.g. new.plumi.org) and another for the
transcoder/videoserver (e.g.newvideos.plumi.org), both pointing to your public
ip address. You could also install the transcoding server in a different
machine or even have multiple transcoding servers with load balancing, but this
setup will not be covered in this guide. Please ensure that these hostnames are
set up in advance of your site installation and have had sufficient time to
propagate through the Internet (eg: 24-48 hours). If you server is not going to
be accessed from the Internet, you still need to set up the domains within your
private network (eg: internal DNS server, /etc/hosts files on all workstations,
etc).
Before running buildout, you should customize the options inside site.cfg.
At the very least you should change the following:
* secret: a shared secret key for encrypted communication between Plumi and
transcodedaemon. Just enter a random string of 4, 8, 16 or 32 characters.
* www-server-name: the hostname of your Plumi site (e.g. www.engagemedia.org)
* www-videoserver-name: the hostname of your transcoder & videoserver
(e.g. videos.engagemedia.org)
If you decided not to change the default user for zope and zeo in site.cfg make
sure that it exists in your system. If not, add it:
sudo useradd zope
Install Plumi 4.x
=================
Once you're ready with the initial configuration execute the following two
commands. Do it as your regular user for testing/dev builds but make sure you
are root for production builds:
python2.6 bootstrap.py
./bin/buildout
That should take some time, so feel free to get some cofee or fresh air while
buildout is downloading, compiling and installing dependencies (Zope, Plone,
ffmpeg, etc). If all goes well your Plumi instance will be ready after that
point.
Running Plumi 4.x
==================
Supervisor will be managing the internal ZEO server, the transcodedaemon,
the async worker instance, the varnish cache server, the gunicorn WSGI web
server, as well as the externally facing ploneFTP server and the nginx web
server in production builds.
Start supervisor like this:
./bin/supervisord
Confirm that zeo, gunicorn and transcodedaemon are up and running:
./bin/supevisorctl status
If you ran buildout as a regular (non root) user and you did not change the
default ports for nginx and ploneftp in site.cfg (www-address & plumiftp-address
respectively) you'll see that both ploneftp and nginx failed to start because
you don't have permission to bind on to the priviledged ports 80 and 21.
Nothing to worry about if you're just evaluating Plumi, you can still use it
without nginx. Just go to port 8000 on localhost to access directly the gunicorn
web server.
Run the plumisite command to create a new Plumi site
./bin/plumisite
Alternatively, if you can create the Plumi site through the web, using the ZMI.
After that step you're ready to roll! Your new Plumi site will be available
at http://localhost:8000/Plone or at http://{www-server-name} for production
builds.
If you want to do some development, you can use Paster instead of gunicorn
since the latter is more suited for production. Stop gunicorn and start paster
as shown below:
./bin/supervisorctl stop gunicorn
./bin/paster serve development.ini --reload
The --reload option will consume more resources but it's very handy for dev
since it will automatically reload any python modules that you edit.
If you have changed the default port, hostname, or the secret encryption key
for the transcode daemon in site.cfg, you should go to the transcode settings
panel (e.g. http://localhost:8000/Plone/@@transcode-controlpanel ) and enter
the same host, port and key there.
Add a new user to your Plumi site for testing and start publishing videos!
In order to shutdown all Plumi related services, use the following command:
./bin/supervisorctl shutdown
If you want to ensure that Plumi will start automatically whenever your server
is turned on, add the following lines to your /etc/rc.local file replacing
PATH_TO_PLUMI with the actual absolute path of your plumi setup:
PATH_TO_PLUMI/bin/supervisord
Configuring Torrents and Video statistics
=========================================
To configure torrent support, visit Site Setup->Seeder Settings and fill in the
announce urls of the tracker you want to use and the absolute paths to store
the torrents. To start autoseeding and show the number of seeders, you need to
install deluged and deluge-console in your system. You can optionally install
deluge-web or deluge-gtk for a graphic environent and configure Deluge to
automatically seed all torrents inside your torrent folder and download all
files to that folder too.
To record and show video views and downloads you'll need a working Piwik
installation. Add the tracking tag in Site-Setup->Site and fill the form in
Site-Setup-> Piwik Settings with the piwik url, the site id on piwik and the
api key (if you have anonymous access on piwik for your site you can leave
anonymous instead of the API key).
Jump to Line
Something went wrong with that request. Please try again.