You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by pd...@apache.org on 2014/09/21 17:53:10 UTC

[5/5] git commit: add general upgrade section

add general upgrade section


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

Branch: refs/heads/4.3
Commit: 3c9229719681497d9163541903981b49bfe3a57b
Parents: 3427a9d
Author: Pierre-Luc Dion <pd...@apache.org>
Authored: Sun Sep 21 11:51:24 2014 -0400
Committer: Pierre-Luc Dion <pd...@apache.org>
Committed: Sun Sep 21 11:51:24 2014 -0400

----------------------------------------------------------------------
 source/index.rst                 |  1 +
 source/upgrade/upgrade_notes.rst | 95 +++++++++++++++++++++++++++++++++++
 2 files changed, 96 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/3c922971/source/index.rst
----------------------------------------------------------------------
diff --git a/source/index.rst b/source/index.rst
index 094ea01..77ad464 100644
--- a/source/index.rst
+++ b/source/index.rst
@@ -48,6 +48,7 @@ Contents:
 .. toctree::
    :maxdepth: 2
 
+   upgrade/upgrade_notes
    rnotes
    
 .. toctree::

http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/3c922971/source/upgrade/upgrade_notes.rst
----------------------------------------------------------------------
diff --git a/source/upgrade/upgrade_notes.rst b/source/upgrade/upgrade_notes.rst
new file mode 100644
index 0000000..1fbb680
--- /dev/null
+++ b/source/upgrade/upgrade_notes.rst
@@ -0,0 +1,95 @@
+.. 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.
+
+
+General Upgrade Notes
+=====================
+
+
+Depreciation of realhostip.com 
+------------------------------
+   
+The realhostip.com dynamic DNS resolution service is being retired on
+September 30th, 2014. In advance of that, CloudStack 4.4 and later no longer uses 
+realhostip.com DNS domains or SSL certificates to encrypt Console Proxy or 
+file copy communications.
+
+For latest update about realhostip.com follow `Apache CloudStack Blog <https://blogs.apache.org/cloudstack/>`_.
+
+
+
+Settings Changes
+----------------
+
+Console Proxy URL
+^^^^^^^^^^^^^^^^^
+
+Please use ***.realhostip.com** (note the asterisk) as
+``consoleproxy.url.domain`` value in global configs if you are using HTTPS for
+console proxy. Please note that you need to restart the management server when you change
+the global config value.
+
+If you started with 4.3, you are likely running the console in HTTP mode
+and the value of the above global config should be blank.
+
+If switching between HTTP / HTTPS, the console proxy VM has to be
+destroyed and recreated (available via UI)
+
+
+Cluster Settings
+^^^^^^^^^^^^^^^^
+
+After upgrading to 4.2 and later, Settings ``mem.overporvisioning.factor`` and 
+``cpu.overporvisioning.factor`` are now at the cluster level and be set to 1 
+which is the default.
+
+If Global Settings ``mem.overporvisioning.factor`` and 
+``cpu.overporvisioning.factor`` have been changed prior the upgrade to 4.2 and 
+later, the upgrade process will be reset them to 1. Values can be changed by 
+editing clusters settings.
+
+All clusters created after the upgrade will get created with the Global Settings 
+values for ``mem.overporvisioning.factor`` and ``cpu.overporvisioning.factor``.
+
+
+Active-Directory Authentication (LDAP)
+--------------------------------------
+
+If using Active-Directory (LDAP/LDAPs) as user authentication; Upgrading to 
+4.3 and later require changes in Global Settings. After upgrading CloudStack
+to 4.3 or latest, following Global Settings must be change:
+
+======================= ============== ==============
+Global Settings         Default        New
+======================= ============== ==============
+ldap.user.object        inetOrgPerson  user
+ldap.username.attribute uid            sAMAccountName
+======================= ============== ==============
+
+
+SystemVM 32bit deprecated
+-------------------------
+
+32bit version of systemvm templates are in the process of behing deprecated. Upgrade instructions from this Release Notes use 64bit templates. 32bit systemvm-templates are available for this version on `http://cloudstack.apt-get.eu/systemvm/4.4/ <http://cloudstack.apt-get.eu/systemvm/4.4/>`_. Follow the dev mailing list for further updates.
+
+
+.. not confirmed 
+   Build From Sources
+   ------------------
+   
+   Since CloudStack 4.2.1 build packages from source using non opensource 
+   modules param ``-nonoss`` changed to ``-   noredist``.
+
+