Table of Contents

Restore Wiki Procedure

  1. Create new site
    1. [Terminal] Run & 'D:\Bin\Rimu\General Scripts\Refresh Local Wiki.ps1'
    2. [Rimu] Open a Windows Explorer at the backup location (D:\Backups\Wiki\Full\data\pages)
    3. [Browser] Find the most recently changed wiki page and check that the back up has the change (wiki\data\pages).
    4. [Browser] Download the latest version of the Wiki software. Toggle off all the languages and click 'Start Download' at the bottom of the page.
    5. [Rimu] Extract files, rename root directory to dokuwiki (if necessary), and move to Downloads (C:\Users\micro\Downloads).
    6. [Terminal] Run & 'D:\Bin\Rimu\General Scripts\Prepare New Wiki.ps1'
  2. Backup site
    1. [Browser] Start a File Manager.
    2. [Browser,File Manager] Navigate to site > backups.
    3. [Browser,File Manager] Delete 20240717_wiki.tar.gz.
    4. [Browser] Start an Debug Console (Bash).
    5. [Browser,Bash] tar -czf site/backups/20240717_wiki.tar.gz site/wwwroot [Update date].
    6. [Browser,Bash] ls -l site/backups/ - Check backup file exists and is about 60 MB.
  3. Delete site
    1. [Browser,Bash] rm -rf – site/wwwroot && mkdir site/wwwroot - This may take a while.
    2. [Browser,File Manager] Refresh, navigate to site > wwwroot, verify everything is gone.
  4. Upload new site
    1. [Rimu] Drag C:\Users\micro\Downloads\dokuwiki\wiki.zip to the right side of File Manager.
    2. It should extract itself, but it takes ages. Seriously, 10 mins or something.
    3. [Browser,File Manager] Refresh, navigate to site > wwwroot, verify everything is there.
    4. [Browser,File Manager] Delete the wiki.zip file (if it still exists).
  5. Smoke test
    1. [Browser] Open this page in a new tab.
  6. Set up
    1. [Browser (private session)] Go to the wiki and log on as admin.
    2. [Browser (private session)] Go to Admin → Searchindex Manager → Rebuild index.
    3. [Browser (private session)] Go to Admin → Template Style Settings.
    4. [Browser (private session)] Set 'The width of the full site' to 120em.
    5. [Browser (private session)] Go to the Admin → Extension Manager page.
    6. [Browser (private session)] Remove unused plugins, update plugins that require updating.
  7. Testing
    1. [Browser] Verify the plugins work (see Plugin Checks below).
    2. [Browser] Verify this file is *not* accessible. If it is, something is wrong with web.config file. See here for more info.
    3. [Browser] Verify search works (including private pages).
    4. [Browser] Verify old revisions work and page comparison.
    5. [Browser] Verify editing a page and previewing an edited page works.
  8. Clean up
    1. [Rimu] Delete the contents of D:\Backups\Wiki\Full (but not the directory).
    2. [Terminal] Run & 'C:\Bin\Rimu\General Scripts\Refresh Local Wiki.ps1'

Style Checks

A Code bit should look good. It is defined in /site/wwwroot/conf/userall.css which should come from D:\Bin\Common\Wiki Site Root Files\conf\userall.css

Plugin Checks

Comment Syntax Plugin

Verify there is nothing after this line.

Tag Plugin

  1. Verify the tags at the bottom of this page are okay.
  2. Click one to verify tag lists are okay.
  3. Try this link.

Pagelist Plugin

This should look okay:

2009/11/25 02:39Stephen Heise
2009/01/14 00:51Stephen Heise
2009/01/14 00:57Stephen Heise
2009/12/25 09:48Stephen Heise
2009/11/24 22:48Stephen Heise
2009/01/14 00:45Stephen Heise
2009/09/18 06:15Stephen Heise
2009/01/14 00:47Stephen Heise
2009/02/02 04:12Stephen Heise
2009/01/14 23:57Stephen Heise
2009/01/14 23:55Stephen Heise
2010/10/05 20:02Stephen Heise
2009/09/23 04:59Stephen Heise
2009/01/14 23:58Stephen Heise
2010/03/14 22:11Stephen Heise
2009/11/04 20:44Stephen Heise
2010/04/27 22:42Stephen Heise

Blockquote Plugin

This should look okay:

Your male and female slaves are to come from the nations around you; from them you may buy slaves.Leviticus 25:44 OT (New International Version)

Move

Ensure there is a paint brush icon with 'Rename Page' attached to this page at the top right.

Plugin List

Troubleshooting

  1. Check the web server can serve an image.
  2. Check the web server can serve a basic PHP page.
  3. Logs. Probably have to enable logging first. Can view either the Portal Log Stream or the Kudu Log Stream. Not sure which works better. Takes a while to come through.

Plugins

Last time it was the plugins that broke the wiki.

  1. [FileZilla] Delete everything from /site/wwwroot/lib/plugins.
  2. [FileZilla] Download a fresh copy of the wiki and upload the plugins directory.
  3. [Browser] Log into wiki as admin, go to the Extension Manager
  4. [Browser] Search and install all the plugins list above.
  5. [Browser] Go to Searchindex Manager, rebuild index.

Rate Limiting the Searchindex Manager plugin

This probably doesn't need to be done, now that the wiki is hosted on Azure.

  1. [Ares] Open wiki/lib/plugins/searchindex/ajax.php in Notepad++.
  2. [Notepad++] Add the sleep line of code near the bottom of the file:
        // do the work
      $success = idx_addPage($_POST['page'], false, $force);
      sleep(5);
  3. [Notepad++] Save new version of the file.