Difference between revisions of "Wikispooks:Site Backup"

From Wikispooks
Jump to navigation Jump to search
m (formatting)
m (typo)
Line 1: Line 1:
{{work|This is a draft page. Backup file to available asap}}
+
{{work|This is a draft page. Backup file to be made available asap}}
 
==Introduction==
 
==Introduction==
 
Wikispooks content renders it less than welcome to powerful interests which may put it at greater than average risk of disruption - legal or otherwise.
 
Wikispooks content renders it less than welcome to powerful interests which may put it at greater than average risk of disruption - legal or otherwise.

Revision as of 16:49, 13 March 2013

Tools.png This is a draft page. Backup file to be made available asap

Introduction

Wikispooks content renders it less than welcome to powerful interests which may put it at greater than average risk of disruption - legal or otherwise.

A full site backup is therefore available to ensure that, should the site - for whatever reason - become unavailable, a reasonably up to date version of it will be held by many people in multiple locations such that it can avoid the 'black-hole' fate that has overtaken other dissident sites - notably Joe Vialls. It should also demonstrate that the site is genuinely open, crowd sourced and free from proprietorial interest and control, other than to police its original editorial policy and project purposes (See the project pages for full information).

With a modicum of technical know-how the backup can be restored to a local machine or simply archived as an insurance against its present iteration disappearing. Anyone setting up a local site can ask to have it configured to automatically synchronise with the main site so that the local copy is always current - email admin[at]wikispooks.org for the necessary credentials etc.

Backup file

The backup is contained in a single Zip file named wsxxxxxxxx.zip where the x's are the date it was created in yyyymmdd format. The file is updated on an ad-hoc basis - hopefully at least one per month.

General

The ws.zip file contains everything needed to reconstitute the Wikispooks site on any web server running both php and MySQL. The main Wikispooks server runs the Apache web server. There will be a number of Apache config parameters that need setting in order for 'pretty urls' to work properly. Full details can be found on the Mediawiki web site. It should be possible to run the site using other web servers but it has only been tested with Apache 2.2.15

Zip file contents

  1. wsRoot.tar - The Wikispooks domain directory structure and contents
  2. ws.sql - The Wikispooks MySQL database dump
  3. configParams.txt - Configuration parameters for appending to the 'LocalSetting.php' file generated by the Mediawiki install procedure. This installs many extensions; defines additional namespaces and ajusts the Mediawiki default access, registration and editing settings.
  4. readme.txt - Instructions

Overview of the Wikispooks 'Mediawiki' software configuration

  • Current installed version 1.16.3
  • There are many Mediawiki extensions in use on the site. In particular 'Widgets', 'Semantic MediaWiki', 'Semantic Forms', 'News', 'DynamicPageList' and 'Category Tree' are fundamental to the proper display and operation of the site. All the software extensions are included in this backup suite.

System requirements for local site operation

  • A smokey machine running a web server (The main Wikispooks site runs Apache v2.2.15)
  • php v 5.0 +
  • MySQL v 5.0 +
  • at least 5 Gb of free disk space

Note: both WampServer and Xampp (Google them) provide all the server software needed to run the Wikispooks site locally.

Basic installation instructions

  • Unpack ws.zip. This will produce just 4 files per 'file contents' above.
  • Create a new blank MySQL database
  • Create a dedicated database user with full privilages; note this user name and password.
  • import the ws.sql database dump into the new database. Note: The file is too large for a default configuration of phpMyAdmin to handle. It is therefore recommended that the MySQL command line be used - something like:
$ mysql -u username -p password -h localhost data-base-name < ws.sql
  • Unpack wsDirs.tar. Note: The full path to the Wikispooks domain root, as it is set up on the Wikispooks Linux server, is included in this backup. It is:
/var/www/vhosts/wikispooks.com/httpdocs

ie for the purposes of a new server setup, 'httpdocs' is the domain root directory. You should move its entire contents to your machine web server root. The easiest way to do this is to move the 'httpdocs' directory and contents to your server root and rename 'httpdocs' to 'wikispooks' or whatever other name takes your fancy.

Important

In order to safeguard the main site database credentials, there is no 'LocalSettings.php' file included in the backup. To get your system working, you will need to go through the standard Mediawiki setup procedure which should initiate when you access the /site-root/w/config' directory with a browser. Successful completion of this prodedure will create a '.../w/LocalSettings.php' file. This is a basic configuration file which will NOT include any of the required extension and other configuration parameters. To complete the configuration and install the required extensions proceed as follows:

  1. Open 'LocalSettings.php' in a text editor.
  2. Copy and paste the entire contents of the 'configParams.txt' file to the end of the 'LocalSettings.php' file
  3. Save the modified file

Notes

  • The Wikispooks installation is set up such that none of it's media files (ie pdf's, doc's jpg's avi's etc) are held in the MySQL database. The database only contains pointers to these files. The files themselves are held in the directory structure below 'server root/w/images' (a bit counter-intuitive, but there you go)
  • The 'Piwik stats' and 'Cablegate mirror' sub menus will not work. Not included in the backup.
  • The 'Anon Uploads Form' option in the left-hand menu will not work. Not included in backup.
  • Many of the in-text links (especially on 'Category:IFrame' pages) will take you to the master Wikispooks site. This is because urls which ought to be coded as relative, have in fact been entered as absolute urls. It is easy to manually change any such url's in your browser address-bar at run time (simply replace 'https://wikispooks.com/' with 'localhost/your_root_dir_name/'. This issue will be addressed at source as and when.
  • Please post any suggestions, queries etc to this discussion page