We are moving tickets from the Plumi tracker (trac.plumi.org) here, for historical reasons.
Plumi enables you to create your own sophisticated video-sharing site. It includes a beautiful adaptive skin using Diazo, server-side transcoding of most video formats, upload progress bar, thumbnail extraction, HTML5 video playback and embedding, subtitles using Amara, large file uploading via FTP, social media integration, threaded commenting and user feedback forms, customised user profiles and a range of other useful features.
Plumi demo screenshot:
.. image:: docs/demo.jpg
As of December 2016 Plumi has been tested on the following Operating Systems: Debian Jessie, Ubuntu 16, CentOS 7. It can be installed on other systems as well as long as they contain python2.7 and the system dependencies are installed.
For a small/medium portal hosting videos you'd need at least 1 core, 1G RAM, and disk size depending to the size of original videos being uploaded, plus the ones being transcoded (so if you estimate that you'll have 50 videos uploaded, each one of 100MB, you would need at least 70G of disk space)
For bigger installations you would need more RAM and cores. The specs for criticalcommons.org and engagemedia.org, the two biggest plumi installations are:
If plumi is installed in /home/plumi.app, then
So after installation you can delete /home/plumi.app/transcoded and /home/plumi.app/var/blobstorage and make them links to a separate disk (so you can maintain it easier). Of course if you can spare the whole system to be on SSD disks, you don't have to keep the above dirs on a separate disk
Step 1:Install system dependencies
[email protected]:~# apt-get update; apt-get upgrade -y; [email protected]:~# apt-get install -y build-essential pkg-config git-core python-dev libssl-dev zlib1g-dev libxslt1-dev libjpeg62-turbo-dev groff-base python-virtualenv vim libpcre3 libpcre3-dev [email protected]:~# apt-get update; apt-get upgrade -y
[email protected]:~# apt-get update; apt-get upgrade -y [email protected]:~# apt-get install -y build-essential pkg-config git-core python-dev libssl-dev zlib1g-dev libxslt1-dev libjpeg62-dev groff-base python-virtualenv vim libpcre3 libpcre3-dev [email protected]:~# apt-get update; apt-get upgrade -y
[email protected]:~# yum groupinstall "Development Tools" -y [email protected]:~# yum install openssl-devel sqlite-devel bzip2-devel libxslt-devel pcre groff ruby-devel libxml2 libxml2-devel libxslt libxslt-devel git-all zlib zlib-devel zlibrary zlib-devel libjpeg-turbo libjpeg-turbo-devel groff groff-perl bzip2-devel openssl-devel ncurses-devel sqlite-devel readline-devel tk-devel python-virtualenv tkinter freetype freetype-devel python-lcms lcms-devel python-webpy python-devel x264-devel libvpx-devel python-imaging wget ftp nano vim xz-libs -y
Step 2: Get plumi
We will get plumi from it's github repository and install through a virtualenv environment. We'll install plumi in /home/plumi.app
[email protected]:~# cd /home/ [email protected]:/home# git clone https://github.com/plumi/plumi.app/ [email protected]:/home# cd plumi.app [email protected]:/home/plumi.app# virtualenv --no-setuptools .
Add users zope and www-data to the system (if server has nginx or apache www-data will be there already)::
[email protected]:/home# adduser zope [email protected]:/home# adduser www-data
step 3: Edit settings
Edit file site.cfg and change users, if necessary (ftp user, cache user, etc). We'll leave the default site.cfg settings, that allow us to start supervisord (a supervisor process that is responsible to start/stop/monitor all processes plumi needs in order to run) as root, and then chmod to simple system users. Plumi processes can run as different users, for security reasons, while the default settings require that a user zope exists in order to run uwsgi web server.
However, we need to change these two lines::
www-server-name = new.plumi.org www-videoserver-name = newvideos.plumi.org
www-server-name = mgogoulos.plumi.org www-videoserver-name = videos-mgogoulos.plumi.org
to reflect our existing dns. We need 2 dns names for plumi and the transcode daemon although they exist on the same system.
If this is a testing installation and we don't have dns yet, we can let the default settings (new.plumi.org and newvideos.plumi.org) and set these dns on our local /etc/hosts::
www.xx.yyy.zzz new.plumi.org newvideos.plumi.org
Make sure you set the same dns entries on /etc/hosts on both plumi server and your local system, if you're going to use dns names that are not resolvable, otherwise plumi won't behave correctly
Step 4: Run the buildout
[email protected]:/home/plumi.app# ./bin/python bootstrap.py && ./bin/buildout -v
This takes some time, it downloads and installs (on our virtualenv) all necessary packages for plumi to run, then installs the software and creates a plumi portal (on top of Plone).
Step 5 Install ffmpeg
There are 3 ways we can use ffmpeg to transcode videos:
We will cover the system package installation here:
ffmpeg can be found on Debian Backports. To enable edit /etc/apt/sources.list and append line::
deb http://ftp.debian.org/debian jessie-backports main
Now install ffmpeg::
apt-get update; apt-get install ffmpeg -y
ffmpeg is part of the packages of a default Ubuntu 16.04 distribution so use apt-get install to install
[email protected]:~# apt-get update; apt-get install ffmpeg -y
ffmpeg can be found on atrpms repo. Enable epel-release before we can install ffmpeg::
[email protected]:~# yum -y install epel-release [email protected]:~# rpm -Uvh http://dl.fedoraproject.org/pub/epel/7/x86_64/e/epel-release-7-8.noarch.rpm [email protected]:~# rpm -ivh https://www.mirrorservice.org/sites/dl.atrpms.net/el7-x86_64/atrpms/stable/atrpms-repo-7-7.el7.x86_64.rpm
Now edit /etc/yum.repos.d/atrpms.repo and under [atrpms] change the baseurl and enabled from. Set::
now you can install ffmpeg::
[email protected]:~# yum -y install ffmpeg
Step 6: start supervisord
With plumi buildout having finished and ffmpeg installed on our system, it's time to run supervisord::
[email protected]:/home/plumi.app# ./bin/supervisord
after a few seconds, check that everything is up and running::
[email protected]:/home/plumi.app# ./bin/supervisorctl status cache RUNNING pid 22650, uptime 0:21:29 nginx RUNNING pid 22651, uptime 0:21:29 ploneftp RUNNING pid 22649, uptime 0:21:29 transcodedaemon RUNNING pid 22612 uptime 0:21:29 uwsgi RUNNING pid 22646, uptime 0:21:29 worker RUNNING pid 22647, uptime 0:21:29 zeo RUNNING pid 22645, uptime 0:21:29
(in case something is not running, check logs on var/log and partrs/transcodedaemon)
We have noticed that the worker process does not start properly some times. If that's the case, edit file parts/worker/etc/zope.conf and on the zodb_db main section make sure the blob-dir is set as the full path on the filesystem (eg /home/plumi.app/var/blobstorage).
We are good! Let's open a browser to http://new.plumi.org and see Plumi
Screenshot of an installed Plumi site:
.. image:: docs/plumi-vanilla.jpg