E3.3.27_-_Modulo_ZCS_-_Manual_de_Instalacion-ZCS-OK_v1.1

SP3 – Módulo de Correo electrónico Manual de Instalación dd/mm/aaaa

Elaborado: Revisado: Aprovado:

Subproyecto SP3 Paquete SP3.3 Tarea 3.1.14 Versión: 1.0 Págs totales: 9

Índice Introducción........................................................................................................3 Preparación del entorno....................................................................................3 Instalación de Zimbra con los binarios............................................................3 Modificaciones necesarias en la BDD..............................................................4 Despliegue de las utilidades del ámbito SUMA en la parte servidora..........4 Personalización de Zimbra................................................................................5 Mantenimiento de Zimbra..................................................................................7 Provisión de cuentas..........................................................................................7 Provisión de una cuenta....................................................................................9 Acceso a Zimbra desde el LMS vía web.........................................................10

Histórico Versión Comentarios 1.0 Versión inicial

Módulo de correo electrónico · Manual de instalación Versión: 1.0

Autor openTrends

Fecha 03/11/08

Página 2 de 9

Introducción El objetivo de este documento es documentar un proceso de instalación paso a paso de una aplicación Zimbra en un servidor Linux con los complementos desarrollados específicamente en el ámbito del proyecto SUMA. Concretamente se utilizará : ●

Zimbra 5.0.0

●

Linux Suse 10.0

Preparación del entorno El entorno necesario para instalar Zimbra comprende : ●

Versión instalable original de Zimbra

●

Código fuente modificado en el ámbito del proyecto SUMA

Instalación de Zimbra con los binarios Desde la web de Zimbra, bajarse la versión binaria 5.0.0 del Zimbra Collaboration Suite para el sistema operativo destino. Mover este paquete a un directorio temporal de la máquina que hará de servidor. Abrir una sesión SSH contra el servidor donde se quiere instalar el Zimbra. Entrar como usuario root del sistema y cambiar de directorio hasta posicionarse donde se ha guardado el fichero tar. Lo desempaquetaremos con el comando : > tar xzf zcs.tgz Se creará un directorio /zcs. Para ejecutar el instalador, haremos : > cd zcs > ./install.sh Módulo de correo electrónico · Manual de instalación Versión: 1.0

Página 3 de 9

Esto iniciará el proceso. ●

Si ya teníamos un zimbra instalado, primero ejecutaremos ./install.sh -u para desinstalarlo y después continuaremos con el proceso descrito.

Se recomienda, en un primer paso, realizar una instalación estándar siguiendo los pasos explicados en el manual de Zimbra. De esta manera conseguimos instalar Zimbra con todos los paquetes necesarios para a su correcta ejecución.

El manual se puede encontrar en la página Web de Zimbra Instal·lación de Zimbra 5.0. Una vez realizada la instalación estándar, hay que añadir los cambios hechos para la adaptación al LMS.

Modificaciones necesarias en la BDD Una de las modificaciones incorporadas en la parte servidora de Zimbra ha sido la posibilidad de consultar un histórico de las acciones realizadas sobre un correo (envío, lectura, borrado, re-envío...) Esto no estaba previsto por Zimbra y se ha tenido que hacer un desarrollo ad-hoc. Para guardar la información, además , se ha modificado la base de datos MySQL que usa el aplicativo añadiendo una tabla. Para añadir esta tabla deberemos ejecutar el script script_BD_campus.sql.

Despliegue de las utilidades del ámbito SUMA en la parte servidora Una vez el Zimbra esté instalado, se le aplicarán los cambios desarrollados en el ámbito de SUMA en la parte del servidor. Se recomienda detener Zimbra.

Módulo de correo electrónico · Manual de instalación Versión: 1.0

Página 4 de 9

Dentro del directorio /opt/zimbra buscaremos todos los ficheros zimbracommon.jar y los sustituiremos por nuestro fichero zimbracommon.jar. Nuevamente, en el directorio /opt/zimbra buscaremos todos los ficheros zimbrastore.jar y los sustituiremos por el nuestro fichero zimbrastore.jar. En los directorios donde encontremos el fichero zimbrastore.jar también copiaremos los ficheros okiBusDummy.jar i okiOSID-2.0.jar. Volvemos a iniciar Zimbra para que detecte los cambios y despliegue los archivos. Los cambios necesarios para la integración con el LMS en el ámbito del proyecto SUMA, se habrán aplicado.

Personalización de Zimbra Una vez que Zimbra se haya instalado y adaptado a LMS de SUMA es necesario realizar tareas de administración para a eliminar todo lo que no sea necesario o no se desee utilizar. Se muestra la configuración mínima, cualquier otra que se desee se podrá adaptar a las necesidades de cada momento.

Acceder mediante el cliente web de administración. https://www.zimbraServer.net:7071/zimbraAdmin

Accedemos a Configuration -> Class of Service (COS) y definimos la funcionalidad que queremos activar. A modo de ejemplo indicamos lo que se debería escoger para activar el calendario. El resto de opciones no indicadas deberán dejarse desactivadas.

●

Pestaña “Features”

Módulo de correo electrónico · Manual de instalación Versión: 1.0

Página 5 de 9

Dejamos activadas las siguientes opciones : Major Features ●

Calendar

●

Preferences

General Features ●

Tagging

●

Sharing

CalendarFeatures ● ●

Group Calendar

Pestaña “Preferences” Configurar las CalendarOptions

●

Pestaña “Themes” Limitamos la presentación a la que hay por defecto

●

Pestaña “Zimlets” Configuración por defecto

●

Pestaña “Server Pool” Configuración por defecto

●

Pestaña “Advance” Configuración por defecto

Accedemos a Configuration -> Servers -> Servidor instalado ●

Pestaña “Services” Validamos que todos los servicios estén habilitados

●

Pestaña “IMAP” Desactivamos el acceso a través del protocolo IMAP

●

Pestaña “POP”

Módulo de correo electrónico · Manual de instalación Versión: 1.0

Página 6 de 9

Desactivamos el acceso a través del protocolo POP

Mantenimiento de Zimbra Zimbra se configura para ser arrancado con el inicio del propio SO, pero a la vez proporciona un ejecutable para controlar el estado, detener o arrancar el gestor de correo. /opt/zimbra/bin/zmcontrol [-v -h -H ] command [args] -v:

display version

-h:

print usage statement

-H:

Host name (localhost)

Command in: maintenance

Toggle maintenance mode

shutdown

Stop services

start

Start services

startup

Start services

status

Display service status

stop

Stop services

Provisión de cuentas Zimbra ofrece dos maneras de poder crear cuentas con la interacción de un usuario de administración. Desde el mismo cliente web de administración o utilitzando la herramienta zmprov. Mientras que el cliente web de administración ya incorpora documentación detallada de todos los processos, la herramienta zmprov no. Por este motivo se documentará esta herramienta. Zmprovtool realiza todas las tareas de aprovisionamiento en Zimbra LDAP, incluyendo creación de cuentas, alias, dominios, listas de distribución, recursos y calendarios. Todas las operaciones son invocadas por opciones en la línea de comandos, cada una de las cuales tiene un nombre corto y otro largo. Módulo de correo electrónico · Manual de instalación Versión: 1.0

Página 7 de 9

Esta herramienta acepta entradas desde la línea de comandos o a través de un fichero con la sintaxis de la operación que se desee realizar. Operaciones básicas para cuentas : Nombre largo

Nombre corto

Sintaxis i ejemplos

CreateAccount

ca

Sintaxi:{name@domain} {password} [attribute1 value1 etc] Type on one line. zmprov ca [email protected] test123 displayName JSmith

DeleteAccount

da

Sintaxi:{name@domain|id|adminName} zmprov da [email protected]

GetAccount

ga

Sintaxi:{name@domain|id|adminName} zmprov ga [email protected]

GetAllAccounts

gaa

Sintaxi: [-v] [{domain}] zmprov gaa zmprov gaa -v domain.com

ModifyAccount

ma

Sintaxi: {name@domain|id|adminName} [attribute1 value1 etc] zmprov ma [email protected] zimbraAccountStatus maintenance

Provisión de una cuenta Se creará un fichero -commands.zmp- de texto con las entradas, cada una en una línea, que se deseen realizar. En este caso, creación de cuentas.

createAccount [email protected] password displayName 'Nombre Apellido1 Apellido2' zimbraCUERPOId IdentificadorDelCuerpoCreado givenName 'Nombre' sn 'Apellido1 apellido2' Módulo de correo electrónico · Manual de instalación Versión: 1.0

Página 8 de 9

La contraseña en el caso del LMS de SUMA no es realmente necesaria ya que todas las validaciones de autenticación se realizan contra el propio LMS y nunca contra Zimbra, aunque para más seguridad, se puede definir una genérica conocida por los administradores. Sólo es necesario el atributo zimbraCOSId y se ha creado un Class Of Service nuevo y específico para al LMS y se debe indicar el identificador. Éste se puede recuperar mediante otra instrucción : getCuerpo NombreDelCUERPO

Ejecutar zmprov < commands.zmp para realizar las inserciones.

Acceso a Zimbra desde el LMS vía web Zimbra está implementado para ser accedido vía pantalla de login donde se solicita un usuario y una contraseña. Desde el LMS se quiere evitar este tipo de acceso, ya que el usuario se debe autenticar en el LMS a través del módulo específico de Campus. Y en ningún momento se debe volver a solicitar un nuevo acceso en cualquier otro módulo. Zimbra ofrece un servicio de pre-autenticación para evitar volver a solicitar datos de usuario. Desde el módulo de LMS se deberá acceder a Zimbra con la siguiente URL : http://zimbra.domain.cat/service/preauth?isCampusAccess=true El parámetro isCampusAcces nos definirá que el tipo de acceso es interno al LMS. En cualquier otro caso se utilizará el acceso específico de Zimbra indicando los parámetros necesarios.

Módulo de correo electrónico · Manual de instalación Versión: 1.0

Página 9 de 9