In this example:
- Our webserver files are placed in /var/www/html/. Another common location for this could be /usr/local/apache2/htdocs/
- The latest version of OJS we're using is OJS-2.2
1) Download the latest version of the OJS software from the PKP site: http://pkp.sfu.ca/ojs_download
- Code: Select all
> wget http://pkp.sfu.ca/ojs/download/ojs-2.2.tar.gz
2) Extract the files to a location under your web root (/var/www/html/ojs/)
- Code: Select all
> tar xfz ojs-2.2.tar.gz
3) The ojs files should now be extracted in a directory called "ojs-2.2"
4) You can rename this directory to something that is more suitable for you journals
- Code: Select all
> mv ojs-2.2 myOJS
5) Change directory to your OJS folder
- Code: Select all
> cd myOJS
6) This is what you should have in your OJS directory at the moment:
drwxr-xr-x 6 user user 4096 Dec 11 22:59 cache
drwxr-xr-x 39 user user 4096 Dec 11 22:52 classes
-rw-r--r-- 1 user user 10068 Dec 11 22:59 config.inc.php
-rw-r--r-- 1 user user 10068 Nov 2 22:57 config.TEMPLATE.inc.php
drwxr-xr-x 3 user user 4096 Dec 11 22:52 dbscripts
drwxr-xr-x 3 user user 4096 Dec 11 22:59 docs
drwxr-xr-x 9 user user 4096 Dec 11 22:54 help
drwxr-xr-x 2 user user 4096 Dec 11 22:54 includes
-rw-r--r-- 1 user user 2135 Sep 18 2007 index.php
drwxr-xr-x 2 user user 4096 Dec 11 22:54 js
drwxr-xr-x 5 user user 4096 Dec 11 22:54 lib
drwxr-xr-x 13 user user 4096 Dec 11 22:59 locale
drwxr-xr-x 30 user user 4096 Dec 11 22:56 pages
drwxr-xr-x 10 user user 4096 Dec 11 22:57 plugins
drwxr-xr-x 2 user user 4096 Dec 11 22:59 public
drwxr-xr-x 3 user user 4096 Dec 11 22:57 registry
drwxr-xr-x 3 user user 4096 Dec 11 22:57 rt
drwxr-xr-x 2 user user 4096 Dec 11 22:57 styles
drwxr-xr-x 30 user user 4096 Dec 11 22:58 templates
drwxr-xr-x 3 user user 4096 Dec 11 22:59 tools
7) Make the following files and directories (and their contents) write-able by your webserver. You can do this by changing the owner and group or changing their permissions. In this example we will change their permissions:
- Code: Select all
> chmod 666 config.inc.php
> chmod 777 public/ -R
> chmod 777 cache/ -R
8 ) Create a directory to store uploaded files. It's recommended that this directory is not under your webserver root. So we'll make it inside the /home/ directory. This directory should also write-able by your webserver:
- Code: Select all
> cd /home/
> mkdir myOJS-files
> chmod 777 myOJS-files
9) We should now create a database to be used by our OJS installation. We will use mysql for this example since it's the most commonly used database software. We also create a database user for OJS to use.
- Code: Select all
> mysql -u root -p
create database `myOJS-DB`;
grant all on `myOJS-DB`.* to `ojs-user`@localhost identified by 'somePass';
10) Now we're all ready to run the automated setup script via a web browser. To do so, we have to go to this URL: http://www.mydomain.com/myOJS/
- Under the "Pre-Installation Steps", you should see all YESs. If you see a No for one item, you should go back to the installation steps above and find out what you've missed.
- Select the Primary locale and Additional Locales for your OJS installation
- You could leave all the default values in place except "Connection character set", "Database character set" and "Password encryption algorithm". If your server supports Connection and Database character sets, you should select Unicode for both. Also if your server supports sha1 hashes, then you should use sha1 for more security
- "Directory for uploads" should be the same directory that was created in step 8: /home/myOJS-files. Leave the "Do not create required subdirectories (only useful for a manual installation)" checkbox unchecked.
- Create and Administrator account
- For Database Settings, this is what we should put for this example:
* Database driver: MySQL
* Host: localhost
* Username: ojs-user
* Password: somePass
* Database name: myOJS-DB
* And UN-CHECK the "Create new database" checkbox
11) Click on the "Install Open Journal Systems" button and you're all done.
Installations at a hosting company or Windows servers will differ in a few cases. But the progress as a whole should be very close to the steps above. All comments and questions are welcome here.