LP#1790923: disable XUL staff client by default
authorGalen Charlton <gmc@equinoxinitiative.org>
Wed, 5 Sep 2018 20:29:22 +0000 (16:29 -0400)
committerBill Erickson <berickxx@gmail.com>
Thu, 6 Sep 2018 21:27:25 +0000 (17:27 -0400)
commit23fd5ef82afefa0732df9f4f386888ccffad8b1a
tree25c3a868466f7ecef2b871ac739ae373f779de22
parent81324a87efcaa46b2d4bf289d04280eacf7be625
LP#1790923: disable XUL staff client by default

This patch discourages use of the legacy XUL staff client
by adjusting the installation process so that a versioned XUL
server directory is not created. Instead, by default XUL
server files (which is still needed by a few web staff client
interfaces) end up in /openils/var/web/xul/legacy. During installation
and upgrade, the /openils/var/web/xul/server symbolic link is
set to point to /openils/var/web/xul/legacy/server if possible.

If for some reason a given installation of Evergreen 3.2.x does not
wish to stop using the XUL staff client, STAFF_CLIENT_STAMP_ID
can still be provided during the 'make install' step, and the
make_release script can still create the XUL client installers
if given the -x switch.

Note, however, that use of the XUL staff client in 3.2.x is
NOT RECOMMENDED and no longer under any guarantee of community
support.

To test
-------
[1] Perform a fresh installation and verify that /openils/var/web/xul/legacy
    is created and that /openils/var/web/xul/server is a symlink
    pointing to /openils/var/web/xul/legacy/server.
[2] Verify that the web staff client works and that the
    user permissions editor in particular continues to work.
[3] Perform an upgrade; verify that /openils/var/web/xul/legacy exists
    and that if /openils/var/web/xul/server started out as a symlink,
    it has been repointed.

Signed-off-by: Galen Charlton <gmc@equinoxinitiative.org>
Signed-off-by: Bill Erickson <berickxx@gmail.com>
Open-ILS/xul/staff_client/Makefile.am
docs/installation/server_installation.adoc
docs/installation/server_upgrade.adoc