After you publish your initial RDS-enabled image and create farms using it, you can make changes to that image and push the changes to the existing farms. A typical reason to update an already published image is to install additional third-party applications or other features.

Prerequisites

Verify you have the administrator account credentials to log in to the image and update it. This administrator account must be the same one that was used to publish the image using the New Image workflow. See Convert a Configured Master Virtual Machine to an Assignable Image.

Note:

When using the Microsoft Remote Desktop Client as your RDP software to connect to the master VM, ensure it is the most up-to-date version. For example, the default RDP software in the Windows 7 operating system is not at a high enough version. The version must be version 8 or higher.

Procedure

  1. In the Administration Console, navigate to Inventory > Images.
  2. Click the image's name to open up its details page.
  3. On the image's details page, click ... > Take Offline.

    Taking the image offline prevents the farms that are using this image from creating new servers based on this image while you are updating it.

  4. Click Publish.

    A window opens and the VM begins powering on.

  5. Wait until the window reflects that the VM is fully powered on.
  6. When the image is powered on, use the VM's IP address and your RDP software to connect to the RDS-enabled Windows server operating system.
    • If the master image VM was created with a public IP address, you can use that IP address in your RDP software

    • If the master image VM has a private IP address, you must RDP into it by one of these two methods:

      • Using another VM in your Microsoft Azure subscription that does have a public IP address and doing an outbound RDP into the master image VM.

      • Use your VPN and RDP into the master image VM over your corporate network

  7. Log in to the RDS-enabled Windows server operating system using the username and password that was supplied in the Import Image wizard.

    Enter the username as \username.

  8. In the Windows server operating system, perform your intended updates.

    If you are installing additional third-party applications, see the steps described in Customize the Guest Windows Operating System of the Master Image Virtual Machine.

  9. Return to the Administration Console and click Publish.

Results

The updated image is re-published to the system. Any farms using the image automatically delete and re-create their server instances using the updated image.