Fecha: 13/02/2014

Autor: David Álvarez Cabal, Adexe Rivera Martín y Guanchor Ojeda Hernández

Versión: 2.4-madeira

Manual de instalación

Campus Impulsa

Cliente

ÍNDICE

1. Control de Versiones....................................................................................................... 3

2. Instalación 42.1. Requisitos previos.................................................................................................. 4

2.1.1. Requisitos mínimos............................................................................................................................ 42.1.2. Gestor de documentación.................................................................................................................. 5

2.2. Instalación.............................................................................................................. 52.2.1. Base de datos..................................................................................................................................... 52.2.2. Directorio de datos............................................................................................................................. 52.2.3. Aplicación del Campus...................................................................................................................... 5

3. Configuración de la biblioteca......................................................................................103.1. Instalación Alfresco.............................................................................................. 103.2. Activación de Alfresco como repositorio...............................................................12

4. Webservices................................................................................................................... 14

2

1. Control de Versiones

Versión Fecha Autor Motivo

0.1 06/11/13 David Álvarez Cabal Creación del documento

0.2 07/11/13 David Álvarez Cabal Instrucciones alfresco

1.0 04/12/13 David Álvarez Cabal Configuración de webservices

1.1 16/12/13 David Álvarez Cabal GIT

2.0 10/01/14 David Álvarez Cabal Mejoras en el documento

2.1 16/01/14 Adexe Rivera Martín Revisión menor del documento

2.2 17/01/14 Adexe Rivera Martín Mejoras en la sección webservices

2.3 21/01/14 David Alvarez Cabal Inclusión de requisitos previos

2.4-madeira 13/02/14 Guanchor Ojeda Hernández Actualizado para Madeira/CV

3

2. Instalación

2.1. Requisitos previos

Estas versiones que aparecen en este documento, son con las que se han realizado las

pruebas del sistema, es probable que el campus funcione con alguna versión menor a

las recomendadas, pero no podemos garantizarlo.

2.1.1. Requisitos mínimos

Para que el campus funcione de manera correcta se requieren al menos las siguientes

versiones de software en su servidor:

• PHP 5.3.21

• PostgreSQL 9.2

Además algunas librerías de php nos harán falta, por supuesto la librería de php para

Postgresql.

• Curl

• Pgsql

PHP deberá estar configurado correctamente para su uso con PostgreSQL, para ello

será suficiente que tras la instalación de la librería pgsql, se compruebe la existencia

de la siguiente linea o la configuración de esta librería en el archivo php.ini.

extension=pgsql.so

La ubicación de dicho archivo dependerá del sistema operativo sobre el que tenga

instalado PHP, pero puede obtener esa información creando un archivo info.php en la

raíz de su servidor web con el siguiente código:

<?PHP phpinfo(); ?>

4

2.1.2. Gestor de documentación

Para la configuración de la biblioteca utilizando el gestor de documentos Alfresco debe

existir una instalación de dicho gestor documental corriendo en su versión 3.4e que

debe ser accesible desde el campus, que será configurado según se explica más

adelante en el correspondiente apartado de éste mismo documento.

Una vez que tenemos los requisitos previos en nuestro servidor podemos proceder a

la instalación del campus.

2.2. Instalación

2.2.1. Base de datos

Antes de instalar el campus en el sistema es necesario disponer de una base de datos

VACÍA creada en un servidor Postgres con un usuario que disponga de permisos para

la creación de tablas y gestión de la información en dicha base de datos.

2.2.2. Directorio de datos

También debemos de crear una carpeta para los datos del sistema en una ruta NO

ACCESIBLE desde el navegador web, pero con permisos de escritura para el

navegador.

2.2.3. Aplicación del Campus

Debemos de crear una carpeta en la ruta de nuestro servidor Apache que sea

accesible desde un navegador web.

2.2.3.1 A través de archivo

El Campus puede estar comprimido en un solo archivo o como una estructura de

carpetas. En el caso que recibamos el Campus en un archivo comprimido

descomprimiremos el mismo, de manera que obtendremos la estructura de carpetas.

Mediante un cliente de ftp copiaremos toda la estructura de carpetas en el directorio

que hemos creado anteriormente.

5

Una vez que hemos copiado el contenido completo a nuestro servidor, accederemos a

ella a través del navegador web, lo que debería mostrar el asistente de configuración,

que veremos en la siguiente imagen.

2.2.3.2 A través de repositorio

Con el objeto de facilitar las actualizaciones del sistema recomendamos utilizar GIT

para instalar el Campus, de manera que sólo sea necesario sincronizar el repositorio

cuando exista una nueva actualización.

1. Para ello se puede clonar el código del campus. Lo primero que debe hacer es

crearse una cuenta de usuario en bitbucket, a continuación remita a Inventia

Plus su usuario bitbucket para que podamos asignarle los permisos

correspondientes al repositorio.

2. Un vez que tenga los permisos podrá clonar el repositorio a través del enlace

que se indica a continuación, o el que le suministre el propio sistema de

bitbucket.

git clone https://

[su_usuario_bitBucket]@bitbucket.org/inventiaplus/campus-impulsa-2.6.git

3. Una vez que el repositorio ha sido clonado, nos situamos en la rama

correspondiente:

git checkout madeira-master

4. Hay que renombrar el fichero webservices/impulsa_services.wsdl.prod a

webservices/impulsa_services.wsdl. Posteriomente cambiaremos parte de su

contenido.

5. Ahora, continuamos con el proceso de instalación llamando desde nuestro

navegador web al directorio raíz de nuestro repositorio.

Una vez tengamos el campus, copiado o descargado, accederemos desde un

navegador a la url del campus. Para seguir con los pasos que se muestran a

continuación.

6

Una vez seleccionado el idioma pasamos a la siguiente pantalla, en la que podremos

configurar al ruta donde configuramos el directorio de datos.

El siguiente paso nos permitirá indicar el motor de base de datos que usaremos en el

campus, que debe ser Postgres. En el desplegable sólo aparecen aquellas bases de

datos que se detectan como instaladas en nuestro sistema. Si la base de datos

recomendada (postgres) no se encuentra disponible, por favor, proceda a instalarla y

reinicie la instalación.

7

En la siguiente pantalla, introduciremos los datos de la base de datos que hemos

creado anteriormente en el punto 1.2.1.

Además dependiendo de la configuración del servidor es posible que deba indicar un

nombre o la dirección ip del servidor de bases de datos en lugar de localhost.

En el siguiente paso se realizará una comprobación de los requisitos del sistema, si

existe algún problema deberá solucionarlo antes de poder continuar con la instalación.

Si todos los requisitos han sido superados el siguiente paso puede tardar un poco, sea

paciente, se están instalando todos los módulos que componen el campus (mis

cursos, calendario, foro...)

Una vez instalado pulse continuar y se le mostrará un formulario para crear un usuario

administrador por defecto.

8

En la última de las pantallas se nos pedirá información básica acerca del sitio. Dicha

información no es relevante para el Campus.

Con esto hemos terminado y ya podremos acceder a nuestro campus a través del

navegador web utilizando el usuario “admin” y la clave que hemos creado.

9

3. Configuración de la biblioteca

La biblioteca está basada en el gestor documental Alfresco (la versión sobre la que se

ha implementado el campus ha sido la 3.4e)

3.1. Instalación Alfresco

Si se va a utilizar un servidor de Alfresco que no esté bajo nuestro control (servidor

corporativo, compartido con otras herramientas...), o que ya esté instalado, no será

necesario realizar esta configuración. Tan sólo activarlo como repositorio en el propio

campus, como se indica en el apartado siguiente.

1. Lo primero que haremos será descargar la versión correspondiente de Alfresco del

sitio oficial.

2. A continuación le daremos permisos de ejecución al archivo descargado para

poder ejecutarlo:

chmod 744 alfresco-community-3.4.e-installer-linux-x64.bin

3. Por último ejecutaremos el instalador:

./alfresco-community-3.4.e-installer-linux-x64.bin

Tan sólo debemos responder a las preguntas del asistente y esperar a que finalice la

instalación.

Una vez finalizada la instalación podemos configurar el alfresco para que apunte a

cualquier carpeta diferente a la estándar, para ello se deben seguir los siguientes

pasos, que se llevarán a cabo sobre el archivo server.xml de configuración del

servidor Tomcat sobre el que esté corriendo Alfresco, normalmente será:

/opt/[carpeta_alfresco]/tomcat/conf/server.xml

10

1. Parar el servicio alfresco. Le recomendamos consultar la documentación de su

instalación de Alfresco para realizar todas las operaciones que se requieren

sobre los servicios del mismo.

2. Modificar el parámetro

autoDeploy a "false"

3. Añadir la siguiente línea en la etiqueta Host

<Context path = "url_en_la_que_queremos_que_escuche" docBase =

"ruta_local_de_la_aplicacion"/>

4. En nuestro caso, la línea quedó de la siguiente forma:

<Context

path="localhost/medusa/pre/eforma/campus/biblioteca/alfresco"

docBase="/opt/alfresco-3.4.e/tomcat/webapps/alfresco"/>

La variable path debe tener como valor la url por la que se accede al Document

Root del campus y añadirle '/biblioteca/alfresco'.

5. Iniciar el servicio alfresco

Si no se realizan las modificaciones anteriores y se deja el Alfresco en otra ruta se

deberá tener en cuenta posteriormente para modificar ciertos valores en el código de

la aplicación. Se deben el siguiente archivo:

[ruta_aplicacion_campus]/config.php

En él, deberemos indicarle los datos de conexión con la API de alfresco. Estos datos

son la relativa ruta de la api y un usuario de alfresco con permisos suficientes para

realizar as labores de creación de usuarios y espacios.

11

$CFG->alfresco_api =

'http://www3.gobiernodecanarias.org/medusa/pre/eforma/campus/biblioteca/alf

resco/api'; // ruta completa de la API de alfresco

$CFG->alfresco_ws_user = 'user'; // usuario con permisos suficientes

$CFG->alfresco_ws_admin = '****'; //clave del usuario con permisos

suficientes

3.2. Activación de Alfresco como repositorio

Para la activación de Alfresco como repositorio de documentación del Campus tan sólo

debe seguir un par de sencillos pasos, que se realizan desde el siguiente enlace:

[ruta_del_servidor]/admin/repository.php

Se selecciona la opción visible para que los usuarios puedan acceder a sus espacios y

trabajar sobre ellos.

Justo a continuación se le mostrará una página de configuración que contiene dos

opciones, la primera de ellas habilita a los usuarios a crear un repositorio en el curso,

y la segunda en función del contexto en el que se encuentre. En nuestro caso ambas

opciones estarán desactivadas.

12

Una vez que haya activado la opción correspondiente puede ordenarla según la

preferencia que quiera darle en el uso. En nuestro caso la pondremos en primer lugar

ya que será la opción principal como repositorio de información.

13

4. Webservices

Los webservices requieren la configuración del fichero impulsa_services.wsdl que

se encuentra en la carpeta “webservices”. En esta carpeta están los Webservices

desarrollados por Inventia Plus y que permitirán interactuar con el Campus. No deben

confundirse con los webservices de los diferentes componentes del campus (moodle,

alfresco...)

Se debe buscar la línea en la que se encuentra la etiqueta “soap:address location” y

en ella indicaremos la dirección del api alfresco del servidor que queramos utilizar.

En nuestro caso esa linea será:

<soap:address location =

"[ruta_del_servidor]/webservices/impulsaServices.php"/>

A continuación deberán seguirse los siguientes pasos:

1. Habilitar los servicios web en el sistema, para ello entramos en la siguiente

dirección y ahí veremos la opción “habilitar servicios web”, que marcamos y

guardamos los cambios.

[ruta_del_servidor]/admin/settings.php?section=optionalsubsystems

14

2. Habilitar el protocolo a utilizar (en nuestro caso SOAP)

[ruta_del_servidor]/admin/settings.php?section=webserviceprotocols

3. Crear un usuario específico para dichos servicios y comprobar los privilegios de

dicho usuario.

15

3.1. Primero creamos el usuario a través de este enlace.

[ruta_del_servidor]/user/editadvanced.php?id=-1

3.2. A continuación para comprobar los privilegios, visite la siguiente ruta,

seleccione el usuario creado y compruebe que dispone del privilegio

webservice/soap:use.

[ruta_del_servidor]/admin/roles/check.php?contextid=1

3.3. Si no dispusiera de dicho privilegio, no podría utilizar los webservices, por

lo que deberá solucionarlo, creando un rol de servicios web con las

capacidades necesarias y asígneselo al usuario como rol del sistema. Para

ello puede dirigirse a la siguiente dirección:

[ruta_del_servidor]/admin/roles/define.php?action=add

Recomendamos basar el role creado en el arquetipo “manager” para evitar

posibles problemas con los permisos en el webservice.

En la siguiente pantalla se indicará un nombre corto, un nombre largo, una

descripción de la función para la que se ha creado este nuevo rol y se deben dejar

todos los campos que aparecen a continuación con sus opciones por defecto, a

excepción de “Web Service: SOAP protocol” que debe activarse para permitir su

utilización por este nuevo role.

16

Una vez creado el nuevo role podrá asignárselo al usuario desde la dirección:

[ruta_del_servidor]/admin/roles/assign.php?contextid=1

17

4. A continuación seleccione el servicio correspondiente. Para ello deberá crear

utilizando el botón “Add” o añadir que se encuentra al final de la pantalla, en la

zona de servicios personalizados y al que deberá identificar con un nombre que

desee.

[ruta_del_servidor]/admin/settings.php?section=externalservices

En la página siguiente, marque las opciones “Habilitado” y “Usuario

autorizado”. Además seleccione “No se requiere permiso”.

Una vez creado seleccione las funciones requeridas para el servicio que acaba

de crear.

18

Se mostrará un largo listado, deberá seleccionar aquellas funcionalidades que

vayan a ser utilizadas por el webservice creado. En caso de dudas le

recomendamos que seleccione todas, ya que si omite alguna funcionalidad

necesaria los webservices no funcionarán de manera correcta.

5. Por último, tan sólo nos queda crear el token que se utilizará por los servicios

web, este paso lo deberá realizar en la dirección.

[ruta_del_servidor]/admin/settings.php?section=webservicetokens

En la pantalla que se nos muestra deberemos seleccionar el usuario que hemos

creado y asociado a nuestros webservices y en el desplegable servicio el propio

servicio que hemos creado.

19

Dicho token lo incluiremos en el archivo config.php existente en la carpeta

[ruta_del_servidor]/webservices. Si el archivo no existiera debería crearse

con el siguiente contenido:

<?PHP $token = “[token_generado_en_el_paso_anterior]”; ?>

20