Parámetros configurables de Velneo vServer

Los parámetros que indicamos a continuación se configuran en el registro del sistema.

En Windows, se configuran en la rama de registro del servidor:

  • General a la máquina, por ejemplo vServer de 64 bits en máquina de 64 bits:

    • HKEY_LOCAL_MACHINE\SOFTWARE\Velneo\vServer

  • En el usuario system:

    • HKEY_USERS.DEFAULT\Software\Velneo\vServer

  • En el usuario en curso (cuando el servicio VATP está asociado a la cuenta de un usuario y queremos configurar los parámetros para ese usuario, debemos hacerlo en una sesión de Windows de dicho usuario):

    • HKEY_CURRENT_USER\Software\Velneo\vServer

En Linux:

  • General a la máquina, en el fichero /etc/xdg/Velneo/vServer.conf.

  • En un usuario: /home/usuario/Velneo/.config/vServer.conf.

En cloud:

Se configura en el fichero /.config/Velneo/vServer.conf. Para poder editarlo debemos usar el explorador de archivos cloud sftp.

La clave se lee en el arranque del servidor y al parar el servidor se guarda la configuración. Por tanto, para cambiar la configuración requiere tener parado el servidor.

Configurar días de caducidad de contraseña

La entrada se llama PasswordsDays.

Si un usuario se ha configurado para que su contraseña caduque, se entenderá que ésta caducará transcurrido un tiempo. Por defecto son 90 días, pero este tiempo es configurable.

El valor por defecto es 90 (=90 días).

Configurar tiempo de desbloqueo de cuenta

La entrada se llama PasswordsMinWait.

Cuando un usuario intenta conectarse a un Velneo vServer y hace nueve intentos fallidos, el sistema bloquea automáticamente la cuenta. Este parámetro permite configurar el número de minutos que deben trascurrir para que la cuenta sea desbloqueada nuevamente.

Este tiempo de desbloqueo de cuenta, por defecto es de 1 minuto y, si mientras está bloqueada la cuenta el usuario vuelve a introducir unas credenciales erróneas, se incrementará otro minuto más por cada fallo.

El valor por defecto es 1, que equivale a 1 minuto.

Una vez iniciado Velneo vServer podemos comprobar en los mensajes del log de sistema qué valor está tomando.

Configurar timeout para expulsión de enganches inactivos

La entrada se llama ConnectionExpiredSeconds.

Si un enganche de un cliente de ejecución (Velneo vClient, por ejemplo), se ha perdido, en enganche quedará activo en el servidor durante 300 segundos, pero este tiempo es configurable para servidores licenciados (es decir, no es configurable para servidores sin licenciar).

Mediante este parámetro podremos configurar La entrada se llama ConnectionExpiredSeconds y el valor por defecto es 300 segundos. El tiempo debemos indicarlo en segundos. La clave se lee en el arranque del servidor y al parar el servidor se guarda la configuración en el usuario que ejecuta el servidor, de dónde la recogerá de entonces en adelante. Por tanto, para cambiar la configuración requiere tener parado el servidor.

Esta clave no se crea por defecto, debemos crearla nosotros manualmente, al tratarse de un dato numérico, el tipo es DWORD32.

El servidor cuando arranque de nuevo, buscará primero en su usuario, si ahí no tiene valor, entonces buscará en la rama de la máquina. Una vez que lo obtenga de la máquina, se lo guarda en la rama del usuario correspondiente, y lo leerá a partir de entonces ahí.

De esta forma, podemos establecer un valor por defecto inicial, pero siempre tendremos la posibilidad de modificar el dato para un servidor en concreto, si hay más de uno en la máquina.

Una vez iniciado Velneo vServer podemos comprobar en los mensajes del log de sistema qué valor está tomando.

Configurar del nivel de detalle en los mensajes de Velneo vServer (verbose)

Permite configurar el nivel de verbose para registrar eventos realizados por Velneo vServer. Estos eventos serán mostrados en el panel de salida de mensajes de Velneo vAdmin.

La entrada se llama VerboseLevel y contiene un valor entero.

Los valores posibles van de 0 a 8, siendo 0 el valor más bajo detalle y 8 es el valor más alto de detalle.

  • Nivel bajo: 0, 1, 2

  • Nivel medio: 3, 4, 5

  • Nivel alto: 6, 7, 8

Haz clic aquí para conocer con más detalle los tipos de mensaje que se pueden generar.

Una vez iniciado Velneo vServer podemos comprobar en los mensajes del log de sistema qué valor está tomando.

Desactivar la regeneración de índices en paralelo (bigkey)

La entrada se llama ParallelRegenDisabled, es de tipo binario y para desactivarla debemos asignarle un 1 como valor.

Desactiva la regeneración en paralelo (BigKey) en servidores con licencia de subscripción.

Una vez iniciado Velneo vServer podemos comprobar en los mensajes del log de sistema qué valor está tomando.

Incluir un certificado TLS/SSL propio

Esta funcionalidad solamente está disponible en servidores con suscripción. Permite indicar a Velneo vServer que haga uso de un certificado propio cuando se ejecute en modo SSL.

Para ello una vez que dispongamos de nuestro certificado, debemos indicar al sistema la senda de los ficheros correspondientes a la parte pública y la parte privada del mismo.

En Windows: añadir dos valores de cadena:

  • CertificateKey y cuyo valor será la senda completa del fichero crt del certificado fullchain. Ejemplo: C:\crt\micertificado.crt

  • PrivateKey y cuyo valor será la senda completa del fichero key del certificado. Ejemplo: C:\crt\micertificado.key

Certificado fullchain: La cadena de confianza de una cadena de certificados es una lista ordenada de certificados, que contiene un certificado de suscriptor de usuario final y certificados intermedios, que representa la autoridad certificadora (CA) intermedia, que permite al receptor verificar que el emisor y todos los certificados intermedios son de confianza. Más información sobre esto en Wikipedia.

En Linux: añadir los valores en el fichero de configuración vServer.conf de esta manera:

CertificateKey=senda completa arhcivo fullchain  
PrivateKey=senda completa archivo key

Ejemplo:

CertificateKey=/crt/micertificado.crt  
PrivateKey=/crt/micertificado.key

En Velneo Cloud la configuración de certificados es automática y transparente para el usuario.

Si necesitas configurar tu propio dominio de empresa tienes aquí toda la información.

El formato de ambos ficheros debe ser base64.

Podemos comprobar si el fichero del certificado es base64 editándolo en un editor de texto plano (Notepad, Notepad++) y comprobar que tiene el formato siguiente: empieza un con un encabezado -----BEGIN CERTIFICATE-----, terminar con un pie -----END CERTIFICATE----- y entre ambos el texto en base64 del certificado. Ejemplo:

-----BEGIN CERTIFICATE-----
TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQsIGNvbnNlY3RldHV
yIGFkaXBpc2NpbmcgZWxpdC4gSW50ZWdlciB2aXRhZSBibGFu
ZGl0IGxlby4gUGVsbGVudGVzcXVlIHNlZCBzZW0gaW1wZXJka
WV0LCBwb3N1ZXJlIG51bmMgdml0YWUsIHZ1bHB1dGF0ZSBy
aXN1cy4gTmFtIGJsYW5kaXQgdXQgbGVjdHVzIG5lYyB0ZW1wb
3IuIFBlbGxlbnRlc3F1ZSBpYWN1bGlzIGZlbGlzIG5lYyBleCBjb25k
aW1lbnR1bSwgdml0YWUgY29tbW9kbyBsZW8gbWFsZXN1YWR
hLiBEb25lYyBzaXQgYW1ldCBuaWJoIGluIGVuaW0gY29uZGltZW
50dW0gZmF1Y2lidXMuIEluIGRhcGlidXMgc29kYWxlcyBkb2xvciB
hdCBwb3J0dGl0b3IuIEFsaXF1YW0gdXQgYmliZW5kdW0gbGlnd
WxhLg==
-----END CERTIFICATE-----

También podemos comprobar si es correcto con OpenSSL, con el comando:

openssl x509 -in certificate.crt -text -noout

Donde "certificate.crt" lo reemplazaremos con el nombre y la extensión del fichero del certificado.

Podemos comprobar si el fichero de la clave privada del certificado es base64 editándolo en un editor de texto plano (Notepad, Notepad++) y comprobar que tiene el formato siguiente: empieza un con un encabezado -----BEGIN PRIVATE KEY-----, terminar con un pie -----END PRIVATE KEY----- y entre ambos el texto en base64 del certificado. Ejemplo:

-----BEGIN PRIVATE KEY-----
TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQsIGNvbnNlY3RldHV
yIGFkaXBpc2NpbmcgZWxpdC4gSW50ZWdlciB2aXRhZSBibGFu
ZGl0IGxlby4gUGVsbGVudGVzcXVlIHNlZCBzZW0gaW1wZXJka
WV0LCBwb3N1ZXJlIG51bmMgdml0YWUsIHZ1bHB1dGF0ZSBy
aXN1cy4gTmFtIGJsYW5kaXQgdXQgbGVjdHVzIG5lYyB0ZW1wb
3IuIFBlbGxlbnRlc3F1ZSBpYWN1bGlzIGZlbGlzIG5lYyBleCBjb25k
aW1lbnR1bSwgdml0YWUgY29tbW9kbyBsZW8gbWFsZXN1YWR
hLiBEb25lYyBzaXQgYW1ldCBuaWJoIGluIGVuaW0gY29uZGltZW
50dW0gZmF1Y2lidXMuIEluIGRhcGlidXMgc29kYWxlcyBkb2xvciB
hdCBwb3J0dGl0b3IuIEFsaXF1YW0gdXQgYmliZW5kdW0gbGlnd
WxhLg==
-----END PRIVATE KEY-----

También podemos comprobar si es correcto con OpenSSL, con el comando:

openssl rsa -in privateKey.key -check

Donde "privateKey.key" lo reemplazaremos con el nombre y la extensión del fichero de la clave privada del certificado.

Parámetros del servicio

Se trata de parámetros que se han de configurar a nivel de servicio VATP. Se configuran del modo siguiente:

En Windows: para configurar el arranque del servidor en modo seguro es necesario añadir el parámetro en el valor de la clave "ImagePath" de la entrada de registro:

HKEY_LOCAL_MACHINE/SYSTEM/ControlSet001/services/Vatp Service XX.X.XXXX.XXXXX

En Linux: simplemente se incluye este parámetro de arranque.

Estos parámetros son:

Activar log (/log)

Permite generar un log en el directorio del trabajo servidor.

En el log se irán guardando todas las operaciones del protocolo con fecha, hora y texto descriptivo.

Ejemplo de mensaje:

2021-10-21T16:58:13 [INFO] Buscar entre límites Grupo: Ejecución Conexión: 6 Parámetro1: 2-5-5-1358 Parámetro2: ARTICULOS Parámetro3: ID Resultado: Ok InstanciaCodigo: 120 InstanciaId: GESTIONPYME_APP_GESTIONPYME_DAT InstanciaNombre: gestionpyme_app_gestionpyme_dat ProyectoId: 6u65o9bq.vcd ProyectoAlias: gestionpyme_dat ProyectoNombre: gestionpyme_dat Usuario: velneo

Este parámetro solamente se recomienda usarlo en el caso de que en Velneo nos lo recomienden durante el seguimiento de un soporte.

Activar protocolo SSL (/ssl)

Esta funcionalidad solamente está disponible en servidores con suscripción. Permite que la comunicación entre los clientes y el servidor se haga mediante protocolo TLS/SSL.

Para volver a dejar el servicio sin TLS/SSL, simplemente debemos pararlo y quitar el parámetro /ssl.

Configurar puerto de escucha /port

Solamente será necesario configurarlo en el caso de que nuestro servidor vaya a usar un puerto distinto al 690.

Para configurar el puerto de escucha debemos añadir en el parámetro ImagePath del servicio correspondiente, a continuación de la senda del fichero ejecutable de Velneo vServer el parámetro port: /port=nnnn, donde nnnn es el número de puerto por el que queremos acceder al servidor.

Iniciar en modo seguro (/norun)

Esta funcionalidad está orientada a ayudarnos en el caso de que hayamos tenido problemas al arrancar un servidor debido a algún problema con instancias o con un proceso ON_INIT_SERVER.

En modo seguro, el servidor:

  • No arranca las instancias.

  • No permite ejecutar las aplicaciones.

  • No regenera tablas con cambios de estructura.

  • No deshace transacciones incompletas

Cuando el servidor arranca en modo seguro, nos permite:

  • Acceder con vAdmin para administrar el servidor.

  • Revisar y configurar las instancias.

  • Acceder con vDevelop para editar tus aplicaciones.

  • Hacer los cambios que necesites en tus aplicaciones.

Una vez resueltos los problemas de arranque, podemos volver a configurar nuestro servidor en modo normal.

Para volver a dejar el servicio en arranque normal, simplemente debemos pararlo y quitar el parámetro /norun

Esta funcionalidad también está disponible en el panel de control de los servidores del cloud de Velneo.

Activar IPV6 (/ipv6)

Esta funcionalidad está orientada a que Velneo pueda ser usado en redes IPV6.

Para configurarlo debemos añadir en el parámetro ImagePath del servicio correspondiente, a continuación de la senda del fichero ejecutable de Velneo vServer el parámetro /ipv6.

Última actualización