You are viewing the PKP Support Forum | PKP Home Wiki

HOW-TO: Detailed OJS Installation Instructions

Are you an Editor, Author, or Journal Manager in need of help? Want to talk to us about workflow issues? This is your forum.

Moderators: jmacgreg, michael, vgabler, John

Forum rules
This forum is meant for general questions about the usability of OJS from an everyday user's perspective: journal managers, authors, and editors are welcome to post questions here, as are librarians and other support staff. We welcome general questions about the role of OJS and how the workflow works, as well as specific function- or user-related questions.

What to do if you have general, workflow or usability questions about OJS:

1. Read the documentation. We've written documentation to cover from OJS basics to system administration and code development, and we encourage you to read it.

2. take a look at the tutorials. We will continue to add tutorials covering OJS basics as time goes on.

3. Post a question. Questions are always welcome here, but if it's a technical question you should probably post to the OJS Technical Support subforum; if you have a development question, try the OJS Development subforum.

HOW-TO: Detailed OJS Installation Instructions

Postby smiri » Mon Mar 31, 2008 11:33 pm

This is step by step instruction for how to install OJS on a linux server:

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.
Posts: 183
Joined: Thu Sep 06, 2007 7:01 pm

Re: HOW-TO: Detailed OJS Installation Instructions

Postby Sams » Fri Aug 29, 2008 12:15 am

Even after following all the steps i get the following error
Fatal error: Smarty error: unable to write to $compile_dir '/var/www/ojs/typoOjs/cache/t_compile'. Be sure $compile_dir is writable by the web server user. in /var/www/ojs/typoOjs/lib/smarty/Smarty.class.php on line 1095. do help me out on the same
Posts: 3
Joined: Thu Aug 28, 2008 11:19 pm

Re: HOW-TO: Detailed OJS Installation Instructions

Postby jmacgreg » Fri Sep 05, 2008 3:02 pm

Hi Sam,

The error you get is due to a permissions error; there's an entry on permissions in the FAQ: viewtopic.php?f=8&t=2481#t4.

Posts: 4162
Joined: Tue Feb 14, 2006 10:50 am

Return to OJS Editorial Support and Discussion

Who is online

Users browsing this forum: No registered users and 4 guests