Configuración de /WEB-INF/web.xml

web.xml

Tras ejecutar el Asistente de Instalación, es conveniente revisar el contenido del archivo /WEB-INF/web.xml para configurar los parámetros de los servlets del paquete com.knowgate.http.
Deben estar creados los servlets: HttpBinaryServlet, HttpBlobServlet y HttpQueryServlet.

Servlets

hipergate incluye servlets para la descarga de archivos, para el acceso remoto a la base de datos, acortamiento de URLs e interoperabilidad de calendarios ICalendar y contactos VCard.
Servlets requeridos

• HttpSchedulerServlet: Planificador de tareas. Utilizado por el módulo de email marketing.
• HttpBinaryServlet: Descarga de archivos desde el directorio /storage. Utilizado por el módulo de disco virtual.
• HttpBlobServlet: Descarga de archivos desde campos LONGVARBINARY de la BB.DD. Utilizado por el módulo de gestión de proyectos.

• HttpCalendarServlet: Interoperabilidad con Google Calendar.
• HttpDataObjsServlet: Acceso remoto a la BB.DD. por HTTP. No se recomienda instalar este servlet sin revisar adecuadamente su configuración de seguridad. Úsese por HTTPS y con contraseñas fuertes únicamente. Ya que permite el acceso externo completa a la base de datos por SQL.
• HttpShortURLRedirect: Redireccionador del acortador de URLs.
• HttpVCardServlet: Lee contactos del calendario de hipergate en formato VCard.

Para cada unos de los servlets requeridos (HttpBinaryServlet, HttpBLOBServlet y HttpQueryServlet) hay que configurar los siguientes parámetros:

jdbcDriverClassName

Establece el driver de acceso a BB.DD., igual que el parámetro driver de hipergate.cnf

jdbcURL

Establece la cadena de conexión a la BB.DD., igual que el parámetro dburl de hipergate.cnf

dbUserName/dbUserPassword

Establece el usuario y contraseña de acceso a la BB.DD., igual que los parámetros dbuser/dbpassword de hipergate.cnf

Los parámetros de conexión a la base de datos para los servlets del paquete com.knowgate.http (HttpBinaryServlet, HttpBLOBServlet y HttpQueryServlet) pueden especificarse en el archivo de /WEB-INF/web.xml o en el archivo /etc/hipergate.cnf. La informacion de web.xml es prioritaria sobre la de hipergate.cnf de modo que si ambas difieren se tomará como válida la de web.xml.

Los parámetros de web.xml pueden dejarse vacíos si se tiene una única instancia de la aplicación corriendo en el mismo servidor, pero es imprescindible rellenarlos si se tienen varias instancias de la aplicación corriendo en el mismo servidor contra bases de datos diferentes. Si no se encuentran parámetros de conexión en web.xml el servlet irá a buscarlos a hipergate.cnf y no a otros archivos de configuración como real.cnf o portal.cnf.

            <servlet>
                  <servlet-name>HttpBinaryServlet</servlet-name>
                  <servlet-class>com.knowgate.http.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>
                      <param-value></param-value>
                  </init-param>
              </servlet>
          
             <servlet>
                  <servlet-name>HttpBLOBServlet</servlet-name>
                  <servlet-class>com.knowgate.http.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.knowgate.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>
                  </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 el mismo Tomcat

Es posible utilizar varias instancias de hipergate corriendo contra diferentes bases de datos en el mismo servidor.
Cada instancia requiere el uso de un archivo de propiedades propio igual que hipergate.cnf pero con nombre distinto.
Todos los archivos de propiedades para todas las instancias deben colocarse en el mismo directorio, por defecto /etc o C:\Windows o el que se especifique en la variable de entorno KNOWGATE_PROFILES.
La versión pública de hipergate viene preparada para trabajar con archivos de propiedades adicionales además de hipergate.cnf:
demo.cnf, devel.cnf, portal.cnf, real.cnf y test.cnf.
Para usar un archivo de propiedades diferente de hipergate.cnf hay que editar include de JSP situado en /web/methods/dbbind.jsp.
Se debe reemplazar la clase com.knowgate.dataobjs.DBBind en dbbind.jsp por la subclase apropiada para cada archivo de propiedades:

Por consiguiente para utilizar el archivo de propiedades test.cnf el contenido de dbbind.jsp debe ser:
<jsp:useBean id="GlobalDBBind" scope="application" class="com.knowgate.dataobjs.DBTest"/>