Home / Working with the Visual Studio 2017 (Winter Update) Virtual Machine

Overview

The Microsoft® Visual Studio® ALM/DevOps Virtual Machine is a single virtual machine image that contains fully installed and configured copies of the software listed below. This virtual machine requires Hyper-V, and can be used with Windows Server 2008 R2 SP1, Windows 8 (SLAT-capable processor required)/Windows Server 2012, Windows 8.1/Windows Server 2012 R2, Windows Server 2016, or Windows 10. The detailed instructions in this document assume that you are using Windows 10, although the instructions are similar for other operating systems.

The 2017 (Winter Update) virtual machine contains the following pre-configured software:

  1. Microsoft Windows Server 2016 Standard Evaluation

  2. Microsoft Visual Studio Enterprise 2017 (15.5)

  3. Microsoft Visual Studio Team Foundation Server 2018

  4. Microsoft Office Professional Plus 2016 (Word, PowerPoint, Excel, Outlook)

  5. Microsoft SQL Server 2016 Standard

  6. Sample users and data required to support hands-on-lab scripts which accompany this download.

Activation

The virtual machine requires online activation if you wish to use it more than 10 days. For this to occur, your VM will need to be connected to a virtual network that has Internet access. We strongly recommend that you only connect this virtual machine to the Internet temporarily and promptly disable Internet access once activation is complete. Please refer to the section “Configure this Virtual Machine with Hyper-V” below for more information.

Expiration

If you choose to activate your virtual machine, it will begin a 180-day trial of Windows Server 2012 Standard Evaluation. After the 180 days is over you will need to stop using this virtual machine.

Rollback

It is strongly recommended that you implement a rollback strategy for restoring this virtual machine to a previous point in time. This is helpful in case you make a mistake, or if you want to reset the state of the original sample data contained within this virtual machine. Hyper-V uses a concept called checkpointing. The hands-on-labs which were built for use with this virtual machine were tested using a “clean” state of the virtual machine; therefore it is recommended that you restore to a clean checkpoint before you start each hands-on-lab. See the section titled “Working with Checkpoints” below for more information.

Labs/Demo Scripts

A set of hands-on-lab documents, which also function as demo scripts, are available for download along with this virtual machine. The latest version of these documents can be downloaded from here. These hands-on-labs provide a guided experience for you to learn about the new application lifecycle management capabilities of Visual Studio 2017, as well as application lifecycle management features which have been introduced since Visual Studio 2010.

You will want to provide as much RAM as possible to this virtual machine. A minimum of 8GB is suggested. But you should not allocate all of your physical memory to a virtual machine or you can “starve” your host machine of the RAM it needs to complete other tasks. For example, if you have 16GB of physical memory on your computer then a good allocation for your virtual machine might be 12GB. This can be a process of trial and error.

By default, when you import this virtual machine it will be configured with a certain amount of RAM and number of virtual processors. If you have the necessary hardware, you can increase this allocation after the import step by using the Hyper-V console and accessing the settings for this virtual machine.

If you have more than one hard drive, place the VHD file on a physical drive that is different from your system drive. Use the drive with the faster spindle rate if it is a mechanical drive or use an SSD drive. If you use an external hard drive, faster interfaces such as eSata or Firewire 800 will work better. Be careful with slower laptop drives and USB 1.1 interfaces.

Test Requirement for Hyper-V Host Machine
Operating System Microsoft Windows® Server 2008 R2 with the Hyper-V role enabled
Microsoft Windows® Server 2012 with the Hyper-V role enabled
Microsoft Windows® 8 with Hyper-V enabled
Microsoft Windows® 8.1 with Hyper-V enabled
Microsoft Windows® Sever 2012 R2 with Hyper-V enabled
Microsoft Windows® 10 with Hyper-V enabled
Microsoft Windows® Sever 2016 with Hyper-V enabled
Drive Formatting NTFS
Processor Intel VT or AMD-V capable, *SLAT-capable CPU required if using Windows 8*
RAM 8 GB of free physical RAM (9 GB or more recommended)
Hard disk space required for install 80 GB (more if using checkpoints)

How to Log In

Select the user you want to log in as and the password box will appear. All accounts use the same password: P2ssw0rd (capital letter P, the number two, the letter s, the letter s, the letter w, the number zero, the letter r, and the letter d).

Configuring the Virtual Machine with Hyper-V

This section lists the tasks that you must perform using a server with the Hyper-V role enabled.

1. Import and configure the Virtual Machine

Due to the activation and expiration models in Windows Server, it’s highly recommended that you do one of the following: - Retain a copy of the unaltered VM - Create and retain a checkpoint from before first run of the VMs

a. Under Actions, click Import Virtual Machine

b. If you are going to import to a Windows Server 2008 R2 machine, move the VHD file from the WMIv2\\Virtual Hard Disks folder to the WMIv1\\Virtual Hard Disks folder

c. Use the Browse button to select the folder where the virtual machine package was extracted. Keep default settings. Browse to either the “WMIv1” or “WMIv2” folder depending upon if you are going to import to Server 2008 R2 or Windows8.1/Server 2012 R2 (or later), respectively

d. Click Select Folder when you have browsed to this path.

e. Click Next through each remaining page of the import wizard, then Finish, and wait for the import operation to complete.

f. The new virtual machine will show up in your Virtual Machines list.

g. Optionally, you can right-click this virtual machine to configure various Settings. For example you may wish to increase the number of virtual processors (depending on your hardware) or adjust the amount of RAM allocated to this virtual machine. Read the “Recommended System Configuration” section above for tips about RAM allocation.

h. Start the virtual image.

i. Once the machine starts, log in as Sachin. All passwords are P2ssw0rd.

j. After you login it may take a few minutes to finish the configuration install new drivers. Once done, you may be prompted to reboot.

k. After reboot the machine is ready to use.

2. Activate the operating system.

This step should be automatic once you connect the VM to the Internet.

a. Open the Hyper-V Manager on the host.

b. Select the VM in the Virtual Machines pane

c. Click Settings in the Actions pane.

d. Configure the network adapter to use an external network adapter. *(For information on how to configure an external network adapter with Hyper-V please consult the Hyper-V documentation)*

e. Your settings should resemble the following screenshot (the actual name of your external network may vary)

f. Click OK to close the settings dialog.

g. Start the virtual machine if it isn’t already running.

h. Once the machine starts, log in as Sachin. All passwords are P2ssw0rd.

i. Typically, you can simply give the guest OS a few minutes in order to automatically activate the 180 day trial, but you can always double-check in the Control Panel.

j. From the Start menu, open the Control Panel.

k. Double-click on the System control panel applet.

l. If necessary, click on Activate Windows Now at the bottom of the System applet.

m. Click on Activate Windows online now. If you have successfully enabled Internet access for your virtual machine then this step should just take a few moments.

n. Your virtual machine will now remain active for up to 180 days from this point in time. You can confirm this by looking at the bottom of the System control panel applet.

o. Proceed to step 3 below to configure your virtual machine for use with an internal network adapter. Step 3 is very important since there is no active virus protection software on this virtual machine, and it may not contain the latest security patches, so you shouldn’t leave this virtual machine in an Internet-facing state.

3. Configure an internal network adapter

a. Open the Hyper-V Manager on the host.

b. Select the VM in the Virtual Machines pane.

c. Click Settings in the Actions pane.

d. Configure the network adapter to use an internal network adapter. *(For information on how to configure an external network adapter with Hyper-V please consult the Hyper-V documentation)*

e. Your settings should resemble the following screenshot (the actual name of your internal network may vary)

f. Click OK to close the settings dialog.

g. It is highly recommended that you now take a checkpoint of the virtual machine so that you can return to this state later if you need to. See “*Working with Checkpoints*” below for more information.

Working with Checkpoints

Hyper-V introduces the concept of “checkpoints” which can be used to revert a virtual machine to a previous configuration state. The hands-on-labs which were built for use with this virtual machine were tested for use with a “clean” state of the virtual machine; it is recommended that you restore to a clean checkpoint before you start each hands-on-lab. As delivered, this virtual machine does not include any checkpoints.

Note that having many checkpoints can adversely affect performance. You can delete checkpoints you no longer need and Hyper-V will merge these when the VM is not running.

Tasks Detailed Steps

1. Create a Checkpoint

a. Prepare the VM(s) in the state you wish to capture.

b. Open or return to the Hyper-V Manager

c. Select the VM and click Checkpoint under Actions.

d. Wait for the checkpoint captures to complete.

e. (optional) Right-click a checkpoint to rename it.

2. Apply a Checkpoint

a. Open or return to the Hyper-V Manager

b.Select the VM, right-click on the checkpoint you wish to use, and choose Apply. You will be prompted to save the current state as a checkpoint. Doing so will retain your current state, skipping will discard it.

Date and Time

Previous versions of this virtual machine were hard-coded to boot up with a specific demo date that was in the past. This updated version of the virtual machine will match the real-world date and time by default, eliminating many of the headaches associated with being disconnected from the real-world date. Only one lab requires the date to be set specifically to a certain demo date (the Agile Planning and Portfolio Management lab), and instructions for how to do this are provided at the beginning of that lab.

Feedback

If you have comments or general feedback, please e-mail devopsdemos@microsoft.com.