incubator-cloudstack-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject git commit: Docs: Add missing file on security groups.
Date Wed, 17 Oct 2012 00:58:18 GMT
Updated Branches:
  refs/heads/master a9fab0526 -> a35e23c58

Docs: Add missing file on security groups.


Branch: refs/heads/master
Commit: a35e23c58fe93feaf4b5b68532934e8d1a8ca37d
Parents: a9fab05
Author: Jessica Tomechak <>
Authored: Tue Oct 16 17:57:03 2012 -0700
Committer: Jessica Tomechak <>
Committed: Tue Oct 16 17:57:46 2012 -0700

 docs/en-US/about-security-groups.xml         |   35 +++++++++++++++++++++
 docs/en-US/cloud-infrastructure-concepts.xml |    3 +-
 docs/en-US/security-groups.xml               |    1 +
 3 files changed, 38 insertions(+), 1 deletions(-)
diff --git a/docs/en-US/about-security-groups.xml b/docs/en-US/about-security-groups.xml
new file mode 100644
index 0000000..85e8477
--- /dev/null
+++ b/docs/en-US/about-security-groups.xml
@@ -0,0 +1,35 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" ""
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+<!-- 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
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+<section id="about-security-groups">
+    <title>About Security Groups</title>
+    <para>Security groups provide a way to isolate traffic to VMs. A security group
is a group of VMs that filter their incoming and outgoing traffic according to a set of rules,
called ingress and egress rules. These rules filter network traffic according to the IP address
that is attempting to communicate with the VM. Security groups are particularly useful in
zones that use basic networking, because there is a single guest network for all guest VMs.
In &PRODUCT; 3.0.3 - 3.0.5, security groups are supported only in zones that use basic
+    <note><para>In a zone that uses advanced networking, you can instead define
multiple guest networks to isolate traffic to VMs.</para>
+        </note>
+    <para></para>
+    <para>Each &PRODUCT; account comes with a default security group that denies
all inbound traffic and allows all outbound traffic. The default security group can be modified
so that all new VMs inherit some other desired set of rules.</para>
+    <para>Any &PRODUCT; user can set up any number of additional security groups.
When a new VM is launched, it is assigned to the default security group unless another user-defined
security group is specified. A VM can be a member of any number of security groups. Once a
VM is assigned to a security group, it remains in that group for its entire lifetime; you
can not move a running VM from one security group to another.</para>
+    <para>You can modify a security group by deleting or adding any number of ingress
and egress rules. When you do, the new rules apply to all VMs in the group, whether running
or stopped.</para>
+    <para>If no ingress rules are specified, then no traffic will be allowed in, except
for responses to any traffic that has been allowed out through an egress rule.</para>
diff --git a/docs/en-US/cloud-infrastructure-concepts.xml b/docs/en-US/cloud-infrastructure-concepts.xml
index 7fc9efa..5ab39ec 100644
--- a/docs/en-US/cloud-infrastructure-concepts.xml
+++ b/docs/en-US/cloud-infrastructure-concepts.xml
@@ -31,4 +31,5 @@
   <xi:include href="about-primary-storage.xml" xmlns:xi=""
   <xi:include href="about-secondary-storage.xml" xmlns:xi=""
   <xi:include href="about-physical-networks.xml" xmlns:xi=""
\ No newline at end of file
+  <xi:include href="security-groups.xml" xmlns:xi=""/>
diff --git a/docs/en-US/security-groups.xml b/docs/en-US/security-groups.xml
index 55f2a72..3c08965 100644
--- a/docs/en-US/security-groups.xml
+++ b/docs/en-US/security-groups.xml
@@ -24,6 +24,7 @@
 <section id="security-groups">
     <title>Security Groups</title>
+    <xi:include href="about-security-groups.xml" xmlns:xi=""
     <xi:include href="add-security-group.xml" xmlns:xi=""
     <xi:include href="enable-security-groups.xml" xmlns:xi=""
     <xi:include href="add-ingress-egress-rules.xml" xmlns:xi=""

View raw message