Configure UCT-V in Azure

Ensure that UCT-V is registered via the registered UCT-V Controller and communicates through PORT 8891.

Note:  Deployment of UCT-Vs through third-party orchestrator is supported on both Linux and Windows platforms. For details, refer to Linux UCT-V Installation and Windows UCT-V Installation Using MSI Package.

To register UCT-V in Azure Portal, use one of the following methods.

Register UCT-V during Virtual Machine Launch

Note:  Registering UCT-V during Virtual Machine Launch is not applicable for Windows Agents. You can register your Windows Agents after launching the Virtual machine, using a configuration file.

In your Azure portal, you can launch the UCT-V init virtual machine and register the UCT-V using custom data.

Follow these steps:

  1. In the Virtual machines page of the Azure Portal, select Create then Virtual machine. The Create a Virtual Machine page appears. For details, refer to Create virtual machine topic in Azure Documentation.
  2. On the Advanced tab, enter the Custom Data as text in the following format and deploy the virtual machine. The UCT-V uses this custom data to generate config file (/etc/gigamon-cloud.conf) used to register with GigaVUE‑FM.
    Copy
    #cloud-config
     write_files:
     - path: /etc/gigamon-cloud.conf
       owner: root:root
       permissions: '0644'
       content: |
         Registration:
            groupName: <Monitoring Domain Name>
            subGroupName: <Connection Name>
            user: <Username>
            password: <Password>
            remoteIP: <IP address of the UCT-V Controller 1, <IP address of the UCT-V Controller 2>
            remotePort: 8891

Note:  Ensure to configure User and Password in the User Management page. For details, refer to Configure Role-Based Access for Third Party Orchestration. Enter the UserName and Password created in the Add Users Section.

Register UCT-V after Virtual Machine Launch

Note:  You can configure more than one UCT-V Controller for a UCT-V, so that if one UCT-V Controller goes down, the UCT-V registration will happen through another Controller that is active.

To register UCT-V after launching a Virtual Machine using a configuration file, follow the steps given below:

  1. Install the UCT-V in the Linux or Windows platform. For details, refer to Linux UCT-V Installation and Windows UCT-V Installation.

  2. Log in to the UCT-V. For details, refer to Default Login Credentials for UCT-V Controller.
  3. Create a local configuration file and enter the following custom data.
    • /etc/gigamon-cloud.conf is the local configuration file in Linux platform.
    • C:\ProgramData\uctv\gigamon-cloud.conf is the local configuration file in Windows platform.
    • When creating C:\ProgramData\uctv\gigamon-cloud.conf file, ensure that the file name extension is .conf. To view the file name extension in Windows, follow these steps:
      1. Go to File Explorer and open the File Location.
      2. On the top navigation bar, click View.
      3. In the View tab, enable the File name extensions check box.

    Copy
    Registration:
        groupName: <Monitoring Domain Name>
        subGroupName: <Connection Name>
        user: <Username>
        password: <Password>
        remoteIP: <IP address of the UCT-V Controller 1>, 
               <IP address of the UCT-V Controller 2>
        remotePort: 8891

    Note:  Ensure to configure User and Password in the User Management page. For details, refer to Configure Role-Based Access for Third Party Orchestration. Enter the UserName and Password created in the Add Users Section.

  4. Restart the UCT-V service.
    • Linux platform: 
      $ sudo service uctv restart
    • Windows platform: Restart from the Task Manager.
The deployed UCT-V registers with the GigaVUE‑FM through the UCT-V Controller. After successful registration, the UCT-V sends heartbeat messages to GigaVUE‑FM every 30 seconds. If one heartbeat is missing, UCT-V status appears as 'Unhealthy'. If more than five heartbeats fail to reach GigaVUE‑FM, GigaVUE‑FM tries to reach the UCT-V and if that fails as well then GigaVUE‑FM unregisters the UCT-V and removes it from GigaVUE‑FM.