Instalación

Ponga a andar su propia instancia de Elgg en un momento.

Requisitos

  • MySQL 5.5.3+ (5.0.0+ if upgrading an existing installation)

  • PHP 7.1+ with the following extensions:

    • GD (para el procesamiento de imágenes).
    • PDO (for database connection)
    • JSON (for AJAX responses, etc.)
    • XML (for reading plugin manifest files, etc.)
    • Compatibilidad con cadenas de tamaño variable (para internacionalización).
    • Configuración adecuada y posibilidad de enviar mensajes de correo electrónico mediante un agente de transferencia de mensajes (MTA).

  • Servidor web que permita reescribir direcciones URL.

Official support is provided for the following configurations:

  • Apache server
    • Apache con el módulo rewrite module activado.
    • PHP ejecutado como un módulo de Apache.
  • Nginx server
    • Nginx with PHP-FPM using FastCGI

Por «compatibilidad oficial» se entiende:

  • Most development and testing is performed with these configurations
  • Much of the installation documentation is written assuming Apache or Nginx is used
  • Priority on bug reports is given to Apache and Nginx users if the bug is web server specific (but those are rare).

Browser support policy

Feature branches support the latest 2 versions of all major browsers as were available at the time of the first stable release on that branch.

Bugfix release will not alter browser support, even if a new version of the browser has since been released.

Major browsers here means all of the following, plus their mobile counterparts:

  • Android Browser
  • Chrome
  • Firefox
  • IE
  • Safari

«Support» may mean that we take advantage of newer, unimplemented technologies but provide a JavaScript polyfill for the browsers that need it.

You may find that Elgg happens to work on unsupported browsers, but compatibility may break at any time, even during a bugfix release.

Resumen

Envíe Elgg

With Composer (recommended if comfortable with CLI):

composer self-update
composer create-project elgg/starter-project:dev-master ./path/to/project/root
cd ./path/to/project/root
composer install
composer install # 2nd call is currently required
vendor/bin/elgg-cli install # follow the questions to provide installation details

From pre-packaged zip (recommended if not comfortable with CLI):

  • Descargue la última versión de Elgg.
  • Envíe el archivo ZIP a su servidor con un cliente de FTP.
  • Unzip the files in your domain’s document root.

Cree una carpeta de datos

Elgg necesita una carpeta especial en la que almacenar los ficheros enviados al sitio, incluidos los iconos de perfil y las fotos de los usuarios. Tendrá que crear una carpeta para este fin.

Atención

For security reasons, this folder MUST be stored outside of your document root. If you created it under /www/ or /public_html/, you’re doing it wrong.

Una vez la carpeta está creada, tendrá que asegurarse de que el servidor web en el que se está ejecutando Elgg tiene permisos para escribir y crear subcarpetas en esa carpeta. No debería ser un problema en servidores Windows, pero si su servidor está en un GNU/Linux, Mac OS X o en una variante de UNIX, tendrá que establecer los permisos en la carpeta.

Si está enviando los ficheros mediante un cliente de FTP gráfico, es posible que el editor le permita cambiar los permisos haciendo clic derecho en la carpeta y seleccionando «Propiedades» o «Obtener información».

Nota

Directories must be executable to be read and written to. The suggested permissions depend upon the exact server and user configuration. If the data directory is owned by the web server user, the recommended permissions are 750.

Advertencia

Setting your data directory to 777 will work, but it is insecure and is not recommended. If you are unsure how to correctly set permissions, contact your host for more information.

Cree una base de datos en MySQL

Cree una nueva base de datos en MySQL para Elgg usando la herramienta de administración de bases de datos que prefiera (pregunte al administrador del sistema si tiene alguna duda).

Asegúrese de que añade un usuario a la base de datos con todos los privilegios y de que se queda con el nombre de la base de datos, del usuario y de la contraseña. Necesitará esta información durante la instalación de Elgg.

Set up Cron

Elgg uses timed requests to your site to perform background tasks like sending notifications or performing database cleanup jobs. You need to configure the cron to be able to use those kind of features.

Visite su sitio Elgg

Una vez completados los pasos, visite su sitio Elgg desde un navegador web. Elgg le presentará un asistente que le guiará a través del proceso de instalación. La primera cuenta que cree al finalizar la instalación será una cuenta de administrador.

Una nota sobre settings.php y .htaccess

El instalador de Elgg intentará crear dos ficheros por usted:

  • elgg-config/settings.php, which contains local environment configuration for your installation
  • .htaccess, which allows Elgg to generate dynamic URLs

Si los ficheros no se pueden generar automáticamente, por ejemplo porque el servidor carezca de permisos de escritura en las carteras correspondientes, Elgg le ofrecerá instrucciones para crearlos usted manualmente. También puede cambiar los permisos de la carpeta raíz y de la carpeta del motor de manera temporal. Defina los permisos en esas dos carpetas de manera que permitan que el servidor escriba esos dos ficheros, complete el proceso de instalación, y vuelva a cambiar los permisos a su valor previo. Si por algún motivo esto no funcionase, necesitará:

  • In elgg-config/, copy settings.example.php to settings.php, open it up in a text editor and fill in your database details
  • On Apache server, copy install/config/htaccess.dist to .htaccess
  • On Nginx server copy install/config/nginx.dist to /etc/nginx/sites-enabled and adjust it’s contents

Solución de problemas

¡Ayuda! Tengo problemas al instalar Elgg

En primer lugar:

  • Asegúrese de que el servidor cumple con los requisitos técnicos de Elgg.
  • Siga las instrucciones aquí definidas para su entorno de ser necesario.
  • ¿Se ha asegurado de que mod_rewrite está cargado?
  • ¿Se está cargando el módulo de MySQL para Apache?

Tome nota de los pasos que siga para arreglar la instalación. A veces, al cambiar algunas opciones o ficheros para intentar solucionar el problema, es posible que cause otros problemas más adelante. Si necesita empezar de cero, sólo tiene que eliminar todos los ficheros, eliminar la base de datos, y volver a empezar.

No puedo guardar la configuración durante la instalación, me sale un error 404 al intentarlo

Elgg utiliza la extensión de Apache mod_rewrite para simular ciertas direcciones URL. Por ejemplo, cada vez que realiza una acción en Elgg, o cuando visita el perfil de un usuario, el servidor traduce internamente la URL a algo que Elgg comprende. Esto se hace mediante reglas definidas en el fichero .htaccess, que es la manera estándar de definir configuración adicional de un sitio en Apache.

Este error sugiere que las reglas de mod_rewrite no se están aplicando correctamente. Los motivos pueden ser varios. Si no se siente cómodo o no puede aplicar las soluciones que le presentamos a continuación, le recomendamos encarecidamente que contacte con el administrador de sistemas o asistente técnico correspondiente y le haga llegar esta página a él.

The .htaccess, if not generated automatically (that happens when you have problem with mod_rewrite), you can create it by renaming install/config/htaccess.dist file you find with elgg package to .htaccess. Also if you find a .htaccess file inside the installation path, but you are still getting 404 error, make sure the contents of .htaccess are same as that of install/config/htaccess.dist.

``mod_rewrite`` no está instalado.

Revise el fichero de configuración de Apache, httpd.conf, y asegúrese de que el módulo mod_rewrite se está cargando. Si ha necesitado cambiar la configuración, acuérdese de reiniciar Apache para que los cambios surtan efecto. También puede usar PHP info para comprobar si el módulo está cargado.

No se están respetando las reglas del fichero ``.htaccess``.

En la configuración de su servidor virtual (virtual host), que puede formar parte de httpd.conf, cambie el valor de «AllowOverride» de forma que quede como sigue:

AllowOverride all

Esto le indicará a Apache que debe utilizar las reglas de substitución (mod_rewrite) del fichero .htaccess.

Elgg no está instalador en la carpeta raíz del servidor web. Por ejemplo, está instalado en «http://example.org/elgg/» en vez de en «http://example.org/».

El script de instalación me redirige a «action» en vez de a «actions»

This is a problem with your mod_rewrite setup.

Atención

DO NOT, REPEAT, DO NOT change any directory names!

Instalé en un subdirectorio y mi instalación no funciona !

Si usted instaló Elgg, este será accedido con una dirección como http://example.org/mysite/ (http://ejemplo.org/misitio/) en lugar de http://example.org/ (http://ejemplo.org), hay una pequeña probabilidad de que las «rewrte rules» o reglas de reescritura, del fichero .htaccess no lo procesen correctamente. Esto normalmente es debido al uso de alias con Apache. Usted puede necesitar dar un puntero a mod_rewrite que apunte a donde su instalación de Elgg se encuentra.

  • Abra el fichero .htaccess en un editor de texto
  • Donde le señale, añada una línea como ``RewriteBase /path/to/your/elgg/installation/` (RewriteBase/camino/hacia/su/ellg/instalacion/) No olvide las barras finales.
  • Salve el fichero y recargue su navegador

Por favor, dése cuenta que el camino que está usando es el “web”, quitándole la parte del host.

Por ejemplo, si la instalación de Elgg se encuentra en http://example.org/elgg/, deberá usar la siguiente base:

RewriteBase /elgg/

Por favor, dése cuenta que instalar en un subdirectorio no requiere el uso de «RewriteBase». Esto solo es necesario en las raras circunstancias en las que la configuración del servidor lo requiere.

Lo hice todo! mod_rewrite está trabajando bien, pero sin embargo el error 404 sigue apareciendo.

Es posible que haya algún tipo de problema con el fichero «.htaccess». A veces la rutina de instalación de Elgg no es capaz de crear dicho fichero y tampoco es capaz de avisar de que no ha podido crearlo. Si ha probado ya todo lo anterior, llegados a este punto:

  • Compruebe si el fichero «.htaccess» es realmente el de Elgg, y no uno básico instalado por el propio servidor.
  • Si efectivamente no es el fichero de Elgg, use «htaccess_dist» (cámbiele el nombre a «.htaccess»).

Recibo un mensaje de error diciendo que el test de reescritura ha fallado después de chequear la pagina de requerimientos

Me aparecen estos mensajes tras el paso de comprobación de los requisitos (el segundo paso) de la instalación:

Creemos que su servidor se encuentra ejecutando el web server Apache.

No se ha superado la prueba de substitución, probablemente porque la opción «AllowOverride» no tiene el valor «All» para la carpeta de Elgg. Esto impide que Apache procese el fichero «htaccess» que define las reglas de substitución.

Otra posible causa, aunque menos probable, es que Apache esté configurado con un alias para la carpeta de Elgg, y que por ello necesite definir la opción «RewriteBase» en el fichero «.htaccess». Encontrará más información al respecto en el fichero «.htaccess» de la carpeta de Elgg.

Tras recibir este error, cualquier interacción con la interfaz web arroja un error 500 (error interno del servidor).

Lo más probable es que la causa sea el no haber cargado el módulo de filtros eliminando el prefijo de comentario de la línea:

#LoadModule filter_module modules/mod_filter.so

del fichero de configuración de Apache «httpd.conf».

El fichero «error.log» de Apache contendrá una entrada como la siguiente:

… .htaccess: Orden incorrecta: «AddOutputFilterByType», es posible que no esté bien escrita o que esté definida en un módulo que no está incluido en la configuración del servidor.

Hay una página en blanco después de poner los parámetros de mi base de datos

Asegúrese de que el módulo de MySQL de Apache está instalado y se está cargando.

Estoy teniendo un error 404 con una url muy larga

Si obtiene un error 404 durante la instalación o durante la creación del primero de los usuarios con una URL como «http://example.com/homepages/26/d147515119/htdocs/elgg/action/register», significa que la URL del sitio definida en la tabla sites_entity de la base de datos es incorrecta. Elgg intenta adivinar el valor, pero en el caso de servidores compartidos no siempre acierta. Use phpMyAdmin para editar el valor en la base de datos y cambiarlo a la URL correcta.

Estoy teniendo problemas poniendo mi camino de datos

This is highly server specific so it is difficult to give specific advice. If you have created a directory for uploading data, make sure your http server can access it. The easiest (but least secure) way to do this is give it permissions 777. It is better to give the web server ownership of the directory and limit the permissions.

Advertencia

Setting directory permissions to 777 allows the ENTIRE internet to place files in your directory structure an possibly infect you webserver with malware. Setting permissions to 750 should be more than enough.

La causa principal de este problema es que PHP esté configurado para evitar el acceso a la mayor parte de las carpetas mediante la opción open_basedir. Consulte a su proveedor de servidor.

Make sure the path is correct and ends with a /. You can check the path in your database in the config table.

If you only have ftp access to your server and created a directory but do not know the path of it, you might be able to figure it out from the www file path set in your config database table. Asking for help from your hosting help team is recommended at this stage.

No puedo validar mi cuenta de administración ya que no tengo un servidor de correo

Si bien es cierto que las cuentas normales (sin contar las creadas desde el panel de administración) deben tener asociada y autenticada una cuenta de correo electrónico para poder usarse, la cuenta de administrador lo necesita.

Una vez registrada la primera cuenta, podrá acceder al sitio con los datos de acceso que haya indicado durante el registro de la cuenta.

Lo he intentado todo, y sigo sin poder instalar Elgg

Es posible que, durante el proceso de depuración de su problema de instalación original, haya causado algún otro problema. Pruebe a realizar una instalación desde cero de nuevo.

  • Pare su base de datos Elgg
  • Borre su directorio de datos
  • Borre los ficheros fuente de Elgg
  • Empiece de nuevo.

Si aún así no es capaz de instalar Elgg, busque la ayuda de la comunidad de Elgg. Asegúrese de indicar la versión de Elgg que está intentando instalar, así como detalles sobre la plataforma del servidor, y cualquier mensaje de error que reciba, incluyendo aquellos que contenga el historial (log) del servidor.