Article ID: 930848
Article Last Modified on 3/23/2007
APPLIES TO
- Microsoft SoftGrid for Terminal Services
- Microsoft SoftGrid for Windows Desktops
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.
Parameter | Value(s) | Description |
---|---|---|
SWICACHESIZE | cache size in MB
|
This 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.
|
SWIDCSDISPLAY | display name
|
This 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.
|
SWIDCSTYPE | SoftGrid|UDDI] | This parameter specifies the type for this Desktop Configuration Server. The default type is "SoftGrid."
|
SWIDCSHOST | IP address or host name
|
This 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.
|
SWIDCSPORT | port number
|
This 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.
|
SWIDCSPATH | path name
|
This 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.
|
SWIDCSREFRESH | 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."
|
SWIPUBLISHDESKTOP | 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:
|
SWIPUBLISHSTART | 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:
|
SWISKIPDATASETTINGS | 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."
|
SWIGLOBALDATA | global data directory
|
This 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\.
|
SWIUSERDATA | user data directory
|
This parameter specifies the directory where data that is specific to particular users will be stored. The default directory is %APPDATA%.
|
The following table describes frequently used MSI parameters.
Parameter | Value(s) | Description |
---|---|---|
INSTALLDIR | path name
|
This parameter specifies the installation directory of the SoftGrid Client.
|
REINSTALL | feature name ALL |
An example of this is REINSTALL=ALL. |
REINSTALLMODE | p, o, e, d, c, a, u, m, s, v | An 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:
For more information about Macrovision InstallShield command-line options, visit the following Macrovision Web site:
In the Ask a Question box, type command-line.
Keywords: kbtshoot kbexpertiseinter KB930848