pandora/README.md

175 lines
4.5 KiB
Markdown
Raw Normal View History

2016-04-15 12:21:24 +00:00
# pan.do/ra - open media archive
2016-04-15 12:21:24 +00:00
for more information on pan.do/ra visit our website at https://pan.do/ra
2016-04-15 12:21:24 +00:00
## SETUP
pan.do/ra is known to work with Ubuntu 14.04,
but other distributions should also work.
The instructions below are for Ubuntu 14.04.
All commans given expect that you are root.
To run pan.do/ra you need to install and setup:
python
postgres
nginx (or apache2)
additinal video packages
2012-04-19 12:43:54 +00:00
2016-04-15 12:21:24 +00:00
## Installing required packages
1) add pandora ppa to get all packages in the required version
2012-04-19 12:43:54 +00:00
apt-get install software-properties-common
2011-12-19 19:42:18 +00:00
add-apt-repository ppa:j/pandora
apt-get update
2) install all required packages
2016-04-15 12:21:24 +00:00
2015-11-14 14:22:40 +00:00
apt-get install git subversion mercurial \
python-setuptools python-pip python-virtualenv ipython \
2011-12-03 16:17:07 +00:00
python-dev python-imaging python-numpy python-psycopg2 \
2011-12-26 14:30:30 +00:00
python-geoip python-html5lib python-lxml \
2012-04-19 12:43:54 +00:00
postgresql postgresql-contrib rabbitmq-server \
poppler-utils mkvtoolnix gpac imagemagick \
python-ox oxframe ffmpeg
2016-04-15 12:21:24 +00:00
## Prepare Environment
1) add pandora user and set permissions
2016-04-15 12:21:24 +00:00
adduser pandora --disabled-login --disabled-password
2) Setup Database
2016-04-15 12:21:24 +00:00
su postgres
createuser pandora
createdb -T template0 --locale=C --encoding=UTF8 -O pandora pandora
echo "CREATE EXTENSION pg_trgm;" | psql pandora
exit
3) Setup RabbitMQ
2016-04-15 12:21:24 +00:00
You have to use the same password here and in BROKER_URL in local_settings.py
2015-01-19 17:52:04 +00:00
rabbitmqctl add_user pandora PASSWORD
rabbitmqctl add_vhost /pandora
rabbitmqctl set_permissions -p /pandora pandora ".*" ".*" ".*"
2016-04-15 12:21:24 +00:00
## Install Pan.do/ra
2015-11-14 14:22:40 +00:00
1) Get code from git
2016-04-15 12:21:24 +00:00
2012-04-19 12:43:54 +00:00
cd /srv/
2016-03-11 09:33:23 +00:00
git clone https://git.0x2620.org/pandora.git pandora
cd pandora
./ctl init
2009-12-31 15:04:32 +00:00
cd /srv
chown -R pandora.pandora pandora
2) create local_settings.py and config.jsonc
2.1) create file /srv/pandora/pandora/local_settings.py with the following content:
2016-04-15 12:21:24 +00:00
DATABASES = {
'default': {
'NAME': 'pandora',
'ENGINE': 'django.db.backends.postgresql_psycopg2',
'USER': 'pandora',
'PASSWORD': '',
}
}
DB_GIN_TRGM = True
2015-01-19 17:52:04 +00:00
BROKER_URL = 'amqp://pandora:PASSWORD@localhost:5672//pandora'
#with apache x-sendfile or lighttpd set this to True
XSENDFILE = False
#with nginx X-Accel-Redirect set this to True
XACCELREDIRECT = True
2.2) create config.jsonc
2016-04-15 12:21:24 +00:00
config.jsonc holds the configuration for your site.
To start you can copy /srv/pandora/pandora/config.pandora.jsonc
to /srv/pandora/pandora/config.jsonc but have a look at
https://wiki.0x2620.org/wiki/pandora/configuration and
config.0xdb.jsonc config.padma.jsonc for configuration options.
3) initialize database
2016-04-15 12:21:24 +00:00
su pandora
cd /srv/pandora/pandora
./manage.py init_db
4) install init scripts and start daemons
/srv/pandora/ctl install
2013-07-10 16:14:48 +00:00
/srv/pandora/ctl start
5) Setup Webserver
a) nginx (recommended)
2016-04-15 12:21:24 +00:00
apt-get install nginx
cp /srv/pandora/etc/nginx/pandora /etc/nginx/sites-available/pandora
cd /etc/nginx/sites-enabled
ln -s ../sites-available/pandora
#read comments in /etc/nginx/sites-available/pandora for setting
#your hostname and other required settings
#make sure XACCELREDIRECT = True in /srv/pandora/pandora/local_settings.py
service nginx reload
2012-04-19 12:43:54 +00:00
b) apache2 (if you need it for other sites on the same server)
2016-04-15 12:21:24 +00:00
apt-get install apache2-mpm-prefork libapache2-mod-xsendfile
a2enmod xsendfile
2015-03-28 18:08:32 +00:00
a2enmod proxy_http
a2enmod proxy_wstunnel
cp /srv/pandora/etc/apache2/pandora.conf /etc/apache2/sites-available/pandora.conf
a2ensite pandora
#read comments in /etc/apache2/sites-available/pandora.conf for setting
#your hostname and other required settings
#make sure XSENDFILE = True in /srv/pandora/pandora/local_settings.py
service apache2 reload
2016-04-15 12:21:24 +00:00
Now you can open pandora in your browser, the first user to sign up will become admin.
## Updating
To update pandora to the latest version run this:
su pandora
cd /srv/pandora
./update.py
this will update pandora/oxjs/python-ox and list possible upgrades to the db
2009-12-31 15:04:32 +00:00
2016-04-15 12:21:24 +00:00
to update your database run:
2016-04-15 12:21:24 +00:00
su pandora
cd /srv/pandora
./update.py db
2016-04-15 12:21:24 +00:00
## Development
in one terminal:
2016-04-15 12:21:24 +00:00
./manage.py runserver 2620
and background task in another:
2016-04-15 12:21:24 +00:00
./manage.py celeryd -B -Q celery,default,encoding -l INFO
now you can access your local pandora instace at http://127.0.0.1:8000/
we use virtual machines/lxc for development, you can get a vm from our site
or use the script in vm/build.sh to create one.