Console

To add a wire group to an existing cross-site network, do the following:

1. In the Google Cloud console, go to theInterconnect page.

   Go to Interconnect

2. On theCross-site networks tab, click the name of the cross-sitenetwork to which you want to add a wire group.

3. ClickAdd wire group.

4. Specify the basic details of the wire group to add to the cross-site network.

   • Name: a name for the wire group
   • Description: an optional description of the wire group

5. Select eitherVLAN mode orPort mode for your wire group. If necessary, reviewTraffic modes.

6. If you configuredPort mode, review theFailure detectionfield. To enable failure detection, select theDisable portcheckbox.

   When you enable failure detection,Google Cloud continuously monitors each wire and disables a wireif it loses connectivity so that you can fail over to an alternatepath, such as another healthy wire in the group.

7. In theUnmetered bandwidth field, enter the unmetered bandwidth,in Gbps, for the wire group.

   You can't configure bandwidth that exceeds the following:

   • Your quota between a given pair of metros or the limit for a given wire.If you haven't already, follow the instructions tocheck quotas and limits for bandwidth.
   • The Cross-Site Interconnect connection capacity.

   For additional considerations for configuringthis field, seeWire bandwidth.

8. Choose whether to allocate the wire group's bandwidth setting to eachwire or to share the bandwidth between all wires in the group.

   • Allocate per wire. The unmetered bandwidth is allocated to eachwire in the group.
   • Shared with wire group. The unmetered bandwidth is divided equallybetween each wire in the group. However, dynamic throttling allocatesunused unmetered bandwidth to other wires in the group.

9. ClickNext.

10. Specify the Cross-Site Interconnect connections over which to createyour cross-site network.

    1. Select the connections that you created for your first site,Site A.
    2. Select the connections that you created for your second site,Site B.

11. ClickNext.

12. If you configuredVLAN mode, specifyVLAN tags for eachwire in your wire group by entering an integer from2 to4093.

    You can't enter a VLAN tag value that is already in use on the sameCross-Site Interconnect connection.

13. Review the configuration of your wire group, and then clickCreate wire group.

gcloud

Google Cloud CLI procedure overview

To complete the procedure for adding a wire group to an existing cross-site network by using the Google Cloud CLI, do the following:

1. Add a wire group to your cross-site network
2. Add an endpoint and connections for site A to the wire group:
   1. Add an endpoint that represents site A
   2. Add connection A1
   3. Add connection A2
3. Add an endpoint and connections for site B to the wire group:
   1. Add an endpoint that represents site B
   2. Add connection B1
   3. Add connection B2

1. Add a wire group

To add a wire group, use thegcloud compute interconnects wire-groups create command.

  gcloud compute interconnects wire-groups createWIRE_GROUP_NAME \      --cross-site-network=CROSS_SITE_NETWORK_NAME \      --bandwidth-unmetered=UNMETERED_BANDWIDTH \      --bandwidth-allocation=BANDWIDTH_ALLOCATION \      --fault-response=FAILURE_DETECTION \      [--description=DESCRIPTION]

Replace the following:

• WIRE_GROUP_NAME: the name of the wire group.
• CROSS_SITE_NETWORK_NAME: the name of the cross-sitenetwork to add the wire group to.

2a. Add an endpoint for site A

To add an endpoint to the wire group that represents your first site, orsite A, use thegcloud compute interconnects wire-groups add-endpoint command.

  gcloud compute interconnects wire-groups add-endpointWIRE_GROUP_NAME \      --cross-site-network=CROSS_SITE_NETWORK_NAME \      --endpoint-label=ENDPOINT_A_LABEL

Replace the following:

• WIRE_GROUP_NAME: the name of the wire group that youcreated previously
• CROSS_SITE_NETWORK_NAME: the name of the cross-sitenetwork to which you are adding a wire group
• ENDPOINT_A_LABEL: a label for the endpoint, suchasashburn

2b. Add connection A1

To add the first Cross-Site Interconnect connection to thewire group for site A, orconnection A1, use thegcloud compute interconnects wire-groups add-interconnect command.

  gcloud compute interconnects wire-groups add-interconnectWIRE_GROUP_NAME \      --cross-site-network=CROSS_SITE_NETWORK_NAME \      --endpoint-label=ENDPOINT_A_LABEL \      --interconnect-label=INTERCONNECT_CONNECTION_A1_LABEL \      --interconnect=INTERCONNECT_CONNECTION_A1 \      --vlan-tags=TRAFFIC_MODE

Replace the following:

• WIRE_GROUP_NAME: the name of the wire group that youcreated previously.
• CROSS_SITE_NETWORK_NAME: the name of the cross-sitenetwork to which you are adding a wire group.
• ENDPOINT_A_LABEL: the existing label that you specifiedwhen you created the endpoint for site A.
• INTERCONNECT_CONNECTION_A1_LABEL: a new labelfor the first Cross-Site Interconnect connection that youcreated for site A.
• INTERCONNECT_CONNECTION_A1: the connectionthat you created for site A. You can specify the connection by its name,partial URI, or full URI. See the following examples:
  • my-connection
  • projects/my-project/global/interconnects/my-connection
  • https://compute.googleapis.com/compute/v1/projects/my-project/global/interconnects/my-connection

• TRAFFIC_MODE: the traffic mode configuration for the wiresthat use this Cross-Site Interconnect connection:

  • To configure port mode, enter-1.

  • To configure VLAN mode, choose one of the following:

    • To auto-allocate VLAN tag values, enter0.

    • To specify VLAN tag values manually, enter one tag value,such as1000. This VLAN tag is used for the wire betweenconnections A1 and B1 (wire A1-B1). A VLAN tag value must be aninteger from2 to4093. VLAN tags must be the same for bothendpoints of a wire. You can't enter a VLAN tag value that isalready in use on the Cloud Interconnect connection.

2c. Add connection A2

  gcloud compute interconnects wire-groups add-interconnectWIRE_GROUP_NAME \      --cross-site-network=CROSS_SITE_NETWORK_NAME \      --endpoint-label=ENDPOINT_A_LABEL \      --interconnect-label=INTERCONNECT_CONNECTION_A2_LABEL \      --interconnect=INTERCONNECT_CONNECTION_A2 \      --vlan-tags=TRAFFIC_MODE

Replace the following:

• WIRE_GROUP_NAME: the name of the wire group that youcreated previously.
• CROSS_SITE_NETWORK_NAME: the name of the cross-sitenetwork to which you are adding a wire group.
• ENDPOINT_A_LABEL: the existing label that you specifiedwhen you created the endpoint for site A.
• INTERCONNECT_CONNECTION_A2_LABEL: a new labelfor the redundant Cross-Site Interconnect connection that youcreated for site A.
• INTERCONNECT_CONNECTION_A2: the redundant connectionthat you created for site A. You can specify the connection by its name,partial URI, or full URI. See the following examples:
  • my-connection
  • projects/my-project/global/interconnects/my-connection
  • https://compute.googleapis.com/compute/v1/projects/my-project/global/interconnects/my-connection

• TRAFFIC_MODE: the traffic mode configuration for the wiresthat use this Cloud Interconnect connection:

  • To configure port mode, enter-1.

  • To configure VLAN mode, choose one of the following:

    • To auto-allocate VLAN tag values, enter0.To specify VLAN tag values manually, enter one tag value,such as1000. This VLAN tag is used for the wire betweenconnections A1 and B1 (wire A1-B1). A VLAN tag value must be aninteger from2 to4093. VLAN tags must be the same for bothendpoints of a wire. You can't enter a VLAN tag value that isalready in use on the Cloud Interconnect connection.

3a. Add an endpoint for site B

To add an endpoint to the wire group that represents your second site, orsite B, use thegcloud compute interconnects wire-groups add-endpoint command.

  gcloud compute interconnects wire-groups add-endpointWIRE_GROUP_NAME \      --cross-site-network=CROSS_SITE_NETWORK_NAME \      --endpoint-label=ENDPOINT_B_LABEL

Replace the following:

• WIRE_GROUP_NAME: the name of the wire group that youcreated previously
• CROSS_SITE_NETWORK_NAME: the name of the cross-sitenetwork to which you are adding a wire group
• ENDPOINT_B_LABEL: a label for the endpoint, suchaschicago

3b. Add connection B1

To add a Cross-Site Interconnect connection to the wire groupfor site B, orconnection B1, use thegcloud compute interconnects wire-groups add-interconnect command.

  gcloud compute interconnects wire-groups add-interconnectWIRE_GROUP_NAME \      --cross-site-network=CROSS_SITE_NETWORK_NAME \      --endpoint-label=ENDPOINT_B_LABEL \      --interconnect-label=INTERCONNECT_CONNECTION_B1_LABEL \      --interconnect=INTERCONNECT_CONNECTION_B1 \      --vlan-tags=TRAFFIC_MODE

  gcloud compute interconnects wire-groups add-interconnectWIRE_GROUP_NAME \      --cross-site-network=CROSS_SITE_NETWORK_NAME \      --endpoint-label=ENDPOINT_B_LABEL \      --interconnect-label=INTERCONNECT_CONNECTION_B2_LABEL \      --interconnect=INTERCONNECT_CONNECTION_B2 \      --vlan-tags=TRAFFIC_MODE

Console

To update a wire group in a cross-site network, do the following:

1. In the Google Cloud console, go to theInterconnect page.

   Go to Interconnect

2. On theCross-site networks tab, click the name of the wiregroup that you want to update.

3. On theWire group details page, clickEdit, andupdate the following fields as needed:

   • Description: The description of the wire group.

   • Admin enabled state: Whether the wire group is enabled ordisabled. Disabling a wire group stops all traffic through the wiregroup.

   • Unmetered bandwidth: The unmetered bandwidth,in Gbps, for the wire group.

     You can't configure bandwidth that exceeds the following:

     • Your quota between a given pair of metros or the limit for a given wire.If you haven't already, follow the instructions tocheck quotas and limits for bandwidth.
     • The Cross-Site Interconnect connection capacity.

     For additional considerations for configuringthis field, seeWire bandwidth.

   • Allocation method: whether to allocate the wire group'sbandwidth setting to each wire or to share the bandwidth betweenall wires in the group.

     • Allocate per wire. The unmetered bandwidth is allocated to eachwire in the group.
     • Shared with wire group. The unmetered bandwidth is divided equallybetween each wire in the group. However, dynamic throttling allocatesunused unmetered bandwidth to other wires in the group.

   • Failure detection: Whether failure detection is enabled ordisabled. If your wire group is in port mode, you canenable failure detection by selecting theDisable port checkbox.

     When you enable failure detection,Google Cloud continuously monitors each wire and disables a wireif it loses connectivity so that you can fail over to an alternatepath, such as another healthy wire in the group.

4. After you make your changes, clickSave.

gcloud

To update a wire group, use thegcloud compute interconnects wire-groups update command.

  gcloud compute interconnects wire-groups updateWIRE_GROUP_NAME \      --cross-site-network=CROSS_SITE_NETWORK_NAME \      [--bandwidth-unmetered=UNMETERED_BANDWIDTH] \      [--bandwidth-allocation=BANDWIDTH_ALLOCATION] \      [--fault-response=FAILURE_DETECTION] \      [--description=DESCRIPTION] \      [--admin-enabled | --no-admin-enabled]

Replace the following:

• WIRE_GROUP_NAME: the name of the wire group
• CROSS_SITE_NETWORK_NAME: the name of the cross-sitenetwork that contains the wire group

• Depending on which properties you want to update, use the following flags:

  • UNMETERED_BANDWIDTH: the unmetered bandwidthfor the wire group in Gbps. The bandwidth that you specify is allocatedto each wire in the group.

    You can't configure bandwidth that exceeds the following:

    • Your quota between a given pair of metros or the limit for a given wire.If you haven't already, follow the instructions tocheck quotas and limits for bandwidth.
    • The Cross-Site Interconnect connection capacity.

    For additional considerations for configuringthis field, seeWire bandwidth.

  • BANDWIDTH_ALLOCATION: use this flag to set thebandwidth allocation scope, which can have either of the following values:

  • ALLOCATE_PER_WIRE, which provides a separate unmetered bandwidthallocation for each wire in the group.

  • SHARED_WITH_WIRE_GROUP, which has one unmetered bandwidth allocationthat is divided across each wire in the group. Dynamic throttlingreallocates unused bandwidth from unutilized or underutilized wires toother wires in the group.

  • FAILURE_DETECTION: Use this flag for port modeconfigurations only. To enable failure detection, enterDISABLE_PORT.Otherwise, enterNONE.

    When you enable failure detection,Google Cloud continuously monitors each wire and disables a wireif it loses connectivity so that you can fail over to an alternatepath, such as another healthy wire in the group.

  • DESCRIPTION: the description of the wire group

  • --admin-enabled | --no-admin-enabled: whether the wire group isenabled or disabled.

    To enable the wire group, use--admin-enabled. To disable a wiregroup, use--no-admin-enabled. Disabling a wire group stops alltraffic through the wire group.

Console

1. In the Google Cloud console, go to theInterconnect page.

   Go to Interconnect

2. On theCross-site networks tab, click the name of the wire group whosemode you want to change.

3. On theWire group details page, clickEdit.

4. ClickAdvanced settings, and then select an option in theWire group mode field.

5. If you selectedVLAN mode, specifyVLAN tags for eachwire in your wire group by entering an integer from2 to4093.

   You can't enter a VLAN tag value that is already in use on the sameCross-Site Interconnect connection.

6. ClickSave.

gcloud

1. Remove the existing connections from your wire group by using thegcloud compute interconnects wire-groups remove-interconnect command.

   Run the command four times to removeINTERCONNECT_CONNECTION_A1,INTERCONNECT_CONNECTION_A2,INTERCONNECT_CONNECTION_B1, andINTERCONNECT_CONNECTION_B2.

   gcloud compute interconnects wire-groups remove-interconnectWIRE_GROUP_NAME \    --cross-site-network=CROSS_SITE_NETWORK_NAME \    --endpoint-label=ENDPOINT_LABEL \    --interconnect-label=INTERCONNECT_CONNECTION_LABEL

   Replace the following:

   • WIRE_GROUP_NAME: the name of the wire group
   • CROSS_SITE_NETWORK_NAME: the name of the cross-sitenetwork
   • ENDPOINT_LABEL: the label that you specifiedwhen you created the endpoint for the site
   • INTERCONNECT_CONNECTION_LABEL: the labelthat you specified when you added the connection to the wire group

2. Add the connections to your wire group again.

   Complete the following steps and configure the--vlan-tags flagaccording to the traffic mode that you want to use:

   1. Add connection A1
   2. Add connection A2
   3. Add connection B1
   4. Add connection B2