Microsoft® Virtual Server 2005 R2 contains the latest software updates for Virtual Server 2005. These release notes contain important information about the new features included with this release, about installing the software, and about known issues. To make sure that you understand these updates and their effects, review all of the information in this document before you install R2.
Important |
---|
Information in this document might differ from some of the information that appears in the Virtual Server 2005 Administrator's Guide or Getting Started. If you find such differences, consider the information in this document to be correct. |
These release notes cover:
-
What's new in R2
-
Installation notes
-
Speeding operating system installation on SCSI disks
-
Virtual Server performance counters
-
Known issues
-
Documentation Corrections
-
Copyright
What's new in R2
R2 includes the following features:
-
Support for additional host operating systems
-
Support for additional guest operating systems
-
Support for seven additional languages
-
Virtual Disk Precompactor
-
Performance enhancements
-
Built-in support for network installations
-
Reserved disk space for saved state files
-
Virtual floppy disk for pre-loading virtual SCSI drivers
-
Support for hyper-threading
-
Support to specify NUMA node programmatically to allocate virtual machine memory
Support for additional host operating systems
In addition to the host operating systems supported by Virtual Server 2005, R2 adds support for the following host operating systems:
-
Microsoft Windows Server™ 2003 R2, Standard Edition
-
Microsoft Windows Server™ 2003, Standard Edition with Service Pack 1 (SP1)
-
Microsoft Windows Server™ 2003 R2, Enterprise Edition
-
Microsoft Windows Server™ 2003, Enterprise Edition with SP1
-
Microsoft Windows Server™ 2003 R2, Datacenter Edition
-
Microsoft Windows Server™ 2003, Datacenter Edition with SP1
-
Microsoft Windows Server™ 2003 R2, Standard x64 Edition
-
Microsoft Windows Server™ 2003, Standard x64 Edition
-
Microsoft Windows Server™ 2003 R2, Enterprise x64 Edition
-
Microsoft Windows Server™ 2003, Enterprise x64 Edition
-
Microsoft Windows® XP Professional with Service Pack 2 (SP2)
-
Microsoft Windows® XP Professional, x64 Edition
Important |
---|
You should use Microsoft Windows XP Professional as a host operating system only in a non-production environment. |
Support for additional guest operating systems
In addition to the guest operating systems supported by Virtual Server 2005, R2 adds support for the following guest operating systems:
-
Microsoft Windows Server™ 2003 R2, Standard Edition
-
Microsoft Windows Server™ 2003, Standard Edition with SP1
-
Microsoft Windows Server™ 2003 R2, Enterprise Edition
-
Microsoft Windows Server™ 2003, Enterprise Edition with SP1
-
Microsoft Windows® XP Professional with SP2
Note |
---|
Per-incident and security update support for Microsoft Windows NT® Server 4.0 ended on December 31, 2004. This includes support for Windows NT Server 4.0 running in a virtual machine under Virtual Server 2005 and R2. For more information, see "Changes in Windows NT Server 4.0 Support" at the |
Support for seven additional languages
In addition to English and Japanese, R2 is also available in French, German, Spanish, Italian, Korean, Traditional Chinese and Simplified Chinese.
Virtual Disk Precompactor
R2 includes Virtual Disk Precompactor, a utility designed to "zero out" (overwrite with zeros) any available blank space on a virtual hard disk (VHD). We recommend that you use Virtual Disk Precompactor before you compact a dynamically expanding VHD in order to create a smaller compacted VHD.
Note |
---|
Compacting VHDs is described in "Compacting dynamically expanding virtual hard disks" in the Virtual Server 2005 Administrator's Guide. This topic describes using a non-Microsoft tool to zero out data, however, you can use Virtual Disk Precompactor instead. |
After you install R2, you can find Virtual Disk Precompactor.iso in the folder: %systemdrive%\Program Files\Microsoft Virtual Server\Virtual Machine Additions\.
To use Virtual Disk Precompactor, you must first capture Virtual Disk Precompactor.iso using the standard procedure for capturing .iso files as described in "To add or remove a CD or DVD drive" in the Virtual Server 2005 Administrator's Guide.
If your virtual machine is running when you capture Virtual Disk Precompactor.iso, Virtual Disk Precompactor starts automatically. If you click Yes when prompted, Virtual Disk Precompactor precompacts all virtual hard disks for this virtual machine. If Virtual Disk Precompactor does not start automatically, you can start it by navigating to the CD drive of the guest operating system and double-clicking Precompact.exe.
Alternatively, you can also run Virtual Disk Precompactor from the command line by navigating to the CD drive of the guest operating system and typing Precompact. The available parameters are:
-Help - Displays help for the precompactor.
-Silent - Runs the precompactor in unattended mode.
-SetDisks - Specifies the disks to be precompacted. If this parameter isn't specified, then all virtual hard disks for this virtual machine are compacted. For example, the following command will precompact your C, D, and E drives in unattended mode:
Precompact -Silent -SetDisks:CDE
Note |
---|
You can only compact dynamically expanding VHDs. To compact a fixed-size VHD, you can convert it to a dynamically expanding VHD, compact it, and then convert it back to a fixed size VHD. |
Performance enhancements
Changes have been made to the way that Virtual Server allocates physical memory to guest operating systems. In some scenarios, this could result in significant performance improvements.
Built-in support for network installations
PXE boot support has been added to the virtual machine network adapter. This means that when the appropriate network infrastructure is in place, you can perform a network installation of a guest operating system without needing a PXE boot floppy disk.
Reserved disk space for saved state files
With R2, Virtual Server now reserves sufficient space on the physical disk to save the state of each running virtual machine. It does this when the virtual machine starts up by creating an empty saved state (.vsv) file equal to amount of memory allocated to the virtual machine plus a 20 MB buffer. For example, if 200 MB of memory is allocated to a virtual machine, Virtual Server will create an empty .vsv file that is 220 MB in size. This ensures that you will have sufficient disk space to save the state of the virtual machine. When you shut down the virtual machine, Virtual Server deletes the empty .vsv. If you have selected the option to save virtual machine state, Virtual Server replaces it with a populated .vsv file. If not, Virtual Server simply frees the space on the disk without creating another file.
Important |
---|
If there is insufficient disk space to create the .vsv file, the virtual machine will not start. To start the virtual machine, you will need to make additional space available on the physical disk that is at least equal to the memory allocated to the virtual machine plus 20 MB. |
Virtual floppy disk for pre-loading emulated SCSI drivers
R2 includes a virtual floppy disk, SCSI Shunt Driver.vfd, that you can use to load the emulated SCSI drivers during installation of a Windows Server 2003, Windows 2000 Server, or Windows XP Professional guest operating system. This will speed the installation when the virtual hard disk is attached to a virtual SCSI adapter. For instructions on using this virtual floppy disk, see "Speeding operating system installation on SCSI disks" later in this document.
Support for hyper-threading
With Virtual Server 2005, we recommended that you disable hyper-threading on the host operating system to improve the performance of your virtual machines. With R2, this is no longer necessary. Hyper-threading does not affect virtual machine performance, except when Virtual Machine Additions is not installed.
Support to specify NUMA node programmatically to allocate virtual machine memory
On computers that use a symmetric multiprocessing (SMP) system which supports non-uniform memory access (NUMA), you can now specify the NUMA node to allocate the virtual machine's memory to the specified node. The value is stored in the virtual machine configuration (.vmc) file in a new key, Settings/Numa/Memory/Preferred_Node. You can specify the node programmatically by using IVMVirtualMachine::SetConfigurationValue.
Installation notes
This section provides information about installing R2. There are two installation scenarios for R2:
-
Upgrade in place. Install R2 on a computer on which Virtual Server 2005 is currently installed.
-
New installation. Install R2 on a computer on which Virtual Server 2005 is not currently installed.
Important |
---|
You must shut down all guest operating systems or turn off all virtual machines before installing R2, including any virtual machines that are currently in a saved state. This is important because saved states are not compatible between R2 and all previous versions of Virtual Server 2005. |
Upgrading in place
On a computer that is running Virtual Server 2005, you can upgrade to R2 using the following procedure.
Important |
---|
You cannot upgrade a trial version of Virtual Server 2005. In this case, you must first remove Virtual Server 2005 as described in "Remove Virtual Server" in the Virtual Server 2005 Administrator's Guide. Then you can perform a new installation, as described next, in "Performing a new installation." |
-
Make sure that all virtual machines are turned off, including any virtual machines in a saved state. Saved states are not compatible between Virtual Server 2005 and R2.
-
Back up all of your Virtual Server files. In the unlikely event that your installation becomes corrupted, you can restore the files from these backups. The files to back up include:
-
Virtual Server configuration file (options.xml)
-
Virtual machine configuration (.vmc) files
-
Virtual network configuration (.vnc) files
-
Virtual hard disk (.vhd) files
-
Undo disk (.vud) files
For more information about the default locations of these files, see "Virtual Server folders and files" in the Virtual Server 2005 Administrator's Guide. For more information about backing up your files, see "Backing up and restoring Virtual Server" in the Virtual Server 2005 Administrator's Guide.
-
Virtual Server configuration file (options.xml)
-
From the Services snap-in, stop the Virtual Server and Virtual Machine Helper services. For instructions, see "Start and stop the Virtual Server service" in the Virtual Server 2005 Administrator's Guide.
-
If you want, on the host operating system, install Windows Server 2003 SP1 or Windows XP Professional SP2 as appropriate.
-
Depending on your installation, follow the instructions in "Install R2 on a single computer" or "Install the Virtual Server service and the Administration Website for R2 on separate computers" later in this document.
-
After completing the installation, reinstall Virtual Machine Additions in each guest operating system, as described in the Virtual Server 2005 Administrator's Guide.
Note |
---|
When you reinstall Virtual Machine Additions, the guest operating system will restart twice. |
Performing a new installation
You can install R2 on a computer that is not currently running Virtual Server 2005 using the following procedure.
-
Ensure that the computer on which you want to install R2 meets or exceeds the requirements listed in "System Requirements" in the Virtual Server 2005 Administrator’s Guide. In addition to these requirements, it also can be running one of the operating systems listed earlier in "Support for additional host operating systems."
-
Install the World Wide Web Service component of Internet Information Services (IIS) on the computer on which you want to install the Administration Website.
-
Review conceptual information about configuring the Administration Website to run as either the authenticated user or the Local System account. Once you select either of these options, you can only change the option by reinstalling Virtual Server. For more information, see "Installing the Administration Website" in the Virtual Server 2005 Administrator's Guide.
-
Depending on the type of installation you want, follow the instructions in "Install Virtual Server 2005 R2 on a single computer" or "Install the Virtual Server service and the Administration Website on separate computers" later in this document. For background information about these options, see "Installing Virtual Server" in the Virtual Server 2005 Administrator's Guide.
Important Internet Information Services (IIS) must already be installed on the computer on which you install the Administration Website. -
If the purpose of this installation is to upgrade an existing instance of Virtual Server 2005 running on a 32-bit host operating system to R2 running on a 64-bit host operating system, then you probably want to move your Virtual Server resources from the old 32-bit computer to the new 64-bit computer. In this case, be sure to review the information in "Migrate your resources to the new installation" later in this document.
Install R2 on a single computer
In this scenario, you install the Virtual Server service for R2 and the Administration Website for R2 on the same computer. For more information about this configuration, see "Installing Virtual Server" in the Virtual Server 2005 Administrator's Guide.
-
Log onto the computer on which you want to install R2.
-
If you are installing R2 from a CD-ROM, on the installation CD open the folder corresponding to the type of operating system, 32-bit or 64-bit. If you are installing from the Web, download the appropriate R2 installation program.
-
For a new installation, double-click Setup.exe to start the Setup Wizard and follow the remaining steps. For an upgrade, click Next, and skip to the last step.
-
Proceed through the wizard until you reach the Setup Type page.
-
On the Setup Type page, select Complete, which installs the Virtual Server service and the Administration Website on this computer, and then click Next.
-
On the Configure Components page, either accept the default Website port value of 1024, or type a new value for the port.
-
Select Configure the Administration Website to always run as the authenticated user, or Configure the Administration Website to always run as the Local System account. Then, click Next.
-
If users will need to access Virtual Server through Windows Firewall, select Enable Virtual Server exceptions in Windows Firewall. Otherwise, leave this check box blank.
-
Click Next and then Install to begin the installation.
-
Once the installation is complete, the Setup Complete page appears. Click Finish to close the page and exit the Setup Wizard.
Note |
---|
To perform this procedure, you must be a member of the Administrators group on the local computer, or you must have been delegated the appropriate authority. If the computer is joined to a domain, members of the Domain Admins group might be able to perform this procedure. As a security best practice, consider using Run as to perform this procedure. When you perform an upgrade, setup configures your new installation by using the original defaults. If you select Enable Virtual Server exceptions in Windows Firewall, setup adds an exception for the Virtual Server service (vssrvc.exe) to every port on the computer. It also adds an exception to port 135 for Remote Procedure Call, which is required for DCOM. If you are installing the Administration Website on a computer running Windows XP SP2, you must configure port 80 manually. If you leave the Enable Virtual Server exceptions in Windows Firewall check box blank, you will need to manually configure any firewall settings. For instructions, see the Virtual Server 2005 Administrator's Guide. |
Install the Virtual Server service and the Administration Website on separate computers
In this scenario, you install the Virtual Server service for R2 on one computer and the Administration Website for R2 on a different computer. For more information about this configuration, see "Installing Virtual Server" in the Virtual Server 2005 Administrator's Guide.
-
Log onto the computer on which you want to install the Virtual Server service.
-
If you are installing R2 from a CD-ROM, on the installation CD open the folder corresponding to the type of operating system, 32-bit or 64-bit. If you are installing from the Web, download the appropriate R2 installation program.
-
For a new installation, double-click Setup.exe to start the Setup Wizard and follow the remaining steps. For an upgrade, click Next, and skip to the last step.
-
Proceed through the wizard until you reach the Setup Type page.
-
On the Setup Type page, select Custom, and then click Next.
-
Click Virtual Server Web Application, select This feature will not be available, and then click Next.
-
Click Install to begin the installation.
-
Once the installation is complete, the Setup Complete page appears. Click Finish to close the page and exit the Setup Wizard.
Note |
---|
To perform this procedure, you must be a member of the Administrators group on the local computer, or you must have been delegated the appropriate authority. If the computer is joined to a domain, members of the Domain Admins group might be able to perform this procedure. As a security best practice, consider using Run as to perform this procedure. When you perform an upgrade, setup configures your new installation by using the original defaults. If you select Enable Virtual Server exceptions in Windows Firewall, setup adds an exception for the Virtual Server service (vssrvc.exe) to every port on the computer. It also adds an exception to port 135 for Remote Procedure Call, which is required for DCOM. If you leave the Enable Virtual Server exceptions in Windows Firewall check box blank, you will need to manually configure any firewall settings. For instructions, see the Virtual Server 2005 Administrator's Guide. |
-
Log onto the computer on which you want to install the Administration Website for R2.
-
If you are installing R2 from a CD-ROM, on the installation CD open the folder corresponding to your operating system, 32-bit or 64-bit. If you are installing from the Web, download the appropriate R2 installation program.
-
For a new installation, double-click Setup.exe to start the Setup Wizard and follow the remaining steps. For an upgrade, click Next, and skip to the last step.
-
Proceed through the wizard until you reach the Setup Type page.
-
On the Setup Type page, select Custom, and then click Next.
-
Click Virtual Server Service, select This feature will not be available, and then click Next.
-
On the Configure Components page, either accept the default Website port value, or type a new value for the port.
-
Select Configure the Administration Website to always run as the Local System account, and then click Next.
-
Click Install to begin the installation.
-
Once the installation is complete, the Setup Complete page appears. Click Finish to close the page and exit the Setup Wizard.
Note |
---|
To perform this procedure, you must be a member of the Administrators group on the local computer, or you must have been delegated the appropriate authority. If the computer is joined to a domain, members of the Domain Admins group might be able to perform this procedure. As a security best practice, consider using Run as to perform this procedure. For more information about the options to configure the Administration Website, see "Configuring constrained delegation" in the Virtual Server 2005 Administrator's Guide. When installation is complete, Microsoft Internet Explorer opens and an installation summary appears. In addition, a message may appear depending on whether you have enabled Internet Explorer Enhanced Security Configuration. You can click OK to dismiss this message. |
Migrate your resources to the new installation
You might need to migrate your resources -- including virtual machines, virtual networks, and Virtual Server configuration -- from Virtual Server 2005 to your new R2 installation. This might be the case, for example, if your installation of R2 is on a different computer than the original installation, or if you had to perform a clean installation of the operating system to upgrade it from 32-bit to 64-bit. Migrating your resources is not necessary when you perform an in-place upgrade.
To migrate your resources, you can take the following steps:
-
Shut down or turn off all virtual machines that you want to migrate, including any virtual machines that are in a saved state.
Important Saved state (.vsv) files are not compatible between Virtual Server 2005 and R2 and cannot be migrated. -
Make backup copies of all Virtual Server configuration and resource files. These include:
-
Virtual Server configuration file (options.xml)
-
Virtual machine configuration (.vmc) files
-
Virtual network configuration (.vnc) files
-
Virtual hard disk (.vhd) files
-
Undo disk (.vud) files
-
Virtual Server configuration file (options.xml)
-
For more information about the default locations of these files, see "Virtual Server folders and files" in the Virtual Server 2005 Administrator's Guide. For more information about backing up your files, see "Backing up and restoring Virtual Server" in the Virtual Server 2005 Administrator's Guide.
-
Install or upgrade the host operating system as appropriate.
-
Install R2, following the instructions earlier in this document.
-
Restore the copied files to the new R2 installation, in the same location as they had in your original installation of Virtual Server 2005.
-
Reinstall Virtual Machine Additions for each virtual machine. For instructions, see the Virtual Server 2005 Administrator's Guide.
Note |
---|
When you reinstall Virtual Machine Additions, the guest operating system will restart twice. |
Installing R2 from the command line
Command-line installation of R2 is different from command-line installation of Virtual Server 2005. You can install R2 using either the Setup file or the .msi (Windows Installer) file. This topic describes both approaches.
Installing R2 using the Setup file
You can install R2 from the command line using the following syntax:
Setup.exe /v" /qn"
This installs R2 in unattended mode.
Installing R2 using the .msi file
In R2, the .msi file is embedded in Setup.exe. If you need to use the .msi file for installation, you can extract this file—Virtual Server 2005 Install.msi—from Setup.exe by using the following syntax:
Setup.exe /c /t drive letter :\ path to the .msi file
Example: Setup.exe /c /t c:\SetupFiles
This extracts Virtual Server 2005 Install.msi to the specified location. To perform the installation, you can then use the syntax described in "Installing Virtual Server from the command line" in the Virtual Server 2005 Administrator's Guide.
Important |
---|
Microsoft version numbers are in the form N.M.I.J. For example, a version number might be 1.1.465.235. The .msi program does not check the fourth set of numbers to validate the product version. Therefore, it will not allow you to install R2 over the original release version of Virtual Server 2005 because it will not detect a difference between the two versions. To perform an unattended upgrade using the .msi file, you must first remove Virtual Server 2005. Alternatively, you can force the installation of R2 over Virtual Server 2005 by adding the following parameters to the end of the installation command: REINSTALL=ALL REINSTALLMODE=vomus. |
Speeding operating system installation on SCSI disks
Virtual Server now includes a virtual floppy disk file named SCSI Shunt Driver.vfd that contains the virtual machine emulated SCSI drivers for Windows Server 2003, Windows 2000 Server, and Windows XP Professional. When you install one of these operating systems on a virtual hard disk that is attached to an emulated SCSI adapter, you can increase the speed of the installation by using this disk to load the SCSI drivers.
Note |
---|
SCSI Shunt Driver.vfd does not include the emulated SCSI drivers for Windows NT 4.0 Server. To speed an installation of Windows NT 4.0 Server on a SCSI disk, you can change the attachment of the VHD from the virtual SCSI adapter to a virtual IDE adapter, install the guest operating system, and then reattach the VHD to the SCSI adapter. |
-
Start the guest operating system installation.
-
When prompted to load a third-party SCSI or RAID driver, press F6. This prompt will display at the bottom of the setup screen. You must press F6 as soon as the prompt displays.
The setup screen will display a message indicating that Windows could not determine the type of mass storage device on your system.
-
Go to the Floppy Drive Properties page of the virtual machine and capture SCSI Shunt Driver.vfd. For instructions, see "To add or remove a floppy disk" in the Virtual Server 2005 Administrator's Guide. To capture it, you can either select SCSI Shunt Driver.vfd in the Known virtual floppy disks list, or you can type the fully qualified path, which is %systemdrive%\Program Files\Microsoft Virtual Server\Virtual Machine Additions\SCSI Shunt Driver.vfd.
-
Return to the setup screen, type S, and then press Enter.
-
Scroll to the SCSI driver for your operating system and press Enter.
-
Complete the guest operating system installation.
Virtual Server performance counters
Virtual Server 2005 adds the Virtual Machines performance object to Windows Server 2003 Performance Logs and Alerts. This object has the following counters:
-
Allocated MB. For each virtual machine, displays the currently allocated memory in megabytes (MB).
-
Allocated Pages. For each virtual machine, displays the number of memory pages currently allocated.
The Virtual Machines performance object is available only when at least one virtual machine is running. On the Add Counters page, when you add one of these counters, you can select the virtual machine instances to monitor. You can either select all instances or select the instances from the list.
For more information about adding and using performance counters, see "Performance objects and counters: Monitoring Performance" in Windows Server 2003 Help.
Known issues
The following are descriptions of known issues in R2.
Data loss can occur when compacting a differencing disk with Undo Disks enabled
When compacting a differencing disk that is attached to a virtual machine with Undo Disks enabled, any changes saved in an undo disk (.vud) file will be lost. This occurs because compacting the differencing disk makes the undo disk file unusable. To help prevent data loss, commit the changes stored in the .vud file when you shut down or turn off the virtual machine before you compact any disks attached to that machine.
Share a SCSI adapter only when using ID 0
You should share a SCSI adapter only when a virtual hard disk attached to the SCSI adapter is attached to ID 0. Otherwise the following error will occur: IVMHardDiskConnection::get_HardDisk() failed. This hard disk object has not been properly initialized. This error prevents you from returning to the configuration page to modify the configuration.
Configure Windows Firewall manually when installing R2 on Windows XP SP2
After you install R2 on a host computer running Windows XP SP2, you need to manually configure Windows Firewall even if you selected the Enable Virtual Server exceptions in Windows Firewall option during installation. You must add an exception to port 80 for the Virtual Server Web application (VSWebapp.exe) so you can use the Administration Website. For more information, search for "Windows Firewall exceptions" in Help and Support Center.
Default Host key assignment and non-English characters
The Host key is assigned to the right ALT key by default, which might interfere with inputting certain characters on a virtual machine running a non-English operating system. You can resolve this issue by assigning the Host key to a different key. For instructions, see "To change the default Host key" in the Virtual Server 2005 Administrator's Guide.
Installing VMRC or documentation only does not modify Windows Firewall
When you install Virtual Machine Remote Control (VMRC) or documentation only, you might receive an incorrect error message that the installation process adds exceptions in Windows Firewall. However, no changes are made to Windows Firewall when you perform a custom installation and install VMRC or documentation only.
Installation requires support for 8.3 file names
If you have used the fsutil command to turn off support for creating file names in 8.3 format, the R2 install will fail. You must turn on this support in order to install R2.
Incorrect user rights on virtual machine folder causes unexpected or disk-related errors during startup
When you try to start a virtual machine with a user account that does not have Write access to the virtual machine configuration folder, you will receive a message such as, "The virtual machine Virtualmachinename could not be started. An unexpected error occurred." Or "Virtualmachinename could not be started because a disk-related error occurred." This occurs because Virtual Server creates an empty saved state (.vsv) file in the virtual machine configuration folder when a virtual machine starts up. You can resolve this problem by granting Write permission on the virtual machine configuration folder to the user account for the virtual machine.
Setup modifies ACL on default virtual machine configuration folder with settings from custom folder
If you specify a custom folder to store virtual machines and use Virtual Server security settings to add permission entries for a new user, removing and reinstalling Virtual Server will modify the access control list (ACL) on the default folder by adding the new user with the rights that were assigned on the custom folder. The default folder is %systemdrive%:\Documents and Settings\All Users\Shared Documents\Shared Virtual Machines.
Removing Virtual Server does not remove configuration files
When you remove Virtual Server, the removal process does not delete files that store settings for virtual disk files or virtual machines and virtual networks. If you do not want to keep these files, you can delete them manually. The default locations of these files are as follows:
-
Virtual machine configuration (.vmc) files are stored in %systemdrive%:\Documents and Settings\All Users\Shared Documents\Shared Virtual Machines
-
Virtual network configuration (.vnc) files are stored in %systemdrive%:\Documents and Settings\All Users\Shared Documents\Shared Virtual Networks.
-
Virtual hard disk (.vhd) files that are created when a virtual machine is created are located by default in the virtual machine configuration folder (%systemdrive%:\Documents and Settings\All Users\Shared Documents\Shared Virtual Machines). Other virtual hard disk files and all virtual floppy disk (.vfd) files are stored in the location that was specified when the file was created.
Virtual Disk Precompactor message refers to Virtual PC tool
After Virtual Disk Precompactor finishes, a message incorrectly instructs you to use the Virtual Disk Wizard to compact the disk. This wizard is provided only with Microsoft Virtual PC 2004. When using R2 to compact a virtual hard disk, use the Administration Website to inspect the virtual hard disk and then compact it. For instructions, see "To compact a dynamically expanding virtual hard disk" in the Virtual Server 2005 Administrator's Guide.
Availability of 32-bit and 64-bit versions of VMRC
The version of Virtual Machine Remote Control (VMRC) that is provided with Virtual Server matches the version of Virtual Server, either 32-bit or 64-bit. If you install the 64-bit version of Virtual Server VMRC, you must install the 32-bit version of Virtual Server on a separate computer if you need to obtain a 32-bit version of VMRC.
Virtual Machine Additions on remote systems
When you remotely manage a virtual machine from a computer on which Virtual Server R2 is installed, virtual machine details for the remote virtual machine might include a warning that Virtual Machine Additions is out of date. This warning occurs when the remote physical computer is not running the R2 version of Virtual Server. You can ignore this warning.
Documentation Corrections
This section provides additions and corrections to the Virtual Server 2005 documentation.
IPsec affects Internet Connection Sharing
"Using Microsoft Loopback Adapter" in the Virtual Server 2005 Administrator's Guide includes the section "Configure NAT" that is missing information about Internet Protocol security (IPsec). If IPsec is enabled on the host operating system, you cannot share the host operating system's internet connection with virtual machines.
OnSwitchedDisplay method for remote servers
When scripting the _IVMRCClientControlEvents::OnSwitchedDisplay method for virtual machines on remote servers, be sure to include the remote server name in the URL. You can access the remote server name using the ServerAddress property. For more information, see "_IVMRCClientControlEvents::OnSwitchedDisplay" and "ServerAddressProperty of IVMRCClientControl" in the Virtual Server 2005 Programmer’s Guide.
Specifying an empty string for defaultGatewayAddress
The Virtual Server 2005 Programmer’s Guide incorrectly states that VMDHCPVirtualNetworkServer.DefaultGatewayAddress returns an error code of E_INVALIDARG when the defaultGatewayAddress parameter is an empty string.
Correction: When you specify an empty string for defaultGatewayAddress parameter, the currently specified default gateway is deleted.
DefaultVNConfigurationPath Property of IVMVirtualServer
The Virtual Server 2005 Programmer’s Guide incorrectly states that the path string returned by VMVirtualServer.DefaultVNConfigurationPath is terminated by a trailing \.
Correction: If the property is set to a path without a trailing \, no \ character is appended.
VMTaskResult enumeration
The Virtual Server 2005 Programmer’s Guide incorrectly states that the VMTaskResult enumeration includes the value vmTaskResult_Cancel.
Correction: The value is vmTaskResult_Cancelled.
Parameter for CoInitializeSecurity in InitVS()
The Virtual Server 2005 Programmer’s Guide incorrectly states that the parameter RpcAuthnLevel.PktPrivact should be provided in a call to CoInitializeSecurity in InitVS().
Correction: The parameter is RpcAuthnLevel.PktPrivacy.
Description of the virtualNetworkName parameter
In the Virtual Server 2005 Programmer’s Guide, the description of the virtualNetworkName parameter incorrectly states that it specifies the name of the virtual machine to add.
Correction: This parameter specifies the name of the virtual network to add.
Key_Application reference information
In the "Key Identifier Reference" in the Virtual Server 2005 Programmer’s Guide, Key_Application is missing. The missing information is as follows:
Key identifier string: Key_Application
Meaning: the Application key
Description of Virtual Server scripting support
"Virtual Server scripting support" in the Virtual Server 2005 Administrator's Guide includes this incorrect statement: "If a script is attached to an event that is associated with a virtual machine, the quoted name of the virtual machine will be passed as the first parameter to the script."
Correction: This statement is incorrect and should be ignored.
Description of user accounts for script execution
"Configuring Virtual Server scripts" in the Virtual Server 2005 Administrator's Guide includes this incomplete statement: "Scripts are executed in a new process in the logon session of the Virtual Server service, which runs under the Network Service account by default. As a result, any user interface (UI) that the script may try to present will not be visible on the local computer. In general, you should not attempt to display UI from these scripts."
Correction: This statement should read as follows: "Scripts that execute when Virtual Server starts or stops are executed in a new process in the logon session of the Virtual Server service, which runs under the Network Service account by default. As a result, any UI that the script may try to present will not be visible on the local computer. In general, you should not attempt to display UI from these scripts. Also, keep in mind that the Network Service account might not have the user right required to perform one or more of the actions in the script. In such cases you need to either modify the script or grant the user rights to the Network Service account. When possible you should modify the script because granting additional user rights to an account makes it more vulnerable to attack. If you need to grant a user right, from a command prompt, type:CACLS "%DIR%" /C /E /G "NT AUTHORITY\NetworkService":permission
Other scripts are executed in a new process in the logon session of an individual virtual machine, which runs under the user account configured for that virtual machine. Because the user account might not have the permission required to display UI, you also should not try to display UI from these other scripts."
Configuring constrained delegation
In "Configuring constrained delegation" in the Virtual Server 2005 Administrator's Guide, there is an error in "Step 3: Allow the Virtual Server service to delegate a user's credentials to another computer."
The current instruction is as follows:
-
Type the name of the computer running the Virtual Server service, and then click OK.
The correct instruction is as follows:
-
Type the name of the computer hosting the resource files, and then click OK.
Virtual Machine Additions setup change affects information for Virtual Server Migration Toolkit users
Virtual Machine Additions in R2 is installed as part of the .msi setup package instead of through the Virtual Machine Additions .iso image file. As a result, the instructions in the topic "Load Virtual Machine Additions" in the Virtual Server Migration Toolkit help (Vsmt.chm) are incorrect.
Correction: Instead of capturing the .iso and copying files from that source, you will need to copy the following files from a guest operating system on which Virtual Machine Additions is installed. Vmsrvc.sys is located in the %systemroot%\System32\Drivers folder of the guest operating system. Msvmscsi.sys is located in the %systemdrive%\Program Files\Virtual Machine Additions folder of the guest operating system.
The instructions for pasting them to the Deployment Agent repository folder remain the same.
Copyright
This document is provided for informational purposes only and Microsoft makes no warranties, either express or implied, in this document. Information in this document, including URL and other Internet Web site references, is subject to change without notice. The entire risk of the use or the results from the use of this document remains with the user. Unless otherwise noted, the example companies, organizations, products, domain names, e-mail addresses, logos, people, places, and events depicted herein are fictitious, and no association with any real company, organization, product, domain name, e-mail address, logo, person, place, or event is intended or should be inferred. Complying with all applicable copyright laws is the responsibility of the user. Without limiting the rights under copyright, no part of this document may be reproduced, stored in or introduced into a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording, or otherwise), or for any purpose, without the express written permission of Microsoft Corporation.
Microsoft may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from Microsoft, the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property.
© 2005 Microsoft Corporation. All rights reserved.
Microsoft, MS-DOS, Windows, Windows NT, and Windows Server are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.
All other trademarks are property of their respective owners.