Configuring the Sandbox : Introduction to the Sandbox

Introduction to the Sandbox
The sandbox holds runtime modifications that applications make as they are running. The original executable that you built never changes, so it can be placed in a shared folder with read-only access.
The name of a sandbox (SANDBOXNAME) is specified in the package.ini file prior to build (Package.ini format).
Under normal circumstances, the sandbox is stored under %AppData%\Thinstall\SANDBOXNAME. On Windows XP this path is C:\Documents and Settings\USERNAME\Application Data\SANDBOXNAME.
During startup, VMware Project North Star (Thinstall) searches for an existing Sandbox in the following locations in the order listed below. If a sandbox already exists, VMware Project North Star (Thinstall) uses the existing sandbox rather than creating a new one.
Search using an application-specific environment variable
1
Example: If SANDBOXNAME=“Mozilla Firefox 1.0" the environment variable “Mozilla Firefox 1.0_SANDBOX_DIR.ComputerName” is consulted.
2
Search using a global environment variable that applies to all Thinstalled applications
3
Example: THINSTALL_SANDBOX_DIR.ComputerName
4
Search for an application-specific ‘local’ sandbox
5
6
Search for a ‘local’ sandbox for all Thinstalled applications
7
8
Use the value “SandboxPath=” from Package.ini to determine a custom sandbox path this option is set (SandboxPath)
9
10
Search in the user’s “Application Data\Thinstall” folder for a sandbox
11
12
If an existing sandbox cannot be found, Thinstall creates a new sandbox. VMware Project North Star (Thinstall) creates a new sandbox using the following logic:
1
2
3
If SANDBOXPATH Package.ini option is set, try to create a sandbox at this location.
4
Try to create a sandbox in the user %AppData%\Thinstall folder.
 
Example Scenarios:
Scenario:
I want to run from USB flash and have my sandbox load and save to the same directory where the executable is located.
How to accomplish:
Set “SandboxPath=.” in your package.ini file in the [BuildOptions] section. (SandboxPath).
Scenario:
My users have a mapped drive to store their files and I want the sandbox stored on the mapped drive.
How to accomplish:
Option 1. Use “SandboxPath=z:\Sandbox” if the drive is always mapped to the same letter (SandboxPath).
Option 2. In the user login script, set the environment variable THINSTALL_SANDBOX_DIR=z:\Sandbox. Any Thinstalled application run after setting this variable uses z:\Sandbox for its sandbox storage location.