Commands
You can execute commands on VT-NET to verify the platform's health and detect any potential issue, as well as modify the way the platform operates. With these commands, you can perform a range of actions, including checking versions and objects status, retrieving platform's statistics, or modifying processes status.
See below for a list of commands to execute and, should you run into any kind of error in the platform, find the suggested next steps. You can also find a list of the most frequently used Linux commands at the end of the page.
Status Commands
/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "status object .*"
Objets in the platform include lines, stations, processes, qservices and satellites. Run this command to verify all object's in the platform are running and appear as started. This command displays a table with all the objects and their respective information, which includes: object name, type, state, logical state, messages queued and group.
This command can also be used to retrieve an object's version.
/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "status proc .*"
This command displays a table with all the processes and their respective information, which includes: process name, type, state, logical state, messages queued and group. To verify that processes are operating, state and logical state must always match and appear as started.
To verify the state of a single process, type the following:
/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "status proc [PROCESS].*"
Use the ,detail modifier after the last * symbol in the command to obtain detailed information.
/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "status [line,station,qservice,sat] .*"
To verify the state of a single line, qservice, satellite or station, type the following:
/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "status line,station,qservice,sat [NAME]"
Use the ,detail modifier after the last * symbol in the command to obtain detailed information.
Important
There should be at least one process, one line and one station started on the platform for it to work correctly.
Execute this command to verify the processes' activity.
/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "statistics proc [NAME], detail"
Execute the following command to verify errors on the lines that function as an entry for transactions (DH) and on the lines that connect to client’s services. This applies to all incoming traffic through Veritran channels (devices), as well as all outgoing communication to the different integrated backend services.
/veritran/vt-net/bin/vtNetQShell -e [NVIRONMENT] -n [NODE] -c "statistics line [NAME], detail"
Execute the following command to verify errors on the stations that function as an entry for transactions (DH) and on the stations that connect to client’s services. This applies to all incoming traffic through Veritran channels (devices), as well as all outgoing communication to the different integrated backend services.
/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "statistics station [NAME], detail"
You can use this same command to also verify objects, qservices and satellites' statistics.
ps -ef | grep kernel
Status Modification Commands
/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "start [PROCESS].*"
After initiating a process, run the status command again to verify this time it appears as 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].*"
/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 .*"
To stop VT-NET (NDA1), type the following command:
/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"
Version and Configuration Commands
Execute this command to verify that VT-NET is working correctly, mostly after installation or after an update.
/veritran/vt-net/bin/kernel -V
This command displays the platform's version as shown below:
/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
If you are executing this command after a modification in the system, it is suggested to also verify objects' status to make sure everything is working correctly.
/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "info proc [PROCESS].*"
Use the ,detail modifier after the last * symbol in the command to obtain detailed information.
/veritran/vt-net/bin/vtNetQShell -e [ENVIRONMENT] -n [NODE] -c "info db .*, detail"
Linux Commands
Find below a set of commonly used Linux commands. Keep in mind that this list may not be final. For more Linux commands, check Linux documentation.
df -h du -h
free -m
top
gtar -cvzf [FILENAME].tgz /[FILESPATH]/*
gtar -cvzf [FILENAME].tgz --exclude='/EXCLUDEDFILESPATH/*' /INCLUDEDFILESPATH/
gtar -xvzf [FILENAME].tar.gz
cp /dev/null /veritran/[NODE]/vt-net/log/XXXX_NDA1.log
find /veritran/ -name 'config.php'
scp [FILENAME] remote_user@remote_server_ip:/[REMOTESERVER]
scp remote_user@remote_server_ip:/[REMOTEFILEPATH] /[LOCALPATH]
wget http://file-url