Ron Wheeler created CLOUDSTACK-4152:
---------------------------------------

             Summary: 2.8. About Physical Networks could be clearer
                 Key: CLOUDSTACK-4152
                 URL: https://issues.apache.org/jira/browse/CLOUDSTACK-4152
             Project: CloudStack
          Issue Type: Improvement
      Security Level: Public (Anyone can view this level - this is the default.)
          Components: Doc
    Affects Versions: 4.1.1
         Environment: all

            Reporter: Ron Wheeler


Networking seems to be the biggest problem that new users have in getting 
started.


1) This page needs some diagrams to make it easier to understand what is being 
described.
There are some magical statements or statements about something that the 
administrator must do with no reference to a section describing how to do it or 
when it must be done.

2) CIDR is used without any definition or explanation.
3) The user is told that IP addresses need to be allocated without any 
suggestion of how this is done. This needs to be clarified. 

4) It might be useful to split this page into at least 2 pages - Basic and 
Advanced.
In the Basic, it would be helpful to describe in some detail the most common 
test or small organization environments. 
The audience here is a system administrator that has a broad but not too deep 
knowledge of networking.
Someone with 2-5 servers behind a simple firewall with 1-5 public IP addresses. 
I suggest writing the first draft for a person with 1 public IP address behind 
a simple firewall and see how hard it is to extend that to multiple public IPs 
without getting into an advanced setup.

The Advanced is more complex but it is also easier to describe since you can 
assume that the audience is a network administrator who has a lot more in-depth 
knowledge of networing, routers, VLANs, etc.


--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

Reply via email to