README.md 1.96 KB
Newer Older
1
2
This repository is deprecated. Please use https://github.com/pkp/ojs-vagrant.

Mark Jordan's avatar
Mark Jordan committed
3
4
## Introduction

Mark Jordan's avatar
Mark Jordan committed
5
A test/play virtual machine for [Open Journal Systems](http://pkp.sfu.ca/ojs/). It should work on any operating system that supports VirtualBox and Vagrant.
Mark Jordan's avatar
Mark Jordan committed
6
7
8

This virtual machine **should not** be used in production.

Mark Jordan's avatar
Mark Jordan committed
9
10
11
## Prerequisites

Install the following prerequisites on your laptop or desktop:
Mark Jordan's avatar
Mark Jordan committed
12
13
14
15

1. [VirtualBox](https://www.virtualbox.org/)
2. [Vagrant](http://www.vagrantup.com/)

Mark Jordan's avatar
Mark Jordan committed
16
## Setting up your virtual machine
Mark Jordan's avatar
Mark Jordan committed
17

Mark Jordan's avatar
Mark Jordan committed
18
1. `git clone http://lib-git.lib.sfu.ca/mjordan/ojs_vagrant` (or download the .zip/.tar version)
Mark Jordan's avatar
Mark Jordan committed
19
2. `cd ojs_vagrant`
Mark Jordan's avatar
Mark Jordan committed
20
21
3. `vagrant up`

Mark Jordan's avatar
Mark Jordan committed
22
23
When all the scripts have finished running, your virtual machine is ready for use.

Mark Jordan's avatar
Mark Jordan committed
24
## Accessing OJS
Mark Jordan's avatar
Mark Jordan committed
25

Mark Jordan's avatar
Mark Jordan committed
26
You can connect to OJS a web browser at [http://localhost:8000/ojs](http://localhost:8000/ojs). You will need to enter the required information on the installation page. Some things to watch for:
Mark Jordan's avatar
Mark Jordan committed
27
28

* Under "File Settings," /var/www/files has been created for you. You don't need to change this setting.
Mark Jordan's avatar
Mark Jordan committed
29
* Under "Database Settings," use 'localhost' for Host, and 'ojs' for Username, Password, and Database name. Uncheck "Create new database" (the database has been done for you).
Mark Jordan's avatar
Mark Jordan committed
30

Mark Jordan's avatar
Mark Jordan committed
31
32
Once you have installed OJS, it is ready for use. The [OJS Documentation wiki](https://pkp.sfu.ca/wiki/index.php?title=OJS_Documentation) contains everything you need to know.

Mark Jordan's avatar
Mark Jordan committed
33
34
## Other details you might find useful

Mark Jordan's avatar
Mark Jordan committed
35
You can connect to the machine via ssh: `ssh -p 2222 vagrant@localhost` and log in with:
Mark Jordan's avatar
Mark Jordan committed
36
37
38
39
  - username: vagrant
  - password: vagrant

You won't normally need the following but just in case:
Mark Jordan's avatar
Mark Jordan committed
40

Mark Jordan's avatar
Mark Jordan committed
41
42
MySQL credentials:
  - username: root
Mark Jordan's avatar
Mark Jordan committed
43
44
  - password: ojs

Mark Jordan's avatar
Mark Jordan committed
45
46
47
OJS database details:
  - database: ojs
  - user: ojs
Mark Jordan's avatar
Mark Jordan committed
48
49
50
51
  - password: ojs

## Environment

Mark Jordan's avatar
Mark Jordan committed
52
53
The virtual machine runs:

Mark Jordan's avatar
Mark Jordan committed
54
55
56
57
58
59
60
61
- Ubuntu 14.04
- MySQL 5.5.41
- Apache 2.26
- PHP 5.5.9 
- OJS 2.4.6

## Thanks

62
This Vagrant virtual machine is based on [Islandora Vagrant](https://github.com/Islandora-Labs/islandora_vagrant).