ZxChat Admin Guide/es

From ZeXtras Suite Wiki

Jump to: navigation, search
Idioma: English  • español • português
ZxChat logo box.png
Available since version: 1.6.4
Latest Version: 1.36
Released on: August 18th, 2016
Compatibility List
Admin Guide
XMPP Guide
Audit Logs
User Guide
FAQ

Compatibilidad

El zimlet ZxChat y el módulo para ZeXtras Suite se desarrollaron y estan certificados para funcionar en Zimbra 8 o posterior. Si fuera instalado en versiones anteriores se podrían experimentar comportamientos inesperados en el cliente web de los usuarios.

ZeXtras Chat es compatible con Zimbra Open Source Edition y con Zimbra Network Edition

Base de datos de Zextras Chat

ZeXtras Chat usa un esquema de base de datos dedicado y un motor para almacenar la información. Cuando se emite una nueva versión de tal esquema, se activa automáticamente una Actualización del mismo.

Firewalls y Proxy

El zimlet ZeXtras Chat usa los mismos puertos que el webmail para conectarse con el módulo, y esta conexión debe permanecer activa y será restablecida en un ciclo de 25 segundos, por lo que al haber mala conexión el servidor "piensa" que el cliente se desconectó, afectando el uso del Chat. Además, la función XMPP de ZxChat requiere el puerto 5222 (y 5223 para legacy SSL); entonces asegúrese que estos puertos puedan aceptar conexiones y que las mismas estén rutearas hacia el servidor apropiado.

Si está teniendo dificultades con las videollamadas debido a problemas de ruteo o NAT reverso pruebe utilizando un servidor TURN

Migración desde Instant Messaging de Zimbra

Si usted tiene Zimbra 7.x y quiere usar ZeXtras Chat en vez de la mensajería instantánea incorporada, o si está planeando una migración desde Zimbra 6 o 7 hacia Zimbra 8.x hay un comando disponible para migrar las listas de contactos hacia ZeXtras Chat.

 zxsuite chat doMigrateZimbraIMRoster

Este comando no necesita argumentos, y migrará todas las listas de mensajería de Zimbra hacia la base de datos de ZeXtras Chat. Las solicitudes pendientes de aceptación no serán migradas.

Función "View Mail" y ZeXtras Chat

Para proteger la privacidad de los usuarios y evitar suplantación de identidad el zimlet ZeXtras Chat solamente se encuentra disponible cuando se ingresa a la cuenta mediante nombre de usuario y contraseña. Al loguearse a través de la función específica para ver el correo desde la consola Zimbra aparecerá un mensaje de advertencia y el zimlet no se cargará.

Funciones avanzadas

Protocolo XMPP

ZeXtras Chat es 100% compatible con el protocolo XMPP, lo cual permite usar un cliente compatible para conectarse y chatear. Puede ver la guía con las funciones XMPP en esta página: ZeXtras Chat XMPP

Registros de auditoría de ZeXtras Chat

Los detalles sobre como habilitar o deshabilitar los registros avanzados de ZeXtras Chat los puede encontrar aquí: Registros de auditoría de ZeXtras Chat

Administración de ZeXtras Chat

Así como todos los demás módulos de ZeXtras, muchas de las tareas administrativas de ZxChat se pueden realizar desde el zimlet.

También está disponible la interfáz de línea de comandos, en tanto que todas las operaciones COS/Usuario con comandos se deben hacer desde la línea de comandos de Zimbra (`zmprov` and `zmzimletctl`). Todos los comandos se deben ejecutar como usuario "zimbra".

Iniciar o detener el Servidor de Chat

Zimlet administrativo de ZeXtras

Para iniciar el servidor ZeXtras Chat ingrese a la sección "Core" del zimlet de ZeXtras y presione el botón "Start" correspondiente al módulo ZxChat

Para detener el servidor de chat ZeXtras, presione el botón "Stop" en la misma sección.

Consola ZeXtras

El servidor de Chat se inicia automáticamente con el primer reinicio después de instalar ZeXtras Suite.

El estado del servicio se puede administrar mediante los comandos "getService", "doStartService", "doStartServices" y "dotopService"

Sintaxis:
   zxsuite chat getServices
 
        services                               
            module                                 
                could_start                                                false
                could_stop                                                  true
                running                                                    true
            xmpp                                   
                could_start                                                false
                could_stop                                                  true
                running                                                    true
            soap                                   
                could_start                                                false
                could_stop                                                  true
                running                                                    true
            store-event-destination               
                could_start                                                false
                could_stop                                                  true
                running                                                    true
            user-events-destination               
                could_start                                                false
                could_stop                                                  true
                running                                                    true
            history-event-destination             
                could_start                                                false
                could_stop                                                  true
                running                                                    true
            session-cleaner                       
                could_start                                                false
                could_stop                                                  true
                running                                                    true
            local-server-destination               
                could_start                                                false
                could_stop                                                  true
                running                                                    true
            session-manager                       
                could_start                                                false
                could_stop                                                  true
                running                                                    true
            flush-db                               
                could_start                                                false
                could_stop                                                  true
                running                                                    true
 

Para que el módulo ZxChate se encuentre totalmente funcional todos los servicios deben tener la propiedad "running" establecida en "true".

doStartService

Sintaxis:
  zxsuite chat doStartService {service_name}
  
LISTA DE PARAMETROS

NOMBRE             TIPO     
service_name(M)    String
    
(M) == parámetro obligatorio (O) == parámetro opcional

doRestartService

Sintaxis:
  zxsuite chat doRestartService {service_name}

LISTA DE PARAMETROS
 
NOMBRE             TIPO     
service_name(M)    String   
 
(M) == parámetro obligatorio (O) == parámetro opcional

doStopService

Sintaxis:
   zxsuite chat doStopService {service_name}  

LISTA DE PARAMETROS

NOMBRE             TIPO     
service_name(M)    String    

(M) == parámetro obligatorio (O) == parámetro opcional

Habilitación del autostart del servidor ZeXtras Chat

Desde el zimlet ZeXtras

Tildar la opción "Automatic module startup" que se encuentra al lado del botón "ZxChat" en la sección "Core" de Zextras.

Desde la interfáz de línea de comandos

Para habilitar el servidor de Chat de ZeXtras hay que establecer la propiedad "ZxChat_Enabled" en true mediante el comando "setPtoperty"

zxsuite chat setProperty ZxChat_ModuleEnabledAtStartup true

Desabilitar el servidor de Chat

Desde el zimlet ZeXtras

Simplemente destildar la opción "Automatic module startup" que se encuentra al lado del botón "ZxChat" en la sección "Core" de ZeXtras.

Desde la CLI

Para deshabilitar el servidor de chat Zextras la propiedad "ZxChat_Enabled" se debe establecer en false a través del comando "setPtoperty".

zxsuite chat setProperty ZxChat_ModuleEnabledAtStartup false

Habilitando el zimlet ZeXtras Chat para un usuario

Desde la consola Zimbra

Zxchat admin g 3.png

Desde la CLI de Zextras

Para habilitar el zimlet para un usuario se usa la línea de comandos de Zimbra:

 zmprov ma youraccount@domain.com +zimbraZimletAvailableZimlets com_zextras_chat

Deshabilitando el zimlet ZeXtras Chat para un usuario

Desde la consola Zimbra

Zxchat admin g 4.png

Desde la CLI de ZeXtras

Para deshabilitar el zimlet para un usuario se usa la línea de comandos de Zimbra

 zmprov ma youraccount@domain.com -zimbraZimletAvailableZimlets com_zextras_chat

Habilitando el zimlet ZeXtras Chat para una Clase de Servicio

Desde la cosola Zimbra

Zxchat admin g 5.png

Desde la interfáz de línea de comandos de Zimbra

Para habilitar el zimlet ZeXtras Chat para una clase de servicio se usa la línea de comandos de Zimbra:

 zmzimletctl acl com_zextras_chat [nombre_de_la_COS] grant

Deshabilitando ZeXtras Chat para una Clase de Servicio

Desde la consola Zimbra

Zxchat admin g 6.png

Desde la línea de comandos de Zimbra

Para deshabilitar el Zimlet Zextras Chat para una COS, se usa la CLI de Zimbra:

 zmzimletctl acl com_zextras_chat [nombre_de_la_COS] deny

Administración de contactos en Zextras Chat

Existen varias formas de administrar la lista de contactos de los usuarios: se pueden agregar dos contactos entre si a sus respectivas listas de contactos, o conectar todos los contactos existentes entre si mediante listas de distribución.

Consola de administración de Zimbra

Conectar dos contactos entre si

Chat connect user.png

Conectar todos los contactos entre si mediante una lista de distribución

Primeramente hace falta colocar todos los contactos en una lista de distribución. Posteriormente, para auto-rellenar la lista de contactos con todos los contactos, hay que establecer el valor de allowDlMemberAddAsFriend en true.

Warning.png ¡Atención!

Los contactos agregados con este metodo no pueden ser removidos

Friend chat dl.png

Zimbra CLI

doAddBuddies

Sintaxis:
   zxsuite chat doAddBuddies {user1} {user2} [attr1 value1 [attr2 value2...]]
LISTA DE PARAMETROS
NOMBRE          TIPO
user1(M)        Nombre de la cuenta
user2(M)        Nombre de la cuenta
user1nick(O)    String
user2nick(O)    String
(M) == parametro obligatorio, (O) == parametro opcional

Ejemplo de uso:
zxsuite chat doAddBuddies juan@example.com pablo@example.com user1nick "Mi Mejor Amigo"
Agrega Juan y Pablo entre si. Pablo verá a Juan como "Mi Mejor Amigo" en su lista del Chat.

doRemoveBuddies

Sintaxis:
   zxsuite chat doRemoveBuddies {user1} {user2}
LISTA DE PARAMETROS
NOMBRE      TIPO
user1(M)    Nombre de la cuenta
user2(M)    Nombre de la cuenta
(M) == parametro obligatorio, (O) == parametro opcional

Ejemplo de uso:
zxsuite chat doRemoveBuddies juan@example.com Pablo@example.com
Quita Juan de la lista de Pablo y viceversa.

getBuddyList


Sintaxis:
   zxsuite chat getBuddyList {account}
LISTA DE PARAMETROS
NOMBRE        TIPO
account(M)    Nombre de la cuenta
(M) == parametro obligatorio, (O) == parametro opcional

Ejemplo de uso:
zxsuite chat getBuddyList juan@example.com
Muestra la lista de contactos de Juan.

Lista de distribución de contactos Para agregar todos los miembros de una lista de distribución a la lista de contactos de los usuarios, debe establecerse el valor allowDlMemberAddAsFriend en true

<config>
zxsuite config distributionlist set friends@zimbra.local attribute allowDlMemberAddAsFriend value true
</config>
Warning.png ¡Atención!

Los contactos de la lista no pueden eliminarse

doMakeBuddies Agrega todos los miembros de una lista de distribución a la lista de contactos .


Sintaxis:
   zxsuite chat doMakeBuddies {distribution_list}
LISTA DE PARAMETROS
NOMBRE          TIPO
distribution_list(M)    String
(M) == parametro obligatorio, (O) == parametro opcional

Ejemplo de uso:
zxsuite chat doMakeBuddies example_list@example.com
Hace que todos los contactos en la lista se agreguen entre si.


** NOTA ** Este comando puede crear muchas entrada en la base de datos de ZxChat.
           Por ejemplo, si hay 100 miembros en la lista, las entradas
           agregadas a la base de datos serán 100 * 99 = 9900
Warning.png ¡Atención!

Este comando es obsoleto en Zextras Suite 2.6 y solo funciona en la versión Heredada


Limpieza de la base de datos de ZeXtras Chat

La limpieza es ejecutada de noche, y se remueven los siguientes items:

  • Mensajes no enviados en los últimos 30 días
  • Entradas de contactos rotas (ej. nexos a cuentas no existentes)

Enviar un mensaje a todos los usuarios "en línea"

Desde el zimlet ZeXtras

Esta función no está disponible desde el zimlet ZeXtras.

Desde la línea de comandos de ZeXtras

Para poder enviar un mensaje a todos los usuarios, se dispone del comando "broadcastMessage":


Sintaxis:
   zxsuite chat broadcastMessage {message} [attr1 value1 [attr2 value2...]]

LISTA DE PARÁMETROS

NOMBRE          TIPO                
message(M)    String              
domains(O)    Domain Name[,..]    

(M) == parámetro obligatorio, (O) == parámetro opcional

Ejemplo de uso:

zxsuite chat broadcastMessage "Broadcasted message" domains example1.com,example2.com
Envía un mensaje a todos los usuarios conectados en los dominios example1.com y example2.com
Personal tools