Comandos

Puedes ejecutar comandos en VT-NET para verificar el estado de la plataforma y detectar cualquier problema potencial, así como modificar la forma en la que opera la plataforma. Con estos comandos, puedes realizar una variedad de acciones, como verificar versiones y el estado de los objetos, extraer estadísticas de la plataforma o modificar el estado de los procesos.

A continuación se encuentra una lista de comandos para ejecutar y los pasos a seguir sugeridos en caso de verificar algún tipo de error en la plataforma. También encontrarás una lista de los comandos de Linux más utilizados al final de la página.

Sintaxis del comando

Todos los comandos del sistema tienen una sintaxis específica.

COMMAND object_type {object_name | "<RE>"} [,command_options] [,filter = value]

COMANDO

object_type: Este campo es obligatorio.

NODE
DB
PROC(ESS)
SET(ELLITE)
LINE
STATION
QSER(VICE)

object_name: Objeto sobre el cual se ejecutará el comando. En caso de utilizar una expresión regular, el comando se ejecutará sobre todos los objetos incluidos en la expresión. Este campo es obligatorio.

command_options: Modificadores, atributos o parámetros que mejoran la funcionalidad del comando.

filter: Filtra los objetos sobre los que se ejecutará el comando según el estado, actividad o tipo de proceso o atributo. Indica un valor en este campo para aplicar el filtro. Puedes utilizar expresiones regulares en lugar de los nombres de los objetos, y combinar criterios de filtrado.

[en] You can use regular expressions in some commands. This allows you to describe a chain of strings without detailing every single object.

[en] Regular expression must always go between quotation marks "...", for example, "DH.*". The system admits any standard regular expression.

[en] Symbol	Description	Ejemplo
\|	[en] Alternating constructor	[en] It establishes possible alternatives. For example, when executing a command on "P1DH1\|P1DH2", the command will run over those two objects.
+	[en] Addition constructor	[en] Indicates that the immediate previous character must be present at least once. For example, executing a command on "P1DH+1" will run the command over P1DH1, P1DHH1, P1DHHH1, etc.
?	[en] Quantification constructor	[en] Indicates that the immediate previous character might be present once. For example, when executing the command on "P1DH?1" , the command will run over P1DH1 or P1D1.
*	[en] Quantification constructor	[en] Indicates that the immediate previous character might be present once or infinite times, or might not be present at all. For example, when executing the command on "P1DH*1", the command will run over P1D1, P1DH1, P1DHH1, etc.
()	[en] Parentheses. Grouping constructor	[en] Defines the operator's precedence. For example, "(PRO1\|PRO2)DH" is the same as "PRO1DH\|PRO2DH". [en] Special characters do not lose their meaning when between parentheses.
.	[en] Period	[en] The period character can be replaced by any other character. For example, when executing a command on "P.1DH", the command will run over any object that begins with "P" and ends with "1DH", for example, PA1DH, PB1DH, etc. Note that the command will not run over "PAA1DH", since the period character replaces only one character. If you need to run the command over "PAA1DH", it is necessary to include repetitions with "P.*1DH".
\	[en] Slash	[en] This character is used in combination with other characters. When using "\.", the period character changes its behavior and acts as a literal character. Additionally, this character can grant other characters special meaning: \d: w \s: \D: \W: \S: \A: \Z:
[]	[en] Square brackets	[en] Square backets group characters by class and help search a character among a group of characters. You can use the "-" character to specify a range. Metacharacters lose their meaning when they are between brackets and become literal.
$	[en] Currency	[en] Represents the end of a string of characters. Instead of representing a character, it represents a position. For example, when using the "z$" expression, the command will execute upon all the objects that end with "z".
^	[en] Caret	[en] When used individually, it represents the beginning of a string. For example, when using the "^[a-z]" regular expression, the system will retrieve all the strings that do not begin with uppercase. When used with square brackets, as in "[^\w ]", the expression will retrieve all the characters that are not alphanumeric or a space.
{}	[en] Curly brackets	[en] When used as metacharacters, they need to contain one or more numbers separated by a comma and have to go right after another regular expression. For example, the "\d{2}" regular expression indicates that the command needs to run over objects that contain two digits.

Comandos de estado de la plataforma

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "status object .*"

Entre los objetos de la plataforma se encuentran las líneas, estaciones, procesos, qservices y satélites. Usa este comando para verificar que todos los objetos de la plataforma se estén ejecutando y aparezcan como started.

Este comando muestra una tabla con todos los objetos y su información correspondiente, que incluye: nombre del objeto y tipo de objeto (por ejemplo, si es un proceso o un qservice). La tabla también incluye el estado del objeto y su estado lógico (logical state), que determina el estado del objeto dependiendo del último comando ejecutado sobre él. Por ejemplo, si un usuario detiene el objeto, el estado lógico debería aparecer como stopped. Por último, la tabla muestra los mensajes en cola para ese objeto y el grupo al que pertenece.

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "status proc .*"

Este comando muestra una tabla con todos los procesos y su información correspondiente, que incluye: nombre del proceso, tipo, estado, estado lógico, mensajes en cola y grupo. Para verificar que los procesos estén funcionando, los campos state y logical state deben coincidir siempre y aparecer como started.

Para verificar el estado de un solo proceso, escribe lo siguiente, incluyendo el nombre del proceso:

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "status proc [PROCESS].*"

Usa el modificador ,detail después del último símbolo * en el comando para obtener información detallada, como la versión del proceso.

Ejecuta este comando para verificar el estado de las líneas o estaciones de entrada y salida, qservices o satélites.

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "status [line,station,qservice,sat] .*"

Para verificar el estado de una sola línea, qservicie, satélite o estación, escribe lo siguiente, incluyendo el nombre del objeto.

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "status line,station,qservice,sat [NAME]"

Usa el modificador ,detail después del último símbolo * en el comando para obtener información detallada, como la versión del objeto.

Importante

Debe haber al menos un proceso, una línea y una estación iniciadas en la plataforma para que funcione correctamente.

Ejecuta este comando para verificar la actividad de los procesos, y ver información como los mensajes de entrada, salida, y el máximo de mensajes que hubo en cola.

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "statistics proc [NAME], detail"

Ejecuta el siguiente comando para verificar las estadísticas de las líneas, y ver información como los mensajes de entrada y salida, y el máximo de mensajes que hubo en cola. Esto puede ayudar a detectar errores en las líneas que funcionan como entrada de las transacciones y en las que conectan con los servicios del cliente. Aplica a todo el tráfico entrante a través de los canales (dispositivos) de Veritran, así como a todas las comunicaciones salientes a los diferentes servicios integrados de backend.

/veritran/vt-net/bin/vtNetQShell -e [NVIRONMENT] -n [NODE] -c "statistics line [NAME], detail"

Ejecuta el siguiente comando para verificar las estadísticas de las estaciones, y ver información como los mensajes de entrada y salida, y el máximo de mensajes que hubo en cola. Esto puede ayudar a detectar errores en las estaciones que funcionan como entrada de las transacciones y en las que conectan con los servicios del cliente. Aplica a todo el tráfico entrante a través de los canales (dispositivos) de Veritran, así como a todas las comunicaciones salientes a los diferentes servicios integrados de backend.

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "statistics station [NAME], detail"

Puedes utilizar este mismo comando para verificar también las estadísticas de objetos, qservices y satélites.

ps -ef | grep kernel

Comandos de modificación de estado de la plataforma

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "start [PROCESS].*"

Después de iniciar un proceso, ejecuta el comando status nuevamente para verificar que esta vez aparece como started.

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "stop [PROCESS].*"

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "abort proc [PROCESS].*"

[en] Another variant is to force the abort process command, which is used under more serious platform issues.

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "abort proc [PROCESS].*, force"

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "purge proc [PROCESS].*"

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "warmboot proc .*"

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "warmboot proc [PROCESS].*"

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "stop node .*"

Para detener VT-NET (NDA1), escribe el siguiente comando:

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n NDA1 -c "stop node .*"

/veritran/vt-net/bin/kernel -f /veritran/vt-net/networkDirectory/[ENVIRONMENT]_[NODE].ini

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "run file [file.cmd]"

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "send proc [PROCESS],cmd=[COMMAND]"

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "send proc [PROCESS],cmd=gethelp"

Comandos de versión y configuración

Ejecuta este comando para verificar que VT-NET esté funcionando correctamente, principalmente después de su instalación o de una actualización.

/veritran/vt-net/bin/kernel -V

Este comando muestra la versión de la plataforma como se presenta a continuación:

/veritran/vt-net/bin/kernel -V
Version:     1.13.4.113 (19f7eb5bb2a39e456asde6e55c3644f3df93206a)
URL:       https://repository.veritran.com/package.git - HEAD detached at 1.13.4.113 - 19f7eb5bb2a39e456asde6e55c3644f3df93206a
Tag name:     1.13.4.113
Build Date:    Mon Mar 27 22:28:33 -03 2023
System:      Linux jnlp-slave-redhat-8.-tcwt ..0-26-generic #2-Ubuntu MP Fri ug 26 2:2:7 UC 2022 x86_6 x86_6 x86_6 NU/Linux

Platform Version: 1.13.4.113 (19f7eb5bb2a39e456asde6e55c3644f3df93206a)
URL:       https://repository.veritran.com/package.git - HEAD detached at 1.13.4.113 - 19f7eb5bb2a39e456asde6e55c3644f3df93206a
Tag name:     1.13.4.113
Build Date:    Mon Mar 27 22:25:04 -03 2023
System:      Linux jnlp-slave-redhat-8.5-tc4wt 5.4.-16-generic #14-Ubuntu MP Fri ug 6 1:1:57 UC x86_64 x86_64 x86_64 NU/Linux

Si ejecutas este comando después de realizar una modificación en el sistema, se sugiere verificar también el estado de los objetos para asegurarte de que todo esté funcionando correctamente.

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "info proc [PROCESS].*"

Usa el modificador ,detail después del último símbolo * en el comando para obtener información detallada.

/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "info db .*, detail"

Veritran Docs