source: update systemvmtemplate urls for 4.11
Signed-off-by: Rohit Yadav <rohit@apache.org>
diff --git a/source/conf.py b/source/conf.py
index 60f2557..1065f60 100644
--- a/source/conf.py
+++ b/source/conf.py
@@ -67,16 +67,16 @@
# General information about the project.
project = u'Apache CloudStack Release Notes'
-copyright = u'2016, Apache CloudStack'
+copyright = u'2018, Apache CloudStack'
# The version info for the project you're documenting, acts as replacement for
# |version| and |release|, also used in various other places throughout the
# built documents.
#
# The short X.Y version.
-version = '4.10'
+version = '4.11'
# The full version, including alpha/beta/rc tags.
-release = '4.10.0.0'
+release = '4.11.0.0'
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
diff --git a/source/global.rst b/source/global.rst
index 956c39b..55a36ad 100644
--- a/source/global.rst
+++ b/source/global.rst
@@ -21,11 +21,11 @@
.. _CloudStack Apidocs: http://cloudstack.apache.org/docs/api/
.. Latest version systemvm template URL
-.. |sysvm64-url-xen| replace:: http://packages.shapeblue.com/systemvmtemplate/4.10/systemvm64template-4.10-xen.vhd.bz2
-.. |sysvm64-url-kvm| replace:: http://packages.shapeblue.com/systemvmtemplate/4.10/systemvm64template-4.10-kvm.qcow2.bz2
-.. |sysvm64-url-vmware| replace:: http://packages.shapeblue.com/systemvmtemplate/4.10/systemvm64template-4.10-vmware.ova
-.. |sysvm64-url-hyperv| replace:: http://packages.shapeblue.com/systemvmtemplate/4.10/systemvm64template-4.10-hyperv.vhd.zip
-.. |sysvm64-url-ovm| replace:: http://packages.shapeblue.com/systemvmtemplate/4.10/systemvm64template-4.10-ovm.raw.bz2
+.. |sysvm64-url-xen| replace:: http://download.cloudstack.org/systemvm/4.11/systemvmtemplate-4.11.0-xen.vhd.bz2
+.. |sysvm64-url-kvm| replace:: http://download.cloudstack.org/systemvm/4.11/systemvmtemplate-4.11.0-kvm.qcow2.bz2
+.. |sysvm64-url-vmware| replace:: http://download.cloudstack.org/systemvm/4.11/systemvmtemplate-4.11.0-vmware.ova
+.. |sysvm64-url-hyperv| replace:: http://download.cloudstack.org/systemvm/4.11/systemvmtemplate-4.11.0-hyperv.vhd.zip
+.. |sysvm64-url-ovm| replace:: http://download.cloudstack.org/systemvm/4.11/systemvmtemplate-4.11.0-ovm.raw.bz2
.. Version specific: 4.5 systemvm template URL
.. |acs45-sysvm64-url-xen| replace:: http://cloudstack.apt-get.eu/systemvm/4.5/systemvm64template-4.5-xen.vhd.bz2
diff --git a/source/index.rst b/source/index.rst
index f71956f..ef487a9 100644
--- a/source/index.rst
+++ b/source/index.rst
@@ -67,6 +67,7 @@
.. toctree::
:maxdepth: 1
+ upgrade/upgrade-4.10
upgrade/upgrade-4.9
upgrade/upgrade-4.8
upgrade/upgrade-4.7
diff --git a/source/upgrade/_sysvm_templates.rst b/source/upgrade/_sysvm_templates.rst
index 53a3be5..f279165 100644
--- a/source/upgrade/_sysvm_templates.rst
+++ b/source/upgrade/_sysvm_templates.rst
@@ -37,9 +37,9 @@
+------------+------------------------------------------------------------+
| Hypervisor | Description |
+============+============================================================+
- | XenServer | Name: systemvm-xenserver-4.10 |
+ | XenServer | Name: systemvm-xenserver-4.11 |
| | |
- | | Description: systemvm-xenserver-4.10 |
+ | | Description: systemvm-xenserver-4.11 |
| | |
| | URL: |sysvm64-url-xen| |
| | |
@@ -63,9 +63,9 @@
| | |
| | Routing: no |
+------------+------------------------------------------------------------+
- | KVM | Name: systemvm-kvm-4.10 |
+ | KVM | Name: systemvm-kvm-4.11 |
| | |
- | | Description: systemvm-kvm-4.10 |
+ | | Description: systemvm-kvm-4.11 |
| | |
| | URL: |sysvm64-url-kvm| |
| | |
@@ -89,9 +89,9 @@
| | |
| | Routing: no |
+------------+------------------------------------------------------------+
- | VMware | Name: systemvm-vmware-4.10 |
+ | VMware | Name: systemvm-vmware-4.11 |
| | |
- | | Description: systemvm-vmware-4.10 |
+ | | Description: systemvm-vmware-4.11 |
| | |
| | URL: |sysvm64-url-vmware| |
| | |
@@ -115,9 +115,9 @@
| | |
| | Routing: no |
+------------+------------------------------------------------------------+
- | HyperV | Name: systemvm-hyperv-4.10 |
+ | HyperV | Name: systemvm-hyperv-4.11 |
| | |
- | | Description: systemvm-hyperv-4.10 |
+ | | Description: systemvm-hyperv-4.11 |
| | |
| | URL: |sysvm64-url-hyperv| |
| | |
diff --git a/source/upgrade/upgrade-4.10.rst b/source/upgrade/upgrade-4.10.rst
new file mode 100644
index 0000000..8789cf3
--- /dev/null
+++ b/source/upgrade/upgrade-4.10.rst
@@ -0,0 +1,420 @@
+.. 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.10.x
+
+Upgrade Instruction from |version_to_upgrade|
+=============================================
+
+This section will guide you from CloudStack |version_to_upgrade| to CloudStack
+|version|.
+
+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)
+#. Add package repository for MySQL connector
+#. Upgrade CloudStack management server(s)
+#. Update hypervisors specific dependencies
+
+.. include:: _sysvm_templates.rst
+
+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:`ubuntu48` or :ref:`rhel48` and :ref:`kvm48` hosts upgrade.
+
+Instructions for creating packages from the CloudStack source are in the
+`CloudStack Installation Guide`_.
+
+
+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/"';
+
+
+.. _ubuntu48:
+
+Management Server on Ubuntu
+---------------------------
+
+If you are using Ubuntu, follow this procedure to upgrade your packages. If
+not, skip to step :ref:`rhel48`.
+
+.. 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-repo48:
+
+.. include:: _java_8_ubuntu.rst
+
+CloudStack apt repository
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Start by opening ``/etc/apt/sources.list.d/cloudstack.list`` on
+any systems that have CloudStack packages installed.
+
+This file should have one line, which contains:
+
+.. sourcecode:: bash
+
+ deb http://cloudstack.apt-get.eu/ubuntu precise 4.10
+
+We'll change it to point to the new package repository:
+
+.. sourcecode:: bash
+
+ deb http://cloudstack.apt-get.eu/ubuntu precise 4.11
+
+Setup the public key for the above repository:
+
+.. sourcecode:: bash
+
+ wget -qO - http://cloudstack.apt-get.eu/release.asc | sudo apt-key add -
+
+If you're using your own package repository, change this line to
+read as appropriate for your |version| repository.
+
+#. Now 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
+
+
+.. _rhel48:
+
+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-sysvm48`.
+
+.. 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.
+
+
+.. include:: _mysql_connector.rst
+
+
+.. _rpm-repo410:
+
+CloudStack RPM repository
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The first order of business will be to change the yum repository
+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.)
+
+Start by opening ``/etc/yum.repos.d/cloudstack.repo`` on any
+systems that have CloudStack packages installed.
+
+This file should have content similar to the following:
+
+.. sourcecode:: bash
+
+ [apache-cloudstack]
+ name=Apache CloudStack
+ baseurl=http://cloudstack.apt-get.eu/centos/6/4.10/
+ enabled=1
+ gpgcheck=0
+
+If you are using the community provided package repository, change
+the base url to ``http://cloudstack.apt-get.eu/centos/$releasever/4.11/``.
+
+Setup the GPG public key if you wish to enable ``gpgcheck=1``:
+
+.. sourcecode:: bash
+
+ rpm --import http://cloudstack.apt-get.eu/RPM-GPG-KEY
+
+
+
+If you're using your own package repository, change this line to
+read as appropriate for your |version| 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.2.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;
+
+
+.. _kvm48:
+
+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-repo48` 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-repo410` 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
+
+
+Restart management services
+---------------------------
+
+#. Now it's time to start the management server
+
+ .. sourcecode:: bash
+
+ $ sudo service cloudstack-management start
+
+#. If you use it, start the usage server
+
+ .. sourcecode:: bash
+
+ $ sudo service cloudstack-usage start
+
+
+.. include:: /global.rst
diff --git a/source/upgrade/valid_source.rst b/source/upgrade/valid_source.rst
index 706118a..4f52838 100644
--- a/source/upgrade/valid_source.rst
+++ b/source/upgrade/valid_source.rst
@@ -44,9 +44,9 @@
.. sourcecode:: bash
- $ gpg --verify apache-cloudstack-4.10-src.tar.bz2.asc
- $ gpg --print-md MD5 apache-cloudstack-4.10-src.tar.bz2 | diff - apache-cloudstack-4.10-src.tar.bz2.md5
- $ gpg --print-md SHA512 apache-cloudstack-4.10-src.tar.bz2 | diff - apache-cloudstack-4.10-src.tar.bz2.sha
+ $ gpg --verify apache-cloudstack-4.11-src.tar.bz2.asc
+ $ gpg --print-md MD5 apache-cloudstack-4.11-src.tar.bz2 | diff - apache-cloudstack-4.11-src.tar.bz2.md5
+ $ gpg --print-md SHA512 apache-cloudstack-4.11-src.tar.bz2 | diff - apache-cloudstack-4.11-src.tar.bz2.sha
Each of these commands should return no output. Any output from
them implies that there is a difference between the hash you
@@ -55,7 +55,7 @@
#. Get the commit hash from the VOTE email.
- For example: ``4cd60f3d1683a34.10c3248f48ae064fb573db2a1``. The
+ For example: ``1b8a532ba52127f388847690df70e65c6b46f4d4``. The
value changes between releases.
#. Create two new temporary directories:
@@ -85,7 +85,7 @@
.. sourcecode:: bash
- $ diff -r /tmp/cloudstack/apache-cloudstack-4.10-src /tmp/cloudstack/tree
+ $ diff -r /tmp/cloudstack/apache-cloudstack-4.11-src /tmp/cloudstack/tree
Ensure that content is the same.
@@ -93,7 +93,7 @@
.. sourcecode:: bash
- $ cd /tmp/cloudstack/apache-cloudstack-4.10-src
+ $ cd /tmp/cloudstack/apache-cloudstack-4.11-src
$ mvn --projects='org.apache.cloudstack:cloudstack' org.apache.rat:apache-rat-plugin:0.8:check
The build fails if any non-compliant files are present that are
