Microsoft KB Archive/930953

From BetaArchive Wiki

Article ID: 930953

Article Last Modified on 7/31/2007


APPLIES TO

  • Microsoft SoftGrid for Terminal Services
  • Microsoft SoftGrid for Windows Desktops


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.

Parameter Value Description
DB_USER SQL Server standard login Installer: 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_USER SQL Server standard login Installer: 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_PASS password Installer: 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_SERVICE TRUE or FALSE Installer: 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_PATH local path Installer: 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_HOST Host name Installer: 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_PASS password Installer: 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_PORT SQL port Installer: 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_GROUP server group name Installer: 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_SERVICE database name Installer: Select Database


Item: Please select the name

This parameter specifies the database name.

Example: DB_SERVICE=SOFTGRID

Required for installation only

INSTALLDIR local path Installer: 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_EXISTS TRUE or FALSE Installer: 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.

SWIDOMAINNAME Windows 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

SWIDOMAINUID Windows 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

SWIDOMAINPWD password Installer: Directory Server


Item: Password

This parameter specifies the password for SWIDOMAINUID.

Required for installation only

SWIADMINGROUP security group Installer: Administrator Group


Item: Group Name

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

Required for installation only

SWIUSERGROUP security group Installer: Default Provider Group


Item: Group Name

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

Required for installation only

SWICONTENTDIR local path Installer: Content Path


Item: Folder name

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

Example: SWICONTENTDIR="D:\content"

Required for installation only

SWISERVERLOGDIR local path Installer: 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.

Parameter Value Description
ADDLOCAL feature 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
REINSTALLMODE p, 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.bat

set 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.302

set 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:

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.

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.

Keywords: kbexpertiseinter kbtshoot KB930953



Send feedback to Microsoft

© Microsoft Corporation. All rights reserved.


Retrieved from ‘https://www.betaarchive.com/wiki/index.php?title=Microsoft_KB_Archive/930953&oldid=227009’
the Creative Commons 3.0 ShareAlike (except the Microsoft KB Archive).
Powered by MediaWiki