Instalación y actualización

Instalar y actualizar XenForo siguen procesos muy similares. A nivel muy básico, el proceso general es:

  1. Descargar XenForo y extraer los archivos localmente.
  2. Subir el contenido del directorio upload, del archivo zip extraído, al servidor.
  3. Apuntar el navegador al sistema de instalación/actualización y seguir las instrucciones en pantalla.

Si se tiene cualquier problema o pregunta sobre esto, hay que enviar un tiquet de soporte y XenForo ayudará con el proceso.

Instrucciones más detalladas se proveen a continuación.

Nota

Hay que asegurarse de que el servidor cumple con los requisitos de XenForo.

Instalar XenForo

Para instalar XenForo se precisa lo siguiente:

  1. Los detalles de la cuenta de cliente de XenForo
  2. Un cliente FTP (tal como FileZilla o WinSCP)
  3. Los detalles de acceso al servidor por FTP
  4. Una base de datos MySQL vacía en el servidor y los detalles para poder accederla

1. Descargar

Para empezar, primero hay que descargar el archivo zip que contiene XenForo desde el Área de clientes de XenForo.

Si aún no se está listo, puede proveerse información sobre el sitio que ejecutará XenForo. Una vez hecho esto, se hará visible el enlace de descarga. Hacer clic en él y seguir las instrucciones en pantalla.

Nota

Asegurarse de que no esté seleccionada la opción Descargar solo el pàquete de actualización al descargar para una instalación limpia.

2. Subir

En nuestra computadora, decomprimir el archivo descargado en el paso 1. En su interior, se verá un directorio upload. Hay que subir el contenido de este directorio al servidor (no el directorio en sí mismo).

Ahora hay que usar el cliente FTP para conectar al servidor y crear el directorio en donde se quiere instalar XenForo. Por ejemplo, si se desea acceder a XenForo a través de example.com/comunidad/, hay que crear un directorio comunidad en la raíz de la web (como el directorio public_html). Se precisa tomar nota de esa URL para que se corresponda con el siguiente paso. Esto se conoce como la "URL raíz de XenForo".

Nota

Si se desea instalar XenForo en la raíz del dominio, generalmente no es necesario crear un directorio. Sin embargo, XenForo debe instalarse dentro de un directorio que no se esté usando a la vez para mostrar páginas.

Hay que usar el cliente FTP para subir los contenidos del interior del directorio upload que estaba en el zip extraído anteriormente, al directorio recién creado en el servidor. Hay que asegurarse de que se han subido todos los archivos y directorios. Si se hace correctamente, una vez subidos, se verán archivos como admin.php y css.php directamente dentro del directorio creado en el servidor.

La subida puede conllevar algún rato. No hay que hacer nada hasta que se termine la subida. Hay que mantener abierto el cliente FTP ya que se precisa en el siguiente paso.

3. Instalar

Casi se está listo para comenzar la instalación de XenForo.

Direcciona el navegador al directorio install que está dentro de la URL raíz de XenForo. Por ejemplo, Si la URL raíz de XenForo es www.example.com/comunidad/, hay que dirigir el navegador a www.example.com/comunidad/install/. Si la URL es correcta, se verá el instalador de XenForo.

En dependencia de la configuración del servidor, puede recibirse un error sobre que ciertos directorios no son escriturables. En este caso, síganse los pasos de la "configuración de permisos de directorios". Si se recibe cualquier otro mensaje de error, El servidor no cumple con los requisitos de XenForo y es necesario realizar cambios en el alojamiento en su configuración de PHP.

Permisos del directorio de configuración

En dependencia de la configuración de PHP, se puede precisar hacer escriturables manualmente ciertos directorios. Si esto fuera necesario, se mostrará un mensaje al iniciar la instalación.

Si se recibiera este mensaje, hay que abrir el cliente FTP y navegar hasta el directorio raíz de XenForo (el directorio creado anteriormente). Deberán verse los directorios data e internal_data. Es preciso cambiarles los permisos a los dos.

En Linux, suelen ser "chmod 0777". Generalmente, esto puede hacerse a través del cliente FTP asegurándose de que el directorio tenga los permisos de lectura, escritura y ejecución por usuario, grupo y todo el mundo. En Windows/IIS, es preciso conceder el permiso "Control completo" a la cuenta IUSR_.

Una vez acabado, refrescar el instalador (tecla F5). Si los cambios han sido correctos, desaparecerá el mensaje de error que recuerda que los directorios no pueden escribirse.

Si no se muestran otros errores, se podrá comenzar el proceso de instalación de XenForo. En los primeros pasos, se nos solicitarán detalles sobre la base de datos del servidor. Si se desconocen los valores a usar aquí, será necesario contactar con el alojamiento para obtenerlos.

Una vez verificada la configuración de la base de datos, si es posible, se escribirán automáticamente en el servidor. Si no lo fuera, se precisará descargar el archivo de configuración generado y subirlo manualmente.

Subir el archivo config generado

Si no hubiera podido escribirse automáticamente el archivo de configuración en el servidor, se verá un botón para descargar el archivo a la computadora. Hágase clic en él.

Abrir el cliente FTP y navegar hasta el directorio raíz de XenForo. En su interior, habrá un subdirectorio denominado src. Ábrelo y sube el archivo config.php, aquí descargado, a él. Ahora puede continuarse con la instalación.

Para terminar la instalación, hay que seguir las instrucciones en pantalla hasta que termine. Ahora, XenForo está instalado y ya se puede comenzar a configurarlo.

Actualizar XenForo

Actualizar XenForo sigue un proceso muy similar a la instalación.

Puede actualizarse directamente desde cualquier versión previa hasta la última. No son necesarias actualizaciones intermedias primero.

Advertencia

Antes de actualizar, se recomienda encarecidamente hacer una copia de seguridad de la base de datos y de los archivos. ¡No es posible volver atrás una vez comenzada la actualización!

Se precisará actualizar complementos para que sean compatibles con con la nueva versión. Hay que contactar con los autores de los complementos para más detalles.

Actualizar desde XenForo 1

Si se está actualizando XenForo 1, hay cosas importantes a tener en cuenta. Esta es una actualización particularmente importante.

  1. Los complementos de XenForo 1 no son compatibles con XenForo 2. Será necesario contactar con los autores para ver si tienen una versión actualizada de cualquier complemento que se esté usando. Si no hay intención de usar un complemento por un largo periodo se recomienda, si es posible, desinstalarlo ANTES de actualizar. No hacerlo puede dejar datos huérfanos en la base de datos.
  2. Los estilos de XenForo 1 no son compatibles con XenForo 2. La actualización no mantiene ninguna propiedad del estilo ni modificación de plantilla. Deberán rehacerse estas tras actualizar.
  3. Cualquier otra personalización hecha en XenForo 1 es poco probable que funcione en XenForo 2 sin hacer un montón de cambios.

Se recomienda encarecidamente, si es posible, realizar una actualización de prueba en el sitio antes de actualizar el sitio en producción.

Nota

Es vital el hacer una copia de seguridad del sitio ANTES de actualizar a XenForo 2. No es posible volver atrás tras comenzar la actualización. El único metodo de volver atrás será restaurar desde una copia de seguridad.

1. Descargar

Para empezar, primero hay que descargar el archivo zip que contiene XenForo desde el Área de clientes de XenForo.

Hacer clic en el enlace Descargar XenForo adjunto a la licencia del sitio que se está actualizando. Antes de descargar, hay que asegurarse que la opción Descargar solo el pàquete de actualización está seleccionada.

Nota

Si se tienen varias licencias, hay que asegurarse de usar para cada sitio los archivos asociados con la licencia correcta. Pueden existir diferencias en las descargas (como la eliminación de marca aplicada) que puedan dar lugar a violaciones accidentales de la licencia.

2. Subir

En nuestra computadora, decomprimir el archivo descargado en el paso 1. En su interior, se verá un directorio upload. Hay que subir el contenido de este directorio al servidor (no el directorio en sí mismo).

Conectar al servidor usando el cliente FTP y navegar hasta el directorio raíz de XenForo (directorio en el que ya está instalado XenForo). En este directorio se verán archivos como admin.php y css.php directamente dentro del directorio.

Hay que usar el cliente FTP para subir los contenidos del directorio upload que estaba en el zip extraído anteriormente al directorio raíz del servidor. Hay que asegurarse de que se han subido todos los archivos y directorios. Si se hace correctamente, se deberá permitir al cliente FTP sobreescribir los archivos si es que lo pregunta.

Nota

Al subir archivos, es muy importante "combinar" con los que ya están en el servidor. Algunos clientes FTP reemplazan simplemente los contenidos del servidor con exáctamente el contenido que se sube. Si esto ocurre, pueden perderse algunos archivos y datos.

La subida puede llevar un rato. Una vez terminada, debe seguirse el siguiente paso. Se cerrará el sitio hasta que el paso finalice.

3. Actualizar

Dirigir el navegador al directorio install en la URL raíz de XenForo. Por ejemplo, Si la URL raíz de XenForo es www.example.com/comunidad/, debe dirigirse el navegador a www.example.com/comunidad/install/. Si se teclea correctamente la URL, se verá el instalador de XenForo.

Puede solicitarse el nombre y contraseña para acceder como usuario administrador. En adelante, hay que seguir las instrucciones en pantalla hasta finalizar la actualización. Una vez terminada, el sitio se abrirá automáticamente.

Actualizar desde XenForo 1

Si se está actulizando desde XenForo 1, puede necesitarse guardar un nuevo archivo congfig. Se preguntará para hacerlo al inicio del proceso de actualización. Si este nuevo config no puede escribirse automáticamente, se deberá subir al directorio src en la raíz de la instalación de XenForo.

Adicionalmente, si se quisiera agregar soporte emoji, véase la página soporte Emoji.

4. Comprobaciones post-actualización

Cuando se actualiza XenForo, no se sobre-escribirá automáticamente ninguna plantilla o frase personalizadas. Deberá comprobarse la existencia de entradas obsoletas en Aspecto > Plantillas obsoletas y Aspecto > Frases obsoletas. Pueden usarse las Herramientas de combinación para intentar incorporar automáticamente el motor de los cambios en las personalizaciones.

Si se usa un estilo o idioma provisto por terceras partes, habrá que mirar si existe un lanzamiento diseñado para la versión de XenForo que se ejecuta.

Problemas comunes de la actualización

Intentar una instalación limpia en lugar de una actualización

Si tras subir los archivos e ir a www.example.com/comunidad/install/, se ejecuta una instalación limpia, indica que los archivos no se han combinado correctamente al subirlos. Es posible que se hayan eliminado archivos de forma inesperada.

Como mínimo, se precisa crear el archivo internal_data/install-lock.php. Su contenido da igual. Una vez hecho, puede dirigirse el navegador a www.example.com/comunidad/install/. Si siguiese intentando ejecutarse una instalación limpia, hay que contactar con el soporte.

Si los directorios internal_data o data están desaparecidos o vacíos, se han eliminado los avatares y los adjuntos. Se recomienda encarecidamente restaurarlos desde una copia de seguridad.

No se encuentra la actualización

Si tras subir los archivos e ir a www.example.com/comunidad/install/, no se encuentra actualización alguna, los archivvos no se han subido a la ubicación correcta.

En la gran mayoría de casos, esto indica que se ha subido el directorio upload en sí mismo, en vez de su contenido. Hay que asegurarse de sobreescribir los archivos existente al actualizar.