Generalidades
Este artículo describe cómo actualizar tu instalación de MediaWiki. Revisa la siguiente guía en mediawiki.org para obtener instrucciones de actualización ampliadas:
Necesitas descargar la versión actualizada de MediaWiki antes de comenzar. Puedes encontrar enlaces de descarga para las versiones de MediaWiki actualmente compatibles en la siguiente página:
Revisar los requerimientos
Puedes encontrar una lista actualizada de los requisitos de MediaWiki en tu manual:
Leer las notas de lanzamiento
Las notas de la versión de MediaWiki se encuentran en un archivo RELEASE-NOTES-1.xx en la carpeta principal extraída. Además, puedes encontrar enlaces a las notas de la versión para todas las versiones de MediaWiki en la siguiente página:
Hacer copia de seguridad de archivos existentes y la base de datos
Siempre asegúrate de hacer una copia de seguridad de los archivos de tu base de datos y sitio web antes de realizar cualquier ajuste. De esta manera, si algo fallara, podrías reemplazar rápidamente tus archivos. Mira el siguiente artículo para más detalles:
Desempacar los archivos nuevos
Una vez que hayas hecho una copia de seguridad de los datos de tu sitio existente, carga el archivo MediaWiki actualizado que descargaste en tu servidor web a través de FTP. Luego, inicia sesión en tu servidor a través de SSH, y descomprime el archivo en el servidor. Ahora deberías tener una nueva carpeta MediaWiki para la instalación actual.
Una vez que se extrae el archivo, copia los siguientes archivos y carpetas del directorio de instalación anterior al nuevo:
- LocalSettings.php
- La carpeta de images. En versiones anteriores, esto se llamaba uploads. Si has configurado un directorio personalizado para images/uploads, cópialo en su lugar.
- Cualquier extensión en el directorio de extensiones que aún no hayas actualizado/reinstalado.
- Tu logo personalizado. Las versiones anteriores a la 1.24 almacenarán tu logotipo en skins/common/images/, y las versiones más nuevas usan resources/assets/ o images/ Asegúrate de actualizar LocalSettings.php con la ruta actualizada.
- Skins personalizados, que se encuentran en la carpeta de skins.
- Cualquier modificación personalizada a los archivos antiguos, que deberán copiarse manualmente a las nuevas versiones de esos archivos.
- Tu archivo .htaccess, si está personalizado.
Actualizar extensiones
Si has instalado extensiones en la instalación anterior de MediaWiki, es posible que también debas actualizarlas. Los archivos de extensión individuales se pueden descargar a través de la página de extensión de descarga de MediaWiki. Alternativamente, puedes cargar MwExtUpgrader en tu sitio para actualizar extensiones por lotes. Una vez cargado, ejecuta el siguiente comando para actualizar tus extensiones:
[server]$ php mwExtUpgrader.phar
Ejecutar el script de actualización para revisar la base de datos
Puede que sea necesario ejecutar el script /maintenance/update.php después de la actualización. Para hacerlo, inicia sesión en tu sitio a través de SSH. Luego corre el siguiente comando:
[server]$ php ./maintenance/update.php
Esto ejecuta un script de actualización que debería corregir cualquier error actual en tu sitio. Si eso no funciona, especifica la ruta completa a una versión de PHP. Por ejemplo:
[server]$ /usr/local/php82/bin/php ./maintenance/update.php
Probar la actualización
Asegúrate de que las siguientes funciones del sitio estén funcionando:
- Ver páginas.
- Editar páginas.
- Subir un archivo.
- Visita /Special:Version en tu navegador para confirmar la versión de MediaWiki y las extensiones instaladas.
Eliminar las sobras de instalaciones antiguas
Asegúrate de eliminar o bloquear cualquier carpeta de instalación de MediaWiki después de que se complete la actualización para asegurarte de que tu sitio sea seguro.