source/networking/multiple_guest_networks.rst - cloudstack-docs-admin - Git at Google

 .. Licensed to the Apache Software Foundation (ASF) under one
    or more contributor license agreements.  See the NOTICE file
    distributed with this work for additional information#
    regarding copyright ownership.  The ASF licenses this file
    to you under the Apache License, Version 2.0 (the
    "License"); you may not use this file except in compliance
    with the License.  You may obtain a copy of the License at
    http://www.apache.org/licenses/LICENSE-2.0
    Unless required by applicable law or agreed to in writing,
    software distributed under the License is distributed on an
    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    KIND, either express or implied.  See the License for the
    specific language governing permissions and limitations
    under the License.


 Using Multiple Guest Networks
 -----------------------------

 In zones that use advanced networking, additional networks for guest
 traffic may be added at any time after the initial installation. You can
 also customize the domain name associated with the network by specifying
 a DNS suffix for each network.

 A VM's networks are defined at VM creation time. A VM cannot add or
 remove networks after it has been created, although the user can go into
 the guest and remove the IP address from the NIC on a particular
 network.

 Each VM has just one default network. The virtual router's DHCP reply
 will set the guest's default gateway as that for the default network.
 Multiple non-default networks may be added to a guest in addition to the
 single, required default network. The administrator can control which
 networks are available as the default network.

 Additional networks can either be available to all accounts or be
 assigned to a specific account. Networks that are available to all
 accounts are zone-wide. Any user with access to the zone can create a VM
 with access to that network. These zone-wide networks provide little or
 no isolation between guests.Networks that are assigned to a specific
 account provide strong isolation.


 Adding an Additional Guest Network
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 #. Log in to the CloudStack UI as an administrator or end user.

 #. In the left navigation, choose Network.

 #. Click Add guest network. Provide the following information:

    -  **Name**: The name of the network. This will be user-visible.

    -  **Display Text**: The description of the network. This will be
       user-visible.

    -  **Zone**. The name of the zone this network applies to. Each zone
       is a broadcast domain, and therefore each zone has a different IP
       range for the guest network. The administrator must configure the
       IP range for each zone.

    -  **Network offering**: If the administrator has configured multiple
       network offerings, select the one you want to use for this
       network.

    -  **Guest Gateway**: The gateway that the guests should use.

    -  **Guest Netmask**: The netmask in use on the subnet the guests
       will use.

 #. Click Create.


 Reconfiguring Networks in VMs
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 CloudStack provides you the ability to move VMs between networks and
 reconfigure a VM's network. You can remove a VM from a network and add
 to a new network. You can also change the default network of a virtual
 machine. With this functionality, hybrid or traditional server loads can
 be accommodated with ease.

 This feature is supported on XenServer, VMware, and KVM hypervisors.


 Prerequisites
 ^^^^^^^^^^^^^

 Ensure that vm-tools are running on guest VMs for adding or removing
 networks to work on VMware hypervisor.


 Adding a Network
 ^^^^^^^^^^^^^^^^

 #. Log in to the CloudStack UI as an administrator or end user.

 #. In the left navigation, click Instances.

 #. Choose the VM that you want to work with.

 #. Click the NICs tab.

 #. Click Add network to VM.

    The Add network to VM dialog is displayed.

 #. In the drop-down list, select the network that you would like to add
    this VM to.

    A new NIC is added for this network. You can view the following
    details in the NICs page:

    -  ID

    -  Network Name

    -  Type

    -  IP Address

    -  Gateway

    -  Netmask

    -  Is default

    -  CIDR (for IPv6)


 Removing a Network
 ^^^^^^^^^^^^^^^^^^

 #. Log in to the CloudStack UI as an administrator or end user.

 #. In the left navigation, click Instances.

 #. Choose the VM that you want to work with.

 #. Click the NICs tab.

 #. Locate the NIC you want to remove.

 #. Click Remove NIC button. |remove-nic.png|

 #. Click Yes to confirm.


 Selecting the Default Network
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

 #. Log in to the CloudStack UI as an administrator or end user.

 #. In the left navigation, click Instances.

 #. Choose the VM that you want to work with.

 #. Click the NICs tab.

 #. Locate the NIC you want to work with.

 #. Click the Set default NIC button. |set-default-nic.png|.

 #. Click Yes to confirm.

 Changing the Network Offering on a Guest Network
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 A user or administrator can change the network offering that is
 associated with an existing guest network.

 #. Log in to the CloudStack UI as an administrator or end user.

 #. If you are changing from a network offering that uses the CloudStack
    virtual router to one that uses external devices as network service
    providers, you must first stop all the VMs on the network.

 #. In the left navigation, choose Network.

 #. Click the name of the network you want to modify.

 #. In the Details tab, click Edit. |edit-icon.png|

 #. In Network Offering, choose the new network offering, then click
    Apply.

    A prompt is displayed asking whether you want to keep the existing
    CIDR. This is to let you know that if you change the network
    offering, the CIDR will be affected.

    If you upgrade between virtual router as a provider and an external
    network device as provider, acknowledge the change of CIDR to
    continue, so choose Yes.

 #. Wait for the update to complete. Don't try to restart VMs until the
    network change is complete.

 #. If you stopped any VMs, restart them.


 .. |remove-nic.png| image:: /_static/images/remove-nic.png
    :alt: button to remove a NIC.
 .. |set-default-nic.png| image:: /_static/images/set-default-nic.png
    :alt: button to set a NIC as default one.
 .. |edit-icon.png| image:: /_static/images/edit-icon.png
    :alt: button to edit.
	.. Licensed to the Apache Software Foundation (ASF) under one
	or more contributor license agreements. See the NOTICE file
	distributed with this work for additional information#
	regarding copyright ownership. The ASF licenses this file
	to you under the Apache License, Version 2.0 (the
	"License"); you may not use this file except in compliance
	with the License. You may obtain a copy of the License at
	http://www.apache.org/licenses/LICENSE-2.0
	Unless required by applicable law or agreed to in writing,
	software distributed under the License is distributed on an
	"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
	KIND, either express or implied. See the License for the
	specific language governing permissions and limitations
	under the License.


	Using Multiple Guest Networks
	-----------------------------

	In zones that use advanced networking, additional networks for guest
	traffic may be added at any time after the initial installation. You can
	also customize the domain name associated with the network by specifying
	a DNS suffix for each network.

	A VM's networks are defined at VM creation time. A VM cannot add or
	remove networks after it has been created, although the user can go into
	the guest and remove the IP address from the NIC on a particular
	network.

	Each VM has just one default network. The virtual router's DHCP reply
	will set the guest's default gateway as that for the default network.
	Multiple non-default networks may be added to a guest in addition to the
	single, required default network. The administrator can control which
	networks are available as the default network.

	Additional networks can either be available to all accounts or be
	assigned to a specific account. Networks that are available to all
	accounts are zone-wide. Any user with access to the zone can create a VM
	with access to that network. These zone-wide networks provide little or
	no isolation between guests.Networks that are assigned to a specific
	account provide strong isolation.


	Adding an Additional Guest Network
	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

	#. Log in to the CloudStack UI as an administrator or end user.

	#. In the left navigation, choose Network.

	#. Click Add guest network. Provide the following information:

	- Name: The name of the network. This will be user-visible.

	- Display Text: The description of the network. This will be
	user-visible.

	- Zone. The name of the zone this network applies to. Each zone
	is a broadcast domain, and therefore each zone has a different IP
	range for the guest network. The administrator must configure the
	IP range for each zone.

	- Network offering: If the administrator has configured multiple
	network offerings, select the one you want to use for this
	network.

	- Guest Gateway: The gateway that the guests should use.

	- Guest Netmask: The netmask in use on the subnet the guests
	will use.

	#. Click Create.


	Reconfiguring Networks in VMs
	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

	CloudStack provides you the ability to move VMs between networks and
	reconfigure a VM's network. You can remove a VM from a network and add
	to a new network. You can also change the default network of a virtual
	machine. With this functionality, hybrid or traditional server loads can
	be accommodated with ease.

	This feature is supported on XenServer, VMware, and KVM hypervisors.


	Prerequisites
	^^^^^^^^^^^^^

	Ensure that vm-tools are running on guest VMs for adding or removing
	networks to work on VMware hypervisor.


	Adding a Network
	^^^^^^^^^^^^^^^^

	#. Log in to the CloudStack UI as an administrator or end user.

	#. In the left navigation, click Instances.

	#. Choose the VM that you want to work with.

	#. Click the NICs tab.

	#. Click Add network to VM.

	The Add network to VM dialog is displayed.

	#. In the drop-down list, select the network that you would like to add
	this VM to.

	A new NIC is added for this network. You can view the following
	details in the NICs page:

	- ID

	- Network Name

	- Type

	- IP Address

	- Gateway

	- Netmask

	- Is default

	- CIDR (for IPv6)


	Removing a Network
	^^^^^^^^^^^^^^^^^^

	#. Log in to the CloudStack UI as an administrator or end user.

	#. In the left navigation, click Instances.

	#. Choose the VM that you want to work with.

	#. Click the NICs tab.

	#. Locate the NIC you want to remove.

	#. Click Remove NIC button. \|remove-nic.png\|

	#. Click Yes to confirm.


	Selecting the Default Network
	^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

	#. Log in to the CloudStack UI as an administrator or end user.

	#. In the left navigation, click Instances.

	#. Choose the VM that you want to work with.

	#. Click the NICs tab.

	#. Locate the NIC you want to work with.

	#. Click the Set default NIC button. \|set-default-nic.png\|.

	#. Click Yes to confirm.

	Changing the Network Offering on a Guest Network
	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

	A user or administrator can change the network offering that is
	associated with an existing guest network.

	#. Log in to the CloudStack UI as an administrator or end user.

	#. If you are changing from a network offering that uses the CloudStack
	virtual router to one that uses external devices as network service
	providers, you must first stop all the VMs on the network.

	#. In the left navigation, choose Network.

	#. Click the name of the network you want to modify.

	#. In the Details tab, click Edit. \|edit-icon.png\|

	#. In Network Offering, choose the new network offering, then click
	Apply.

	A prompt is displayed asking whether you want to keep the existing
	CIDR. This is to let you know that if you change the network
	offering, the CIDR will be affected.

	If you upgrade between virtual router as a provider and an external
	network device as provider, acknowledge the change of CIDR to
	continue, so choose Yes.

	#. Wait for the update to complete. Don't try to restart VMs until the
	network change is complete.

	#. If you stopped any VMs, restart them.


	.. \|remove-nic.png\| image:: /_static/images/remove-nic.png
	:alt: button to remove a NIC.
	.. \|set-default-nic.png\| image:: /_static/images/set-default-nic.png
	:alt: button to set a NIC as default one.
	.. \|edit-icon.png\| image:: /_static/images/edit-icon.png
	:alt: button to edit.