httpserver.vsi: es un archivo binario, utilizado para una carga más rápida.
httpserver.json: es un archivo de configuración en formato JSON, legible y editable.
El servidor (vServer) tiene una lógica específica para garantizar la mejor experiencia de carga y para mantener la coherencia de la configuración.
El servidor intenta cargar la configuración de la forma más eficiente posible, priorizando el archivo binario.
1. Carga por Defecto (Desde el Binario)
Este es el escenario de carga habitual, que optimiza el rendimiento.
Al solicitarse la carga de la configuración, y el archivo binario httpserver.vsi existe, la configuración se carga directamente desde el archivo binario.
Si ocurre algún error durante esta carga, el mensaje correspondiente se mostrará en el panel de mensajes de vAdmin.
2. Carga de Respaldo (Desde JSON y Regeneración Binaria)
Este escenario se ejecuta cuando no existe el fichero binario.
Al solicitarse la carga de la configuración, y el archivo binario httpserver.vsi no existe, la configuración se carga desde el archivo JSON (httpserver.json).
Inmediatamente después de la carga exitosa, el servidor genera y guarda una nueva versión del archivo binario (httpserver.vsi).
Si ocurre algún error durante esta carga, el mensaje correspondiente se mostrará en el panel de mensajes de vAdmin.
Si necesitamos que vServer cargue la configuración desde el archivo JSON de forma intencionada (por ejemplo, tras editarlo manualmente o después de una migración), debemos detener el servidor, borrar el archivo httpserver.vsi . Al arrancarlo nuevamente, se generará el vis a partir del JSON.
Al realizar un cambio en el panel de administración (vAdmin), el servidor se asegura de que la configuración quede guardada en ambos formatos.
En servidores locales, por defecto, siempre se abre un puerto 443 en el servidor para servir los componentes (vAdmin Web, vDataClient Web). Pero es configurable.
Las propiedades de un Virtual host son las siguientes:
Configuración general
Activo
Nos permite activar o desactivar el virtual host.
Puerto de escucha
En este parámetro especificaremos el puerto de escucha para este virtual host. Ejemplo: 8080
Nombre del host
Si vamos a usar un dominio, lo especificaremos aquí. Ejemplo: midominio.com.
Este parámetro es opcional.
SSL
En este parámetro configuraremos si el protocolo a usar va a ser con SSL (HTTPS) o sin SSL (HTTP).
Fichero certificado
Si la conexión va a ser SSL, aquí podemos especificar la senda en disco del fichero correspondiente al certificado.
El certificado debe ser fullchain: es el archivo que garantiza la jerarquía de confianza entre el servidor y una autoridad reconocida. Contiene, en un orden específico, la lista de certificados necesarios para que un navegador valide la conexión como segura:
Certificado de Entidad Final: El certificado específico de tu dominio (el "suscriptor").
Certificados Intermedios: Uno o varios certificados que actúan como puente, demostrando que tu dominio ha sido validado por una Autoridad Certificadora (CA) de confianza.
Si necesitas información sobre cómo componerlo, haz clic aquí.
Este parámetro es opcional.
Fichero clave privada
Si la conexión va a ser SSL, y en el parámetro anterior hemos especificado un certificado, aquí podemos especificar la senda en disco del fichero de la clave privada del certificado.
Este parámetro es opcional.
Instancias
Si vamos a servir vía Web objetos de instancias de proyectos de Velneo, definiremos un elemento por cada instancia a servir.
El botón nos permitirá configurar una instancia y el botón eliminarla.
Por cada instancia, debemos cumplimentar los siguientes parámetros:
Ruta
Que será la ruta para la web dentro del host que tendrá la instancia que queremos servir.
Siempre debe ir precedida del carácter "/".
Instancia
Que será el identificador que tenga en vAdmin la instancia que queremos servir:
Ficheros estáticos
Si desde el virtual host va servir ficheros estáticos, en esta sección debemos indicar:
Directorio raíz
Senda de disco local dentro de la cual se situarán los ficheros estáticos del virtual host.
Fichero index
Senda de un fichero html en disco que se cargará cuando se acceda a la URL base del host.
Por ejemplo, si hemos definido un virtual host para el dominio miempresa.com y creamos un fichero índex para el mismo, cuando alguien escriba en un navegador miempresa.com, se cargará el fichero indicado en este parámetro.
Dentro de cada fichero estático podemos configurar diversos alias. El botón nos permitirá añadir un nuevo alias y el botón eliminarlo. De cada alias debemos especificar:
El alias (que debe ir precedido del carácter "/") por ejemplo "/filial1" y su senda, que se corresponderá con una carpeta física del disco.
Página de error
El servicio HTTPS de Velneo vServer permite configurar páginas de error personalizadas para cada Virtual Host. Esta funcionalidad permite mostrar páginas HTML específicas cuando se produce un error HTTP (como 404 - No encontrado, 500 - Error interno del servidor, etc.), mejorando la experiencia del usuario final al proporcionar mensajes de error más amigables y coherentes con el diseño de nuestro sitio web.
El botón (Ctrl + N) nos permitirá añadir una página de error para el virtual host que estemos editando y el botón (Supr) eliminarla.
Los datos que debemos especificar al crear una página de error son:
Status
Código del error HTTP (número entre 0 y 999). Ejemplo: 404 .
Senda fichero HTML
Ruta relativa al documento HTML que se mostrará cuando se produzca ese código de error. El archivo ha de estar en la Velneo\httpserver\htdocs del directorio de trabajo del servidor o en una subcarpeta dentro de ésta.
Si creamos la página de error 404.html en la carpeta, htdocs, en este parámetro especificaremos 404.html . Si la cremos dentro de la carpeta htdocs/errores, en este parámetro especificaremos errorres/404.html.
Funcionamiento
Cuando se produce un error HTTP (por ejemplo, un recurso no encontrado genera un error 404), el servidor verifica si existe una página de error configurada para ese código.
Si existe una página de error configurada, el servidor sirve el contenido del fichero HTML especificado manteniendo el código de estado HTTP original.
Si no existe una página de error configurada para ese código específico en el Virtual Host actual, el servidor busca en la configuración del Virtual Host principal.
Si no se encuentra ninguna página de error configurada, se devuelve la respuesta de error estándar del servidor.
Códigos de error HTTP comunes
Código
Descripción
Uso recomendado
400
Bad Request
Solicitud mal formada
401
Unauthorized
Acceso no autorizado
403
Forbidden
Acceso prohibido
404
Not Found
Recurso no encontrado
500
Internal Server Error
Error interno del servidor
502
Bad Gateway
Error de gateway
503
Service Unavailable
Servicio no disponible
Las páginas de error personalizadas deben estar ubicadas en un directorio accesible por el manejador de ficheros estáticos del Virtual Host.
Si configuramos una página de error que no existe o no es accesible, el servidor devolverá el error original sin contenido personalizado.
Podemos configurar páginas de error en el Virtual Host principal para que actúen como valores por defecto para todos los demás Virtual Hosts que no tengan configuración específica.
Consumo de puestos de ejecución
Cada instancia que se configure consumirá un puesto de ejecución del servidor y admite hasta 64 conexiones concurrentes, si llega a la 65 empezará a consumir 2 puestos de ejecución del servidor ys si llega a 129, consumirá 3 puestos de ejecución.
Iniciar servidor HTTP: inicia el servicio HTTP del el servidor. Al arrancar nos informará sobre el host o hosts que se han iniciado. Ejemplo:
Detener servidor HTTP cola: detiene el servicio HTTP del servidor y nos informará sobre el estado de la operación.
Nuevo virtual host: permite crear y configurar un nuevo host virtual en el vServer.
Eliminar virtual host: permite borrar un host virtual.
Refrescar: refresca la lista de host virtuales del servidor.