Description of the SoftGrid Client 3.x registry entries

Article translations Article translations
Article ID: 931247 - View products that this article applies to.
Expand all | Collapse all

On This Page

SUMMARY

Microsoft SoftGrid Client 3.x stores its configuration in the registry. You can gather some useful information about the client if you understand the format of data in the registry. You can also configure many client actions by changing registry entries. This article lists all the SoftGrid client registry keys and explains their uses.

MORE INFORMATION

SoftGrid Client 3.x registry entries

Configuration key location

HKEY_LOCAL_MACHINE\SOFTWARE\Softricity\SoftGrid Client\CurrentVersion\Configuration

Configuration key values

Collapse this tableExpand this table
NameTypeData (Examples)Description
ProductNameStringSoftGrid for Terminal ServersDo not modify.
ClientVersionString3.x.x.xxxDo not modify.
GUIDStringA unique ID generated during installation that is sent to the server to identify the client.
DriversStringSftfs.sysIf present, the name of the driver that caused a stop error last time the core was starting. Can be deleted to let sftlist to start if you have fixed the stop error.
InstallPathStringC:\SoftricityWhere the SoftGrid client is installed. Do not modify.
LogFileNameStringC:\Softricity\sftlog.txtClient log file. Can be modified to change the log file location. You must restart the sftlist service.
LogModuleMaskBinaryFFFF03F03FFF1D1EControls which modules write to the log file. Set to FFF... (16 Fs) for all modules.
LogMinSeverityDWORD3Controls which messages are written to the log. 1-5 are valid. 1 is fatal errors only, 2 is errors and fatal errors, etc. 5 is verbose, meaning everything gets written to the log.
LogContextFlagsDWORD00000207Do not modify this.
AlwaysRunDWORD0 or 1Set under HKCU to determine whether the tray will run at startup and stay running after the last app shuts down (1) or only run when applications are in use (0).
RegisterTypesDWORD0 or 1Whether file types should automatically be registered with Windows. Use Options Dialog to modify.
OSDCacheStringC:\Softricity\OSD CacheWhere the OSD files are cached. Should not be modified.
UserDataDirectoryStringC:\SoftGridData\%UserName%Path where the SoftGrid Client stores user specific data. Can include environment variables. Note that this is set once per machine, not per user. Therefore, include a variable that makes it per user.
GlobalDataDirectoryStringC:\Documents and Settings\All Users\Documents\Path where the SoftGrid Client stores global SoftGrid data, including caches for OSD files, icon files, shortcut information, and SystemGuard resources (such as .ini files). Available in 3.0 SP2 and above.
IconCacheStringC:\Softricity\Icon CacheWhere icons are cached. Should not be modified.
ShortcutsStringC:\Softricity\shortcuts.datPath to the file where published shortcuts can be tracked and deleted when applications are removed. Can be moved and modified when the sftlist is stopped.
AllowCrashesDWORD0 or 10 by default. When a crash occurs:
0 - the SoftGrid client continues operation even when a crash occurs
1 - Allow crashes to occur, a debug dr watson log will be created
KillHungThreadsDWORD300Time in seconds that the client should wait before it kills a thread it thinks has stopped responding. 0xFFFFFFFF means never kill, 0 means kill immediately. Do not modify.
MaxClientWorkerThreadsDWORD32Maximum number of worker threads the client will allow in its thread pool. You must restart sftlist if you change this. Do not modify.
InitialClientWorkerThreadsDWORD8Initial number of worker threads the client will create in its thread pool. You must restart sftlist for this to take effect. Do not modify.
CoreInternalTimeoutDWORD15Timeout in seconds for internal IPC requests between core and front-end. Do not modify.
CoreShortTimeoutDWORD30Timeout in seconds for IPC requests between the core and front-end that are typically quick (such as retrieving a program name. Do not modify.
CoreMediumTimeoutDWORD60Timeout in seconds for IPC requests between the core and front-end that may take a short time to finish. For example, shutting down an program. Do not modify.
CoreLongTimeoutDWORD120Timeout in seconds for IPC requests between the core and front-end that may take a long time to finish. For example, updating from a MIME server). Do not modify.
DCCSeamlessTimeoutDWORD30In a seamless session, time in seconds that the DCC (Desktop Configuration Control) process will remain open after the last application closes.
DCCInitialSeamlessTimeoutDWORD30In a seamless session, time in seconds the DCC (Desktop Configuration Control) process will remain open when there are no applications. This refers to instances when a front-end component starts DCC because a program is about to be launched.
DCCInitTimeoutDWORD60Controls how long the client core will wait for the DCC to initialize before stopping requests to connect front-end components or to do a MIME update. Defaults to 60 seconds. Cannot be set below 10 seconds.
MonitorNetworkActivityDWORD0 or 1Turn the SoftGrid system tray icon network activity light on (1) or off (0).
TrayErrorDisplayDelayDWORD30Time in seconds that the SoftGrid system tray will display error messages like "Launch failed".
TraySuccessDisplayDelayDWORD10Time in seconds that the SoftGrid system tray will display success messages like "Word launched" or "Excel shut down". If 0, those messages will be suppressed.
AppListSharedTimeoutDWORD15Timeout for acquiring a commonly-used internal resource. Do not modify.
AppListExclusiveTimeoutDWORD30Timeout for acquiring a commonly-used internal resource. Do not modify.
DefaultSuiteCombineTimeDWORD10If COMBINEAPPS is not in an OSD file, this value is used to indicate how soon after open a program can shut down and not generate any error messages when another application in the same suite is running.
SerializedSuiteLaunchTimeoutDWORD10How long the client will wait as it tries to serialize program starts in the same suite. If the client times out, the program start will continue, but it will not be serialized.
PublishShortcutsToDesktopDWORD0 or 1Automatically publish shortcuts to the user's desktop (if under HKCU) or to each user's desktop (if under HKLM) if set to 1.
PublishShortcutsToStartMenuDWORD0 or 1Automatically publish shortcuts to the user's Start menu (if under HKCU) or to each user's start menu (if under HKLM) if set to 1.
ScriptTimeoutDWORD300 Default timeout in seconds for scripts in .osd file if WAIT=TRUE. Can specify per-script timeouts with TIMEOUT instead of WAIT. 0 means wait forever.
DumpPathStringC:\Softricity\DumpsDefault path to create minidumps when exceptions occur.
DumpPathSizeLimitDWORD1000Default maximum size in megabytes of which the total space used by the minidumps that are created.
LaunchRecordLogPathStringC:\Softricity\usage.txtIf set in the registry (HKLM or HKCU), SFTTray will write to this log when program start, shut down, fail to launch, and then enter and exit disconnected mode. If a path is not specified in the registry, no logging occurs. Only applies to SP2 and beyond.
LaunchRecordMaskDWORD0x1A (26) would produce log messages for launch errors and MDO activity.
0x1F (31) logs everything.
0x0 (0) logs nothing.
Can control which of the 5 events are logged: 1 for launches, 2 for launch errors, 4 for shutdowns, 8 for entering disconnected mode, and 16 for reconnecting to a server. Add any combination of those numbers to turn on the respective messages. 0 turns everything off; 0xFFFFFFFF turns everything on. Defaults to 0xFFFFFFFF if not in registry. Only applies to SP2 and beyond.
LaunchRecordWriteTimeoutDWORD3000Specifies in milliseconds how long the tray will wait when trying to write to the launch record log in if another process is using it. Defaults to 3000 ms. Only applies to SP2 and beyond.
ImportSearchPathStringd:\files\;C:\documents and settings\user1\SFTsA semi-colon delimited list of up to 5 directories to search for portable SFT files before bothering to prompt the user to select a directory. Trailing back slash in paths is optional. Not present by default. Must be set manually.

Applies to version 3.1
UnspecifiedStringD:\SFTs\The last location the user browsed to while locating an SFT for package import. Set automatically if the SFT is found successfully. Used on successive imports in attempt to automatically locate SFTs.

Applies to version 3.1
Patch LevelStringHotfix 100String value representing the Hotfix release applied to the system.

Applies to version 3.1
LastMiniDumpLoggedBinaryContains a binary timestamp indicating the time on the last minidump the client mentioned in the message it logs when it starts up. Do not modify.

Applies to version 3.1
AllowDisconnectedOperationDWORD0 or 1Determines if the client is allowed to go in to Minimal Disconnected Operation (MDO) mode:
0 - No
1 - Yes
DOTimeoutMinutesDWORD0x78 (120 minutes)Allows the client to run applications in Minimal Disconnected Operation (MDO) for the amount of minutes specified. Maximum time is 45 days (0x278D0)

Network key

The Network key controls a variety of network-related parameters. This key is primarily used by the network transport agent.

Network key location

HKEY_LOCAL_MACHINE\SOFTWARE\Softricity\SoftGrid Client\CurrentVersion\Network

Network key values

Collapse this tableExpand this table
NameTypeData (Examples)Description
BandwidthDWORD0x10Tell the server whether connecting is over a modem or LAN so it can optimize stream rate. Configure in Options Dialog. This value only applies to version 3.0 of the SoftGrid Client. This value should not be modified in version 3.1 or in later versions of the SoftGrid Client.
ProtocolDWORD0x8Default protocol to use (TCP vs SSL). Configure in Options Dialog
HTTPProxyNameStringproxy.softricity.intName of a proxy server. Configure in Options Dialog
HTTPProxyPortDWORD8080Port on the proxy server to use. Configure in Options Dialog
HTTPUseProxyDWORD0 or 1Whether to use the HTTP proxy. Configure in Options Dialog
RTSPProxyNameStringproxy.softricity.intName of RTSP proxy server. Configure in Options Dialog
RTSPProxyPortDWORD5054Port on RTSP proxy server to use. Configure in Options Dialog
RTSPUseProxyDWORD0 or 1Whether to use an RTSP proxy server. Configure in Options Dialog
ReadTimeoutDWORD30Read timeout for network transactions, in seconds. Do not modify.
WriteTimeoutDWORD30Write timeout for network transactions, in seconds. Do not modify.
ConnectTimeoutDWORD30Connect timeout for network transactions, in seconds. Do not modify.
HTTPRetryLimitDWORD3How many times to retry an HTTP transaction before giving up.
RTSPRetryLimitDWORD3How many times to retry an RTSP transaction before giving up.
ReestablishmentRetriesDWORD3How many times to try to reestablish a dropped session.
ReestablishmentIntervalDWORD15How long to wait between tries to reestablish a dropped session, in seconds.

File system key

The values that are the AppFS key control the file system parameters for SoftGrid.

File system key location

HKEY_LOCAL_MACHINE\SOFTWARE\Softricity\SoftGrid Client\CurrentVersion\AppFS

File system key values

Collapse this tableExpand this table
NameTypeData (Examples)Description
FileSizeDWORD500Maximum size in megabytes of file system cache file. If changing in registry, must set State to 0 and reboot.
FileNameStringC:\Softricity\sftfs.fsdLocation of file system cache file. If changing in registry, must either leave size the same and reboot, or set State to 0 and reboot.
CSRSectorSizeDWORD512Do not modify.
STRSectorSizeDWORD4096Do not modify.
DriveLetterStringQ:Drive where SoftGrid file system will be mounted.
StateDWORD0x100State of file system. Set to 0 and reboot to completely clear FS cache.
FileSystemStorageStringC:\Profiles\Joe\SGPath for symlinks, set under HKCU. Do not modify (use data directory under Configuration to change).
GlobalFileSystemStorageStringC:\Softricity\GlobalFSPath for global FS data. Do not modify.
UniqueIdDWORD7Unique ID number for each user, set under HKCU, matches what is under the User key. Do not modify.
MaxPercentToLockInCacheDWORD90Restricts more than the specified percentage of the "FileSystem cache file" from being locked. Do not modify.

Permissions key

The Permissions key lets you enable and disable some actions for non-administrative users. Notice that this is not a secure system. If users can edit their own registries, they can give themselves any of these permissions. This key is primarily designed to stop users from making mistakes. For example, this key is designed to prevent users from accidentally unloading programs. This key is not designed to help secure any part of the SoftGrid Client.

The Permission Key settings control all interfaces that enable the named actions. This includes the Options Dialog, SFTTray, and SFTMime. These settings do not affect administrators.

Permissions key location

HKEY_LOCAL_MACHINE\SOFTWARE\Softricity\SoftGrid Client\CurrentVersion\Permissions

Permissions key values

Collapse this tableExpand this table
NameTypeData (Examples)Description
RemoveAppDWORD0Does not allow a user to remove personal settings, shortcuts, file type associations, and symbolic links.
1Allows user to remove personal settings, shortcuts, file type associations, and symbolic links (and not completely remove the application from cache for all users). This is the default for Terminal Servers and Windows Desktops.
RemoveAppCompleteDWORD0Does not allow a user to completely remove an application from cache.

Applies to version 3.1
1Allows a user to completely remove an application from cache.
LoadAppDWORD0Does not allow a user to load an application. This is the default for Terminal Servers.
1Allows a user to load an application. This is the default for Windows Desktops.
UnloadAppDWORD0Does not allow a user to unload an application.
1Allows a user to unload an application.
LockAppDWORD0Does not allow a user to lock and unlock an application. This is the default for Terminal Servers.
1Allows a user to lock and unlock an application. This is the default for Windows Desktops.
ManageTypesDWORD0Does not allow a user to add, edit, and remove file type associations for that User alone. This is the default for Terminal Servers.
1Allows a user to add, edit, and remove file type associations for that user only and not globally. This is the default for Windows Desktops.
RefreshServerDWORD0Does not allow a user to trigger a refresh of MIME settings. This is the default for Terminal Servers.
1Allows a user to trigger a refresh of MIME settings. This is the default for Windows Desktops.
ImportAppDWORD0Does not allow a user to import applications into cache.

Applies to version 3.1
1Allows a user to import applications into cache.

Properties

Article ID: 931247 - Last Review: November 5, 2007 - Revision: 3.2
APPLIES TO
  • Microsoft SoftGrid for Terminal Services
  • Microsoft SoftGrid for Windows Desktops
Keywords: 
kbexpertiseinter kbtshoot KB931247

Give Feedback

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com