You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by ml...@apache.org on 2013/01/26 06:25:09 UTC
[43/50] git commit: Document procedure to choose default System
Offering for System VMs
Document procedure to choose default System Offering for System VMs
Signed-off-by: Radhika PC <ra...@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 <ra...@citrix.com>
Authored: Fri Jan 11 18:13:17 2013 +0530
Committer: Joe Brockmeier <jz...@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>