CENDARI/editorsnotes - Githubissues

Installation

"SUPERSET" OF INSTRUCTIONS:

UBUNTU:

Check python version: (>2.7) python --version

Postgresql

sudo apt-get install postgresql
sudo apt-get install pgadmin3
sudo -u postgres psql postgres
sudo apt-get install postgresql-client
sudo apt-get install postgresql-server-dev-9.3
sudo -u postgres createdb mydb
\password postgres

+open pgAdmin gui & create new role & connect the db

Fabric

sudo apt-get install python-pip python-dev build-essential
sudo pip install fabric

libxml2 + libxslt

sudo apt-get install libxml2
sudo apt-get install libxml2-dev libxslt-dev

Elastic Search

sudo apt-get install openjdk-7-jre
wget https://download.elasticsearch.org/elasticsearch/elasticsearch/elasticsearch-1.1.0.deb
sudo dpkg -i elasticsearch-1.1.0.deb
sudo service elasticsearch start

Nodejs

sudo apt-get install -y python-software-properties python g++ make
sudo add-apt-repository -y ppa:chris-lea/node.js
sudo apt-get update
sudo apt-get install nodejs

Less
```
sudo apt-get install npm
npm config set registry http://registry.npmjs.org
sudo npm install -g less@1.3.3
```
- you can use: sudo apt-get install node-less but this may not install the 1.3.3 version that we tested with
Virtual Environment
```
sudo pip install virtualenv
```
Redis Install redis from http://redis.io/ for RQ (Redis Queue) to work. On ubuntu:
```
 apt-get install redis-server
```
Install flup
```
sudo pip install flup
```

For pycurl install

sudo apt-get install libcurl4-gnutls-dev

For odbc install
```
sudo apt-get install unixodbc-dev
```

For Pillow/Image loading, install

sudo apt-get install libjpeg-dev libtiff5-dev libopenjpeg-dev zlib1g-dev

Inside Editors Notes Directory
```
fab setup
```
Create database in pgAdmin

edit editorsnotes/settings_local.py with new database info
```
sudo -u postgres fab sync_database
```
Create a superuser and initial project
```
fab create_superuser
sudo service elasticsearch status
```
(> check that elasticsearch is started)
```
sudo fab runserver
```
Check the site: http://localhost:8000/
ImageMagick Download from http://www.imagemagick.org/ version > 6.4
iipsrv http://iipimage.sourceforge.net/ Installation is a bit complicated. It needs apache2 and fastcgi. first install apache2, then mod_fastcgi, then the iipimage server On ubuntu:
```
 sudo apt-get install apache2-server libapache2-mod-fastcgi
 sudo apt-get install iipimage-server
```
This will install /etc/apache2/mods-available/iipsrc.conf and a symbolic link to it from /etc/apache2/mods-enabled Add a filesystem prefix at this end of this file to limit the access of the server and facilitate communication with editorsnotes. Assuming your installation of editorsnotes is on a directory ENOTE, the images uploaded will be stored in ENOTE/uploads/scans/... Then, add the following line to iipsrv.conf (replace ENOTE with your dir):
```
 -initial-env MEMCACHED_SERVERS=localhost \
 -initial-env FILESYSTEM_PREFIX=ENOTE/uploads/
```
or using the new syntax:
```
 FcgidInitialEnv MEMCACHED_SERVERS "localhost"
 FcgidInitialEnv FILESYSTEM_PREFIX "ENOTE/uploads/"
```
To enable fastcgi module on apache2 for ubutu 14.04, you may have to do:
```
 sudo a2enmod fastcgi
```
Sometimes this does not work due to access rights (all the directories on the path to ENOTE should be visible to iipsrv). In that case, create a directory /var/www/uploads and create a link to it in ENOTE. Beware of access rights ... (sudo mkdir ... and chown /var/www/uploads) Then, add /var/www/uploads/ to iipsrc.conf
Image conversion When uploading images, an external process is used to do the conversion into a tiled pyramid file using the Imagemagick "convert" program. The external process should run using the following program (can be in background):
```
bin/python manage.py rqworker default
```
This background program can be managed by the supervisord program if you have it installed. Look at the file supervisor.conf for an example on how t set it up.
Watchdog (optional)
```
  sudo pip install watchdog
```
VIPS
```
  sudo apt-get install libvips-tools
```

Virtuoso The installation is too complex, based on virtuoso opensource 6.1

  sudo apt-get install libodbc1 odbcinst odbcinst1debian2 unixodbc-bin unixodbc-dev
  sudo apt-get install virtuoso-minimal virtuoso-opensource virtuoso-opensource-6.1-bin virtuoso-opensource-6.1-common virtuoso-server virtuoso-vad-conductor virtuoso-vad-isparql virtuoso-vad-ods virtuoso-vad-rdfmappers libvirtodbc0

Following the documentation of virtuoso-python, create a file in /etc/odbc.ini containing the lines:

  [VOS]
  Description = Virtuoso
  Driver = /usr/lib/odbc/virtodbcu_r.so
  Servername = localhost
  Port = 1111
  UserName = dba 
  Locale = en.UTF-8

That should work then with the default user dba.

MAC Current realease doesnt work: released used editorsnotes-0.6.0

Already had: python,python-dev, django, django-admin (?), pip

brew install git

Install brew:

ruby -e "$(curl -fsSL https://raw.github.com/mxcl/homebrew/go)"
brew doctor

Install libxml2
```
brew install --with-python libxml2
```
Install libxslt
```
brew install libxslt
```
Install ElasticSearch
```
brew install ElasticSearch
```
Install Fabric
```
sudo pip install fabric
```
Install Node.js Download from http://nodejs.org/download/ node-v0.10.21.pkg in /usr/local/bin
Install LessCss: http://lesscss.org/
```
sudo npm install -g less@1.3.3
```
Install Browserify
```
sudo npm install browserify
```
Install postgreSQL Download from http://www.enterprisedb.com/products-services-training/pgdownload#osx postgresql-9.3.1-1-osx.dmg (NOT?)
```
brew install postgresql
```
Install watchdog (optional)
```
brew install libyaml 
sudo pip install watchdog
```
(fab watch_static command to automatically collect and compile static files as they are changed.)
Install virtualenv
```
sudo pip install virtualenv
```
Start Elastic Search
```
sudo elasticsearch start
```
Install flup
```
sudo pip install flup
```
Install bsddb3
```
brew install berkeley-db --without-java
sudo BERKELEYDB_DIR=/usr/local/Cellar/berkeley-db/5.3.28/ pip install bsddb3
```
- wjw - this manual installation technique is documented in more here http://chriszf.posthaven.com/getting-berkeleydb-working-with-python-on-osx)
Inside Editors Notes Directory
```
fab setup
```
Database Create database in pgAdmin

edit editorsnotes/settings_local.py with new database info
```
fab sync_database
fab runserver
```
Check the site: http://localhost:8000/
Image conversion When uploading images, an external process is used to do the conversion into a tiled pyramid file using the Imagemagick "convert" program. The external process should run using the following program (can be in background):
```
bin/python manage.py rqworker default
```

CENDARI / editorsnotes

readme

Installation

UBUNTU: