Mahara

Luego de estudiar el estado del arte de las distintas herramientas para redes sociales, decidimos implementar Mahara, dado que su desarrollo a basado en Software Libre y su esquema de manejo nos permiten agregar nuevas funcionalidades.

Mahara es ideal para generar grupos, presentar un perfil profesional y ordenado

Contents

  1. Guía de Instalación de Mahara
    1. 1. Dependencias
      1. Ambiente Básico de Operación
      2. PHP Extensiones
      3. Puedo usar Windows?
      4. Windows sera soportado en el futuro?
      5. Y en otros sistemas operativos Solaris/Mac/BSD/Otros ?
      6. Y en otros servidores Web/otras Bases de Datos/Otros PHP?
    2. 2. Obtener el código
    3. 3. Crear la Base de Datos
      1. Que base de datos debería usar?
    4. 4. Configuración
      1. PHP Settings
      2. Configuración Servidor Web
      3. Configuración Mahara
        1. Cron Job
    5. 5. Ejecute el instalador Web
    6. Troubleshooting
  2. Actualizando Mahara Desde 0.8.X o 0.9.X a 1.0

1. Guía de Instalación de Mahara

Instalar Mahara requiere que usted tenga algunos conocimientos básicos de como las aplicaciones web trabajan. Usted debe saber como configurar bases de datos, servidores web etc.

Si usted tiene como distribución Debian/Ubuntu, el software requerido puede ser instalado utilizando la herramienta <code>apt-get</code>. Si usted utiliza otra distribución GNU/Linux diferente, busque la herramienta de instalación especifica de su distribución.

1.1. 1. Dependencias

1.1.1. Ambiente Básico de Operación

1.1.2. PHP Extensiones

1.1.3. Puedo usar Windows?

Windows no esta soportado por el momento. De todas formas hemos escuchado reportes de personas que tienen Mahara ejecutandose en Windows. Usted necesitaria para correr en Windows instalar un equivalente al archivo (https://eduforge.org/tracker/index.php?func=detail&aid=700&group_id=176&atid=739 ), ademas de otras cosas.

Windows no es recomendado.

1.1.4. Windows sera soportado en el futuro?

Tal vez pero los desarrolladores no han probado ni siquiera Mahara en una maquina Windows. Pero aun no lo esperes dado que estamos concentrados en otras prioridades.

1.1.5. Y en otros sistemas operativos Solaris/Mac/BSD/Otros ?

Si se trata de *nix/BSD, estamos interesados en corregir los reportes de Bugs. Tenemos Mahara en algunas maquinas mac asi que nos encontramos también reparando algunos Bugs.

1.1.6. Y en otros servidores Web/otras Bases de Datos/Otros PHP?

No se han realizado pruebas en otros servidores web. Por favor contacte el equipo de desarrollo en #mahara o en el foro si usted esta interesado en que Mahara implemente o brinde soporte para otros servidores web o otras bases de datos. PHP 5.1 o superior es requerido.

1.2. 2. Obtener el código

Usted puede también descargar pantallazos desde http://git.catalyst.net.nz/gitweb?p=mahara.git;a=summary o puedes revisar el proyecto desde el reporte del git:

<pre>git clone http://git.catalyst.net.nz/mahara.git</pre>

1.3. 3. Crear la Base de Datos

Usted necesita crear una base de datos para Mahara y asegurarse que el servidor web te permita hacer una conexión a la base de datos.

En postgres:

<pre>createdb -U (username who will be connecting) (databasename)</pre>

En MySQL:

<pre>mysql -Uroot [enter password] create database mahara; grant all on mahara.* to 'username'@'localhost' identified by 'password';</pre>

1.3.1. Que base de datos debería usar?

Los desarrolladores recomiendan PostgreSQL para máxima estabilidad e integridad de datos. Al instalar correctamente PostgreSQL, este superará probablemente MySQL de muchos aspectos - utilizamos las tablas de InnoDB para el soporte transaccional.

This makes the upgrade process a lot safer, if the upgrade fails you know you won't have left your database schema in a mess that can't be automatically upgraded once the original problem is fixed.

Ademas PostgreSQL puede hacer DLL en las transacciones - que son para decir <code>BEGIN; CREATE TABLE foo(bar int); ROLLBACK;</code> esto trabaja como se esperaría. Actualizar la versión puede hacerlo algo mas seguro, si esta falla usted pudo dejar el esquema de la base de datos en un problema el cual quizás aumente si no es corregido.

1.4. 4. Configuración

1.4.1. PHP Settings

You should make sure that <code>magic_quotes_gpc</code> is off, and that <code>register_globals</code> is off. Mahara will warn you about any other unsafe or unoptimal settings when it is run. Mahara also ships with a .htaccess file that will ensure that bad settings are off.

1.4.2. Configuración Servidor Web

Copie el contenido de <code>htdocs/</code> a un directorio en su servidor web.

1.4.3. Configuración Mahara

Usted necesita crear un directorio (fuera del documento root) y asegurese que el usuario del servidor web tiene acceso de escritura. Esto es cuando Mahara almacenrará datos como archivos subidos por parte del usuario. En <code>htdocs/</code> is <code>config-dist.php</code>. Usted Necesita hacer una copia de este archivo <code>config.php</code>. Usted entonces necesita ingresar a el y realizar los cmbios que fueran apropiados. El archivo esta muy bien comentariado, y no hay muchas configuraciones para cambiar, de todas formas, tome especial nota de las siguientes configuraciones:

1.4.3.1. Cron Job

Usted necesita configurar un cron job cuando de clic a htdocs/lib/cron.php cada minuto. Mahara implementa su propio cron internamente , entonces cliqueando cron cada minuto es suficiente para hacer que todo trabaje.

Usted puede configurarlo usando la linea de comandos 'php' comando para ejecutar el script de cron, o usando la linea de comandos del navegador web como lo son lynx o w3m.

Algo como lo siguiente en el archivo crontab será suficiente:

<pre>* * * * * www-data php /path/to/mahara/htdocs/lib/cron.php</pre>

1.5. 5. Ejecute el instalador Web

Una vez de haber configurado su config.php, usted deberia ser capaz de navegar en la instalación de Mahata usando su navegador web. Esto le mostrará una páginamostrando las condiciones de uso de Mahara, y le preguntará por la aceptación del mismo. Si usted esta de acuerdo con las condiciones, de clicl en "agree" y Mahara se instalará por si solo en su Base de Datos. Clic en continuar, y usted podrá ver la pantalla de inicio de sesión. Acceda al sistema con el usuario "admin", password "mahara". Felicitaciones!

1.6. Troubleshooting

P: Yo veo esto:

Fatal error: Call to undefined function get_config() in /.../htdocs/lib/errors.php on line 122

R: Cree el archivo config.php a partir de config-dist.php

P: Después de una instalación exitosa, Veo mensajes como 'You are missing the XMLRPC extension

R: Estos mensajes son advertencias que usted no tiene instaladas algunas extensiones requeridas para redes. El código que le permite a su Mahara hablar a Moodle/otros Maharas. si usted quieres hacer esto, installe las extensiones PHP requeridas. Si no, en su <code>config.php</code>, busque esta linea:

<pre>$cfg->log_environ_targets = LOG_TARGET_SCREEN | LOG_TARGET_ERRORLOG;</pre>

y cambiela a

<pre>$cfg->log_environ_targets = 0;</pre>

P: Yo veo esto:

Parse error: syntax error, unexpected '{' in .../htdocs/init.php on line 79

R: Usted probablemente esta corriendo Mahara en PHP4. Mahara requiere PHP 5.1 o mayor.

2. Actualizando Mahara Desde 0.8.X o 0.9.X a 1.0

Aquí es como usted actualiza desde 0.8.X o 0.9.X a 1.0:

  1. Cierre la instalación de Mahara, entonces, los usuarios no podrán ingresar datos mientras se realice el proceso de actualización.
  2. Realice unz Copia deSeguridad de su Base de Datos y Directorio Dataroot
  3. Coloque el nuevo código en su lugar. Si usted no ha hecho cambios a su copia de Mahara, la mejor forma es extraer el nuevo archivo, mover la copia vieja fuera de la ruta de acceso y mover la nueva carpeta dentro del lugar donde la antigua carpeta estaba. esto asegurará que la actualización no interrumpirá sus cambios.
  4. Visite admin/upgrade.php. Observe en la base de datos la actualización. Note que si su sistema es muy largo, y en particular muchas vistas, la actualización puede tomar más de un minuto para ejecutarse.
  5. Haga su sitio disponible para los usuarios de nuevo.

Troubleshooting 

 P: La actualización falló :(
 R: El proceso de actualización ha sido probado muy bien, entonces no debería tener problema alguno. Pero si los tiene, por favor pongase en contacto con nosotros en #mahara y hada un dump a su base de datos y copie los mensajes de error.

 P: Como yo se que la actualización se realizó/como yo se que mi sitio es Mahara 1.0?
 R: El número de la versión está al final de la pantalla en la sección de administración.

 P: el tema de Mahara no se ve correctamente.
 R: Haga una serie de actualizaciones en el browser (usualmente Ctrl+R/Apple+R o F5). Esto para refrescar el cache de su máquina

mahara (last edited 2008-05-26 19:45:26 by jegc)