codeswitcher

Note to self:

We created a doku subdomain on sb (for some reason, cpanel balked at creating it on dev) to test/stage migration. The wiki is in "~/$phd/doku/". Moved its original "data" directory to "ORIG_data". Moved its original "conf/users.auth.php" to "conf/users.auth.php_ORIG".

To use for upgrades:

0) Backup the Site-to-Be-Upgraded (StBU):

0.1) Find site in File Manager, select whole toplevel folder, select "compress" and give a reasonable name.

1) Stage old data in doku.sb:

1.1) on doku.sb: in "~/$phd/doku/", delete the "data" folder if any (left by previous use of staging to upgrade different site).

1.2) from StBU to doku.sb: copy StbU's "data" folder into doku.sb's ~/$phd/doku/

1.3) on doku.sb: in "~/$phd/doku/", delete the "users.auth.php" if any (left by previous use of staging to upgrade different site).

1.4) from StBU to doku.sb: copy StbU's "conf/users.auth.php" to doku.sb's "~/$phd/doku/conf/users.auth.php"

1.5) Hypothetical: from StBU to doku.sb: copy StbU's "conf/local.php" to doku.sb's "~/$phd/doku/conf/local.php"

1.6) that's it, the upgraded version should be staged on doku.sb: go check to see if you can log in to doku.sb with your tokens from StBU. Do user acceptance testing of StBU on doku.sb. Should be content identical and have all the same users.

2) To promote new version of wiki back to prod:

2.1) on StBU: rename root to "OLD_$root"

2.2) from doku.sb to StBU: copy doku.sb's "~/$phd/doku" into StBU's as "$root".

2.3) go to CPanel, to "MultiPHP Manager", find name of StBU's doman, select, and set to some reasonable version of PHP (currently 8.1 or 8.2)

2.4) that's it, you should have an upgraded version of StBU in prod: go user acceptance test on StBU.

Notes: this blows away user/admin-set configs on StBU. Fix that? [ETA: added copying up the conf/local.php.]

Also, for some reason MultiPHP Manager was happy to set doku.sb to 8.2, but won't set StBU higher than 8.1. Mysterious.