http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/changed-API-commands-4.3.xml ---------------------------------------------------------------------- diff --git a/en-US/changed-API-commands-4.3.xml b/en-US/changed-API-commands-4.3.xml deleted file mode 100644 index 8c4d962..0000000 --- a/en-US/changed-API-commands-4.3.xml +++ /dev/null @@ -1,619 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> -<!-- 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 - http://www.apache.org/licenses/LICENSE-2.0 - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<section id="changed-api-commands-4.3"> - <title>API Changes Introduced in 4.3</title> - <para>Here are the list of APIs changed as part of the 4.3 release.</para> - - <section id="hyperv-api"> - <title>Hyper-V</title> - <informaltable> - <tgroup cols="2" align="left" colsep="1" rowsep="1"> - <colspec colwidth="1.0*" colname="1" colnum="1"/> - <colspec colwidth="9.87*" colname="2" colnum="2"/> - <thead> - <row> - <entry><para>API</para></entry> - <entry><para>Description</para></entry> - </row> - </thead> - <tbody> - <row> - <entry><para>addPrimaryStorage</para></entry> - <entry><para>To this existing API, the following field has been added: - smb</para></entry> - </row> - <row> - <entry><para>addImageStore</para></entry> - <entry><para>To this existing API, the following field has been added: - smb</para></entry> - </row> - </tbody> - </tgroup> - </informaltable> - </section> - <section id="socket-api"> - <title>Reporting CPU Sockets</title> - <informaltable> - <tgroup cols="2" align="left" colsep="1" rowsep="1"> - <colspec colwidth="1.0*" colname="1" colnum="1"/> - <colspec colwidth="9.87*" colname="2" colnum="2"/> - <thead> - <row> - <entry><para>API</para></entry> - <entry><para>Description</para></entry> - </row> - </thead> - <tbody> - <row> - <entry><para>listhost</para></entry> - <entry><para>To this existing API, the following request parameter has been added: - hypervisor.</para><para>The new response parameter added is: cpusockets</para> - <para>cpusockets returns the number of CPU sockets on the host.</para></entry> - </row> - </tbody> - </tgroup> - </informaltable> - </section> - <section id="nfs-object"> - <title>Migrating NFS Secondary Storages to Use Object Store</title> - <informaltable> - <tgroup cols="2" align="left" colsep="1" rowsep="1"> - <colspec colwidth="1.0*" colname="1" colnum="1"/> - <colspec colwidth="9.87*" colname="2" colnum="2"/> - <thead> - <row> - <entry><para>API</para></entry> - <entry><para>Description</para></entry> - </row> - </thead> - <tbody> - <row> - <entry><para>updateCloudToUseObjectStore</para></entry> - <entry><para>Migrate current NFS secondary storages to use object store.</para></entry> - </row> - </tbody> - </tgroup> - </informaltable> - </section> - <section id="ldap-apis"> - <title>LDAP Authentication</title> - <informaltable> - <tgroup cols="2" align="left" colsep="1" rowsep="1"> - <colspec colwidth="1.0*" colname="1" colnum="1"/> - <colspec colwidth="9.87*" colname="2" colnum="2"/> - <thead> - <row> - <entry><para>API</para></entry> - <entry><para>Description</para></entry> - </row> - </thead> - <tbody> - <row> - <entry><para>listLdapConfigurations</para></entry> - <entry><para>Lists all the LDAP configurations.</para></entry> - </row> - <row> - <entry><para>addLdapConfiguration</para></entry> - <entry><para>Add a new LDAP Configuration.</para></entry> - </row> - <row> - <entry><para>deleteLdapConfiguration</para></entry> - <entry><para>Removes an LDAP Configuration.</para></entry> - </row> - <row> - <entry><para>listLdapUsers</para></entry> - <entry><para>Lists all the LDAP users.</para></entry> - </row> - <row> - <entry><para>ldapCreateAccount</para></entry> - <entry><para>Creates an account from an LDAP user.</para></entry> - </row> - <row> - <entry><para>importLdapUsers</para></entry> - <entry><para>Import LDAP users.</para></entry> - </row> - </tbody> - </tgroup> - </informaltable> - <para>The following APIs have been deprecated: ldapConfig and ldapRemove </para> - </section> - <section id="alert-api"> - <title>Publishing Alerts Using the Web ROOT Admin API</title> - <informaltable> - <tgroup cols="2" align="left" colsep="1" rowsep="1"> - <colspec colwidth="1.0*" colname="1" colnum="1"/> - <colspec colwidth="9.87*" colname="2" colnum="2"/> - <thead> - <row> - <entry><para>API</para></entry> - <entry><para>Description</para></entry> - </row> - </thead> - <tbody> - <row> - <entry><para>generateAlert</para></entry> - <entry><para>A new API has been added to generate and publish alerts for usage services. - The usage services can be installed on a different host or the same host where the - Management Server is running. This API is available only to the Root - Admin.</para></entry> - </row> - <row> - <entry><para>listAlerts</para></entry> - <entry><para>To this existing API, a new response parameter has been added: name. An - alert can be searched on the basis of alert name.</para></entry> - </row> - </tbody> - </tgroup> - </informaltable> - </section> - <section id="dynamic-compute"> - <title>Dynamic Compute Offering</title> - <informaltable> - <tgroup cols="2" align="left" colsep="1" rowsep="1"> - <colspec colwidth="1.0*" colname="1" colnum="1"/> - <colspec colwidth="9.87*" colname="2" colnum="2"/> - <thead> - <row> - <entry><para>API</para></entry> - <entry><para>Description</para></entry> - </row> - </thead> - <tbody> - <row> - <entry><para>DeployVM</para></entry> - <entry><para>To this existing API, the following request parameter has been added: - details.</para></entry> - </row> - <row> - <entry><para>ScaleVM</para></entry> - <entry><para>To this existing API, the following request parameter has been added: - details.</para></entry> - </row> - <row> - <entry><para>ScaleSystemVM</para></entry> - <entry><para>To this existing API, the following request parameter has been added: - details.</para></entry> - </row> - <row> - <entry><para>UpgradeVM</para></entry> - <entry><para>To this existing API, the following request parameter has been added: - details.</para></entry> - </row> - <row> - <entry><para>UpgradeSysytemVM</para></entry> - <entry><para>To this existing API, the following request parameter has been added: - details.</para></entry> - </row> - </tbody> - </tgroup> - </informaltable> - </section> - <section id="vr-api"> - <title>Enhanced Upgrade for Virtual Routers</title> - <informaltable> - <tgroup cols="2" align="left" colsep="1" rowsep="1"> - <colspec colwidth="1.0*" colname="1" colnum="1"/> - <colspec colwidth="9.87*" colname="2" colnum="2"/> - <thead> - <row> - <entry><para>API</para></entry> - <entry><para>Description</para></entry> - </row> - </thead> - <tbody> - <row> - <entry><para>upgradeRouterTemplate</para></entry> - <entry><para>This is a new API which has been added in this release.</para> - <para>The following are the request parameters:</para> - <itemizedlist> - <listitem> - <para>id: Upgrade the specified VR</para> - </listitem> - <listitem> - <para>zone_id : Upgrade the VRs in the specified zone.</para> - </listitem> - <listitem> - <para>pod_id : Upgrade the VRs in the specified pod.</para> - </listitem> - <listitem> - <para>cluster_id : Upgrade the VRs in the specified cluster.</para> - </listitem> - <listitem> - <para>domain_id : Upgrade the VRs belonging to the specified domain.</para> - </listitem> - <listitem> - <para>account_id : Upgrade the VRs belonging to the specified account.</para> - </listitem> - </itemizedlist> - </entry> - </row> - <row> - <entry><para>listRouters</para></entry> - <entry><para>For this existing API, the following request parameters has been - added:</para> - <itemizedlist> - <listitem> - <para>version: Lists routers by specified version.</para> - </listitem> - <listitem> - <para>zone_id : lists routers in specified zone.</para> - </listitem> - <listitem> - <para>pod_id : Lists routers in the specified pod.</para> - </listitem> - <listitem> - <para>cluster_id : Lists routers in the specified cluster.</para> - </listitem> - <listitem> - <para>domain_id : Lists routers owned by specified domain.</para> - </listitem> - <listitem> - <para>account: Lists routers owned by specified account.</para> - </listitem> - </itemizedlist> - <para>The following response parameters has been added:</para> - <itemizedlist> - <listitem> - <para>version : (String) The router version. For example, 4.3.0.</para> - </listitem> - <listitem> - <para>requiresupgrade: (Boolean) The flag to indicate if the router template - requires an upgrade.</para> - </listitem> - </itemizedlist></entry> - </row> - </tbody> - </tgroup> - </informaltable> - <section id="otherapis-4.3"> - <title>Assorted List of Changed APIs</title> - <itemizedlist> - <listitem> - <para>expungeVirtualMachine</para> - <para>Expunge a virtual machine. Once expunged, it cannot be recovered.</para> - </listitem> - <listitem> - <para>revertSnapshot</para> - <para>Reverts a volume snapshot.</para> - </listitem> - <listitem> - <para>reconnectHost </para> - <para>New response parameters: cpusockets</para> - </listitem> - <listitem> - <para>copyTemplate </para> - <para>Changed request parameters: sourcezoneid (optional) </para> - </listitem> - <listitem> - <para>listRouters</para> - <para>New request parameters: clusterid (optional), version (optional) </para> - <para>New response parameters: requiresupgrade, version </para> - <para>New removed parameters: templateversion </para> - </listitem> - <listitem> - <para>createVpnConnection</para> - <para>New request parameters: passive (optional) </para> - <para>New response parameters: passive</para> - </listitem> - <listitem> - <para>listVolumes </para> - <para>New request parameters: storageid (optional) </para> - <para>New response parameters: path, quiescevm, storageid</para> - </listitem> - <listitem> - <para>migrateVolume</para> - <para>New response parameters: path, quiescevm, storageid</para> - </listitem> - <listitem> - <para>enableStorageMaintenance </para> - <para>New response parameters: storagecapabilities</para> - </listitem> - <listitem> - <para>stopRouter</para> - <para>New response parameters: requiresupgrade, version </para> - <para>Removed parameters: templateversion</para> - </listitem> - <listitem> - <para>attachVolume </para> - <para>New response parameters: path, quiescevm, storageid</para> - </listitem> - <listitem> - <para>listAlerts </para> - <para>New request parameters: name (optional)</para> - <para>New response parameters: name </para> - </listitem> - <listitem> - <para>updateVolume</para> - <para>New request parameters: displayvolume (optional), state (optional), storageid - (optional)</para> - <para>Changed parameters: id (optional), path (optional) </para> - <para>New response parameters: path, quiescevm, storageid </para> - </listitem> - <listitem> - <para>cancelHostMaintenance </para> - <para>New response parameters: cpusockets</para> - </listitem> - <listitem> - <para>updateServiceOffering </para> - <para>New response parameters: iscustomized</para> - </listitem> - <listitem> - <para>updateStoragePool </para> - <para>New response parameters: storagecapabilities</para> - </listitem> - <listitem> - <para>addBaremetalHost </para> - <para>New response parameters: cpusockets</para> - </listitem> - <listitem> - <para>resizeVolume </para> - <para>New response parameters: path, quiescevm, storageid</para> - </listitem> - <listitem> - <para>createVMSnapshot </para> - <para>New request parameters: quiescevm (optional)</para> - </listitem> - <listitem> - <para>createIpForwardingRule</para> - <para>New response parameters: networkid </para> - </listitem> - <listitem> - <para>updateDiskOffering </para> - <para>New request parameters: displayoffering (optional)</para> - </listitem> - <listitem> - <para>listCapabilities </para> - <para>New response parameters: kvmsnapshotenabled </para> - <para>Removed parameters: KVMsnapshotenabled</para> - </listitem> - <listitem> - <para>startInternalLoadBalancerVM </para> - <para>New response parameters: requiresupgrade, version </para> - <para>Removed parameters: templateversion </para> - </listitem> - <listitem> - <para>updatePortForwardingRule </para> - <para>New response parameters: networkid</para> - </listitem> - <listitem> - <para>listPortForwardingRules </para> - <para>New request parameters: networkid (optional) </para> - <para>New response parameters: networkid</para> - </listitem> - <listitem> - <para>cancelStorageMaintenance </para> - <para>New response parameters: storagecapabilities</para> - </listitem> - <listitem> - <para>deployVirtualMachine </para> - <para>New request parameters: details (optional)</para> - </listitem> - <listitem> - <para>createPortForwardingRule </para> - <para>New response parameters: networkid</para> - </listitem> - <listitem> - <para>createVPCOffering </para> - <para>New request parameters: serviceofferingid (optional)</para> - </listitem> - <listitem> - <para>destroyRouter </para> - <para>New response parameters: requiresupgrade, version </para> - <para>Removed parameters: templateversion</para> - </listitem> - <listitem> - <para>updateTrafficType </para> - <para>New request parameters: hypervnetworklabel (optional) </para> - <para>New response parameters: hypervnetworklabel</para> - </listitem> - <listitem> - <para>addHost </para> - <para>New response parameters: cpusockets</para> - </listitem> - <listitem> - <para>rebootRouter</para> - <para>New response parameters: requiresupgrade, version </para> - <para>Removed parameters: templateversion</para> - </listitem> - <listitem> - <para>updateHost </para> - <para>New response parameters: cpusockets</para> - </listitem> - <listitem> - <para>detachVolume </para> - <para>New response parameters: path, quiescevm, storageid</para> - </listitem> - <listitem> - <para>listSnapshots </para> - <para>New response parameters: revertable</para> - </listitem> - <listitem> - <para>updateLoadBalancerRule </para> - <para>New response parameters: protocol</para> - </listitem> - <listitem> - <para>listRemoteAccessVpns </para> - <para>New request parameters: id (optional), networkid (optional) </para> - <para>Changed parameters: publicipid (optional)</para> - </listitem> - <listitem> - <para>prepareHostForMaintenance </para> - <para>New response parameters: cpusockets </para> - </listitem> - <listitem> - <para>stopInternalLoadBalancerVM </para> - <para>New response parameters: requiresupgrade, version </para> - <para>Removed parameters: templateversion</para> - </listitem> - <listitem> - <para>listLoadBalancerRules </para> - <para>New response parameters: protocol </para> - </listitem> - <listitem> - <para>listResourceDetails </para> - <para>New request parameters: fordisplay (optional) </para> - <para>Changed parameters: resourcetype (required), resourceid (required)</para> - </listitem> - <listitem> - <para>scaleVirtualMachine </para> - <para>New request parameters: details (optional)</para> - </listitem> - <listitem> - <para>changeServiceForRouter </para> - <para>New response parameters: requiresupgrade, version </para> - <para>Removed parameters: templateversion</para> - </listitem> - <listitem> - <para>updateZone </para> - <para>New response parameters: resourcedetails, tags(*) </para> - <para>Removed parameters: affinitygroupid</para> - </listitem> - <listitem> - <para>listFirewallRules </para> - <para>New request parameters: networkid (optional)</para> - </listitem> - <listitem> - <para>createZone </para> - <para>New response parameters: resourcedetails, tags(*) </para> - <para>Removed parameters: affinitygroupid</para> - </listitem> - <listitem> - <para>deleteNetwork </para> - <para>New request parameters: forced (optional)</para> - </listitem> - <listitem> - <para>changeServiceForSystemVm </para> - <para>New request parameters: details (optional)</para> - </listitem> - <listitem> - <para>createStoragePool </para> - <para>New response parameters: storagecapabilities</para> - </listitem> - <listitem> - <para>addTrafficType </para> - <para>New request parameters: hypervnetworklabel (optional), isolationmethod (optional) </para> - <para>New response parameters: hypervnetworklabel </para> - </listitem> - <listitem> - <para>createServiceOffering </para> - <para>Changed request parameters: memory (optional), cpunumber (optional), cpuspeed (optional) </para> - <para>New response parameters: iscustomized</para> - </listitem> - <listitem> - <para>createVPC </para> - <para>New request parameters: start (optional)</para> - </listitem> - <listitem> - <para>listZones </para> - <para>New request parameters: tags (optional) </para> - <para>New response parameters: resourcedetails, tags(*) </para> - <para>Removed parameters: affinitygroupid </para> - </listitem> - <listitem> - <para>createVolume </para> - <para>New request parameters: virtualmachineid (optional) </para> - <para>New response parameters: path, quiescevm, storageid </para> - </listitem> - <listitem> - <para>startRouter </para> - <para>New response parameters: requiresupgrade, version </para> - <para>Removed parameters: templateversion</para> - </listitem> - <listitem> - <para>changeServiceForVirtualMachine </para> - <para>New request parameters: details (optional)</para> - </listitem> - <listitem> - <para>listStoragePools </para> - <para>New response parameters: storagecapabilities </para> - </listitem> - <listitem> - <para>resetVpnConnection </para> - <para>New response parameters: passive</para> - </listitem> - <listitem> - <para>createPrivateGateway </para> - <para>New request parameters: networkofferingid (optional)</para> - </listitem> - <listitem> - <para>listServiceOfferings </para> - <para>New response parameters: iscustomized</para> - </listitem> - <listitem> - <para>createLoadBalancerRule </para> - <para>New request parameters: protocol (optional) </para> - <para>New response parameters: protocol</para> - </listitem> - <listitem> - <para>createNetworkOffering </para> - <para>New request parameters: keepaliveenabled (optional)</para> - </listitem> - <listitem> - <para>copyIso </para> - <para>Changed request parameters: sourcezoneid (optional)</para> - </listitem> - <listitem> - <para>uploadVolume </para> - <para>New response parameters: path, quiescevm, storageid</para> - </listitem> - <listitem> - <para>createSnapshot </para> - <para>New request parameters: quiescevm (optional) </para> - <para>New response parameters: revertable</para> - </listitem> - <listitem> - <para>listIpForwardingRules </para> - <para>New response parameters: networkid</para> - </listitem> - <listitem> - <para>createDiskOffering </para> - <para>New request parameters: hypervisorsnapshotreserve (optional)</para> - </listitem> - <listitem> - <para>listInternalLoadBalancerVMs </para> - <para>New response parameters: requiresupgrade, version </para> - <para>Removed parameters: templateversion </para> - </listitem> - <listitem> - <para>scaleSystemVm Request: New parameters: details (optional)</para> - </listitem> - <listitem> - <para>listHosts </para> - <para>New request parameters: hypervisor (optional) Response: New parameters: - cpusockets</para> - </listitem> - <listitem> - <para>listVpnConnections</para> - <para>New response parameters: passive</para> - </listitem> - <listitem> - <para>updateNetworkOffering </para> - <para>Request: New parameters: keepaliveenabled (optional) </para> - </listitem> - <listitem> - <para>findStoragePoolsForMigration</para> - <para>New response parameters: storagecapabilities</para> - </listitem> - </itemizedlist> - </section> - - </section> -</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/changed-apicommands-4-0.xml ---------------------------------------------------------------------- diff --git a/en-US/changed-apicommands-4-0.xml b/en-US/changed-apicommands-4-0.xml deleted file mode 100644 index 042d5e2..0000000 --- a/en-US/changed-apicommands-4-0.xml +++ /dev/null @@ -1,268 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> -<!-- 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 - http://www.apache.org/licenses/LICENSE-2.0 - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<section id="changed-apicommands-4.0"> - <title>Changed API Commands in 4.0.0-incubating</title> - <informaltable> - <tgroup cols="2" align="left" colsep="1" rowsep="1"> - <colspec colwidth="1" colname="1" colnum="1"/> - <colspec colwidth="2*" colname="2" colnum="2"/> - <thead> - <row> - <entry><para>API Commands</para></entry> - <entry><para>Description</para></entry> - </row> - </thead> - <tbody> - <row> - <entry> - <para>copyTemplate</para> - <para>prepareTemplate</para> - <para>registerTemplate</para> - <para>updateTemplate</para> - <para>createProject</para> - <para>activateProject</para> - <para>suspendProject</para> - <para>updateProject</para> - <para>listProjectAccounts</para> - <para>createVolume</para> - <para>migrateVolume</para> - <para>attachVolume</para> - <para>detachVolume</para> - <para>uploadVolume</para> - <para>createSecurityGroup</para> - <para>registerIso</para> - <para>copyIso</para> - <para>updateIso</para> - <para>createIpForwardingRule</para> - <para>listIpForwardingRules</para> - <para>createLoadBalancerRule</para> - <para>updateLoadBalancerRule</para> - <para>createSnapshot</para> - </entry> - <entry> - <para>The commands in this list have a single new response parameter, and no other - changes.</para> - <para>New response parameter: tags(*)</para> - <note> - <para>Many other commands also have the new tags(*) parameter in addition to other - changes; those commands are listed separately.</para> - </note></entry> - </row> - <row> - <entry> - <para>rebootVirtualMachine</para> - <para>attachIso</para> - <para>detachIso</para> - <para>listLoadBalancerRuleInstances</para> - <para>resetPasswordForVirtualMachine</para> - <para>changeServiceForVirtualMachine</para> - <para>recoverVirtualMachine</para> - <para>startVirtualMachine</para> - <para>migrateVirtualMachine</para> - <para>deployVirtualMachine</para> - <para>assignVirtualMachine</para> - <para>updateVirtualMachine</para> - <para>restoreVirtualMachine</para> - <para>stopVirtualMachine</para> - <para>destroyVirtualMachine</para> - </entry> - <entry> - <para>The commands in this list have two new response parameters, and no other - changes.</para> - <para>New response parameters: keypair, tags(*)</para> - </entry> - </row> - <row> - <entry> - <para>listSecurityGroups</para> - <para>listFirewallRules</para> - <para>listPortForwardingRules</para> - <para>listSnapshots</para> - <para>listIsos</para> - <para>listProjects</para> - <para>listTemplates</para> - <para>listLoadBalancerRules</para> - </entry> - <entry><para>The commands in this list have the following new parameters, and no other - changes.</para> - <para>New request parameter: tags (optional)</para> - <para>New response parameter: tags(*)</para> - </entry> - </row> - <row> - <entry> - <para>listF5LoadBalancerNetworks</para> - <para>listNetscalerLoadBalancerNetworks</para> - <para>listSrxFirewallNetworks</para> - <para>updateNetwork</para> - </entry> - <entry> - <para>The commands in this list have three new response parameters, and no other - changes.</para> - <para>New response parameters: canusefordeploy, vpcid, tags(*)</para> - </entry> - </row> - <row> - <entry> - <para>createZone</para> - <para>updateZone</para> - </entry> - <entry><para>The commands in this list have the following new parameters, and no other - changes.</para> - <para>New request parameter: localstorageenabled (optional)</para> - <para>New response parameter: localstorageenabled</para> - </entry> - </row> - <row> - <entry><para>listZones</para></entry> - <entry><para>New response parameter: localstorageenabled</para></entry> - </row> - <row> - <entry> - <para>rebootRouter</para> - <para>changeServiceForRouter</para> - <para>startRouter</para> - <para>destroyRouter</para> - <para>stopRouter</para> - </entry> - <entry><para>The commands in this list have two new response parameters, and no other - changes.</para> - <para>New response parameters: vpcid, nic(*)</para></entry> - </row> - <row> - <entry> - <para>updateAccount</para> - <para>disableAccount</para> - <para>listAccounts</para> - <para>markDefaultZoneForAccount</para> - <para>enableAccount</para> - </entry> - <entry><para>The commands in this list have three new response parameters, and no other - changes.</para> - <para>New response parameters: vpcavailable, vpclimit, vpctotal</para></entry> - </row> - <row> - <entry><para>listRouters</para></entry> - <entry> - <para>New request parameters: forvpc (optional), vpcid (optional)</para> - <para>New response parameters: vpcid, nic(*)</para> - </entry> - </row> - <row> - <entry><para>listNetworkOfferings</para></entry> - <entry> - <para>New request parameters: forvpc (optional)</para> - <para>New response parameters: forvpc </para> - </entry> - </row> - <row> - <entry><para>listVolumes</para></entry> - <entry> - <para>New request parameters: details (optional), tags (optional)</para> - <para>New response parameters: tags(*)</para> - </entry> - </row> - <row> - <entry><para>addTrafficMonitor</para></entry> - <entry> - <para>New request parameters: excludezones (optional), includezones (optional)</para> - </entry> - </row> - <row> - <entry><para>createNetwork</para></entry> - <entry> - <para>New request parameters: vpcid (optional)</para> - <para>New response parameters: canusefordeploy, vpcid, tags(*)</para> - </entry> - </row> - <row> - <entry><para>listPublicIpAddresses</para></entry> - <entry> - <para>New request parameters: tags (optional), vpcid (optional)</para> - <para>New response parameters: vpcid, tags(*)</para> - </entry> - </row> - <row> - <entry><para>listNetworks</para></entry> - <entry> - <para>New request parameters: canusefordeploy (optional), forvpc (optional), tags - (optional), vpcid (optional)</para> - <para>New response parameters: canusefordeploy, vpcid, tags(*)</para> - </entry> - </row> - <row> - <entry><para>restartNetwork</para></entry> - <entry> - <para>New response parameters: vpcid, tags(*)</para> - </entry> - </row> - <row> - <entry><para>enableStaticNat</para></entry> - <entry> - <para>New request parameter: networkid (optional)</para> - </entry> - </row> - <row> - <entry><para>createDiskOffering</para></entry> - <entry> - <para>New request parameter: storagetype (optional)</para> - <para>New response parameter: storagetype</para> - </entry> - </row> - <row> - <entry><para>listDiskOfferings</para></entry> - <entry> - <para>New response parameter: storagetype</para> - </entry> - </row> - <row> - <entry><para>updateDiskOffering</para></entry> - <entry> - <para>New response parameter: storagetype</para> - </entry> - </row> - <row> - <entry><para>createFirewallRule</para></entry> - <entry> - <para>Changed request parameters: ipaddressid (old version - optional, new version - - required)</para> - <para>New response parameter: tags(*)</para> - </entry> - </row> - <row> - <entry><para>listVirtualMachines</para></entry> - <entry> - <para>New request parameters: isoid (optional), tags (optional), templateid - (optional)</para> - <para>New response parameters: keypair, tags(*)</para> - </entry> - </row> - <row> - <entry><para>updateStorageNetworkIpRange</para></entry> - <entry> - <para>New response parameters: id, endip, gateway, netmask, networkid, podid, startip, - vlan, zoneid</para> - </entry> - </row> - </tbody> - </tgroup> - </informaltable> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/changed-apicommands-4.1.xml ---------------------------------------------------------------------- diff --git a/en-US/changed-apicommands-4.1.xml b/en-US/changed-apicommands-4.1.xml deleted file mode 100644 index 1667aaf..0000000 --- a/en-US/changed-apicommands-4.1.xml +++ /dev/null @@ -1,253 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> -<!-- 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 - http://www.apache.org/licenses/LICENSE-2.0 - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<section id="changed-apicommands-4.1"> - <title>Changed API Commands in 4.1</title> - <informaltable> - <tgroup cols="2" align="left" colsep="1" rowsep="1"> - <colspec colwidth="1.0*" colname="1" colnum="1"/> - <colspec colwidth="4.37*" colname="2" colnum="2"/> - <thead> - <row> - <entry><para>API Commands</para></entry> - <entry><para>Description</para></entry> - </row> - </thead> - <tbody> - <row> - <entry> - <para>createNetworkOffering</para> - </entry> - <entry> - <para>The following request parameters have been added:</para> - <itemizedlist> - <listitem> - <para>isPersistent</para> - </listitem> - <listitem> - <para>startipv6</para> - </listitem> - <listitem> - <para>endipv6</para> - </listitem> - <listitem> - <para>ip6gateway</para> - </listitem> - <listitem> - <para>ip6cidr</para> - </listitem> - </itemizedlist> - </entry> - </row> - <row> - <entry> - <para>listNetworkOfferings</para> - <para>listNetworks</para> - </entry> - <entry> - <para>The following request parameters have been added:</para> - <itemizedlist> - <listitem> - <para>isPersistent</para> - <para>This parameter determines if the network or network offering listed are - persistent or not.</para> - </listitem> - <listitem> - <para>ip6gateway</para> - </listitem> - <listitem> - <para>ip6cidr</para> - </listitem> - </itemizedlist> - </entry> - </row> - <row> - <entry> - <para>createVlanIpRange</para> - </entry> - <entry> - <para>The following request parameters have been added:</para> - <itemizedlist> - <listitem> - <para>startipv6</para> - </listitem> - <listitem> - <para>endipv6</para> - </listitem> - <listitem> - <para>ip6gateway</para> - </listitem> - <listitem> - <para>ip6cidr</para> - </listitem> - </itemizedlist> - </entry> - </row> - <row> - <entry> - <para>deployVirtualMachine</para> - </entry> - <entry> - <para>The following parameter has been added: ip6Address.</para> - <para>The following parameter is updated to accept the IPv6 address: - iptonetworklist.</para> - </entry> - </row> - <row> - <entry> - <para>CreateZoneCmd</para> - </entry> - <entry> - <para>The following parameter have been added: ip6dns1, ip6dns2.</para> - </entry> - </row> - <row> - <entry> - <para>listRouters</para> - <para>listVirtualMachines</para> - </entry> - <entry> - <para>For nic responses, the following fields have been added.</para> - <itemizedlist> - <listitem> - <para>ip6address</para> - </listitem> - <listitem> - <para>ip6gateway</para> - </listitem> - <listitem> - <para>ip6cidr</para> - </listitem> - </itemizedlist> - </entry> - </row> - <row> - <entry> - <para>listVlanIpRanges</para> - </entry> - <entry> - <para>For nic responses, the following fields have been added.</para> - <itemizedlist> - <listitem> - <para>startipv6</para> - </listitem> - <listitem> - <para>endipv6</para> - </listitem> - <listitem> - <para>ip6gateway</para> - </listitem> - <listitem> - <para>ip6cidr</para> - </listitem> - </itemizedlist> - </entry> - </row> - <row> - <entry> - <para>listRouters</para> - <para>listZones</para> - </entry> - <entry> - <para>For DomainRouter and DataCenter response, the following fields have been - added.</para> - <itemizedlist> - <listitem> - <para>ip6dns1</para> - </listitem> - <listitem> - <para>ip6dns2</para> - </listitem> - </itemizedlist> - </entry> - </row> - <row> - <entry> - <para>addF5LoadBalancer</para> - <para>configureNetscalerLoadBalancer</para> - <para>addNetscalerLoadBalancer</para> - <para>listF5LoadBalancers</para> - <para>configureF5LoadBalancer</para> - <para>listNetscalerLoadBalancers</para> - </entry> - <entry> - <para>The following response parameter is removed: inline.</para> - </entry> - </row> - <row> - <entry><para>listFirewallRules</para> - <para>createFirewallRule</para></entry> - <entry> - <para>The following request parameter is added: traffictype (optional).</para> - </entry> - </row> - <row> - <entry><para>listUsageRecords</para></entry> - <entry><para>The following response parameter is added: virtualsize.</para> - </entry> - </row> - <row> - <entry> - <para>deleteIso</para> - </entry> - <entry> - <para>The following request parameter is added: forced (optional).</para> - </entry> - </row> - <row> - <entry> - <para>createStoragePool</para> - </entry> - <entry> - <para>The following request parameters are made mandatory:</para> - <itemizedlist> - <listitem> - <para>podid</para> - </listitem> - <listitem> - <para>clusterid</para> - </listitem> - </itemizedlist> - </entry> - </row> - <row> - <entry> - <para>listZones</para> - </entry> - <entry> - <para>The following request parameter is added: securitygroupenabled</para> - </entry> - </row> - <row> - <entry><para>createAccount</para></entry> - <entry><para>The following new request parameters are added: accountid, userid</para></entry> - </row> - <row> - <entry><para>createUser</para></entry> - <entry><para>The following new request parameter is added: userid</para></entry> - </row> - <row> - <entry><para>createDomain</para></entry> - <entry><para>The following new request parameter is added: domainid</para></entry> - </row> - </tbody> - </tgroup> - </informaltable> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/changing-root-password.xml ---------------------------------------------------------------------- diff --git a/en-US/changing-root-password.xml b/en-US/changing-root-password.xml deleted file mode 100644 index 880f50f..0000000 --- a/en-US/changing-root-password.xml +++ /dev/null @@ -1,50 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- 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 - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<section id="changing-root-password"> - <title>Changing the Root Password</title> - <para>During installation and ongoing cloud administration, you will need to log in to the UI as the root administrator. - The root administrator account manages the &PRODUCT; deployment, including physical infrastructure. - The root administrator can modify configuration settings to change basic functionality, create or delete user accounts, and take many actions that should be performed only by an authorized person. - When first installing &PRODUCT;, be sure to change the default password to a new, unique value.</para> - <orderedlist> - <listitem><para>Open your favorite Web browser and go to this URL. Substitute the IP address of your own Management Server:</para> - <programlisting>http://<management-server-ip-address>:8080/client</programlisting> - </listitem> - <listitem><para>Log in to the UI using the current root user ID and password. The default is admin, password.</para></listitem> - <listitem><para>Click Accounts.</para></listitem> - <listitem><para>Click the admin account name.</para></listitem> - <listitem><para>Click View Users.</para></listitem> - <listitem><para>Click the admin user name.</para></listitem> - <listitem> - <para>Click the Change Password button. - <inlinemediaobject> - <imageobject> - <imagedata fileref="./images/change-password.png" /> - </imageobject> - <textobject><phrase>change-password.png: button to change a user's password</phrase></textobject> - </inlinemediaobject></para> - </listitem> - <listitem><para>Type the new password, and click OK.</para></listitem> - </orderedlist> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/changing-secondary-storage-ip.xml ---------------------------------------------------------------------- diff --git a/en-US/changing-secondary-storage-ip.xml b/en-US/changing-secondary-storage-ip.xml deleted file mode 100644 index 34f93e3..0000000 --- a/en-US/changing-secondary-storage-ip.xml +++ /dev/null @@ -1,44 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- 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 - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<section id="changing-secondary-storage-ip"> - <title>Changing the Secondary Storage IP Address</title> - <para>You can change the secondary storage IP address after it has been provisioned. After changing the IP address on the host, log in to your management server and execute the following commands. Replace HOSTID below with your own value, and change the URL to use the appropriate IP address and path for your server:</para> - <programlisting> - # mysql -p - mysql> use cloud; - mysql> select id from host where type = 'SecondaryStorage'; - mysql> update host_details set value = 'nfs://192.168.160.20/export/mike-ss1' - where host_id = HOSTID and name = 'orig.url'; - mysql> update host set name = 'nfs://192.168.160.20/export/mike-ss1' where type - = 'SecondaryStorage' and id = #; - mysql> update host set url = 'nfs://192.168.160.20/export/mike-ss1' where type - = 'SecondaryStorage' and id = #; - mysql> update host set guid = 'nfs://192.168.160.20/export/mike-ss1' where type - = 'SecondaryStorage' and id = #; - </programlisting> - <note><para>When copying and pasting a command, be sure the command has pasted as a single line before executing. Some document viewers may introduce unwanted line breaks in copied text.</para></note> - <para>Then log in to the cloud console UI and stop and start (not reboot) the Secondary Storage VM for that Zone.</para> - - </section> - http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/changing-secondary-storage-servers.xml ---------------------------------------------------------------------- diff --git a/en-US/changing-secondary-storage-servers.xml b/en-US/changing-secondary-storage-servers.xml deleted file mode 100644 index a628eec..0000000 --- a/en-US/changing-secondary-storage-servers.xml +++ /dev/null @@ -1,36 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- 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 - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<section id="changing-secondary-storage-servers"> - <title>Changing Secondary Storage Servers</title> - <para>You can change the secondary storage NFS mount. Perform the following steps to do so:</para> - <orderedlist> - <listitem><para>Stop all running Management Servers.</para></listitem> - <listitem><para>Wait 30 minutes. This allows any writes to secondary storage to complete.</para></listitem> - <listitem><para>Copy all files from the old secondary storage mount to the new.</para></listitem> - <listitem><para>Use the procedure above to change the IP address for secondary storage if required.</para></listitem> - <listitem><para>Start the Management Server.</para></listitem> - </orderedlist> - </section> - http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/changing-service-offering-for-vm.xml ---------------------------------------------------------------------- diff --git a/en-US/changing-service-offering-for-vm.xml b/en-US/changing-service-offering-for-vm.xml deleted file mode 100644 index 5e37880..0000000 --- a/en-US/changing-service-offering-for-vm.xml +++ /dev/null @@ -1,189 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- 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 - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<section id="changing-service-offering-for-vm"> - <title>Changing the Service Offering for a VM</title> - <para>To upgrade or downgrade the level of compute resources available to a virtual machine, you - can change the VM's compute offering.</para> - <orderedlist> - <listitem> - <para>Log in to the &PRODUCT; UI as a user or admin.</para> - </listitem> - <listitem> - <para>In the left navigation, click Instances.</para> - </listitem> - <listitem> - <para>Choose the VM that you want to work with.</para> - </listitem> - <listitem> - <para>(Skip this step if you have enabled dynamic VM scaling; see <xref - linkend="change-cpu-ram-for-vm"/>.)</para> - <para>Click the Stop button to stop the VM. <inlinemediaobject> - <imageobject> - <imagedata fileref="./images/stop-instance-icon.png"/> - </imageobject> - <textobject> - <phrase>StopButton.png: button to stop a VM</phrase> - </textobject> - </inlinemediaobject> - </para> - </listitem> - <listitem> - <para>Click the Change Service button.<inlinemediaobject> - <imageobject> - <imagedata fileref="./images/change-service-icon.png"/> - </imageobject> - <textobject> - <phrase>ChangeServiceButton.png: button to change the service of a VM</phrase> - </textobject> - </inlinemediaobject></para> - <para>The Change service dialog box is displayed.</para> - </listitem> - <listitem> - <para>Select the offering you want to apply to the selected VM.</para> - </listitem> - <listitem> - <para>Click OK.</para> - </listitem> - </orderedlist> - <section id="change-cpu-ram-for-vm"> - <!-- CS-17394 --> - <title>CPU and Memory Scaling for Running VMs</title> - <para>(Supported on VMware and XenServer)</para> - <para>It is not always possible to accurately predict the CPU and RAM requirements when you - first deploy a VM. You might need to increase these resources at any time during the life of a - VM. You can dynamically modify CPU and RAM levels to scale up these resources for a running VM - without incurring any downtime.</para> - <para>Dynamic CPU and RAM scaling can be used in the following cases:</para> - <itemizedlist> - <listitem> - <para>User VMs on hosts running VMware and XenServer.</para> - </listitem> - <listitem> - <para>System VMs on VMware.</para> - </listitem> - <listitem> - <para>VMware Tools or XenServer Tools must be installed on the virtual machine.</para> - </listitem> - <listitem> - <para>The new requested CPU and RAM values must be within the constraints allowed by the - hypervisor and the VM operating system.</para> - </listitem> - <listitem> - <para>New VMs that are created after the installation of &PRODUCT; 4.2 can use the dynamic - scaling feature. If you are upgrading from a previous version of &PRODUCT;, your existing - VMs created with previous versions will not have the dynamic scaling capability unless you - update them using the following procedure.</para> - </listitem> - </itemizedlist> - </section> - <section id="update-vms"> - <title>Updating Existing VMs</title> - <para>If you are upgrading from a previous version of &PRODUCT;, and you want your existing VMs - created with previous versions to have the dynamic scaling capability, update the VMs using - the following steps:</para> - <orderedlist> - <listitem> - <para>Make sure the zone-level setting enable.dynamic.scale.vm is set to true. In the left - navigation bar of the &PRODUCT; UI, click Infrastructure, then click Zones, click the zone - you want, and click the Settings tab.</para> - </listitem> - <listitem> - <para>Install Xen tools (for XenServer hosts) or VMware Tools (for VMware hosts) on each VM - if they are not already installed.</para> - </listitem> - <listitem> - <para>Stop the VM.</para> - </listitem> - <listitem> - <para>Click the Edit button.</para> - </listitem> - <listitem> - <para>Click the Dynamically Scalable checkbox.</para> - </listitem> - <listitem> - <para>Click Apply.</para> - </listitem> - <listitem> - <para>Restart the VM.</para> - </listitem> - </orderedlist> - </section> - <section id="configure-dynamic-scaling"> - <title>Configuring Dynamic CPU and RAM Scaling</title> - <para>To configure this feature, use the following new global configuration variables:</para> - <itemizedlist> - <listitem> - <para>enable.dynamic.scale.vm: Set to True to enable the feature. By default, the feature is - turned off.</para> - </listitem> - <listitem> - <para>scale.retry: How many times to attempt the scaling operation. Default = 2.</para> - </listitem> - </itemizedlist> - </section> - <section id="dynamic-scaling-howto"> - <title>How to Dynamically Scale CPU and RAM</title> - <para>To modify the CPU and/or RAM capacity of a virtual machine, you need to change the compute - offering of the VM to a new compute offering that has the desired CPU and RAM values. You can - use the same steps described above in <xref linkend="changing-service-offering-for-vm"/>, but - skip the step where you stop the virtual machine. Of course, you might have to create a new - compute offering first.</para> - <para>When you submit a dynamic scaling request, the resources will be scaled up on the current - host if possible. If the host does not have enough resources, the VM will be live migrated to - another host in the same cluster. If there is no host in the cluster that can fulfill the - requested level of CPU and RAM, the scaling operation will fail. The VM will continue to run - as it was before.</para> - </section> - <section id="dynamic-scaling-limitations"> - <title>Limitations</title> - <itemizedlist> - <listitem> - <para>You can not do dynamic scaling for system VMs on XenServer.</para> - </listitem> - <listitem> - <para>&PRODUCT; will not check to be sure that the new CPU and RAM levels are compatible - with the OS running on the VM.</para> - </listitem> - <listitem> - <para>When scaling memory or CPU for a Linux VM on VMware, you might need to run scripts in - addition to the other steps mentioned above. For more information, see <ulink - url="http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1012764"; - >Hot adding memory in Linux (1012764)</ulink> in the VMware Knowledge Base.</para> - </listitem> - <listitem> - <para>(VMware) If resources are not available on the current host, scaling up will fail on - VMware because of a known issue where &PRODUCT; and vCenter calculate the available - capacity differently. For more information, see <ulink - url="https://issues.apache.org/jira/browse/CLOUDSTACK-1809"; - >https://issues.apache.org/jira/browse/CLOUDSTACK-1809</ulink>.</para> - </listitem> - <listitem> - <para>On VMs running Linux 64-bit and Windows 7 32-bit operating systems, if the VM is - initially assigned a RAM of less than 3 GB, it can be dynamically scaled up to 3 GB, but - not more. This is due to a known issue with these operating systems, which will freeze if - an attempt is made to dynamically scale from less than 3 GB to more than 3 GB. </para> - </listitem> - </itemizedlist> - </section> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/changing-vm-name-os-group.xml ---------------------------------------------------------------------- diff --git a/en-US/changing-vm-name-os-group.xml b/en-US/changing-vm-name-os-group.xml deleted file mode 100644 index daf78bc..0000000 --- a/en-US/changing-vm-name-os-group.xml +++ /dev/null @@ -1,59 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- 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 - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<section id="changing-vm-name-os-group"> - <title>Changing the VM Name, OS, or Group</title> - <para>After a VM is created, you can modify the display name, operating system, and the group it belongs to.</para> - <para>To access a VM through the &PRODUCT; UI:</para> - <orderedlist> - <listitem><para>Log in to the &PRODUCT; UI as a user or admin.</para></listitem> - <listitem><para>In the left navigation, click Instances.</para></listitem> - <listitem><para>Select the VM that you want to modify.</para></listitem> - <listitem><para>Click the Stop button to stop the VM. <inlinemediaobject> - <imageobject> - <imagedata fileref="./images/stop-instance-icon.png"/> - </imageobject> - <textobject> - <phrase>StopButton.png: button to stop a VM</phrase> - </textobject> - </inlinemediaobject> - </para></listitem> - <listitem><para>Click Edit. <inlinemediaobject> - <imageobject> - <imagedata fileref="./images/edit-icon.png"/> - </imageobject> - <textobject> - <phrase>EditButton.png: button to edit the properties of a VM</phrase> - </textobject> - </inlinemediaobject></para></listitem> - <listitem><para>Make the desired changes to the following:</para></listitem> - - <listitem><para><emphasis role="bold">Display name</emphasis>: Enter a new display name if you want to change - the name of the VM.</para></listitem> - <listitem><para><emphasis role="bold">OS Type</emphasis>: Select the desired operating system.</para></listitem> - <listitem><para><emphasis role="bold">Group</emphasis>: Enter the group name for the VM.</para></listitem> - - <listitem><para>Click Apply.</para></listitem> - </orderedlist> - </section> - http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/choosing-a-deployment-architecture.xml ---------------------------------------------------------------------- diff --git a/en-US/choosing-a-deployment-architecture.xml b/en-US/choosing-a-deployment-architecture.xml deleted file mode 100644 index 0503d8c..0000000 --- a/en-US/choosing-a-deployment-architecture.xml +++ /dev/null @@ -1,29 +0,0 @@ -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> -<!-- 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 - http://www.apache.org/licenses/LICENSE-2.0. - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<chapter id="choosing-a-deployment_architecture"> - <title>Choosing a Deployment Architecture</title> - <para>The architecture used in a deployment will vary depending on the size and purpose of the deployment. This section contains examples of deployment architecture, including a small-scale deployment useful for test and trial deployments and a fully-redundant large-scale setup for production deployments.</para> - <xi:include href="small_scale_deployment.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> - <xi:include href="large_scale_redundant_setup.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> - <xi:include href="separate_storage_network.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> - <xi:include href="multi_node_management_server.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> - <xi:include href="multi_site_deployment.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> -</chapter> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/choosing-a-hypervisor.xml ---------------------------------------------------------------------- diff --git a/en-US/choosing-a-hypervisor.xml b/en-US/choosing-a-hypervisor.xml deleted file mode 100644 index bf83fe3..0000000 --- a/en-US/choosing-a-hypervisor.xml +++ /dev/null @@ -1,136 +0,0 @@ -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> -<!-- 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 - http://www.apache.org/licenses/LICENSE-2.0. - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<chapter id="choosing-a-hypervisor"> - <title>Choosing a Hypervisor: Supported Features</title> - <para>&PRODUCT; supports many popular hypervisors. Your cloud can consist entirely of hosts running a single hypervisor, or you can use multiple hypervisors. Each cluster of hosts must run the same hypervisor.</para> - <para>You might already have an installed base of nodes running a particular hypervisor, in which case, your choice of hypervisor has already been made. If you are starting from scratch, you need to decide what hypervisor software best suits your needs. A discussion of the relative advantages of each hypervisor is outside the scope of our documentation. However, it will help you to know which features of each hypervisor are supported by &PRODUCT;. The following table provides this information.</para> - <informaltable frame="all"> - <!-- <title>Hypervisor supported features</title> --> - <tgroup cols="6" align="left" colsep="1" rowsep="1"> - <colspec colnum="1" colname="c1" colwidth="2*"/> - <colspec colnum="2" colname="c2" colwidth="1*"/> - <colspec colnum="3" colname="c3" colwidth="1*"/> - <colspec colnum="4" colname="c4" colwidth="1*"/> - <colspec colnum="5" colname="c5" colwidth="1*"/> - <colspec colnum="6" colname="c6" colwidth="1*"/> - <thead> - <row> - <entry><para>Feature</para></entry> - <entry><para>XenServer 6.0.2</para></entry> - <entry><para>vSphere 4.1/5.0</para></entry> - <entry><para>KVM - RHEL 6.2</para></entry> - <entry><para>OVM 2.3</para></entry> - <entry><para>Bare Metal</para></entry> - </row> - </thead> - <tbody> - <row> - <entry><para>Network Throttling</para></entry> - <entry><para>Yes</para></entry> - <entry><para>Yes</para></entry> - <entry><para>No</para></entry> - <entry><para>No</para></entry> - <entry><para>N/A</para></entry> - </row> - <row> - <entry><para>Security groups in zones that use basic networking</para></entry> - <entry><para>Yes</para></entry> - <entry><para>No</para></entry> - <entry><para>Yes</para></entry> - <entry><para>No</para></entry> - <entry><para>No</para></entry> - </row> - <row> - <entry><para>iSCSI</para></entry> - <entry><para>Yes</para></entry> - <entry><para>Yes</para></entry> - <entry><para>Yes</para></entry> - <entry><para>Yes</para></entry> - <entry><para>N/A</para></entry> - </row> - <row> - <entry><para>FibreChannel</para></entry> - <entry><para>Yes</para></entry> - <entry><para>Yes</para></entry> - <entry><para>Yes</para></entry> - <entry><para>No</para></entry> - <entry><para>N/A</para></entry> - </row> - <row> - <entry><para>Local Disk</para></entry> - <entry><para>Yes</para></entry> - <entry><para>Yes</para></entry> - <entry><para>Yes</para></entry> - <entry><para>No</para></entry> - <entry><para>Yes</para></entry> - </row> - <row> - <entry><para>HA</para></entry> - <entry><para>Yes</para></entry> - <entry><para>Yes (Native)</para></entry> - <entry><para>Yes</para></entry> - <entry><para>Yes</para></entry> - <entry><para>N/A</para></entry> - </row> - <row> - <entry><para>Snapshots of local disk</para></entry> - <entry><para>Yes</para></entry> - <entry><para>Yes</para></entry> - <entry><para>Yes</para></entry> - <entry><para>No</para></entry> - <entry><para>N/A</para></entry> - </row> - <row> - <entry><para>Local disk as data disk</para></entry> - <entry><para>No</para></entry> - <entry><para>No</para></entry> - <entry><para>No</para></entry> - <entry><para>No</para></entry> - <entry><para>N/A</para></entry> - </row> - <row> - <entry><para>Work load balancing</para></entry> - <entry><para>No</para></entry> - <entry><para>DRS</para></entry> - <entry><para>No</para></entry> - <entry><para>No</para></entry> - <entry><para>N/A</para></entry> - </row> - <row> - <entry><para>Manual live migration of VMs from host to host</para></entry> - <entry><para>Yes</para></entry> - <entry><para>Yes</para></entry> - <entry><para>Yes</para></entry> - <entry><para>Yes</para></entry> - <entry><para>N/A</para></entry> - </row> - <row> - <entry><para>Conserve management traffic IP address by using link local network to communicate with virtual router</para></entry> - <entry><para>Yes</para></entry> - <entry><para>No</para></entry> - <entry><para>Yes</para></entry> - <entry><para>Yes</para></entry> - <entry><para>N/A</para></entry> - </row> - </tbody> - </tgroup> - </informaltable> -</chapter> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/cisco3750-hardware.xml ---------------------------------------------------------------------- diff --git a/en-US/cisco3750-hardware.xml b/en-US/cisco3750-hardware.xml deleted file mode 100644 index b526610..0000000 --- a/en-US/cisco3750-hardware.xml +++ /dev/null @@ -1,52 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> -<!-- 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 - http://www.apache.org/licenses/LICENSE-2.0 - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<section id="cisco3750-hardware"> - <title>Cisco 3750</title> - <para>The following steps show how a Cisco 3750 is configured for zone-level layer-3 switching. - These steps assume VLAN 201 is used to route untagged private IPs for pod 1, and pod 1âs layer-2 - switch is connected to GigabitEthernet1/0/1.</para> - <orderedlist> - <listitem> - <para>Setting VTP mode to transparent allows us to utilize VLAN IDs above 1000. Since we only - use VLANs up to 999, vtp transparent mode is not strictly required.</para> - <programlisting>vtp mode transparent -vlan 200-999 -exit</programlisting> - </listitem> - <listitem> - <para>Configure GigabitEthernet1/0/1.</para> - <programlisting>interface GigabitEthernet1/0/1 -switchport trunk encapsulation dot1q -switchport mode trunk -switchport trunk native vlan 201 -exit</programlisting> - </listitem> - </orderedlist> - <para>The statements configure GigabitEthernet1/0/1 as follows:</para> - <itemizedlist> - <listitem> - <para>VLAN 201 is the native untagged VLAN for port GigabitEthernet1/0/1.</para> - </listitem> - <listitem> - <para>Cisco passes all VLANs by default. As a result, all VLANs (300-999) are passed to all the pod-level layer-2 switches.</para> - </listitem> - </itemizedlist> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/cisco3750-layer2.xml ---------------------------------------------------------------------- diff --git a/en-US/cisco3750-layer2.xml b/en-US/cisco3750-layer2.xml deleted file mode 100644 index e4fe142..0000000 --- a/en-US/cisco3750-layer2.xml +++ /dev/null @@ -1,45 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> -<!-- 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 - http://www.apache.org/licenses/LICENSE-2.0 - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<section id="cisco3750-layer2"> - <title>Cisco 3750</title> - <para>The following steps show how a Cisco 3750 is configured for pod-level layer-2 - switching.</para> - <orderedlist> - <listitem> - <para>Setting VTP mode to transparent allows us to utilize VLAN IDs above 1000. Since we only - use VLANs up to 999, vtp transparent mode is not strictly required.</para> - <programlisting>vtp mode transparent -vlan 300-999 -exit</programlisting> - </listitem> - <listitem> - <para>Configure all ports to dot1q and set 201 as the native VLAN.</para> - <programlisting>interface range GigabitEthernet 1/0/1-24 -switchport trunk encapsulation dot1q -switchport mode trunk -switchport trunk native vlan 201 -exit</programlisting> - </listitem> - </orderedlist> - <para>By default, Cisco passes all VLANs. Cisco switches complain of the native VLAN IDs are - different when 2 ports are connected together. Thatâs why you must specify VLAN 201 as the - native VLAN on the layer-2 switch.</para> -</section>
