Configure GigaVUE Fabric Components in AWS

You can use your own AWS orchestration system to deploy GigaVUE fabric nodes and use GigaVUE-FM to configure the advanced features supported by these nodes. These nodes register themselves with GigaVUE-FM using the information provided by your AWS orchestration system. Once the nodes are registered with GigaVUE-FM, you can configure monitoring sessions and related services in GigaVUE-FM. Health status of the registered nodes are determined by the heartbeat messages sent from the respective nodes.

Note: Deployment of GigaVUE fabric components through a third-party orchestrator is supported on Linux and Windows platforms. Refer to Linux G-vTAP Agent Installation and Windows G-vTAP Agent Installation for detailed information.

In your AWS EC2, you can configure the following GigaVUE fabric components:

Configure GigaVUE V Series Nodes and V Series Proxy in AWS
Configure G-vTAP Controller in AWS
Configure G-vTAP Agent in AWS

Configure GigaVUE V Series Nodes and V Series Proxy in AWS

To configure GigaVUE V Series Nodes and V Series Proxy in AWS platform:

Before configuring GigaVUE fabric components through AWS, you must create a monitoring domain in GigaVUE-FM. Refer to Create a Monitoring Domain for detailed instructions.

Note: You can use AWS Orchestrator for GigaVUE fabric node configuration only using V Series 2 nodes.
In the Monitoring Domain Configuration page, select No for the Use FM to Launch Fabric field as you are going to configure the fabric components in AWS Orchestrator.
In your AWS environment, you can deploy GigaVUE V Series Nodes or V Series proxy using the following methods:
- Register GigaVUE V Series Nodes or Proxy using User Data
- RegisterGigaVUE V SeriesProxy using a configuration file

Note: When using VPC mirroring as the traffic acquistion method, add a tag with key GigamonNode and value VSeriesNode to the V Series Node or Proxy created on the platform.

Register GigaVUE V Series Nodes or Proxy using User Data

To register GigaVUE V Series Nodes or proxy using the user data in AWS GUI:

On the Instances page of AWS EC2, click Launch instances. The Launch Instance wizard appears. For detailed information, refer to Launch an instance using the Launch Instance Wizard topic in Amazon EC2 Documentation.
On the Step 3: Configure Instance Details tab, enter the User data as text in the following format and deploy the instance. The GigaVUE V Series Nodes or V Series proxy uses this user data to generate config file (/etc/gigamon-cloud.conf) used to register with GigaVUE-FM.
```
#cloud-config
```
```
write_files:
```
```
 - path: /etc/gigamon-cloud.conf
```
```
 owner: root:root
```
```
 permissions: '0644'
```
```
 content:
```
```
     Registration:
```
```
	groupName: <Monitoring Domain Name>
```
```
	subGroupName: <VPC Name>
```
```
	user: <username>
```
```
	password: <passoword>
```
```
	remoteIP: <IP address of the GigaVUE-FM>
```
```
	remotePort: 443
```
- You can register yourGigaVUE V Series directly with GigaVUE‑FM or you can use V Series proxy to register yourGigaVUE V Series with GigaVUE‑FM. If you wish to registerGigaVUE V Series directly, enter the remotePort value as 443 or if you wish to deployGigaVUE V Series using V Series proxy then, enter the remotePort value as 8891.
- Use only the default user and password details given in the user data.
- If there is no monitoring domain in GigaVUE‑FM with the same monitoring domain name and connection name as given in your user data, then GigaVUE‑FM automatically creates a monitoring domain under AnyCloud and your V Series nodes or proxys gets deployed under that monitoring domain.
- In the above mentioned case, the Traffic Acquisition Tunnel MTU is set to the default value 1500. To edit the Traffic Acquisition Tunnel MTU, select the monitoring domain and click on the Edit Monitoring Domain option. Enter the Traffic Acquisition Tunnel MTU and click Save.
You can navigate to Instances > Actions > Instance Settings > Edit user data and edit the user data.

RegisterGigaVUE V SeriesProxy using a configuration file

To registerGigaVUE V SeriesProxy using a configuration file:

Log in to theGigaVUE V SeriesProxy.
Edit the local configuration file (/etc/gigamon-cloud.conf) and enter the following user data.
```
Registration:
```
```
	groupName: <Monitoring Domain Name>
```
```
	subGroupName: <VPC Name>
```
```
	user: <username>
```
```
	password: <password>
```
```
	remoteIP: <IP address of the GigaVUE-FM>
```
```
	remotePort: 443
```
Note: If you wish to registerGigaVUE V Series using V Series proxy then, enter the remotePort value as 8891.
Restart theGigaVUE V Seriesproxy service.
- V Series node:
```
$ sudo service vseries-node restart
```
- V Series proxy:
```
$ sudo service vps stop
```

The deployedGigaVUE V SeriesV Series proxy registers with the GigaVUE-FM. After successful registration theGigaVUE V Seriesproxy sends heartbeat messages to GigaVUE-FM every 30 seconds. If one heartbeat is missing ,the fabric node status appears as 'Unhealthy'. If more than five heartbeats fail to reach GigaVUE-FM, GigaVUE‑FM tries to reach theGigaVUE V Seriesproxy and if that fails as well then GigaVUE‑FM unregisters theGigaVUE V Seriesproxy and it will be removed from GigaVUE‑FM.

Configure G-vTAP Controller in AWS

You can configure more than one G-vTAP Controller in a monitoring domain.

To configure G-vTAP Controller in AWS platform:

Before configuring GigaVUE fabric components through AWS, you must create a monitoring domain in GigaVUE-FM. While creating the monitoring domain, select G-vTAP as the Traffic Acquisition Method. Refer to Create a Monitoring Domain for detailed instructions.
Note: You can use AWS Orchestrator for GigaVUE fabric node configuration only using V Series 2 nodes.
In the Monitoring Domain Configuration page, select No for the Use FM to Launch Fabric field as you are going to configure the fabric components in AWS Orchestrator.
In your AWS environment, launch the G-vTAP Controller AMI instance using any of the following methods:
- Register G-vTAP Controller using User Data
- Register G-vTAP Controller using a configuration file
Register G-vTAP Controller using User Data
To register G-vTAP Controller using the user data in AWS GUI:
1. On the Instances page of AWS EC2, click Launch instances. The Launch Instance wizard appears. For detailed information, refer to Launch an instance using the Launch Instance Wizard topic in Amazon EC2 Documentation.
2. On the Step 3: Configure Instance Details tab, enter the User data as text in the following format and deploy the instance. The G-vTAP Controller uses this user data to generate config file (/etc/gigamon-cloud.conf) used to register with GigaVUE-FM.
```
#cloud-config
```
```
write_files:
```
```
 - path: /etc/gigamon-cloud.conf
```
```
 owner: root:root
```
```
 permissions: '0644'
```
```
 content:
```
```
     Registration:
```
```
	groupName: <Monitoring Domain Name>
```
```
	subGroupName: <VPC Name>
```
```
	user: <username>
```
```
	password: <password>
```
```
	remoteIP: <IP address of the GigaVUE-FM>
```
```
	remotePort: 443
```
  - Use only the default user and password details given in the user data.
  - If there is no monitoring domain in GigaVUE‑FM with the same monitoring domain name and connection name as given in your user data, then GigaVUE‑FM automatically creates a monitoring domain under AnyCloud and your V Series nodes or proxys gets deployed under that monitoring domain.
  - In the above mentioned case, the Traffic Acquisition Tunnel MTU is set to the default value 1500. To edit the Traffic Acquisition Tunnel MTU, select the monitoring domain and click on the Edit Monitoring Domain option. Enter the Traffic Acquisition Tunnel MTU and click Save.
  You can navigate to Instances > Actions > Instance Settings > Edit user data and edit the user data.
The G-vTAP Controller deployed in AWS EC2 appears on the Monitoring Domain page of GigaVUE-FM.
Register G-vTAP Controller using a configuration file
To register G-vTAP Controller using a configuration file:
1. Log in to the G-vTAP Controller.
2. Edit the local configuration file (/etc/gigamon-cloud.conf) and enter the following user data.
```
Registration:
```
```
	groupName: <Monitoring Domain Name>
```
```
	subGroupName: <VPC Name>
```
```
	user: <username>
```
```
	password: <password>
```
```
	remoteIP: <IP address of the GigaVUE-FM>
```
```
	remotePort: 443
```
3. Restart the G-vTAP Controller service.
```
$ sudo service gvtap-cntlr restart
```

The deployed G-vTAP Controller registers with the GigaVUE-FM. After successful registration the G-vTAP Controller sends heartbeat messages to GigaVUE-FM every 30 seconds. If one heartbeat is missing ,the fabric node status appears as 'Unhealthy'. If more than five heartbeats fail to reach GigaVUE-FM, GigaVUE‑FM tries to reach the G-vTAP Controller and if that fails as well then GigaVUE‑FM unregisters the G-vTAP Controller and it will be removed from GigaVUE‑FM.

Note: When you deploy GigaVUE V Series Nodes or G-vTAP Controllers using 3rd party orchestration, you cannot delete the monitoring domain without unregistering the GigaVUE V Series Nodes or G-vTAP Controllers.

Configure G-vTAP Agent in AWS

G-vTAP Agent should be registered via the registered G-vTAP Controller and communicates through PORT 8891.

Deployment of G-vTAP Agents through third-party orchestrator is supported on Linux and Windows platforms.

To register G-vTAP Agent using a configuration file:

Install the G-vTAP Agent in the Linux or Windows platform. For detailed instructions, refer to Linux G-vTAP Agent Installation and Windows G-vTAP Agent Installation.
Log in to the G-vTAP Agent.
Edit the local configuration file and enter the following user data.
- /etc/gigamon-cloud.conf is the local configuration file in Linux platform.
- C:\ProgramData\gvtap-agent\gigamon-cloud.conf is the local configuration file in Windows platform.
```
Registration:
```
```
	groupName: <Monitoring Domain Name>
```
```
	subGroupName: <Connection Name>
```
```
	user: <username>
```
```
	password: <password>
```
```
	remoteIP: <IP address of the G-vTAP Controller 1>, 
		   <IP address of the G-vTAP Controller 2>
```
```
	remotePort: 8891
```
Note: Use only the default user and password details given in the user data.
Restart the G-vTAP Agent service.
- Linux platform:
```
$ sudo service gvtap-agent restart
```
- Windows platform: Restart from the Task Manager.

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

The deployed G-vTAP Agent registers with the GigaVUE-FM through the G-vTAP Controller. After successful registration the G-vTAP Agent sends heartbeat messages to GigaVUE-FM every 30 seconds. If one heartbeat is missing, G-vTAP Agent status appears as 'Unhealthy'. If more than five heartbeats fail to reach GigaVUE-FM, GigaVUE‑FM tries to reach the G-vTAP Agent and if that fails as well then GigaVUE‑FM unregisters the G-vTAP Agent and it will be removed from GigaVUE‑FM.