Difference between revisions of "Wikispooks:Site Backup"
m (t) |
m (should get this done today) |
||
| Line 10: | Line 10: | ||
==Content of the 'Backups' directory== | ==Content of the 'Backups' directory== | ||
| − | + | * Available files are listed in the '''<font face="Serif">Backup files list</font>''' box on the right. The main site backup files are in the form <code>site-YYYY-MM-DD.zip</code> indicating the date taken and there will usually be at least 4 generations of them. The file {{BULink|site-latest.zip}} links to the most up-to-date of the site backups. | |
| − | {| | + | * {{BULink|wikileaks.zip}} contains '''Bit-Torrent''' files for the entire wikileaks site between it's original launch in 2006 to February 2010. |
| − | + | * From time-to-time there may be other [[Wikispooks:About|Wikispooks project]]-related files made available for download. | |
| − | + | ===Notes=== | |
| − | + | '''The following items are ''not'' included in the main site backup files:''' | |
| − | + | * The 'Anon Uploads Form' | |
| − | + | * 'Piwik stats' | |
| − | + | * Wikileaks 'Torrents' - Separate download {{BULink|here|wikileaks.zip}} | |
| − | + | ||
| − | + | ==Setting up and running a Copy Of The Site== | |
| − | + | A single main site backup file contains everything needed to run a copy or mirror of the Wikispooks site on a suitably configured web server. '''[http://httpd.apache.org/ Apache]''' is the web server used by Wikispooks and assumed in these instructions although [http://nginx.org/en/ NginX], [http://www.microsoft.com/web/platform/server.aspx IIS] and other web servers can be configured to run Mediawiki. | |
| − | + | ||
| − | + | ''N.B. Either [http://www.wampserver.com/en/ WampServer] or [http://www.apachefriends.org/en/xampp.html Xampp] provides all the Apache web-server software need to run the Wikispooks site locally on either a Linux or Windows machine.'' | |
| − | + | ===Overview=== | |
| − | + | Set up your web server; create blank MySQL database; download {{BULink|site-latest.zip}} to your server root and unpack it; import file <code>''path-to-server-root''/backups/ws.sql</code> into your blank MySQL database; edit <code>''path-to-server-root''/w/LocalSettings.php</code> and enter your database name and user credentials; navigate to your web-server root from your web browser to browse your local copy of Wikispooks. | |
| + | |||
| + | ====Web server setup==== | ||
| + | To do | ||
| − | == | + | ====Create new MySQL database==== |
| − | To | + | To do |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | == | + | ====Download and unpack site backup==== |
| − | + | *Unzip {{BULink|site-latest.zip}} '''in the web server root directory'''. This will generate many directories and files in and under the web server root. | |
| − | === | + | ====Import the Wikispooks content into your database==== |
| + | Import <code>''path-to-server-root/backups/''ws.sql</code> into the new database. | ||
| + | '''N.B.''' The file is too large for a default configuration of phpMyAdmin to handle. Try a MySQL command for this, e.g. | ||
| + | ::<code>$ mysql -u username -p password -h localhost data-base-name < ws.sql </code> | ||
| + | |||
| + | ====Configure your ''LocalSettings.php'' file==== | ||
| + | To do | ||
| − | + | ==Error reporting== | |
If things don't go smoothly, adding the following lines to LocalSettings.php will give you some diagnostic output: | If things don't go smoothly, adding the following lines to LocalSettings.php will give you some diagnostic output: | ||
::<code>$wgShowExceptionDetails = true;</code> | ::<code>$wgShowExceptionDetails = true;</code> | ||
::<code>$wgShowSQLErrors = 1;</code> | ::<code>$wgShowSQLErrors = 1;</code> | ||
It's recommended to take these lines out once things are working OK. | It's recommended to take these lines out once things are working OK. | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
===Finishing Touches=== | ===Finishing Touches=== | ||
| Line 60: | Line 54: | ||
==Running A Live Site Mirror== | ==Running A Live Site Mirror== | ||
| − | |||
If you have interest and resources to set up a realtime site mirror on your server, you are encouraged to do so. We may also be able to provide you with some technical assistance if needed. Requests for help setting up realtime mirrors should be addressed to <code>admin[at]wikispooks.org</code> and encrypted with [[WikiSpooks:PGP Public Key|'''this key''']]. | If you have interest and resources to set up a realtime site mirror on your server, you are encouraged to do so. We may also be able to provide you with some technical assistance if needed. Requests for help setting up realtime mirrors should be addressed to <code>admin[at]wikispooks.org</code> and encrypted with [[WikiSpooks:PGP Public Key|'''this key''']]. | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
===Known Issues=== | ===Known Issues=== | ||
Revision as of 08:42, 4 June 2015
Even if you are a casual reader and not a contributor to the wikispooks project, you are encouraged to download and keep a backup copy of the site (~2.9Gb) in case it goes offline for any reason. The site is open licenced so you are free to copy it's content and publish it elsewhere, either as an exact mirror or as part of another website. The more people around the world who keep a backup, the better the odds that the site content will not be lost.
Contents
Content of the 'Backups' directory
- Available files are listed in the Backup files list box on the right. The main site backup files are in the form
site-YYYY-MM-DD.zipindicating the date taken and there will usually be at least 4 generations of them. The filesite-latest.ziplinks to the most up-to-date of the site backups. wikileaks.zipcontains Bit-Torrent files for the entire wikileaks site between it's original launch in 2006 to February 2010.- From time-to-time there may be other Wikispooks project-related files made available for download.
Notes
The following items are not included in the main site backup files:
- The 'Anon Uploads Form'
- 'Piwik stats'
- Wikileaks 'Torrents' - Separate download
here
Setting up and running a Copy Of The Site
A single main site backup file contains everything needed to run a copy or mirror of the Wikispooks site on a suitably configured web server. Apache is the web server used by Wikispooks and assumed in these instructions although NginX, IIS and other web servers can be configured to run Mediawiki.
N.B. Either WampServer or Xampp provides all the Apache web-server software need to run the Wikispooks site locally on either a Linux or Windows machine.
Overview
Set up your web server; create blank MySQL database; download site-latest.zip to your server root and unpack it; import file path-to-server-root/backups/ws.sql into your blank MySQL database; edit path-to-server-root/w/LocalSettings.php and enter your database name and user credentials; navigate to your web-server root from your web browser to browse your local copy of Wikispooks.
Web server setup
To do
Create new MySQL database
To do
Download and unpack site backup
- Unzip
site-latest.zipin the web server root directory. This will generate many directories and files in and under the web server root.
Import the Wikispooks content into your database
Import path-to-server-root/backups/ws.sql into the new database.
N.B. The file is too large for a default configuration of phpMyAdmin to handle. Try a MySQL command for this, e.g.
$ mysql -u username -p password -h localhost data-base-name < ws.sql
Configure your LocalSettings.php file
To do
Error reporting
If things don't go smoothly, adding the following lines to LocalSettings.php will give you some diagnostic output:
$wgShowExceptionDetails = true;$wgShowSQLErrors = 1;
It's recommended to take these lines out once things are working OK.
Finishing Touches
The procedure as explained above is sufficient for the database and all the files. There will be a number of Apache config parameters that need setting in order for 'pretty URLs' to work properly, such as a .htaccess file. Full details can be found on the Mediawiki web site.
Running A Live Site Mirror
If you have interest and resources to set up a realtime site mirror on your server, you are encouraged to do so. We may also be able to provide you with some technical assistance if needed. Requests for help setting up realtime mirrors should be addressed to admin[at]wikispooks.org and encrypted with this key.
Known Issues
- You may experience difficulty with file permissions on the images directory during the install process. In this case, you may need to change these permissions. For more details, see http://www.mediawiki.org/wiki/Manual:Security#Upload_security
- Some of the in-text links (especially on 'Category:IFrame' pages) may 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 URLs 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.
- Suggestions, Queries etc? - Either Email the admin (non-WikiSpooks members) or use this discussion page (WikiSpooks members)
| ||||||
|
