restore_wiki_procedure
Table of Contents
Restore Wiki Procedure
- Create new site
- [Terminal] Run
& 'D:\Bin\Rimu\General Scripts\Refresh Local Wiki.ps1'
- [Rimu] Open a Windows Explorer at the backup location (
D:\Backups\Wiki\Full\data\pages
) - [Browser] Find the most recently changed wiki page and check that the back up has the change (
wiki\data\pages
). - [Browser] Download the latest version of the Wiki software. Toggle off all the languages and click 'Start Download' at the bottom of the page.
- [Rimu] Extract files, rename root directory to
dokuwiki
(if necessary), and move to Downloads (C:\Users\micro\Downloads
). - [Terminal] Run
& 'D:\Bin\Rimu\General Scripts\Prepare New Wiki.ps1'
- Backup site
- [Browser] Start a File Manager.
- [Browser,File Manager] Navigate to
site > backups
. - [Browser,File Manager] Delete
20240717_wiki.tar.gz
. - [Browser] Start an Debug Console (Bash).
- [Browser,Bash]
tar -czf site/backups/20240717_wiki.tar.gz site/wwwroot
[Update date]. - [Browser,Bash]
ls -l site/backups/
- Check backup file exists and is about 60 MB.
- Delete site
- [Browser,Bash]
rm -rf – site/wwwroot && mkdir site/wwwroot
- This may take a while. - [Browser,File Manager] Refresh, navigate to
site > wwwroot
, verify everything is gone.
- Upload new site
- [Rimu] Drag
C:\Users\micro\Downloads\dokuwiki\wiki.zip
to the right side of File Manager. - It should extract itself, but it takes ages. Seriously, 10 mins or something.
- [Browser,File Manager] Refresh, navigate to
site > wwwroot
, verify everything is there. - [Browser,File Manager] Delete the
wiki.zip
file (if it still exists).
- Smoke test
- [Browser] Open this page in a new tab.
- Set up
- [Browser (private session)] Go to the wiki and log on as admin.
- [Browser (private session)] Go to Admin → Searchindex Manager → Rebuild index.
- [Browser (private session)] Go to Admin → Template Style Settings.
- [Browser (private session)] Set 'The width of the full site' to
120em
. - [Browser (private session)] Go to the Admin → Extension Manager page.
- [Browser (private session)] Remove unused plugins, update plugins that require updating.
- Testing
- [Browser] Verify the plugins work (see Plugin Checks below).
- [Browser] Verify search works (including private pages).
- [Browser] Verify old revisions work and page comparison.
- [Browser] Verify editing a page and previewing an edited page works.
- Clean up
- [Rimu] Delete the contents of
D:\Backups\Wiki\Full
(but not the directory). - [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
- Verify the tags at the bottom of this page are okay.
- Click one to verify tag lists are okay.
- Try this link.
Pagelist Plugin
This should look okay:
2009/11/25 02:39 | Stephen Heise | |
2009/01/14 00:51 | Stephen Heise | |
2009/01/14 00:57 | Stephen Heise | |
2009/12/25 09:48 | Stephen Heise | |
2009/11/24 22:48 | Stephen Heise | |
2009/01/14 00:45 | Stephen Heise | |
2009/09/18 06:15 | Stephen Heise | |
2009/01/14 00:47 | Stephen Heise | |
2009/02/02 04:12 | Stephen Heise | |
2009/01/14 23:57 | Stephen Heise | |
2009/01/14 23:55 | Stephen Heise | |
2010/10/05 20:02 | Stephen Heise | |
2009/09/23 04:59 | Stephen Heise | |
2009/01/14 23:58 | Stephen Heise | |
2010/03/14 22:11 | Stephen Heise | |
2009/11/04 20:44 | Stephen Heise | |
2010/04/27 22:42 | Stephen 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
- Check the web server can serve an image.
- Check the web server can serve a basic PHP page.
- 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.
- [FileZilla] Delete everything from
/site/wwwroot/lib/plugins
. - [FileZilla] Download a fresh copy of the wiki and upload the
plugins
directory. - [Browser] Log into wiki as admin, go to the Extension Manager
- [Browser] Search and install all the plugins list above.
- [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.
- [Ares] Open
wiki/lib/plugins/searchindex/ajax.php
in Notepad++. - [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);
- [Notepad++] Save new version of the file.
restore_wiki_procedure.txt · Last modified: 2024/07/17 07:03 by stephen