You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by ts...@apache.org on 2013/04/18 04:26:23 UTC
[35/41] git commit: updated refs/heads/marvin_refactor to 94b18c6
Initial pass at RPM upgrade instructions from 4.0.x to 4.1.0
Signed-off-by: Chip Childers <ch...@apache.org>
Project: http://git-wip-us.apache.org/repos/asf/cloudstack/repo
Commit: http://git-wip-us.apache.org/repos/asf/cloudstack/commit/7182a939
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack/tree/7182a939
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack/diff/7182a939
Branch: refs/heads/marvin_refactor
Commit: 7182a939a89b50280ec374f8a295e71837b71e3a
Parents: 11162f5
Author: Chip Childers <ch...@apache.org>
Authored: Wed Apr 17 20:47:11 2013 -0400
Committer: Chip Childers <ch...@apache.org>
Committed: Wed Apr 17 20:49:18 2013 -0400
----------------------------------------------------------------------
docs/en-US/Release_Notes.xml | 45 +++++++++++++++++++++++++++++++++++-
1 files changed, 43 insertions(+), 2 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/7182a939/docs/en-US/Release_Notes.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/Release_Notes.xml b/docs/en-US/Release_Notes.xml
index f243a26..d51e9fb 100644
--- a/docs/en-US/Release_Notes.xml
+++ b/docs/en-US/Release_Notes.xml
@@ -4201,10 +4201,51 @@ under the License.
</orderedlist>
</listitem>
<listitem id="upgrade-rpm-packages">
- <para>The package names have changed between 4.0 and 4.1, so upgrading the packages won't happen automatically with a <command>yum update</command></para>
+ <para>If you are using CentOS or RHEL, follow this procedure to upgrade your packages. If not, skip to step <xref linkend="restart-system-vms" />.</para>
+ <note><title>Community Packages</title>
+ <para>This section assumes you're using the community supplied packages for &PRODUCT;. If you've created your own packages and yum repository, substitute your own URL for the ones used in these examples.</para>
+ </note>
+ <orderedlist id="rpmsteps">
+ <listitem>
+ <para>The first order of business will be to change the yum repository for each system with &PRODUCT; 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.)</para>
+ <para>Start by opening <filename>/etc/yum.repos.d/cloudstack.repo</filename> on any systems that have &PRODUCT; packages installed.</para>
+ <para>This file should have content similar to the following:</para>
+ <programlisting language="Bash">
+[apache-cloudstack]
+name=Apache CloudStack
+baseurl=http://cloudstack.apt-get.eu/rhel/4.0/
+enabled=1
+gpgcheck=0
+ </programlisting>
+ <para>If you are using the community provided package repository, change the baseurl to http://cloudstack.apt-get.eu/rhel/4.1/</para>
+ <para>If you're using your own package repository, change this line to read as appropriate for your 4.1.0 repository.</para>
+ </listitem>
+ <listitem id="rpm-master">
+ <para>Now that you have the repository configured, it's time to install the <filename>cloudstack-management</filename> package. This will pull in any other dependencies you need.</para>
+ <programlisting language="Bash">$ sudo yum install cloudstack-management</programlisting>
+ </listitem>
+ <listitem id="kvm-agent-rpm">
+ <para>For KVM hosts, you will need to upgrade the <filename>cloudstack-agent</filename> package:</para>
+ <programlisting language="Bash">$ sudo yum install cloudstack-agent</programlisting>
+ <para>During the installation of <filename>cloudstack-agent</filename>, the RPM will copy your <filename>agent.properties</filename>, <filename>log4j-cloud.xml</filename>, and <filename>environment.properties</filename> from <filename>/etc/cloud/agent</filename> to <filename>/etc/cloudstack/agent</filename>.</para>
+ </listitem>
+ <listitem>
+ <para>Verify that the file <filename>/etc/cloudstack/agent/environment.properties</filename> has a line that reads:</para>
+ <programlisting language="Bash">paths.script=/usr/share/cloudstack-common</programlisting>
+ <para>If not, add the line.</para>
+ </listitem>
+ <listitem>
+ <para>Restart the agent:</para>
+ <programlisting language="Bash">
+ service cloud-agent stop
+ killall jsvc
+ service cloudstack-agent start
+ </programlisting>
+ </listitem>
+ </orderedlist>
</listitem>
<listitem id="restart-system-vms">
- <para>Once you've upgraded the packages on your management servers, you'll need to restart the system VMs. Make sure port 8096 is open <!-- [FIXME, where?] --> to do this.</para>
+ <para>Once you've upgraded the packages on your management servers, you'll need to restart the system VMs. Make sure port 8096 is open in your local host firewall to do this.</para>
<para>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:</para>
<programlisting language="Bash"><prompt>#</prompt> nohup cloudstack-sysvmadm -d <replaceable>IP address</replaceable> -u cloud -p -a > sysvm.log 2>&1 &</programlisting>
<para>You can monitor the log for progress. The process of restarting the system VMs can take an hour or more.</para>