[Koha-bugs] [Bug 23073] wiki.koha-community.org needs updating to a later version

[bugzilla-daemon at bugs.koha-community.org]

https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=23073

--- Comment #24 from Thomas Dukleth <td-koha-bugs at agogme.com> ---
Important bug fix for installing a MediaWiki compliant stable version of PHP
Composer completed a couple of months ago and finally enough incremental
changes for excluding files inappropriate for version control through present
and past commits.  Carefully examining past versions for uniformity of version
control exclusion was tedious but there should be no significant distractions
for a file disappearing as outside the scope of version control and then
reappearing in a later version when exclusion was missed.  Files excluded as
inappropriate for version control are currently available at
https://test01.agogme.com/koha_migrate_mwiki_db_and_upgrade_test.tgz .  Code
and configuration files to test migrating the MediaWiki database and upgrading
the wiki are currently available at
git://test01.agogme.com/koha-migrate-mwiki-db-and-upgrade-test.git .

Anyone interested in testing the code would need to separately obtain a full
dump of the Koha Wiki to avoid publicly compromising Koha Wiki usernames and
passwords which are not contained in the published archive.  The issue of
resetting wgSecretKey in LocalSettings.php could be avoided by obtaining a copy
of the Koha Wiki LocalSettings.php .  I have prepared a special nonpublic tar
archive for Koha developers interested in testing. 

Mason James has been working on code to automatically validate the database
migration.

Test instances have been mostly up for over a year.  They may frequently go
down or become slow when: regenerated for code testing; or excess RAM or CPU
use running some memory intensive processes unrelated to Koha on the VPS. 
Non-Koha use of the VPS starting too many processes still occasionally leads
the OOM killer to stop mysqld for which I should add a monitoring and restart
service for when I forget to check after such excess RAM usage.

Reinstalled test instance of the Koha Wiki using Postgres at
https://koha-mw-pg-test01.agogme.com/ .

Koha test wiki migrated to MySQL at https://koha-mw-my-test01.agogme.com/ .

Koha MySQL test wiki upgraded to MediaWiki 1.35 LTS at
https://koha-mw-my-test01-upgr.agogme.com/ .

Please note that some adjustment of the upgraded wiki, such as the superseded
language change template at the bottom of the home page, may be outside the
ordinary scope of an automated upgrade process and require manual correction. 
The job queue may be full for an extended period after reinstalling or
upgrading a test wiki instance because reindexing is necessary.  Ordering of
search query result set improves with actual use but appears to be ordered by
page creation initially after reindexing rather than page modification or other
potentially more useful relevancy ranking which develops over time as the wiki
instance is used.

>From the current changelog.
In README.txt
-------------

Clarified language and instruction variously.

Added an explanation in installation instructions about obtaining files
from a current git repository, an archive of files inappropriate for
version control, database dump, etc.

Added guidance in installation instructions to clarify what files
currently need to be copied manually and what are examples needing
modification to previous guidance about what is installed automatically.

Added clarification for webserver configuration including testing Apache
and Nginx at the same time with different webserver ports.

Added the importance of starting the Perl script
koha_migrate_mwiki_db_and_upgrade.pl from the shell script
koha_migrate_mwiki_db_and_upgrade_startup.sh to provide better management
and needed logging.

Added a note to the configuration section noting that each of the main
scripts has minimal internal configuration variables for finding the main
configuration and other scripts.

Clarified function of MediaWiki RESTBase in relation to VisualEditor
extension.  VisualEditor works fine without any of the subtle difficulties of
configuring RESTBase to respond when proxied through the webserver.  The
core extension Parsoid is sufficient to run VisualEditor with no
installation or configuration needed.  The only disadvantage without
RESTBase is that diffs may have some extra whitespace or such for
imperfect diffs if switching back and forth between VisualEditor and
WikiText editor before saving.  Given the difficulties of configuring
the wiki editor and Wikitext source editor.  Choose
elude many people.

Added a section for configuration sharing security giving guidance
and a script for substituting example values for security sensitive values
in some configuration files when committing to public source code
repositories.

In koha_migrate_mwiki_db_and_upgrade_startup.sh
---------------------------------------

Added bash script to control startup of migration and installation to log
STDOUT and STDERR.

In koha_migrate_mwiki_db_and_upgrade.pl
---------------------------------------

Corrected for temporary file inadvertantly created when creating download
directory for upgraded MediaWiki installation archive.

Corrections for moving binary files and other files not suitable for
version control to a separate archive from version control files.

Improved elapsed time reporting.

Standard date and time reporting.

In LocalSettings.php
--------------------

Commented out RESTBase configuration which has subtle configuration
difficulties and substituted Parsoid configuration without RESTBase as
sufficient for VisualEditor extension.

Added localhost specification for page editing as the editor runs on
localhost.  Configuring page editing to specify the IP address from
which the editor runs corrects for a problem otherwise preventing
editing of spam protected pages with editing restrictions such as we have
on the home page to prevent newly created accounts from immediately
editing the home page.

SearchBox.mustache
------------------

Changed the category excluded from the SimpleSearch form for dynamically
archived content to Obsolete which has already been in use.

koha_mwiki_instances_postinstall.sh
-----------------------------------

Corrected installation of PHP composer to function more resiliantly in a
script and set version to a stable point which avoids errors with
MediaWiki.

In etc/apache2
--------------

Changed listen port numbers for example Apache 2 configuration files to
allow testing along with testing Nginx.

In etc/nginx
------------

Example nginx configuration files.

In koha_migrate_mwiki_db_and_upgrade_FOREXPORT.sh
---------------------------------------

Added bash script to remove nonpublic elements from config files
substituting public configuration examples for each of the nonpublic
values in the following configuration line.  The preceding line with
a public configuration example starts with "# FOREXPORT # ".

-- 
You are receiving this mail because:
You are watching all bug changes.