1. manual tecnico

Manual Técnico OpenFire

COLOMBIA

Aplicación OpenFireInstalación, configuración y administración

1.1.1.1.1.1.1.1.1 Versión 1

Este documento contiene secretos del negocio e información de propiedad de Claro Colombia. No está permitido ningún tipo de utilización de la información contenida aquí sin previo consentimiento escrito

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

1


Control de Revisiones

Versión Realizada porDescripción de la

revisión

Fecha de Terminació

n

1.0Edwin Pineda

AlvaranCreación Julio 2013.

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

2


MENU INDICE

Generalidades ………………………………………………………………………………………………..

Instalación de Openfire…………………………………………………………………………………….

Activando openfire ……………………………………………………………………………….

Completando El Proceso De Instalación Del Servidor Openfire ………………….

Administración de openfire ……………………………………………………………………………..

Autenticación a la consola de administración del Openfire ……………………….

REQUISITOS …………………………………………………………………………………………………

Instalación de Plugin faspath …………………………………………………………………………..

Conclusiones ………………………………………………………………………………………………….

3


GENERALIDADES

OpenFire (anteriormente llamado WILDFIRE y JIVE Messenger) es un sistema de mensajería instantánea 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 además contiene plugins gratuitos con diferentes funciones extras.

La administración del servidor se hace a través 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 configuración del servidor, agregar y borrar usuarios, crear cuartos de conferencia permanentes, grupos, etc.

Características:#

Openfire implementa las siguientes características:

1. Panel de administración web2. Interfaz para agregar plugins3. SSL/TLS4. Amigable5. Adaptable según las necesidades6. Conferencias7. Interacción con MSN, Google Talk, Yahoo messenger, AIM, ICQ8. Estadísticas del Servidor, mensajes, paquetes, etc.

4

http://www.linuxparatodos.net/web/comunidad/base-de-conocimiento/-/wiki/Base+de+Conocimiento/OpenFire#section-OpenFire-Caracteristicas


9. Clúster con múltiples servidores10.Transferencia de Archivos11.Compresión de datos12.Tarjetas personales con Avatar13.Mensajes offline14.Favoritos15.Autenticación vía Certificados, Kerbeos, LDAP, PAM y Radius16.Almacenamiento en Active Directory, LDAP, MS SQL, MySQL, Oracle y

PostgreSQL17.SASL: ANONYMOUS, DIGEST-MD5 y Plain

La aplicación 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 ocasión se instalara en Linux ya que es donde estará el ambiente de producción para la empresa.

1. El primer paso para la implementación de un servidor Openfire será descargar el paquete que contiene dicha aplicación, para ello tendremos que dirigirnos al siguiente portal web, que es la página oficial y la versión 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 botón “Linux”Posteriormente nos desplegara un menú que nos mostrara cuatro versiones de Openfire, en este caso seleccionaremos y descargaremos el paquete que fue diseñado para distribuciones Linux basadas en Redhat.O descargar la versión 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.2-1.i386.rpm

2. El siguiente paso será instalar el paquete, para ello haremos uso del comando “rpm”, a continuación veremos un ejemplo de cómo se vería después de ejecutar el comando:

5

http://www.igniterealtime.org/projects/openfire/index.jsp


[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:

Una cuenta de usuario:Esta cuenta de usuario será la asignada al administrador del servidor de mensajería Openfire.

Un password para la cuenta de usuario:

Sera el password asignado a la cuenta del administrador del servidor de mensajería Openfire.

Una base de Datos:Base de Datos en la cual serán dados de alta los usuarios de este servidor de mensajería y gestionadas por el administrador del servidor Openfire.

5. Una vez leído 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 continuación:

[root@localhost]# mysql -u root -p

Enter password: nos pedirá teclear la contraseña de root de MySQL.

6. Lo siguiente será dar de alta la base de datos para el servidor de mensajería Openfire.

Mysql> CREATE DATABASE openfire;

Query OK, 1 row affected (0.00 sec)

7. Después diríjase al siguiente directorio

6


[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 continuación:

[root@localhost]# cat openfire_mysql.sql | mysql -u root -p openfire

Enter password: nos pedirá teclear la contraseña 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 ejecución sobre la base de datos que antes creamos, esto se consigue de la siguiente manera.

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 mensajería 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 mensajería Openfire. Estas opciones pueden ser consultadas en la siguiente tabla:

Start Inicia el servicio

Stop Detiene el servicio

Restart

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

ReloadRecarga el servicio.-La diferencia con restart radica en que al ejecutar un reload este solamente carga las actualizaciones hechas al fichero de configuración del servicio sin necesidad de matar los procesos relacionados con el mismo, por lo que podría entenderse que hace el cambio en caliente.

7


status Da a conocer el estado en el que se encuentra el servicio

Como alternativa también podemos ocupar el siguiente comando para iniciar el servidor de mensajería 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.

Completando El Proceso De Instalación Del Servidor Openfire

11.Para completar el proceso de instalación del servidor de mensajería Openfire primero deberán estar levantados los servicios de apache, MySQL así como el Openfire, así que si alguno de estos está apagado no podrá visualizar la interfaz gráfica del servidor Openfire.

Una vez que nos hemos asegurado que estos servicios están levantados, solo tendremos que abrir un navegador y teclear en la parte superior, la URL de la dirección 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 “Español” en que y Damos clic al botón “Continúe”.

8


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 elección de los puertos 9090 y 9091 son los puertos por los cuales podremos acceder en futuras sesiones para fines de gestión y administración del servidor, a menos que usted quiera cambiar estos puertos, se recomienda dejarlos como están:

13. El siguiente paso será configurar la fuente de datos, de las cuales elegiremos la “Conexión Estándar” y luego de ello , dar clic en el botón “Continuar” Posteriormente en la sección “Driver Predefinido” seleccionaremos el driver de MySQL esto es porque nosotros configuramos el servidor con MySQL, en caso de haber sido PosgreSQL se tendría que haber elegido el driver de PosgreSQL, el campo “Clase del Driver JDBC” será generado automáticamente después de haber seleccionado el driver de MySQL.

9


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 también agregar el nombre de la base de datos que creamos previamente en el campo (database-name),la cual tiene por nombre Openfire.

Una vez terminado, debiera quedar así:

dbc:mysql://localhost:3306/openfire

Por último, solo deberá teclear el nombre de usuario y la contraseña de la base de datos generada anteriormente. El login de usuario es “root” e igualmente tendrá que teclear la contraseña que usted le asignó a “root”

10


14. Damos clic en el botón “Siguiente”. El siguiente paso será elegir en la sección “Seteos de Perfil” la opción “Por defecto” nos permite crear manualmente los usuarios y es un proceso intuitivo y fácil pero para nuestra configuración necesitamos configurarlo con el directorio activo de DataCenter y elegiremos “Directory Server (LDAP)” posteriormente dar clic en siguiente:

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

11


NOTA: esto en caso de que sea un open LDAP pero para nosotros sería un directorio activo de Windows y la configuración estaría en la siguiente tabla:

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 actúa como administrador de Openfire, este debe ser un usuario valido que se encuentre en el árbol LDAP, en este caso el Administrador del Openfire.

12

http://3.bp.blogspot.com/-3BQqi8chLVI/TaaIBHg6QfI/AAAAAAAAAMg/doZHrpSJ-Ow/s1600/7.png

http://2.bp.blogspot.com/-fyUHsXpUI8E/TaaHeDB1nxI/AAAAAAAAAMY/Ei78KII6wnA/s1600/8.png


18. Finalmente nos conectamos a la consola de administración.

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.

ADMINISTRACION DE OPENFIRE

Autenticación a la consola de administración del Openfire

La gestión de acceso a la consola de administración de Openfire debe estar controlada solo por el administrador o administradores del Openfire. La cual se encuentra en la siguiente dirección IP.

172.22.104.130 : 9090

Nos conectamos con la cuenta administrativa y su contraseña, en este caso Admin. Damos clic al botón Login.

13

http://3.bp.blogspot.com/-cN5NdlIfUt0/TaaGzdgVmTI/AAAAAAAAAMQ/fFoa5axK1Fg/s1600/9.png

http://3.bp.blogspot.com/-f3KmF3ZYoPU/Ub4FAaNG2yI/AAAAAAAAIX4/0rlVVlPca7Q/s1600/drivemeca-instalando-jabber-openfire-server(8).PNG


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.

La siguiente imagen es la del actual servidor de producción:

14

http://2.bp.blogspot.com/-OsFoip8QRuw/Ub4FB2XYm6I/AAAAAAAAIYI/7A09bw3VUgc/s1600/drivemeca-instalando-jabber-openfire-server(9).PNG


2. Activamos zona horaria. Damos clic al botón Save Settings.

3. Activamos cambios en la parte de seguridad de cuentas de usuarios deshabilitando creación libre de cuentas y cambios de contraseñas. Damos clic al botón Server Settings y Registration & Login, hacemos los cambios y damos clic al botón Save settings.

15

http://3.bp.blogspot.com/-k0GVnQBVPto/Ub4E65FGJ0I/AAAAAAAAIWQ/j-0inyHLjuU/s1600/drivemeca-instalando-jabber-openfire-server(10).PNG

http://2.bp.blogspot.com/-cJni0rk6nEc/Ub4E7dGORWI/AAAAAAAAIWc/bqiZeEiETEo/s1600/drivemeca-instalando-jabber-openfire-server(11).PNG


4. Activamos cambios en la parte de configuración de correo porque de lo contrario no se podrán enviar transcripciones de chat a los clientes o usuarios externos del chat.

16


REQUISITOS

Los requisitos para la ejecución de forma correcta de la aplicación oTrack son:

Tener instalado Java (JRE) en una versión 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 gestión de bases de

datos relacional Apache Tomcat, contenedor de aplicaciones web. GlassFish servidor de aplicaciones de software libre en la versión

minimo 3.1 o superior

17


INSTALACION DE PLUGIN FASPATH

Plugin de web chat o Fastpath:Web chat es parte del producto de Openfire es un complemento que permite una vía de acceso rápida para clientes externos a nuestro servidor de mensajería. Proporciona una forma fácil para que los usuarios externos hablen con agentes de soporte utilizando el chat.

Instalación

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 direcciónhttp://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 administración.

18

http://www.igniterealtime.org/projects/openfire/plugins.jsp


III. Después se debe ir a la pestaña de Plugings y se sube el archivo descargado del Plugin fastpath con el nombre de (fastpath.jar) como se muestra a continuación:

IV. El Plugin automáticamente se adaptara y estará totalmente instalado cuando aparezca la pestaña de Fastpath como se ve a continuación

V. Después de instalado se puede ingresar a la pestaña para la configuración de los grupos de chat para los clientes externos, las configuraciones tienen la opción de administrar y gestionar las colas de chat, los usuarios, operadores pertenecientes a cada grupo, imágenes que visualiza el cliente externo, textos de bienvenida y de información del proceso de chat, configuración de transcripción de chat, entre otras opciones.

19


Nota ten en cuenta que el Plugin no funciona si el web chat no está instalado y configurado, lo cual se detalla más delante de este manual.A continuación vemos las opciones que se tiene en la pestaña de fastpath:

VI. Vamos a crear nuestro primer grupo y a ver las opciones que nos permite damos clic en el botón “créate workgroup”

20


VII. Nos aparecerá un formulario lo rellenamos como se ve a continuación:Workgroup Name: es el nombre del grupo que visualizara el cliente externoMembers: 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 descripción general del grupo

VIII. Después de creado el grupo nos desplegara un menú al lado izquierdo de la consola de administración donde encontraremos diferentes opciones de configuración del grupo.

21


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

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

Offline Setings: permite la configuración para que cuando el grupo no tenga asesores disponibles o no conectados permita redirigir a una página o enviar un correo de gestión

22


Transcripts: permite configurar el correo que se le envía al cliente con la constancia del dialogo y la gestión de soporte que se le brindo al cliente externo.

23


Form Ui: en esta opción nos permite configurar el formulario que el cliente externo vera antes de hablar con el asesor, en esta parte se puede configurar como sea más 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 más información, 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


Images: es la opción que nos permite configurar las imágenes básicas de presentación de la empresa y de la visualización que tiene el cliente externo cuando está abriendo el chat.

Es una pestaña que a pesar de tener la configuración en inglés es bastante intuitiva.

25


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

Settings: en esta opción encontramos una de las principales configuraciones ya que nos permite manipular las sesiones que va a tener cada asesor, tiempos de inactividad, mínimo y máximo de sesiones, para lo anterior se debe tener en cuenta la configuración de colas por asesor o por grupo. Y al finalizar los cambios se actualiza el grupo.

26


IX. El Plugin de fastpath también nos permite obtener una pestaña 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 continuación después 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 conversación o borrarla

27


2. Web chat: está especialmente configurado para funcionar tanto como un Plug-in de servidor y archivos de aplicación web estándar que se puede implementar en cualquier servidor de aplicaciones (Tomcat, Resin, WebLogic, y así sucesivamente).

En la mayoría de los casos, se implementa la aplicación de Web chat en un servidor de aplicaciones independiente para una implementación de producción.

Para ello, se puede descargar el Plug-in de la página oficial el archivo con el nombre de (webchat.war) que se encuentra en la siguiente URL http://www.igniterealtime.org/projects/openfire/plugins.jsp

28

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>: <número_puerto> / webchatAl comienzo del proceso de instalación, siga las instrucciones en pantalla.

Nota: Asegúrese de que el nombre del servidor Webchat es el nombre del servidor Openfire. Usted puede encontrar el nombre en la consola de administración del Servidor de Openfire y luego en la Configuración del servidor.

Si queremos obtener el web chat (webchat.war) modificado para nuestra empresa lo podemos encontrar en la siguiente dirección 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.

29


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.

30

1. manual tecnico

Documents