Manual:Backing up a wiki/es

Es importante que de forma periódica hagas una copia de seguridad de los datos de tu wiki. Esta página describe este proceso para un wiki típico basado en MediaWiki; probablemente quieras hacerte tus propios scripts que se encarguen de esto automáticamente, o usar una frecuencia distinta para esta tarea según el tamaño de tu wiki y tus necesidades particulares.

Sumario
MediaWiki guarda información importante en dos lugares:
 * La base de datos
 * Las páginas y su contenido, los usuarios y sus preferencias personales, metadatos, índice de búsqueda, etc.


 * Sistema de archivos
 * Archivos de configuración del software, apariencias personalizadas, extensiones, imágenes y archivos multimedia (incluyendo los archivos borrados), etc.

Deberías poner tu wiki en modo lectura antes de empezar a crear la copia: mira. Esto garantizará que todas las partes de tu copia de seguridad sean consistentes, aunque algunas de las extensiones que tengas instaladas puedan escribir información al disco de todos modos.



Transferencia de archivos
Tendrás que elegir un método para transferir los archivos desde el servidor en el que se encuentran:


 * En el caso de información que no sea privada, puedes simplemente publicarla en archive.org y/o en un directorio  de tu servidor web.
 * SCP (o WinSCP), SFTP / FTP o cualquier otro protocolo de transferencia que elija.
 * La empresa que hospeda el wiki podría a lo mejor ofrecer una interfaz administrativa accesible con un navegador; consúltales.

Base de datos
La mayor parte de la información vital que contiene el wiki se encuentra en la base de datos, de la cual normalmente es bastante sencillo hacer una copia de seguridad. Cuando se usa el MySQL o MariaDB backend, la base de datos se puede volcar en un archivo de script que se puede usar más tarde para recrear la base de datos y todos los datos que contiene desde cero. If your wiki is currently offline, its database can be backed up by simply copying the database file.

When using the default MySQL or MariaDB backend, the database can be dumped into a script file which can be used later to recreate the database and all the data in it from scratch.

Automysqlbackup
Ver el paquete en Debian:

Instalar el paquete:

Todas tus bases de datos serán salvadas en /var/lib/automysqlbackup/:

Copia de seguridad manual:

Restaurar una base de datos:

Para otras distribuciones, busca en Sourceforge.



Mysqldump desde la línea de comandos
La forma más práctica de crear un volcado de la base de datos que quieres copiar es usar la herramienta de volcado estándar de MySQL mysqldump desde la línea de comandos. Asegúrate de usar los parámetros correctos, o tendrás problemas para restaurar la base de datos. Dependiendo del tamaño de la base de datos, mysqldump puede tardar un tiempo considerable.

Antes de nada, añade una línea como esta a LocalSettings.php:

Puedes quitar esa línea en cuanto concluya el proceso de volcado de información.

Ejemplo del comando a ejecutar en la línea de comandos de Linux/UNIX:

mysqldump -h hostname -u userid -p --default-character-set=whatever dbname > backup.sql

Sustituye,  ,   y   según corresponda. All four may be found in your (LSP) file. may be found under ; by default it is localhost. may be found under,  may be found under , where it is listed after. If  is not specified mysqldump will likely use the default of utf8, or if using an older version of MySQL, latin1. While  may be found under. After running this line from the command line mysqldump will prompt for the server password (which may be found under in LSP).

Mira la documentación de mysqldump para ver una lista completa de los parámetros que admite el comando.

La salida de mysqldump puede pasarse por tubería a gzip para producir un archivo de salida más pequeño, de este modo:

mysqldump -h hostname -u userid -p dbname | gzip > backup.sql.gz

Some newer versions of MySQL might show an error about tablespaces and PROCESS privilege. MediaWiki does not use tablespaces. The solution is to add the  option to the command:

mysqldump --no-tablespaces -h hostname -u userid -p dbname | gzip > backup.sql.gz

Puede usarse una orden similar de mysqldump para producir salida en formato XML, indicando la opción --xml:

mysqldump -h hostname -u userid -p --xml dbname > backup.xml

y comprimir el archivo enviándolo por tubería a gzip:

mysqldump -h hostname -u userid -p --xml dbname | gzip > backup.xml.gz

Additional options you should consider using with mysqldump for a backup includes the following.

If you do not use --single-transaction, then you should consider using the --lock-tables and --add-locks options.

Due to an unexpected change in MySQL versions 5.7.41 and 8.0.32 in February 2023, the --single-transaction option required the backup user to have RELOAD or FLUSH_TABLES privileges. The issue was fixed in MySQL versions 5.7.42 and 8.0.33. See MySQL Bug 109685 and Ubuntu Bug 2003866 for details.

Recuerda hacer copia también de los componentes del sistema de archivos que también forman parte del wiki y que puedes necesitar, como las imágenes, el logotipo y las extensiones.



Ejecutar mysqldump con Cron
En los sistemas que corren sistemas operativos tipo Unix, un Cron es un administrador regular de procesos en segundo plano que permite lanzar ciertos procesos (comandos o scripts de línea de comandos) de forma periódica o en determinadas fechas.

He aquí un ejemplo de comando que podrías lanzar desde un crontab:  nice -n 19 mysqldump -u $USER --password=$PASSWORD $DATABASE -c | nice -n 19 gzip -9 > ~/backup/wiki-$DATABASE-$(date '+%Y%m%d').sql.gz El comando  reduce la prioridad del proceso.

Procura usar valores válidos con,   y. Este comando creará una copia de seguridad poniendo el día de la semana en el nombre del archivo, con lo cual tendrías una buena referencia de copias. Si quieres copiar también los archivos y las extensiones, quizá te interese ver esto.

Si quieres añadir esta tarea en Cron por medio de Cpanel, debes usar el carácter de escape "%":

/usr/bin/mysqldump -u $USER --password=$PASSWORD $DATABASE -c | /bin/gzip > ~/backup/wiki-$DATABASE-$(date '+\%Y\%m\%d').sql.gz

De lo contrario obtendrás un error:

/bin/sh: -c: line 0: unexpected EOF while looking for matching `'' /bin/sh: -c: line 1: syntax error: unexpected end of file

Running mysqldump with Systemd
Systemd unifies service configurations and control. Timers are systemd unit files that control service files or events. Timers can be used as an alternative to cron. An example of systemd unit files and backup script is shown below.

wiki-backup.timer
The following timer runs the wiki-backup service at 5:10 AM every morning.

$ cat /etc/systemd/system/wiki-backup.timer

[Unit] Description=Run the backup service once a day Documentation=...

[Timer] OnCalendar=*-*-* 05:10:00 RandomizedDelaySec=600 Persistent=true

[Install] WantedBy=timers.target

wiki-backup.service
When the wiki-backup timer fires, then the service is invoked. The service runs a script located in /sbin.

$ cat /etc/systemd/system/wiki-backup.service

[Unit] Description=Run the backup service once a day Documentation=...

[Service] Type=oneshot User=root ExecStart=/sbin/wiki-backup

wiki-backup script
$ cat /sbin/wiki-backup


 * 1) !/usr/bin/env bash

PATH=/bin:/sbin:/usr/bin:/usr/sbin export PATH
 * 1) Systemd adds random paths at times. Take full control of PATH.

wiki_password=...
 * 1) Read the backup password from conf or ini Failed

if MYSQL_PWD="${wiki_password}" \ mysqlcheck my_wiki --auto-repair --user=mwuser 1>/dev/null; then echo "Repair wiki database ok" else echo "Failed to repair wiki database" echo "Continuing anyways" fi
 * 1) Fix the wiki tables just in case. This step produces a lot of noise,
 * 2) so send stdout to /dev/null.

if ! systemctl stop apache2.service ; then echo "Failed to stop Apache service" echo "Continuing anyways" fi
 * 1) Disable the connection from Apache to MySQL for the dump

if mysql --version 2>&1 | grep -q -E 'mysqlspace:+Ver 8\.0\.32'; then echo "Using MySQL --lock-tables --add-locks options" mysql_lock_opt="--lock-tables --add-locks" else echo "Using MySQL --single-transaction option" mysql_lock_opt="--single-transaction" fi
 * 1) Lock option choice due to MySQL change at versions 5.7.41 and 8.0.32 in
 * 2) February 2023. See https://bugs.mysql.com/bug.php?id=109685 and
 * 3) https://bugs.launchpad.net/ubuntu/+source/mysql-5.7/+bug/2003866.

if MYSQL_PWD="${wiki_password}" \ mysqldump --no-tablespaces \ ${mysql_lock_opt} \ --events --triggers --routines \ --add-drop-table --create-options \ --extended-insert \ --default-character-set=utf8 \ -u mwuser -h localhost my_wiki | gzip -q -v9 > /backup/wiki-backup.sql.gz ; then echo "Dump wiki database ok" else echo "Failed to dump wiki database" echo "Continuing anyways" fi

if ! systemctl start apache2.service ; then echo "Failed to start Apache service" echo "Continuing anyways" fi
 * 1) Re-enable connection from Apache to MySQL for the dump

exit 0

Tablas
Algunas de las tablas vertidas tienen diferentes grados de temporalidad. Así que, para ahorrar espacio (más allá de aplicar gzip), si bien estas tablas tienen que estar presentes para tener un volcado como es debido, no ocurre lo mismo con la información que contienen. Sin embargo, en determinadas circunstancias el inconveniente de tener que reconstruir toda esta información puede ser mayor que el ahorro de espacio en disco (por ejemplo, en un wiki muy grande donde la velocidad a la que se restaura información es un factor clave).

Mira el hilo mysql5 binary schema de la lista de correo donde se trata este asunto.



Conversión Latin-1 a UTF-8
Mira la sección correspondiente en la página que trata la actualización para ver información sobre este proceso. En la página de discusión también encontrarás más información en general sobre cómo trabajar con juegos de caracteres.

PostgreSQL
Puedes usar la herramienta  para hacer una copia de seguridad de una base de datos de MediaWiki basada en PostgreSQL. Por ejemplo:

pg_dump mywiki > mywikidump.sql

volcará la base de datos  en mywikidump.sql.

Para restaurar el volcado:

psql mywiki -f mywikidump.sql

También te puede interesar volcar la información global, por ejemplo los usuarios de la base de datos:

pg_dumpall --globals > postgres_globals.sql

phpMyAdmin
Pon tu wiki en modo lectura añadiendo  a LocalSettings.php.

Find the wiki database in LocalSettings.php. Here is an example of what this looks like in LocalSettings.php:

 Sigue el enlace a tu página administrativa, identifícate y elige la base de datos del wiki. Elige Exportar.

Asegúrate de que todos los elementos que puedes exportar están marcados, incluyendo Estructura (es importante mantener la estructura de las tablas).

Opcionalmente marca también "Añadir DROP TABLE" para borrar las referencias existentes al importar.

Asegúrate de que Datos está marcada.  Elige "En zip". Finalmente, pulsa CONFIRMAR para guardar la copia de seguridad.  Elimina  de LocalSettings.php.</li> </ol>

Recuerda hacer copia también de los componentes del sistema de archivos del wiki que puedas necesitar, como las imágenes, el logotipo y las extensiones.

<span id="External_links">

Enlaces externos

 * Para ver un tutorial, mira en Siteground: MySQL Export: How to backup your MySQL database?
 * Backing up the Database

HeidiSQL (alternative to phpMyAdmin)
HeidiSQL es similar a phpMyAdmin, pero sin las limitaciones de la versión gratuita de phpMyAdmin. HeidiSQL necesita una conexión directa con la base de datos; algunos servidores sólo ofrecen interfaces web (phpMyAdmin) a bases de datos protegidas por cortafuegos.

<span id="File_system">

Sistema de archivos
MediaWiki guarda otros componentes del wiki en el sistema de archivos cuando es más apropiado hacerlo así que insertarlos en la base de datos, por ejemplo en el caso de los archivos de configuración del sitio ($1, $2 (eliminado en MediaWiki 1.23)), los archivos de imágenes (incluyendo las imágenes borradas, las imágenes en miniatura y las imágenes SVG, si corresponde), además de las apariencias personalizadas, los archivos de las extensiones, etc.

The most important of these are:


 * uploaded files in the  directory (including deleted files, thumbnails, and rendered math and SVG images, if applicable).
 * uploaded files in the  directory (including deleted files, thumbnails, and rendered math and SVG images, if applicable).

El mejor método para hacer una copia de seguridad de estos archivos es almacenarlos por ejemplo en un archivo, que luego puede comprimirse si se desea. En Windows, pueden usarse aplicaciones como WinZip o 7-zip si se prefiere.

En un sistema basado en Linux, suponiendo que el wiki se encuentre en /srv/www/htdocs/wiki, podrías usar algo como:

Debería ser posible hacer una copia de seguridad de todo el directorio "wiki" de la carpeta "htdocs" si estás usando XAMPP.

Configuration files
is the most important of these, but a wiki might also have things like  or other web server configuration files that should be backed up.

Uploaded files
Files uploaded to the wiki are by default put into the  directory, separated into subdirectories such as. There are also other directories such as  and. These should all be backed up.

The  can be backed up along with everything else, but can optionally be excluded in order to save backup space. This directory stores the derived thumbnails of images and other files; generally multiple thumbnails per wiki file. After restoring from backup, these thumbnails will be recreated as required (although depending on this may need to be a manual process).

<span id="Backup_the_content_of_the_wiki_(XML_dump)">

Copia de seguridad del contenido del wiki (volcado XML)
También es una buena idea crear un volcado XML además del volcado de la base de datos. Los volcados XML albergan el contenido del wiki (las páginas del wiki y todas sus revisiones) sin los datos relacionados con el sitio (no tienen las cuentas de usuario, metadatos de las imágenes, registros, etc.).

Los volcados XML tienen menos posibilidades de causar problemas con la codificación de caracteres y son una forma de transferir gran cantidad de contenido de forma rápida; también son más fáciles de usar con herramientas externas, lo que los convierte en un buen recurso si se da el caso de que el volcado principal de la base de datos se vuelve inutilizable.

Para crear un volcado XML, usa la herramienta de línea de comando, que encontrarás en el directorio   de tu instalación de MediaWiki. Véase para más información.

También puedes crear un volcado XML de un grupo específico de páginas usando Especial:Exportar, aunque normalmente si intentas volcar muchas páginas desde esta interfaz te encontrarás con que la petición del navegador caduca.

Para importar un volcado XML en un wiki, usa la herramienta de línea de comando. Si se trata sólo de unas pocas páginas, también puedes usar Especial:Importar mediante tu navegador, aunque de forma predeterminada sólo los administradores pueden usar esta página.

'' See for more information. ''

<span id="Without_shell_access_to_the_server">

Sin acceso a nivel de consola al servidor
If you have no shell access, use the MediaWiki Client Tools' MediaWiki Scraper dumpgenerator script, a Python 3.x port of the WikiTeam Python 2.7 dumpgenerator.py script. It is run from the command-line in a terminal.

The XML dump can include full or only most recent page history. The images dump will contain all file types with associated descriptions. The  and   files will contain information about wiki features such as the installed extensions and skins. User account information won't be preserved.

Full instructions are at the MediaWiki Client Tools' MediaWiki Scraper GitHub repository.

Mira también Data dumps.

Scripts
Script does not need to be modified for each site to be backed up. Does not (yet) rotate old backups. Usage:. Also provides a script to restore a backup. Shell script, last updated 2013. Puede ser usado con el Programador de Tareas de Windows. Last updated 2019. Python 2 script.
 * Script no oficial para crear copias de seguridad de Flominator: sirve para crear una copia de seguridad de todos los archivos y de la base de datos, e incluye opcionalmente rotación de las copias. Shell script, last updated 2012.
 * Otro script para crear copias de seguridad que crea volcados de la base de datos, los archivos y el XML, pone el sitio en modo lectura, marca las copias por fechas y lee el juego de caracteres a utilizar de LocalSettings.php. El script no necesita ser modificado por cada sitio a copiar. De momento no soporta la rotación de viejas copias. Uso: $code. También proporciona un script para restaurar un $code de respaldo.
 * User:Darizotas/MediaWiki Backup Script for Windows - un script que hace una copia de seguridad de una instalación de MediaWiki basada en Windows. Nota: No tiene función de restauración. Shell script, last updated 2015.
 * Script no oficial para hacer copias de seguridad creado por Duesentrieb. Shell script, last updated 2016.
 * mw_backup, un script para realizar copias de seguridad periódicas. Este script genera copias de seguridad diarias, semanales o mensuales de tu base de datos y del directorio de imágenes cuando se ejecuta como un proceso diario de Cron. PHP script, last updated 2017.
 * Another unofficial by Lanthanis that: exports the pages of specified namespaces as an XML file; dumps specified database tables; and adds further specified folders and files to a ZIP backup file.
 * WikiTeam tools - si no tienes acceso al servidor (por ejemplo, si tu wiki está en una granja gratuita de wikis), puedes generar un volcado XML y un volcado de imágenes usando las herramientas de WikiTeam (mira algunos de los wikis salvaguardados de este modo).
 * Mediawiki Scraper - if you do not have server access (e.g. your wiki is in a free wikifarm), you can generate an XML dump and an image dump using dumpgenerator from Mediawiki Client Tools, Python 3 script, last update 2023.

Extensions

 * – Allows users to generate and download database dumps
 * – Allows users to generate and download XML and file/image dumps

<span id="See_also">

Véase también

 * is a quick and easy way to save all pages on your wiki.
 * — si no tienes una copia de seguridad válida
 * — si no tienes una copia de seguridad válida
 * — si no tienes una copia de seguridad válida
 * — si no tienes una copia de seguridad válida