ZeXtras Migration Tool Installation Guide/es

From ZeXtras Suite Wiki

Jump to: navigation, search
Idioma: English  • español • português

Guía de instalación de ZeXtras Migration Tool

Prerrequisitos

Ningún software adicional más allá del requerido por Zimbra es necesario para instalar ZeXtras Migration Tool.

Dónde descargar los archivos de instalación de ZeXtras Migration Tool

Directamente desde la página de download.

Instalación y configuración

Componentes

ZeXtras Migration Tool está compuesto por dos elementos principales:

  • El Core, que es básicamente un “paquete Jar para expandir Zimbra.
  • El Zimlet, que accesa y administra el Core.


El script de instalación sigue una estructura estándar permitiéndole tres opciones de instalación: core, zimlet y all. La última es equivalente a instalar el core y el zimlet juntos.

A continuación se explican en detalle todas las combinaciones posibles.

Instalación de ZeXtras Suite en ambientes multistore

Tenga en cuenta las siguientes reglas para instalar ZeXtras Migration Tool cuando trabaja en un ambiente multistore:

REGLA 1: ZeXtras Suite debe ser instalado en todos los servidores que ejecutan el servicio 'mailboxd'.

REGLA 2: Instalar ZeXtras Suite en cada servidor uno a uno. Hacerlo en varios servidores al mismo tiempo puede saturar los logs de errores.

REGLA 3: si su Master Server LDAP es también un servidor de e-mail, la REGLA 2 se hace imprescindible. Si falla va a causar problemas mayores, destrucción y detención del servidor.

REGLA 4: Como de costumbre, tome su tiempo:)


Instrucciones generales

Antes de instalar ZeXtras Migration Tool es necesario descargar el paquete, como fue explicado en la sección apropiada arriba, y abrir el archivo en una carpeta de su elección.

$ tar xfz zextras_migration_tool-X.X.X.tgz
$ ls 
zextras_migration_tool-X.X.X.tgz zextras_migration_tool-X.X.X/

Dentro de la carpeta <codeZzextras_migration_tool-XXX</code> debe encontrar un shell script ejecutable llamado install.sh.

$ cd zextras_migration_tool-X.X.X
$ ./install.sh -h

./install.sh -h | ./install.sh [ -u ] all|zimlet|core 

-h         Éste mismo mensaje
-u         Desinstalar la selección

Las opciones disponibles para la (des)instalación son:
core   -- El Core de ZeXtras Migration Tool
zimlet -- El Zimlet ZeXtras Migration Tool
all    -- El Core seguido del Zimlet

* Para que se pueda utilizar la herramienta ZeXtras Migration Tool tienen que estar instalados el Core y el Zimlet.

El Output de ./ Install.sh-h dará al usuario una explicación concisa sobre el uso del script de instalación.

Para ejecutar una instalación sin problemas se requiere ser usuario root o ejecutar el script con privilegios de root. Por ejemplo:

$ su -
# ./install.sh all

or

$ sudo ./install.sh all

Una vez iniciado, el script ejecutará una verificación de su sistema determinando su versión Zimbra y la existencia de cualquier instalación preexistente de ZeXtras Migration Tool o ZeXtras Suite.

Warning.png ¡Atención!

Si fueran detectados componentes de ZeXtras Suite, se le pedirá que los desinstale (como se detalla aquí) y deberá ejecutar nuevamente el script de instalación de ZeXtras Migration Tool.

Para continuar con la instalación deberá aceptar el 'Acuerdo de licencia de usuario final' de ZeXtras y solo después, la instalación propiamente dicha tendrá lugar.
Para más detalles sobre la instalación del Core o del Zimlet de ZeXtras Migration Tool, consulte las secciones relacionadas más abajo.


Instalación completa de ZeXtras Migration Tool

--- RECOMENDADO ---
Para instalar ZeXtras Migration Tool, es necesario que el Core y el Zimlet hayan sido instalados correctamente, y estén completamente funcionales.
Seleccionando all, instalará el Core y el Zimlet, en ese orden, y de una sola vez.
Alternativamente, se puede invocar el script install.sh con el core o el zimlet, instalando cada uno separadamente.

Warning.png ¡Atención!

Deben corresponder las versiones del Core y del Zimlet de ZeXtras Migration Tool, cuando son instalados separadamente.

Video tutorial de instalación de ZeXtras Migration Tool (en Inglés)


Instalación completa

./install.sh all

Instalación del Core ZeXtras Migration Tool

Para instalar el Core es necesario que los servicios Zimbra hayan sido detenidos previamente.
Se puede detener antes de ejecutar el script, o interrumpirlo cuando el script lo solicite.
Una vez que ese paso esté completo, el script ejecutará una serie de verificaciones sobre una eventual instalación anterior del Core de ZeXtras Migration Tool y, eventualmente, instalará el “archivo jar” entre las extensiones Zimbra.

Instalación del Core por separado:

./install.sh core

Una vez instalado el Core, Zimbra deberá ser reiniciado para verificar si la operación fue realizada correctamente.
(Si se estuviera usando la opción all para instalar el Core y el Zimlet, el propio script pedirá iniciar Zimbra).
Una vez que Zimbra esté totalmente iniciado, la presencia de líneas como las que se mencionan a continuación /opt/Zimbra/log/mailbox.log indicarán una instalación exitosa.

INFO  [main] [] extensions - Initialized extension ZExtrasExtension: com.zextras.extension.ZExtrasExtension@com.zimbra.cs.extension.ZimbraExtensionClassLoader@7543073a
[...]
INFO  [main] [] extensions - registered handler at /zextras
[...]
INFO  [main] [] extensions - ZExtrasExtension Started

Instalación del Zimlet ZeXtras Migration Tool

Para instalar el Zimlet es necesario que los servicios Zimbra estén funcionando.
Como se explicó mas arriba, se puede proceder manualmente antes o dejar que el script los inicialice cuando se lo solicite.
Una vez que Zimbra esté activo, el zimlet será instalado; si el Core ha sido instalado previamente, la versión del Zimlet debe coincidir con aquél.

Instalación del Zimlet por separado:

./install.sh zimlet


Actualización completa de ZeXtras Migration Tool

En caso de una instancia preexistente de ZeXtras Migration Tool en su sistema, la instalación de una nueva versión automáticamente hará la actualización.
Vea las instrucciones más arriba para el procedimiento de Instalación.

Warning.png ¡Atención!

Las versiones del Core y del Zimlet deben siempre coincidir para que ZeXtras Migration Tool funcione correctamente. Téngalo en cuenta si actualiza los componentes por separado.


Reversión completa de ZeXtras Migration Tool

A fin de revertir cualquier componente de ZeXtras Migration Tool, es necesario desinstalarlo usando un script de instalación de un paquete de la misma versión o superior, y posteriormente, instalar las versiones mas antiguas.

Warning.png ¡Atención!

Una reversión puede tener como resultado que las licencias o los backups existentes no sean reconocidos correctamente por la versión anterior de ZeXtras Migration Tool. En consecuencia, no es recomendado ni nos responsabilizamos por las pérdidas de datos.

Desinstalación completa de ZeXtras Migration Tool

El procedimiento de remoción es mas bien semejante a una instalación. Colocando la opción -u antes del archivo, es todo lo que se requiere.
El script verificará la presencia de todos los componentes de ZeXtras Migration Tool y solicitará su remoción.
Utilizando la opción -all, se removerá primero el Core y posteriormente el Zimlet.

Por ejemplo:

./install.sh -u all

---

Conclusión

En caso que no se llegue a una conclusión exitosa, verifique paso a paso esta guía, o dé un vistazo a la sección Solución de problemas.

Ahora que ZeXtras Migration Tool está instalado, seguramente querrá usarlo; siga este link para ver como..

Personal tools