cloudstack-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From seb...@apache.org
Subject [05/10] git commit: upgrade instruction from 4.3
Date Wed, 21 May 2014 06:34:04 GMT
upgrade instruction from 4.3

Signed-off-by: Sebastien Goasguen <runseb@gmail.com>


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/e6cf5520
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/tree/e6cf5520
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/diff/e6cf5520

Branch: refs/heads/master
Commit: e6cf552082df6e5a629977d0ea8aa482ba08ead5
Parents: a259891
Author: Pierre-Luc Dion <pdion@cloudops.com>
Authored: Mon May 19 14:37:40 2014 -0400
Committer: Sebastien Goasguen <runseb@gmail.com>
Committed: Wed May 21 08:33:09 2014 +0200

----------------------------------------------------------------------
 source/index.rst                |  27 +-
 source/rnotes.rst               | 111 +-------
 source/systemvm_templates.rst   |   6 +
 source/upgrade/upgrade-4.3.rst  | 489 +++++++++++++++++++++++++++++++++++
 source/upgrade/valid_source.rst | 107 ++++++++
 5 files changed, 632 insertions(+), 108 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/e6cf5520/source/index.rst
----------------------------------------------------------------------
diff --git a/source/index.rst b/source/index.rst
index 52991b5..994c60e 100644
--- a/source/index.rst
+++ b/source/index.rst
@@ -33,13 +33,38 @@ This document contains information specific to this release of CloudStack,
inclu
 Contents:
 
 .. toctree::
-   :maxdepth: 3
+   :maxdepth: 2
 
    about
+
+.. toctree::
+   :maxdepth: 2
+
    fixed_issues
+
+.. toctree::
+   :maxdepth: 2
+
    compat
+
+.. toctree::
+   :maxdepth: 1
+
+   upgrade/upgrade-4.3
+
+.. toctree::
+   :maxdepth: 2
+
    rnotes
+
+.. toctree::
+   :maxdepth: 2
+
    api-changes
+
+.. toctree::
+   :maxdepth: 2
+
    known_issues   
 
 .. include:: global.rst

http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/e6cf5520/source/rnotes.rst
----------------------------------------------------------------------
diff --git a/source/rnotes.rst b/source/rnotes.rst
index 8ed741f..60bb5fe 100644
--- a/source/rnotes.rst
+++ b/source/rnotes.rst
@@ -35,113 +35,6 @@ questions on users@cloudstack.apache.org or dev@cloudstack.apache.org.
    communications.
 
 
-Validate |version| source code tarball
---------------------------------------
-
-#. 
-
-   Perform the following to verify the artifacts:
-
-   #. 
-
-      (optional) Install GPG keys if needed:
-
-      .. sourcecode:: bash
-   	  
-          $ sudo apt-get install gpg
-
-   #. 
-
-      Import the GPG keys stored in the source distribution's KEYS file
-
-      .. sourcecode:: bash
-
-          $ gpg --import KEYS
-
-      Alternatively, download the signing keys, the IDs found in the
-      KEYS file, individually by using a keyserver.
-
-      For example:
-
-      .. sourcecode:: bash
-
-          $ gpg --recv-keys CC56CEA8
-
-   #. 
-
-      Verify signatures and hash files:
-
-      .. sourcecode:: bash
-
-          $ gpg --verify apache-cloudstack-4.4-src.tar.bz2.asc
-          $ gpg --print-md MD5 apache-cloudstack-4.4-src.tar.bz2 | diff - apache-cloudstack-4.4-src.tar.bz2.md5
-          $ gpg --print-md SHA512 apache-cloudstack-4.4-src.tar.bz2 | diff - apache-cloudstack-4.4-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
-      generated locally and the hash that has been pulled from the
-      server.
-
-   #. 
-
-      Get the commit hash from the VOTE email.
-
-      For example: ``4cd60f3d1683a3445c3248f48ae064fb573db2a1``. The
-      value changes between releases.
-
-   #. 
-
-      Create two new temporary directories:
-
-      .. sourcecode:: bash
-
-          $ mkdir /tmp/cloudstack/git
-          $ mkdir /tmp/cloudstack/tree
-
-   #. 
-
-      Check out the |version| branch:
-
-      .. sourcecode:: bash
-
-          $ git clone https://git-wip-us.apache.org/repos/asf/cloudstack.git /tmp/cloudstack/git
-          $ cd /tmp/cloudstack/git
-          $ git archive --format=tar --prefix=/tmp/cloudstack/tree/ <commit-hash> |
tar Pxf -
-
-   #. 
-
-      Unpack the release artifact:
-
-      .. sourcecode:: bash
-
-          $ cd /tmp/cloudstack
-          $ tar xvfj apache-cloudstack-4.4-src.tar.bz2
-
-   #. 
-
-      Compare the contents of the release artifact with the contents
-      pulled from the repo:
-
-      .. sourcecode:: bash
-
-          $ diff -r /tmp/cloudstack/apache-cloudstack-4.4-src /tmp/cloudstack/tree
-
-      Ensure that content is the same.
-
-   #. 
-
-      Verify the Code License Headers:
-
-      .. sourcecode:: bash
-
-          $ cd /tmp/cloudstack/apache-cloudstack-4.4-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
-      not specifically excluded from the ASF license header requirement.
-      You can optionally review the target/rat.txt file after the run
-      completes. Passing the build implies that RAT certifies that the
-      files are compliant and this test is passed.
 
 Upgrade from 4.2.x to |version|
 -------------------------------
@@ -3021,4 +2914,8 @@ Upgrade from 2.2.14 to |version|
       On each slave host in the Xen pool, repeat these steps, starting
       from "manually live migrate VMs."
 
+
+.. include:: upgrade/valid_source.rst
+
+
 .. include:: global.rst
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/e6cf5520/source/systemvm_templates.rst
----------------------------------------------------------------------
diff --git a/source/systemvm_templates.rst b/source/systemvm_templates.rst
index 496e750..6c550f5 100644
--- a/source/systemvm_templates.rst
+++ b/source/systemvm_templates.rst
@@ -25,6 +25,8 @@
 |                         | Public: no                                                  
                                 |
 |                         |                                                             
                                 |
 |                         | Featured: no                                                
                                 |
+|                         |                                                             
                                 |
+|                         | Routing: yes                                                
                                 |
 +-------------------------+-----------------------------------------------------------------------------------------------+
 | KVM                     | Name: systemvm-kvm-|version|                                
                                 |
 |                         |                                                             
                                 |
@@ -50,6 +52,8 @@
 |                         | Public: no                                                  
                                 |
 |                         |                                                             
                                 |
 |                         | Featured: no                                                
                                 |
+|                         |                                                             
                                 |
+|                         | Routing: yes                                                
                                 |
 +-------------------------+-----------------------------------------------------------------------------------------------+
 | VMware                  | Name: systemvm-vmware-|version|                             
                                 |
 |                         |                                                             
                                 |
@@ -75,4 +79,6 @@
 |                         | Public: no                                                  
                                 |
 |                         |                                                             
                                 |
 |                         | Featured: no                                                
                                 |
+|                         |                                                             
                                 |
+|                         | Routing: yes                                                
                                 |
 +-------------------------+-----------------------------------------------------------------------------------------------+
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/e6cf5520/source/upgrade/upgrade-4.3.rst
----------------------------------------------------------------------
diff --git a/source/upgrade/upgrade-4.3.rst b/source/upgrade/upgrade-4.3.rst
new file mode 100644
index 0000000..9a810f3
--- /dev/null
+++ b/source/upgrade/upgrade-4.3.rst
@@ -0,0 +1,489 @@
+Upgrade from 4.3
+================
+
+This section will guide you from CloudStack 4.3.x 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:
+
+#. Install new System-VM templates
+#. Backup CloudStack database (MySQL)
+#. Upgrade CloudStack packages
+#. Update hypervisors specific dependencies
+#. Restart System-VMs and Virtual-Routers
+
+
+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:`ubuntu` or :ref:`rhel` and :ref:`kvm` hosts upgrade. 
+
+Instructions for creating packages from the CloudStack source are in the `CloudStack Installation
Guide`_.
+
+Update System-VM template
+-------------------------
+
+#. 
+
+   While running the existing 4.3.x system, log in to the UI as root
+   administrator.
+
+#. 
+
+   In the left navigation bar, click Templates.
+
+#. 
+
+   In Select view, click Templates.
+
+#. 
+
+   Click Register template.
+
+   The Register template dialog box is displayed.
+
+#. 
+
+   In the Register template dialog box, specify the following values
+   (do not change these):
+
+   .. include:: /systemvm_templates.rst
+
+
+Prepare Databases
+-----------------
+
+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 > cloudstack-backup.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/"';
+
+
+.. _ubuntu:
+
+Ubuntu management server
+------------------------
+
+If you are using Ubuntu, follow this procedure to upgrade your packages. If not, skip to
step `11 <#upgrade-rpm-packages-|version|>`__.
+
+.. 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-repo:
+
+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.3
+   
+   We'll change it to point to the new package repository:
+   
+   .. sourcecode:: bash
+   
+       deb http://cloudstack.apt-get.eu/ubuntu precise 4.4
+   
+   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
+
+#. 
+
+   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
+
+
+.. _rhel:
+
+CentOS/RHEL management server
+-----------------------------
+
+If you are using CentOS or RHEL, follow this procedure to upgrade your packages. If not,
skip to step `14 <#restart-system-vms-|version|>`__.
+
+.. 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-repo:
+
+CloustStack 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/rhel/4.3/
+       enabled=1
+       gpgcheck=0
+
+   If you are using the community provided package repository, change
+   the base url to ``http://cloudstack.apt-get.eu/rhel/4.4/``
+
+   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
+
+#. 
+
+   Now it's time to restart the management server
+
+   .. sourcecode:: bash
+
+       $ sudo service cloudstack-management start
+
+
+Xen/XenServer hypervisor
+------------------------
+
+   **(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``.
+
+VMware hypervisor
+-----------------
+
+   .. 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;
+
+#. 
+
+   Start the CloudStack Management server
+
+   .. sourcecode:: bash
+
+       $ sudo service cloudstack-management start
+
+.. _kvm:
+
+KVM hypervisor
+--------------
+
+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-repo` as detailed above.
+
+#. 
+
+   Stop the running agent.
+
+   .. sourcecode:: bash
+
+       $ sudo service cloudstack-agent stop
+
+#. 
+
+   Update the agent software.
+
+   .. sourcecode:: bash
+
+       $ sudo apt-get update 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-repo` 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
+
+#. 
+
+   Now it's time to restart the management server
+
+   .. sourcecode:: bash
+
+       $ sudo service cloudstack-management start
+
+.. _upg-sysvm:
+
+System-VMs and Virtual-Routers
+------------------------------
+
+Once you've upgraded the packages on your management servers, you'll
+need to restart the system VMs. Ensure that the admin port is set to
+8096 by using the "integration.api.port" global parameter. This port
+is used by the cloud-sysvmadm script at the end of the upgrade
+procedure. For information about how to set this parameter, see
+`Setting Global Configuration Parameters <http://docs.cloudstack.apache.org/projects/cloudstack-installation/en/latest/configuration.html#setting-global-configuration-parameters>`_
in the Installation Guide.
+Changing this parameter will require management server restart. Also
+make sure port 8096 is open in your local host firewall to do this.
+
+There is a script that will do this for you, all you need to do is
+run the script and supply the IP address for your MySQL instance and
+your MySQL credentials:
+
+.. sourcecode:: bash
+
+    # nohup cloudstack-sysvmadm -d IP address -u cloud -p -a > sysvm.log 2>&1 &
+
+You can monitor the log for progress. The process of restarting the
+system VMs can take an hour or more.
+
+.. sourcecode:: bash
+
+    # tail -f sysvm.log
+
+The output to ``sysvm.log`` will look something like this:
+
+.. sourcecode:: bash
+
+    Stopping and starting 1 secondary storage vm(s)...
+    Done stopping and starting secondary storage vm(s)
+    Stopping and starting 1 console proxy vm(s)...
+    Done stopping and starting console proxy vm(s).
+    Stopping and starting 4 running routing vm(s)...
+    Done restarting router(s).
+
+
+.. include:: /global.rst

http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/e6cf5520/source/upgrade/valid_source.rst
----------------------------------------------------------------------
diff --git a/source/upgrade/valid_source.rst b/source/upgrade/valid_source.rst
new file mode 100644
index 0000000..1aca761
--- /dev/null
+++ b/source/upgrade/valid_source.rst
@@ -0,0 +1,107 @@
+Validate |version| source code tarball
+--------------------------------------
+
+#. 
+
+   Perform the following to verify the artifacts:
+
+   #. 
+
+      (optional) Install GPG keys if needed:
+
+      .. sourcecode:: bash
+      
+          $ sudo apt-get install gpg
+
+   #. 
+
+      Import the GPG keys stored in the source distribution's KEYS file
+
+      .. sourcecode:: bash
+
+          $ gpg --import KEYS
+
+      Alternatively, download the signing keys, the IDs found in the
+      KEYS file, individually by using a keyserver.
+
+      For example:
+
+      .. sourcecode:: bash
+
+          $ gpg --recv-keys CC56CEA8
+
+   #. 
+
+      Verify signatures and hash files:
+
+      .. sourcecode:: bash
+
+          $ gpg --verify apache-cloudstack-4.4-src.tar.bz2.asc
+          $ gpg --print-md MD5 apache-cloudstack-4.4-src.tar.bz2 | diff - apache-cloudstack-4.4-src.tar.bz2.md5
+          $ gpg --print-md SHA512 apache-cloudstack-4.4-src.tar.bz2 | diff - apache-cloudstack-4.4-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
+      generated locally and the hash that has been pulled from the
+      server.
+
+   #. 
+
+      Get the commit hash from the VOTE email.
+
+      For example: ``4cd60f3d1683a3445c3248f48ae064fb573db2a1``. The
+      value changes between releases.
+
+   #. 
+
+      Create two new temporary directories:
+
+      .. sourcecode:: bash
+
+          $ mkdir /tmp/cloudstack/git
+          $ mkdir /tmp/cloudstack/tree
+
+   #. 
+
+      Check out the |version| branch:
+
+      .. sourcecode:: bash
+
+          $ git clone https://git-wip-us.apache.org/repos/asf/cloudstack.git /tmp/cloudstack/git
+          $ cd /tmp/cloudstack/git
+          $ git archive --format=tar --prefix=/tmp/cloudstack/tree/ <commit-hash> |
tar Pxf -
+
+   #. 
+
+      Unpack the release artifact:
+
+      .. sourcecode:: bash
+
+          $ cd /tmp/cloudstack
+          $ tar xvfj apache-cloudstack-4.4-src.tar.bz2
+
+   #. 
+
+      Compare the contents of the release artifact with the contents
+      pulled from the repo:
+
+      .. sourcecode:: bash
+
+          $ diff -r /tmp/cloudstack/apache-cloudstack-4.4-src /tmp/cloudstack/tree
+
+      Ensure that content is the same.
+
+   #. 
+
+      Verify the Code License Headers:
+
+      .. sourcecode:: bash
+
+          $ cd /tmp/cloudstack/apache-cloudstack-4.4-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
+      not specifically excluded from the ASF license header requirement.
+      You can optionally review the target/rat.txt file after the run
+      completes. Passing the build implies that RAT certifies that the
+      files are compliant and this test is passed.


Mime
View raw message