Install Worker on a Windows Image

Overview

Use the Workload Manager installer executable cliqr_installer.exe to create Workload Manager-enabled Windows images on different clouds and regions.

The Windows worker installer is compatible with these releases of Windows Server:

  • Win2k8
  • Win2k12
  • Win2k16

Cloud Nuances

  •  vCenter Installation Nuances

    You must first install VMware tools on the VM.

Installation Process

This procedure may differ based on your cloud and your Windows version. This procedure provides a point of reference to install the WINDOWS_WORKER_OS_VERSION image.

To install the worker on a Windows image, follow this procedure:

  1. Download the artifacts.zip file from software.cisco.com and unzip it to obtain the installer package (cliqr_installer.exe).

    You should only run the cliqr_installer.exe package once on a clean image. Do not attempt to run the installer twice on the same image.


  2. Launch a base Windows image from the Cloud Provider Console. The following image is an example for OpenStack.

  3. Workload Manager requires PowerShell 4.0 or above on W2k12R2 or W2k16. Verify that you are running the correct version of PowerShell:

    PS C:\> $PSVersionTable.PSVersion
    
    Major Minor Build Revision 
    ----- ----- ----- -------- 
    4  0  -1  -1
  4. Verify that the C:\PROGRA~1 path is resolvable to C:\Program Files.

    dir "C:\PROGRA~1"

    Otherwise, you must create the corresponding link:

    mklink /J "C:\PROGRA~1" "C:\Program Files"
  5. Download CloudCenter Tools as directed by CloudCenter Support.


  6. Go to the command prompt window and run the downloaded file:
    C:\<path to the file>\cliqr_installer.exe /CLOUDTYPE=openstack (or other cloud) /CLOUDREGION=default
    (The other cloud options are: amazon, azurerm, google, openstack, vmware)

  7. Run the Installer. You may optionally add the IIS installation (depends on your deployment).

     Additional steps if using Windows 2016 Image on AWS
     Additional steps if using a Windows Azure Image
    • The following extra steps are required if configuring W2k12R2 or W2k16 application VM image in AzureRM.

       Windows 2012 R2 worker image in Azure
      1. Open Server Manager and start/open the Add Roles and Features Wizard.

      2. Click Next at the Before you begin pane.

      3. Select Role-based or feature-based installation on the Installation type pane and click Next .

      4. Select the Select a server from the server pool option in the Server Selection pane.

      5. In the Server Roles pane, select Web Server (IIS), and add all roles under Application Development.

      6. Click Next to proceed to the Features pane.

      7. In the Internet Information Services pane, expand Web Management Tools, and select IIS Management Console.

      8. Select Add Features and select:
        1. .NET Framework 3.5 Features, add .NET Framework 3.5

        2. .NET Framework 4.5 Features, add ASP.NET 4.5

    • Remove the installer.exe file.

    • Go to Control Panel > System and Security > System > Allow Remote Access. Uncheck the check box to Allow connections only from computers running Remote Desktop with Network Level Authentication. This action allows you to RDP into the VM from the CloudCenter UI.
    • In the file explorer go to C:\Windows\System32\Sysprep. Double click on sysprep. Make sure you choose the options displayed in the image below. Once sysprep is done, your RDP session will terminate

       

    • Go to the Azure Management UI and shutdown the application VM image.

  8. After installing the agent, verify the following post-installation information.

    If this information remains unverified, be aware that the agent may not be successfully installed.

    Ensure that the CliQr Startup Service starts up using the Automatic (Delayed Start) type – if not, set it to Automatic(Delayed Start)

  9. Capture an image of the Worker VM.

  10. After creating the image, use the Image ID to map the corresponding Workload Manager logical image to this physical image (Workload Manager UI > Admin > Images > Manage Cloud Mapping > Add/Edit Mapping). See Cloud Mapping for Images for additional context).


  • No labels
© 2017-2019 Cisco Systems, Inc. All rights reserved