The Virtual Directory System
The virtual directory (VD) system allows the administrator to attach any directory or drive to a user account’s root folder. When a client requests the root directory from the server, the VDs you specify are sent to the client. The client can also navigate to any of the VD directories’ subdirectories. The VD system takes care of all path translation.
Security settings can be specified for each virtual directory. All subdirectories under the VD inherit the security settings of the VD.
There are 2 modes that a user account can operate in with respect to the virtual file system. The two modes are simple and standard mode.
Simple Virtual Directory mode
When a user account uses simple directory mode, the administrator can only assign one directory to represent the virtual directory for that user. Instead of that directory being seen as a subdirectory off of the root, the virtual directory selected will be the directory the user is placed in when they first log into the server. In other words, the directory selected as the virtual root directory will be the root directory. A user account is placed in simple directory mode by selecting the Is Simple Directory checkbox for the user account.
Standard Virtual Directory mode
In standard mode (the Is Simple Directory option is un-checked), the administrator may attach as many directories to a user account as desired. The directories selected will appear as subdirectories off of the root directory when the designated user logs into the server.
A Virtual Directory Mode Example
Let’s take a user with one virtual directory called ftproot that maps to C:\ftproot.
In Simple Directory mode, the remote root directory that the user sees, “/“, is mapped directly to C:\ftproot on the server. The actual virtual directory name is ignored (you can think of it as always being named “/“). The user will see all files and folders in C:\ftproot listed in their root directory. They can upload and download files directly into the root directory and they will be uploaded or downloaded to C:\ftproot on the server.
When not in simple directory mode, the root directory “/” doesn’t map to anything. Instead, the root directory “/” becomes a virtual file system that you can attach sub-directories to. When not in simple directory mode, you can add as many virtual directories to a user account as you like, and the virtual directory name will become a sub-directory in the virtual root. However, you have to change to that sub-directory before you can upload or download anything. If you try to upload a file to the root folder “/“, then the operation is invalid because the path “/” doesn’t map directly to a folder on the server. You would need to specify the path /ftproot to upload or download files from the virtual directory ftproot.
Variables that can appear in Virtual Directory Names and Paths
The special variable %USER% can be present in a virtual directory name or path. When present, the %USER% variable is replaced by the user’s username during login.