Differences

This shows you the differences between two versions of the page.

--- restore_wiki_procedure [2014/01/02 09:02] – [Tag Plugin] stephen
+++ restore_wiki_procedure [2024/07/17 07:03] (current) – stephen
@@ Line 1: / Line 1: @@
 ====== Restore Wiki Procedure ======
-  - [//Zeus//] Plug in Flicky.
+  - Create new site
-  - [//Zeus//] Win + Alt + F6, ''Refresh Local Wiki.bat''.
+    - [//Terminal//] Run ''& 'D:\Bin\Rimu\General Scripts\Refresh Local Wiki.ps1' ''
-  - [//Zeus//] Open a Windows Explorer at the backup location (''C:\External Drives\Primary Media 2\Backups\Wiki\Full\www.tallguyracing.com\'')
+    - [//Rimu//] Open a Windows Explorer at the backup location (''%%D:\Backups\Wiki\Full\data\pages%%'')
-  - [//Firefox//] Find the most [[http://tallguyracing.com/wiki/doku.php?do=recent|recently changed wiki page]] and check that the back up has the change (''wiki\data\pages'').
+    - [//Browser//] Find the most [[http://tallguyracing-wiki.azurewebsites.net/doku.php?do=recent|recently changed wiki page]] and check that the back up has the change (''wiki\data\pages'').
-  - [//Firefox//] Download the latest version of the [[http://download.dokuwiki.org/|Wiki software]].
+    - [//Browser//] Download the latest version of the [[http://download.dokuwiki.org/|Wiki software]]. Toggle off all the languages and click 'Start Download' at the **bottom** of the page.
-  - [//Zeus//] Extract to a temp directory and rename root directory to ''wiki''.
+    - [//Rimu//] Extract files, rename root directory to ''dokuwiki'' (if necessary), and move to Downloads (''C:\Users\micro\Downloads'').
-  - [//Zeus//] Compare ''wiki\conf'' with new wiki and copy/merge
+    - [//Terminal//] Run ''& 'D:\Bin\Rimu\General Scripts\Prepare New Wiki.ps1' ''
-    - ''acl.auth.php''
+  - Backup site
-    - ''local.php''
+    - [//Browser//] Start a [[https://tallguyracing-wiki.scm.azurewebsites.net/newui/fileManager#|File Manager]].
-    - ''users.auth.php''
+    - [//Browser,File Manager//] Navigate to ''site > backups''.
-  - [//Zeus//] Copy ''wiki\data\attic'' from back up to new wiki.
+    - [//Browser,File Manager//] Delete ''20240717_wiki.tar.gz''.
-  - [//Zeus//] Copy ''wiki\data\media'' from back up to new wiki.
+    - [//Browser//] Start an [[https://tallguyracing-wiki.scm.azurewebsites.net/newui/fileManager#|Debug Console]] (Bash).
-  - [//Zeus//] Copy ''wiki\data\meta'' from back up to new wiki.
+    - [//Browser,Bash//] ''tar -czf site/backups/20240717_wiki.tar.gz site/wwwroot'' [Update date].
-  - [//Zeus//] Copy ''wiki\data\pages'' from back up to new wiki.
+    - [//Browser,Bash//] ''ls -l site/backups/'' - Check backup file exists and is about 60 MB.
-  - [//Zeus//] Copy ''wiki\lib\plugins\term'' from back up to new wiki. This plugin can not be installed automatically.
+  - Delete site
-  - [//Zeus//] Copy ''Dropbox\Application Settings\Wiki\style.local.ini'' from **Flicky** to ''wiki\lib\tpl\dokuwiki'' on the new wiki.
+    - [//Browser,Bash//] ''rm -rf -- site/wwwroot && mkdir site/wwwroot'' - This may take a while.
-  - [//Zeus//] Delete all ''.listing'' files from new wiki.
+    - [//Browser,File Manager//] Refresh, navigate to ''site > wwwroot'', verify everything is gone.
-  - [//Zeus//] Delete ''wiki\install.php''.
+  - Upload new site
-  - [//Zeus//] <del>Delete ''wiki\inc\lang\*'' except ''en''.</del>
+    - [//Rimu//] Drag ''C:\Users\micro\Downloads\dokuwiki\wiki.zip'' to the **right side** of //File Manager//.
-  - [//Zeus//] <del>Delete ''wiki\lib\plugings\*\lang\*'' except ''en''.</del>
+    - It should extract itself, but it takes ages. Seriously, 10 mins or something.
-  - [//Firefox//] Download the latest version of the [[http://wiki.splitbrain.org/plugin:comment|Comment Plugin]] (this plugin can not be added automatically).
+    - [//Browser,File Manager//] Refresh, navigate to ''site > wwwroot'', verify everything is there.
-  - [//Zeus//] Extract to a temp directory and rename the root directory (the one containing the ''syntax.php'' file) to ''Comment''.
+    - [//Browser,File Manager//] Delete the ''wiki.zip'' file (if it still exists).
-  - [//Zeus//] Copy to the ''wiki\lib\plugins'' directory in the new wiki.
+  - Smoke test
-  - [//Zeus//] Zip the wiki.
+    - [//Browser//] Open [[https://tallguyracing-wiki.azurewebsites.net/doku.php?id=restore_wiki_procedure|this page]] in a **new tab**.
-  - [//Chrome//] Open GoDaddy's [[https://hostingmanager.secureserver.net/AccountPanel2.aspx?accountuid=EC8BBB2A-467E-413A-B4F1-06EB6D09CFE4|File Manager]].
+  - Set up
-  - [//GoDaddy File Manager//] Delete ''/wikiold_*''.
+    - [//Browser (private session)//] Go to the [[http://tallguyracing-wiki.azurewebsites.net/doku.php|wiki]] and log on as admin.
-  - [//GoDaddy File Manager//] Rename ''/wiki'' to ''/wikiold_20110402''.
+    - [//Browser (private session)//] Go to Admin -> [[http://tallguyracing-wiki.azurewebsites.net/doku.php?id=start&do=admin&page=searchindex|Searchindex Manager]] -> Rebuild index.
-  - [//GoDaddy File Manager//] Create ''/wiki''.
+    - [//Browser (private session)//] Go to Admin -> [[https://tallguyracing-wiki.azurewebsites.net/doku.php?id=restore_wiki_procedure&do=admin&page=styling|Template Style Settings]].
-  - [//GoDaddy File Manager//] Upload wiki zip file to ''/wiki''.
+    - [//Browser (private session)//] Set 'The width of the full site' to ''120em''.
-  - [//GoDaddy File Manager//] Extract the wiki zip file to ''/wiki''.
+    - [//Browser (private session)//] Go to the Admin -> [[http://tallguyracing-wiki.azurewebsites.net/doku.php?id=start&do=admin&page=extension|Extension Manager]] page.
-  - [//GoDaddy File Manager//] Delete the the wiki zip file.
+    - [//Browser (private session)//] Remove unused plugins, update plugins that require updating.
-  - [//Internet Explorer//] Go to the [[http://tallguyracing.com/wiki/doku.php|wiki]] and log on as admin.
+  - Testing
-  - [//Internet Explorer//] Go to Admin -> Manage Plugins and install the following plugins:
+    - [//Browser//] Verify the plugins work (see [[#plugin_checks|Plugin Checks]] below).
-    - [[http://wiki.splitbrain.org/plugin:pagelist|Pagelist Plugin]]
+    - [//Browser//] Verify [[http://tallguyracing-wiki.azurewebsites.net/data/pages/wiki/dokuwiki.txt|this file]] is *not* accessible. If it is, something is wrong with web.config file. See [[https://www.dokuwiki.org/security|here]] for more info.
-    - [[http://www.dokuwiki.org/plugin:searchindex|Searchindex Manager]]
+    - [//Browser//] Verify search works (including private pages).
-    - [[http://www.dokuwiki.org/plugin:tag|Tag Plugin]]
+    - [//Browser//] Verify old revisions work and page comparison.
-    - [[http://www.dokuwiki.org/plugin:editx|Editx Plugin]]
+    - [//Browser//] Verify editing a page and previewing an edited page works.
-    - [[http://www.foosel.org/snippets/dokuwiki/blockquote#with_plugin_manager|Blockquote Plugin]]
+  - Clean up
-  - Fix the Searchindex Manager plugin:
+    - [//Rimu//] Delete the contents of ''%%D:\Backups\Wiki\Full%%'' (but not the directory).
-    - [//GoDaddy File Manager//] Download wiki/lib/plugins/searchindex/ajax.php and open in Notepad++.
+    - [//Terminal//] Run ''& 'C:\Bin\Rimu\General Scripts\Refresh Local Wiki.ps1' ''
-    - [//Notepad++//]Add the sleep line of code near the bottom of the file:<code php>    // do the work
-    $success = idx_addPage($_POST['page'], false, $force);
+===== Style Checks =====
-    sleep(5);</code>
-    - [//GoDaddy File Manager//] Upload new version of the file.
+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''
-  - [//Internet Explorer//] Go to Admin -> Searchindex Manager -> Rebuild index.
-  - [//GoDaddy File Manager//] Delete everything in ''/wiki/data/cache'' except the ''_dummy'' file.
-  - [//Firefox//] Verify the plugins work (see [[#plugin_checks|Plugin Checks]] below).
-  - [//Firefox//] Verify search works (including private pages).
-  - [//Firefox//] Verify old revisions work and page comparison.
-  - [//Firefox//] Verify editing a page and previewing an edited page works.
-  - [//Zeus//] Delete the contents of ''C:\External Drives\Primary Media 2\Backups\Wiki\Full\www.tallguyracing.com\wiki''.
-  - [//Zeus//] Win + Alt + F6, ''Refresh Local Wiki.bat''.
 ===== Plugin Checks =====
-==== Comment Plugin ====
+==== Comment Syntax Plugin ====
-Verify there is nothing after this line. /* The comment plugin is not working. */
+Verify there is nothing after this line. /* The Comment Syntax plugin is not working. */
 ==== Tag Plugin ====
-Verify the tags at the bottom of this page are okay. Click one to verify tag lists are okay.
   - Verify the tags at the bottom of this page are okay.
   - Click one to verify tag lists are okay.
-  - Try [[http://tallguyracing.com/wiki/doku.php?id=tag:code_snippet&do=showtag&tag=code_snippet|this link]].
+  - Try [[https://tallguyracing-wiki.azurewebsites.net/doku.php?id=tag:code_snippet&do=showtag&tag=code_snippet|this link]].
 ==== Pagelist Plugin ====
@@ Line 74: / Line 64: @@
 {{topic>code_snippet -archived}}
-==== Term Plugin ====
+==== Blockquote Plugin ====
 This should look okay:
-<term WTF>what the fuck</term>
+<blockquote>Your male and female slaves are to come from the nations around you; from them you may buy slaves.<cite>[[http://www.biblegateway.com/passage/?search=Leviticus%2025:44&version=NIV|Leviticus 25:44 OT (New International Version)]]</cite></blockquote>
-"I dunno WTF he is on about."
+==== Move ====
-==== Blockquote Plugin ====
+Ensure there is a paint brush icon with 'Rename Page' attached to this page at the top right.
-This should look okay:
+===== Plugin List =====
-<blockquote>Your male and female slaves are to come from the nations around you; from them you may buy slaves.<cite>[[http://www.biblegateway.com/passage/?search=Leviticus%2025:44&version=NIV|Leviticus 25:44 OT (New International Version)]]</cite></blockquote>
+    - [[http://www.foosel.org/snippets/dokuwiki/blockquote#with_plugin_manager|Blockquote Plugin]]
+    - [[http://www.dokuwiki.org/plugin:commentsyntax|Comment Syntax Plugin]].
+    - [[https://www.dokuwiki.org/plugin:move|Move Plugin]]
+    - [[http://wiki.splitbrain.org/plugin:pagelist|Pagelist Plugin]]
+    - [[http://www.dokuwiki.org/plugin:searchindex|Searchindex Manager]]
+    - [[http://www.dokuwiki.org/plugin:tag|Tag Plugin]]
+===== Troubleshooting =====
+  - Check the web server can serve an [[https://tallguyracing-wiki.azurewebsites.net/test.jpg|image]].
+  - Check the web server can serve a [[https://tallguyracing-wiki.azurewebsites.net/test.php|basic PHP page]].
+  - Logs. Probably have to [[https://portal.azure.com/#@09e59351-6930-4410-a75a-e4a8ea2fa4c6/resource/subscriptions/2f06a290-7493-4b82-bb45-3387c0b6b2ec/resourceGroups/Aussie/providers/Microsoft.Web/sites/TallGuyRacing-Wiki/appservicelogs|enable logging]] first. Can view either the [[https://portal.azure.com/#@09e59351-6930-4410-a75a-e4a8ea2fa4c6/resource/subscriptions/2f06a290-7493-4b82-bb45-3387c0b6b2ec/resourceGroups/Aussie/providers/Microsoft.Web/sites/TallGuyRacing-Wiki/logStream|Portal Log Stream]] or the [[https://tallguyracing-wiki.scm.azurewebsites.net/api/logstream|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 [[http://tallguyracing-wiki.azurewebsites.net/doku.php?id=start&do=admin&page=extension|Extension Manager]]
+  - [//Browser//] Search and install all the plugins list above.
+  - [//Browser//] Go to [[http://tallguyracing-wiki.azurewebsites.net/doku.php?id=start&do=admin&page=searchindex|Searchindex Manager]], rebuild index.
-==== Editx ====
+===== Rate Limiting the Searchindex Manager plugin =====
-Edit a page and verify that there is a 'page management' title and link at the bottom of the page.
+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:<code php>    // do the work
+  $success = idx_addPage($_POST['page'], false, $force);
+  sleep(5);</code>
+  - [//Notepad++//] Save new version of the file.
 {{tag>wiki meta admin backup restore}}