Upgrading your Open Journal Systems (OJS) installation ensures you have the latest features, security patches, and performance improvements. If you’re running OJS 3.2.x and need to upgrade to version 3.3.0-20, this guide provides a clear, step-by-step process to minimize downtime and avoid data loss.
Before proceeding, ensure you have:
- SSH access to your server
- A recent backup of your OJS files and database
- Basic command line knowledge
Step 1: Put Your Site in Maintenance Mode
Before making changes, prevent user access to avoid data inconsistencies:
- Add a maintenance message in
indexPage.tpl - Use .htaccess rules to restrict access temporarily
Step 2: Take a Full Backup
A complete backup is crucial – PKP recommends backing up both files and database.
Backup OJS Files
Backup the Files Directory
Locate your files_dir path in config.inc.php and back it up separately.
Backup the Database
Step 3: Download and Extract OJS 3.3.0-20
Step 4: Copy Over Important Files
From your old installation (/var/www/html), copy these to the new folder:
config.inc.phppublic/directory- Any custom plugins or themes
Step 5: Replace the Old Codebase
Step 6: Run the Upgrade Script
Execute from the new OJS directory:
Monitor for errors – check PKP forums if issues occur.
Step 7: Clear Cache and Check Logs
Step 8: Test the Site
- Visit your site in a browser
- Log in as admin
- Verify journals and submissions
- Test all plugins and themes
Step 9: Remove Old Files (Optional)
Once confirmed working, you may delete the backup or keep it temporarily.
Need Help With Your OJS Upgrade?
If you encounter issues:
- Consult the PKP Documentation
- Post in the PKP Community Forum
- Consider professional support for complex setups
For optimal performance after upgrading, consider these optimization tips from PKP.
