Description of the command-line installation parameters for SoftGrid Virtual Application Server 4.x

This article has been archived. It is offered "as is" and will no longer be updated.
SUMMARY
This article describes the command-line installation parameters for SoftGrid Virtual Application Server 4.x.

Important The information in this article applies to the following scenarios:
  • You install SoftGrid Virtual Application Server. Then, you create a configuration database.
  • You upgrade SoftGrid Virtual Application Server and the configuration database.
  • You install any of the following SoftGrid components:
    • SoftGrid Virtual Application Server
    • SoftGrid Server Management Console
    • SoftGrid Management Web Service
    • SoftGrid Client Management Console
  • You uninstall SoftGrid Virtual Application Server.
  • You install SoftGrid Virtual Application Server in an existing SoftGrid database.
Note You can perform only the first four scenarios by using a command line in SoftGrid Virtual Application Server 4.x. You can perform the last scenario only by using the installation wizard. Microsoft plans to address this limitation.
MORE INFORMATION
The following table describes the SoftGrid command-line parameters that are available for SoftGrid Virtual Application Server 4.x. You can use these parameters together with the Setup.exe command-line tool, together with the Msiexec.exe installer tool, or in the properties of a custom transformation (.mst) file.
ParameterValueDescription
DB_USERSQL Server standard loginInstaller: Database User Password

Item: User Name

This parameter specifies the user name of the SQL Server standard login. SoftGrid Virtual Application Server uses this name to access the SoftGrid database. This account is created the first time that you install SoftGrid Virtual Application Server.

Required for installation only
DB_ADMIN_USERSQL Server standard loginInstaller: Database Administration

Item: Administrator Account

This parameter specifies the SQL Server standard login. The user name is usually "sa." The login must exist before the installation or the upgrade. Additionally, the login must be a member of the "System Administrators" SQL role.

Note This user must have the authority to create and modify the SoftGrid configuration database, to create and modify jobs in the MSDB database, and to create a SQL Server standard login.

Example: DB_ADMIN_USER=sa

Required for installation and upgrade
DB_ADMIN_PASSpasswordInstaller: Database Administration

Item: Password

This parameter specifies the password for the user account that the DB_ADMIN_USER parameter specifies.

Required for installation and upgrade
DB_CREATE_SERVICETRUE or FALSEInstaller: Select Database

Item: "Create new database for the configuration information"

This parameter instructs the installer to create a new SoftGrid configuration database.

Note The default value is TRUE.
DB_FILE_PATHlocal pathInstaller: Create Database

Item: File Location

This parameter provides an alternative location for the SoftGrid configuration database. This parameter is valid for installation only when you install SQL Server and SoftGrid Virtual Application Server on the same computer. After the installation, you cannot the path by using the command line.

Note During an installation, SQL Server provides the default value. During an upgrade, the previous SoftGrid installation provides the default value.
DB_HOSTHost nameInstaller: Database Server Location

Item: Server Name

This parameter specifies the host name of a SQL Server-based database server.

Example: DB_HOST=SGSQLSRV

Required
DB_PASSpasswordInstaller: Database User Password

Items: Password, Confirm Password

During a new installation, this parameter specifies the password for the account that DB_USER specifies.

Example: DB_PASS=password

Required for installation only
DB_PORTSQL portInstaller: Database Server Location

Item: Port Number

This parameter specifies an alternative port to use to communicate with SQL Server.

Note The default value for an installation is 1433. An upgrade uses the same port as the previous installation.
DB_SERVER_GROUPserver group nameInstaller: Server Group

Item: Group Name

This parameter specifies a server group in addition to "Default Server Group"

Note "Default Server Group" is always created during installation.

Not implemented in SoftGrid Virtual Application Server 4.x
DB_SERVICEdatabase nameInstaller: Select Database

Item: Please select the name

This parameter specifies the database name.

Example: DB_SERVICE=SOFTGRID

Required for installation only
INSTALLDIRlocal pathInstaller: Custom Setup

Item: Install to

This parameter specifies the root installation directory.

Example: INSTALLDIR="D:\Program Files\Softricity"

Note The default value is "C:\Program Files\Softricity".
SERVER_RECORD_EXISTSTRUE or FALSEInstaller: Select Database

Item: Create a new database

This parameter specifies whether to create a new database.

Undefined: Create a configuration database
True: Do not add a server record
False: Add a server record

Note By default, no value is defined.

Not implemented in SoftGrid Virtual Application Server 4.x. SoftGrid Virtual Application Server 4.x always tries to create a new configuration database.
SWIDOMAINNAMEWindows domain Installer: Directory Server

Item: Domain name

This parameter specifies the fully qualified domain name to be browsed for security groups.

Example: MyDom.Microsoft.int

Note Only this domain can be browsed. You must manually enter the security groups from domains that are trusted by this domain.

Required for installation only
SWIDOMAINUIDWindows domain User Installer: Directory Server

Item: User name

This parameter specifies a Windows domain user to use to access the directory server.

Required for installation only
SWIDOMAINPWDpasswordInstaller: Directory Server

Item: Password

This parameter specifies the password for SWIDOMAINUID.

Required for installation only
SWIADMINGROUPsecurity groupInstaller: Administrator Group

Item: Group Name

This parameter specifies a security group that contains all the SoftGrid administrator accounts.

Required for installation only
SWIUSERGROUPsecurity groupInstaller: Default Provider Group

Item: Group Name

This parameter specifies a security group that contains all the SoftGrid user accounts.

Required for installation only
SWICONTENTDIRlocal pathInstaller: Content Path

Item: Folder name

This parameter specifies the local path of the SoftGrid content directory.

Example: SWICONTENTDIR="D:\content"

Required for installation only
SWISERVERLOGDIRlocal pathInstaller: Not applicable

This parameter specifies the path of the SoftGrid Vitual Application Server log file (Sft-server.log).

Note The default value is the Logs subfolder of the SoftGrid Server folder.
The following table describes parameters that are frequently used together with the Msiexec.exe installer tool.
ParameterValueDescription
ADDLOCALfeature name[,feature name]This parameter specifies the features to install. This parameter can be any combination of Release_SoftGrid_Server, Release_SoftGrid_Management_Console, Release_SoftGrid_Mgmt_Web_Service, and Release_Client_MMC.

Example: ADDLOCAL=Release_SoftGrid_Server
REINSTALL feature name
ALL
Example: REINSTALL=ALL
REINSTALLMODEp, o, e, d, c, a, u, m, s, v Example: REINSTALLMODE=vomus

Examples of how to use the parameters

All examples appear in the form in which they were tested.

Example parameters
  • /qn: quiet installation
  • /Lv: verbose logging
  • /passive: no user interaction is required

Install SoftGrid Virtual Application Server, SoftGrid Management Web Service, and SoftGrid Server Management Console

REM Install.batset VAS=4.1.1.302 set Log=L:\Examples\s%VAS%-SftVAS-Cmd.log set DB="MySGDB" set Host="%COMPUTERNAME%" cd ..\s%VAS% msiexec /i "SoftGrid Virtual Application Server.msi" INSTALLDIR="S:\Program Files\Softricity" DB_USER=SoftGrid DB_PASS="fakepw" DB_ADMIN_USER=sa DB_ADMIN_PASS="fakepw" DB_CREATE_SERVICE=TRUE SWIDOMAINNAME="pjf-support.cts.softricity.int" SWIDOMAINUID="sgbrowse" SWIDOMAINPWD="fakepw" SWIADMINGROUP="SG Admins" SWIUSERGROUP="SG Users" DB_SERVICE=%DB% DB_HOST=%Host% SWISERVERLOGDIR="L:\" DB_FILE_PATH="D:\SFTData" SWICONTENTDIR="P:\SFTContent" /Lv %Log% /qn

Upgrade

REM Upgrade to 4.1.1.302set VAS=4.1.1.302 set Log=L:\Examples\s%VAS%-Upgrade-Cmd.log cd ..\s%VAS% msiexec /i "SoftGrid Virtual Application Server.msi" DB_ADMIN_USER=sa DB_ADMIN_PASS="fakepw" DB_USER="SoftGrid" DB_PASS="fakepw" REINSTALL=ALL REINSTALLMODE=vomus /Lv %Log% /qn

Install SoftGrid Server Management Console and SoftGrid Client Management Console

REM Consoles only set VAS=4.1.1.302 set Log=L:\Examples\s%VAS%-SftSrvOnly-Cmd.log cd ..\s%VAS% msiexec /i "SoftGrid Virtual Application Server.msi" INSTALLDIR="S:\Program Files\Softricity" ADDLOCAL=Release_SoftGrid_Management_Console,Release_Client_MMC /Lv %Log% /qn

Install SoftGrid Virtual Application Server only

REM Server Only set VAS=4.1.1.302 set Log=L:\Examples\s%VAS%-ServerOnly-Cmd.log set DB="MYSGDB" set Host="%COMPUTERNAME%" cd ..\s%VAS% msiexec /i "SoftGrid Virtual Application Server.msi" INSTALLDIR="S:\Program Files\Softricity" DB_USER=SoftGrid DB_PASS="fakepw" DB_ADMIN_USER=sa DB_ADMIN_PASS="fakepw" DB_CREATE_SERVICE=TRUE SWIDOMAINNAME="pjf-support.cts.softricity.int" SWIDOMAINUID="sgbrowse" SWIDOMAINPWD="fakepw" SWIADMINGROUP="SG Admins" SWIUSERGROUP="SG Users" DB_SERVICE=%DB% DB_HOST=%Host% SWISERVERLOGDIR="L:\" ADDLOCAL=Release_SoftGrid_Server DB_FILE_PATH="D:\SFTData" /Lv %Log% /qn

Uninstall SoftGrid Virtual Application Server and components

REM uninstall set VAS=4.1.1.302 set Log=L:\Examples\s%VAS%-Remove-cmd.log cd ..\s%VAS% msiexec /uninstall "SoftGrid Virtual Application Server.msi" /passive /Lv %Log% /qn
REFERENCES
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.

Microsoft provides third-party contact information to help you find technical support. This contact information may change without notice. Microsoft does not guarantee the accuracy of this third-party contact information.
Properties

Article ID: 930953 - Last Review: 01/15/2015 09:22:17 - Revision: 3.0

Microsoft SoftGrid for Terminal Services, Microsoft SoftGrid for Windows Desktops

  • kbnosurvey kbarchive kbexpertiseinter kbtshoot KB930953
Feedback