Document procedure to choose default System Offering for System VMs Signed-off-by: Radhika PC <radhika.puthiyet...@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/regions Commit: 25c0d84c169b6c61ad1995845fa636fed8d092c3 Parents: a2b2d45 Author: Radhika PC <radhika.puthiyet...@citrix.com> Authored: Fri Jan 11 18:13:17 2013 +0530 Committer: Joe Brockmeier <j...@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>
