incubator-cloudstack-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mlsoren...@apache.org
Subject [43/50] git commit: Document procedure to choose default System Offering for System VMs
Date Sat, 26 Jan 2013 05:25:09 GMT
Document procedure to choose default System Offering for System VMs

Signed-off-by: Radhika PC <radhika.puthiyetath@citrix.com>


Project: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/commit/25c0d84c
Tree: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/tree/25c0d84c
Diff: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/diff/25c0d84c

Branch: refs/heads/add_remove_nics
Commit: 25c0d84c169b6c61ad1995845fa636fed8d092c3
Parents: a2b2d45
Author: Radhika PC <radhika.puthiyetath@citrix.com>
Authored: Fri Jan 11 18:13:17 2013 +0530
Committer: Joe Brockmeier <jzb@zonker.net>
Committed: Thu Jan 24 21:32:46 2013 -0600

----------------------------------------------------------------------
 docs/en-US/offerings.xml          |   32 ++++++-------
 docs/en-US/sys-offering-sysvm.xml |   75 ++++++++++++++++++++++++++++++++
 2 files changed, 90 insertions(+), 17 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/25c0d84c/docs/en-US/offerings.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/offerings.xml b/docs/en-US/offerings.xml
index 10252fd..ca6312d 100644
--- a/docs/en-US/offerings.xml
+++ b/docs/en-US/offerings.xml
@@ -1,25 +1,22 @@
 <?xml version='1.0' encoding='utf-8' ?>
-<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
[
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
[
 <!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
 %BOOK_ENTITIES;
 ]>
-
 <!-- 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.
+  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.
 -->
 
 <chapter id="offerings">
@@ -28,4 +25,5 @@
         are discussed in the section on setting up networking for users.</para>
     <xi:include href="compute-disk-service-offerings.xml" xmlns:xi="http://www.w3.org/2001/XInclude"
/>
     <xi:include href="system-service-offerings.xml" xmlns:xi="http://www.w3.org/2001/XInclude"
/>
+    <xi:include href="sys-offering-sysvm.xml" xmlns:xi="http://www.w3.org/2001/XInclude"
/>
 </chapter>

http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/25c0d84c/docs/en-US/sys-offering-sysvm.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/sys-offering-sysvm.xml b/docs/en-US/sys-offering-sysvm.xml
new file mode 100644
index 0000000..cccf3e0
--- /dev/null
+++ b/docs/en-US/sys-offering-sysvm.xml
@@ -0,0 +1,75 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
[
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+<!-- 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.
+-->
+<section id="sys-offering-sysvm">
+  <title>Changing the Default System Offering for System VMs</title>
+  <para>You can manually change the system offering for a particular System VM. Additionally,
as a
+    &PRODUCT; administrator, you can also change the default system offering used for
System
+    VMs.</para>
+  <orderedlist>
+    <listitem>
+      <para>Create a new system offering.</para>
+      <para>For more information, see <phrase condition="install"><xref
+            linkend="creating-system-service-offerings"/></phrase>
+        <phrase condition="admin">Creating a New System Service Offering</phrase>.
</para>
+    </listitem>
+    <listitem>
+      <para>Back up the database:</para>
+      <programlisting>mysqldump -u root -p cloud | bzip2 > cloud_backup.sql.bz2</programlisting>
+    </listitem>
+    <listitem>
+      <para>Open an MySQL prompt:</para>
+      <programlisting>mysql -u cloud -p cloud</programlisting>
+    </listitem>
+    <listitem>
+      <para>Run the following queries on the cloud database.</para>
+      <orderedlist numeration="loweralpha">
+        <listitem>
+          <para>In the disk_offering table, identify the original default offering
and the new
+            offering you want to use by default. </para>
+          <para>Take a note of the ID of the new offering.</para>
+          <programlisting>select id,name,unique_name,type from disk_offering;</programlisting>
+        </listitem>
+        <listitem>
+          <para>For the original default offering, set the value of unique_name to
NULL.</para>
+          <programlisting># update disk_offering set unique_name = NULL where id =
10;</programlisting>
+          <para>Ensure that you use the correct value for the ID.</para>
+        </listitem>
+        <listitem>
+          <para>For the new offering that you want to use by default, set the value
of unique_name
+            as follows:</para>
+          <para>For the default Console Proxy VM (CPVM) offering,set unique_name to
+            'Cloud.com-ConsoleProxy'. For the default Secondary Storage VM (SSVM) offering,
set
+            unique_name to 'Cloud.com-SecondaryStorage'. For example:</para>
+          <programlisting>update disk_offering set unique_name = 'Cloud.com-ConsoleProxy'
where id = 16;</programlisting>
+        </listitem>
+      </orderedlist>
+    </listitem>
+    <listitem>
+      <para>Restart &PRODUCT; Management Server. Restarting is required because
the default
+        offerings are loaded into the memory at startup.</para>
+      <programlisting>service cloud-management restart</programlisting>
+    </listitem>
+    <listitem>
+      <para>Destroy the existing CPVM or SSVM offerings and wait for them to be recreated.
The new
+        CPVM or SSVM are configured with the new offering. </para>
+    </listitem>
+  </orderedlist>
+</section>


Mime
View raw message