Deploy Security Connector on Microsoft Hyper-V

The ZIP file you downloaded contains these files:
  • PowerShell Utility Script: create-akamai-sc-vm.ps1
  • Virtual Hard Disk Image File: akamai-sc-<imageID>.vhd

    where <imageID> is the ID of the hard disk image file.

You can deploy Security Connector with the PowerShell utility script or manually with a virtual hard disk image file.

Create the Security Connector virtual machine with the PowerShell utility script

Before you begin

  1. Download Security Connector
  2. Confirm that the folder you extracted contains the create-akamai-sc-vm.ps1 file.

You can use the PowerShell utility script to create the Security Connector virtual machine.
Note: The PowerShell utility script is not supported with Microsoft Hyper-V on Windows Server 2008. If you plan to deploy Hyper-V on Windows Server 2008, use the virtual hard disk image file and deploy it manually. For instructions, see Manually create the Security Connector virtual machine with the hard disk image file.

How to

  1. Open a PowerShell window.
  2. Type this command to execute the script:
    <path_to_unzipped_folder>/create-akamai-sc-vm.ps1

    where <path_to_unzipped_folder> is the path to the folder with the PowerShell script

  3. If you see "The script is not digitally signed. You cannot run this script on the current system" error message, complete these steps to set the execution policy to bypass.
    1. In the PowerShell window, enter this command:
      Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
    2. When prompted for confirmation, enter Y and press Enter.
  4. When prompted, enter the VM name, disk path, and virtual switch name. The VM is created.
  5. Open Hyper-V Manager.
  6. Select the virtual machine and in the Actions menu, click Start. After starting the VM, in the Actions menu, click Connect to access the VM. It may take a few minutes for the machine to start.
    Ignore any errors that may appear while the virtual machine boots.

Next steps

Create a Security Connector password

Manually create the Security Connector virtual machine with the hard disk image file

Before you begin

  1. Download Security Connector
  2. Confirm that the folder you extracted contains the akamai-sc-<imageID>.vhd file, where <imageID> is the ID associated with the image.

You can manually deploy the Security Connector virtual machine with the hard disk image file. These instructions apply to Microsoft Hyper-V on Windows Server 2016. These steps may vary on other versions of Windows or Windows Server.
Note: The virtual hard disk file image file that’s used to create the virtual machine is the hard disk drive for the virtual machine. Therefore, the changes you make to the virtual machine are saved to the hard disk or the image file. If you need to create a new Security Connector virtual machine, make sure you download a new image file.

How to

  1. Open Hyper-V Manager.
  2. Select the computer or local server where you’re deploying the virtual machine.
  3. In the Actions menu, select New > Virtual Machine.
  4. Review the Before You Begin content and click Next.
  5. In the Specify Name and Location window, enter a name for the VM and click Next.
  6. In the Assign Memory window, enter 2048 in the Startup Memory field and click Next.
  7. In the Configure Networking window, select the virtual switch that you want from the Connection menu, and click Next.
  8. In the Connect Virtual Hard Disk window, complete these steps:
    1. Select Use an existing virtual hard disk option and click Browse.
    2. Browse to the akamai-sc-<imageID>.vhd file, where <imageID> is the ID associated with the virtual hard disk image file.
    3. Click Open.
    4. Click Next
  9. Review the summary with the details you selected for the VM. Click Finish.
  10. Modify the number of virtual processors:
    1. Select the VM that was created in step 9 and in the Actions menu, click Settings.
    2. In the Hardware menu, select Processor.
    3. In the Number of virtual processors field, enter 2 and click Apply.
  11. Update the network adapter settings:
    1. In the Hardware menu, click Add Hardware.
    2. Select Network Adapter and click Add.
    3. Select the network adapter you added.
    4. Select the virtual switch. Depending on your network topology, this may be the switch you added in step 7.
    5. Click Apply and then click OK.
  12. Select the virtual machine and in the Actions menu, click Start. After starting the VM, in the Actions menu, click Connect to access the VM. It may take a few minutes for the machine to start.
    Ignore any errors that may appear while the virtual machine boots.

Next steps

Create a Security Connector password