Campus Impulsa Cliente - gobiernodecanarias.org
Transcript of Campus Impulsa Cliente - gobiernodecanarias.org
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