Instalación de IHMC CmapServer versión 4.14 para GNU/Linux
Descripción
CmapTools es una aplicación gratuita y multiplataforma creada por el Institute for Human and Machine Cognition (IHMC) para realizar Mapas Conceptuales (Cmaps) que representan modelos de conocimiento. Cuando esta aplicación cliente interactúa con el CmapServer, permite a los usuarios en cualquier parte del mundo a través de Internet, compartir, navegar, hacer comentarios y colaborar en la construcción de Cmaps.
El CmapServer actúa como un repositorio compartido y un índice de búsqueda de los Cmaps, permite la colaboración asincrónica a través de hilos de discusión y la colaboración síncrona durante la edición de los Cmaps a través de un chat en la aplicación cliente, además permite ver una versión de estos Mapas Conceptuales como página Web.
Si desea instalar la aplicación cliente, debe consultar: Instalación de CmapTools
Requisitos del Sistema con GNU/Linux
- PC con 500 MHz o una velocidad superior de procesador.
- 256 MB de RAM o superior.
- 200 MB de espacio disponible en disco duro mínimo.
- Super VGA (800 x 600) o adaptador de vídeo de mayor resolución.
- Teclado y Ratón o dispositivo de señalización compatible.
- Linux kernel 2.4.x o superior
Recomendaciones
Es recomendable la instalación de un solo CmapServer por máquina.
El computador donde se instalará CmapServer debe tener una dirección IP fija. CmapServer puede no funcionar correctamente en una máquina que esté configurado para utilizar DHCP.
La máquina debe ser registrada en un DNS. Si la máquina no está registrada en un DNS, el acceso a la CmapServer desde CmapTools puede ser extremadamente lento.
El CmapServer tiene un servidor web incorporado que permite el acceso a los mapas conceptuales en versión HTML. Este servidor web se ejecuta en el puerto 80 por defecto y, por lo tanto, CmapServer debe ser instalado como root. Si usted no tiene permisos como root o existe otro servidor web (es decir, Apache, IIS u otro) corriendo en este puerto, se debe cambiar el puerto del servidor web a alguno mayor que 1024. Se sugiere utilizar el puerto 8001 o 8080.
Si la máquina donde está instalado CmapServer tiene múltiples interfaces de red, usted puede seleccionar la dirección IP y el nombre de host que desea que CmapServer use al inscribirse en el Directorio de Lugares, y colocarlo en el archivo InstallCmapServer.properties antes de realizar la instalación, o en el archivo serverconfig.txt si ya la ha hecho. Las variables que editar son: server.ip.address y server.hostname.
Si usted tiene un firewall, entonces tiene que abrir algunos puertos con el fin de permitir que CmapServer se comuniquen con los clientes (CmapTools) y otros servidores. Los puertos que se deben abrir son: 4447 (TCP), 4747 (TCP / UDP) y el puerto del servidor web (es decir, 80, 8001 o el que se haya utilizado).
CmapServer corre por debajo. Se separa de la terminal y no tiene una ventana visible. Si quiere saber si está corriendo CmapServer debe verificar si existe en la máquina un proceso llamado CmapServer o probar la conexión desde un cliente CmapTools.
A la versión web de CmapServer se puede acceder desde cualquier navegador web con la siguiente sintaxis http://hostname:port_number/. El nombre de host puede ser también la dirección IP del servidor, y el número de puerto es el que se seleccionó (es decir, 80, 8001, 8080 u otro). Si el servidor Web se está ejecutando en el puerto 80 no es necesario incluirlo en la URL.
Con esta versión de CmapServer, se debe utilizar una versión de CmapTools superior o igual a la 4, que está disponible en la pagina de descarga de Cmaptools http://cmap.ihmc.us/download/ o en ftp://ftp.ihmc.us/DownloadCmapTools/CmapTools/
Al conectarse desde un CmapTools a una carpeta de CmapServer, se debe tener cuidado al momento de suministrar el usuario y la contraseña, ya que por defecto, CmapTool guarda estos datos. Para que esto no ocurra, debe seleccionar la casilla para utilizar estos datos sólo para la sección actual.
CmapServer viene con una herramienta denominada AdminTool la cual se puede utilizar para crear nuevos usuarios administradores, arrancar el servidor o pararlo tanto en la máquina local, como en máquinas remotas. Si desea utilizar esta herramienta de forma remota, debe instalar CmapServer en el equipo de administración, aunque no es lo suficientemente versátil para complicarse con su instalación.
CmapServer puede actualizarse por sí mismo. Ejecute el script <RUTA_INSTALACION>/bin/update. No es necesario descargar el programa de nuevo de la página web si usted ya tiene instalada una versión anterior de la CmapServer.
Para más información acerca de la arquitectura de la red de este sistema, permisos y control de acceso se puede consultar la siguiente dirección: http://cmap.ihmc.us/Documentation/WhitePapers.php
Cómo instalar CmapSever en GNU/Linux
Solicitar el instalador de CmapServer al Institute for Human and Machine Cognition (IHMC), a través del formulario disponible en: http://cmap.ihmc.us/download/dl_CmapServer_educ.php
Crear en la misma carpeta donde se tiene el instalador de CmapServer, un archivo de texto llamado "InstallCmapServer.properties" y ajustarlo a sus necesidades teniendo en cuenta las recomendaciones planteadas anteriormente. Un ejemplo de este archivo sin personalizar lo puedes descargar de la siguiente página: http://cmap.ihmc.us/download/InstallCmapServer.properties
- Estos son algunos de los parámetros que se deben modificar en este archivo, los datos con los que se llenan estos parámetros son tomados de una instalación típica:
Modo de instalación Silent, permite que la instalación de CmapServer corra sin ninguna interacción del usuario: INSTALLER_UI=silent
Directorio donde se instalará CmapServer, por ejemplo si es en /opt/CmapServer (el directorio debe ser creado previamente): USER_INSTALL_DIR=/opt/CmapServer/
El nombre de host es la dirección de Internet que se utilizará para generar la URL de las páginas web de los Cmaps almacenados en el CmapServer, y está determinada automáticamente por el servidor. Por ejemplo, cmapserver.midominio.org: server.hostname=cmapserver.midominio.org
El Nombre del Servidor es la descripción que aparecerá en el Directorio de Lugares, así como en los CmapTools: server.name= Descripción (Lugar de Origen)
Usuario y contraseña para la administración del CmapSever (no tiene relación con los usuarios del sistema operativo):
- admin.account=
- admin.password=
E-mail del administrador de CmapSever: admin.email.address=
El número de puerto que usted desea que CmapServer use para escuchar y recibir las solicitudes de los CmapTools. El puerto por defecto es el 4447: server.port=4447
- El número de puerto para el servidor Web interno, este puerto por defecto es el 80, pero debe verificarse que no esté siendo usado por otro programa, de ser así se debe escoger otro, como los sugeridos en la parte de recomendaciones: webserver.port=8001
CmapServer utiliza uno de los siguientes modo de conexión:
- En "SSL", donde todos los datos son encriptados para garantizar la comunicación.
- En "PKI", que utiliza una clave pública para autenticar los clientes, en caso de escoger este modo, se deben introducir los parámetros que se piden a continuación, los cuales son el nombre de ruta al archivo PKCS12 que contiene el certificado del servidor y de su clave privada. Si no escoge este modo de conexión, estos parámetros no deberán ser modificados.
- El modo “normal”, que es el modo por defecto. Los valores válidos son los siguientes: normal, ssl o pki (sólo minúsculas) server.connection.mode=normal
El Servicio de Auditoría mantiene un acta textual de la actividad de los usuarios en este CmapServer. Cada vez que un usuario guarda, copia, o elimina un archivo, el servicio de auditoría registra la fecha y la hora, el usuario que hace la solicitud, y el camino a los recursos afectados. El valor por defecto es false, si se desea activar debe cambiarse a true. En caso de querer activar esta opción se deben llenar los datos que piden a continuación donde se guardará la información, de lo contrario no deben ser modificados: audit.enabled=false
- Estos son algunos de los parámetros que se deben modificar en este archivo, los datos con los que se llenan estos parámetros son tomados de una instalación típica:
- Modificar los permisos de la instalación:
$ chmod 755 LinuxCmapServer_v4.06_04-28-06.bin $ chmod 755 InstallCmapServer.properties
Ejecutar el programa de instalación (Si el archivo InstallCmapServer.properties queda modificado con los parámetros adecuados, al instalarse no debe pedir ninguna información):
# ./LinuxCmapServer_v4.06_07-20-2006.bin -f InstallCmapServer.properties
Cómo ejecutar CmapSever como un servicio en Linux
Revisar que en el archivo <RUTA_INSTALACION>/bin/CmapServer.lax, la siguientes variables estén en blanco:
lax.stderr.redirect = lax.stdin.redirect = lax.stdout.redirect =
- Como usuario root crear el archivo /etc/init.d/cmapserver con el siguiente contenido (se debe mejorar este script!):
NAME=CmapServer
case "$1" in
start)
echo -n "Starting $NAME"
echo .
/opt/CmapServer/bin/CmapServer &
;;
stop)
echo -n "Stopping $NAME"
echo .
pkill -f CmapServer
;;
*)
echo "Usage: /etc/init.d/$NAME {start|stop}"
exit 1
;;
esac