cloudstack-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From pdion...@apache.org
Subject [4/8] git commit: 4.4.1: upgrade instruct,api, upgrade from 4.4.0
Date Sun, 21 Sep 2014 14:31:42 GMT
4.4.1: upgrade instruct,api, upgrade from 4.4.0


Project: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/repo
Commit: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/commit/c5ef6bb7
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/tree/c5ef6bb7
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/diff/c5ef6bb7

Branch: refs/heads/master
Commit: c5ef6bb7bf40ba4011c003129de122fcf46169e6
Parents: e2a0a87
Author: Pierre-Luc Dion <pdion891@apache.org>
Authored: Sun Sep 21 09:32:13 2014 -0400
Committer: Pierre-Luc Dion <pdion891@apache.org>
Committed: Sun Sep 21 09:32:13 2014 -0400

----------------------------------------------------------------------
 source/about.rst                          |   2 +-
 source/api-changes.rst                    |  57 +++-
 source/conf.py                            |   2 +-
 source/global.rst                         |  10 +-
 source/index.rst                          |   1 +
 source/upgrade/_sysvm_templates_pre43.rst | 266 +++++++++++++------
 source/upgrade/upgrade-4.4.rst            | 352 +++++++++++++++++++++++++
 7 files changed, 597 insertions(+), 93 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/c5ef6bb7/source/about.rst
----------------------------------------------------------------------
diff --git a/source/about.rst b/source/about.rst
index 3881217..1eb40c1 100644
--- a/source/about.rst
+++ b/source/about.rst
@@ -17,7 +17,7 @@
 What's New in |version|
 =======================
 
-CloudStack |version| includes the following new features and improvements.
+CloudStack |release| is a bugfix release and does not add new features to |version|. Here
is the list of new features and improvements introduce in |version|:
 
 .. contents::
    :local:

http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/c5ef6bb7/source/api-changes.rst
----------------------------------------------------------------------
diff --git a/source/api-changes.rst b/source/api-changes.rst
index 8272287..ad003e5 100644
--- a/source/api-changes.rst
+++ b/source/api-changes.rst
@@ -14,9 +14,64 @@
    under the License.
 
 
-API Changes Introduced in |release|
+API Changes Introduced in |version|
 ===================================
 
+API Changes Introduced in |release|
+-----------------------------------
+updateSnapshotPolicy (Updates the snapshot policy.)
+
++-----------------------------------+-------------------------------------------------------------------------------------------+
+| API                               | Description                                       
                                       |
++===================================+===========================================================================================+
+|  updateSnapshotPolicy             |                                                   
                                       |
+|                                   |                                                   
                                       |
++-----------------------------------+-------------------------------------------------------------------------------------------+
+|  listSnapshotPolicies             | Request:                                          
                                       |
+|                                   |                                                   
                                       |
+|                                   |   New parameters: fordisplay (optional), id (optional)
                                   |
+|                                   |                                                   
                                       |
+|                                   |   Changed parameters: volumeid (old version - required,
new version - optional)           |
+|                                   |                                                   
                                       |
+|                                   | Response:                                         
                                       |
+|                                   |                                                   
                                       |
+|                                   |   New parameters: fordisplay                      
                                       |
+|                                   |                                                   
                                       |
++-----------------------------------+-------------------------------------------------------------------------------------------+
+|  getUser                          | Request:                                          
                                       |
+|                                   |                                                   
                                       |
+|                                   |   New parameters: userapikey (required)           
                                       |
+|                                   |                                                   
                                       |
+|                                   |   Removed parameters: apikey                      
                                       |
+|                                   |                                                   
                                       |
++-----------------------------------+-------------------------------------------------------------------------------------------+
+|  listResourceDetails              | Request:                                          
                                       |
+|                                   |                                                   
                                       |
+|                                   |   New parameters: value (optional)                
                                       |
+|                                   |                                                   
                                       |
++-----------------------------------+-------------------------------------------------------------------------------------------+
+|  createSnapshotPolicy             | Request:                                          
                                       |
+|                                   |                                                   
                                       |
+|                                   |   New parameters: fordisplay (optional)           
                                       |
+|                                   |                                                   
                                       |
+|                                   | Response:                                         
                                       |
+|                                   |                                                   
                                       |
+|                                   |   New parameters: fordisplay                      
                                       |
+|                                   |                                                   
                                       |
++-----------------------------------+-------------------------------------------------------------------------------------------+
+|  uploadVolume                     | Request:                                          
                                       |
+|                                   |                                                   
                                       |
+|                                   |   New parameters: diskofferingid (optional)       
                                       |
+|                                   |                                                   
                                       |
++-----------------------------------+-------------------------------------------------------------------------------------------+
+
+
+
+
+API Changes Introduced in 4.4.0
+-------------------------------
+
+
 +-----------------------------------+-------------------------------------------------------------------------------------------+
 | API                               | Description                                       
                                       |
 +===================================+===========================================================================================+

http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/c5ef6bb7/source/conf.py
----------------------------------------------------------------------
diff --git a/source/conf.py b/source/conf.py
index 8980e5a..b337298 100644
--- a/source/conf.py
+++ b/source/conf.py
@@ -75,7 +75,7 @@ copyright = u'2014, Apache CloudStack'
 # The short X.Y version.
 version = '4.4'
 # The full version, including alpha/beta/rc tags.
-release = '4.4.0'
+release = '4.4.1'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/c5ef6bb7/source/global.rst
----------------------------------------------------------------------
diff --git a/source/global.rst b/source/global.rst
index 2ad70ec..1b40228 100644
--- a/source/global.rst
+++ b/source/global.rst
@@ -19,11 +19,13 @@
 .. _CloudStack Installation Guide: http://docs.cloudstack.apache.org/projects/cloudstack-installation
 .. _CloudStack Administrator's Guide: http://docs.cloudstack.apache.org/projects/cloudstack-administration
 
-
+.. Latest version systemvm template URL
 .. |sysvm64-url-xen|    replace:: http://cloudstack.apt-get.eu/systemvm/4.4/systemvm64template-4.4.0-6-xen.vhd.bz2
 .. |sysvm64-url-kvm|    replace:: http://cloudstack.apt-get.eu/systemvm/4.4/systemvm64template-4.4.0-6-kvm.qcow2.bz2
 .. |sysvm64-url-vmware| replace:: http://cloudstack.apt-get.eu/systemvm/4.4/systemvm64template-4.4.0-6-vmware.ova
 
-.. |acs43-sysvm64-url-xen|    replace:: http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-xen.vhd.bz2
-.. |acs43-sysvm64-url-kvm|    replace:: http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-kvm.qcow2.bz2
-.. |acs43-sysvm64-url-vmware| replace:: http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-vmware.ova
+.. Version specific: 4.3 systemvm template URL
+.. |acs43-sysvm64-url-xen|    replace:: http://download.cloud.com/templates/4.3/systemvm64template-2014-06-23-master-xen.vhd.bz2
+.. |acs43-sysvm64-url-kvm|    replace:: http://download.cloud.com/templates/4.3/systemvm64template-2014-06-23-master-kvm.qcow2.bz2
+.. |acs43-sysvm64-url-vmware| replace:: http://download.cloud.com/templates/4.3/systemvm64template-2014-06-23-master-vmware.ova
+.. |acs43-sysvm64-url-hyperv| replace:: http://download.cloud.com/templates/4.3/systemvm64template-2014-06-23-master-hyperv.vhd.bz2

http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/c5ef6bb7/source/index.rst
----------------------------------------------------------------------
diff --git a/source/index.rst b/source/index.rst
index 0a399bb..c15f32b 100644
--- a/source/index.rst
+++ b/source/index.rst
@@ -72,6 +72,7 @@ Contents:
 .. toctree::
    :maxdepth: 1
 
+   upgrade/upgrade-4.4
    upgrade/upgrade-4.3
    upgrade/upgrade-4.2
    upgrade/upgrade-4.1

http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/c5ef6bb7/source/upgrade/_sysvm_templates_pre43.rst
----------------------------------------------------------------------
diff --git a/source/upgrade/_sysvm_templates_pre43.rst b/source/upgrade/_sysvm_templates_pre43.rst
index c79a799..c00d374 100644
--- a/source/upgrade/_sysvm_templates_pre43.rst
+++ b/source/upgrade/_sysvm_templates_pre43.rst
@@ -18,6 +18,9 @@
 Update System-VM templates
 --------------------------
 
+.. note::
+   Upgrading pre-4.3 to 4.4.1 require 2 systemvm templates downloaded: the 4.3 and 4.4.
+
 #. While running the existing |version_to_upgrade| system, log in to the UI as 
    root administrator.
 
@@ -25,96 +28,187 @@ Update System-VM templates
 
 #. In Select view, click Templates.
 
-#. Click Register template.
+#. Register 4.3 systemvm template:
+   
+   #. Click Register template.
+
+      The Register template dialog box is displayed.
 
-   The Register template dialog box is displayed.
+   #. In the Register template dialog box, specify the following values
+      (do not change these):
+   
+      +-------------------------+------------------------------------------------------------+
+      | Hypervisor              | Description                                           
    |
+      +=========================+============================================================+
+      | XenServer               | Name: systemvm-xenserver-4.3                          
    |
+      |                         |                                                       
    |
+      |                         | Description: systemvm-xenserver-4.3                   
    |
+      |                         |                                                       
    |
+      |                         | URL: |acs43-sysvm64-url-xen|                          
    |
+      |                         |                                                       
    |
+      |                         | Zone: Choose the zone where this hypervisor is used   
    |
+      |                         |                                                       
    |
+      |                         | Hypervisor: XenServer                                 
    |
+      |                         |                                                       
    |
+      |                         | Format: VHD                                           
    |
+      |                         |                                                       
    |
+      |                         | OS Type: Debian GNU/Linux 7.0 (64-bit) (or the        
    |
+      |                         | highest Debian release number available in the        
    |
+      |                         | dropdown)                                             
    |
+      |                         |                                                       
    |
+      |                         | Extractable: no                                       
    |
+      |                         |                                                       
    |
+      |                         | Password Enabled: no                                  
    |
+      |                         |                                                       
    |
+      |                         | Public: no                                            
    |
+      |                         |                                                       
    |
+      |                         | Featured: no                                          
    |
+      |                         |                                                       
    |
+      |                         | Routing: no                                           
    |
+      +-------------------------+------------------------------------------------------------+
+      | KVM                     | Name: systemvm-kvm-4.3                                
    |
+      |                         |                                                       
    |
+      |                         | Description: systemvm-kvm-4.3                         
    |
+      |                         |                                                       
    |
+      |                         | URL: |acs43-sysvm64-url-kvm|                          
    |  
+      |                         |                                                       
    |
+      |                         | Zone: Choose the zone where this hypervisor is used   
    |
+      |                         |                                                       
    |
+      |                         | Hypervisor: KVM                                       
    |
+      |                         |                                                       
    |
+      |                         | Format: QCOW2                                         
    |
+      |                         |                                                       
    |
+      |                         | OS Type: Debian GNU/Linux 7.0 (64-bit) (or the        
    |
+      |                         | highest Debian release number available in the        
    |
+      |                         | dropdown)                                             
    |
+      |                         |                                                       
    |
+      |                         | Extractable: no                                       
    |
+      |                         |                                                       
    |
+      |                         | Password Enabled: no                                  
    |
+      |                         |                                                       
    |
+      |                         | Public: no                                            
    |
+      |                         |                                                       
    |
+      |                         | Featured: no                                          
    |
+      |                         |                                                       
    |
+      |                         | Routing: no                                           
    |
+      +-------------------------+------------------------------------------------------------+
+      | VMware                  | Name: systemvm-vmware-4.3                             
    |
+      |                         |                                                       
    |
+      |                         | Description: systemvm-vmware-4.3                      
    |
+      |                         |                                                       
    |
+      |                         | URL: |acs43-sysvm64-url-vmware|                       
    |
+      |                         |                                                       
    |
+      |                         | Zone: Choose the zone where this hypervisor is used   
    |
+      |                         |                                                       
    |
+      |                         | Hypervisor: VMware                                    
    |
+      |                         |                                                       
    |
+      |                         | Format: OVA                                           
    |
+      |                         |                                                       
    |
+      |                         | OS Type: Debian GNU/Linux 7.0 (64-bit) (or the        
    |
+      |                         | highest Debian release number available in the        
    |
+      |                         | dropdown)                                             
    |
+      |                         |                                                       
    |
+      |                         | Extractable: no                                       
    |
+      |                         |                                                       
    |
+      |                         | Password Enabled: no                                  
    |
+      |                         |                                                       
    |
+      |                         | Public: no                                            
    |
+      |                         |                                                       
    |
+      |                         | Featured: no                                          
    |
+      |                         |                                                       
    |
+      |                         | Routing: no                                           
    |
+      +-------------------------+------------------------------------------------------------+
 
-#. In the Register template dialog box, specify the following values
-   (do not change these):
+#. Register |version| systemvm template:
+   
+   #. Click Register template.
 
-   *The name of the template must end by "-4.3" when you upgrade to CloudStack 4.4.0*
+      The Register template dialog box is displayed.
 
-   +-------------------------+------------------------------------------------------------+
-   | Hypervisor              | Description                                              
 |
-   +=========================+============================================================+
-   | XenServer               | Name: systemvm-xenserver-4.3                             
 |
-   |                         |                                                          
 |
-   |                         | Description: systemvm-xenserver-4.3                      
 |
-   |                         |                                                          
 |
-   |                         | URL: |sysvm64-url-xen|                                   
 |
-   |                         |                                                          
 |
-   |                         | Zone: Choose the zone where this hypervisor is used      
 |
-   |                         |                                                          
 |
-   |                         | Hypervisor: XenServer                                    
 |
-   |                         |                                                          
 |
-   |                         | Format: VHD                                              
 |
-   |                         |                                                          
 |
-   |                         | OS Type: Debian GNU/Linux 7.0 (64-bit) (or the           
 |
-   |                         | highest Debian release number available in the           
 |
-   |                         | dropdown)                                                
 |
-   |                         |                                                          
 |
-   |                         | Extractable: no                                          
 |
-   |                         |                                                          
 |
-   |                         | Password Enabled: no                                     
 |
-   |                         |                                                          
 |
-   |                         | Public: no                                               
 |
-   |                         |                                                          
 |
-   |                         | Featured: no                                             
 |
-   |                         |                                                          
 |
-   |                         | Routing: no                                              
 |
-   +-------------------------+------------------------------------------------------------+
-   | KVM                     | Name: systemvm-kvm-4.3                                   
 |
-   |                         |                                                          
 |
-   |                         | Description: systemvm-kvm-4.3                            
 |
-   |                         |                                                          
 |
-   |                         | URL: |sysvm64-url-kvm|                                   
 |  
-   |                         |                                                          
 |
-   |                         | Zone: Choose the zone where this hypervisor is used      
 |
-   |                         |                                                          
 |
-   |                         | Hypervisor: KVM                                          
 |
-   |                         |                                                          
 |
-   |                         | Format: QCOW2                                            
 |
-   |                         |                                                          
 |
-   |                         | OS Type: Debian GNU/Linux 7.0 (64-bit) (or the           
 |
-   |                         | highest Debian release number available in the           
 |
-   |                         | dropdown)                                                
 |
-   |                         |                                                          
 |
-   |                         | Extractable: no                                          
 |
-   |                         |                                                          
 |
-   |                         | Password Enabled: no                                     
 |
-   |                         |                                                          
 |
-   |                         | Public: no                                               
 |
-   |                         |                                                          
 |
-   |                         | Featured: no                                             
 |
-   |                         |                                                          
 |
-   |                         | Routing: no                                              
 |
-   +-------------------------+------------------------------------------------------------+
-   | VMware                  | Name: systemvm-vmware-4.3                                
 |
-   |                         |                                                          
 |
-   |                         | Description: systemvm-vmware-4.3                         
 |
-   |                         |                                                          
 |
-   |                         | URL: |sysvm64-url-vmware|                                
 |
-   |                         |                                                          
 |
-   |                         | Zone: Choose the zone where this hypervisor is used      
 |
-   |                         |                                                          
 |
-   |                         | Hypervisor: VMware                                       
 |
-   |                         |                                                          
 |
-   |                         | Format: OVA                                              
 |
-   |                         |                                                          
 |
-   |                         | OS Type: Debian GNU/Linux 7.0 (64-bit) (or the           
 |
-   |                         | highest Debian release number available in the           
 |
-   |                         | dropdown)                                                
 |
-   |                         |                                                          
 |
-   |                         | Extractable: no                                          
 |
-   |                         |                                                          
 |
-   |                         | Password Enabled: no                                     
 |
-   |                         |                                                          
 |
-   |                         | Public: no                                               
 |
-   |                         |                                                          
 |
-   |                         | Featured: no                                             
 |
-   |                         |                                                          
 |
-   |                         | Routing: no                                              
 |
-   +-------------------------+------------------------------------------------------------+
+   #. In the Register template dialog box, specify the following values
+      (do not change these):
+      
+      +-------------------------+------------------------------------------------------------+
+      | Hypervisor              | Description                                           
    |
+      +=========================+============================================================+
+      | XenServer               | Name: systemvm-xenserver-|version|                    
    |
+      |                         |                                                       
    |
+      |                         | Description: systemvm-xenserver-|version|             
    |
+      |                         |                                                       
    |
+      |                         | URL: |sysvm64-url-xen|                                
    |
+      |                         |                                                       
    |
+      |                         | Zone: Choose the zone where this hypervisor is used   
    |
+      |                         |                                                       
    |
+      |                         | Hypervisor: XenServer                                 
    |
+      |                         |                                                       
    |
+      |                         | Format: VHD                                           
    |
+      |                         |                                                       
    |
+      |                         | OS Type: Debian GNU/Linux 7.0 (64-bit) (or the        
    |
+      |                         | highest Debian release number available in the        
    |
+      |                         | dropdown)                                             
    |
+      |                         |                                                       
    |
+      |                         | Extractable: no                                       
    |
+      |                         |                                                       
    |
+      |                         | Password Enabled: no                                  
    |
+      |                         |                                                       
    |
+      |                         | Public: no                                            
    |
+      |                         |                                                       
    |
+      |                         | Featured: no                                          
    |
+      |                         |                                                       
    |
+      |                         | Routing: no                                           
    |
+      +-------------------------+------------------------------------------------------------+
+      | KVM                     | Name: systemvm-kvm-|version|                          
    |
+      |                         |                                                       
    |
+      |                         | Description: systemvm-kvm-|version|                   
    |
+      |                         |                                                       
    |
+      |                         | URL: |sysvm64-url-kvm|                                
    |  
+      |                         |                                                       
    |
+      |                         | Zone: Choose the zone where this hypervisor is used   
    |
+      |                         |                                                       
    |
+      |                         | Hypervisor: KVM                                       
    |
+      |                         |                                                       
    |
+      |                         | Format: QCOW2                                         
    |
+      |                         |                                                       
    |
+      |                         | OS Type: Debian GNU/Linux 7.0 (64-bit) (or the        
    |
+      |                         | highest Debian release number available in the        
    |
+      |                         | dropdown)                                             
    |
+      |                         |                                                       
    |
+      |                         | Extractable: no                                       
    |
+      |                         |                                                       
    |
+      |                         | Password Enabled: no                                  
    |
+      |                         |                                                       
    |
+      |                         | Public: no                                            
    |
+      |                         |                                                       
    |
+      |                         | Featured: no                                          
    |
+      |                         |                                                       
    |
+      |                         | Routing: no                                           
    |
+      +-------------------------+------------------------------------------------------------+
+      | VMware                  | Name: systemvm-vmware-|version|                       
    |
+      |                         |                                                       
    |
+      |                         | Description: systemvm-vmware-|version|                
    |
+      |                         |                                                       
    |
+      |                         | URL: |sysvm64-url-vmware|                             
    |
+      |                         |                                                       
    |
+      |                         | Zone: Choose the zone where this hypervisor is used   
    |
+      |                         |                                                       
    |
+      |                         | Hypervisor: VMware                                    
    |
+      |                         |                                                       
    |
+      |                         | Format: OVA                                           
    |
+      |                         |                                                       
    |
+      |                         | OS Type: Debian GNU/Linux 7.0 (64-bit) (or the        
    |
+      |                         | highest Debian release number available in the        
    |
+      |                         | dropdown)                                             
    |
+      |                         |                                                       
    |
+      |                         | Extractable: no                                       
    |
+      |                         |                                                       
    |
+      |                         | Password Enabled: no                                  
    |
+      |                         |                                                       
    |
+      |                         | Public: no                                            
    |
+      |                         |                                                       
    |
+      |                         | Featured: no                                          
    |
+      |                         |                                                       
    |
+      |                         | Routing: no                                           
    |
+      +-------------------------+------------------------------------------------------------+
 
 #. Watch the screen to be sure that the template downloads successfully and 
    enters the **READY** state. Do not proceed until this is successful.

http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/c5ef6bb7/source/upgrade/upgrade-4.4.rst
----------------------------------------------------------------------
diff --git a/source/upgrade/upgrade-4.4.rst b/source/upgrade/upgrade-4.4.rst
new file mode 100644
index 0000000..fe867d9
--- /dev/null
+++ b/source/upgrade/upgrade-4.4.rst
@@ -0,0 +1,352 @@
+.. 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.
+
+
+.. |version_to_upgrade| replace:: 4.4.0
+
+Upgrade Instruction from |version_to_upgrade|
+=============================================
+
+
+Any steps that are hypervisor-specific will be called out with a note.
+
+We recommend reading through this section once or twice before beginning
+your upgrade procedure, and working through it on a test system before
+working on a production system.
+
+.. note:: 
+   The following upgrade instructions should be performed regardless of 
+   hypervisor type.
+
+Upgrade Steps:
+
+#. Backup CloudStack database (MySQL)
+
+#. Upgrade CloudStack management server(s)
+
+#. Update hypervisors specific dependencies
+
+
+Packages repository
+-------------------
+
+
+Most users of CloudStack manage the installation and upgrades of
+CloudStack with one of Linux's predominant package systems, RPM or
+APT. This guide assumes you'll be using RPM and Yum (for Red Hat
+Enterprise Linux or CentOS), or APT and Debian packages (for Ubuntu).
+
+Create RPM or Debian packages (as appropriate) and a repository from
+the |version| source, or check the Apache CloudStack downloads page at
+http://cloudstack.apache.org/downloads.html
+for package repositories supplied by community members. You will need
+them for :ref:`ubuntu43` or :ref:`rhel43` and :ref:`kvm43` hosts upgrade. 
+
+Instructions for creating packages from the CloudStack source are in the 
+`CloudStack Installation Guide`_.
+
+.. include:: _sysvm_templates.rst
+
+
+Database Preparation
+--------------------
+
+
+Backup current database
+
+#. Stop your management server or servers. Run this on all management
+   server hosts:
+
+   .. sourcecode:: bash
+
+      $ sudo service cloudstack-management stop
+
+#. If you are running a usage server or usage servers, stop those as well:
+
+   .. sourcecode:: bash
+
+      $ sudo service cloudstack-usage stop
+
+#. Make a backup of your MySQL database. If you run into any issues or
+   need to roll back the upgrade, this will assist in debugging or
+   restoring your existing environment. You'll be prompted for your
+   password.
+
+   .. sourcecode:: bash
+
+      $ mysqldump -u root -p cloud > cloud-backup_`date '+%Y-%m-%d'`.sql
+      $ mysqldump -u root -p cloud_usage > cloud_usage-backup_`date '+%Y-%m-%d'`.sql
+
+#. **(KVM Only)** If primary storage of type local storage is in use, the
+   path for this storage needs to be verified to ensure it passes new
+   validation. Check local storage by querying the cloud.storage\_pool
+   table:
+
+   .. sourcecode:: bash
+
+      $ mysql -u cloud -p -e "select id,name,path from cloud.storage_pool where pool_type='Filesystem'"
+
+   If local storage paths are found to have a trailing forward slash,
+   remove it:
+
+   .. sourcecode:: bash
+
+      $ mysql -u cloud -p -e 'update cloud.storage_pool set path="/var/lib/libvirt/images"
where path="/var/lib/libvirt/images/"';
+
+
+.. _ubuntu44:
+
+Management Server on Ubuntu
+---------------------------
+
+
+If you are using Ubuntu, follow this procedure to upgrade your packages. If 
+not, skip to step :ref:`rhel44`.
+
+.. note:: 
+   **Community Packages:** This section assumes you're using the community 
+   supplied packages for CloudStack. If you've created your own packages and 
+   APT repository, substitute your own URL for the ones used in these examples.
+
+The first order of business will be to change the sources list for
+each system with CloudStack packages. This means all management
+servers, and any hosts that have the KVM agent. (No changes should
+be necessary for hosts that are running VMware or Xen.)
+
+
+.. _apt-repo44:
+
+CloudStack apt repository
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+
+#. Update your apt package list:
+
+   .. sourcecode:: bash
+
+      $ sudo apt-get update
+
+#. Now that you have the repository configured, it's time to upgrade
+   the ``cloudstack-management`` package. 
+
+   .. sourcecode:: bash
+
+      $ sudo apt-get upgrade cloudstack-management
+
+#. If you use CloudStack usage server
+
+   .. sourcecode:: bash
+
+      $ sudo apt-get upgrade cloudstack-usage
+
+
+.. _rhel44:
+
+Management Server on CentOS/RHEL
+--------------------------------
+
+If you are using CentOS or RHEL, follow this procedure to upgrade your 
+packages. If not, skip to hypervisors section, then :ref:`upg-sysvm44`.
+
+.. note:: 
+   **Community Packages:** This section assumes you're using the community 
+   supplied packages for CloudStack. If you've created your own packages and 
+   yum repository, substitute your own URL for the ones used in these examples.
+
+
+.. _rpm-repo44:
+
+CloustStack RPM repository
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+
+#. Now that you have the repository configured, it's time to upgrade the 
+   ``cloudstack-management``.
+
+   .. sourcecode:: bash
+
+      $ sudo yum upgrade cloudstack-management
+
+#. If you use CloudStack usage server
+
+   .. sourcecode:: bash
+
+      $ sudo yum upgrade cloudstack-usage
+
+
+hypervisor: XenServer
+---------------------
+
+   **(XenServer only)** Copy vhd-utils file on CloudStack management servers.
+   Copy the file `vhd-utils <http://download.cloud.com.s3.amazonaws.com/tools/vhd-util>`_

+   to ``/usr/share/cloudstack-common/scripts/vm/hypervisor/xenserver``.
+
+   .. sourcecode:: bash
+
+      wget -P /usr/share/cloudstack-common/scripts/vm/hypervisor/xenserver \
+      http://download.cloud.com.s3.amazonaws.com/tools/vhd-util
+
+
+hypervisor: VMware
+------------------
+
+   .. warning::
+      For VMware hypervisor CloudStack management server packages must be 
+      build using "noredist". Refer to `Building from Source 
+      <http://docs.cloudstack.apache.org/projects/cloudstack-installation/en/latest/building_from_source.html>`_.
+
+   **(VMware only)** Additional steps are required for each VMware cluster.
+   These steps will not affect running guests in the cloud. These steps
+   are required only for clouds using VMware clusters:
+
+#. Stop the Management Server:
+
+   .. sourcecode:: bash
+
+      $ sudo service cloudstack-management stop
+
+#. Generate the encrypted equivalent of your vCenter password:
+
+   .. sourcecode:: bash
+
+      $ java -classpath /usr/share/cloudstack-common/lib/jasypt-1.9.0.jar org.jasypt.intf.cli.JasyptPBEStringEncryptionCLI
encrypt.sh input="_your_vCenter_password_" password="`cat /etc/cloudstack/management/key`"
verbose=false
+
+   Store the output from this step, we need to add this in
+   cluster\_details table and vmware\_data\_center tables in place of
+   the plain text password
+
+#. Find the ID of the row of cluster\_details table that you have to
+   update:
+
+   .. sourcecode:: bash
+
+      $ mysql -u <username> -p<password>
+
+   .. sourcecode:: bash
+
+      select * from cloud.cluster_details;
+
+#. Update the plain text password with the encrypted one
+
+   .. sourcecode:: bash
+
+      update cloud.cluster_details set value = '_ciphertext_from_step_1_' where id = _id_from_step_2_;
+
+#. Confirm that the table is updated:
+
+   .. sourcecode:: bash
+
+      select * from cloud.cluster_details;
+
+#. Find the ID of the correct row of vmware\_data\_center that you
+   want to update
+
+   .. sourcecode:: bash
+
+      select * from cloud.vmware_data_center;
+
+#. update the plain text password with the encrypted one:
+
+   .. sourcecode:: bash
+
+      update cloud.vmware_data_center set password = '_ciphertext_from_step_1_' where id
= _id_from_step_5_;
+
+#. Confirm that the table is updated:
+
+   .. sourcecode:: bash
+
+      select * from cloud.vmware_data_center;
+
+
+.. _kvm44:
+
+hypervisor: KVM
+---------------
+
+KVM on Ubuntu
+^^^^^^^^^^^^^
+
+(KVM only) Additional steps are required for each KVM host. These
+steps will not affect running guests in the cloud. These steps are
+required only for clouds using KVM as hosts and only on the KVM
+hosts.
+
+#. Configure the :ref:`apt-repo44` as detailed above.
+
+#. Stop the running agent.
+
+   .. sourcecode:: bash
+
+      $ sudo service cloudstack-agent stop
+
+#. Update the agent software.
+
+   .. sourcecode:: bash
+
+      $ sudo apt-get upgrade cloudstack-agent
+
+#. Verify that the file ``/etc/cloudstack/agent/environment.properties`` has a 
+   line that reads:
+
+   .. sourcecode:: bash
+
+      paths.script=/usr/share/cloudstack-common
+
+   If not, add the line.
+
+#. Start the agent.
+
+   .. sourcecode:: bash
+
+      $ sudo service cloudstack-agent start
+
+
+KVM on CentOS/RHEL
+^^^^^^^^^^^^^^^^^^
+For KVM hosts, upgrade the ``cloudstack-agent`` package
+
+#. Configure the :ref:`rpm-repo44` as detailed above.
+
+   .. sourcecode:: bash
+
+      $ sudo yum upgrade cloudstack-agent
+
+#. Verify that the file ``/etc/cloudstack/agent/environment.properties`` has a 
+   line that reads:
+
+   .. sourcecode:: bash
+
+      paths.script=/usr/share/cloudstack-common
+
+   If not, add the line.
+
+#. Restart the agent:
+
+   .. sourcecode:: bash
+
+      $ sudo service cloudstack-agent stop
+      $ sudo killall jsvc
+      $ sudo service cloudstack-agent start
+
+
+.. _upg-sysvm44:
+
+System-VMs and Virtual-Routers
+------------------------------
+
+.. include:: _sysvm_restart.rst
+
+
+.. include:: /global.rst


Mime
View raw message