[jira] [Commented] (CLOUDSTACK-4152) 2.8. About Physical Networks could be clearer

["Paul Angus (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/CLOUDSTACK-4152?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14358454#comment-14358454 ] 

Paul Angus commented on CLOUDSTACK-4152:
----------------------------------------

Marking this issue as resolved as netowrking documentation has been heavily updated and improved

> 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
>            Priority: Blocker
>              Labels: networking
>
> 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 was sent by Atlassian JIRA
(v6.3.4#6332)