Generate/VShellIcon.gif  Virtual Roots Category

The Virtual Roots category allows you to enable and configure virtual roots.

Virtual Root List

This list displays the available virtual root folder mappings. Each mapping consists of an virtual root path and its corresponding alias.

A virtual root that has an invalid path (one that doesn't exist, for example) will not be accessible to any users.

Upon connecting, the user will be placed in the first available virtual root folder unless the Load the user's environment option (see below) is selected. If there are no virtual roots available to the user, the user will be disconnected.

Add and Edit Buttons

The Add and Edit buttons open the Virtual Root Path dialog where you can add or edit virtual root paths and configure the users and groups assigned to them. Changes made to the virtual root configuration will not take effect until you press either the Apply or OK button.

Use single virtual root

Checking this option will place all defined virtual roots under a single virtual root.

Create %USER% root path when user connects

Checking this option instructs VShell to automatically create a directory for a virtual root for a user when that user connects and the path contains the %USER% substitution parameter.

The permissions for the connecting user will be applied to the newly created directory. The connecting user must have permissions to create directories in the existing "base" directory (the directory before the %USER% portion of the path).

User profiles

This option allows you to select how user profiles are treated. Options are as follows:

Generate/BULLET1.gif    Do not load user profiles: Selecting this option instructs VShell not to load user profiles.

Generate/BULLET1.gif    Load user profiles: Selecting this option adds VSHELL_FILE_HOME and VSHELL_HOME environment variables among others to your choice of home folders.

Note: Selecting this option will increase logon time because each user profile must be loaded in order to read the user's environment variables.

If this option is selected, VShell determines the user's "Home" folder (the folder in which the user is initially placed upon connecting) based on the following criteria (in the following order, first match succeeds):

Generate/BULLET1.gif    VSHELL_FILE_HOME user environment variable, if it exists and is a valid path.

Generate/BULLET1.gif    VSHELL_HOME user environment variable if the VSHELL_SFTP_HOME environment variable does not exist or its value is not a valid path.

Generate/BULLET1.gif    The user's "My Documents" folder, if it exists.

Generate/BULLET1.gif    If the above environment variables do not exist or the values are not valid paths, VShell will place the user in the root of the system drive.

After determining the "Home" folder, if the "Home" folder is not accessible to the user, the user will be placed in the first available virtual root folder. If there are no virtual roots available to the user, the user will be disconnected.

Generate/BULLET1.gif    Load local user profiles: Selecting this option will load the profile if the Windows' system control panel "User Profile" is set as "Local".