Jump to content

Project: Redcap; the crossroads of the Order

Project Redcap:Maintenance: Difference between revisions

From Project: Redcap
m Andrew Gronosky moved page Project Redcap:Maintenance Log to Project Redcap:Maintenance: I quickly realized this should include maintenance instructions as well as a log. Therefore the name 'Maintenance log" was too narrow.
Added upgrade procedure
Line 1: Line 1:
This page documents maintenance activity on Project: Redcap. For feature requests or how to report bugs, please see [[Project Redcap: Community Portal]].
This page contains maintenance instructions and logs for the Project: Redcap wiki. It's mostly for administrators.  


== 2025 Maintenance ==
To check the status of the wiki, make a feature request, or report a bug, please refer to [[Project Redcap:Community portal]].
 
== Maintenance Log ==
To see when the next maintenance window is, please refer to [[Project Redcap:Community portal]].
 
=== 2025 Maintenance ===
2025-12-27:
2025-12-27:
* Full database backup (Andrew Gronosky is custodian of the database backups)
* Full database backup (Andrew Gronosky is custodian of the database backups)
Line 7: Line 12:
* Updated all extensions; see [[Special:Version]]
* Updated all extensions; see [[Special:Version]]
* Added extension https://www.mediawiki.org/wiki/Extension:RottenLinks  
* Added extension https://www.mediawiki.org/wiki/Extension:RottenLinks  
The RottenLinks extension didn't work properly on the first try. The admin is looking into it.


2025-03-30:
2025-03-30:
Line 14: Line 21:
* Removed end-of-life extension Ploticus
* Removed end-of-life extension Ploticus
* Updated all other extensions
* Updated all other extensions
* Note for future maintainers: Please verify the [[MediaWiki:License]] page still contains CC-BY-SA 4.0 after the upgrade
 
== Upgrade Procedure ==
The simplest and safest way to update the wiki is to make a fresh install of MediaWiki and migrate the customizations into it.
# [https://www.mediawiki.org/wiki/Manual:Lock_the_database Lock the database]
# Make a full database backup (see LocalSettings.php for the name of the database).
# Archive the database backup in private cloud storage.
# Upload the new MediaWiki distribution zip to <code>public_html</code> and unpack it.
# Rename the newly created <code>mediawiki-X.YY-etc</code> directory to <code>redcap_new</code>.
# <code>cp -R redcap/images/* redcap_new/images</code>
# <code>cp redcap/LocalSettings.php redcap/.htaccess redcap_new</code>
# Check the skins listed in <code>LocalSettings.php</code>. Download and install any that aren't already present in the skins directory.
# Use [[Special:Version]] to view the list of installed extension. For any that are not already present in the <code>/extensions</code> directory, download and unpack the latest versions.
# <code>cd ~/public_html; mv redcap redcap_old; mv redcap_new redcap</code>
# Unlock the database (edit <code>LocalSettings.php</code>
# <code>cd maintance; php run.php update</code>
# Log in with a web browser and see if it works!

Revision as of 09:52, 27 December 2025

This page contains maintenance instructions and logs for the Project: Redcap wiki. It's mostly for administrators.

To check the status of the wiki, make a feature request, or report a bug, please refer to Project Redcap:Community portal.

Maintenance Log

To see when the next maintenance window is, please refer to Project Redcap:Community portal.

2025 Maintenance

2025-12-27:

The RottenLinks extension didn't work properly on the first try. The admin is looking into it.

2025-03-30:

  • Full database backup
  • Wiki upgrade to version 1.43
  • Installed Extension:JsonConfig
  • Removed end-of-life extension Ploticus
  • Updated all other extensions

Upgrade Procedure

The simplest and safest way to update the wiki is to make a fresh install of MediaWiki and migrate the customizations into it.

  1. Lock the database
  2. Make a full database backup (see LocalSettings.php for the name of the database).
  3. Archive the database backup in private cloud storage.
  4. Upload the new MediaWiki distribution zip to public_html and unpack it.
  5. Rename the newly created mediawiki-X.YY-etc directory to redcap_new.
  6. cp -R redcap/images/* redcap_new/images
  7. cp redcap/LocalSettings.php redcap/.htaccess redcap_new
  8. Check the skins listed in LocalSettings.php. Download and install any that aren't already present in the skins directory.
  9. Use Special:Version to view the list of installed extension. For any that are not already present in the /extensions directory, download and unpack the latest versions.
  10. cd ~/public_html; mv redcap redcap_old; mv redcap_new redcap
  11. Unlock the database (edit LocalSettings.php
  12. cd maintance; php run.php update
  13. Log in with a web browser and see if it works!