Installing VMM from a Command Prompt

 

Updated: May 13, 2016

Applies To: System Center 2012 SP1 - Virtual Machine Manager, System Center 2012 R2 Virtual Machine Manager, System Center 2012 - Virtual Machine Manager

You can install Virtual Machine Manager (VMM) by using a command prompt. Installing VMM features involves saving installation settings in an .ini file and using the setup.exe command with that file.

Important

For all of these procedures, use the Run as administrator option to open an elevated command prompt.

Installation files

Your installation media contains .ini files for each VMM feature:

  • VMServer.ini

    Settings for the VMM management server.

  • VMClient.ini

    Settings for the VMM console.

  • VMEUP.ini

    Settings for the VMM Self-Service Portal.

    Note

    As of System Center 2012 Service Pack 1 (SP1), the VMM Self-Service Portal has been removed.

  • VMServerUninstall.ini

    Uninstallation settings for the VMM management server.

The files contain key/value pairs that have default values. These entries are commented out. To edit the file, remove the comment symbol (#) and change the value.

Installing a VMM management server by using a command prompt

To install a VMM management server, edit the VMServer.ini file and then run the setup.exe command.

Note

When you install a VMM management server, the VMM console is automatically installed.

Configuring options for a VMM management server in the installation file

Option Values Default
ProductKey Product key in the format: xxxxx-xxxxx-xxxxx-xxxxx-xxxxx xxxxx-xxxxx-xxxxx-xxxxx-xxxxx
UserName Optional display name for the user who is installing the features. Note: This is not the user account for the installation. Administrator
CompanyName Optional display name for the organization that is installing the features. Microsoft Corporation
ProgramFiles Location for VMM files. C:\Program Files\Microsoft System Center 2012\Virtual Machine Manager
CreateNewSqlDatabase 0: Use an existing Microsoft SQL Server database.

1: Create a new SQL Server database.
1
SqlInstanceName Name of the new or existing instance of SQL Server. MICROSOFT$VMM$
SqlDatabaseName Name of the new or existing SQL Server database. VirtualManagerDB
RemoteDatabaseImpersonation 0: Do not impersonate the administrator account for SQL Server. Important: The user that runs setup.exe must be an administrator for the server that is hosting SQL Server.

1: Impersonate the administrator account for SQL Server by using the provided credentials. Important: The user who runs setup.exe must provide values for the SqlDBAdminName, SqlDBAdminPassword, and SqlDBAdminDomain parameters.
0
SqlMachineName Name of the server that is hosting SQL Server. Do not specify localhost. Instead, specify the actual name of the computer. <sqlmachinename>
(various ports) For information about ports, see Ports and Protocols for VMM. IndigoTcpPort: 8100

IndigoHTTPSPort: 8101

IndigoNETTCPPort: 8102

IndigoHTTPPort: 8103

WSManTcpPort: 5985

BitsTcpPort: 443
CreateNewLibraryShare 0: Use an existing library share.

1: Create a new library share.
1
LibraryShareName Name of the file share to be used or created. MSSCVMMLibrary
LibrarySharePath Location of the existing file share or the new file share to be created. C:\ProgramData\Virtual Machine Manager Library Files
LibraryShareDescription Description of the share. Virtual Machine Manager Library Files
SQMOptIn 0: Do not opt in to the Customer Experience Improvement Program (CEIP).

1: Opt in to CEIP.

For more information about CEIP, see Microsoft Customer Experience Improvement Program.

For CEIP privacy information, see Privacy Statement for the Microsoft Customer Experience Improvement Program.
0
MUOptIn 0: Do not opt in to Microsoft Update.

1: Opt in to Microsoft Update.

For more information about Microsoft Update, see Frequently Asked Questions.

For Microsoft Update privacy information, see Update Services Privacy Statement.
0
VmmServiceLocalAccount 0: Use a domain account for the VMM service (scvmmservice).

1: Use the Local System account for the VMM service. Note: To use a domain account, when you run setup.exe, provide values for the VMMServiceDomain, VMMServiceUserName, and VMMServiceUserPassword parameters. For more information about service accounts, see Specifying a Service Account for VMM.
0
TopContainerName Container for Distributed Key Management (DKM); for example, “CN=DKM,DC=contoso,DC=com”.

For more information about DKM, see Configuring Distributed Key Management in VMM.
VMMServer
HighlyAvailable 0: Do not install as highly available.

1: Install as highly available.

For information about highly available installations, see Installing a Highly Available VMM Management Server.
0
VmmServerName Clustered service name for a highly available VMM management server. Important: Do not enter the name of the failover cluster or the name of the computer on which the highly available VMM management server is installed. For more information, see How to Install a Highly Available VMM Management Server. <VMMServerName>
VMMStaticIPAddress IP address for the clustered service name for a highly available VMM management server, if you are not using Dynamic Host Configuration Protocol (DHCP). Note: Both IPv4 and IPv6 are supported. <comma-separated-ip-for-HAVMM>
Upgrade 0: Do not upgrade from a previous version of VMM.

1: Upgrade from a previous version.
1

Installing a VMM management server by using a command prompt

After you edit VMServer.ini, open an elevated command prompt, and then run setup.exe by using the following parameters:

  • /server

    Specifies installation of the VMM management server.

  • /i or /x

    Specifies whether to install (/i) or uninstall (/x) the server.

  • /f <filename>

    Specifies the .ini file to use.

    Important

    Be sure that this parameter points to the correct .ini file. If setup.exe does not find an .ini file, it will perform the installation by using its own default values.

  • /VmmServiceDomain <domainName>

    Specifies the domain name for the account that is running the VMM service (scvmmservice). Use this parameter only if you set VmmServiceLocalAccount to 0 in VMServer.ini.

  • /VmmServiceUserName <userName>

    Specifies the user name for the account that is running the VMM service (scvmmservice). Use this parameter only if you set VmmServiceLocalAccount to 0 in VMServer.ini.

  • /VmmServiceUserPassword <password>

    Specifies the password for the account that is running the VMM service (scvmmservice). Use this parameter only if you set VmmServiceLocalAccount to 0 in VMServer.ini.

  • /SqlDBAdminDomain <domainName>

    Specifies the domain name for the administrator account for the SQL Server database. Use this parameter if the current user does not have administrative rights to SQL Server.

  • /SqlDBAdminName <userName>

    Specifies the user name for the administrator account for the SQL Server database. Use this parameter if the current user does not have administrative rights to SQL Server.

  • /SqlDBAdminPassword <password>

    Specifies the password for the administrator account for the SQL Server database. Use this parameter if the current user does not have administrative rights to SQL Server.

  • /IACCEPTSCEULA (as of System Center 2012 SP1)

    Notes acceptance of the Microsoft Software License Terms. This is a mandatory parameter.

For example, to use a VMServer.ini file that is stored in C:\Temp with a SQL Server administrator account of contoso\SQLAdmin01 and a VMM service account of contoso\VMMadmin14, use the following command:

setup.exe /server /i /f C:\Temp\VMServer.ini /SqlDBAdminDomain contoso /SqlDBAdminName SQLAdmin01 /SqlDBAdminPassword password123 /VmmServiceDomain contoso /VmmServiceUserName VMMadmin14 /VmmServiceUserPassword password456 /IACCEPTSCEULA

Uninstalling a VMM management server by using a command prompt

To uninstall a VMM management server, edit the VMServerUninstall.ini file and then run the setup.exe command.

Configuring options for uninstalling a VMM management server

Option Values Default
RemoteDatabaseImpersonation 0: Local SQL Server installation.

1: Remote SQL Server installation.

When you run setup.exe, provide a value for the SqlDBAdminName, SqlDBAdminPassword, and SqlDBAdminDomain parameters unless the user who is running setup.exe is an administrator for SQL Server.

Replaces the OnRemoteServer setting in VMM 2008 R2.
0
RetainSqlDatabase 0: Remove the SQL Server database.

1: Do not remove the SQL Server database. Important: To remove the SQL Server database, when you run setup.exe, provide a value for the SqlDBAdminName, SqlDBAdminPassword, and SqlDBAdminDomain parameters unless the user who is running Setup is an administrator for SQL Server.
0
ForceHAVMMUninstall 0: Do not force uninstallation if setup.exe cannot verify whether this node is the final node of the highly available installation.

1: Force the uninstallation.

For more information about uninstalling a highly available VMM management server, see How to Uninstall a Highly Available VMM Management Server.
0

Uninstalling a VMM management server by using a command prompt

To uninstall a VMM management server by using a VMServerUninstall.ini file that is stored in C:\Temp, with a SQL Server administrator account of contoso\SQLAdmin01, use this command:

setup.exe /server /x /f C:\Temp\VMServerUninstall.ini /SqlDBAdminDomain contoso /SqlDBAdminName SQLAdmin01 /SqlDBAdminPassword password123

Installing or uninstalling a VMM console by using a command prompt

To install a VMM console, edit the VMClient.ini file and then run the setup.exe command.

To uninstall a VMM console, run the setup.exe command. There is no separate .ini file for uninstalling the VMM console.

Note

Do not attempt to uninstall the VMM console from a system that includes a VMM management server. You must first uninstall the VMM management server.

Configuring options for a VMM console

Option Values Default
ProgramFiles Location for VMM files. C:\Program Files\Microsoft System Center 2012\Virtual Machine Manager
IndigoTcpPort Port that is used for communication between the VMM management server and the VMM console. 8100
MUOptIn 0: Do not opt in to Microsoft Update.

1: Opt in to Microsoft Update.

For more information about Microsoft Update, see Frequently Asked Questions.

For Microsoft Update privacy information, see Update Services Privacy Statement.
0
VmmServerForOpsMgrConfig This setting is not used. For more information, see Configuring Operations Manager Integration with VMM. <VMMServerName>

Installing a VMM console by using a command prompt

After you edit VMClient.ini, use an elevated command prompt to run setup.exe by using the following parameters:

  • /client

    Specifies installation of the VMM console.

  • /i or /x

    Specifies whether to install (/i) or uninstall (/x) the console.

  • /f <filename>

    Specifies the .ini file to use.

    Important

    Be sure that this parameter points to the correct .ini file. If setup.exe does not find an .ini file, it will perform the installation by using its own default values.

  • /opsmgr

    Specifies whether to configure a preinstalled instance of System Center Operations Manager 2007.

    Warning

    Do not use this parameter. For more information, see Configuring Operations Manager Integration with VMM.

For example, to use a VMClient.ini file that is stored in C:\Temp, use this command:

setup.exe /client /i /f C:\Temp\VMClient.ini

Installing the VMM Self-Service Portal by using a command prompt

Note

In System Center 2012 SP1, the VMM Self-Service Portal has been removed.

To install the VMM Self-Service Portal, edit the VMEUP.ini file and then run the setup.exe command.

To uninstall the VMM Self-Service Portal, run the setup.exe command. There is no separate .ini file for uninstalling the VMM Self-Service Portal.

Configuring options for the VMM Self-Service Portal installation

Option Values Default
ProgramFiles Location in which to store program files. C:\Program Files\Microsoft System Center 2012\Virtual Machine Manager
VmmServerName Name of the VMM management server that this VMM Self-Service Portal connects to. <machineName>
IndigoTcpPort Port that is used for communication between the VMM management server and the VMM Self-Service Portal. 8100
SelfServicePortalTcpPort Port that users use to connect to the VMM Self-Service Portal. 80
SelfServicePortalHeader If other websites on this server are using the same port, specify a header for the VMM Self-Service Portal.

For more information about headers, see How to Install the VMM Self-Service Portal.
<headerName>
MUOptIn 0: Do not opt in to Microsoft Update.

1: Opt in to Microsoft Update.

For more information about Microsoft Update, see Frequently Asked Questions.

For Microsoft Update privacy information, see Update Services Privacy Statement.
0

Installing or uninstalling the VMM Self-Service Portal by using a command prompt

After you edit VMEUP.ini, use an elevated command prompt to run setup.exe by using the following parameters:

  • /eup

    Specifies installation of the VMM Self-Service Portal.

  • /i or /x

    Specifies whether to install (/i) or uninstall (/x) the VMM Self-Service Portal.

  • /f <filename>

    Specifies the .ini file to use.

    Important

    Be sure that this parameter points to the correct .ini file. If setup.exe does not find an .ini file, it will perform the installation by using its own default values.

To use a VMEUP.ini file that is stored in C:\Temp to install the VMM Self-Service Portal, use this command:

setup.exe /eup /i /f C:\Temp\VMEUP.ini

To uninstall the VMM Self-Service Portal, use this command:

setup.exe /eup /x

See Also

Installing System Center 2012 - Virtual Machine Manager