Manual Tcnico OpenFire

COLOMBIA

Aplicacin OpenFire Instalacin, configuracin y administracin

1.1.1.1.1.1.1.1.1

Versin 1

Este documento contiene secretos del negocio e informacin de propiedad de Claro Colombia. No est permitido ningn tipo de utilizacin de la informacin contenida aqu sin previo consentimiento escrito

BOGOT D.C., COLOMBIA, julio de 2013.

Manual Tcnico OpenFire

Control de Revisiones

Versin 1.0

Realizada por Edwin Pineda Alvaran

Descripcin de la revisin Creacin

Fecha de Terminacin Julio 2013.

Este documento es solo para uso interno y es clasificado como CONFIDENCIAL.

Manual Tcnico OpenFire

MENU INDICE
Generalidades .. Instalacin de Openfire. Activando openfire . Completando El Proceso De Instalacin Del Servidor Openfire .

Administracin de openfire .. Autenticacin a la consola de administracin del Openfire .

REQUISITOS Instalacin de Plugin faspath .. Conclusiones .

Manual Tcnico OpenFire

GENERALIDADES
OpenFire (anteriormente llamado WILDFIRE y JIVE Messenger) es un sistema de mensajera instantnea GPL y hecho en java utiliza el protocolo XMPP, es un servidor de chat. Con l se puede administrar a los usuarios, compartir archivos, auditar mensajes, mensajes offline, mensajes broadcast, grupos, entre otras funcionalidades y adems contiene plugins gratuitos con diferentes funciones extras. La administracin del servidor se hace a travs de una interfaz web, que corre por defecto en el puerto 9090 (HTTP) y 9091 (HTTPS). Los administradores pueden conectarse desde cualquier lugar y editar la configuracin del servidor, agregar y borrar usuarios, crear cuartos de conferencia permanentes, grupos, etc. Caractersticas:# Openfire implementa las siguientes caractersticas: 1. Panel de administracin web 2. Interfaz para agregar plugins 3. SSL/TLS 4. Amigable 5. Adaptable segn las necesidades 6. Conferencias 7. Interaccin con MSN, Google Talk, Yahoo messenger, AIM, ICQ 8. Estadsticas del Servidor, mensajes, paquetes, etc. 9. Clster con mltiples servidores 10. Transferencia de Archivos 11. Compresin de datos 12. Tarjetas personales con Avatar 13. Mensajes offline 14. Favoritos 15. Autenticacin va Certificados, Kerbeos, LDAP, PAM y Radius 16. Almacenamiento en Active Directory, LDAP, MS SQL, MySQL, Oracle y PostgreSQL 17. SASL: ANONYMOUS, DIGEST-MD5 y Plain

Manual Tcnico OpenFire

La aplicacin est desarrollada en java, es libre y permite ser adaptada de acuerdo a las necesidades de la empresa.

INSTALACION
Nota: Se puede instalar en sistemas operativos tales como: Windows, Linux, Mac os. En esta ocasin se instalara en Linux ya que es donde estar el ambiente de produccin para la empresa. 1. El primer paso para la implementacin de un servidor Openfire ser descargar el paquete que contiene dicha aplicacin, para ello tendremos que dirigirnos al siguiente portal web, que es la pgina oficial y la versin con la que trabajaremos ser Openfire 3.8.2 http://www.igniterealtime.org/projects/openfire/index.jsp Una vez dentro, nos pedir que seleccionemos la plataforma bajo la cual se desea instalar Openfire, daremos clic en el botn Linux Posteriormente nos desplegara un men que nos mostrara cuatro versiones de Openfire, en este caso seleccionaremos y descargaremos el paquete que fue diseado para distribuciones Linux basadas en Redhat. O descargar la versin Openfire 3.8.2 del repositorio interno la cual encontramos en: svn://172.22.1.60:3690/telmex_corporativo/trunk/Openfire-3-8-2/ openfire-3.8.21.i386.rpm

2. El siguiente paso ser instalar el paquete, para ello haremos uso del comando rpm, a continuacin veremos un ejemplo de cmo se vera despus de ejecutar el comando:
[root@localhost]# rpm -ivh openfire-3.8.2.i386.rpm Preparando... ############################## [100%] 1:openfire ################### [100%] }}}

3. El siguiente paso es crearle una base de datos a Openfire Integrando MySQL con el servidor Openfire para ello se debe tener instalado el motor de base de datos de MySQL (instalar MySQL). 4. Ahora que tenemos ya instalado tanto el servidor Openfire como el manejador de Bases de datos MySQL, solo nos resta integrar estas dos aplicaciones para que operen de manera conjunta. Para ello tendremos que generar en el manejador de MySQL lo siguiente:

Manual Tcnico OpenFire

Una cuenta de usuario: Un password para la cuenta de usuario: Una base de Datos:

Esta cuenta de usuario ser la asignada al administrador del servidor de mensajera Openfire. Sera el password asignado a la cuenta del administrador del servidor de mensajera Openfire. Base de Datos en la cual sern dados de alta los usuarios de este servidor de mensajera y gestionadas por el administrador del servidor Openfire.

5. Una vez ledo lo anterior comenzaremos por dar de alta la cuenta de usuario as como un password para el mismo, para ello abriremos una terminal y nos pasaremos al modo consola de MySQL como se muestra a continuacin:
[root@localhost]# mysql -u root -p Enter password: nos

pedir teclear la contrasea de root de MySQL.

6. Lo siguiente ser dar de alta la base de datos para el servidor de mensajera Openfire.
Mysql> CREATE DATABASE openfire; Query OK, 1 row affected (0.00 sec)

7. Despus dirjase al siguiente directorio

[root@localhost]# cd /opt/openfire/resources/database

8. He importe el fichero .sql a la base de datos que creamos, en este caso como nuestro manejador de bases de datos es MySQL seleccionamos el fichero .sql que hace referencia a MySQL como se muestra a continuacin:
[root@localhost]# cat openfire_mysql.sql | mysql -u root -p openfire Enter password: nos

pedir teclear la contrasea de root de MySQL.

9. Lo siguiente ser asignarle al administrador de Openfire una cuenta dentro de MySQL y luego de ello asignarle a este usuario permisos de lectura, escritura y ejecucin sobre la base de datos que antes creamos, esto se consigue de la siguiente manera.

Manual Tcnico OpenFire

mysql> GRANT ALL ON openfire.* TO 'adminopenfire'@'localhost' IDENTIFIED BY 'PASSWORD' WITH GRANT OPTION; Query OK, 0 rows affected (0.00 sec) mysql>

La palabra PASSWORD se refiere al password del usuario adminopenfire el cual ser asignado por usted.

ACTIVANDO OPENFIRE
10. Para iniciar el servidor de mensajera Openfire por primera vez solo deber teclear en terminal el siguiente comando:
[root@ localhost ~]# /etc/init.d/openfire start

Igualmente existen opciones ya sea para reiniciar, detener, recargar o conocer el status en el que se encuentra el servidor de mensajera Openfire. Estas opciones pueden ser consultadas en la siguiente tabla:
Start Stop Restart Inicia el servicio Detiene el servicio Reinicia el servicio.-La diferencia con reload radica en que al ejecutar un restart este mata todos los procesos relacionado con el servicio y los vuelve a generar de nueva cuenta Recarga el servicio.-La diferencia con restart radica en que al ejecutar un reload este solamente carga las actualizaciones hechas al fichero de configuracin del servicio sin necesidad de matar los procesos relacionados con el mismo, por lo que podra entenderse que hace el cambio en caliente. Da a conocer el estado en el que se encuentra el servicio

Reload

status

Como alternativa tambin podemos ocupar el siguiente comando para iniciar el servidor de mensajera Openfire
[root@ localhost ~]# service openfire start

Y de igual manera podemos usar las opciones antes descritas en la tabla anterior. Recuerde que estos comandos se ejecutan como root.

Manual Tcnico OpenFire

Completando El Proceso De Instalacin Del Servidor Openfire

11. Para completar el proceso de instalacin del servidor de mensajera Openfire primero debern estar levantados los servicios de apache, MySQL as como el Openfire, as que si alguno de estos est apagado no podr visualizar la interfaz grfica del servidor Openfire. Una vez que nos hemos asegurado que estos servicios estn levantados, solo tendremos que abrir un navegador y teclear en la parte superior, la URL de la direccin IP del servidor que tiene instalado el servidor seguido del puerto 9090 por el cual recibe peticiones el servidor ejemplo: http://192.168.1.45:9090, all elegimos el idioma Espaol en que y Damos clic al botn Contine.

12. El siguiente paso ser elegir el dominio sobre el cual trabajara el servidor, en este caso nuestro dominio tiene por nombre jabber.test.com o (hostname), la eleccin de los puertos 9090 y 9091 son los puertos por los cuales podremos acceder en futuras sesiones para fines de gestin y administracin del servidor, a menos que usted quiera cambiar estos puertos, se recomienda dejarlos como estn:

Manual Tcnico OpenFire

13. El siguiente paso ser configurar la fuente de datos, de las cuales elegiremos la Conexin Estndar y luego de ello , dar clic en el botn Continuar Posteriormente en la seccin Driver Predefinido seleccionaremos el driver de MySQL esto es porque nosotros configuramos el servidor con MySQL, en caso de haber sido PosgreSQL se tendra que haber elegido el driver de PosgreSQL, el campo Clase del Driver JDBC ser generado automticamente despus de haber seleccionado el driver de MySQL.

El siguiente campo URL de la Base de Datos nos mostrara el siguiente texto:

dbc:mysql://[host-name]:3306/[database-name] Debemos sustituir el (host-name) por la palabra localhost, as como tambin agregar el nombre de la base de datos que creamos previamente en el campo (database-name),la cual tiene por nombre Openfire.

Manual Tcnico OpenFire

Una vez terminado, debiera quedar as:

dbc:mysql://localhost:3306/openfire

Por ltimo, solo deber teclear el nombre de usuario y la contrasea de la base de datos generada anteriormente. El login de usuario es root e igualmente tendr que teclear la contrasea que usted le asign a root

14. Damos clic en el botn Siguiente. El siguiente paso ser elegir en la seccin Seteos de Perfil la opcin Por defecto nos permite crear manualmente los usuarios y es un proceso intuitivo y fcil pero para nuestra configuracin necesitamos configurarlo con el directorio activo de DataCenter y elegiremos Directory Server (LDAP) posteriormente dar clic en siguiente:

10

Manual Tcnico OpenFire

15. Ahora debemos dar la configuracin del directorio activo, en el ejemplo: Tipo de Servidor: OpenLDAP, Servidor: localhost, DN Base: dc=redlinux,dc=org, En Autenticacin DN del Administrador:cn=admin,dc=redlinux,dc=org Y Clave: la clave del administrador, para comprobar que todo ha sido ingresado correctamente presione el botn Testear seteos (recomendado) o contine presionando el botn Salvar y continuar.

NOTA: esto en caso de que sea un open LDAP pero para nosotros sera un directorio activo de Windows y la configuracin estara en la siguiente tabla:

11

Manual Tcnico OpenFire

16. Presione los botones de Salvar y Continuar ya que l toma valores por defecto del mapeo del directorio activo.

17. Ahora ingresamos el nombre de un usuario que acta como administrador de Openfire, este debe ser un usuario valido que se encuentre en el rbol LDAP, en este caso el Administrador del Openfire.

18. Finalmente nos conectamos a la consola de administracin.

19. Teniendo instalado el cliente Spark en Linux o Windows y teniendo acceso a la red del servidor de Openfire ya nos podemos conectar con los usuarios de nuestro directorio activo. 12

Manual Tcnico OpenFire

ADMINISTRACION DE OPENFIRE
Autenticacin a la consola de administracin del Openfire
La gestin de acceso a la consola de administracin de Openfire debe estar controlada solo por el administrador o administradores del Openfire. La cual se encuentra en la siguiente direccin IP.

172.22.104.130:9090
Nos conectamos con la cuenta administrativa y su contrasea, en este caso Admin. Damos clic al botn Login.

1. Estamos en la pantalla inicial de la consola administrativa, desde aqu podemos ver el estado del servidor Openfire, siguiente paso, activaremos zona horaria. Damos clic en Lenguaje and Time.

13

Manual Tcnico OpenFire

La siguiente imagen es la del actual servidor de produccin:

2. Activamos zona horaria. Damos clic al botn Save Settings.

14

Manual Tcnico OpenFire

3. Activamos cambios en la parte de seguridad de cuentas de usuarios deshabilitando creacin libre de cuentas y cambios de contraseas. Damos clic al botn Server Settings y Registration & Login, hacemos los cambios y damos clic al botn Save settings.

15

Manual Tcnico OpenFire

4. Activamos cambios en la parte de configuracin de correo porque de lo contrario no se podrn enviar transcripciones de chat a los clientes o usuarios externos del chat.

16

Manual Tcnico OpenFire

REQUISITOS
Los requisitos para la ejecucin de forma correcta de la aplicacin oTrack son: Tener instalado Java (JRE) en una versin igual o superior a la 1.6.0_X.

Tener conectividad hacia http:// 172.22.104.130:5222 Tener conectividad hacia http:// 172.22.104.130:9090 para la consola

administrativa
Tener cuenta activa con password vigente en el directorio activo Motor d base de datos MySQL, sistema de gestin de bases de datos relacional Apache Tomcat, contenedor de aplicaciones web. GlassFish servidor de aplicaciones de software libre en la versin minimo 3.1 o superior

17

Manual Tcnico OpenFire

INSTALACION DE PLUGIN FASPATH

Plugin de web chat o Fastpath: Web chat es parte del producto de Openfire es un complemento que permite una va de acceso rpida para clientes externos a nuestro servidor de mensajera. Proporciona una forma fcil para que los usuarios externos hablen con agentes de soporte utilizando el chat. Instalacin Web chat o Plug-in de Fastpath est dividido en dos partes: 1. Fastpath Service: es un Plug-in que se instala en el servidor de Openfire y se realiza en los siguientes pasos: I. Se debe de descargar de la siguiente direccin http://www.igniterealtime.org/projects/openfire/plugins.jsp el Plug-in de Fastpath service.

II.

Y se debe instalar en el servidor de Openfire ingresando a la consola de administracin.

18

Manual Tcnico OpenFire

III.

Despus se debe ir a la pestaa de Plugings y se sube el archivo descargado del Plugin fastpath con el nombre de (fastpath.jar) como se muestra a continuacin:

IV.

El Plugin automticamente se adaptara y estar totalmente instalado cuando aparezca la pestaa de Fastpath como se ve a continuacin

V.

Despus de instalado se puede ingresar a la pestaa para la configuracin de los grupos de chat para los clientes externos, las configuraciones tienen la opcin de administrar y gestionar las colas de chat, los usuarios, operadores pertenecientes a cada grupo, imgenes que visualiza el cliente externo, textos de bienvenida y de informacin del proceso de chat, configuracin de transcripcin de chat, entre otras opciones.

19

Manual Tcnico OpenFire

Nota ten en cuenta que el Plugin no funciona si el web chat no est instalado y configurado, lo cual se detalla ms delante de este manual. A continuacin vemos las opciones que se tiene en la pestaa de fastpath:

VI.

Vamos a crear nuestro primer grupo y a ver las opciones que nos permite damos clic en el botn crate workgroup

20

Manual Tcnico OpenFire

VII.

Nos aparecer un formulario lo rellenamos como se ve a continuacin: Workgroup Name: es el nombre del grupo que visualizara el cliente externo Members: son los usuarios u operadores que pertenecen al grupo de soporte Y se pueden buscar en el link Browser. Nota: Un usuario puede pertenecer a uno o varios grupos. Description: es una descripcin general del grupo

VIII.

Despus de creado el grupo nos desplegara un men al lado izquierdo de la consola de administracin donde encontraremos diferentes opciones de configuracin del grupo.

21

Manual Tcnico OpenFire

Mannger Queque: nos permite configurar las diferentes colas que puede tener el chat y por medio de reglas adaptarlas a la mejor solucin.

Room Monitors: funciona para agregar y definir un monitor para el grupo el cual puede ver en tiempo real cualquier gestin o movimiento del grupo de agentes que pertenecen a este grupo.

Offline Setings: permite la configuracin para que cuando el grupo no tenga asesores disponibles o no conectados permita redirigir a una pgina o enviar un correo de gestin

22

Manual Tcnico OpenFire

Transcripts: permite configurar el correo que se le enva al cliente con la constancia del dialogo y la gestin de soporte que se le brindo al cliente externo.

23

Manual Tcnico OpenFire

Form Ui: en esta opcin nos permite configurar el formulario que el cliente externo vera antes de hablar con el asesor, en esta parte se puede configurar como sea ms conveniente para obtener los datos del cliente. Como vemos en el ejemplo tenemos el nombre, email, celular, y un checkbox para que el cliente decida si quiere o no ms informacin, los campos se pueden configurar que sea o no requeridos y que se muestren en lista en formulario o en chekbox, el proceso seria : 1. Add field 2. Save changes

En la parte inferior encontramos detalles de cada campo del formulario.

24

Manual Tcnico OpenFire

Images: es la opcin que nos permite configurar las imgenes bsicas de presentacin de la empresa y de la visualizacin que tiene el cliente externo cuando est abriendo el chat.

Es una pestaa que a pesar de tener la configuracin en ingls es bastante intuitiva.

25

Manual Tcnico OpenFire

Text: en esta opcin nos permite configurar los textos que encontramos en las diferentes pantallas de visualizacin del chat del cliente externo, podemos modificarlas como para un ptimo entendimiento y procesos del chat.

Settings: en esta opcin encontramos una de las principales configuraciones ya que nos permite manipular las sesiones que va a tener cada asesor, tiempos de inactividad, mnimo y mximo de sesiones, para lo anterior se debe tener en cuenta la configuracin de colas por asesor o por grupo. Y al finalizar los cambios se actualiza el grupo.

26

Manual Tcnico OpenFire

IX.

El Plugin de fastpath tambin nos permite obtener una pestaa en donde podemos obtener reportes donde por medio del grupo y la fecha podemos ver que chat se han solucionado y gestionado

Como lo vemos a continuacin despus de filtrar por un grupo entre un rango de fechas no despliega el cliente externo, el asesor, la pregunta, la fecha y nos permite ver la conversacin o borrarla

27

Manual Tcnico OpenFire

2. Web chat: est especialmente configurado para funcionar tanto como un Plug-in de servidor y archivos de aplicacin web estndar que se puede implementar en cualquier servidor de aplicaciones (Tomcat, Resin, WebLogic, y as sucesivamente). En la mayora de los casos, se implementa la aplicacin de Web chat en un servidor de aplicaciones independiente para una implementacin de produccin. Para ello, se puede descargar el Plug-in de la pgina oficial el archivo con el nombre de (webchat.war) que se encuentra en la siguiente URL http://www.igniterealtime.org/projects/openfire/plugins.jsp

Se despliega en los webapps de su servidor de aplicaciones, inicia el servidor y vaya a un enlace como el siguiente: http:// <hostname>: <nmero_puerto> / webchat Al comienzo del proceso de instalacin, siga las instrucciones en pantalla.

28

Manual Tcnico OpenFire

Nota: Asegrese de que el nombre del servidor Webchat es el nombre del servidor Openfire. Usted puede encontrar el nombre en la consola de administracin del Servidor de Openfire y luego en la Configuracin del servidor. Si queremos obtener el web chat (webchat.war) modificado para nuestra empresa lo podemos encontrar en la siguiente direccin del repositorio de desarrollo svn://172.22.1.60:3690/telmex_corporativo/trunk/webchat

CONCLUCIONES
Se debe tener instalado y configurado el Plug-in (fastpath.jar) en el servidor de Openfire. Se debe tener instalado el en aplicativo web (webchat.war) en un contenedor web en nuestro caso es en glasfish 3.1. para que el chat este completo y funcionando se deben tener las dos partes instaladas e iniciadas ya que una complementa la otra. El web chat debe poder acceder al servidor de Openfire mediante el puerto 5222.

29