Installation

Automatic setup

Janeway includes and environment setup script that will install virtual environment, its apt requirements and pip requirements. Please read the script to ensure it wont cause any issues with your current install. The command can be called directly from the command line:

wget -O - https://raw.githubusercontent.com/BirkbeckCTP/janeway/master/setup_env.sh | bash

This command has been tested in 14.04, 15.04 and 16.04

You should now setup your database and run the install command.

Manual Install

The following is for Debian/Ubuntu-based systems (16.04).

1. Install python3, pip3 & virtualevwrapper and create a project

sudo apt-get install python3 python3-pip python-pip virtualenvwrapper
source /etc/bash_completion.d/virtualenvwrapper
mkvirtualenv janeway -p /usr/bin/python3

2. Install system dependencies. On Debian-based systems:

   sudo apt-get install libxml2-dev libxslt1-dev python3-dev zlib1g-dev lib32z1-dev libffi-dev libssl-dev libjpeg-dev libmysqlclient-dev

3. From the project root directory run the following to install python dependencies:

   pip3 install -r requirements.txt

4. Copy the example settings file: cp src/core/example_settings.py src/core/settings.py

5. Update settings.py for your env (database login etc.) and setup your database. This must support utf8_mb4. For MySQL installs, use the following CREATE command:

   CREATE DATABASE janeway CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;

6. From inside the src directory, run the installer

   python3 manage.py install_janeway

and follow the on screen instructions.

> Please answer the following questions.

> Press name: Test Press

> Press domain: test.press.com

> Press main contact (email): [email protected]

> Thanks! We will now set up out first journal.

> Journal #1 code: tstj

> Journal #1 domain: journal.press.com

9. Once the command line installer is complete you can complete the setup process by directing your browser to: http://yourfirstjournal.com/install/