Setup execution

SmartDock is not a Windows Service but a small exe file. The reason for this is simple: If it was a Windows service, it would not run as the current user and would then be worthless. It would be impossible to set proxy server settings, change default printer, connect user shares and all other things that are related to the user.

SmartDock is included in the FastTrack Logon zip file. The easiest way to use it is to include a line like this in your prelogon.fsh logon script:
This makes SmartDock execute any time the user logs on, whether the computer is on LAN or not. Since you replicated the script file and the SmartDock executable to the local logon directory with FastTrack Logon, it can also execute without LAN access. The client location from the FastTrackPath function is used, as the SmartDock.exe file is, by default, located in the same client directory as the executing FSH.Exe.

Example script

SmartDock executes a script named "SmartDock.fsh" in the same directory as the SmartDock.exe. In the FastTrack Logon binary folder there is already a template script. All lines are commented out to avoid accidental execution, but the scripts looks like this:
If the server AcmeProxy is reachable, proxy server is set and two shares are connected. If the server is not reachable, all shares are disconnected and the proxy server is disabled to make sure that the user can actually browse the internet outside the company. You could also detect whether the user is on a LAN or not by checking the IP scope. You can expand the script with all sorts of other things specific to your company needs. Remember that the script will also execute on LAN after your logon script, so do not do anything that voids the functionality of the logon script.

Supplement backup script example

This example could be part of a SmartDock script. If the primary backup routine is located in the prelogon.fsh part of the logon script or put as an on-demand backup on the user's desktop, it is a good idea to remind them, if they do not backup their documents within a certain number of days. As we know that SmartDock will eventually fire the script every day, we can check that the backup is recent. The "DoBackup" custom command below stamps the time of the backup to the registry. If there is an additional backup routine in the logon script or as an on-demand desktop icon, this script must set the same registry key. So when a user connects to VPN without a recent backup, the user is asked the question below and answering 'Yes' will refresh the backup.


The script listed below and is a template script to do this. The registry key names "Acme Corporation" should be replaced with your company name. The initial condition tests, if the server "AcmeServer" is reachable. This is to detect, if there is access to the corporate network. This server name must be replaced by a server name that you have on your network, for example the actual target server of the backup.
The script requires version 6.6. For earlier versions, the "Empty" condition must be replaced with a comparison to an empty string and the third parameter to the "Ask" conditions must be removed. The third parameter selects the "Hardrive" icon.

Configuring SmartDock

From version 7 SmartDock comes with a file called SmartDock.xml. This XML file is the configuration file for SmartDock. The reason that the settings are in an XML file instead of using registry keys, is that the settings can then be deployed along the exe file. SmartDock.xml is located in the FTLogon.zip file along the SmartDock.exe file and looks like this by default:
Versions before FastTrack Scripting Host 7 do not have a configuration file and the default settings above are used. The AutoRerun feature did not exist prior to version 7. The purpose of the AutoRerun feature is to get a script executed every once and awhile for desktop computers that are almost always on and rarely logged on and off. The settings explained: