This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Configure EDGE Network Mode

    This topic provides configuration instructions for Eucalyptus EDGE network mode. Eucalyptus requires network connectivity between its clients (end-users) and the cloud components (e.g., CC, CLC, and Walrus).

    To configure Eucalyptus for EDGE mode, most networking configuration is handled through settings in a global Cloud Controller (CLC) property file.

    The /etc/eucalyptus/eucalyptus.conf file contains some network-related options in the “Networking Configuration” section. These options use the prefix VNET_. The most commonly used VNET options are described in the following table.

    The most commonly used VNET options are described in the following table.

    OptionDescriptionComponent
    VNET_BRIDGEThis is the name of the bridge interface to which instances’ network interfaces should attach. A physical interface that can reach the CC must be attached to this bridge. Common setting for KVM is br0.Node Controller
    VNET_DHCPDAEMONThe ISC DHCP executable to use. This is set to a distro-dependent value by packaging. The internal default is /usr/sbin/dhcpd3.Node Controller
    VNET_MODEThe networking mode in which to run. The same mode must be specified on all CCs and NCs in your cloud. Valid values: EDGEAll CCs and NCs
    VNET_PRIVINTERFACEThe name of the network interface that is on the same network as the NCs. Default: eth0Node Controller
    VNET_PUBINTERFACEThis is the name of the network interface that is connected to the same network as the CC. Depending on the hypervisor’s configuration this may be a bridge or a physical interface that is attached to the bridge. Default: eth0Node Controller

    You must edit eucalyptus.conf on the Cluster Controller (CC) and Node Controller (NC) hosts. You must also create a network configuration file and upload it the Cloud Controller (CLC).

    CC Configuration

    Log in to the CC and open the /etc/eucalyptus/eucalyptus.conf file. Go to the Network Configuration section, uncomment and set the following:

    VNET_MODE="EDGE"
    

    Save the file. Repeat on each CC in your cloud.

    NC Configuration

    Log into an NC machine and open the /etc/eucalyptus/eucalyptus.conf file. Go to the Network Configuration section, uncomment and set the following parameters:

    VNET_MODE
    VNET_PRIVINTERFACE
    VNET_PUBINTERFACE
    VNET_BRIDGE
    VNET_DHCPDAEMON
    

    For example:

    VNET_MODE="EDGE"
    VNET_PRIVINTERFACE="br0"
    VNET_PUBINTERFACE="br0"
    VNET_BRIDGE="br0"
    VNET_DHCPDAEMON="/usr/sbin/dhcpd"
    

    Save the file. Repeat on each NC.

    Cloud Configuration

    To configure the rest of the EDGE mode parameters, you must create a network.yaml configuration file. Later in the installation process you will Upload the Network Configuration to the CLC.

    Create the network configuration file. Open a text editor. Create a file similar to the following structure.

    # A list of servers that instances receive to resolve DNS names
    InstanceDnsServers:
    - ""
    
    # List of public IP addresses or address ranges
    PublicIps:
    - ""
    
    # A list of cluster objects that define each availability zone (AZ) in your cloud
    Clusters:
    -
      # Name of the cluster as it was registered
      Name: ""
      
      # Subnet definition that this cluster will use for private addressing
      Subnet:
        # Arbitrary name for the subnet
        Name: ""
    
        # The subnet that will be used for private addressing
        Subnet: ""
    
        # Netmask for the subnet defined above
        Netmask: ""
    
        # Gateway that will route packets for the private subnet
        Gateway: ""
    
      # List of Private IP addresses or address ranges for instances   
      PrivateIps:
      - ""
    

    Save the network.json file. The following example is for a setup with one cluster (AZ), called PARTI00, with a flat network topology.

    InstanceDnsServers:
    - "10.1.1.254"
    
    PublicIps:
    - "10.111.101.84"
    - "10.111.101.91-10.111.101.93"
    
    Clusters:
    - Name: PARTI00
    
      Subnet:
        Name: "10.111.0.0"
        Subnet: "10.111.0.0"
        Netmask: "255.255.0.0"
        Gateway: "10.111.0.1"
    
      PrivateIps:
      - "10.111.101.94"
      - "10.111.101.95"
    

    For a multi-cluster deployment, add an additional cluster to your configuration for each cluster you have. The following example has an two clusters, PARTI00 and PARTI01.

    InstanceDnsServers:
    - "10.1.1.254"
    
    PublicIps:
    - "10.111.101.84"
    - "10.111.101.91-10.111.101.93"
    
    Clusters:
    - Name: PARTI00
    
      Subnet:
        Name: "10.111.0.0"
        Subnet: "10.111.0.0"
        Netmask: "255.255.0.0"
        Gateway: "10.111.0.1"
    
      PrivateIps:
      - "10.111.101.94"
      - "10.111.101.95"
    
    - Name: PARTI01
    
      Subnet:
        Name: "10.111.0.0"
        Subnet: "10.111.0.0"
        Netmask: "255.255.0.0"
        Gateway: "10.111.0.1"
    
      PrivateIps:
      - "10.111.101.96"
      - "10.111.101.97"