Merge remote-tracking branch 'origin/4.14'

rohityadavcloud · rohityadavcloud · commit 2c3a9e5fc8f4 · 2020-06-05T22:28:34.000+05:30
Signed-off-by: Rohit Yadav &lt;rohit.yadav@shapeblue.com&gt;
diff --git a/source/adminguide/templates/_bypass-secondary-storage-kvm.rst b/source/adminguide/templates/_bypass-secondary-storage-kvm.rst
@@ -17,7 +17,7 @@
 .. _bypass-secondary-storage-kvm:
 
 Bypassing Secondary Storage For KVM templates
---------------------------------------------
+---------------------------------------------
 
 CloudStack provides an additional way to register and use templates on KVM.
 
@@ -41,6 +41,13 @@ To enable this option for a template:
 
 After the template is registered, it is automatically available for VM deployments.
 
+From CloudStack 4.14.0, system VM templates also support direct download. An administrator can register a new system VM template as ROUTING or USER type with the direct download flag, and it can be changed to SYSTEM type during the upgrade or by out-of-band database changes. Type of newly registered template can be changed to SYSTEM in the database using a SQL query similar to:
+
+.. code:: bash
+
+      UPDATE cloud.vm_template SET type=’SYSTEM’ WHERE uuid=’UUID_OF_NEW_TEMPLATE’;
+
+
 Uploading Certificates for Direct Downloads
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 For direct downloads over HTTPS, the KVM hosts must have valid certificates. These certificates can be either self-signed or signed and will allow the KVM hosts to access the templates/ISOs and download them.
@@ -78,7 +85,7 @@ CloudStack provides some APIs to handle certificates for direct downloads:
          upload templatedirectdownloadcertificate hypervisor=KVM name=CERTIFICATE_ALIAS zoneid=ZONE_ID certificate=CERTIFICATE_FORMATTED hostid=HOST_ID
 
 Syncronising Certificates for Direct Downloads
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 As new hosts may be added to a zone which do not include a certificate which was previously uploaded to pre-existing hosts.
 
@@ -88,3 +95,14 @@ CloudStack provides a way to synchronize certificates across all the connected h
 - Enumerate the connected hosts in a zone
 - Check which hosts are missing the certificates which have been already uploaded to other hosts
 - Upload missing certificates to hosts
+
+Direct Download Timeouts
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+With 4.14.0, ability to configure different timeout values for the direct downloading of templates has been added. Three new global settings have been added for this:
+
+- **direct.download.connect.timeout** - Connection establishment timeout in milliseconds for direct download. Default value: 5000 milliseconds.
+
+- **direct.download.socket.timeout** - Socket timeout (SO_TIMEOUT) in milliseconds for direct download. Default value: 5000 milliseconds.
+
+- **direct.download.connection.request.timeout** - Requesting a connection from connection manager timeout in milliseconds for direct download. Default value: 5000 milliseconds. This setting is hidden and not visible in UI.
diff --git a/source/installguide/hypervisor/kvm.rst b/source/installguide/hypervisor/kvm.rst
@@ -153,6 +153,7 @@ In RHEL or CentOS:
 
 .. parsed-literal::
 
+   $ yum install -y epel-release
    $ yum install cloudstack-agent
 
 In Ubuntu:
diff --git a/source/installguide/hypervisor/lxc.rst b/source/installguide/hypervisor/lxc.rst
@@ -149,6 +149,7 @@ In RHEL or CentOS:
 
 .. parsed-literal::
 
+   $ yum install -y epel-release
    $ yum install cloudstack-agent
 
 In Ubuntu:
diff --git a/source/quickinstallationguide/qig.rst b/source/quickinstallationguide/qig.rst
@@ -536,6 +536,7 @@ afterwards we'll need to configure a few things.
 
 .. parsed-literal::
 
+   # yum -y install epel-release
    # yum -y install cloudstack-agent
 
 
diff --git a/source/releasenotes/about.rst b/source/releasenotes/about.rst
@@ -17,7 +17,8 @@
 What's New in |release|
 =======================
 
-Apache CloudStack |release| is a |version| LTS release with over 15 major new features, and over 200 enhancements and fixes since 4.13.  Highlights include:
+Apache CloudStack |release| is a |version| LTS release with over 15 major new features, and
+over 200 enhancements and fixes since 4.13.  Highlights include:
 
 •	New modern UI (Project Primate, Technical preview)
 •	Backup and Recovery framework
@@ -33,28 +34,47 @@ Apache CloudStack |release| is a |version| LTS release with over 15 major new fe
 •	Enable additional configuration metadata to virtual machines
 
 
-The full list of new features can be found in the project release notes at http://docs.cloudstack.apache.org/en/4.14.0.0/releasenotes/changes.html
+The full list of new features can be found in the project release notes at
+http://docs.cloudstack.apache.org/en/4.14.0.0/releasenotes/changes.html
 
-.. note:: 
+.. important::
    This version of CloudStack allows control over the visibility of the DNS services provided
-   by the Virtual Router. One can control whether the service on the routers be available to 
-   networks outside the local network. This might be important on Shared Networks which are 
-   using Internet routable/public (i.e. non-RFC 1918) IP addresses. The new global setting 
-   "expose.dns.externally" has been added with a default value of "true" in order to keep backward compatibility
-   with the previous installations. If you wish to disable public access to the DNS services
-   running on Virtual Router, set the value to "false" and recreate the related Virtual Routers.
+   by the Virtual Router in Shared networks. By default CloudStack allows DNS queries via the
+   Guest interface from any IP address. This allows for the DNS resolution of guest VMs on the
+   Shared network by services outside of the shared network. While this can be useful, it can
+   also be an issue on Shared Networks which are using Internet routable/public (i.e. non-RFC1918)
+   IP addresses, as the DNS service is then queriable from the public internet at large. A new
+   global setting "expose.dns.externally" has been added (with a default value of "true" in
+   order to keep backward compatibility) which controls whether the source of DNS queries
+   should be limited to only hosts on the Shared Network guest subnet or not. If you wish
+   to disable 'outside' access to the DNS services running on Virtual Routers; set the value
+   to "false" and recreate the related Virtual Routers.
 
-Apache CloudStack powers numerous elastic Cloud computing services, including solutions that have ranked as Gartner Magic Quadrant leaders. Highlighted in the Forrester Q4 2017 Enterprise Open Source Cloud Adoption report, Apache CloudStack "sits beneath hundreds of service provider clouds", including Fortune 5 multinational corporations. A list of known Apache CloudStack users are available at http://cloudstack.apache.org/users.html
+Apache CloudStack powers numerous elastic Cloud computing services, including solutions that have
+ranked as Gartner Magic Quadrant leaders. Highlighted in the Forrester Q4 2017 Enterprise Open Source
+Cloud Adoption report, Apache CloudStack "sits beneath hundreds of service provider clouds", including
+Fortune 5 multinational corporations. A list of known Apache CloudStack users are available
+at http://cloudstack.apache.org/users.html
+
+Libvirt Python Dependency on KVM and CentOS
+===========================================
+
+For CentOS users using the security groups feature on KVM it is needed to install the epel-release and python36-libvirt packages.
 
 New User Interface & Depreciation notice of existing UI
 =======================================================
 
-Cloudstack 4.14 ships with a Technical Preview of a new, modern User Interface (project Primate) . This technical preview can be used by users & operators of Cloudstack environments for evaluation & testing purposes. With version 4.14, the existing UI remains the supported UI for production environments.
-However, with the 4.14 release, the Apache Cloudstack community will stop taking feature requests for new functionality in the existing UI. All new functionality will be developed against the new UI.
+Cloudstack 4.14 ships with a Technical Preview of a new, modern User Interface (project Primate).
+This technical preview can be used by users & operators of Cloudstack environments for evaluation
+& testing purposes. With version 4.14, the existing UI remains the supported UI for production environments.
+However, with the 4.14 release, the Apache Cloudstack community will stop taking feature requests
+for new functionality in the existing UI. All new functionality will be developed against the new UI.
 
-The next LTS release (likely to be version 4.15) of Apache Cloudstack will ship with the production release of the new UI. It will also be the last version of CloudStack to ship with the old UI. This release will also have the final deprecation notice for the old UI.
+The next LTS release (likely to be version 4.15) of Apache Cloudstack will ship
+with the production release of the new UI. It will also be the last version of
+CloudStack to ship with the old UI. This release will also have the final
+deprecation notice for the old UI.
 
 In the following release (likely to be 4.16), the old UI will be deprecated.
 
 Please see `Primate install guide <../installguide/primate.html>`_
-
diff --git a/source/upgrading/upgrade/upgrade-4.11.rst b/source/upgrading/upgrade/upgrade-4.11.rst
@@ -302,6 +302,8 @@ For KVM hosts, upgrade the ``cloudstack-agent`` package
 
    .. parsed-literal::
 
+      $ sudo yum install -y epel-release
+      $ sudo yum install -y python36-libvirt
       $ sudo yum upgrade cloudstack-agent
 
 #. Restart the agent:
diff --git a/source/upgrading/upgrade/upgrade-4.13.rst b/source/upgrading/upgrade/upgrade-4.13.rst
@@ -281,6 +281,8 @@ For KVM hosts, upgrade the ``cloudstack-agent`` package
 
    .. parsed-literal::
 
+      $ sudo yum install -y epel-release
+      $ sudo yum install -y python36-libvirt
       $ sudo yum upgrade cloudstack-agent
 
 #. Restart the agent:
diff --git a/source/upgrading/upgrade/upgrade-4.9.rst b/source/upgrading/upgrade/upgrade-4.9.rst
@@ -383,6 +383,8 @@ For KVM hosts, upgrade the ``cloudstack-agent`` package
 
    .. parsed-literal::
 
+      $ sudo yum install -y epel-release
+      $ sudo yum install -y python36-libvirt
       $ sudo yum upgrade cloudstack-agent
 
 #. Verify that the file ``/etc/cloudstack/agent/environment.properties`` has a

Original file line number	Diff line number	Diff line change
`@@ -536,6 +536,7 @@ afterwards we'll need to configure a few things.`
`536`	`536`
`537`	`537`	`.. parsed-literal::`
`538`	`538`
	`539`	`+ # yum -y install epel-release`
`539`	`540`	`# yum -y install cloudstack-agent`
`540`	`541`
`541`	`542`