Administrator's Guide - Kerio Software Archive

Administrator's Guide - Kerio Software Archive Administrator's Guide - Kerio Software Archive

download.kerio.com
from download.kerio.com More from this publisher
30.01.2015 Views

Network interfaces connection will not be recovered. • In mode of on-demand dial (i.e. outside the intervals defined), connection will be recovered in response to the first request (i.e. packet sent from the local network to the Internet). Automatic hangup when idle Dial-ups are usually charged by connection time. When no data are transferred via the connection, there is no reason to keep the link up. Therefore, it is possible to set also idleness time after which the link will be hung-up automatically. For optimal idleness timeout length, it is necessary to know how the Internet connection is charged in the particular case. If the idleness timeout is too short, it may result in too frequent hanging up and dialing of the link which might be very uncomfortable and in certain cases even increase connection costs. Note: In the time interval where persistent connection of the link is set (see above), the idleness timeout is ignored. 5.6 Supportive scripts for link control (Windows) In some cases there is a special need of running a program or a script (execute a batch command) along with dialing or hanging up a link. This can be helpful for example if a special type of modem is used that must be controlled by a special program provided by its developers. Kerio Control allows launching any program or a command in the following situations: Before dial, After dial, Before hang-up or/and After hang-up. In case of the Before dial and Before hang-up options, the system does not wait for its completion after startup of the program. Figure 5.4 Dial-up — external commands Scripts for control of dial-ups must be located in the scripts subdirectory of the firewall’s installation directory, typically C:\Program Files\Kerio\WinRoute Firewall\scripts (Attention! This directory does not exist in the default installation — it is therefore necessary to create it!). 58

5.6 Supportive scripts for link control (Windows) The script names must have the following names: • BeforeDial.cmd — before dial, • AfterDial.cmd — after dial, • BeforeHangup.cmd — before hangup, • AfterHangup.cmd — after hangup. Each script first accepts the parameter of full name of the connection currently being dialed or hung up (name in the Kerio Control interface). Possible errors (e.g. if you allow an action but the particular script does not exist) are recorded in the Error log (see chapter 22.8). Note: If the name of the dial-up includes blanks, it will be automatically put in quotes upon the script call, which guarantees correct transmission of the full name in an only parameter of the script. However, it is more suitable to use names without blanks and diacritics for dial-ups. Interfaces in Kerio Control can be renamed any time needed. Warning: On Windows, Kerio Control is running as a service. Therefore, external applications and operating system’s commands will run in the background only (in the SYSTEM account). The same rules are applied for all external commands and external programs called by scripts. Therefore, it is not highly unrecommended to use interactive applications (i.e. applications with user interaction) for the actions described above. Interactive application would be running “in background” until the system restart or killing of the particular process. Under specific circumstances, such application might also block other dials or hang-ups. In the Software Appliance / VMware Virtual Appliance edition, supportive scripts for dial-ups are not supported. 59

5.6 Supportive scripts for link control (Windows)<br />

The script names must have the following names:<br />

• BeforeDial.cmd — before dial,<br />

• AfterDial.cmd — after dial,<br />

• BeforeHangup.cmd — before hangup,<br />

• AfterHangup.cmd — after hangup.<br />

Each script first accepts the parameter of full name of the connection currently being dialed<br />

or hung up (name in the <strong>Kerio</strong> Control interface).<br />

Possible errors (e.g. if you allow an action but the particular script does not exist) are recorded<br />

in the Error log (see chapter 22.8).<br />

Note: If the name of the dial-up includes blanks, it will be automatically put in quotes upon the<br />

script call, which guarantees correct transmission of the full name in an only parameter of the<br />

script. However, it is more suitable to use names without blanks and diacritics for dial-ups.<br />

Interfaces in <strong>Kerio</strong> Control can be renamed any time needed.<br />

Warning:<br />

On Windows, <strong>Kerio</strong> Control is running as a service. Therefore, external applications and<br />

operating system’s commands will run in the background only (in the SYSTEM account). The<br />

same rules are applied for all external commands and external programs called by scripts.<br />

Therefore, it is not highly unrecommended to use interactive applications (i.e. applications<br />

with user interaction) for the actions described above. Interactive application would be<br />

running “in background” until the system restart or killing of the particular process. Under<br />

specific circumstances, such application might also block other dials or hang-ups.<br />

In the <strong>Software</strong> Appliance / VMware Virtual Appliance edition, supportive scripts for dial-ups<br />

are not supported.<br />

59

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!