VISULOX 4 Documentation

Script objects

System side scripts can be assigned to Command Guard and can be issued
to the terminals at any time. As long the terminals belong to the group.

RDP configuration files can be assigned as well to freerdp sessions.
RD Gateway authentication with common users is supported.


scriptobject.jpg

Command Guard system side shell scripts

In Command Guard, it is possible to start such scripts in a single shell or in all connected shells at once.
Script category must be set to GUARD.

scriptobjectGUARD.jpg

The script size is limited to 40 KB.

The size and the type of the script is configured here:

visulox config -name scriptobject.guard
    ----------------------------------------------
    | changed | key                     | value  |
    ----------------------------------------------
    |         | scriptobject.guard.size | 40.0kB |
    |         | scriptobject.guard.type | text   |
    ----------------------------------------------


Assigning scripts to a Command Guard group

image2021-3-12_12-28-37.png

Available scripts can be attached / detached from the Command Guard group.

Script writing rules

A script is a list of lines. Mostly they are representing shell scripts.

For example:

Script

echo

here

date

uptime

ntpq -p

Output

# echo here

here

#  date

Tue Jan 12 17:15:53 CET 2016

#  uptime

 17:15:53 up 25 days,  2:36,  9 users,  load average: 0.20, 0.20, 0.22

#  ntpq -p

     remote           refid      st t when poll reach   delay   offset  jitter

==============================================================================

*xyz.tbsol.de     144.23.187.145   3 u  568 1024  377    0.862   -2.353   1.428

+xxx.tbsol.de    172.10.1.1      12 u   35 1024  377    0.458  -15.297  16.387

#


It would be better to put the commands into brackets:

Script

(

  echo

here

  date

  uptime

  ntpq -p

)

Output

# (

echo

here

date

>  uptime

>  ntpq -p

> )

here

Tue Jan 12 17:06:36 CET 2016

 17:06:36 up 25 days,  2:27,  9 users,  load average: 0.28, 0.25, 0.24

     remote           refid      st t when poll reach   delay   offset  jitter

==============================================================================

*xyz.tbsol.de     144.23.187.145   3 u   11 1024  377    0.862   -2.353   1.428

+xxx.tbsol.de    172.10.1.1       4 u  560 1024  377    0.296  -12.838  14.940

# uptime

 17:06:49 up 25 days,  2:27,  9 users,  load average: 0.32, 0.26, 0.24

[root@tab-ol6u4-sgd1-510 ~]#

RDP configuration files

In a vlxshell application, it is possible to use such a script for the freerdp connection.

Script category must be set to RDP.

scriptobjectRDP.jpg

The script size is limited to 4 KB.

The size and the type of the script is configured here:

visulox config -name scriptobject.rdp
    -------------------------------------------
    | changed | key                   | value |
    -------------------------------------------
    |         | scriptobject.rdp.size | 4.0kB |
    |         | scriptobject.rdp.type | ASCII |
    -------------------------------------------

vlxshell application with freerdp configuration file

RDPapp.jpg

In this example a preconfigured VISULOX resource is used for the credentials of the RDP connection.


vlxshell parameters in "Arguments for Command":

-client freerdp -rdpfile <scriptname|filename> -- <freerdp-parameter>


vlxshell parameters with RD Gateway configuration:

-client freerdp -rdpfile RDP -resource <resource-name> -gateway-resource <resource-name> /g:<server.domain> /gateway-usage-method:direct


To add an existing RDP file to the VISULOX Cluster, use:

visulox addon script add -name RDP -category rdp -script /tmp/testfile.rdp 


For more RDP connection events, set:

visulox config -name vlxshell.event.rdpconnect=true


See also: How to configure FreeRDP for VISULOX PORTAL