P. 1
HIPERGATE

HIPERGATE

|Views: 213|Likes:
Publicado porjoseluisblanco69

More info:

Published by: joseluisblanco69 on Aug 02, 2012
Copyright:Attribution Non-commercial

Availability:

Read on Scribd mobile: iPhone, iPad and Android.
download as DOC, PDF, TXT or read online from Scribd
See more
See less

01/24/2015

pdf

text

original

HIPERGATE TABLA DE CONTENIDO

1. Que es Hipergate.
a. Que hace Hipergate único. 2. Modulos Funcionales.

a. Modulos Funcionales Incluidos en el Producto Estándar.
b. Funcionalidades Comunes para todos los Modulos.

3. Ventajas y Beneficios. 4. Diseño y Tecnología. a. Requisitos y Prioridades del Diseño. b. Lenguajes, Componentes y Plataformas Utilizados.
c. Estructura interna. d. Servidor sin Estados.

e. Separación de Datos por Clientes y Departamentos.
f. Modelos de Seguridad.

5. Manual de Instalación para la versión 4.0. a. Para los Impacientes. b. Planificar la Instalación. c. Requisitos. d. Contenido del paquete de Distribución. e. Instalar y Configurar un Sitio Web de ejemplo. f. Instalar las Librerías.

g. Crear la Base de Datos. h. Ejecutar el Asistente de Configuración. i. j. Configuración de Seguridad y Áreas de Trabajo. Pruebas de Conexión de Acceso.

k. Configuración de Servlets. l. Usos de Múltiples instancias de Hipergate en el mismo Servidor.

m. Incompatibilidades desconocidas. n. Descargas Adicionales. o. Herramientas de Administración. p. Instalación sobre JBoss. q. Apéndice 1: Propiedades de Hipergate.cnf. r. Apéndice 2: Carga Manual de la Base de Datos.

s. Apéndice 3: Configuración de Granjas de Servidores. t. Apéndice 4: Librerías de Terceros.

u. Apéndice 5: Librerías de Depuración. v. Apéndice 6: Notas para Recompilara los Fuentes. w. Como actualizarse de la versión 3.0 a la 4.0 x. Diagnostico de Problemas.

1. Que es Hipergate:
hipergate es una suite de aplicaciones de código abierto basadas en web. El propósito del conjunto de programas es cubrir un amplio rango de necesidades de tecnología de información en cualquier organización. Todas las aplicaciones se acceden desde Internet Explorer sin necesidad de descargar ningún software en el puesto cliente. La suite tiene capacidad multi-entidad y puede utilizarse indistintamente para dar servicio a una empresa, a un grupo de empresas, o en modalidad ASP para alojar un número ilimitado de entidades cliente diferente.

a. Que hace Hipergate Único:

• • • • • • • •

Es completamente gratuito. Es la única aplicación Open Source con una cobertura funcional tan amplia. Funciona sobre múltiples bases de datos y sistemas operativos. Tiene un diseño conceptual e implementación unitarios. Es apropiado para su uso en modalidad ASP. Es multi-idioma. Dispone de una red de servicios profesionales de soporte. Está bien documentado.

2. Módulos Funcionales:
a. Módulos funcionales incluidos en el producto estándar

Modulo de Herramientas Colaborativas y Trabajo en Grupo
• • • • •
Calendario y Agenda de Reuniones Compartida. Foros Libres y Moderados con múltiples grupos. Área de Preguntas Frecuentes. Directorio de Personal Listado y Reserva de Salas y otros Recursos Compartidos

Modulo de Gestión de Contactos
• • • • • • • •
BB.DD. de Clientes, Proveedores, Competidores y Partners. BB.DD. de contactos personales Múltiples Direcciones por Contacto. Gestión de Demarcaciones Territoriales (Delegaciones) Gestión del Pipeline de Ventas (Oportunidades Comerciales) Listas de Distribución de diversos tipos. Carga Directa de Windows Address Book (Outlook Express) Carga Directa de ficheros de Contactos.

Modulo de Gestión de Proyectos y Soporte a Incidencias
• • • •
Árbol Jerárquico de Proyectos. Seguimiento de Tareas Pendientes. Control de Averías e Incidencias. Contratos de Mantenimiento con Clientes.

Modulo de Tienda Virtual
• • • • • • • • •
Múltiples Catálogos Independientes. Jerarquía ilimitada de Categorías de Productos. Atributos Variables por Producto. Gestión de Stock en múltiples almacenes. Gestión de Pedidos. Gestión de Facturación. TPV Banesto. TPV Banco Popular. TPV BBVA.

Modulo de Producción de Contenidos
• • • • • • •
Plantillas para comunicación vía e-mail. Plantillas para websites. Formularios electrónicos. Plantillas para fax. Inclusión de contenidos multimedia. Gestión categorizada de contenidos. Librería de portlets para la presentación de contenidos dinámicos.

Roles predefinidos listos para utilizar en las aplicaciones. Informes y Consultas • • • • Herramienta de Consulta Guiada por Formulario. Estadísticas de recepción de mensajes. Seguridad a nivel de empresa y a nivel de departamento. b. Ejecutor multi-hilo en segundo plano.Modulo de Envío Masivo de Correos Electrónicos • • Gestión de envíos múltiples de e-mails a listas de distribución. Importar/Exportar favoritos al PC cliente. Categorización de objetos. Integración con LDAP. Ventajas y Beneficios del Producto hipergate es software de última generación. Biblioteca Corporativa • • • • • Disco Virtual 100% basado en Web. Número ilimitado de usuarios y grupos de permisos. Enlaces Favoritos compartidos. 3. Volcados a Excel. Gestión de datos jerárquicos • • • Tesauro geográfico. Planificador de Tareas • • Gestión de colas de procesos. El CRM Java Libre más completo . Seguridad por usuario basada en roles para los archivos. Funcionalidades Comunes para todos los módulos Seguridad basada en roles • • • • • Múltiples dominios independientes de seguridad. Informes remitidos por e-mail. programado y testeado con las herramientas y técnicas más modernas. diseñado. Consultas online en formato HTML. Tesauro lexicográfico. Gestión e Indexación de propiedades de documentos OLE.

El interface con el usuario está diseñado para ser homogéneo y de esta forma de fácil y rápido aprendizaje. Solución Integral hipergate está concebido y pensado tanto en profesionales independientes como en empresas. usuario e invitado. La suite está orientada a facilitar el trabajo diario. de manera que puedan derivar todos sus procesos informáticos hacia la plataforma. Auto-administrable por el usuario final hipergate suministra un modelo de administración predefinido basado en 4 perfiles de usuario: administrador. superusuario. Una vez realizado el pago el usuario puede empezar a trabajar con las aplicaciones contratadas. Integración con Office hipergate reconoce e indexa documentos Office. . El usuario puede en cualquier momento contratar el uso de las aplicaciones hipergate mediante pago a través de Internet aunque también se dan opciones de otras formas de pago. empresa o departamento. Las aplicaciones pueden activarse o desactivarse en caliente de forma particular para cada cliente.Ningúte otro producto libre sobre plataforma Java ofrece un conjunto de funcionalidades tan amplio como hipergate. Aplicaciones independientes pero sinérgicas Cada aplicación de la suite puede funcionar de forma independiente o junto con las otras aplicaciones. Diseño y Tecnología: a. a los que se asocia unas operaciones que pueden hacer sobre su información de forma muy parecida a como funciona el sistema operativo. SQL Server. Soporte en todas las plataformas y bases de datos comunes hipergate funciona indistintamente sobre Linux o Windows. Las facilidades de auto-administración sirven dos propósitos: 1º) reducir el coste de propiedad de la aplicación en el cliente y 2º) reducir el coste de mantenimiento si la plataforma se ofrece en modalidad ASP. El administrador de la instancia concreta. Entorno intuitivo y fácil de manejar Cada aplicación es fácilmente accesible desde un menú principal de pestañas. Esto hace que el usuario final pueda contratar las aplicaciones que realmente necesita sin tener que comprar toda la solución como sucede con los paquetes de software actuales. y sobre Oracle. PostgreSQL o MySQL. 4. Se fijaron una serie de requisitos y prioridades que el producto debía cumplir estrictamente. Registro rápido y a trabajar Al usuario se le da opción de que pruebe la herramienta durante un periodo de tiempo. permite cargar y exportar datos a Outlook Express y generar consultas en formato Excel. creando así una base de usuarios que utilicen el software constantemente. Requisitos y Prioridades de Diseño hipergate fue diseñado desde el principio como una suite orientada a dar un servicio de alta calidad a los clientes más exigentes.

según se configure explota las llamadas atómicas de cada sistema operativo para obtener el mejor rendimiento. En este apartado se prefirió la expansión horizontal del producto por múltiples módulos antes que fabricar unas pocas aplicaciones específicas de alta complejidad. La filosofía del producto es que las empresas pequeñas y medianas obtengan prácticamente todas las funcionalidades necesarias para cada departamento y que las grandes dispongan de una base sólida para desarrollar extensiones propietarias. la aplicación funciona sin sesiones ni estados mantenidos en el lado servidor. modelo conceptual sencillo. Tolerancia a Fallos La aplicación puede configurarse para funcionar en clustering tanto con los servidores web como con la base de datos. fácil acceso a todas las funcionalidades. El modelo de objetos que aísla el modelo físico de la base de datos del modelo de la lógica de negocio proporciona un marco natural para hacer ampliaciones con una curva de aprendizaje . Escalabilidad Durante todo el ciclo de desarrollo no se quiso sacrificar en ningún momento el rendimiento por la transportabilidad o la ampliación funcional del producto. La aplicación está diseñada en 3 capas: servidor web. completitud en la gama de operaciones disponibles. Cada nuevo módulo es meticulosamente testeado en sucesivos walkthroughts de código. Esto se consigue mediante: • • • • • arquitectura de información homogénea a través de todos los módulos. Unix y Win32. El diseño hace énfasis en la capacidad para crear granjas y repartir la carga entre múltiples servidores. El código está optimizado para hacer uso de las funcionalidades específicas de cada base de datos y plataforma sobre los que puede ejecutarse.Ergonomía y Usabilidad La primera prioridad del producto es que cada parte proporcione una buena experiencia de usuario. Una parte de la lógica de proceso emplea procedimientos almacenados PL/SQL. Estabilidad La suite es un producto pensado para tener disponibilidad 24x7. la suite incorpora un sofisticado sistema propietario de cache distribuido con la misión de mantener información local en los servidores web y reducir la sobrecarga de los nodos de la base de datos. Alcance Funcional La suite está pensada para cubrir el 80% de las necesidades más típicas de cada módulo funcional. tiempos de respuesta rápidos para todas las operaciones. Mantenibilidad La estructura del código se diseñó pensando en que resultase sencillo de mantener y de ampliar por programadores sin conocimientos profundos de los detalles del sistema. pruebas de caja negra y pruebas de stress en condiciones críticas. Por último. PL/pgSQL o Transact-SQL reescritos manualmente para aprovechar al máximo las opciones más avanzadas de cada SGBDR. y. servidor de aplicación y servidor de base de datos. Para reducir el consumo de memoria y aumentar la capacidad de servicio de cada servidor web. El código Java dispone de 3 modos de ejecución: 100% Java Puro.

ya están resueltas de forma estándar en componentes reutilizables. es el uso racional de la CPU y el disco que se consideran recursos escasos.1.5.8 Xerces2 XML Java Parser 2.1.2 JavaMailTM 1. Muchas de las tareas rutinarias de codificación: generación de formularios.2 Xalan XSLT Processor 2. validación de datos. Separación de datos entre clientes hipergate comparte información de varios clientes en una misma base de datos para evitar una proliferación insostenible de bases de datos.2 JavaTM Advanced Imaging 1.4 y Tomcat 5. La versión 1. La máquina que aloje el servidor web debe ser Linux. No obstante.5. gestión de fechas.3 Jakarta POI 2.2. El software puede correr en cualquier versión de la máquina virtual desde la 1.6.27 con Java 1.0.8 a la 1. Además se aboga por el uso exclusivo de plataformas con respaldo explícito para su continuidad de las grandes empresas del sector.6.2 Componentes utilizados bajo licencia de SUN Microsystems Inc. Simplicidad A pesar de su amplio alcance técnico y funcional. la información de cada cliente puede extraerse limpiamente en cualquier momento de la base de datos compartida para hacer una copia de respaldo exclusiva del cliente o para instalarse en una instancia de base de datos dedicada. tablas de remonte. AIX o Windows 2000.5 Jakarta ORO 2.2 .1. Lenguajes. como requisito imprescindible para poder dar servicio ASP. etc. • • • JavaBeansTM Activation Framework 1. Componentes utilizados bajo licencias Open Source • • • • • • Jakarta Bean Scripting Framework 2. Tomcat 4.0. Otro factor.2 Enterprise DT Ltd Java FTP Library 1.5 con Java 1.3.1a con Java 1. Tecnología Estándar Sólo se emplean componentes y tecnologías de uso muy común en el mercado. b.1. Solaris. BSD.3.suave. la suite está diseñada y codificada para ser muy simple parte por parte. Componentes y Plataformas Utilizados Java y Tomcat Todos los módulos de hipergate están escritos en 100% Java Puro.0 de hipergate ha sido testeada sobre Tomcat 3. Economía La aplicación puede funcionar basada 100% en software libre con el propósito de eliminar casi por completo los costes de licencias.

Servidor sin estados hipergate no utiliza sesisones ni estados mantenidos en el servidor. con los objetivos de: 1. Realizar el máximo de validaciones y procesamiento en cliente para reducir el tráfico entre el navegador y el servidor web.3.0. Proporcionar un API para todos los objetos de la aplicación. Capa 4: Scripts Java BeanShell. Estas cookies sólo contienen un mínimo de información: • dominio de seguridad al que se está conectado . c.4 Servidor de Aplicaciones El la persistencia objetos en base de datos. 7.0 (opcional) DipuTree Java tree applet 3. 2. 5.0 (opcional) Sistemas Gestores de Base de Datos Relacional Soportados • • • Oracle 9i. d. puede ejecutarse dentro de Tomcat o de forma separada sobre JBoss. Separar la capa de presentación de la persistencia de objetos. Reducir el número de llamadas a la base de datos en aquellas operaciones que puedan ejecutarse de forma atómica dentro del gestor de base de datos. Utilizar el máximo de código compilado y optimizado para el núcleo de librerías del sistema. 6. Externalizar la lógica de negocio en scripts de servidor que no requieran ser recompilados para ejecutarse. Estructura Interna Diseño multi-capa El código de hipergate está dividido en 5 capas: • • • • • Capa 1: Código JavaScript ejecutado por el navegador cliente.Otros Componentes • • Infomentum AppletFile 3. Esto es una medida destinada a reducir el consumo de memoria y aumentar la escalabilidad en el servidor web. Esta división persigue alcanzar el mejor grado de escalabilidad y extensibilidad de la aplicación. Toda la información se mantiene mediante cookies de sesión almacenadas en el cliente. 3. el módulo de cache distribuido y el planificador de tareas pueden instalarse separados del servidor web sobre JBoss 3. Capa 2: Páginas JSP servidas por el servlet runner (Tomcat) Capa 3: Modelo abstracto de objetos Java. 10g Microsoft SQL Server 2000 PostgreSQL 7. Capa 5: Procedimientos almacenados en el SGBDR. 4.

Este vendedor podría crear nuevas fichas de clientes o generar oportunidades comerciales en el área de trabajo de ventas. el Dominio de hipergate es la unidad de mayor nivel de división de datos. un vendedor podría ser usuario del área de trabajo del departamento de ventas. consiguiendo que las personas de un departamento tengan acceso a un conjunto de datos y aplicaciones diferente de los de otro departamento. Las áreas de trabajo suelen representar departamentos funcionales en las entidades cliente.• • • área de trabajo a la que se está conectado identificador único de del usuario conectado token de acceso de sesión encriptado Como no hay sesiones. la división de datos y permisos de acceso puede llegar a nivel departamental. incluso. f. yendo un paso más lejos. Toda la información de estado se transfiere de una página a otra mediante métodos GET o POST de HTTP. La ventaja de este enfoque es que permite separar fácil y limpiamente los datos de cada cliente El inconveniente es que se genera una proliferación de bases de datos clónicas prácticamente imposibles de mantener a partir de cierto volumen de instancias. pero su nivel de privilegio en el área de trabajo de soporte sólo le permitiría ver las incidencias abiertas pendientes de resolución. El uso principal de los dominio es establecer los límites de asignación de permisos para cada administrador. puede crear nuevos usuarios o activar y desactivar aplicaciones dentro de su dominio. no existe el concepto de identificador de la sesión actual. incluso aunque dicha información se encontrase previamente almacenada en una base de datos compartida. Por ejemplo. al mismo tiempo invitado del área de trabajo del departamento de soporte técnico. Un controlador de cache se encarga de mantener la coherencia de los datos en instalación con múltiples servidores web funcionando de forma concurrente contra la misma base de datos. aunque otro uso común es usarlo como contenedor de usuarios individuales no adscritos a ninguna entidad (por ejemplo. En hipergate se ha seguido una aproximación híbrida al problema de la separación de datos: una única base de datos puede contener información de múltiples entidades cliente sin solapamientos. y. pero no puede ver ni alterar los datos de otras entidades clientes en dominios diferentes. Las áreas de trabajo forman los compartimentos estancos de información. para mantener el requisito indispensable de la separación de datos por cliente. Áreas de Trabajo Cada Dominio puede contener una o más Áreas de Trabajo. las utilidades de administración disponen de subrutinas para cortar y separar la información de un cliente en una base de datos aislada de uso exclusivo. e. profesionales independientes que contratan una cuenta de uso personal). Sin embargo. Esto reduce el tráfico de red y aligera la carga sobre la base de datos. Separación de datos por clientes y departamentos Muchas aplicaciones que funcionan en modalidad ASP lo hacen replicando automáticamente un modelo de datos para cada una de las instancias cliente. Así el administrador de una entidad cliente. sin posibilidad de modificarlas. Dominios Conceptualmente. Típicamente representa una entidad cliente completa. Modelo de Seguridad . Caches El sistema utiliza un cache distribuido que permite almacenar información de la base de datos de forma local en los servidores web. En un momento dado cada usuario sólo ve la información de aquella área de trabajo a la que está conectado con un rol determinado.

Esto le permitiría crear nuevas fichas de empleados. Existen 3 tipos de cuenta predefinidas: la cuenta corporativa. En este caso se crearía un dominio para la empresa y un área de trabajo para cada delegación. Así. la cuenta profesional y la cuenta de sistema. Dominio Área de Trabajo Un dominio representa un conjunto de usuarios que se administran de forma independiente. Por ejemplo. Cada dominio contiene una o varias áreas de trabajo. Cuenta Una cuenta es lo mismo que un contrato de uso con un cliente final. Las cuentas corporativas permiten un número arbitrario de usuarios y están asociadas a su propio dominio. pero no crear nuevos clientes. superusuario. Se permite crear un número ilimitado de usuarios cada uno con su propio conjunto de roles y clave de acceso. supongamos que la entidad cliente es una empresa con dos delegaciones.hipergate implementa un modelo de seguridad a nivel de sesión basado en roles. Cada dominio tiene uno o más administradores. un usuario podría tener rol de Administrador en el módulo del Directorio de Personal y Rol de Invitado en el módulo de ventas. usuario. cada usuario tiene disponible un subconjunto de todas las aplicaciones y ejerce un rol en cada una de ellas en función de los grupos de permisos a los que pertenezca. Se dispone de cuatro roles predefinidos más un quinto definible por entidad cliente: administrador. Cada usuario pertenece a uno a más grupos. Las cuentas del sistema se usan por los operadores del ISP que proporcionan el servicio como un medio de administrar todos los dominios contratados con clientes. Se desea que la creación y gestión de usuario esté centralizada en Barcelona y que los usuarios de cada sede vean sólo la agenda y el directorio de su localidad. Se pueden añadir o quitar aplicaciones sin afectar al funcionamiento del resto del sistema. Estos roles marcan lo que el usuario puede hacer en cada aplicación. Usuario Rol Grupo Diagrama ilustrativo del modelo de seguridad . El área de trabajo es una entidad que sirve para establecer la visibilidad de conjuntos de datos en la aplicación. Los grupos en si mismos no otorgan roles a los usuarios. En un momento dado. invitado y variable. Es posible definir un número arbitrario de grupos. Es preciso asignar un rol al grupo dentro de una aplicación y área de trabajo para que los usuario adquieran el rol deseado. Las cuentas profesionales representan usuarios individuales que no pueden hacer uso de las funcionalidades de trabajo en equipo de la aplicación. El modelo maneja los siguientes conceptos: Aplicación El producto funciona como un conjunto de aplicaciones interoperables. una en Madrid y otra en Barcelona.

Para que hipergate funcione es necesario haber pre-instalado (al menos) Java 1. básicamente.16 (o superior) o PostgreSQL 8. 7. 4. en una unidad con espacio suficiente. Los directorios /storage y /web/workareas.x.zip en cualquier parte. Las páginas JSP de hipergate. Abrir la página http://servidor:puerto/admin/setup. Copiar todos los archivos del directorio /web o /web al servidor web.0. Descargar y descomprimir hipergate-4.Manual de Instalación para la Versión 4.x-aa. 3. Tomcat) y un gestor de base de datos.xml (se puede hacer más tarde pero hasta que no esté hecho no funcionará el módulo de disco virtual) (Opcional) Si se ha instalado hipergate en un directorio que no es el raíz del dominio utilizado modificar el valor de la variable config. Los . Configurar /WEB-INF/web. que es donde se almacenan los archivos manejados por hipergate que no residen en la base de datos. Un tamaño inicial de 30Mb para la base de datos es más que suficiente para tareas de desarrollo. /storage y /web/workareas son dos directorios que pueden crecer indefinidamente según se suban archivos a la aplicación. Requisitos Sistema Operativo Linux o Windows .x. 5. 2. 1.4.js b. en copiar las páginas JSP y los archivos . Microsoft SQL Server 2005/DE or Oracle 10g/XE o MySQL 5. La diferencia esencial entre /storage y /web es que los archivos de /storage no necesitan ser visibles por HTTP (aunque en la instalación por defecto lo son) mientras que los de /web deben colgar de una URL bajo el servidor web.htm para iniciar el asistente de instalación. de forma que no colisionen con otros ya instalados (por defecto en WEB-INF/lib). Copiar el directorio /storage en cualquier sitio fuera del árbol del servidor web. un contenedor de servlets (ej. Es importante pesar de antemano dónde se ubicarán los siguientes archivos: • • • • La base de datos. Planificar la instalación La instalación de hipergate consiste. Es preciso tener pre-instalado o Java 1.. 6.0 a.. Para los impacientes. c.BaseUrl en el archivo /fckeditor/js/fck_config.jar en el servidor web y lanzar el asistente de web de instalación.0.6 (o superior) o Tomcat 6.jar.

Se puede utilizar BSD pero es imprescindible que la plataforma seleccionada tenga soporte para una máquina virtual de Java 1. Oracle 9 Por defecto.6 de Sun JDK en distintas plataformas.4/8. si se ejecutan ambas aplicaciones en la misma máquina hay que cambiar el puerto para alguna de las dos.Preferentemente Linux (cualquier distro). database: Volcados binarios de la base de datos de ejemplo.ora) y poner la opción: "open_cursors=100" (como mínimo). BEA WebLogic e IBM WebSphere.16. Microsoft SQL Server Es necesario activar el protocolo TCP/IP en el servidor. antes de crear la base de datos hay que abrir el archivo de configuración de la instancia de BB.DD. y ha sido probado en otros servidores como Sun Web Server. Oracle admite un máximo de 50 cursores abiertos por conexión.x. puesto que se utilizan procedimientos almacenados no soportados por esta base de datos. La base de datos debe ser creada con juego de caracteres UNICODE. licencias y referencia del API de hipergate. doc: Documentación adicional. aparecerá el siguiente error mientras se realiza la carga inicial: "[SQLServer 2005 Driver for JDBC][SQLServer]INSERT failed because the following SET options have incorrect settings: 'ARITHABORT'". Existen una serie de requisitos por cada gestor de base de datos utilizado con hipergate: PostgreSQL PostgreSQL debe estar atendiendo peticiones por TCP/IP. JRE 1. Para ello.DD. que deja un cursor preparado por tabla. De lo contrario. Solaris o AIX. funcione. Se puede comprobar si el lenguaje está cargado lanzando la siguiente sentencia SQL: select lanname from pg_language. No existe soporte para MySQL 4.4. web-XX: Juego de páginas JSP con una aplicación de ejemplo. Oracle 9/10g/XE y MySQL 5.x. Oracle XE Oracle XE usa por defecto el mismo puerto de administración que Tomcat.DD. Contenidos del paquete de distribución El paquete de hipergate se distribuye en formato ZIP. Base de datos relacional hipergate soporta de forma nativa PostgreSQL 7. storage: Contenidos de ejemplo del directorio de almacenamiento privado. de lo contrario se producirá el error SQLException 42P01 ERROR: no existe la relación k_x_app_workarea. En algunos casos puede ser necesario configurar el parámetro ARITHABORT de SQL Server para que la carga inicial de BB. con la seguridad integrada en Windows no es suficiente. d. Por consiguiente.0. (initXXXX. Para ello. el 8080. A continuación se presenta un detalle de los contenidos de los directorios web y storage: . Pramati. Para ello usar el programa SQL Server Client Network Utility. Microsoft SQL Server 2000/2005/DE. El lenguaje plpgsql debe estar instalado en la instancia de BB. hay que conectarse a la base de datos master desde SQL Query Analyzer y ejecutar la sentencia: ALTER DATABASE nombre_bbdd SET ARITHABORT ON. Este parámetro es incompatible con el funcionamiento de la instalación. java: Código fuente de la librería de hipergate.0. antes de cargar el juego de datos inicial. También es necesario activar la seguridad nativa de SQL Server. Contenedor de servlets/JSP El desarrollo inicial de hipergate se ha realizado con Apache Tomcat 6. hay que ejecutar la siguiente sentencia utilizando el usuario administrador de la base de datos: createlang plpgsql nombre_bbdd.6 hipergate 4 ha sido probado con la versión 1. y contien los siguientes subdirectorios: • • • • • • bin: Librería estándar de hipergate.

Contenidos del directorio web .

Instalar y configurar un sitio web de ejemplo La primera decisión a tomar es donde se ubicarán las páginas JSP de la aplicación.Contenidos del directorio storage e. Debe tener configurado un motor de servlets/JSP en el servidor.0 .BaseUrl en el archivo /fckeditor/js/fck_config. Tome nota de la configuración y URLs donde instala las JSP. Se recomienda instalar hipergate justo debajo de la raiz del dominio utilizado. puesto que las necesitará más adelante en el Asistente de Instalación.js Instalación sobre Tomcat 6. como: http://localhost:8080/ Si se desea instalar hipergate en un directorio por debajo del raiz. hay que modificar el valor de la variable config.

cnf Los parámetros de conexión a la base de datos para los servlets del paquete com.encoding. Es necesario indicar a Tomcat que debe esperar archivos fuente Unicode estableciendo el parámetro -Dfile. Compruebe la siguiente línea en su archivo $CATALINA_HOME/conf/server.xml: <Connector port="8080" .Puede instalar una copia de Apache Tomcat en el directorio /opt/tomcat/.compiler.jasper.cnf Establece el usuario y contraseña de acceso a la BB. HttpBLOBServlet y HttpQueryServlet) hay que configurar los siguientes parámetros: jdbcDriverClassName jdbcURL Establece el driver de acceso a BB.CoyoteConnector" port="8080" minProcessors="5" maxProcessors="75" enableLookups="true" redirectPort="8443" acceptCount="100" debug="0" connectionTimeout="20000" useURIValidationHack="false" disableUploadTimeout="true" /> <Host name="localhost" debug="0" appBase="$CATALINA_HOME/webapps/hipergate" unpackWARs="true" autoDeploy="true"> <Context path="" docBase="" debug="0" reloadable="true" crossContext="true"> <Logger className="org." suffix=".. Para recoger archivos desde la BB.apache. igual que el parámetro dburl de hipergate.xml instalado.jsp Cannot read file: ze file al arrancar la aplicación.tomcat4. HttpBLOBServlet y HttpQueryServlet) pueden especificarse en el archivo dbUserName/dbUserPassword .apache.cnf Establece la cadena de conexión a la BB.http (HttpBinaryServlet.txt" timestamp="true"/> </Context> </Host> </Engine> </Service> </Server> Archivos con juego de caracteres Unicode Los archivos fuente JSP de hipergate utilizan el juego de caracteres Unicode codificado como UTF-8.logger.DD..CoyoteConnector" Puede crear un nuevo <Context> para hipergate o utilizar uno existente.xml de la siguiente forma: <Server port="8005" shutdown="SHUTDOWN" debug="0"> <Service name="Tomcat-Standalone"> <Connector className="org.DD.encoding=UTF-8 en la variable de entorno CATALINA_OPTS..CompileException: /common/desktop. y configurarla para que escuche peticiones a través de HTTP en el puerto 8080 (configuración por defecto).catalina. Por ejemplo..DD.FileLogger" prefix="hipergate_log. puede copiar toda la rama web del paquete ZIP de hipergate al directorio $CATALINA_HOME/webapps/hipergate y configurar un nuevo <Context> en el archivo server.coyote. es necesario configurar una serie de entradas en el fichero web/WEBINF/web. igual que los parámetros dbuser/dbpassword de hipergate.tomcat4.DD. Para cada unos de los servlets (HttpBinaryServlet.coyote. es posible que se produzca un error del estilo org.apache.apache.. igual que el parámetro driver de hipergate. Servlets hipergate incluye tres servlets para la descarga de archivos desde el directorio privado storage. /> className="org. Si no se especifica el parámetro file.knowgate.

cnf o portal. Puede mover las librerías a shared/lib si tiene problemas para cargarlas desde WEB-INF/lib.CREATE TABLE. Crear una nueva base de datos desde Microsoft SQL Server Management Studio.xml el servlet irá a buscarlos a hipergate. CREATE TRIGGER TO HIPERGATE.CREATE VIEW. Habilitar el soporte de conexiones por TCP/IP. Los parámetros de web. Añadir las librerías al CLASSPATH no es suficiente. 2.xml es prioritaria sobre la de hipergate. Normalmente. Tomcat utiliza el directorio $CATALINA_HOME/shared/lib para los JARs compartidos por todas las aplicaciones web. 3. .cnf y no a otros archivos de configuración como real. no hay necesida de cambiarlas de sitio. Si no se activa la seguridad nativa se obtendrán el error "Not associated with a trusted SQL Server connection" al intentar la conexión con SQL Server. Abrir SQL Query Analyzer.CREATE SYNONYM.CREATE PUBLIC SYNONYM. Si no se encuentran parámetros de conexión en web. Asegurarse de que el servidor está configurado para aceptar autentificación nativa. Usually there is no need to change them to another place. Las librerías JAR se colocan por defecto en el directorio $CATALINA_HOME/webapps/hipergate/WEBINF/lib.cnf. Microsoft SQL Server 2005 1.xml o en el archivo /etc/hipergate.de /WEB-INF/web. no se recomienda para entornos de producción.CREATE PROCEDURE. g. SQL*Worksheet o Server Manager y ejecutar las sentencias: CREATE TABLESPACE HIPERGATE4 DATAFILE 'C:\oraclexe\oradata\XE\hipergate4. conectarse a la BB. La informacion de web.CREATE SEQUENCE. CREATE USER HIPERGATE IDENTIFIED BY HIPERGATE DEFAULT TABLESPACE HIPERGATE4 QUOTA UNLIMITED ON HIPERGATE4 QUOTA 0 ON SYSTEM. compruebe que la URL http://hostname:8080/login.xml pueden dejarse vacíos si se tiene una única instancia de la aplicación corriendo en el mismo servidor.dbf' SIZE 100M.cnf. f.DD.html funciona correctamenente. pero es imprescindible rellenarlos si se tienen varias instancias de la aplicación corriendo en el mismo servidor contra bases de datos diferentes. GRANT CONNECT.DROP PUBLIC SYNONYM. Crear una base de datos vacía Oracle 10g 1. ya que la mayoría de los contenedores de servlets utilizan su propia estructura de directorios y cargadores de clases para buscar las librerías JAR. Instalar las librerías El segundo paso es instalar las páginas y las librerías de hipergate en un directorio donde el motor de servlets pueda referenciarlas. Abrir una conexión a Oracle con SQL*Plus.xml. 4. Por último.cnf de modo que si ambas difieren se tomará como válida la de web. master y ejecutar: ALTER DATABASE hipergate4 SET ARITHABORT ON Notas sobre Microsoft SQL Server Desktop Engine Aunque hipergate puede correr sobre MSDE. Si tiene dudas acerca de cómo crear una aplicación web en su motor de servlets lea una de las siguientes guías de instalación.

x 1. a través de SSH/Telnet.NET es posible utilizar Web Data Administrator. Leer el archivo README incluido en MSDE sobre cómo instalarlo teniendo en cuenta que MSDE no está pensado para ser instalado manualmente por un humano.conf tcpip_socket = true virtual_host = '127.cnf para usar el SAPWD.1 como host y puerto 1433.o si se dispone de IIS y el SDK de . Se necesita el Enterprise Manager Snap-in para Microsoft Management Console.0 1. usando el usuario administrador de la BB. Si no se activa el PL/pgSQL antes de crear el modelo de datos. y crear una nueva BB. # grant usage on language c to knowgate. pero no es gratis. Habiendo instalado todo esto.Instalar las herramientas cliente de SQL Server Standard/Enterprise. He aquí como proceder: • • • Obtener MSDE Release A de http://www.com/sql/msde/downloads/default.BAK distribuido con hipergate a una nueva base de datos. y un usuario: # createdb -E UNICODE hipergate4 # createuser knowgate # grant all on database hipergate4 to knowgate 2. Los últimos dos parámetros habilitan el soporte TCP/IP y la autentificación dual SQL Server+Windows • MSDE no incluye herramientas administrativas.DD.Sin embargo. hacer: # update pq_language set lanpltrusted=true where lanname='c'. CREATE USER knowgate IDENTIFIED BY 'knowgate'.4. Siguiendo las instrucciones de la sección 3.microsoft.0. # createlang plpgsql hipergate4 4.DD. configurar hiperate.0. PostgreSQL 8. . MySQL 5.* TO 'knowgate'@'%' IDENTIFIED BY 'knowgate'.o usar una herramienta de consulta SQL como WinSQL . MSDE es fácil de instalar y puede ser útil para hacer demos en Windows 2000/XP. Configurar PostgreSQL para que atienda peticiones por TCP/IP estableciendo los siguientes parámetros en el archivo postgresql. ejecutar: setup SAPWD="AStrongPassword" INSTANCENAME="InstanceName" TARGETDIR="C:\MyInstanceFolder" DISABLENETWORKPROTOCOLS=1 SECURITYMODE=SQL. SAPWD es la clave de super usuario de la base de datos. el nombre de la instacia podrías ser HGOLTP2D y el directorio destino C:\MSSQL. (postgres). Esta es la forma más fácil de administrar MSDE. Es posible iniciar y parar el servicio MSSQLServer usando el Panel de Control de Windows o "NET STAART/STOP" desde la línea de comandos.o (puramente experimental) quizá exista una utilidad de línea de comando para restaurar el archivo . El PL/pgSQL debe estar activado antes de ejecutar el asistente de instalación o de cargar el modelo de datos manualmente. .DD. Conectar al servidor de BB.0. Conectarse al servidor como root y ejecutar: CREATE DATABASE hipergate4 CHARACTER SET utf8. Activar el lenguaje PL/pgSQL. de modo que es preciso conectarse al servidor de alguna de las siguiente maneras para crear la base de datos vacía: .3 del README. .0. se producirá un error en la función k_sp_authenticate al intentar conectarse por primera vez y será necesario volver a crear el modelo de datos desde cero.asp. 127. Si se encuentran problemas de permisos accediendo al lenguaje c. GRANT ALL PRIVILEGES ON *.1' port = 5432 3.

El sistema de carga de base de datos genera una serie de usuarios y contraseñas por defecto. en minúsculas) Cuenta de usuario ordinario del dominio modelo de la base de datos. en minúsculas) Cuenta de usuario avanzado del dominio modelo de la base de datos.cnf. acceda a http://myserver/admin/test_connect.jsp?profile=hipergate. Se utiliza para generar copias clónicas de los dominios. areas de trabajo y usuarios que pueden acceder a la aplicación a nivel global. Configurar las propiedades del archivo hipergate.com (password model. vez cargada la base de datos.cnf se crea por defecto en el directorio /etc (o C:\WINNT en Windows) pero su ubicación puede cambiarse asignando el nombre del directorio donde se encuentre a la variable de entorno KNOWGATE_PROFILES Tener creado el modelo de datos 2.html. en minúsculas) Cuenta de administrador del dominio modelo de la base de datos. de datos debe conectarse.com (password model. Se recomienda proteger el directorio /admin con autentificación básica del servidor web una vez finalizada la instalación inicial. en minúsculas) . Se utiliza para generar copias clónicas de los dominios. guest@hipergate-model.* ya que esto no otorga el privilegio de SUPER que es requerido durante el proceso de creación inicial del modelo de datos para crear triggers.htm Una vez finalizada su ejecución el asistente de instalación salta automáticamente a la pantalla de inicio de sesión de la aplicación. i. El Asistente de Instalación que se encuentra en http://servidor:puerto/admin/setup. h.Nótese que la base de datos debe estar creada con juego de caracteres UTF-8 y que no es suficiente con hacer un GRANT ALL PRIVILEGES ON knowgate. Tener las librerías (JARs) necesarios en su sitio (por defecto ya lo están en WEB-INF/lib). aparecerá una pantalla con el driver y cadena de conexión JDCB y un mensaje de éxito. Se utiliza para generar copias clónicas de los dominios. administrator@hipergate-system. superuser@hipergate-model. Ejecutar el Asistente de Instalación Para iniciar hipergate básicamente existen tres requisitos: 1. Puede acceder a la aplicación de ejemplo a través de la URL: http://myserver/login.com (password hipergate) Cuenta de administrador del sistema completo de hipergate.com (password model.com (password model. user@hipergate-model. Áreas de Trabajo y Usuarios lea el Manual de Usuario. Gestiona los dominios. j. Pruebas adicionales de conexión y acceso Una la siguiente URL: Si todo funcionó correctamente.cnf para inidicar a la aplicación a qué base 3. aunque se recomienda cambiar su contraseña por defecto. Configuración de Seguridad y Áreas de Trabajo Para crear nuevos Dominio. hipergate tiene dos dominios reservados con 5 usuarios que deben conservarse. Es preciso dar permisos de escritura al usuario que ejecute el servidor web sobre el directorio /tmp o /C:\TEMP o cualquier otro que se designe como directorio temporal en el archivo hipergate. hipergate. administrator@hipergate-model.

Cuenta de usuario invitado del dominio modelo de la base de datos.http. aceptación y producción de cambios en la aplicación. Cada dominio (test. en mayúsculas) [administrator|superuser|user|guest]@hipergate-real. es conveniente revisar el contenido del archivo /WEBINF/web. • • • [administrator|superuser|user|guest]@hipergate-test.http. el proceso de instalación genera tres dominios de pruebas para que los usuarios puedan empezar a trabajar con la aplicación directamente. demo y real) se puede emplear en los procesos de prueba. Configuración de servlets Tras ejecutar el Asistente de Instalación.xml para configurar los parámetros de los servlets del paquete com. en mayúsculas) k.com (password DEMO.knowgate.xml: <servlet> <servlet-name>HttpBinaryServlet</servlet-name> <servlet-class>com.com (password REAL.HttpBinaryServlet</servlet-class> <init-param> <param-name>jdbcDriverClassName</param-name> <param-value></param-value> </init-param> <init-param> <param-name>jdbcURL</param-name> <param-value></param-value> </init-param> <init-param> <param-name>dbUserName</param-name> <param-value></param-value> </init-param> <init-param> <param-name>dbUserPassword</param-name> <param-value></param-value> </init-param> <init-param> <param-name>id_product</param-name> <param-value></param-value> </init-param> <init-param> <param-name>id_location</param-name> <param-value></param-value> </init-param> <init-param> <param-name>id_category</param-name> <param-value></param-value> </init-param> <init-param> <param-name>id_user</param-name> . Para ello agregar las siguientes líneas al archivo web. Se utiliza para generar copias clónicas de los dominios. Este usuario no tiene permisos de escritura en la aplicación. en mayúsculas) [administrator|superuser|user|guest]@hipergate-demo. Adicionalmente.com (password TEST. Deben estar creados los servlets: HttpBinaryServlet. HttpBlobServlet y HttpQueryServlet.knowgate.

knowgate.http.<param-value></param-value> </init-param> </servlet> <servlet> <servlet-name>HttpBLOBServlet</servlet-name> <servlet-class>com.HttpBLOBServlet</servlet-class> <init-param> <param-name>jdbcDriverClassName</param-name> <param-value></param-value> </init-param> <init-param> <param-name>jdbcURL</param-name> <param-value></param-value> </init-param> <init-param> <param-name>dbUserName</param-name> <param-value></param-value> </init-param> <init-param> <param-name>dbUserPassword</param-name> <param-value></param-value> </init-param> <init-param> <param-name>nm_table</param-name> <param-value></param-value> </init-param> <init-param> <param-name>nm_field</param-name> <param-value></param-value> </init-param> <init-param> <param-name>pk_field</param-name> <param-value></param-value> </init-param> <init-param> <param-name>pk_value</param-name> <param-value></param-value> </init-param> <init-param> <param-name>bin_field</param-name> <param-value></param-value> </init-param> </servlet> <servlet> <servlet-name>HttpQueryServlet</servlet-name> <servlet-class>com.http.HttpQueryServlet</servlet-class> <init-param> <param-name>jdbcDriverClassName</param-name> <param-value></param-value> </init-param> <init-param> <param-name>jdbcURL</param-name> <param-value></param-value> </init-param> <init-param> <param-name>dbUserName</param-name> <param-value></param-value> .knowgate.

SQLServerDriver} URL de acceso a la base de datos (igual que la propiedad dburl del archivo cnf correspondiente) Usuario de base de datos (igual que la propiedad dbuser del archivo cnf correspondiente) Clave del Usuario (igual que la propiedad dbpassword del archivo cnf correspondiente) jdbcDriverClassName oracle.jdbc.</init-param> <init-param> <param-name>dbUserPassword</param-name> <param-value></param-value> </init-param> <init-param> <param-name>queryspec</param-name> <param-value></param-value> </init-param> <init-param> <param-name>columnlist</param-name> <param-value>*</param-value> </init-param> <init-param> <param-name>where</param-name> <param-value></param-value> </init-param> <init-param> <param-name>orderby</param-name> <param-value></param-value> </init-param> <init-param> <param-name>showas</param-name> <param-value>XLS</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>HttpBinaryServlet</servlet-name> <url-pattern>/servlet/HttpBinaryServlet</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>HttpBLOBServlet </servlet-name> <url-pattern>/servlet/HttpBLOBServlet</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>HttpQueryServlet</servlet-name> <url-pattern>/servlet/HttpQueryServlet</url-pattern> </servlet-mapping> Configuración de múltiples instancias de hipergate en la misma máquina Todos los parámetros por defecto de los servlets pueden dejarse en blanco excepto si se utilizan varias instancias de hipergate en la misma máquina.driver.Driver | com.OracleDriver | jdbcURL dbUserName dbUserPassword .jdbc.microsoft.postgresql.sqlserver. en cuyo caso es preciso especificar valores pordefecto de la siguiente forma: Nombre de la clase Java del driver JDBC {org.

cnf hay que editar include de JSP situado en /web/methods/dbbind.DBTest Por consiguiente para utilizar el archivo de propiedades test.DBPortal com.DBTest"/> scope="application" m.dataobjs.cnf: demo. Java BeanShell 2.cnf y test. Cada instancia requiere el uso de un archivo de propiedades propio igual que hipergate.dataobjs.0.dataobjs.DBDemo com. Se debe reemplazar la clase com.knowgate.0 Drivers JDBC para Oracle Oracle Instant Client Microsoft SQL Server 2000 JDBC Driver SP3 Microsoft SQL Server 2005 JDBC Driver 1.cnf devel. BeanShell se utiliza durante el proceso inicial de creación de la base de datos con ModelManager.1 o.cnf portal.jsp debe ser: <jsp:useBean id="GlobalDBBind" class="com.l. Incompatibilidades conocidas Versión 4.cnf. Se puede usar hipergate con JBoss si se carga el modelo de datos con alguna de las exportaciones binarias. real.dataobjs.cnf.DBDevel com.cnf real. La versión pública de hipergate viene preparada para trabajar con 5 archivos de propiedades adicionales además de hipergate. Herramientas de Administración Consulta SQL .knowgate.3 El driver de Oracle que se suministra con la build sólo sirve para la versión 11g El driver de SQL Server que se suministra con la build sólo sirve para el Service Pack 2 de SQL Server 2005 hipergate 4 no funciona con Microsoft SQL Server 7. devel.cnf.cnf com.0.cnf el contenido de dbbind. Descargas Adicionales • • • • • • Drivers JDBC para PostgreSQL MySQL Connector/J 5. Para usar un archivo de propiedades diferente de hipergate.cnf pero con nombre distinto.dataobjs.knowgate.cnf. n.0 • • • • • • • El driver de PostgreSQL que se suministra con la build sólo sirve para la versión 8.DBReal com.jsp por la subclase apropiada para cada archivo de propiedades: demo.jsp.dataobjs.cnf test.knowgate.knowgate. portal.DBBind en dbbind.knowgate.0 y no puede modificarse fácilemnte para que funcione hipergate 4 no funciona con Oracle 8.knowgate.0b1 no es compatible con JBOSS 4. aunque no es muy difícil modificarla para que funcione hipergate 4 no funciona con versiones de MySQL anteriores a la 5. Todos los archivos de propiedades para todas las instancias deben colocarse en el mismo directorio.dataobjs. Múltiples instancias de hipergate en el mismo servidor Es posible utilizar varias instancias de hipergate corriendo contra diferentes bases de datos en el mismo servidor. por defecto /etc o C:\WINNT o el que se especifique en la variable de entorno KNOWGATE_PROFILES.

Permite lanzar uno o varios comandos SQL con el delimitador seleccionado por el susuario y recoger el conjunto de resultados de una consulta.postgresql.htm. Java BeanShell (necesario para ejecutar el asistente) no funciona bien sobre JBoss 4. de modo que tenga mucho cuidado en su uso cuando maneje varias instancias diferentes de hipergate en el mismo servidor ya que podría conectarse a la instancia equivocada. Configurar manualmente hipergate.x.Clase del driver --> <driver-class>org.html p. Estado del pool de conexiones Puede consultarse llamando a la página /admin/connectionpool.jsp Valor de las variables de entorno Pueden inspeccionarse llamando a la página /admin/environment. Por ejemplo si es PostgreSQL podría ser postgre-ds.Existe una herramienta de consulta directa por SQL contra la base de datos en /admin/sql.cnf y no en otros archivos de propiedades. Esta utilidad se conecta por defecto siempre contra la base de datos especificada en hipergate.Usuario y Contraseña --> <user-name>knowgate</user-name> <password>knowgate</password> <security-domain>PostgreSqlDbRealm</security-domain> <metadata> <type-mapping>Postgre SQL</type-mapping> </metadata> </local-tx-datasource> .xx.0.0.cnf Copiar los drivers JDBC y la librería hipergate-x.1:5432/hgoltp8t</connection-url> <!-.xml for para la base de datos que se vaya a utilizar. Instalación sobre JBoss Contribuido por Nam Tu nguyen • • • • • • • • • • • • • • • • • • Usar el archivo etiquetado hipergate-xx-war.jsp Valor de las cookies de sesión Pueden leerse llamando a la página /admin/viewcookies.zip Crear el modelo de datos usando un volcado binario en lugar de utilizando el Asistente de Instalación.xml como: <local-tx-datasource> <jndi-name>KnowgateDS</jndi-name> <connectionurl>jdbc:postgresql://127.0.Driver</driver-class> <!-. Se recomienda deshabilitar cualquer acceso a esta herramienta por parte de los usuarios finales.jar a %JBOSS_HOME%/server/default/lib/ Crear una conexión para JBoss en %JBOSS_HOME%/server/default/deploy/ Hacer una copia de hsql-ds.zip en vez de hipergate-xx-src.

UNIX=1.No se requiere un servicio. mbean.1.168.30:5432/test schema= dbuser=postgres dbpassword=postgres # [Pool de conexiones] # Parámeteros que gobiernan el comportamiento del pool de conexiones de hipergate poolsize=32 maxconnections=100 logintimeout=20 connectiontimeout=60000 connectionreaperdelay=30000 # [Acceso a Ficheros] # Directorio para archivos temporales temp=/tmp # Acceso a ficheros por parte del servidor # Modo de acceso a ficheros (PUREJAVA=0.Driver dburl=jdbc:postgresql://192. • • Copy hiperweb. usuario y contraseña de acceso a los siguientes recursos fileprotocol=file:// fileserver=localhost fileuser= filepassword= # Directorio raíz de almacenamiento privado storage=$CATALINA_HOME/webapps/storage # Directorio para almacenar tareas de borrado shelldir=/tmp # Directorio raíz de almacenamiento público workareasput=$CATALINA_HOME/webapps/hipergate/workareas # URL raíz de almacenamiento público workareasget=http://hostname:8080/workareas # Tamaño máximo de fichero (bytes) . host.postgresql. las variables $CATALINA_HOME no son válidas en este fichero. ni nada.xml. Apéndice 1: Propiedades de hipergate. tan sólo hay que modificar /default/conf/login-config. WINDOWS = 2) javamode=0 # URL raíz de la aplicación web webserver=http://hostname:8080 # URL raíz al servidor de imágenes opcional imageserver=http://hostname:8080/images # Protocolo.cnf El archivo hipergate.war to /server/default/deploy Abrir http://localhost/hiperweb/ q. se utilizan por claridad): # [Base de Datos] # Parámetros de conexión a la base de datos driver=org.cnf contiene la siguiente información (NOTA.

mysql.com mail.ldap. En PostgreSQL dejar este parámetro en blanco excepto si se experimentan problemas de acceso a la tabla sql_features en cuyo caso la propiedad schema debe ser public.transport.1" o "localhost".microsoft.knowgate. según se utilizaría en la función Class.dc=org ldapuser=cn=Manager.yourserver.0.outgoing=smtp.0.jdbc.SQLServerDriver (SQL Server 2000) com.postgresql.1:389/dc=hipergate.dc=hipergate.driver.SelectMethod=cursor.sqlserver. schema Esquema de la base de datos.jdbc.Driver (MySQL) oracle.store.microsoft.0.DatabaseName=nombre_bbdd (SQL Server 2000) • jdbc:sqlserver://nombre_host:1433.protocol=pop3 mail.SQLServerDriver (SQL Server 2005) Cadena de conexión JDBC a la base de datos: • jdbc:postgresql://host_name:5432/nombre_bbdd (PostgreSQL) • jdbc:mysql://host_name/nombre_bbdd (MySQL) • jdbc:oracle:thin:@nombre_host:1521:oracle_sid (Oracle) • jdbc:microsoft:sqlserver://nombre_host:1433.0.incoming=pop3.com mail. Dejar en blanco también para MySQL. Si el servidor web y la base de datos están en la misma máquina el host es "127.OracleDriver (Oracle) com.dc=org ldappassword=manager ldapclass=com.sqlserver.jdbc.LDAPNovell A continuación se describe cada uno de los parámetros y su función driver Nombre del driver JDBC.Databas eName=nombre_bbdd (SQL Server 2005) La cadena de conexión contiene siempre al menos el nombre o direcció IP del servidor (host) el puerto y el nombre de la base de datos.maxfileupload=10485760 # [Miscelánea] # ¿Realizar validación XML de documentos? setXMLValidation=1 # Número de hilos del planificador de tareas maxschedulerthreads=1 # [WebMail] # Poner los nombres de los protocolos en minúsculas mail. Puede ser el usuario propietario de las tablas.forName: • • • • • dburl org.Driver (PostgreSQL) com.SelectMethod=curs or.protocol=smtp mail.jdbc.yourserver.user= # LDAP ldapconnect=ldap://127. • • dbo (SQL Server) HIPERGATE (Oracle) .

com/hipergate http://myserver:8080/images http://localhost:7001/hipergateWeb/images (ejemplo con WebLogic) fileprotocol hipergate puede acceder a los ficheros almacenados de distinas maneras: por FTP. El valor por defecto para este parámetro es 32. para obtener una conexión a la base de datos. El modo 0 (PUREJAVA) accede al sistema de archivos a través del API de Java (java. • • • file:// (ficheros locales) ftp:// (acceso por FTP) nfs:// (acceso por NFS. Tras este periodo de inactividad todas las conexiones no usadas se cierran y el tamaño del pool se reduce eventualmente a cero. se deshabilita el pool y cada conexión se obtiene llamando directamente al método java. • • • http://images. o dejarse en un subdirectorio dentro del mismo servidor.DriverManager. en segundos.io). no soportado) fileserver Nombre del servidor que contiene el repositorio de ficheros. webserver URL completa a la raíz de la aplicación web. Si este parámetro se pone a cero.sql. NFS o directorios montados directamente en el servidor. Todas las imágenes estáticas de la aplicación (pantallas. El valor por defecto es 20. • • /tmp (Linux) C:\\TEMP (Windows) javamode Modo de trabajo con el sistema de ficheros del servidor. maxconnections Número máximo absoluto de de conexiones que se pueden abrir contra la base de datos.getConnection(). etc) pueden ubicarse en un servidor separado. iconos. Esta opción solo es útil cuando el .DD.• public (PostgreSQL) dbuser/dbpassword Usuario y contraseña de conexión a la BB.mycompany. Se utiliza para componer las URLs relativas y absolutas a cada módulo de la aplicación. los modos nativos proporcionan un acceso a ficheros mucho más eficaz. poolsize Número de conexiones que permanecerán abiertas en el pool en espera de ser utilizadas. En él se almacenan los archivos de subida (upload) y algunos archivos de generación temporal. logintimeout Tiempo máximo de espera. temp Directorio temporal para la aplicación. En WebLogic bajo Windows se debe utilizar el modo PUREJAVA. En este parámetro se establece el protocolo de acceso al repositorio de ficheros. • • • http://server:port/webapp http://myserver:8080/ http://localhost:7001/hipergateWeb (ejemplo con WebLogic) imageserver URL al servidor de imágenes opcional. via JDBC. Los modos 1 y 2 (UNIX y WINDOWS) utilizan comandos del sistema para realizar las mismas acciones. Una conexión sólo puede permanecer en el pool sin ser utilizada por un máximo de 5 minutos. Mientras que el modo PUREJAVA mantiene la compatibilidad entre plataformas.

protocol Protocolo de almacenamiento de correo electrónico (por defecto pop3) mail. o bien en otro directorio. Puede estar dentro de la raíz del servidor web. website o cuenta de acceso hay que borrar todos los directorios relacionados con este objecto. mail. Se puede crear un script que lea este fichero y borre cada directorio y añadirlo como una tarea programada (cronjob) o ejecutarlo cada vez que se rearranca el servicio. • • • (Windows 2000) $CATALINA_HOME/webapps/storage /vol/1/hipergate_storage C:\\bea\\weblogic81\\samples\\workshop\\hipergate\\storage shelldir Algunos contenedores de servlets (sobre todo Tomcat) bloquean ficheros y directorios. • • /workareas /hipergateWeb/workareas maxfileupload Tamaño máximo (en bytes) de fichero que se permite subir a la aplicación setXMLValidation Activar las trazas de validación de XML al fusionar las plantillas XSLT de los módulos webbuilder y mailings. storage Directorio raíz de almacenamiento privado de usuarios.incoming Servidor de recepción de correo POP3 (por defecto localhost) .com (acceso por FTP) fileuser/filepassword Nombre de usuario y contraseña utilizados para el acceso a repositorios remotos. plantillas y scripts de ejecución SQL (QBF).protocolo de acceso fileprotocol es distinto de file://.transport. • $CATALINA_HOME/webapps/hipergate/workareas • /vol/1/hipergate_workareas • C:\\BEA\\weblogic81\\samples\\workshop\\hipergate\\hipergateW eb\\workareas (Windows 2000) workareasget URL absoluta para acceder al directorio workareasput. Si desea eliminar una newsletter.txt con la ruta completa al directorio a borrar.store.protocol Transporte que se utilizará para enviar mensajes de correo electrónico (por defecto smtp) mail.domain. • • • /tmp $CATALINA_HOME/webapps/shell C:\\BEA\\weblogic81\\samples\\workshop\\hipergate\\shell (Windows 2000) workareasput Directorio raíz de almacenamiento público. Actualmente solo se utiliza para acceso por FTP. Para cada elemento a borrar. se añade una linea al fichero cleanup. visible a través de web. • • localhost (ficheros locales) ftp-server. pero Java impide este borrado y por tanto hay que crear una tarea que borre los directorios desde fuera del contendor de servlets. maxschedulerthreads Número máximo de hilos (threads) que arranca el planificador de ejecución.

bak a la lista de dispositivos y hacer click en OK. seleccionar All Tasks -> Restore Database. La base de datos utilizada en el parámetro dburl debe estar creada y vacía antes de ser cargada.DD. Oracle 10g/XE 1.DD.backup Si se encuentran problemas de permisos accediendo al lenguaje c. hacer: # update pq_language set lanpltrusted=true where lanname='c'. Apéndice 2: Carga manual de la base de datos Creación de la base de datos con volcados binarios En vez de utilizar el Asistente de Instalación es posible configurar el archivo hipergate.mail. Para cargar la base de datos con el modelo básico de trabajo y un juego de datos de ejemplo.dmp Microsoft SQL Server 2005 1. # grant usage on language c to knowgate. El proceso de carga de base de datos de hipergate utilizará los parámetros de conexión.bak a una unidad de disco local. Creación de la base de datos con la clase Java ModelManager Para utilizar una base de datos primero debe comprobar que dispone del driver JDBC correspondiente y que lo ha configurado en el fichero hipergate. Escribir la siguiente sentencia desde la línea de comandos: IMP system/manager fromuser=HIPERGATE touser=HIPERGATE buffer=128000 commit=yes ignore=yes file=h4orclxe.DUMP: # pg_restore -d hipergate4 h4pgsql83.cnf. Restaurar la BB. Copiar h4mssql2005. PostgreSQL 8. usuario y contraseña disponibles en el fichero de configuración.cnf manualmente e importar los volcados binarios del modelo de datos que hay en el directorio database/ de la distribución.outgoing Servidor de envío de correo SMTP (por defecto localhost) r. seleccionar "From Device". Hacer click con el botón derecho sobre la nueva BB. ejecute el . añadir h4mssql2005.x 1. Crear una base de datos Unicode: # createdb -E UNICODE hipergate4 Crear un nuevo usuario: # createuser knowgate # grant all on database hipergate4 to knowgate 2. desde el fichero H3PGSQL8.. 2.

y ejecutar la sentencia modelmanager. etc. Cada vez que se ejecuta.knowgate.knowgate. La parte cliente está en el paquete com.0b1.siguiente comando (respetando mayúsculas y minúsculas): java [-cp . a su vez.jar.jar.. Apéndice 3: Configuración de granjas de servidores Introducción hipergate puede funcionar instalado en granjas de servidores.hipergate.jar. se marca como inválida para todos los demás y el resto deben re-cargarla de la base de datos.2.cache en hipergate. ibm. s. sino simplemente otorga tickets con fechas de caducidad a los caches locales para coordinarlos entre ellos. xmlParserAPIs. También hay que incluir el driver JDBC apropiado.jar. opciones de menú. jakarta-oro-2.cnf create database NOTA: Será necesario que en su variable de entorno CLASSPATH se encuentren todas las librerías incluidas en la distribución de hipergate.jar y es independiente del servidor que se utilice. es necesario habilitar el Coodinador de Cache Distribuido.datamodel.knowgate.hipergate.datamodel.jar.8. Cada servidor web de hipergate mantiene un cache local de información de acceso frecuente: claves de usuuente: claves de usuario. Esta es la configuraci&oacut .0. Por este motivo es necesario instalar un coordinador de caches locales.sh.sh create database. El coordinador en si mismo no almacena ninguna información. xercesImpl. Cuando se actualiza la información en un nodo.ModelManager $@ Puede guardar el anterior script en /usr/local/bin/modelmanager.ModelManager /etc/hipergate. El siguiente script puede facilitar esta tarea.jar | tr '\n' ':'` java -cp "$cp" com. Un coordinador HTTP utiliza uno de los servidores web en la granja para coordinar al resto. Si se ponen varios servidores web en pararelo existe la posibilidad de que uno de los servidores actualice en la base de datos información que está locamente cacheada en otro. ser de dos tipos: HTTP o EJB. Cuando la aplicación funciona sobre varias máquinas en paralelo. El coordinador de cache se divide en dos partes: cliente y servidor. El conjunto mínimo de librerías de las incluidas en la distribución para que funcione ModelManager es: beanshell.. La parte servidor puede.bsf-2. valores de remonte.] com.bsh-2. busca todos los paquetes JAR en /opt/tomcat/webapps/hipergate/WEB-INF/lib/ y los añade al CLASSPATH (-cp) del comando java que se ejecuta al final: #!/bin/sh cp=`ls -1 /opt/tomcat/webapps/hipergate/WEB-INF/lib/*. No es posible pasar información de un cache local a otro.

common-client.jboss.connectionmanager.plugins. Sólo puede haber un coordinador.jboss. escalabilidad y tolerancia a fallos.BMT --> <interceptor transaction = "Bean"> org.ejb.ejb.provider.resource. el resto de los nodos dejarán de funcionar.cnf de cada nodo y poner: threetiers=enabled java.naming.jar jboss-3.TxInterceptorBMT </interceptor> <interceptor transaction = "Bean" metricsEnabled = "true"> org.ejb.jboss.ejb.jndi.xml añadir: <container-configuration> <container-name>Singleton Stateless SessionBean</container-name> <call-logging>false</call-logging> <container-invoker>org. abrir el archivo de propiedades appserver.jar apache.log4j.StatelessSessionInstanceInterceptor </interceptor> <interceptor transaction = "Bean"> org.ejb.MetricsInterceptor </interceptor> <interceptor> org.jsp Configuración del coordinador sobre un servidor EJB La instalación del coordinador sobre un contenedor de EJBs es más compleja que directamente sobre un servidor web aunque también proporciona mejor rendimiento.jar Parte Servidor (JBoss) En el archivo standardjboss.jboss.plugins. Para habilitar el coordinador.proxy.jar sun.plugins.SecurityInterceptor</interceptor> <!-.ProxyFactory</containerinvoker> <container-interceptors> <interceptor>org.jboss.jboss. Configuración del coordinador sobre un servidor HTTP Cualquierna de los nodos en una granja de servidores hipergate puede actuar como coordinador del resto. Parte Cliente (servidores web) Para utilizar JBoss es preciso instalar librerías adicionales en cada uno de los clientes • • • • • cachecoordinator-jboss30.plugins.0.Un coordinador EJB utiliza un servidor de aplicaciones como JBoss o WebLogic como servidor de tickets para los servidores web cliente.jnp-client.0.plugins.LogInterceptor</interceptor> <interceptor>org.ejb.jboss. si el coordinador cae.jar jboss-3.CachedConnectionInterceptor .url=http://DIRECCION_IP:PUERTO/cache/server.

5 Acceso a ficheros basados en el formato de Documento OLE 2 de Microsoft desde Java. escrito en Java.proxy. Jakarta ORO 2. jboss/server/default/deploy o jboss/server/minimal/deploy Abrir la consola de administración de JBoss (http://servidor:8080/jmx-console/ seleccionar el menú "MainDeployer" para desplegar el archivo cachecoordinatorjboss30.proxy.0b4 BeanShell es un intérprete de código fuente de Java con características de scripting.SecurityInterceptor</interceptor> <interceptor>org.jboss.3. Jakarta POI .jboss.proxy. Apéndice 4: Librerías de terceros J2EE Client .InvokerInterceptor</interceptor> </bean> </client-interceptors> <instancepool>org.HomeInterceptor</interceptor> <interceptor>org.0.0 Un conjunto de clases Java que proporcionan un lenguaje de scripting dentro de aplicaciones Java.jboss.jboss.plugins.0) El proyecto OROMatcher fue cedido a The Apache Software Foundation y ahora es Jakarta .jboss.ejb.Java API To Access Microsoft Format Files .invocation.</interceptor> </container-interceptors> <client-interceptors> <home> <interceptor>org.SecurityInterceptor</interceptor> <interceptor>org.TransactionInterceptor</interceptor> <interceptor>org.TransactionInterceptor</interceptor> <interceptor>org. Para ello: • • • Copiar el JAR al directorio jboss/server/all/deploy.jboss.InvokerInterceptor</interceptor> </home> <bean> <interceptor>org.9.2.1.0 Contiene clases J2EE necesarias para el cache distribuido de hipergate Xerces2 Java Parser 2.jar.jboss.proxy.8 (sólo a partir de la versión 2.proxy.jar (ej.2.2.ejb.StatelessSessionInstancePool</instance-pool> <instance-cache/> <persistence-manager/> <transaction-manager/> <container-pool-conf> <MaximumSize>1</MaximumSize> <MinimumSize>1</MinimumSize> <strictMaximumSize>true</strictMaximumSize> </container-pool-conf> </container-configuration> Arrancar JBoss y desplegar el archivo cachecoordinator-jboss30.4 Jakarta Lucene es un motor de indexación de alto rendimiento escrito en Java. Java BeanShell .4. Jakarta Lucene .proxy.StatelessSessionInterceptor</interceptor> <interceptor>org.ejb.invocation.jar) t. file://C:\jboss\server\all\deploy\cachecoordinatorjboss30.jboss.0 Parser XML de la Fundación Apache Bean Scripting Framework .jboss.

Actualización desde la versión 3.oreilly.1. java [-cp .1.JiBXException: Unable to access binding information for class com. Abrir el asistente de instalación en http://servidor/admin/setup.jar.jar al compilar el proyecto.0 El API de JavaMail proporciona un conjunto de clases para el acceso a un sistema de correo.binding.0 a la 4.cnf upgrade 210 300 .Compile C:\knowgate\storage\xslt\schemas\menu-def-jixb. 5.jar.1 a la 3. 3.txt en Windows). No se debe utilizar la versión de depuración en sistemas de producción final ya que pueden degradar el rendimiento o llenar el disco.jar. 4.0 (excepto el driver JDBC que se esté usando). Esta librería vuelca trazas detalladas de ejecución en el archivo /tmp/javatrc.jar org. Sun JavaMail . El asistente detectará automáticamente la versión anterior y actualizará convenientemente el modelo de datos.0 Para actualizar la versión 2.ModelManager desde la línea de comandos.ModelManager /etc/hipergate.1.1 reutilizando el hipergate. Sun JSR-168 Portlet API 1.0. Descargar el archivo ZIP comprimido de la 3. Sun Java Advanced Imaging API ..knowgate.hipergate.0 a la misma base de datos de la 2.1) JiBX XML binding 1.0 se encuentran en /java/com/knowgate/hipergate/datamodel/updgrade/ Hay que ejecutar el archivo 210-300.cnf que ya existiese.runtime.5 JiBX es un entorno de trabajo para manipular archivos XML usando objetos Java isomorfos.0 efectuar los siguientes pasos : 1.datamodel.Menu Para solucionar este error hay que ejecutar el post-compilador de JiBX tras compilar normalmente el proyecto ejecutando: C:\JRE\bin\java -cp C:\JAR\bcel.ORO.knowgate.] com.CacheHttpServlet: Cannot resolve symbol method getContentType() Para solucionar este error incluir la librería /lib/compile/servlet.jibx.xml w.hipergate. v. Esto puede hacerse utilizando la clase com.jibx.0) Las librerías LDAP de SUN proporicionan acceso a Novell eDirectory™.4.htm.1. 7.hipergate.knowgate.C:\JAR\jibxextras. org. Apéndice 5: Librerías de Depuración La versión estándar de hipergate se distribuye con una librería de depuración llamada hipergatedebug.0 (sólo desde la versión 2. 6.C:\JAR\xpp3. Apéndice 6: Notas para recompilar los fuentes com.jar.txt (o C:\javatrc. Actualización manual alternativa Los scripts para alterar un modelo de datos de versión 2.jar ya no viene dentro del directorio /WEB-INF/lib como en la 2.3 Las librerías JAI de SUN proporcionan acceso a tratamiento de imágenes en el lado del servidor sin emplear AWT Novell LDAP classes for Java(sólo a partir de la versión 2.ddl para la base de datos correspondiente.C:\JAR\jibx-bind-1. Cambiar todas las librerías del /WEB-INF/lib de la 3.0. Instalar las páginsa JSP de la 3. sino descomprimido en el directorio /WEB-INF/classes de la 3. 2.0 por las de la 4. OpenLDAP u otros directorios basados en LDAP. u.1 y actualizarlo a la 3..0.datamodel.1. Hacer una copia de respaldo de la base de datos y de las páginas JSP de la 3.0 en una nueva ubicación en el servidor web.servlet. Apuntar la instancia de 3.5.1. El archivo hipergate.

SET AUTOCOMMIT TO OFF is no longer supported La versión del driver JDBC no coincide con la de la base de datos. you need the SUPER privilege for this operation Durante la creación inicial del modelo de datos.com/thread.com/products/javamail/FAQ.mail.smtp.html#norelay No provider for SMTP Escribir el nombre del protocolo smtp en minúlas en la propiedad mail.cnf.smtp. Access denied.1 Unable to relay for . ERROR: function k_sp_autenticate("unknown".transport..sun. Debe activar el lenguage PL/pgSQL ANTES de iniciar la creación del modelo de datos con el asistente de instalación.SMTPAddressFailedException: 553 sorry. Diagnóstico de Problemas JavaMail com.k_sp_prj_cost does not exist Desde una herramienta de consulta SQL volver a crear sobre el propietario adecuado (típicamente dbo o db_accessadmin) la función Transact/SQL k_sp_prj_cost cuyo código fuente puede encontrarse en java\com\knowgate\hipergate\datamodel\procedures\mssql\projtrack.sun.mail. Ejecutar el GRANT según se especifica en la sección de creación de usuarios para MySQL de esta guía.SMTPAddressFailedException: 550 5.x. that domain isn't in my list of allowed rcpthosts (#5. Ver http://java.1) Este error suele ser debido a que el servidor de correo requiere autentificación al enviar.cnf MySQL MessagingException Illegal mix of collations for operation 'UNION' Esto es debido a que la base de datos ha sido creada con juego de caracteres LATIN1 (u otro) en vez de UTF8. "unknown") does not exist.sun. The authentication service is temporaly unavailable. PostgreSQL Impossible to get connection to the database relation "sql_features" does not exist Pruebe a establecer la propiedad schema=public en hipergate.jspa?threadID=586817&tstart=0 com..7. .7. Este error es debido a que la seguridad de servidor no permite hacer relay de correo.sun.protocol de hipergate.cnf y reiniciar el servidor web para que coja los cambios. Busque en los foros públicos para obtener información adicional sobre problemas con la instalación. SQL Server FUNCTION dbo.ddl General Posted content length of XXX exceeds limit of YYY Aumentar el valor en bytes de la propiedad maxfileupload en hipergate. Ver http://forum.java.

You're Reading a Free Preview

Descarga
scribd
/*********** DO NOT ALTER ANYTHING BELOW THIS LINE ! ************/ var s_code=s.t();if(s_code)document.write(s_code)//-->