From 45dd833b2e957049f317b7a5d507467e5a261978 Mon Sep 17 00:00:00 2001 From: Sebastien Goasguen Date: Tue, 27 Nov 2012 10:07:10 +0100 Subject: [PATCH] CS-547 Signed-off-by: Gavin Lee --- docs/en-US/add-clusters-ovm.xml | 2 +- docs/en-US/admin-guide.xml | 2 +- docs/en-US/aws-ec2-configuration.xml | 2 +- docs/en-US/basic-zone-configuration.xml | 2 +- docs/en-US/basic-zone-guest-ip-addresses.xml | 2 +- ...ic-zone-physical-network-configuration.xml | 2 +- docs/en-US/best-practices-primary-storage.xml | 2 +- .../best-practices-secondary-storage.xml | 2 +- docs/en-US/cloudplatform-api.xml | 31 ------------------- docs/en-US/configuring-projects.xml | 2 +- docs/en-US/log-in-root-admin.xml | 2 +- docs/en-US/manual-live-migration.xml | 4 +-- docs/en-US/network-offerings.xml | 10 +++--- docs/en-US/network-service-providers.xml | 6 ++-- docs/en-US/port-forwarding.xml | 6 ++-- docs/en-US/primary-storage.xml | 2 +- docs/en-US/query-filter.xml | 8 ++--- docs/en-US/release-ip-address.xml | 2 +- docs/en-US/roles.xml | 2 +- docs/en-US/troubleshooting-lb-rules-fails.xml | 2 +- ...aintenance-mode-not-working-on-vCenter.xml | 2 +- .../using-swift-for-secondary-storage.xml | 2 +- docs/en-US/vm-lifecycle.xml | 4 +-- 23 files changed, 35 insertions(+), 66 deletions(-) delete mode 100644 docs/en-US/cloudplatform-api.xml diff --git a/docs/en-US/add-clusters-ovm.xml b/docs/en-US/add-clusters-ovm.xml index 11e1a13555f..aa07dfa6506 100644 --- a/docs/en-US/add-clusters-ovm.xml +++ b/docs/en-US/add-clusters-ovm.xml @@ -26,7 +26,7 @@ Add Cluster: OVM To add a Cluster of hosts that run Oracle VM (OVM): - Add a companion non-OVM cluster to the Pod. This cluster provides an environment where the CloudPlatform System VMs can run. You should have already installed a non-OVM hypervisor on at least one Host to prepare for this step. Depending on which hypervisor you used: + Add a companion non-OVM cluster to the Pod. This cluster provides an environment where the &PRODUCT; System VMs can run. You should have already installed a non-OVM hypervisor on at least one Host to prepare for this step. Depending on which hypervisor you used: For VMWare, follow the steps in Add Cluster: vSphere. When finished, return here and continue with the next step. For KVM or XenServer, follow the steps in . When finished, return here and continue with the next step diff --git a/docs/en-US/admin-guide.xml b/docs/en-US/admin-guide.xml index 512f7a9846a..f1b0327e9d1 100644 --- a/docs/en-US/admin-guide.xml +++ b/docs/en-US/admin-guide.xml @@ -88,5 +88,5 @@ - + diff --git a/docs/en-US/aws-ec2-configuration.xml b/docs/en-US/aws-ec2-configuration.xml index b8966c12495..d6c4066d1d8 100644 --- a/docs/en-US/aws-ec2-configuration.xml +++ b/docs/en-US/aws-ec2-configuration.xml @@ -25,7 +25,7 @@
Enabling the AWS API Compatible Interface - The software that provides AWS API compatibility is installed along with CloudPlatform. However, you must enable the feature and perform some setup steps. + The software that provides AWS API compatibility is installed along with &PRODUCT;. However, you must enable the feature and perform some setup steps. Set the global configuration parameter enable.ec2.api to true. See . diff --git a/docs/en-US/basic-zone-configuration.xml b/docs/en-US/basic-zone-configuration.xml index e27c91493fa..e0c67d81af0 100644 --- a/docs/en-US/basic-zone-configuration.xml +++ b/docs/en-US/basic-zone-configuration.xml @@ -135,7 +135,7 @@ Host Tags. (Optional) Any labels that you use to categorize hosts for ease of maintenance. For example, you can set this to the cloud's HA tag (set in the ha.tag global configuration parameter) if you want this host to be used only for VMs with the "high availability" feature enabled. For more information, see HA-Enabled Virtual Machines as well as HA for Hosts. - In a new cluster, CloudPlatform adds the first primary storage server for you. You can always add more servers later. For an overview of what primary storage is, see About Primary Storage. + In a new cluster, &PRODUCT; adds the first primary storage server for you. You can always add more servers later. For an overview of what primary storage is, see About Primary Storage. To configure the first primary storage server, enter the following, then click Next: Name. The name of the storage device. diff --git a/docs/en-US/basic-zone-guest-ip-addresses.xml b/docs/en-US/basic-zone-guest-ip-addresses.xml index d1d9135b4c6..57ef9e7c20c 100644 --- a/docs/en-US/basic-zone-guest-ip-addresses.xml +++ b/docs/en-US/basic-zone-guest-ip-addresses.xml @@ -24,5 +24,5 @@
Basic Zone Guest IP Addresses - When basic networking is used, CloudPlatform will assign IP addresses in the CIDR of the pod to the guests in that pod. The administrator must add a Direct IP range on the pod for this purpose. These IPs are in the same VLAN as the hosts. + When basic networking is used, &PRODUCT; will assign IP addresses in the CIDR of the pod to the guests in that pod. The administrator must add a Direct IP range on the pod for this purpose. These IPs are in the same VLAN as the hosts.
diff --git a/docs/en-US/basic-zone-physical-network-configuration.xml b/docs/en-US/basic-zone-physical-network-configuration.xml index 83833a73e78..32aeb847d56 100644 --- a/docs/en-US/basic-zone-physical-network-configuration.xml +++ b/docs/en-US/basic-zone-physical-network-configuration.xml @@ -24,6 +24,6 @@
Basic Zone Physical Network Configuration - In a basic network, configuring the physical network is fairly straightforward. You only need to configure one guest network to carry traffic that is generated by guest VMs. When you first add a zone to CloudPlatform, you set up the guest network through the Add Zone screens. + In a basic network, configuring the physical network is fairly straightforward. You only need to configure one guest network to carry traffic that is generated by guest VMs. When you first add a zone to &PRODUCT;, you set up the guest network through the Add Zone screens.
diff --git a/docs/en-US/best-practices-primary-storage.xml b/docs/en-US/best-practices-primary-storage.xml index 2f639b130cb..0c9a22fcb18 100644 --- a/docs/en-US/best-practices-primary-storage.xml +++ b/docs/en-US/best-practices-primary-storage.xml @@ -26,6 +26,6 @@ Best Practices for Primary Storage The speed of primary storage will impact guest performance. If possible, choose smaller, higher RPM drives for primary storage. - Ensure that nothing is stored on the server. Adding the server to CloudPlatform will destroy any existing data + Ensure that nothing is stored on the server. Adding the server to &PRODUCT; will destroy any existing data
diff --git a/docs/en-US/best-practices-secondary-storage.xml b/docs/en-US/best-practices-secondary-storage.xml index c2da7d8be2d..3d535c326e9 100644 --- a/docs/en-US/best-practices-secondary-storage.xml +++ b/docs/en-US/best-practices-secondary-storage.xml @@ -27,6 +27,6 @@ Each Zone can have one or more secondary storage servers. Multiple secondary storage servers provide increased scalability to the system. Secondary storage has a high read:write ratio and is expected to consist of larger drives with lower IOPS than primary storage. - Ensure that nothing is stored on the server. Adding the server to CloudPlatform will destroy any existing data. + Ensure that nothing is stored on the server. Adding the server to &PRODUCT; will destroy any existing data. diff --git a/docs/en-US/cloudplatform-api.xml b/docs/en-US/cloudplatform-api.xml deleted file mode 100644 index 3c4a91481d0..00000000000 --- a/docs/en-US/cloudplatform-api.xml +++ /dev/null @@ -1,31 +0,0 @@ - - -%BOOK_ENTITIES; -]> - - - -
- &PRODUCT; API - The &PRODUCT; API is a low level API that has been used to implement the &PRODUCT; web UIs. It is also a good basis for implementing other popular APIs such as EC2/S3 and emerging DMTF standards. - Many &PRODUCT; API calls are asynchronous. These will return a Job ID immediately when called. This Job ID can be used to query the status of the job later. Also, status calls on impacted resources will provide some indication of their state. - The API has a REST-like query basis and returns results in XML or JSON. - See the Developer’s Guide and the API Reference. -
diff --git a/docs/en-US/configuring-projects.xml b/docs/en-US/configuring-projects.xml index 0f84dd81454..af1fc5323e3 100644 --- a/docs/en-US/configuring-projects.xml +++ b/docs/en-US/configuring-projects.xml @@ -22,7 +22,7 @@ ]>
Configuring Projects - Before CloudPlatform users start using projects, the CloudPlatform administrator must set + Before &PRODUCT; users start using projects, the &PRODUCT; administrator must set up various systems to support them, including membership invitations, limits on project resources, and controls on who can create projects. diff --git a/docs/en-US/log-in-root-admin.xml b/docs/en-US/log-in-root-admin.xml index bf499d6fe95..b8535970ee6 100644 --- a/docs/en-US/log-in-root-admin.xml +++ b/docs/en-US/log-in-root-admin.xml @@ -35,7 +35,7 @@ Continue with basic setup. Choose this if you're just trying &PRODUCT;, and you want a guided walkthrough of the simplest possible configuration so that you can get started right away. We'll help you set up a cloud with the following features: a single machine that runs &PRODUCT; software and uses NFS to provide storage; a single machine running VMs under the XenServer or KVM hypervisor; and a shared public network. The prompts in this guided tour should give you all the information you need, but if you want just a bit more detail, you can follow along in the Trial Installation Guide. - I have used &PRODUCT; before. Choose this if you have already gone through a design phase and planned a more sophisticated deployment, or you are ready to start scaling up a trial cloud that you set up earlier with the basic setup screens. In the Administrator UI, you can start using the more powerful features of CloudPlatform, such as advanced VLAN networking, high availability, additional network elements such as load balancers and firewalls, and support for multiple hypervisors including Citrix XenServer, KVM, and VMware vSphere. + I have used &PRODUCT; before. Choose this if you have already gone through a design phase and planned a more sophisticated deployment, or you are ready to start scaling up a trial cloud that you set up earlier with the basic setup screens. In the Administrator UI, you can start using the more powerful features of &PRODUCT;, such as advanced VLAN networking, high availability, additional network elements such as load balancers and firewalls, and support for multiple hypervisors including Citrix XenServer, KVM, and VMware vSphere. The root administrator Dashboard appears. diff --git a/docs/en-US/manual-live-migration.xml b/docs/en-US/manual-live-migration.xml index 30a5c11a07f..52de4c403f3 100644 --- a/docs/en-US/manual-live-migration.xml +++ b/docs/en-US/manual-live-migration.xml @@ -24,7 +24,7 @@
Moving VMs Between Hosts (Manual Live Migration) - The CloudPlatform administrator can move a running VM from one host to another without interrupting service to users or going into maintenance mode. This is called manual live migration, and can be done under the following conditions: + The &PRODUCT; administrator can move a running VM from one host to another without interrupting service to users or going into maintenance mode. This is called manual live migration, and can be done under the following conditions: The root administrator is logged in. Domain admins and users can not perform manual live migration of VMs. The VM is running. Stopped VMs can not be live migrated. @@ -35,7 +35,7 @@ To manually live migrate a virtual machine - Log in to the CloudPlatform UI as a user or admin. + Log in to the &PRODUCT; UI as a user or admin. In the left navigation, click Instances. Choose the VM that you want to migrate. Click the Migrate Instance button diff --git a/docs/en-US/network-offerings.xml b/docs/en-US/network-offerings.xml index ccfb93cc4cc..c1fd79da890 100644 --- a/docs/en-US/network-offerings.xml +++ b/docs/en-US/network-offerings.xml @@ -24,7 +24,7 @@
Network Offerings - For the most up-to-date list of supported network services, see the CloudPlatform UI or call listNetworkServices. + For the most up-to-date list of supported network services, see the &PRODUCT; UI or call listNetworkServices. A network offering is a named set of network services, such as: DHCP @@ -39,9 +39,9 @@ (Optional) Network tag to specify which physical network to use When creating a new VM, the user chooses one of the available network offerings, and that determines which network services the VM can use. - The CloudPlatform administrator can create any number of custom network offerings, in addition to the default network offerings provided by CloudPlatform. By creating multiple custom network offerings, you can set up your cloud to offer different classes of service on a single multi-tenant physical network. For example, while the underlying physical wiring may be the same for two tenants, tenant A may only need simple firewall protection for their website, while tenant B may be running a web server farm and require a scalable firewall solution, load balancing solution, and alternate networks for accessing the database backend. - If you create load balancing rules while using a network service offering that includes an external load balancer device such as NetScaler, and later change the network service offering to one that uses the CloudPlatform virtual router, you must create a firewall rule on the virtual router for each of your existing load balancing rules so that they continue to function. - When creating a new virtual network, the CloudPlatform administrator chooses which network offering to enable for that network. Each virtual network is associated with one network offering. A virtual network can be upgraded or downgraded by changing its associated network offering. If you do this, be sure to reprogram the physical network to match. - CloudPlatform also has internal network offerings for use by CloudPlatform system VMs. These network offerings are not visible to users but can be modified by administrators. + The &PRODUCT; administrator can create any number of custom network offerings, in addition to the default network offerings provided by &PRODUCT;. By creating multiple custom network offerings, you can set up your cloud to offer different classes of service on a single multi-tenant physical network. For example, while the underlying physical wiring may be the same for two tenants, tenant A may only need simple firewall protection for their website, while tenant B may be running a web server farm and require a scalable firewall solution, load balancing solution, and alternate networks for accessing the database backend. + If you create load balancing rules while using a network service offering that includes an external load balancer device such as NetScaler, and later change the network service offering to one that uses the &PRODUCT; virtual router, you must create a firewall rule on the virtual router for each of your existing load balancing rules so that they continue to function. + When creating a new virtual network, the &PRODUCT; administrator chooses which network offering to enable for that network. Each virtual network is associated with one network offering. A virtual network can be upgraded or downgraded by changing its associated network offering. If you do this, be sure to reprogram the physical network to match. + &PRODUCT; also has internal network offerings for use by &PRODUCT; system VMs. These network offerings are not visible to users but can be modified by administrators.
diff --git a/docs/en-US/network-service-providers.xml b/docs/en-US/network-service-providers.xml index af570977259..82eaff18c05 100644 --- a/docs/en-US/network-service-providers.xml +++ b/docs/en-US/network-service-providers.xml @@ -24,12 +24,12 @@
Network Service Providers - For the most up-to-date list of supported network service providers, see the CloudPlatform UI or call listNetworkServiceProviders. + For the most up-to-date list of supported network service providers, see the &PRODUCT; UI or call listNetworkServiceProviders. A service provider (also called a network element) is hardware or virtual appliance that makes a network service possible; for example, a firewall appliance can be installed in the cloud to provide firewall service. On a single network, multiple providers can provide the same network service. For example, a firewall service may be provided by Cisco or Juniper devices in the same physical network. You can have multiple instances of the same service provider in a network (say, more than one Juniper SRX device). - If different providers are set up to provide the same service on the network, the administrator can create network offerings so users can specify which network service provider they prefer (along with the other choices offered in network offerings). Otherwise, CloudPlatform will choose which provider to use whenever the service is called for. + If different providers are set up to provide the same service on the network, the administrator can create network offerings so users can specify which network service provider they prefer (along with the other choices offered in network offerings). Otherwise, &PRODUCT; will choose which provider to use whenever the service is called for. Supported Network Service Providers - CloudPlatform ships with an internal list of the supported service providers, and you can choose from this list when creating a network offering. + &PRODUCT; ships with an internal list of the supported service providers, and you can choose from this list when creating a network offering.
diff --git a/docs/en-US/port-forwarding.xml b/docs/en-US/port-forwarding.xml index b7786936c4b..b2843eb9c29 100644 --- a/docs/en-US/port-forwarding.xml +++ b/docs/en-US/port-forwarding.xml @@ -29,9 +29,9 @@ You cannot use port forwarding to open ports for an elastic IP address. When elastic IP is used, outside access is instead controlled through the use of security groups. See Security Groups. To set up port forwarding: - Log in to the CloudPlatform UI as an administrator or end user. - If you have not already done so, add a public IP address range to a zone in CloudPlatform. See Adding a Zone and Pod in the Installation Guide. - Add one or more VM instances to CloudPlatform. + Log in to the &PRODUCT; UI as an administrator or end user. + If you have not already done so, add a public IP address range to a zone in &PRODUCT;. See Adding a Zone and Pod in the Installation Guide. + Add one or more VM instances to &PRODUCT;. In the left navigation bar, click Network. Click the name of the guest network where the VMs are running. diff --git a/docs/en-US/primary-storage.xml b/docs/en-US/primary-storage.xml index 4cefa83c190..7010868d24b 100644 --- a/docs/en-US/primary-storage.xml +++ b/docs/en-US/primary-storage.xml @@ -24,7 +24,7 @@
Primary Storage - This section gives concepts and technical details about CloudPlatform primary storage. For information about how to install and configure primary storage through the CloudPlatform UI, see the Advanced Installation Guide. + This section gives concepts and technical details about &PRODUCT; primary storage. For information about how to install and configure primary storage through the &PRODUCT; UI, see the Advanced Installation Guide. diff --git a/docs/en-US/query-filter.xml b/docs/en-US/query-filter.xml index fa5ea6344c1..1c0e493972d 100644 --- a/docs/en-US/query-filter.xml +++ b/docs/en-US/query-filter.xml @@ -24,8 +24,8 @@
Query Filter -The query filter is used to find a mapped user in the external LDAP server. The query filter should uniquely map the CloudPlatform user to LDAP user for a meaningful authentication. For more information about query filter syntax, consult the documentation for your LDAP server. -The CloudPlatform query filter wildcards are: +The query filter is used to find a mapped user in the external LDAP server. The query filter should uniquely map the &PRODUCT; user to LDAP user for a meaningful authentication. For more information about query filter syntax, consult the documentation for your LDAP server. +The &PRODUCT; query filter wildcards are: @@ -51,9 +51,9 @@ The following examples assume you are using Active Directory, and refer to user attributes from the Active Directory schema. -If the CloudPlatform user name is the same as the LDAP user ID: +If the &PRODUCT; user name is the same as the LDAP user ID: (uid=%u) -If the CloudPlatform user name is the LDAP display name: +If the &PRODUCT; user name is the LDAP display name: (displayName=%u) To find a user by email address: (mail=%e) diff --git a/docs/en-US/release-ip-address.xml b/docs/en-US/release-ip-address.xml index 87b53007cdb..c60b73ac65b 100644 --- a/docs/en-US/release-ip-address.xml +++ b/docs/en-US/release-ip-address.xml @@ -25,7 +25,7 @@
Releasing an IP Address - Log in to the CloudPlatform UI as an administrator or end user. + Log in to the &PRODUCT; UI as an administrator or end user. In the left navigation, choose Network. Click the name of the network where you want to work with. Click View IP Addresses. diff --git a/docs/en-US/roles.xml b/docs/en-US/roles.xml index 473e37b77f9..775e30b25f5 100644 --- a/docs/en-US/roles.xml +++ b/docs/en-US/roles.xml @@ -25,7 +25,7 @@
Roles - The CloudPlatform API supports three access roles: + The &PRODUCT; API supports three access roles: Root Admin. Access to all features of the cloud, including both virtual and physical resource management. Domain Admin. Access to only the virtual resources of the clouds that belong to the administrator’s domain. diff --git a/docs/en-US/troubleshooting-lb-rules-fails.xml b/docs/en-US/troubleshooting-lb-rules-fails.xml index c507178e831..62955341e23 100644 --- a/docs/en-US/troubleshooting-lb-rules-fails.xml +++ b/docs/en-US/troubleshooting-lb-rules-fails.xml @@ -30,7 +30,7 @@ Cause - Load balancing rules were created while using a network service offering that includes an external load balancer device such as NetScaler, and later the network service offering changed to one that uses the CloudPlatform virtual router. + Load balancing rules were created while using a network service offering that includes an external load balancer device such as NetScaler, and later the network service offering changed to one that uses the &PRODUCT; virtual router. Solution diff --git a/docs/en-US/troubleshooting-maintenance-mode-not-working-on-vCenter.xml b/docs/en-US/troubleshooting-maintenance-mode-not-working-on-vCenter.xml index c4bf37f6bbe..764d18825b8 100644 --- a/docs/en-US/troubleshooting-maintenance-mode-not-working-on-vCenter.xml +++ b/docs/en-US/troubleshooting-maintenance-mode-not-working-on-vCenter.xml @@ -30,7 +30,7 @@ Cause - The CloudPlatform administrator UI was used to place the host in scheduled maintenance mode. This mode is separate from vCenter's maintenance mode. + The &PRODUCT; administrator UI was used to place the host in scheduled maintenance mode. This mode is separate from vCenter's maintenance mode. Solution diff --git a/docs/en-US/using-swift-for-secondary-storage.xml b/docs/en-US/using-swift-for-secondary-storage.xml index bf238ca6466..329cf81de08 100644 --- a/docs/en-US/using-swift-for-secondary-storage.xml +++ b/docs/en-US/using-swift-for-secondary-storage.xml @@ -24,6 +24,6 @@
Using Swift for Secondary Storage - CloudPlatform supports OpenStack Object Storage ( Swift) for secondary storage. When using Swift, you configure Swift storage for the entire CloudPlatform, then set up NFS secondary storage for each zone as usual. The NFS storage in each zone acts as a staging area through which all templates and other secondary storage data pass before being forwarded to Swift. The Swift storage acts as a cloud-wide resource, making templates and other data available to any zone in the cloud. There is no hierarchy in the Swift storage, just one Swift container per storage object. Any secondary storage in the whole cloud can pull a container from Swift at need. It is not necessary to copy templates and snapshots from one zone to another, as would be required when using zone NFS alone. Everything is available everywhere + &PRODUCT; supports OpenStack Object Storage ( Swift) for secondary storage. When using Swift, you configure Swift storage for the entire &PRODUCT;, then set up NFS secondary storage for each zone as usual. The NFS storage in each zone acts as a staging area through which all templates and other secondary storage data pass before being forwarded to Swift. The Swift storage acts as a cloud-wide resource, making templates and other data available to any zone in the cloud. There is no hierarchy in the Swift storage, just one Swift container per storage object. Any secondary storage in the whole cloud can pull a container from Swift at need. It is not necessary to copy templates and snapshots from one zone to another, as would be required when using zone NFS alone. Everything is available everywhere Swift storage must be set up before you add NFS secondary storage to zones. This is accomplished through some additional configuration steps on a fresh Management Server installation, before you add the first zone. The procedure is described in Adding a Zone in the Advanced Installation Guide.
diff --git a/docs/en-US/vm-lifecycle.xml b/docs/en-US/vm-lifecycle.xml index f5696ced12c..ce09b0d04e9 100644 --- a/docs/en-US/vm-lifecycle.xml +++ b/docs/en-US/vm-lifecycle.xml @@ -29,12 +29,12 @@ - basic-deployment.png: Basic two-machine CloudStack deployment + basic-deployment.png: Basic two-machine &PRODUCT; deployment Once a virtual machine is destroyed, it cannot be recovered. All the resources used by the virtual machine will be reclaimed by the system. This includes the virtual machine’s IP address. A stop will attempt to gracefully shut down the operating system, which typically involves terminating all the running applications. If the operation system cannot be stopped, it will be forcefully terminated. This has the same effect as pulling the power cord to a physical machine. A reboot is a stop followed by a start. - CloudPlatform preserves the state of the virtual machine hard disk until the machine is destroyed. + &PRODUCT; preserves the state of the virtual machine hard disk until the machine is destroyed. A running virtual machine may fail because of hardware or network issues. A failed virtual machine is in the down state. The system places the virtual machine into the down state if it does not receive the heartbeat from the hypervisor for three minutes. The user can manually restart the virtual machine from the down state.