Professional Documents
Culture Documents
About
----Open Journal Systems (OJS) has been developed by the Public Knowledge
Project.
For general information about OJS and other open research systems, visit the
PKP web site at <http://pkp.sfu.ca/>.
License
------OJS is licensed under the GNU General Public License v2. See the file
docs/COPYING for the complete terms of this license.
Third parties are welcome to modify and redistribute OJS in entirety or parts
according to the terms of this license. PKP also welcomes patches for
improvements or bug fixes to the software.
System Requirements
------------------Recommended server requirements:
* PHP >= 4.2.x (including PHP 5.x); Microsoft IIS requires PHP 5.x
* MySQL >= 4.1 or PostgreSQL >= 8.0
(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. We welcome feedback from users who have deployed OJS on
systems
other than those listed above.
Recommended Configuration
-------------------------
the OJS installation and cannot be accessed directly via the web
server. Restrict file permissions as much as possible. Automated
backups of this directory should be roughly synchronized with
database backups.
Installation
-----------Please review this document and the RELEASE document prior to installing OJS.
If you encounter problems, please also see the FAQ document in this directory.
To install OJS:
4. Review and apply the patches recommended for your version of OJS.
<http://pkp.sfu.ca/wiki/index.php/OJS_Recommended_Patches>
To apply a recommended patch, open the bug report and download the
attached patch file(s). (Note that bug reports can quite often include
a number of patches, some relevant to the application (ie. OJS) and
version you are running, and some not. Ensure that you download all
and only the patches specific to your application and version.) For
each patch you download, first attempt a dry-run application of the
patch, to ensure that it applies cleanly:
If the patch applies cleanly, then run the following command, which
will actually apply the patch:
"PATCH_FILE" should be replaced with the path to the patch file that
was downloaded, e.g. "6276-ojs.patch".
Upgrading
--------See docs/UPGRADE for information on upgrading from previous OJS 1.x and OJS
2.x
releases.
Localization
-----------To add support for other languages, the following sets of XML files must be
localized and placed in an appropriately named directory (using ISO locale
* locale/en_US
* help/en_US
* registry/locale/en_US
* rt/en_US
* plugins/[plugin category]/[plugin name]/locale, where applicable
The only critical files that need translation for the system to function
properly are found in locale/en_US and registry/locale/en_US.
New locales must also be added to the file registry/locales.xml, after which
they can be installed in the system through the site administration web
interface.
Scheduled Tasks
--------------OJS supports a mechanism to execute a variety of tasks at scheduled times
(such as automatic sending of reminder notification emails).
To enable support for using scheduled tasks, edit your config.inc.php and
set the scheduled_tasks setting to On, and set up your operating system to
periodically execute (as the same user your webserver is running under) the
PHP script found at tools/runScheduledTasks.php in your OJS directory:
On *nix operating systems, this can be done by adding a simple cron task:
# crontab -e www
0****
php /path/to/ojs2/tools/runScheduledTasks.php
Note that using the script also requires you to have the PHP command-line
interpreter installed on your server.
Third-party Libraries
--------------------* See lib/pkp/lib/libraries.txt for a list of third-party libraries
used by OJS.
Contact/Support
--------------The forum is the recommended method of contacting the team with technical
issues.
Forum: <http://forum.pkp.sfu.ca/>
Bugs: <https://github.com/pkp/pkp-lib#issues>
Email: <pkp.contact@gmail.com>