Mailing-List: contact dev-help@cloudstack.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@cloudstack.apache.org
Reply-To: "dev@cloudstack.apache.org" <dev@cloudstack.apache.org>
From: Ron Wheeler <rwheeler@artifact-software.com>
Organization: Artifact Software
To: "dev@cloudstack.apache.org" <dev@cloudstack.apache.org>
Subject: CloudStack networking documentation
Message-ID: <560A1BB1.4080402@artifact-software.com>
Date: Tue, 29 Sep 2015 01:03:45 -0400
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:38.0) Gecko/20100101
 Thunderbird/38.2.0
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit

http://docs.cloudstack.apache.org/en/master/concepts.html#what-is-apache-cloudstack

In the opening paragraph of About Physical Networks" it says
"The network corresponds to a NIC on the hypervisor host."

In Basic Zone Network Traffic Types it says that there is only one 
physical network in the zone but later on in the middle of discussing 
the various traffic types there is a note
"We strongly recommend the use of separate NICs for management traffic 
and guest traffic".
There is no reason given for this statement.
No suggestion about what tradeoff is being made if you go with a single 
NIC.
Is it performance or security concerns that prompts this?

It might be helpful to describe what is meant by a single physical 
network with multiple NICs.

The note itself appears to be out of place since it is in the middle of 
some definitions rather that in a discussion block.
It also looks like it applies to Advanced Networks but is missing in 
that section.

"CIDR of the pod" is used without any description of what this is and 
how it gets setup.
Might be helpful to add a sentence or two about this. It seems important.

"guest virtual router" is another concept that seems important but has 
no definition or discussion.

Ron

-- 
Ron Wheeler
President
Artifact Software Inc
email: rwheeler@artifact-software.com
skype: ronaldmwheeler
phone: 866-970-2435, ext 102