Deploying a BMC Discovery VA into Microsoft Azure

This topic describes the steps required to deploy a BMC Discovery virtual appliance (VA) into the Microsoft Azure cloud. It contains the following sections:

To deploy a BMC Discovery VA into Microsoft Azure

Convert the Discovery VMDK file to VHD

Microsoft Azure requires the disk image to be in VHD format, rather than the VMDK format in which the BMC Discovery VA is supplied. This procedure assumes you have downloaded a BMC Discovery VA from https://www.bmc.com/available/epd.html

  1. Download the Microsoft Virtual Machine Converter from:
    https://www.microsoft.com/en-us/download/confirmation.aspx?id=42497
    and install it on a Windows computer.
  2. Extract the BMC Discovery virtual appliance zip file to a temporary location.
  3. Open a PowerShell prompt as administrator and run:

    Import-Module 'C:\Program Files\Microsoft Virtual Machine Converter\MvmcCmdlet.psd1'
  4. Convert the VMDK file to VHD. In this command you should replace the file locations and names appropriate to the computer you are using and the version of BMC Discovery that you have downloaded. Enter:

    ConvertTo-MvmcVirtualHardDisk `
            -SourceLiteralPath C:\temp\ADDM_VA_64_11.2.0.2_722067_ga_Full-disk-0.vmdk `
            -VhdType DynamicHardDisk `
            -VhdFormat vhd -destination C:\temp\Discovery_11_2_0_2.vhd

Upload the VHD file to Microsoft Azure

This procedure uploads the VHD file to a new Storage Account and Resource Group in Microsoft Azure.

  1. Open a PowerShell prompt as administrator.
  2. Install the PowerShell modules for Microsoft Azure. At the PowerShell prompt, run:

    Install-Module AzureRM
    Install-Module AzureRM.Compute

    For more information, see https://docs.microsoft.com/en-us/powershell/azure/install-azurerm-ps. Depending on the version of Windows that you are using, you might need to install an updated version of PowerShell.

  3. Log in to your Microsoft Azure account. Enter:

    Login-AzureRmAccount
  4. Set some variables to be used in the following commands, changing the region as required. The Storage Account name must be unique in Azure. Enter:

    $UploadRGName = "DiscoveryUpload"
    $UploadRegion = "West US"
    $UploadStorageAccount = "discoveryuploadstorage"
  5. Create a new Resource Group. Enter:

    New-AzureRmResourceGroup -Name $UploadRGName -Location $UploadRegion
  6. Create a new Storage Account. Enter:

    New-AzureRmStorageAccount -ResourceGroupName $UploadRGName `
            -Name $UploadStorageAccount -Location $UploadRegion `
            -SkuName "Standard_LRS" -Kind "Storage"
  7. Set a variable for the upload destination. Replace the version number in the .vhd file name to match the version of BMC Discovery that you are uploading. Enter:

    $VHDurl="https://$UploadStorageAccount.blob.core.windows.net/discoveryupload/discovery11_2_0_2.vhd"
  8. Upload the VHD file. Replace the path to the .vhd file as required. Enter:

    Add-AzureRmVhd -ResourceGroupName $UploadRGName -Destination $VHDurl `
            -LocalFilePath C:\temp\Discovery_11_2_0_2.vhd

Create an Azure image from the uploaded VHD

The following steps create an Azure Image that can be used to deploy BMC Discovery VM instances.

  1. Create a new image configuration. Enter:

    $imageConfig = New-AzureRmImageConfig -Location $UploadRegion
  2. Configure the OS disk for the image. Enter:

    $imageConfig = Set-AzureRmImageOsDisk -Image $imageConfig `
            -OsType Linux -BlobUri $VHDurl
  3. Create the Image. Replace the Image name and Resource Group name values as required. 

    $image = New-AzureRmImage -ImageName Discovery-11-2-0-2-Image `
            -ResourceGroupName $UploadRGName -Image $imageConfig

Create a new VM from the Azure image

The following steps create an Azure Virtual Machine from the image.

  1. In the Azure Portal, navigate to the upload Resource Group DiscoveryUpload and locate the image created in the previous steps.
  2. Click through to the image and click Create VM.
  3. Set values as required for the VM. Specify a username and use password authentication. The username and password are required by Microsoft Azure for the deployment, but the user is not created. Any valid values for the username and password can be used.
  4. Set a size for the VM according to your requirements.
  5. Set the Networking values for the VM. 

    It is safest to not configure a Public IP address at this point.
    However, If you do choose to have a Public IP address for the machine, you should modify the default inbound security rule to restrict SSH access appropriately, for example, restricted to the IP address from which you plan to access it.

  6. Set any other options as required. The storage for the VM is set as Managed Disk and cannot be changed.
  7. Proceed to create the VM. 

    The deployment job shows as failed unless the Azure Virtual Machine Agent is installed on the BMC Discovery VM before the deployment timeout period (approximately 30 minutes). This failure is not a problem, and after installing the agent in the following section the VM is reported to be "Running OK".

Install the Azure Virtual Machine Agent 

The following steps install the Azure Virtual Machine Agent.

  1. Determine the public or private IP address for the VM by viewing it in the Azure Portal. The type of IP you use depends on how you configured networking for the VM. If you are using the private IP, you must use another machine on the same network to connect to the VM using SSH.
  2. Using SSH, connect to the Discovery appliance as the tideway user and log in with the default password tidewayuser. On the first login, you are forced to change the password. Reconnect after you have changed the password.
  3. Change to the root user and specify a login shell.

    Ensure that you make the root user's shell a login shell. The login shell prevents the root user inheriting the tideway user's environment. If you do not use a login shell, the Azure Virtual Machine Agent is installed in the wrong location and will fail to start.

    Enter:

    su --login root

    and enter the default root password tidewayroot. You are prompted to set a new password for the root user.

  4. Run the following commands to install pip, which is required for the agent installation:

    cd /tmp
    wget https://bootstrap.pypa.io/get-pip.py
    python get-pip.py
  5. Run the following commands to download and install the Azure agent:

    wget https://github.com/Azure/WALinuxAgent/archive/v2.2.18.zip
    unzip v2.2.18.zip
    cd WALinuxAgent-2.2.18
    python setup.py install
  6. Edit /etc/waagent.conf and set:

    Provisioning.Enabled=n
    ResourceDisk.EnableSwap=y
    ResourceDisk.SwapSizeMB=4096    # Set to value appropriate
                                    # for VM size  
  7. Configure the agent to start at boot by running this command:

    chkconfig waagent on
  8. Start the agent:

    service waagent start
  9. Ensure the agent service is running:

    service waagent status

  10. If the VM deployment job failed because the agent was not installed within the timeout period, and the VM still shows as failed after some time has passed, restart the VM from the Azure Portal. This should clear the failed state, and show it as running.

Was this page helpful? Yes No Submitting... Thank you

Comments