Author: buildbot
Date: Fri Jan 25 20:46:15 2013
New Revision: 847962
Log:
Staging update by buildbot for vcl
Added:
websites/staging/vcl/trunk/content/docs/adding-xcat-kickstart-based-image.html
Removed:
websites/staging/vcl/trunk/content/confluence_export/adding-xcat-kickstart-based-image.html
Modified:
websites/staging/vcl/trunk/content/ (props changed)
Propchange: websites/staging/vcl/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Jan 25 20:46:15 2013
@@ -1 +1 @@
-1438693
+1438695
Added:
websites/staging/vcl/trunk/content/docs/adding-xcat-kickstart-based-image.html
==============================================================================
---
websites/staging/vcl/trunk/content/docs/adding-xcat-kickstart-based-image.html
(added)
+++
websites/staging/vcl/trunk/content/docs/adding-xcat-kickstart-based-image.html
Fri Jan 25 20:46:15 2013
@@ -0,0 +1,166 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
+<html>
+<head>
+<!--
+
+ 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.
+-->
+
+ <link href="/css/vcl.css" rel="stylesheet" type="text/css">
+ <link href="/css/code.css" rel="stylesheet" type="text/css">
+ <title>Apache VCL - Adding xCAT kickstart based image</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+</head>
+
+<body>
+ <div id="sitetitle">
+ <table width="100%" border="0" cellspacing="0" cellpadding="5">
+ <tr>
+ <td><a href="/index.html"><img src="/img/vcl-logo.png" height="100"
align="left" alt="Apache VCL logo"></a></td>
+ <td><a href="http://www.apache.org";><img src="/img/asf-logo.png"
align="right" alt="Apache Software Foundation logo"></a></td>
+ </tr>
+ </table>
+ </div>
+
+ <div id="navigation">
+ <ul>
+<li>Information<ul>
+<li><a href="/info/about.html">What is VCL?</a></li>
+<li><a href="/info/features.html">Features</a></li>
+<li><a href="/info/architecture.html">Architecture</a></li>
+<li><a href="/info/use-cases.html">Use Cases</a></li>
+<li><a href="/downloads/download.cgi">Download</a></li>
+<li><a href="http://www.apache.org/licenses/LICENSE-2.0.html";>License</a></li>
+<li><a href="/info/faq.html">FAQ</a></li>
+</ul>
+</li>
+<li><a href="/docs/index.html">Documentation</a><ul>
+<li><a href="/docs/using-vcl.html">Using VCL</a></li>
+<li><a href="/docs/image-creation.html">Image Creation</a></li>
+<li><a href="/docs/administration.html">Administration</a></li>
+<li><a href="/docs/installation.html">Installation</a></li>
+<li><a href="/docs/deployment-planning.html">Deployment Planning</a></li>
+</ul>
+</li>
+<li><a href="/comm/index.html">Community</a><ul>
+<li><a href="/comm/index.html#getInvolved">Getting Involved</a></li>
+<li><a href="/comm/index.html#mail-list">Mailing Lists</a></li>
+<li><a href="/comm/index.html#how-do-i-join-the-project">How can I
Join</a></li>
+<li><a href="/comm/wiki.html">Wiki</a></li>
+<li><a href="/dev/index.html">Development</a><ul>
+<li><a href="/dev/jira.html">Issue Tracking</a></li>
+<li><a href="/dev/code-documentation.html">Code Documentation</a></li>
+<li><a href="/dev/roadmap.html">Roadmap</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="http://www.apache.org";>Apache Software Foundation</a><ul>
+<li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li>
+<li><a href="http://www.apache.org/foundation/sponsorship.html";>Become a
Sponsor</a></li>
+</ul>
+</li>
+</ul>
+ </div>
+
+ <div id="content">
+ <h1 class="title">Adding xCAT kickstart based image</h1>
+ <h1
id="guide-for-adding-kickstart-installs-using-xcat-to-the-vcl-database">Guide
for adding kickstart installs using xCAT to the VCL database.</h1>
+<p>xCAT is the bare-metal provisioning tool primarily used within VCL. It has
+the ability to install physical nodes with an operating system such
+as; windows Red Hat, CentOS, ESX, SLES on x86 based hardware. This
+guide will discuss adding support to VCL for kickstart based or diskfull
+installs.</p>
+<p>Prerequisites are that you need to have a working xCAT install. Please
+see xCAT installation guide in order to install and configure xCAT.</p>
+<ul>
+<li>xCAT main page: <a
href="http://xcat.sourceforge.net/";>http://xcat.sourceforge.net/</a></li>
+<li>xCAT Getting Started guide: <a
href="http://sourceforge.net/apps/mediawiki/xcat/index.php?title=XCAT_Documentation";>http://sourceforge.net/apps/mediawiki/xcat/index.php?title=XCAT_Documentation</a></li>
+</ul>
+<h2 id="kickstart-template-files">Kickstart Template files</h2>
+<p>The template files used by xCAT reside in
+/opt/xcat/share/xcat/install/<distro>. distro can be rh, centos, fedora,
+esx, etc. Make sure to have a working template file. There are several
+examples in either of the distro directories that can used as a starting
+point. Once you have a working template, proceed to adding to the VCL
+database.</p>
+<h2 id="adding-kickstart-based-install-to-the-vcl-database">Adding kickstart
based install to the VCL database</h2>
+<p>The name of the template file and the image.name must match. VCL uses this
+name to check for and properly load using kickstart method. The xcat name
+will have the .tmpl, for example the vcl image.name entry of
+<strong>rhel5-base25-v0</strong> the template file for xcat will be
+<strong>rhel5-base25-v0.tmpl.</strong></p>
+<p>There are three tables that need to have entries before you can start using
+the image through the VCL web interface. The tables used are:</p>
+<ul>
+<li>image</li>
+<li>imagerevision</li>
+<li>resource</li>
+</ul>
+<p>Depending on your OS and the version of VCL, you might need to also create
+a new entry in the OS table. An example of adding a new OSid is discussed
+below.</p>
+<p>In our sql statement examples we will use RedHat 5 and the image id of 25
+as above <strong>rhel5-base25-v0.</strong> In the below sql statement make any
+changes as needed such as ownerid, in this example it is set to 1 or the
+admin user id.</p>
+<div class="codehilite"><pre><span class="n">INSERT</span> <span
class="n">INTO</span> <span class="sb">`image`</span> <span
class="p">(</span><span class="n">id</span><span class="p">,</span> <span
class="sb">`name`</span><span class="p">,</span> <span
class="sb">`prettyname`</span><span class="p">,</span> <span
class="sb">`ownerid`</span><span class="p">,</span> <span
class="sb">`platformid`</span><span class="p">,</span> <span
class="sb">`OSid`</span><span class="p">,</span> <span
class="sb">`minram`</span><span class="p">,</span> <span
class="sb">`minprocnumber`</span><span class="p">,</span> <span
class="sb">`minprocspeed`</span><span class="p">,</span> <span
class="sb">`minnetwork`</span><span class="p">,</span><span
class="sb">`reloadtime`</span><span class="p">,</span> <span
class="sb">`deleted`</span><span class="p">,</span> <span
class="sb">`lastupdate`</span><span class="p">,</span> <span
class="sb">`forcheckout`</span><span class="p">,</span> <span class="sb">`ma
xinitialtime`</span><span class="p">,</span><span
class="sb">`project`</span><span class="p">,</span> <span
class="sb">`size`</span><span class="p">)</span> <span class="n">VALUES</span>
<span class="p">(</span><span class="mi">25</span><span class="p">,</span>
<span class="s">'rhel5-base25-v0'</span><span class="p">,</span> <span
class="s">'RHEL 5 base'</span><span class="p">,</span> <span
class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span
class="p">,</span> <span class="mi">19</span><span class="p">,</span> <span
class="mi">1024</span><span class="p">,</span> <span class="mi">1</span><span
class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span
class="mi">10</span><span class="p">,</span> <span class="mi">14</span><span
class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span
class="n">NOW</span><span class="p">(),</span> <span class="mi">1</span><span
class="p">,</span> <span class="mi">0</span><
span class="p">,</span> <span class="s">'vcl'</span><span
class="p">,</span> <span class="mi">1045</span><span class="p">);</span>
+
+<span class="n">INSERT</span> <span class="n">INTO</span> <span
class="sb">`imagerevision`</span> <span class="p">(</span><span
class="sb">`imageid`</span><span class="p">,</span> <span
class="sb">`revision`</span><span class="p">,</span> <span
class="sb">`userid`</span><span class="p">,</span> <span
class="sb">`datecreated`</span><span class="p">,</span> <span
class="sb">`deleted`</span><span class="p">,</span> <span
class="sb">`production`</span><span class="p">,</span> <span
class="sb">`comments`</span><span class="p">,</span> <span
class="sb">`imagename`</span><span class="p">)</span> <span
class="n">VALUES</span> <span class="p">(</span><span class="mi">25</span><span
class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span
class="mi">1</span><span class="p">,</span> <span class="n">NOW</span><span
class="p">(),</span> <span class="mi">0</span><span class="p">,</span> <span
class="mi">1</span><span class="p">,</span> <span class="n">NULL</span><span cl
ass="p">,</span> <span class="s">'rhel5-base25-v0'</span><span
class="p">);</span>
+
+<span class="n">INSERT</span> <span class="n">INTO</span> <span
class="sb">`resource`</span> <span class="p">(</span><span
class="sb">`resourcetypeid`</span><span class="p">,</span> <span
class="sb">`subid`</span><span class="p">)</span> <span class="n">VALUES</span>
<span class="p">(</span><span class="mi">13</span><span class="p">,</span>
<span class="mi">25</span><span class="p">);</span>
+</pre></div>
+
+
+<p>Again, the xCAT template .tmpl file must match the the
+entry VCL database entry of image.name.</p>
+<p>VCL image.name = <strong>rhel5-base25-v0</strong><br>
+xCAT template file name = <strong>rhel5-base25-v0.tmpl</strong></p>
+<p>At this point you will be able to manage this image through the VCL
+interface.</p>
+<ul>
+<li>Go to Manage images</li>
+<li>Edit image grouping</li>
+<li>Select image group mapped to load onto your bare-metal blades. See
+<a href="docs/addcomputers.html">Add computers</a> if you have not added any
physical nodes
+yet.</li>
+<li>Add <strong>RHEL 5 base</strong> to the desired image group</li>
+</ul>
+<h2 id="testing-kickstart-file">Testing kickstart file</h2>
+<p>Test the load, by either making a reservation for the new
+environment or try to reload a physical node through manage computers
+computer utilities. Watch the vcld.log file to view the processing and to
+debug any issues that may occur.</p>
+<h2 id="extending-the-os-table">Extending the OS table</h2>
+<p>If VCL supports the OS, extending the OS table for a new OS is fairly
+straight forward. In this example we will use Red Hat 6.</p>
+<div class="codehilite"><pre><span class="n">INSERT</span> <span
class="n">INTO</span> <span class="sb">`OS`</span> <span
class="p">(</span><span class="sb">`name`</span><span class="p">,</span> <span
class="sb">`prettyname`</span><span class="p">,</span> <span
class="sb">`type`</span><span class="p">,</span> <span
class="sb">`installtype`</span><span class="p">,</span> <span
class="sb">`sourcepath`</span><span class="p">,</span> <span
class="sb">`moduleid`</span><span class="p">)</span> <span
class="n">VALUES</span> <span class="p">(</span><span
class="s">'rhel6'</span><span class="p">,</span><span
class="s">'RedHat Enterprise 6'</span><span class="p">,</span><span
class="s">'linux'</span><span class="p">,</span><span
class="s">'kickstart'</span><span class="p">,</span><span
class="s">'rhel6'</span><span class="p">,</span> <span
class="p">(</span><span class="n">SELECT</span> <span class="sb">`id`</span>
<span class="n">FROM</span> <s
pan class="sb">`module`</span> <span class="n">WHERE</span> <span
class="sb">`name`</span> <span class="n">LIKE</span> <span
class="s">'os_linux'</span><span class="p">));</span>
+</pre></div>
+ </div>
+
+ <div id="footer">
+ <div class="copyright">
+ <p>
+ Copyright © 2012 The Apache Software Foundation, Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache
License, Version 2.0</a>.
+ <br />
+ Apache and the Apache feather logo are trademarks of The Apache
Software Foundation.
+ </p>
+ </div>
+ </div>
+
+</body>
+</html>
