Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id 0AB31200B5C for ; Thu, 11 Aug 2016 23:46:33 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id 0948B160A93; Thu, 11 Aug 2016 21:46:33 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id D9C2F160AB8 for ; Thu, 11 Aug 2016 23:46:31 +0200 (CEST) Received: (qmail 85196 invoked by uid 500); 11 Aug 2016 21:46:30 -0000 Mailing-List: contact commits-help@cloudstack.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@cloudstack.apache.org Delivered-To: mailing list commits@cloudstack.apache.org Received: (qmail 84900 invoked by uid 99); 11 Aug 2016 21:46:30 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 11 Aug 2016 21:46:30 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id B9E5FE3A9C; Thu, 11 Aug 2016 21:46:30 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: pdion891@apache.org To: commits@cloudstack.apache.org Date: Thu, 11 Aug 2016 21:46:36 -0000 Message-Id: <3d7bb43901a04865ab25119259c0bd90@git.apache.org> In-Reply-To: <7397966e555040fa8b2ad4049e4380e6@git.apache.org> References: <7397966e555040fa8b2ad4049e4380e6@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [7/7] cloudstack-docs-rn git commit: complete upgrade paths to 4.9 archived-at: Thu, 11 Aug 2016 21:46:33 -0000 complete upgrade paths to 4.9 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/a1341471 Tree: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/tree/a1341471 Diff: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/diff/a1341471 Branch: refs/heads/master Commit: a13414718c182f5a935b99d8f95e5c89ec9bdca6 Parents: 166cdbf Author: Pierre-Luc Dion Authored: Sat Aug 6 14:09:20 2016 -0400 Committer: Pierre-Luc Dion Committed: Sat Aug 6 14:09:20 2016 -0400 ---------------------------------------------------------------------- source/index.rst | 3 +- source/upgrade/_mysql_connector.rst | 50 ++++ source/upgrade/upgrade-4.3.rst | 10 +- source/upgrade/upgrade-4.4.rst | 9 +- source/upgrade/upgrade-4.5.rst | 10 +- source/upgrade/upgrade-4.6.rst | 10 +- source/upgrade/upgrade-4.7.rst | 12 +- source/upgrade/upgrade-4.8.rst | 416 +++++++++++++++++++++++++++++++ 8 files changed, 495 insertions(+), 25 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/a1341471/source/index.rst ---------------------------------------------------------------------- diff --git a/source/index.rst b/source/index.rst index 81b77be..84df013 100644 --- a/source/index.rst +++ b/source/index.rst @@ -67,12 +67,13 @@ Contents: .. toctree:: :maxdepth: 1 + upgrade/upgrade-4.8 upgrade/upgrade-4.7 upgrade/upgrade-4.6 upgrade/upgrade-4.5 upgrade/upgrade-4.4 upgrade/upgrade-4.3 - upgrade/upgrade-4.2 +.. upgrade/upgrade-4.2 .. upgrade/upgrade-4.1 .. upgrade/upgrade-4.0 .. upgrade/upgrade-3.0.x http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/a1341471/source/upgrade/_mysql_connector.rst ---------------------------------------------------------------------- diff --git a/source/upgrade/_mysql_connector.rst b/source/upgrade/_mysql_connector.rst new file mode 100644 index 0000000..f132afa --- /dev/null +++ b/source/upgrade/_mysql_connector.rst @@ -0,0 +1,50 @@ +Install new MySQL connector +--------------------------- + +Apache CloudStack |version| require an upgrade of the MySQL connector. To install +the connector via 'apt-get' following steps must be taken: + + +MySQL connector APT repository +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Install the following package provided by MySQL to enable official repositories: + +.. sourcecode:: bash + + wget http://dev.mysql.com/get/mysql-apt-config_0.7.3-1_all.deb + sudo dpkg -i mysql-apt-config_0.7.3-1_all.deb + +Make sure to activate the repository for MySQL connectors. + +.. sourcecode:: bash + + sudo apt-get update + sudo apt-get install mysql-connector-python + + +MySQL connector RPM repository +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Add a new yum repo ``/etc/yum.repos.d/mysql.repo``: + +.. sourcecode:: bash + + [mysql-community] + name=MySQL Community connectors + baseurl=http://repo.mysql.com/yum/mysql-connectors-community/el/$releasever/$basearch/ + enabled=1 + gpgcheck=1 + +Import GPG public key from MySQL: + +.. sourcecode:: bash + + rpm --import http://repo.mysql.com/RPM-GPG-KEY-mysql + +Install mysql-connector + +.. sourcecode:: bash + + yum install mysql-connector-python + http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/a1341471/source/upgrade/upgrade-4.3.rst ---------------------------------------------------------------------- diff --git a/source/upgrade/upgrade-4.3.rst b/source/upgrade/upgrade-4.3.rst index cd6cccb..3d73453 100644 --- a/source/upgrade/upgrade-4.3.rst +++ b/source/upgrade/upgrade-4.3.rst @@ -35,9 +35,9 @@ working on a production system. Upgrade Steps: #. Backup CloudStack database (MySQL) - +#. Install new systemvm template +#. Add package repository for MySQL connector #. Upgrade CloudStack management server(s) - #. Update hypervisors specific dependencies @@ -59,6 +59,8 @@ Instructions for creating packages from the CloudStack source are in the `CloudStack Installation Guide`_. .. include:: _sysvm_templates.rst +.. include:: _mysql_connector.rst + Database Preparation @@ -143,7 +145,7 @@ We'll change it to point to the new package repository: .. sourcecode:: bash - deb http://cloudstack.apt-get.eu/ubuntu precise 4.8 + deb http://cloudstack.apt-get.eu/ubuntu precise 4.9 Setup the public key for the above repository: @@ -213,7 +215,7 @@ This file should have content similar to the following: gpgcheck=0 If you are using the community provided package repository, change -the base url to ``http://cloudstack.apt-get.eu/centos/6/4.8/``. +the base url to ``http://cloudstack.apt-get.eu/centos/$releasever/4.9/``. Setup the GPG public key if you wish to enable ``gpgcheck=1``: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/a1341471/source/upgrade/upgrade-4.4.rst ---------------------------------------------------------------------- diff --git a/source/upgrade/upgrade-4.4.rst b/source/upgrade/upgrade-4.4.rst index e2dd53f..f348ce0 100644 --- a/source/upgrade/upgrade-4.4.rst +++ b/source/upgrade/upgrade-4.4.rst @@ -35,9 +35,9 @@ working on a production system. Upgrade Steps: #. Backup CloudStack database (MySQL) - +#. Install new systemvm template +#. Add package repository for MySQL connector #. Upgrade CloudStack management server(s) - #. Update hypervisors specific dependencies @@ -59,6 +59,7 @@ Instructions for creating packages from the CloudStack source are in the `CloudStack Installation Guide`_. .. include:: _sysvm_templates.rst +.. include:: _mysql_connector.rst Database Preparation @@ -143,7 +144,7 @@ CloudStack apt repository .. sourcecode:: bash - deb http://cloudstack.apt-get.eu/ubuntu precise 4.8 + deb http://cloudstack.apt-get.eu/ubuntu precise 4.9 Setup the public key for the above repository: @@ -214,7 +215,7 @@ This file should have content similar to the following: gpgcheck=0 If you are using the community provided package repository, change -the base url to ``http://cloudstack.apt-get.eu/centos/6/4.8/``. +the base url to ``http://cloudstack.apt-get.eu/centos/$releasever/4.9/``. Setup the GPG public key if you wish to enable ``gpgcheck=1``: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/a1341471/source/upgrade/upgrade-4.5.rst ---------------------------------------------------------------------- diff --git a/source/upgrade/upgrade-4.5.rst b/source/upgrade/upgrade-4.5.rst index 5f5d124..3ed06d1 100644 --- a/source/upgrade/upgrade-4.5.rst +++ b/source/upgrade/upgrade-4.5.rst @@ -35,9 +35,9 @@ working on a production system. Upgrade Steps: #. Backup CloudStack database (MySQL) - +#. Install new systemvm template +#. Add package repository for MySQL connector #. Upgrade CloudStack management server(s) - #. Update hypervisors specific dependencies @@ -59,6 +59,7 @@ Instructions for creating packages from the CloudStack source are in the `CloudStack Installation Guide`_. .. include:: _sysvm_templates.rst +.. include:: _mysql_connector.rst Database Preparation @@ -143,7 +144,7 @@ We'll change it to point to the new package repository: .. sourcecode:: bash - deb http://cloudstack.apt-get.eu/ubuntu precise 4.8 + deb http://cloudstack.apt-get.eu/ubuntu precise 4.9 Setup the public key for the above repository: @@ -214,8 +215,7 @@ This file should have content similar to the following: gpgcheck=0 If you are using the community provided package repository, change -the base url to ``http://cloudstack.apt-get.eu/centos/6/4.8/``. If you want to use -the CentOS7 repository use the url ``http://cloudstack.apt-get.eu/centos/7/4.8/`` +the base url to ``http://cloudstack.apt-get.eu/centos/$releasever/4.9/``. Setup the GPG public key if you wish to enable ``gpgcheck=1``: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/a1341471/source/upgrade/upgrade-4.6.rst ---------------------------------------------------------------------- diff --git a/source/upgrade/upgrade-4.6.rst b/source/upgrade/upgrade-4.6.rst index 282d9da..8d0f582 100644 --- a/source/upgrade/upgrade-4.6.rst +++ b/source/upgrade/upgrade-4.6.rst @@ -35,9 +35,8 @@ working on a production system. Upgrade Steps: #. Backup CloudStack database (MySQL) - +#. Add package repository for MySQL connector #. Upgrade CloudStack management server(s) - #. Update hypervisors specific dependencies @@ -58,6 +57,8 @@ them for :ref:`ubuntu46` or :ref:`rhel46` and :ref:`kvm46` hosts upgrade. Instructions for creating packages from the CloudStack source are in the `CloudStack Installation Guide`_. +.. include:: _mysql_connector.rst + Database Preparation -------------------- @@ -141,7 +142,7 @@ We'll change it to point to the new package repository: .. sourcecode:: bash - deb http://cloudstack.apt-get.eu/ubuntu precise 4.8 + deb http://cloudstack.apt-get.eu/ubuntu precise 4.9 Setup the public key for the above repository: @@ -212,8 +213,7 @@ This file should have content similar to the following: gpgcheck=0 If you are using the community provided package repository, change -the base url to ``http://cloudstack.apt-get.eu/centos/6/4.8/``. If you want to use -the CentOS7 repository use the url ``http://cloudstack.apt-get.eu/centos/7/4.8/`` +the base url to ``http://cloudstack.apt-get.eu/centos/$releasever/4.9/``. Setup the GPG public key if you wish to enable ``gpgcheck=1``: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/a1341471/source/upgrade/upgrade-4.7.rst ---------------------------------------------------------------------- diff --git a/source/upgrade/upgrade-4.7.rst b/source/upgrade/upgrade-4.7.rst index d34009a..6459532 100644 --- a/source/upgrade/upgrade-4.7.rst +++ b/source/upgrade/upgrade-4.7.rst @@ -35,9 +35,8 @@ working on a production system. Upgrade Steps: #. Backup CloudStack database (MySQL) - +#. Add package repository for MySQL connector #. Upgrade CloudStack management server(s) - #. Update hypervisors specific dependencies @@ -58,6 +57,8 @@ them for :ref:`ubuntu47` or :ref:`rhel47` and :ref:`kvm47` hosts upgrade. Instructions for creating packages from the CloudStack source are in the `CloudStack Installation Guide`_. +.. include:: _mysql_connector.rst + Database Preparation -------------------- @@ -141,7 +142,7 @@ We'll change it to point to the new package repository: .. sourcecode:: bash - deb http://cloudstack.apt-get.eu/ubuntu precise 4.8 + deb http://cloudstack.apt-get.eu/ubuntu precise 4.9 Setup the public key for the above repository: @@ -189,7 +190,7 @@ packages. If not, skip to hypervisors section, then :ref:`upg-sysvm47`. .. _rpm-repo47: CloudStack RPM repository -^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^^^^^^ The first order of business will be to change the yum repository for each system with CloudStack packages. This means all @@ -212,8 +213,7 @@ This file should have content similar to the following: gpgcheck=0 If you are using the community provided package repository, change -the base url to ``http://cloudstack.apt-get.eu/centos/6/4.8/``. If you want to use -the CentOS7 repository use the url ``http://cloudstack.apt-get.eu/centos/7/4.8/`` +the base url to ``http://cloudstack.apt-get.eu/centos/$releasever/4.9/``. Setup the GPG public key if you wish to enable ``gpgcheck=1``: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/a1341471/source/upgrade/upgrade-4.8.rst ---------------------------------------------------------------------- diff --git a/source/upgrade/upgrade-4.8.rst b/source/upgrade/upgrade-4.8.rst new file mode 100644 index 0000000..a51a2ee --- /dev/null +++ b/source/upgrade/upgrade-4.8.rst @@ -0,0 +1,416 @@ +.. 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.8.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 + + +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`_. + +.. include:: _mysql_connector.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/"'; + + +.. _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: + +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.8 + +We'll change it to point to the new package repository: + +.. sourcecode:: bash + + deb http://cloudstack.apt-get.eu/ubuntu precise 4.9 + +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. + + +.. _rpm-repo48: + +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.8/ + 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.9/``. + +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 `_ +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 + `_. + +**(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 -p + + .. 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-repo48` 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