Command-line parameters for SoftGrid Client 3.x

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

On This Page

SUMMARY

This article describes the command-line installation parameters for SoftGrid Client 3.x.

MORE INFORMATION

The following SoftGrid command-line parameters are available for the .exe and .msi SoftGrid Client installer files.
Collapse this tableExpand this table
ParameterValue(s)Description
SWICACHESIZEcache size in MBThis parameter specifies the size in megabytes of the SoftGrid Client's cache. The default size is 4096 MB. The maximum size is 65,535 MB, disk space permitting.

An example of this is SWICACHESIZE="1024".
SWIDCSDISPLAYdisplay nameThis parameter specifies the name of the Desktop Configuration Server that is displayed in the Options dialog box. This parameter is required when SWIDCSHOST is used.

An example of this is SWIDCSDISPLAY="Production Environment".
SWIDCSTYPE[HTTP|SoftGrid|UDDI]This parameter specifies the type for this Desktop Configuration Server. The default type is "SoftGrid."

HTTP: Standard HTTP Server
SoftGrid: SoftGrid Virtual Application Server
UDDI: Standard UDDI Server

An example of this is SWIDCSTYPE="HTTP".
SWIDCSHOSTIP address or host nameThis parameter specifies either the IP address of this Desktop Configuration Server or a host name of this server that will resolve into this server's IP address. This parameter is required when SWIDCDISPLAY is used.

An example of this is SWIDCSHOST="SGSERVER01".
SWIDCSPORTport numberThis parameter specifies the logical port that is used by this Desktop Configuration Server to listen for requests from the SoftGrid Client. The default port is 554.

An example of this is SWIDCSPORT="80".
SWIDCSPATHpath nameThis parameter specifies the location on this Desktop Configuration Server of the file that defines file type associations. The default is /. This parameter is required when the value for SWIDCSTYPE is HTTP.

An example of this is SWIDCSPATH="/SoftGrid/appsntypes.xml".
SWIDCSREFRESH[on|off]This parameter specifies whether the SoftGrid Client automatically queries the source of desktop configuration information for file type associations and for applications when a user logs on to the SoftGrid Client. The default setting is "on."

An example of this is SWIDCSREFRESH="off".
SWIPUBLISHDESKTOP[true|false]Shortcuts may be newly available to the SoftGrid Platform. This parameter specifies whether these shortcuts will be published automatically to the Windows Desktop when a user logs on to the client computer and then performs one of the following actions:

Starts the SoftGrid Client

Updates desktop configuration information

Starts an application for the first time

Adds an application in the Options dialog box. The application may be added by using SFTMIME, and may be loaded together with SFTTRAY. The default setting is "false."

An example of this is SWIPUBLISHDESKTOP="true".
SWIPUBLISHSTART[true|false]Shortcuts may be newly available to the SoftGrid Platform. This parameter specifies whether these shortcuts will be published automatically in the Windows Start menu when a user logs on to the client computer and then performs one of the following actions:

Starts the SoftGrid Client

Updates desktop configuration information

Starts an application for the first time

Adds an application in the Options dialog box. The application may be added by using SFTMIME, and may be loaded together with SFTTRAY. The default setting is "false."

An example of this is SWIPUBLISHSTART="true".
SWISKIPDATASETTINGS[true|false]This parameter specifies whether the SoftGrid Data Location page will be suppressed. On the Location page, the user can change the default storage locations for the client’s computer-wide and user-specific data. The default setting is "true."

An example of this is SWISKIPDATASETTINGS="false".
SWIGLOBALDATAglobal data directoryThis parameter specifies the directory where data that is not specific to particular users will be stored. The default directory is C:\Documents and Settings\All Users\Documents\.

An example of this is SWIGLOBALDATA="D:\SoftGrid\Global".
SWIUSERDATAuser data directoryThis parameter specifies the directory where data that is specific to particular users will be stored. The default directory is %APPDATA%.

Note Softricity has not implemented full support for the Microsoft Windows Installer. The /f (repair), /a (administrative installation), /j (product advertising), and /p (patching) switches are not available.

An example of this is SWIUSERDATA="H:\Windows\SoftGrid Client".
The following table describes frequently used MSI parameters.
Collapse this tableExpand this table
ParameterValue(s)Description
INSTALLDIRpath nameThis parameter specifies the installation directory of the SoftGrid Client.

An example of this is INSTALLDIR="D:\Program Files\Softricity".
REINSTALLfeature name
ALL
An example of this is REINSTALL=ALL.
REINSTALLMODE p, o, e, d, c, a, u, m, s, vAn example of this is REINSTALLMODE=vomus.

Examples of how the parameters are used

The .msi file

The following example uses the .msi file. Notice that the Windows Installer /q switch is used to make this a silent installation.

Additionally, notice that the percent (%) characters in "%HomeDrive%" are preceded by the caret (^) character . If the percent characters were not preceded by the caret character, the Windows command shell would set the value between the percent characters to the value of the user who is performing the installation.
Msiexec.exe /i "softgrid-ts-setup.msi"
SWICACHESIZE="1024"
SWIDCSDISPLAY="Production Environment"
SWIDCSTYPE="HTTP"
SWIDCSHOST="OSFSGS"
SWIDCSPORT="80"
SWIDCSPATH="/SoftGrid/appsntype.xml"
SWIDCSREFRESH="on"
SWIPUBLISHDESKTOP="true"
SWIPUBLISHSTART="true"
SWISKIPDATASETTINGS="false"
SWIGLOBALDATA="D:\SoftGrid\Global"
SWIUSERDATA="%HomeDrive%\Windows\SoftGrid Client" /q
Important Line breaks were added to this example for legibility. If you use this command, make sure that you enter the text as one long string, as follows:
Msiexec.exe /i "softgrid-ts-setup.msi" SWICACHESIZE="1024" SWIDCSDISPLAY="Production Environment" SWIDCSTYPE="HTTP" SWIDCSHOST="OSFSGS" SWIDCSPORT="80" SWIDCSPATH="/SoftGrid/appsntype.xml" SWIDCSREFRESH="on" SWIPUBLISHDESKTOP="true" SWIPUBLISHSTART="true" SWISKIPDATASETTINGS="false" SWIGLOBALDATA="D:\SoftGrid\Global" SWIUSERDATA="%HomeDrive%\Windows\SoftGrid Client" /q

The .exe file

The following example uses the .exe file. Notice that the InstallShield /s switch is used to make this a silent installation.

Additionally, notice that the quotation marks that are contained in the /v"" section must be treated as special characters and must be entered as \".
"Softgrid-ts-setup.exe" /s /v"SWICACHESIZE=\"1024\"
SWIDCSDISPLAY=\"Production Environment\"
SWIDCSTYPE=\"HTTP\"
SWIDCSHOST=\"OSFSGS\"
SWIDCSPORT=\"80\"
SWIDCSPATH=\"/SoftGrid/appsntype.xml\"
SWIDCSREFRESH=\"on\"
SWIPUBLISHDESKTOP=\"true\"
SWIPUBLISHSTART=\"true\"
SWISKIPDATASETTINGS=\"false\"
SWIGLOBALDATA=\"D:\SoftGrid\Global\"
SWIUSERDATA=\"^%HomeDrive^%\Windows\SoftGrid Client\""
Important Line breaks were added to this example for legibility. If you use this command, make sure that you enter the text as one long string, as follows:
"Softgrid-ts-setup.exe" /s /v"SWICACHESIZE=\"1024\" SWIDCSDISPLAY=\"Production Environment\" SWIDCSTYPE=\"HTTP\" SWIDCSHOST=\"OSFSGS\" SWIDCSPORT=\"80\" SWIDCSPATH=\"/SoftGrid/appsntype.xml\" SWIDCSREFRESH=\"on\" SWIPUBLISHDESKTOP=\"true\" SWIPUBLISHSTART=\"true\" SWISKIPDATASETTINGS=\"false\" SWIGLOBALDATA=\"D:\SoftGrid\Global\" SWIUSERDATA=\"^%HomeDrive^%\Windows\SoftGrid Client\""

The .msp file

There are no SoftGrid command-line switches available for the .msp file. However you can use the following Windows Installer command-line switch to silently install the .msp file:
msiexec.exe /p "softgrid-xx-HFxxxxxxxxxx.msp" /qn+ REINSTALL=ALL REINSTALLMODE=omus
The following example uses the .msi file to upgrade the SoftGrid Client:
msiexec.exe /i "softgrid-ts-setup.msi" REINSTALL=ALL REINSTALLMODE=vomus
Note The quotation marks are required only when the value contains a space. For consistency, all the previous examples use quotation marks.

For more information about parameters, see the SoftGrid Platform Administration Guide.

For more information about Windows Installer command-line options, visit the following Microsoft Web site:
http://msdn2.microsoft.com/en-us/library/aa372024.aspx
For more information about Macrovision InstallShield command-line options, visit the following Macrovision Web site:
http://helpnet.installshield.com
In the Ask a Question box, type command-line.

Properties

Article ID: 930848 - Last Review: March 23, 2007 - Revision: 2.0
APPLIES TO
  • Microsoft SoftGrid for Terminal Services
  • Microsoft SoftGrid for Windows Desktops
Keywords: 
kbtshoot kbexpertiseinter KB930848

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