OJS Installation

OJS Version 2.1.1.0

Thank you for downloading the Public Knowledge Project's Open Journal Systems. Before proceeding, please read the README file included with this software. For more information about the Public Knowledge Project and its software projects, please visit the PKP web site. If you have bug reports or technical support inquiries about Open Journal Systems, see the support forum or visit PKP's online bug reporting system. Although the support forum is the preferred method of contact, you can also email the team at pkp-support@sfu.ca.

Upgrade

If you are upgrading an existing installation of OJS 2.x, click here to proceed.

Recommended system requirements

  • PHP >= 4.2.x (including PHP 5.x)
  • MySQL >= 3.23.23 (including MySQL 4.x) or PostgreSQL >= 7.1 (including PostgreSQL 8.x)
  • Apache >= 1.3.2x or >= 2.0.4x or Microsoft IIS 6
  • Operating system: Any OS that supports the above software, including Linux, BSD, Solaris, Mac OS X, Windows

As PKP does not have the resources to test every possible combination of software versions and platforms, no guarantee of correct operation or support is implied.

Changes to these settings can be made after installation by editing the file config.inc.php in the base OJS directory, or using the site administration web interface.

Supported database systems

OJS has currently only been tested on MySQL and PostgreSQL, although other database management systems supported by ADOdb may work (in full or partially). Compatibility reports and/or code patches for alternative DBMSs can be sent to the OJS team.

Pre-Installation Steps

1. The following files and directories (and their contents) must be made writable:

  • config.inc.php is writable (optional): NO
  • public/ is writable: NO
  • cache/ is writable: NO
  • cache/t_cache/ is writable: NO
  • cache/t_compile/ is writable: NO
  • cache/_db is writable: NO

2. A directory to store uploaded files must be created and made writable (see "File Settings" below).

Manual installation

Select Manual Install to display the SQL statements necessary to create the OJS database schema and initial data so that database installation can be performed manually. This option is useful when debugging installation problems, particularly on unsupported platforms. Note that this installation method will not attempt to create the database or any tables, although the configuration file will still be written with the supplied database settings.

Locale Settings

For complete Unicode (UTF-8) support, select UTF-8 for all character set settings. Note that this support currently requires a MySQL >= 4.1.1 or PostgreSQL >= 7.1 database server. Please also note that full Unicode support requires PHP >= 4.3.0 compiled with support for the mbstring library (enabled by default in most recent PHP installations). You may experience problems using extended character sets if your server does not meet these requirements.

Your server currently supports mbstring: Yes


The primary language to use for this system. Please consult the OJS documentation if you are interested in support for languages not listed here.







Select any additional languages to support in this system. These languages will be available for use by journals hosted on the site. Additional languages can also be installed at any time from the site administration interface.

The encoding to use for data sent to and received from browsers.

The encoding to use for data sent to and received from the database. This should be the same as the client character set. Note that this capability is only supported with MySQL >= 4.1.1 or PostgreSQL >= 7.1. Select "Not available" if your database server does not meet these requirements.

The encoding to use for data stored in the database. Note that this capability is only supported with MySQL >= 4.1.1 or PostgreSQL >= 7.1. Select "Not available" if your database server does not meet these requirements.

File Settings


Enter full pathname to an existing directory where uploaded files are to be kept. This directory should not be directly web-accessible. Please ensure that this directory exists and is writable prior to installation. Windows path names should use forward slashes, e.g. "C:/myjournal/files".
 

Security Settings


SHA1 is recommended if your system supports it (requires PHP >= 4.3.0).

Administrator Account

This user account will become the site administrator and have complete access to the system. Additional user accounts can be created after installation.

Database Settings

This user account will become the site administrator and have complete access to the system. Additional user accounts can be created after installation.


Database drivers listed in brackets do not appear to have the required PHP extension loaded and installation will likely fail if selected.
Any unsupported database drivers listed above are listed solely for academic purposes and are unlikely to work.

Leave the hostname blank to connect using domain sockets instead of over TCP/IP. This is not necessary with MySQL, which will automatically use sockets if "localhost" is entered, but is required with some other database servers such as PostgreSQL.
 
To use this option your database system must support remote database creation and your user account must have the appropriate permissions to create new databases. If installation fails with this option selected, manually create the database on your server and run the installer again with this option disabled.

Miscellaneous Settings


A unique identifier used to identify metadata records indexed from this site using the Open Archives Initiative Protocol for Metadata Harvesting.