To deploy a Unified Access Gateway instance to the Compute Engine, you must upload a Unified Access Gateway appliance disk image to the Google Cloud Platform.

Procedure

  1. Download the Unified Access Gateway.ova image file, version 2103 or later, from the Customer Connect page.
  2. Open a PowerShell command window and run the following command to extract the .vmdk file from the previously downloaded .ova file.
    • ova-filename is the .ova image file which is downloaded from Customer Connect.
    • target-location is the location to which the .vmdk file is extracted.
    Windows Ubuntu
    expand-7zip ova-filename target-location

    For example, euc-unified-access-gateway-22.12.0.0-42741890_OVF10.ova is the downloaded file, where, 22-12 is the version number and 42741890 is the build number.

    To extract the .vmdk file to C:\temp, run the following command:
    expand-7zip C:\temp\euc-unified-access-gateway-22.12.0.0-42741890_OVF10.ova C:\temp\
    tar -xvf ova-filename
    For example,
    tar -xvf euc-unified-access-gateway-22.12.0.0-42741890_OVF10.ova 
  3. Set the following variables.
    • $gcImageFile is the filename of the .vmdk file extracted in step 2.
    • $gcImageFolder is the folder path of the .vmdk file.

    For example:

    $gcImageFolder="C:\temp"
    $gcImageFile="euc-unified-access-gateway-22.12.0.0-42741890-system.vmdk"
    $gcBucket="uag-appliance-images"
    $gcImageName=$gcImageFile.Replace("-system.vmdk","").Replace(".", "-")
    gcloud auth login
    gcloud config set project "my-project"
    
  4. Create a Google Cloud storage bucket.
    Note: You can also deploy Unified Access Gateway with compute image hosted on another Google Cloud project. In such case, specify the compute image name ( $gcImageName) and the hosting Project ID during Unified Access Gateway deployment.

    Run this command to create storage bucket in the same project.

    gsutil mb -l us-east1 gs://$gcBucket

    Run this command to create storage bucket in a differnt project.

    gsutil mb -l us-east1 gs://$gcBucket -p my-image-hosting-project
  5. Upload the .vmdk image to the Google Cloud storage bucket by using the following command:
    gsutil cp $gcImageFolder\$gcImageFile gs://$gcBucket
  6. Create the appliance image in the Compute Engine from the uploaded .vmdk.

    Run this command to import image in the same project.

    gcloud compute images import $gcImageName --source-file gs://$gcBucket/$gcImageFile --data-disk
    Run this command to import image in a different project.
    gcloud compute images import $gcImageName --source-file gs://$gcBucket/$gcImageFile --data-disk --project my-image-hosting-project
    Note: When you import a compute image, you can specify the subnet to be used for the temporary VMs created by the import tool. Use the flag --subnet as shown in the following example.
    gcloud compute images import $gcImageName --source-file gs://$gcBucket/$gcImageFile --data-disk --subnet default
    For more information about these commands, see Google Cloud SDK documentation.

    Considering the example mentioned in the previous steps, the appliance image created in the Compute Engine is euc-unified-access-gateway-22-12-0-0-42741890 where 22-12 is the version number and 42741890 is the build number.