PDF de programación - Velneo vModApache 7.18

Velneo vModApache 7.18

Índice de contenido

¿Qué es Velneo vModApache V7?.......................................................................................2
Modo básico de funcionamiento del módulo Velneo vModApache V7..............................2
Descargar, instalar y activar Velneo vServer V7..............................................................3
Descargar e instalar el módulo Velneo vModApache V7..................................................3
Descargar e instalar el servidor Apache 2.4 y configurar en el archivo de configuración
de Apache (httpd.conf) la carga del módulo Velneo vModApache V7..............................3
Desarrollar e instanciar un proyecto que contendrá los procesos que, ejectuados desde
la web, retornarán el código html a servir.........................................................................3
Configurar en el archivo de configuración de Apache (httpd.conf) las directivas de
virtualhost o location para el servicio de páginas de Velneo V7.......................................4
Instalación en Linux..............................................................................................................6
Nomenclatura de objetos en urls..........................................................................................7
Procesos..........................................................................................................................7
Dibujos...........................................................................................................................11
Campos de tipo objeto dibujo.........................................................................................12
Variable CONTENT_TYPE.............................................................................................14
Uso de ficheros adjuntos.....................................................................................................14

Pol. Ind. A Granxa, Edificio vCenter
Rúa D, esquina paralela 3
36400 Porriño (Pontevedra)
España

Telf. (+34) 902 36 63 82
[email protected]
velneo.es

Velneo, S.A. C.I.F. A36494706 Inscrita en el Reg Mercantil de Pontevedra al tomo 3085, Libro 3085, Folio 90, Hoja PO-37578, Inscr 1ª

1

Velneo vModApache 7.18

¿Qué es Velneo vModApache V7?
Se trata del módulo Apache para soluciones web. Es un módulo web del servidor Web Apache
que permite servir vía web diversos objetos de instancias de un proyecto de Velneo V7.
Desde un único servidor Apache podremos servir páginas de proyectos de distintintos servidores
de Velneo V7 (Velneo vServer V7).
En la versión actual este módulo solamente está disponible para sistemas operativos Windows y
Linux (en beta) y es compatible solamente con la versión 2.4 de Apache.
En la versión actual el módulo sirve procesos, dibujos y campos de tipo objeto dibujo.

Modo básico de funcionamiento del módulo Velneo vModApache V7
1) Al inciar el servidor web Apache se inicia el módulo, el cual conecta con el/los Velneo vServer
V7.
2) Un navegador (IExplorer, Mozilla, etc.) hace una petición al servidor web de Apache.
3) Dependiendo de la url, el módulo Velneo vModApache V7 procesa esa petición (según lo
que hayamos especificado en la configuración del servidor web Apache). Si la petición no la
procesa el módulo, se la pasa a Apache.
4) El módulo Velneo vModApache V7 devuelve la salida, ya sea el resultado de un proceso
(página web) o una imagen al servidor web Apache.
5) El servidor web Apache envía la salida al navegador.
Esta configuración permite usar todas las funcionalidades del servidor web de Apache y distribuir
la aplicación de Velneo V7 como queramos (no es necesario que el servidor web Apache esté en
la misma máquina que Velneo vServer V7).
Además Velneo vModApache V7 es multi-hilo, por lo que es posible atender a multitutd de
peticiones web de forma simultánea con un solo enganche.
Desde la web podremos ejecutar, básicamente, procesos que retornarán el código html a servir.
Esos procesos, en úlitma instancia, retornarán una cadena texto con el código html, mediante el
comando de instrucción de proceso Set dato de retorno del proceso.
Para poder servir páginas web desde aplicaciones de Velneo V7 necesitaremos:
Descargar, instalar y activar Velneo vServer V7.
Descargar e instalar el módulo Velneo vModApache V7.

Pol. Ind. A Granxa, Edificio vCenter
Rúa D, esquina paralela 3
36400 Porriño (Pontevedra)
España

Telf. (+34) 902 36 63 82
[email protected]
velneo.es

Velneo, S.A. C.I.F. A36494706 Inscrita en el Reg Mercantil de Pontevedra al tomo 3085, Libro 3085, Folio 90, Hoja PO-37578, Inscr 1ª

2

Velneo vModApache 7.18

Descargar e instalar la versión 2.4 del servidor Apache para 32 bits y configurar en el archivo de
configuración de Apache (httpd.conf) la carga del módulo Velneo vModApache V7.
Desarrollar e instanciar un proyecto que contendrá los procesos que, ejectuados desde la web,
retornarán el código html a servir.
Configurar en el archivo de configuración de Apache (httpd.conf) las directivas de virtualhost o
location para el servicio de páginas de Velneo V7.
A continuación iremos explicando cada uno de estos pasos.

Descargar, instalar y activar Velneo vServer V7
Encontrarás toda la información en el capítulo dedicado a Velneo vServer V7.

Descargar e instalar el módulo Velneo vModApache V7
Accede a la página de descargas de este sitio web, descarga el producto e instálalo en la
máquina donde vayas a instalar el servidor Apache. En este punto aclarar que el servidor
Apache y Velneo vServer V7 no tienen por qué estar en la misma máquina; pueden estar en
máquinas diferentes. Además, tal y como se comenta al comienzo de este capítulo, desde un
único servidor Apache podemos servir páginas de distintos servidores de Velneo V7.

Descargar e instalar el servidor Apache 2.4 y configurar en el archivo
de configuración de Apache (httpd.conf) la carga del módulo Velneo
vModApache V7
El nombre del archivo correspondiente al módulo vModApache V7 se llama llama
mod_velneo.so; éste no es instalado en el directorio de módulos de Apache, sino que se instala
en el directorio de Velneo V7 por defecto (C:\Archivos de programa\Velneo\V7); el motivo de ello
es que dicho módulo usa una serie de librerías que son instaladas en dicho directorio.
Por tanto, para declarar su carga, debemos incluir la senda completa del mismo y entrecomillarla
si ésta contiene espacios en blanco:
#Carga el módulo de Velneo
LoadModule velneo_module "C:/Archivos de programa/Velneo/V7/mod_velneo.so"

Desarrollar e instanciar un proyecto que contendrá los procesos que,
ejectuados desde la web, retornarán el código html a servir
Consultar en la zona info el capítulo dedicado a Velneo vDevelop V7.

Pol. Ind. A Granxa, Edificio vCenter
Rúa D, esquina paralela 3
36400 Porriño (Pontevedra)
España

Telf. (+34) 902 36 63 82
[email protected]
velneo.es

Velneo, S.A. C.I.F. A36494706 Inscrita en el Reg Mercantil de Pontevedra al tomo 3085, Libro 3085, Folio 90, Hoja PO-37578, Inscr 1ª

3

Velneo vModApache 7.18

Configurar en el archivo de configuración de Apache (httpd.conf) las
directivas de virtualhost o location para el servicio de páginas de
Velneo V7
Podremos, o bien, establecer una directiva de location, o bien una directiva de virtualhost.
La declaración de una directiva de location sería:
<Location /senda_base>
setHandler velneo
Vrl vatp://usuario:contraseña@servidor[:NUM_PUERTO]/ID_INSTANCIA
</Location>
Donde:
senda_base será la senda base para la web del proyecto a servir.
En el parámetro Vrl se indicará la VRL del servidor, usuario, contraseña e identificador de la
instancia que va a ser atacada vía web.
Si el usuario especificado no tiene contraseña, no se incluirá dicho parámetro, pero sí los dos
puntos: ...usuario:@SERVIDOR..."
En el caso de que el usuario o la contraseña incluya caracteres especiales tales como @, \, etc.
éstos no podrán ser escritos directamente en la cadena sino que tendrán que ir codificados en su
equivalente html (%CODIGO_CARACTER). Ejemplo:
Ejemplo: Si la contraseña del usuario es 123@45, la especificaríamos así: 123%4045
Si el número de puerto del servicio VATP es el 690, no habrá que especificarlo tampoco en la
VRL, ya que éste es el puerto por defecto para el servicio.
Ejemplo
#Ejemplo de directivas location Velneo en httpd.conf
<Location /gestion>
setHandler velneo
Vrl vatp://web:2e3x4A1@localhost/GESTION
</Location>
Supongamos que en el proyecto de destino hemos creado un proceso llamado INDEX; la url
para ejecutarlo sería:

Pol. Ind. A Granxa, Edificio vCenter
Rúa D, esquina paralela 3
36400 Porriño (Pontevedra)
España

Telf. (+34) 902 36 63 82
[email protected]
velneo.es

Velneo, S.A. C.I.F. A36494706 Inscrita en el Reg Mercantil de Pontevedra al tomo 3085, Libro 3085, Folio 90, Hoja PO-37578, Inscr 1ª

4

Velneo vModApache 7.18

http://IP_SERVIDOR/gestion/index.pro
Donde:
IP_SERVIDOR será la IP o el nombre del servidor donde está alojado el servidor apache.
gestion es la senda base que hemos especificado en el archivo de configuración de Apache.
index.pro Objeto a ejecutar de la instancia de Velneo, la extensión ".pro" lo identifica como un
proceso.
Declaración de una directiva de virtualhost:
Esta podremos declararla tanto en el fichero httpd.conf como en el fichero httpd-vhosts.conf
de Apache, en caso de hacerlo en el segundo, tendremos que asegurarnos que en el fichero
httpd.conf se incluya la llamada al fichero httpd-vhosts.conf, mediante el comando:
Include conf/extra/httpd-vhosts.conf
Habitualmente este include suele venir declarado en el fichero pero a modo de comentario:
#Include conf/extra/httpd-vhosts.conf
Para habilitar la llamada simplemente habrá que quitarle el carácter #.
La directiva de virtualhost la declararemos del modo siguiente:
<VirtualHost *:número_puerto>
ServerName nombre_servidor
setHandler velneo
Vrl vatp://usuario:contraseña@servidor[:NUM_PUERTO]/ID_INSTANCIA
</VirtualHost>
Donde:
número_puerto será el número de puer