This is an automated email from the ASF dual-hosted git repository.
rafael pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/cloudstack-docs-install.git
The following commit(s) were added to refs/heads/master by this push:
new c5a3c73 Instructions on API calls and DB changes, to add new Guest
Physical Network (#31)
c5a3c73 is described below
commit c5a3c738d56fd94bf60037914c91bee12b1c3061
Author: Andrija Panic <[email protected]>
AuthorDate: Thu Jul 12 14:18:04 2018 +0200
Instructions on API calls and DB changes, to add new Guest Physical Network
(#31)
* Adding new physical network
* Adding new Guest Network
Added doc, about how to create another Physical Network inside already
running/existing Zone, which requires DB changes, and API calls, and dedicate
this Physical Zone to Guest Traffic (i.e. for Private Gateway functionality)
---
source/_static/images/Add-physical-network-1.png | Bin 0 -> 11750 bytes
source/_static/images/Add-physical-network-2.png | Bin 0 -> 5781 bytes
source/_static/images/Add-physical-network-3.png | Bin 0 -> 17492 bytes
source/optional_installation.rst | 71 +++++++++++++++++++++++
4 files changed, 71 insertions(+)
diff --git a/source/_static/images/Add-physical-network-1.png
b/source/_static/images/Add-physical-network-1.png
new file mode 100644
index 0000000..8679404
Binary files /dev/null and b/source/_static/images/Add-physical-network-1.png
differ
diff --git a/source/_static/images/Add-physical-network-2.png
b/source/_static/images/Add-physical-network-2.png
new file mode 100644
index 0000000..a4501f6
Binary files /dev/null and b/source/_static/images/Add-physical-network-2.png
differ
diff --git a/source/_static/images/Add-physical-network-3.png
b/source/_static/images/Add-physical-network-3.png
new file mode 100644
index 0000000..b140e9d
Binary files /dev/null and b/source/_static/images/Add-physical-network-3.png
differ
diff --git a/source/optional_installation.rst b/source/optional_installation.rst
index f3394fe..e815731 100644
--- a/source/optional_installation.rst
+++ b/source/optional_installation.rst
@@ -802,3 +802,74 @@ Example 2. An S3 Boto Example
.. |Use the GUI to set the configuration variable to true| image::
./_static/images/ec2-s3-configuration.png
.. |Use the GUI to set the name of a compute service offering to an EC2
instance type API name.| image:: ./_static/images/compute-service-offerings.png
+
+
+Adding new Guest Physical Network to existing Zone
+--------------------------------------
+
+In some cases it might be necessary to add additional Guest Physical Network
to already existing Advanced Zone. One example might be that we have been
running Zone with Guest Physical Network that uses VXLAN as isolation method
(i.e. KVM traffic label set to "bond.150), and we also need to start using
Private Gateway functionality, which would not work with current Guest Physical
Network Traffic Label (for explanation why this would not work, please see
":ref:`adding-priv-gw-vpc`".
+
+So in example below, we would like to create new Guest Physical Network
(Traffic Label set to "bond0" in this example) and later use this Guest
Physical Network for other purposes (to provision Private Gateways on top of it)
+
+Depending on the CloudStack version, we can probably accomplish this only by
API commands (i.e. CloudMonkey) and direct database changes.
+
+First obtain Zone ID, and then create Physical Network command:
+
+.. code:: bash
+
+ cloudmonkey> list zones filter=id | grep id | head -n1
+ cloudmonkey> create physicalnetwork name="bond0 Private Gateways"
broadcastdomainrange=zone zoneid=xxxxxx isolationmethod=VLAN
+
+where "xxxxxxx" is the proper zone ID (output from the first command above).
+
+Here we created new Physical Network (not yet of any type...) inside given
zone.
+
+Please note that new Physical Network can not be added, while Zone is in
Enabled state!
+
+It is safe to disable Zone (for few seconds) which will just prevent users
from provisioning new resources in this Zone, then create Physical Network per
instructions from above, and then enable the Zone (this can be done via GUI or
CloudMonkey).
+
+Since Physical Network is in Disabled state by default, we need to enable it
by:
+
+.. code:: bash
+
+ cloudmonkey> list physicalnetworks name="bond0 Private Gateways" | grep id
| head -n1
+ cloudmonkey> update physicalnetwork state=Enabled id=xxxxx
+
+where xxxxx is the correct ID of Physical Network (output from the first
command above).
+
+After Physical Network is created, although we selected VLAN as isolation
method, it may happen (depending on CloudStack version) that there will be no
DB record created (which defines VLAN as isolation method for this new
network), so we need to check this and fix it:
+
+.. code:: bash
+
+ cloudmonkey> list physicalnetworks name="bond0 Private Gateways" | grep
isolationmethods
+
+If above commands gives no output, that means that VLAN was not set as
Isolation Method inside DB, in cloud.physical_network_isolation_methods table,
so we need to set it:
+
+
+.. code:: bash
+
+ mysql> select id from cloud.physical_network where name="bond0 Private
Gateways"
+ mysql> select max(id) from cloud.physical_network_isolation_methods;
+
+Write down the id and max(id) values (i.e. 204, 10)
+
+.. |Add-physical-network-1.png| image::
./_static/images/Add-physical-network-1.png
+
+.. code:: bash
+
+ mysql> INSERT INTO cloud.physical_network_isolation_methods (id,
physical_network_id, isolation_method) VALUES ('11', '204', 'VLAN');
+
+where 11 is actually the next number after the max(id) value, and 204 is the
ID of the Physical Network (check the image below)
+
+.. |Add-physical-network-2.png| image::
./_static/images/Add-physical-network-2.png
+
+Now, that we have set correct Isolation Method for the new Physical Network,
and enabled it, we also need to do most critical part, to define that this
Physical Network caries Guest traffic. This action is also done via database
change.
+
+We want to effectively clone the existing Guest network row from
cloud.physical_network_traffic_types table, and then change needed values: ID,
UUID, PHYSICAL_NETWORK_ID and KVM_NETWORK_LABEL (in our case, we are using KVM,
but same goes for other HyperVisor types)
+
+.. |Add-physical-network-3.png| image::
./_static/images/Add-physical-network-3.png
+
+
+After this last step, we are ready to tag these 2 Guest Physical Networks and
Network Offerings (regular ones for VPC Guest networks, and the special one
used for Private Gateways) and then use these two Guest Networks as originally
planned.
+
+For more details on Network tagging, please see ":ref:`adding-priv-gw-vpc`".
