New lorax documentation - 25.2
This commit is contained in:
Brian C. Lane
parent
e12f6b8ede
commit
17e8cfa095
@ -1,4 +1,4 @@
|
||||
# Sphinx build info version 1
|
||||
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
|
||||
config: 7ed19a7584a3ae1b60c0542067c2ec16
|
||||
config: bc01a4daf0fbacf80c98f88c06e1c399
|
||||
tags: 645f666f9bcd5a90fca523b33c5a78b7
|
||||
|
||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>Overview: module code — Lorax 24.10 documentation</title>
|
||||
<title>Overview: module code — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="../index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="../index.html"/>
|
||||
|
||||
|
||||
<script src="../_static/js/modernizr.min.js"></script>
|
||||
@ -58,7 +58,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -132,6 +132,7 @@
|
||||
<ul><li><a href="pylorax.html">pylorax</a></li>
|
||||
<ul><li><a href="pylorax/base.html">pylorax.base</a></li>
|
||||
<li><a href="pylorax/buildstamp.html">pylorax.buildstamp</a></li>
|
||||
<li><a href="pylorax/cmdline.html">pylorax.cmdline</a></li>
|
||||
<li><a href="pylorax/decorators.html">pylorax.decorators</a></li>
|
||||
<li><a href="pylorax/discinfo.html">pylorax.discinfo</a></li>
|
||||
<li><a href="pylorax/dnfhelper.html">pylorax.dnfhelper</a></li>
|
||||
@ -176,7 +177,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'../',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>pylorax — Lorax 24.10 documentation</title>
|
||||
<title>pylorax — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="../index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="../index.html"/>
|
||||
<link rel="up" title="Module code" href="index.html"/>
|
||||
|
||||
|
||||
@ -59,7 +59,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -196,7 +196,7 @@
|
||||
<span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">buildarch</span><span class="p">):</span>
|
||||
<span class="nb">super</span><span class="p">(</span><span class="n">ArchData</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="n">__init__</span><span class="p">()</span>
|
||||
<span class="bp">self</span><span class="o">.</span><span class="n">buildarch</span> <span class="o">=</span> <span class="n">buildarch</span>
|
||||
<span class="bp">self</span><span class="o">.</span><span class="n">basearch</span> <span class="o">=</span> <span class="n">dnf</span><span class="o">.</span><span class="n">arch</span><span class="o">.</span><span class="n">basearch</span><span class="p">(</span><span class="n">buildarch</span><span class="p">)</span>
|
||||
<span class="bp">self</span><span class="o">.</span><span class="n">basearch</span> <span class="o">=</span> <span class="n">dnf</span><span class="o">.</span><span class="n">rpm</span><span class="o">.</span><span class="n">basearch</span><span class="p">(</span><span class="n">buildarch</span><span class="p">)</span>
|
||||
<span class="bp">self</span><span class="o">.</span><span class="n">libdir</span> <span class="o">=</span> <span class="s">"lib64"</span> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">basearch</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">lib64_arches</span> <span class="k">else</span> <span class="s">"lib"</span>
|
||||
<span class="bp">self</span><span class="o">.</span><span class="n">bcj</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">bcj_arch</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">basearch</span><span class="p">)</span>
|
||||
</div>
|
||||
@ -605,7 +605,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'../',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>pylorax.base — Lorax 24.10 documentation</title>
|
||||
<title>pylorax.base — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="../../index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="../../index.html"/>
|
||||
<link rel="up" title="pylorax" href="../pylorax.html"/>
|
||||
|
||||
|
||||
@ -59,7 +59,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -231,7 +231,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'../../',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>pylorax.buildstamp — Lorax 24.10 documentation</title>
|
||||
<title>pylorax.buildstamp — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="../../index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="../../index.html"/>
|
||||
<link rel="up" title="pylorax" href="../pylorax.html"/>
|
||||
|
||||
|
||||
@ -59,7 +59,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -225,7 +225,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'../../',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
483
docs/html/_modules/pylorax/cmdline.html
Normal file
483
docs/html/_modules/pylorax/cmdline.html
Normal file
@ -0,0 +1,483 @@
|
||||
|
||||
|
||||
<!DOCTYPE html>
|
||||
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
|
||||
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>pylorax.cmdline — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="../../index.html"/>
|
||||
<link rel="up" title="pylorax" href="../pylorax.html"/>
|
||||
|
||||
|
||||
<script src="../../_static/js/modernizr.min.js"></script>
|
||||
|
||||
</head>
|
||||
|
||||
<body class="wy-body-for-nav" role="document">
|
||||
|
||||
<div class="wy-grid-for-nav">
|
||||
|
||||
|
||||
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
|
||||
<div class="wy-side-scroll">
|
||||
<div class="wy-side-nav-search">
|
||||
|
||||
|
||||
|
||||
<a href="../../index.html" class="icon icon-home"> Lorax
|
||||
|
||||
|
||||
|
||||
</a>
|
||||
|
||||
|
||||
|
||||
|
||||
<div class="version">
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
|
||||
<div role="search">
|
||||
<form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
|
||||
<input type="text" name="q" placeholder="Search docs" />
|
||||
<input type="hidden" name="check_keywords" value="yes" />
|
||||
<input type="hidden" name="area" value="default" />
|
||||
</form>
|
||||
</div>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
|
||||
|
||||
|
||||
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../../intro.html">Introduction to Lorax</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../../intro.html#before-lorax">Before Lorax</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../../lorax.html">Lorax</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../../livemedia-creator.html">livemedia-creator</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../../product-images.html">Product and Updates Images</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../../modules.html">pylorax</a></li>
|
||||
</ul>
|
||||
|
||||
|
||||
|
||||
</div>
|
||||
</div>
|
||||
</nav>
|
||||
|
||||
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
|
||||
|
||||
|
||||
<nav class="wy-nav-top" role="navigation" aria-label="top navigation">
|
||||
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
|
||||
<a href="../../index.html">Lorax</a>
|
||||
</nav>
|
||||
|
||||
|
||||
|
||||
<div class="wy-nav-content">
|
||||
<div class="rst-content">
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
||||
<ul class="wy-breadcrumbs">
|
||||
<li><a href="../../index.html">Docs</a> »</li>
|
||||
|
||||
<li><a href="../index.html">Module code</a> »</li>
|
||||
|
||||
<li><a href="../pylorax.html">pylorax</a> »</li>
|
||||
|
||||
<li>pylorax.cmdline</li>
|
||||
<li class="wy-breadcrumbs-aside">
|
||||
|
||||
|
||||
|
||||
</li>
|
||||
</ul>
|
||||
<hr/>
|
||||
</div>
|
||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
||||
<div itemprop="articleBody">
|
||||
|
||||
<h1>Source code for pylorax.cmdline</h1><div class="highlight"><pre>
|
||||
<span class="c">#</span>
|
||||
<span class="c"># cmdline.py</span>
|
||||
<span class="c">#</span>
|
||||
<span class="c"># Copyright (C) 2016 Red Hat, Inc.</span>
|
||||
<span class="c">#</span>
|
||||
<span class="c"># This program is free software; you can redistribute it and/or modify</span>
|
||||
<span class="c"># it under the terms of the GNU General Public License as published by</span>
|
||||
<span class="c"># the Free Software Foundation; either version 2 of the License, or</span>
|
||||
<span class="c"># (at your option) any later version.</span>
|
||||
<span class="c">#</span>
|
||||
<span class="c"># This program is distributed in the hope that it will be useful,</span>
|
||||
<span class="c"># but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
|
||||
<span class="c"># MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the</span>
|
||||
<span class="c"># GNU General Public License for more details.</span>
|
||||
<span class="c">#</span>
|
||||
<span class="c"># You should have received a copy of the GNU General Public License</span>
|
||||
<span class="c"># along with this program. If not, see <http://www.gnu.org/licenses/>.</span>
|
||||
<span class="c">#</span>
|
||||
<span class="c"># Red Hat Author(s): Brian C. Lane <bcl@redhat.com></span>
|
||||
|
||||
<span class="kn">import</span> <span class="nn">os</span>
|
||||
<span class="kn">import</span> <span class="nn">sys</span>
|
||||
<span class="kn">import</span> <span class="nn">argparse</span>
|
||||
|
||||
<div class="viewcode-block" id="lorax_parser"><a class="viewcode-back" href="../../pylorax.html#pylorax.cmdline.lorax_parser">[docs]</a><span class="k">def</span> <span class="nf">lorax_parser</span><span class="p">():</span>
|
||||
<span class="sd">""" Return the ArgumentParser for lorax"""</span>
|
||||
|
||||
<span class="c"># get lorax version</span>
|
||||
<span class="k">try</span><span class="p">:</span>
|
||||
<span class="kn">from</span> <span class="nn">pylorax</span> <span class="kn">import</span> <span class="n">version</span>
|
||||
<span class="n">vernum</span> <span class="o">=</span> <span class="n">version</span><span class="o">.</span><span class="n">num</span>
|
||||
<span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
|
||||
<span class="n">vernum</span> <span class="o">=</span> <span class="s">"devel"</span>
|
||||
|
||||
<span class="n">version</span> <span class="o">=</span> <span class="s">"{0}-{1}"</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">basename</span><span class="p">(</span><span class="n">sys</span><span class="o">.</span><span class="n">argv</span><span class="p">[</span><span class="mi">0</span><span class="p">]),</span> <span class="n">vernum</span><span class="p">)</span>
|
||||
|
||||
<span class="n">parser</span> <span class="o">=</span> <span class="n">argparse</span><span class="o">.</span><span class="n">ArgumentParser</span><span class="p">(</span><span class="n">description</span><span class="o">=</span><span class="s">"Create the Anaconda boot.iso"</span><span class="p">)</span>
|
||||
|
||||
<span class="c"># required arguments for image creation</span>
|
||||
<span class="n">required</span> <span class="o">=</span> <span class="n">parser</span><span class="o">.</span><span class="n">add_argument_group</span><span class="p">(</span><span class="s">"required arguments"</span><span class="p">)</span>
|
||||
<span class="n">required</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"-p"</span><span class="p">,</span> <span class="s">"--product"</span><span class="p">,</span> <span class="n">help</span><span class="o">=</span><span class="s">"product name"</span><span class="p">,</span> <span class="n">required</span><span class="o">=</span><span class="bp">True</span><span class="p">,</span> <span class="n">metavar</span><span class="o">=</span><span class="s">"PRODUCT"</span><span class="p">)</span>
|
||||
<span class="n">required</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"-v"</span><span class="p">,</span> <span class="s">"--version"</span><span class="p">,</span> <span class="n">help</span><span class="o">=</span><span class="s">"version identifier"</span><span class="p">,</span> <span class="n">required</span><span class="o">=</span><span class="bp">True</span><span class="p">,</span> <span class="n">metavar</span><span class="o">=</span><span class="s">"VERSION"</span><span class="p">)</span>
|
||||
<span class="n">required</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"-r"</span><span class="p">,</span> <span class="s">"--release"</span><span class="p">,</span> <span class="n">help</span><span class="o">=</span><span class="s">"release information"</span><span class="p">,</span> <span class="n">required</span><span class="o">=</span><span class="bp">True</span><span class="p">,</span> <span class="n">metavar</span><span class="o">=</span><span class="s">"RELEASE"</span><span class="p">)</span>
|
||||
<span class="n">required</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"-s"</span><span class="p">,</span> <span class="s">"--source"</span><span class="p">,</span> <span class="n">help</span><span class="o">=</span><span class="s">"source repository (may be listed multiple times)"</span><span class="p">,</span>
|
||||
<span class="n">metavar</span><span class="o">=</span><span class="s">"REPOSITORY"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"append"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="p">[])</span>
|
||||
<span class="n">required</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--repo"</span><span class="p">,</span> <span class="n">help</span><span class="o">=</span><span class="s">"source dnf repository file"</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">,</span>
|
||||
<span class="n">dest</span><span class="o">=</span><span class="s">"repos"</span><span class="p">,</span> <span class="n">metavar</span><span class="o">=</span><span class="s">"REPOSITORY"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"append"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="p">[])</span>
|
||||
|
||||
<span class="c"># optional arguments</span>
|
||||
<span class="n">optional</span> <span class="o">=</span> <span class="n">parser</span><span class="o">.</span><span class="n">add_argument_group</span><span class="p">(</span><span class="s">"optional arguments"</span><span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"-m"</span><span class="p">,</span> <span class="s">"--mirrorlist"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"mirrorlist repository (may be listed multiple times)"</span><span class="p">,</span>
|
||||
<span class="n">metavar</span><span class="o">=</span><span class="s">"REPOSITORY"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"append"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="p">[])</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"-t"</span><span class="p">,</span> <span class="s">"--variant"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"variant name"</span><span class="p">,</span> <span class="n">metavar</span><span class="o">=</span><span class="s">"VARIANT"</span><span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"-b"</span><span class="p">,</span> <span class="s">"--bugurl"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"bug reporting URL for the product"</span><span class="p">,</span> <span class="n">metavar</span><span class="o">=</span><span class="s">"URL"</span><span class="p">,</span>
|
||||
<span class="n">default</span><span class="o">=</span><span class="s">"your distribution provided bug reporting tool"</span><span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--isfinal"</span><span class="p">,</span> <span class="n">help</span><span class="o">=</span><span class="s">""</span><span class="p">,</span>
|
||||
<span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">False</span><span class="p">,</span> <span class="n">dest</span><span class="o">=</span><span class="s">"isfinal"</span><span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"-c"</span><span class="p">,</span> <span class="s">"--config"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="s">"/etc/lorax/lorax.conf"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"config file"</span><span class="p">,</span> <span class="n">metavar</span><span class="o">=</span><span class="s">"CONFIGFILE"</span><span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--proxy"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"repo proxy url:port"</span><span class="p">,</span> <span class="n">metavar</span><span class="o">=</span><span class="s">"HOST"</span><span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"-i"</span><span class="p">,</span> <span class="s">"--installpkgs"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="p">[],</span>
|
||||
<span class="n">action</span><span class="o">=</span><span class="s">"append"</span><span class="p">,</span> <span class="n">metavar</span><span class="o">=</span><span class="s">"PACKAGE"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"package glob to install before runtime-install.tmpl runs. (may be listed multiple times)"</span><span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--buildarch"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"build architecture"</span><span class="p">,</span> <span class="n">metavar</span><span class="o">=</span><span class="s">"ARCH"</span><span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--volid"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"volume id"</span><span class="p">,</span> <span class="n">metavar</span><span class="o">=</span><span class="s">"VOLID"</span><span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--macboot"</span><span class="p">,</span> <span class="n">help</span><span class="o">=</span><span class="s">""</span><span class="p">,</span>
|
||||
<span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">True</span><span class="p">,</span> <span class="n">dest</span><span class="o">=</span><span class="s">"domacboot"</span><span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--nomacboot"</span><span class="p">,</span> <span class="n">help</span><span class="o">=</span><span class="s">""</span><span class="p">,</span>
|
||||
<span class="n">action</span><span class="o">=</span><span class="s">"store_false"</span><span class="p">,</span> <span class="n">dest</span><span class="o">=</span><span class="s">"domacboot"</span><span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--noupgrade"</span><span class="p">,</span> <span class="n">help</span><span class="o">=</span><span class="s">""</span><span class="p">,</span>
|
||||
<span class="n">action</span><span class="o">=</span><span class="s">"store_false"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">True</span><span class="p">,</span> <span class="n">dest</span><span class="o">=</span><span class="s">"doupgrade"</span><span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--logfile"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="s">"./lorax.log"</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Path to logfile"</span><span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--tmp"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="s">"/var/tmp"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Top level temporary directory"</span> <span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--cachedir"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"DNF cache directory. Default is a temporary dir."</span><span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--workdir"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Work directory, overrides --tmp. Default is a temporary dir under /var/tmp"</span><span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--force"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">False</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Run even when the destination directory exists"</span><span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--add-template"</span><span class="p">,</span> <span class="n">dest</span><span class="o">=</span><span class="s">"add_templates"</span><span class="p">,</span>
|
||||
<span class="n">action</span><span class="o">=</span><span class="s">"append"</span><span class="p">,</span> <span class="n">help</span><span class="o">=</span><span class="s">"Additional template for runtime image"</span><span class="p">,</span>
|
||||
<span class="n">default</span><span class="o">=</span><span class="p">[])</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--add-template-var"</span><span class="p">,</span> <span class="n">dest</span><span class="o">=</span><span class="s">"add_template_vars"</span><span class="p">,</span>
|
||||
<span class="n">action</span><span class="o">=</span><span class="s">"append"</span><span class="p">,</span> <span class="n">help</span><span class="o">=</span><span class="s">"Set variable for runtime image template"</span><span class="p">,</span>
|
||||
<span class="n">default</span><span class="o">=</span><span class="p">[])</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--add-arch-template"</span><span class="p">,</span> <span class="n">dest</span><span class="o">=</span><span class="s">"add_arch_templates"</span><span class="p">,</span>
|
||||
<span class="n">action</span><span class="o">=</span><span class="s">"append"</span><span class="p">,</span> <span class="n">help</span><span class="o">=</span><span class="s">"Additional template for architecture-specific image"</span><span class="p">,</span>
|
||||
<span class="n">default</span><span class="o">=</span><span class="p">[])</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--add-arch-template-var"</span><span class="p">,</span> <span class="n">dest</span><span class="o">=</span><span class="s">"add_arch_template_vars"</span><span class="p">,</span>
|
||||
<span class="n">action</span><span class="o">=</span><span class="s">"append"</span><span class="p">,</span> <span class="n">help</span><span class="o">=</span><span class="s">"Set variable for architecture-specific image"</span><span class="p">,</span>
|
||||
<span class="n">default</span><span class="o">=</span><span class="p">[])</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--noverify"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_false"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">True</span><span class="p">,</span> <span class="n">dest</span><span class="o">=</span><span class="s">"verify"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Do not verify the install root"</span><span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--sharedir"</span><span class="p">,</span> <span class="n">metavar</span><span class="o">=</span><span class="s">"SHAREDIR"</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Directory containing all the templates. Overrides config file sharedir"</span><span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--enablerepo"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"append"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="p">[],</span> <span class="n">dest</span><span class="o">=</span><span class="s">"enablerepos"</span><span class="p">,</span>
|
||||
<span class="n">metavar</span><span class="o">=</span><span class="s">"[repo]"</span><span class="p">,</span> <span class="n">help</span><span class="o">=</span><span class="s">"Names of repos to enable"</span><span class="p">)</span>
|
||||
<span class="n">optional</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--disablerepo"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"append"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="p">[],</span> <span class="n">dest</span><span class="o">=</span><span class="s">"disablerepos"</span><span class="p">,</span>
|
||||
<span class="n">metavar</span><span class="o">=</span><span class="s">"[repo]"</span><span class="p">,</span> <span class="n">help</span><span class="o">=</span><span class="s">"Names of repos to disable"</span><span class="p">)</span>
|
||||
|
||||
<span class="c"># add the show version option</span>
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"-V"</span><span class="p">,</span> <span class="n">help</span><span class="o">=</span><span class="s">"show program's version number and exit"</span><span class="p">,</span>
|
||||
<span class="n">action</span><span class="o">=</span><span class="s">"version"</span><span class="p">,</span> <span class="n">version</span><span class="o">=</span><span class="n">version</span><span class="p">)</span>
|
||||
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"outputdir"</span><span class="p">,</span> <span class="n">help</span><span class="o">=</span><span class="s">"Output directory"</span><span class="p">,</span> <span class="n">metavar</span><span class="o">=</span><span class="s">"OUTPUTDIR"</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">)</span>
|
||||
|
||||
<span class="k">return</span> <span class="n">parser</span>
|
||||
|
||||
</div>
|
||||
<div class="viewcode-block" id="lmc_parser"><a class="viewcode-back" href="../../pylorax.html#pylorax.cmdline.lmc_parser">[docs]</a><span class="k">def</span> <span class="nf">lmc_parser</span><span class="p">(</span><span class="n">dracut_default</span><span class="o">=</span><span class="s">""</span><span class="p">):</span>
|
||||
<span class="sd">""" Return a ArgumentParser object for live-media-creator."""</span>
|
||||
<span class="n">parser</span> <span class="o">=</span> <span class="n">argparse</span><span class="o">.</span><span class="n">ArgumentParser</span><span class="p">(</span><span class="n">description</span><span class="o">=</span><span class="s">"Create Live Install Media"</span><span class="p">,</span>
|
||||
<span class="n">fromfile_prefix_chars</span><span class="o">=</span><span class="s">"@"</span><span class="p">)</span>
|
||||
|
||||
<span class="c"># These are mutually exclusive, one is required</span>
|
||||
<span class="n">action</span> <span class="o">=</span> <span class="n">parser</span><span class="o">.</span><span class="n">add_mutually_exclusive_group</span><span class="p">(</span><span class="n">required</span><span class="o">=</span><span class="bp">True</span><span class="p">)</span>
|
||||
<span class="n">action</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--make-iso"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Build a live iso"</span><span class="p">)</span>
|
||||
<span class="n">action</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--make-disk"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Build a partitioned disk image"</span><span class="p">)</span>
|
||||
<span class="n">action</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--make-fsimage"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Build a filesystem image"</span><span class="p">)</span>
|
||||
<span class="n">action</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--make-appliance"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Build an appliance image and XML description"</span><span class="p">)</span>
|
||||
<span class="n">action</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--make-ami"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Build an ami image"</span><span class="p">)</span>
|
||||
<span class="n">action</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--make-tar"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Build a tar of the root filesystem"</span><span class="p">)</span>
|
||||
<span class="n">action</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--make-pxe-live"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Build a live pxe boot squashfs image"</span><span class="p">)</span>
|
||||
<span class="n">action</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--make-ostree-live"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Build a live pxe boot squashfs image of Atomic Host"</span><span class="p">)</span>
|
||||
<span class="n">action</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--make-oci"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Build an Open Container Initiative image"</span><span class="p">)</span>
|
||||
<span class="n">action</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--make-vagrant"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Build a Vagrant Box image"</span><span class="p">)</span>
|
||||
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--iso"</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Anaconda installation .iso path to use for qemu"</span><span class="p">)</span>
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--iso-only"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Remove all iso creation artifacts except the boot.iso, "</span>
|
||||
<span class="s">"combine with --iso-name to rename the boot.iso"</span><span class="p">)</span>
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--iso-name"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Name of output iso file for --iso-only. Default is boot.iso"</span><span class="p">)</span>
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--ks"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"append"</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Kickstart file defining the install."</span><span class="p">)</span>
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--image-only"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Exit after creating fs/disk image."</span><span class="p">)</span>
|
||||
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--no-virt"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Run anaconda directly on host instead of using qemu"</span><span class="p">)</span>
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--proxy"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"proxy URL to use for the install"</span><span class="p">)</span>
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--anaconda-arg"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"append"</span><span class="p">,</span> <span class="n">dest</span><span class="o">=</span><span class="s">"anaconda_args"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Additional argument to pass to anaconda (no-virt "</span>
|
||||
<span class="s">"mode). Pass once for each argument"</span><span class="p">)</span>
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--armplatform"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"the platform to use when creating images for ARM, "</span>
|
||||
<span class="s">"i.e., highbank, mvebu, omap, tegra, etc."</span><span class="p">)</span>
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--location"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"location of iso directory tree with initrd.img "</span>
|
||||
<span class="s">"and vmlinuz. Used to run qemu with a newer initrd "</span>
|
||||
<span class="s">"than the iso."</span><span class="p">)</span>
|
||||
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--logfile"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="s">"./livemedia.log"</span><span class="p">,</span>
|
||||
<span class="nb">type</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Name and path for primary logfile, other logs will "</span>
|
||||
<span class="s">"be created in the same directory."</span><span class="p">)</span>
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--lorax-templates"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span>
|
||||
<span class="nb">type</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Path to mako templates for lorax"</span><span class="p">)</span>
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--tmp"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="s">"/var/tmp"</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Top level temporary directory"</span><span class="p">)</span>
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--resultdir"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="n">dest</span><span class="o">=</span><span class="s">"result_dir"</span><span class="p">,</span>
|
||||
<span class="nb">type</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Directory to copy the resulting images and iso into. "</span>
|
||||
<span class="s">"Defaults to the temporary working directory"</span><span class="p">)</span>
|
||||
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--macboot"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">True</span><span class="p">,</span>
|
||||
<span class="n">dest</span><span class="o">=</span><span class="s">"domacboot"</span><span class="p">)</span>
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--nomacboot"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_false"</span><span class="p">,</span>
|
||||
<span class="n">dest</span><span class="o">=</span><span class="s">"domacboot"</span><span class="p">)</span>
|
||||
|
||||
<span class="n">image_group</span> <span class="o">=</span> <span class="n">parser</span><span class="o">.</span><span class="n">add_argument_group</span><span class="p">(</span><span class="s">"disk/fs image arguments"</span><span class="p">)</span>
|
||||
<span class="n">image_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--disk-image"</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Path to existing disk image to use for creating final image."</span><span class="p">)</span>
|
||||
<span class="n">image_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--keep-image"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Keep raw disk image after .iso creation"</span><span class="p">)</span>
|
||||
<span class="n">image_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--fs-image"</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">abspath</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Path to existing filesystem image to use for creating final image."</span><span class="p">)</span>
|
||||
<span class="n">image_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--image-name"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Name of output file to create. Used for tar, fs and disk image. Default is a random name."</span><span class="p">)</span>
|
||||
<span class="n">image_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--fs-label"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="s">"Anaconda"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Label to set on fsimage, default is 'Anaconda'"</span><span class="p">)</span>
|
||||
<span class="n">image_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--image-type"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Create an image with qemu-img. See qemu-img --help for supported formats."</span><span class="p">)</span>
|
||||
<span class="n">image_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--qemu-arg"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"append"</span><span class="p">,</span> <span class="n">dest</span><span class="o">=</span><span class="s">"qemu_args"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="p">[],</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Arguments to pass to qemu-img. Pass once for each argument, they will be used for ALL calls to qemu-img."</span><span class="p">)</span>
|
||||
<span class="n">image_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--qcow2"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Create qcow2 image instead of raw sparse image when making disk images."</span><span class="p">)</span>
|
||||
<span class="n">image_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--qcow2-arg"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"append"</span><span class="p">,</span> <span class="n">dest</span><span class="o">=</span><span class="s">"qemu_args"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="p">[],</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Arguments to pass to qemu-img. Pass once for each argument, they will be used for ALL calls to qemu-img."</span><span class="p">)</span>
|
||||
<span class="n">image_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--compression"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="s">"xz"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Compression binary for make-tar. xz, lzma, gzip, and bzip2 are supported. xz is the default."</span><span class="p">)</span>
|
||||
<span class="n">image_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--compress-arg"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"append"</span><span class="p">,</span> <span class="n">dest</span><span class="o">=</span><span class="s">"compress_args"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="p">[],</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Arguments to pass to compression. Pass once for each argument"</span><span class="p">)</span>
|
||||
<span class="c"># Group of arguments for appliance creation</span>
|
||||
<span class="n">app_group</span> <span class="o">=</span> <span class="n">parser</span><span class="o">.</span><span class="n">add_argument_group</span><span class="p">(</span><span class="s">"appliance arguments"</span><span class="p">)</span>
|
||||
<span class="n">app_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--app-name"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Name of appliance to pass to template"</span><span class="p">)</span>
|
||||
<span class="n">app_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--app-template"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Path to template to use for appliance data."</span><span class="p">)</span>
|
||||
<span class="n">app_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--app-file"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="s">"appliance.xml"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Appliance template results file."</span><span class="p">)</span>
|
||||
|
||||
<span class="c"># Group of arguments to pass to qemu</span>
|
||||
<span class="n">virt_group</span> <span class="o">=</span> <span class="n">parser</span><span class="o">.</span><span class="n">add_argument_group</span><span class="p">(</span><span class="s">"qemu arguments"</span><span class="p">)</span>
|
||||
<span class="n">virt_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--ram"</span><span class="p">,</span> <span class="n">metavar</span><span class="o">=</span><span class="s">"MEMORY"</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="nb">int</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="mi">1024</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Memory to allocate for installer in megabytes."</span><span class="p">)</span>
|
||||
<span class="n">virt_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--vcpus"</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="nb">int</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Passed to qemu -smp command"</span><span class="p">)</span>
|
||||
<span class="n">virt_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--vnc"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Passed to qemu -display command. eg. vnc=127.0.0.1:5, default is to "</span>
|
||||
<span class="s">"choose the first unused vnc port."</span><span class="p">)</span>
|
||||
<span class="n">virt_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--arch"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"System arch to build for. Used to select qemu-system-* command. "</span>
|
||||
<span class="s">"Defaults to qemu-system-<arch>"</span><span class="p">)</span>
|
||||
<span class="n">virt_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--kernel-args"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Additional argument to pass to the installation kernel"</span><span class="p">)</span>
|
||||
<span class="n">virt_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--ovmf-path"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="s">"/usr/share/OVMF/"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Path to OVMF firmware"</span><span class="p">)</span>
|
||||
<span class="n">virt_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--virt-uefi"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">False</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Use OVMF firmware to boot the VM in UEFI mode"</span><span class="p">)</span>
|
||||
<span class="n">virt_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--no-kvm"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">False</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Skip using kvm with qemu even if it is available."</span><span class="p">)</span>
|
||||
|
||||
<span class="c"># dracut arguments</span>
|
||||
<span class="n">dracut_group</span> <span class="o">=</span> <span class="n">parser</span><span class="o">.</span><span class="n">add_argument_group</span><span class="p">(</span><span class="s">"dracut arguments"</span><span class="p">)</span>
|
||||
<span class="n">dracut_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--dracut-arg"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"append"</span><span class="p">,</span> <span class="n">dest</span><span class="o">=</span><span class="s">"dracut_args"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Argument to pass to dracut when "</span>
|
||||
<span class="s">"rebuilding the initramfs. Pass this "</span>
|
||||
<span class="s">"once for each argument. NOTE: this "</span>
|
||||
<span class="s">"overrides the default. (default: </span><span class="si">%s</span><span class="s">)"</span> <span class="o">%</span> <span class="n">dracut_default</span><span class="p">)</span>
|
||||
|
||||
<span class="c"># pxe to live arguments</span>
|
||||
<span class="n">pxelive_group</span> <span class="o">=</span> <span class="n">parser</span><span class="o">.</span><span class="n">add_argument_group</span><span class="p">(</span><span class="s">"pxe to live arguments"</span><span class="p">)</span>
|
||||
<span class="n">pxelive_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--live-rootfs-size"</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="nb">int</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Size of root filesystem of live image in GiB"</span><span class="p">)</span>
|
||||
<span class="n">pxelive_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--live-rootfs-keep-size"</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">"store_true"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Keep the original size of root filesystem in live image"</span><span class="p">)</span>
|
||||
|
||||
<span class="c"># OCI specific commands</span>
|
||||
<span class="n">oci_group</span> <span class="o">=</span> <span class="n">parser</span><span class="o">.</span><span class="n">add_argument_group</span><span class="p">(</span><span class="s">"OCI arguments"</span><span class="p">)</span>
|
||||
<span class="n">oci_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--oci-config"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"config.json OCI configuration file"</span><span class="p">)</span>
|
||||
<span class="n">oci_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--oci-runtime"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"runtime.json OCI configuration file"</span><span class="p">)</span>
|
||||
|
||||
<span class="c"># Vagrant specific commands</span>
|
||||
<span class="n">vagrant_group</span> <span class="o">=</span> <span class="n">parser</span><span class="o">.</span><span class="n">add_argument_group</span><span class="p">(</span><span class="s">"Vagrant arguments"</span><span class="p">)</span>
|
||||
<span class="n">vagrant_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--vagrant-metadata"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"optional metadata.json file"</span><span class="p">)</span>
|
||||
<span class="n">vagrant_group</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--vagrantfile"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"optional vagrantfile"</span><span class="p">)</span>
|
||||
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--title"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="s">"Linux Live Media"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Substituted for @TITLE@ in bootloader config files"</span><span class="p">)</span>
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--project"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="s">"Linux"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"substituted for @PROJECT@ in bootloader config files"</span><span class="p">)</span>
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--releasever"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="s">"25"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"substituted for @VERSION@ in bootloader config files"</span><span class="p">)</span>
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--volid"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="n">help</span><span class="o">=</span><span class="s">"volume id"</span><span class="p">)</span>
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--squashfs_args"</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"additional squashfs args"</span><span class="p">)</span>
|
||||
<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span><span class="s">"--timeout"</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="bp">None</span><span class="p">,</span> <span class="nb">type</span><span class="o">=</span><span class="nb">int</span><span class="p">,</span>
|
||||
<span class="n">help</span><span class="o">=</span><span class="s">"Cancel installer after X minutes"</span><span class="p">)</span>
|
||||
|
||||
<span class="k">return</span> <span class="n">parser</span></div>
|
||||
</pre></div>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
<footer>
|
||||
|
||||
|
||||
<hr/>
|
||||
|
||||
<div role="contentinfo">
|
||||
<p>
|
||||
© Copyright 2015, Red Hat, Inc..
|
||||
|
||||
</p>
|
||||
</div>
|
||||
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
|
||||
|
||||
</footer>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</section>
|
||||
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'../../',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
};
|
||||
</script>
|
||||
<script type="text/javascript" src="../../_static/jquery.js"></script>
|
||||
<script type="text/javascript" src="../../_static/underscore.js"></script>
|
||||
<script type="text/javascript" src="../../_static/doctools.js"></script>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript" src="../../_static/js/theme.js"></script>
|
||||
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
jQuery(function () {
|
||||
SphinxRtdTheme.StickyNav.enable();
|
||||
});
|
||||
</script>
|
||||
|
||||
|
||||
</body>
|
||||
</html>
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>pylorax.decorators — Lorax 24.10 documentation</title>
|
||||
<title>pylorax.decorators — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="../../index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="../../index.html"/>
|
||||
<link rel="up" title="pylorax" href="../pylorax.html"/>
|
||||
|
||||
|
||||
@ -59,7 +59,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -197,7 +197,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'../../',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>pylorax.discinfo — Lorax 24.10 documentation</title>
|
||||
<title>pylorax.discinfo — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="../../index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="../../index.html"/>
|
||||
<link rel="up" title="pylorax" href="../pylorax.html"/>
|
||||
|
||||
|
||||
@ -59,7 +59,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -206,7 +206,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'../../',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>pylorax.dnfhelper — Lorax 24.10 documentation</title>
|
||||
<title>pylorax.dnfhelper — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="../../index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="../../index.html"/>
|
||||
<link rel="up" title="pylorax" href="../pylorax.html"/>
|
||||
|
||||
|
||||
@ -59,7 +59,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -274,7 +274,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'../../',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>pylorax.executils — Lorax 24.10 documentation</title>
|
||||
<title>pylorax.executils — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="../../index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="../../index.html"/>
|
||||
<link rel="up" title="pylorax" href="../pylorax.html"/>
|
||||
|
||||
|
||||
@ -59,7 +59,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -289,6 +289,8 @@
|
||||
<span class="n">env_prune</span><span class="o">=</span><span class="n">env_prune</span><span class="p">,</span> <span class="n">universal_newlines</span><span class="o">=</span><span class="ow">not</span> <span class="n">binary_output</span><span class="p">,</span>
|
||||
<span class="n">env_add</span><span class="o">=</span><span class="n">env_add</span><span class="p">,</span> <span class="n">reset_handlers</span><span class="o">=</span><span class="n">reset_handlers</span><span class="p">,</span> <span class="n">reset_lang</span><span class="o">=</span><span class="n">reset_lang</span><span class="p">)</span>
|
||||
|
||||
<span class="n">output_string</span> <span class="o">=</span> <span class="bp">None</span>
|
||||
<span class="n">err_string</span> <span class="o">=</span> <span class="bp">None</span>
|
||||
<span class="k">if</span> <span class="n">callback</span><span class="p">:</span>
|
||||
<span class="k">while</span> <span class="n">callback</span><span class="p">(</span><span class="n">proc</span><span class="p">)</span> <span class="ow">and</span> <span class="n">proc</span><span class="o">.</span><span class="n">poll</span><span class="p">()</span> <span class="ow">is</span> <span class="bp">None</span><span class="p">:</span>
|
||||
<span class="k">try</span><span class="p">:</span>
|
||||
@ -328,7 +330,7 @@
|
||||
<span class="k">raise</span>
|
||||
|
||||
<span class="k">with</span> <span class="n">program_log_lock</span><span class="p">:</span>
|
||||
<span class="n">program_log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Return code: </span><span class="si">%d</span><span class="s">"</span><span class="p">,</span> <span class="n">proc</span><span class="o">.</span><span class="n">returncode</span><span class="p">)</span>
|
||||
<span class="n">program_log</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s">"Return code: </span><span class="si">%s</span><span class="s">"</span><span class="p">,</span> <span class="n">proc</span><span class="o">.</span><span class="n">returncode</span><span class="p">)</span>
|
||||
|
||||
<span class="k">if</span> <span class="n">proc</span><span class="o">.</span><span class="n">returncode</span> <span class="ow">and</span> <span class="n">raise_err</span><span class="p">:</span>
|
||||
<span class="n">output</span> <span class="o">=</span> <span class="p">(</span><span class="n">output_string</span> <span class="ow">or</span> <span class="s">""</span><span class="p">)</span> <span class="o">+</span> <span class="p">(</span><span class="n">err_string</span> <span class="ow">or</span> <span class="s">""</span><span class="p">)</span>
|
||||
@ -512,7 +514,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'../../',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>pylorax.imgutils — Lorax 24.10 documentation</title>
|
||||
<title>pylorax.imgutils — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="../../index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="../../index.html"/>
|
||||
<link rel="up" title="pylorax" href="../pylorax.html"/>
|
||||
|
||||
|
||||
@ -59,7 +59,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -417,6 +417,7 @@
|
||||
<span class="n">total</span> <span class="o">+=</span> <span class="n">round_to_blocks</span><span class="p">(</span><span class="n">getsize</span><span class="p">(</span><span class="n">join</span><span class="p">(</span><span class="n">top</span><span class="p">,</span><span class="n">f</span><span class="p">)),</span> <span class="n">blocksize</span><span class="p">)</span>
|
||||
<span class="k">if</span> <span class="n">fstype</span> <span class="o">==</span> <span class="s">"btrfs"</span><span class="p">:</span>
|
||||
<span class="n">total</span> <span class="o">=</span> <span class="nb">max</span><span class="p">(</span><span class="mi">256</span><span class="o">*</span><span class="mi">1024</span><span class="o">*</span><span class="mi">1024</span><span class="p">,</span> <span class="n">total</span><span class="p">)</span> <span class="c"># btrfs minimum size: 256MB</span>
|
||||
<span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s">"Size of </span><span class="si">%s</span><span class="s"> block </span><span class="si">%s</span><span class="s"> fs at </span><span class="si">%s</span><span class="s"> estimated to be </span><span class="si">%s</span><span class="s">"</span><span class="p">,</span> <span class="n">blocksize</span><span class="p">,</span> <span class="n">fstype</span><span class="p">,</span> <span class="n">rootdir</span><span class="p">,</span> <span class="n">total</span><span class="p">)</span>
|
||||
<span class="k">return</span> <span class="n">total</span>
|
||||
|
||||
<span class="c">######## Execution contexts - use with the 'with' statement ##############</span>
|
||||
@ -617,7 +618,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'../../',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>pylorax.ltmpl — Lorax 24.10 documentation</title>
|
||||
<title>pylorax.ltmpl — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="../../index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="../../index.html"/>
|
||||
<link rel="up" title="pylorax" href="../pylorax.html"/>
|
||||
|
||||
|
||||
@ -59,7 +59,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -872,7 +872,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'../../',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>pylorax.monitor — Lorax 24.10 documentation</title>
|
||||
<title>pylorax.monitor — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="../../index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="../../index.html"/>
|
||||
<link rel="up" title="pylorax" href="../pylorax.html"/>
|
||||
|
||||
|
||||
@ -59,7 +59,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -359,7 +359,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'../../',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>pylorax.mount — Lorax 24.10 documentation</title>
|
||||
<title>pylorax.mount — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="../../index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="../../index.html"/>
|
||||
<link rel="up" title="pylorax" href="../pylorax.html"/>
|
||||
|
||||
|
||||
@ -59,7 +59,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -263,7 +263,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'../../',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>pylorax.sysutils — Lorax 24.10 documentation</title>
|
||||
<title>pylorax.sysutils — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="../../index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="../../index.html"/>
|
||||
<link rel="up" title="pylorax" href="../pylorax.html"/>
|
||||
|
||||
|
||||
@ -59,7 +59,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -275,7 +275,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'../../',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>pylorax.treebuilder — Lorax 24.10 documentation</title>
|
||||
<title>pylorax.treebuilder — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="../../index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="../../index.html"/>
|
||||
<link rel="up" title="pylorax" href="../pylorax.html"/>
|
||||
|
||||
|
||||
@ -59,7 +59,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -556,7 +556,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'../../',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>pylorax.treeinfo — Lorax 24.10 documentation</title>
|
||||
<title>pylorax.treeinfo — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="../../index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="../../index.html"/>
|
||||
<link rel="up" title="pylorax" href="../pylorax.html"/>
|
||||
|
||||
|
||||
@ -59,7 +59,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -224,7 +224,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'../../',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -12,8 +12,8 @@ isos, bootable (partitioned) disk images, tarfiles, and filesystem images for
|
||||
use with virtualization and container solutions like libvirt, docker, and
|
||||
OpenStack.
|
||||
|
||||
The general idea is to use virt-install with kickstart and an Anaconda boot.iso
|
||||
to install into a disk image and then use the disk image to create the bootable
|
||||
The general idea is to use qemu with kickstart and an Anaconda boot.iso to
|
||||
install into a disk image and then use the disk image to create the bootable
|
||||
media.
|
||||
|
||||
livemedia-creator --help will describe all of the options available. At the
|
||||
@ -21,19 +21,14 @@ minimum you need:
|
||||
|
||||
``--make-iso`` to create a final bootable .iso or one of the other ``--make-*`` options.
|
||||
|
||||
``--iso`` to specify the Anaconda install media to use with virt-install
|
||||
``--iso`` to specify the Anaconda install media to use with qemu.
|
||||
|
||||
``--ks`` to select the kickstart file describing what to install.
|
||||
|
||||
To use livemedia-creator with virt-install you will need to install the
|
||||
following packages, as well as have libvirtd setup correctly.
|
||||
|
||||
* ``virt-install``
|
||||
* ``libvirt-python``
|
||||
To use livemedia-creator with virtualization you will need to have qemu installed.
|
||||
|
||||
If you are going to be using Anaconda directly, with ``--no-virt`` mode, make sure
|
||||
you have the anaconda package installed. You can use the anaconda-tui package
|
||||
to save a bit of space on the build system.
|
||||
you have the anaconda-tui package installed.
|
||||
|
||||
Conventions used in this document:
|
||||
|
||||
@ -44,6 +39,14 @@ Conventions used in this document:
|
||||
``image`` is the disk image being created by running livemedia-creator
|
||||
|
||||
|
||||
livemedia-creator cmdline arguments
|
||||
-----------------------------------
|
||||
|
||||
.. argparse::
|
||||
:ref: pylorax.cmdline.lmc_parser
|
||||
:prog: livemedia-creator
|
||||
|
||||
|
||||
Quickstart
|
||||
----------
|
||||
|
||||
@ -58,8 +61,8 @@ You can run it directly from the lorax git repo like this::
|
||||
--make-iso --iso=/extra/iso/boot.iso \
|
||||
--ks=./docs/fedora-livemedia.ks --lorax-templates=./share/
|
||||
|
||||
If you want to watch the install you can pass ``--vnc vnc`` and use a vnc client
|
||||
to connect to localhost:0
|
||||
You can observe the installation using vnc. The logs will show what port was
|
||||
chosen, or you can use a specific port by passing it. eg. ``--vnc vnc:127.0.0.1:5``
|
||||
|
||||
This is usually a good idea when testing changes to the kickstart. lmc tries
|
||||
to monitor the logs for fatal errors, but may not catch everything.
|
||||
@ -74,7 +77,7 @@ Normally you would run both stages, but it is possible to stop after the
|
||||
install stage, by using ``--image-only``, or to skip the install stage and use
|
||||
a previously created disk image by passing ``--disk-image`` or ``--fs-image``
|
||||
|
||||
When creating an iso virt-install boots using the passed Anaconda installer iso
|
||||
When creating an iso qemu boots using the passed Anaconda installer iso
|
||||
and installs the system based on the kickstart. The ``%post`` section of the
|
||||
kickstart is used to customize the installed system in the same way that
|
||||
current spin-kickstarts do.
|
||||
@ -82,24 +85,22 @@ current spin-kickstarts do.
|
||||
livemedia-creator monitors the install process for problems by watching the
|
||||
install logs. They are written to the current directory or to the base
|
||||
directory specified by the --logfile command. You can also monitor the install
|
||||
by passing ``--vnc vnc`` and using a vnc client. This is recommended when first
|
||||
modifying a kickstart, since there are still places where Anaconda may get
|
||||
stuck without the log monitor catching it.
|
||||
by using a vnc client. This is recommended when first modifying a kickstart,
|
||||
since there are still places where Anaconda may get stuck without the log
|
||||
monitor catching it.
|
||||
|
||||
The output from this process is a partitioned disk image. kpartx can be used
|
||||
to mount and examine it when there is a problem with the install. It can also
|
||||
be booted using kvm.
|
||||
|
||||
When creating an iso the disk image's / partition is copied into a formatted
|
||||
disk image which is then used as the input to lorax for creation of the final
|
||||
media.
|
||||
filesystem image which is then used as the input to lorax for creation of the
|
||||
final media.
|
||||
|
||||
The final image is created by lorax, using the templates in /usr/share/lorax/
|
||||
or the directory specified by ``--lorax-templates``
|
||||
|
||||
Currently the standard lorax templates are used to make a bootable iso, but
|
||||
it should be possible to modify them to output other results. They are
|
||||
written using the Mako template system which is very flexible.
|
||||
The final image is created by lorax, using the templates in /usr/share/lorax/live/
|
||||
or the live directory below the directory specified by ``--lorax-templates``. The
|
||||
templates are written using the Mako template system with some extra commands
|
||||
added by lorax.
|
||||
|
||||
.. note::
|
||||
The output from --make-iso includes the artifacts used to create the boot.iso;
|
||||
@ -163,10 +164,10 @@ changes. Here are the steps I used to convert the Fedora XFCE spin.
|
||||
memtest86+
|
||||
syslinux
|
||||
|
||||
One drawback to using virt-install is that it pulls the packages from
|
||||
the repo each time you run it. To speed things up you either need a local
|
||||
mirror of the packages, or you can use a caching proxy. When using a proxy
|
||||
you pass it to livemedia-creator like this:
|
||||
One drawback to using qemu is that it pulls the packages from the repo each
|
||||
time you run it. To speed things up you either need a local mirror of the
|
||||
packages, or you can use a caching proxy. When using a proxy you pass it to
|
||||
livemedia-creator like this:
|
||||
|
||||
``--proxy=http://proxy.yourdomain.com:3128``
|
||||
|
||||
@ -175,16 +176,16 @@ packages will get cached, so your kickstart url would look like:
|
||||
|
||||
``url --url="http://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/x86_64/os/"``
|
||||
|
||||
You can also add an update repo, but don't name it updates. Add --proxy to
|
||||
it as well.
|
||||
You can also add an update repo, but don't name it updates. Add --proxy to it
|
||||
as well.
|
||||
|
||||
|
||||
Anaconda image install (no-virt)
|
||||
--------------------------------
|
||||
|
||||
You can create images without using virt-install by passing ``--no-virt`` on the
|
||||
cmdline. This will use Anaconda's directory install feature to handle the install.
|
||||
There are a couple of things to keep in mind when doing this:
|
||||
You can create images without using qemu by passing ``--no-virt`` on the
|
||||
cmdline. This will use Anaconda's directory install feature to handle the
|
||||
install. There are a couple of things to keep in mind when doing this:
|
||||
|
||||
1. It will be most reliable when building images for the same release that the
|
||||
host is running. Because Anaconda has expectations about the system it is
|
||||
@ -302,9 +303,9 @@ You can also create qcow2 appliance images using ``--image-type=qcow2``, for exa
|
||||
Filesystem Image Creation
|
||||
-------------------------
|
||||
|
||||
livemedia-creator can be used to create un-partitined filesystem images using the
|
||||
``--make-fsimage`` option. As of version 21.8 this works with both virt-install and no-virt modes
|
||||
of operation. Previously it was only available with no-virt.
|
||||
livemedia-creator can be used to create un-partitined filesystem images using
|
||||
the ``--make-fsimage`` option. As of version 21.8 this works with both qemu and
|
||||
no-virt modes of operation. Previously it was only available with no-virt.
|
||||
|
||||
Kickstarts should have a single / partition with no extra mountpoints.
|
||||
|
||||
@ -347,8 +348,8 @@ using Atomic installer iso with local repo included in the image can be found
|
||||
in docs/rhel-atomic-pxe-live.ks.
|
||||
|
||||
|
||||
Using Mock to Create Images
|
||||
---------------------------
|
||||
Using Mock and --no-virt to Create Images
|
||||
-----------------------------------------
|
||||
|
||||
As of lorax version 22.2 you can use livemedia-creator and anaconda version
|
||||
22.15 inside of a mock chroot with --make-iso and --make-fsimage.
|
||||
@ -404,6 +405,66 @@ located at ~/results/try-1/images/boot.iso, and the ~/results/try-1/
|
||||
directory tree will also contain the vmlinuz, initrd, etc.
|
||||
|
||||
|
||||
Using Mock and qemu to Create Images
|
||||
------------------------------------
|
||||
|
||||
Version 25.0 of livemedia-creator switches to using qemu for virtualization.
|
||||
This allows creation of all image types, and use of the KVM on the host if
|
||||
/dev/kvm is present in the mock environment.
|
||||
|
||||
On the host system:
|
||||
|
||||
1. yum install -y mock
|
||||
|
||||
2. Add a user to the mock group to use for running mock. eg. builder
|
||||
|
||||
3. Create a new /etc/mock/ config file based on the rawhide one, or modify the
|
||||
existing one so that the following options are setup::
|
||||
|
||||
config_opts['chroot_setup_cmd'] = 'install @buildsys-build lorax qemu'
|
||||
|
||||
# build results go into /home/builder/results/
|
||||
config_opts['plugin_conf']['bind_mount_opts']['dirs'].append(('/home/builder/results','/results/'))
|
||||
|
||||
If you are creating images for a branched release of Fedora you should also enable
|
||||
the updates-testing repository so that you get the latest builds in your mock chroot.
|
||||
|
||||
The following steps are run as the builder user who is a member of the mock
|
||||
group.
|
||||
|
||||
4. Make a directory for results matching the bind mount above
|
||||
``mkdir ~/results/``
|
||||
|
||||
5. Copy the example kickstarts
|
||||
``cp /usr/share/docs/lorax/*ks .``
|
||||
|
||||
6. Make sure tar and dracut-network are in the %packages section and that the
|
||||
``url points to the correct repo``
|
||||
|
||||
7. Init the mock
|
||||
``mock -r fedora-rawhide-x86_64 --init``
|
||||
|
||||
8. Copy the kickstart inside the mock
|
||||
``mock -r fedora-rawhide-x86_64 --copyin ./fedora-minimal.ks /root/``
|
||||
|
||||
9. Copy the Anaconda boot.iso inside the mock
|
||||
``mock -r fedora-rawhide-x86_64 --copyin ./boot.iso /root/``
|
||||
|
||||
10. Make a minimal iso::
|
||||
|
||||
mock -r fedora-rawhide-x86_64 --chroot -- livemedia-creator \
|
||||
--resultdir=/results/try-1 --logfile=/results/logs/try-1/try-1.log \
|
||||
--make-iso --ks /root/fedora-minimal.ks --iso /root/boot.iso
|
||||
|
||||
Results will be in ./results/try-1 and logs under /results/logs/try-1/
|
||||
including anaconda logs and livemedia-creator logs. The new iso will be
|
||||
located at ~/results/try-1/images/boot.iso, and the ~/results/try-1/
|
||||
directory tree will also contain the vmlinuz, initrd, etc.
|
||||
|
||||
This will run qemu without kvm support, which is going to be very slow. You can
|
||||
add ``mknod /dev/kvm c 10 232;`` to create the device node before running lmc.
|
||||
|
||||
|
||||
OpenStack Image Creation
|
||||
------------------------
|
||||
|
||||
@ -528,29 +589,27 @@ Make sure that the kickstart you are using creates a /boot/efi partition by incl
|
||||
Debugging problems
|
||||
------------------
|
||||
|
||||
Sometimes an installation will get stuck. When using virt-install the logs will
|
||||
Sometimes an installation will get stuck. When using qemu the logs will
|
||||
be written to ./virt-install.log and most of the time any problems that happen
|
||||
will be near the end of the file. lmc tries to detect common errors and will
|
||||
cancel the installation when they happen. But not everything can be caught.
|
||||
When creating a new kickstart it is helpful to use the ``--vnc vnc`` command so
|
||||
that you can monitor the installation as it happens, and if it gets stuck
|
||||
without lmc detecting the problem you can switch to tty1 and examine the system
|
||||
directly.
|
||||
When creating a new kickstart it is helpful to use vnc so that you can monitor
|
||||
the installation as it happens, and if it gets stuck without lmc detecting the
|
||||
problem you can switch to tty1 and examine the system directly.
|
||||
|
||||
If it does get stuck the best way to cancel is to use virsh to destroy the domain.
|
||||
|
||||
1. Use ``sudo virsh list`` to show the name of the virt. It will start with LiveOS and contain a UUID.
|
||||
2. Run ``sudo virsh destroy <name>`` to destroy the domain.
|
||||
3. Wait 20 seconds or so for lmc to detect that the domain vanished. It should handle cleanup.
|
||||
If it does get stuck the best way to cancel is to use kill -9 on the qemu pid,
|
||||
lmc will detect that the process died and cleanup.
|
||||
|
||||
If lmc didn't handle the cleanup for some reason you can do this:
|
||||
1. ``sudo virsh undefine <name>``
|
||||
2. ``sudo umount /tmp/tmpXXXX`` to unmount the iso from its mountpoint.
|
||||
3. ``sudo rm -rf /tmp/tmpXXXX``
|
||||
4. ``sudo rm /var/tmp/diskXXXXX`` to remove the disk image.
|
||||
1. ``sudo umount /tmp/lmc-XXXX`` to unmount the iso from its mountpoint.
|
||||
2. ``sudo rm -rf /tmp/lmc-XXXX``
|
||||
3. ``sudo rm /var/tmp/lmc-disk-XXXXX`` to remove the disk image.
|
||||
|
||||
The logs from the virt-install run are stored in virt-install.log,
|
||||
logs from livemedia-creator are in livemedia.log and program.log
|
||||
Note that lmc uses the lmc- prefix for all of its temporary files and
|
||||
directories to make it easier to find and clean up leftovers.
|
||||
|
||||
The logs from the qemu run are stored in virt-install.log, logs from
|
||||
livemedia-creator are in livemedia.log and program.log
|
||||
|
||||
You can add ``--image-only`` to skip the .iso creation and examine the resulting
|
||||
disk image. Or you can pass ``--keep-image`` to keep it around after the iso has
|
||||
|
||||
@ -16,6 +16,14 @@ rawhide version to build the boot.iso for rawhide, along with the rawhide
|
||||
repositories.
|
||||
|
||||
|
||||
lorax cmdline arguments
|
||||
-----------------------
|
||||
|
||||
.. argparse::
|
||||
:ref: pylorax.cmdline.lorax_parser
|
||||
:prog: lorax
|
||||
|
||||
|
||||
Quickstart
|
||||
----------
|
||||
|
||||
|
||||
@ -20,6 +20,14 @@ pylorax.buildstamp module
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
pylorax.cmdline module
|
||||
----------------------
|
||||
|
||||
.. automodule:: pylorax.cmdline
|
||||
:members:
|
||||
:undoc-members:
|
||||
:show-inheritance:
|
||||
|
||||
pylorax.decorators module
|
||||
-------------------------
|
||||
|
||||
|
||||
@ -9,7 +9,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>Index — Lorax 24.10 documentation</title>
|
||||
<title>Index — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -31,7 +31,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="index.html"/>
|
||||
|
||||
|
||||
<script src="_static/js/modernizr.min.js"></script>
|
||||
@ -59,7 +59,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -499,6 +499,10 @@
|
||||
</dt>
|
||||
|
||||
|
||||
<dt><a href="pylorax.html#pylorax.cmdline.lmc_parser">lmc_parser() (in module pylorax.cmdline)</a>
|
||||
</dt>
|
||||
|
||||
|
||||
<dt><a href="pylorax.html#pylorax.ltmpl.LoraxTemplateRunner.log">log() (pylorax.ltmpl.LoraxTemplateRunner method)</a>
|
||||
</dt>
|
||||
|
||||
@ -537,6 +541,10 @@
|
||||
</dt>
|
||||
|
||||
|
||||
<dt><a href="pylorax.html#pylorax.cmdline.lorax_parser">lorax_parser() (in module pylorax.cmdline)</a>
|
||||
</dt>
|
||||
|
||||
|
||||
<dt><a href="pylorax.html#pylorax.dnfhelper.LoraxDownloadCallback">LoraxDownloadCallback (class in pylorax.dnfhelper)</a>
|
||||
</dt>
|
||||
|
||||
@ -684,6 +692,10 @@
|
||||
<dt><a href="pylorax.html#module-pylorax.buildstamp">pylorax.buildstamp (module)</a>
|
||||
</dt>
|
||||
|
||||
|
||||
<dt><a href="pylorax.html#module-pylorax.cmdline">pylorax.cmdline (module)</a>
|
||||
</dt>
|
||||
|
||||
</dl></td>
|
||||
<td style="width: 33%" valign="top"><dl>
|
||||
|
||||
@ -1004,7 +1016,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'./',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>Welcome to Lorax’s documentation! — Lorax 24.10 documentation</title>
|
||||
<title>Welcome to Lorax’s documentation! — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="#"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="#"/>
|
||||
<link rel="next" title="Introduction to Lorax" href="intro.html"/>
|
||||
|
||||
|
||||
@ -59,7 +59,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -193,7 +193,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'./',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>Introduction to Lorax — Lorax 24.10 documentation</title>
|
||||
<title>Introduction to Lorax — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="index.html"/>
|
||||
<link rel="next" title="Lorax" href="lorax.html"/>
|
||||
<link rel="prev" title="Welcome to Lorax’s documentation!" href="index.html"/>
|
||||
|
||||
@ -60,7 +60,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -225,7 +225,7 @@ upd-instroot and mk-images* scripts.</p>
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'./',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>livemedia-creator — Lorax 24.10 documentation</title>
|
||||
<title>livemedia-creator — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="index.html"/>
|
||||
<link rel="next" title="Product and Updates Images" href="product-images.html"/>
|
||||
<link rel="prev" title="Lorax" href="lorax.html"/>
|
||||
|
||||
@ -60,7 +60,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -86,6 +86,7 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="intro.html#before-lorax">Before Lorax</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="lorax.html">Lorax</a></li>
|
||||
<li class="toctree-l1 current"><a class="current reference internal" href="">livemedia-creator</a><ul>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#livemedia-creator-cmdline-arguments">livemedia-creator cmdline arguments</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#quickstart">Quickstart</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#how-iso-creation-works">How ISO creation works</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#kickstarts">Kickstarts</a></li>
|
||||
@ -96,7 +97,8 @@
|
||||
<li class="toctree-l2"><a class="reference internal" href="#tar-file-creation">TAR File Creation</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#live-image-for-pxe-boot">Live Image for PXE Boot</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#atomic-live-image-for-pxe-boot">Atomic Live Image for PXE Boot</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#using-mock-to-create-images">Using Mock to Create Images</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#using-mock-and-no-virt-to-create-images">Using Mock and –no-virt to Create Images</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#using-mock-and-qemu-to-create-images">Using Mock and qemu to Create Images</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#openstack-image-creation">OpenStack Image Creation</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#docker-image-creation">Docker Image Creation</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#open-container-initiative-image-creation">Open Container Initiative Image Creation</a></li>
|
||||
@ -168,27 +170,278 @@ same install path as a normal system installation. It can be used to make live
|
||||
isos, bootable (partitioned) disk images, tarfiles, and filesystem images for
|
||||
use with virtualization and container solutions like libvirt, docker, and
|
||||
OpenStack.</p>
|
||||
<p>The general idea is to use virt-install with kickstart and an Anaconda boot.iso
|
||||
to install into a disk image and then use the disk image to create the bootable
|
||||
<p>The general idea is to use qemu with kickstart and an Anaconda boot.iso to
|
||||
install into a disk image and then use the disk image to create the bootable
|
||||
media.</p>
|
||||
<p>livemedia-creator –help will describe all of the options available. At the
|
||||
minimum you need:</p>
|
||||
<p><tt class="docutils literal"><span class="pre">--make-iso</span></tt> to create a final bootable .iso or one of the other <tt class="docutils literal"><span class="pre">--make-*</span></tt> options.</p>
|
||||
<p><tt class="docutils literal"><span class="pre">--iso</span></tt> to specify the Anaconda install media to use with virt-install</p>
|
||||
<p><tt class="docutils literal"><span class="pre">--iso</span></tt> to specify the Anaconda install media to use with qemu.</p>
|
||||
<p><tt class="docutils literal"><span class="pre">--ks</span></tt> to select the kickstart file describing what to install.</p>
|
||||
<p>To use livemedia-creator with virt-install you will need to install the
|
||||
following packages, as well as have libvirtd setup correctly.</p>
|
||||
<ul class="simple">
|
||||
<li><tt class="docutils literal"><span class="pre">virt-install</span></tt></li>
|
||||
<li><tt class="docutils literal"><span class="pre">libvirt-python</span></tt></li>
|
||||
</ul>
|
||||
<p>To use livemedia-creator with virtualization you will need to have qemu installed.</p>
|
||||
<p>If you are going to be using Anaconda directly, with <tt class="docutils literal"><span class="pre">--no-virt</span></tt> mode, make sure
|
||||
you have the anaconda package installed. You can use the anaconda-tui package
|
||||
to save a bit of space on the build system.</p>
|
||||
you have the anaconda-tui package installed.</p>
|
||||
<p>Conventions used in this document:</p>
|
||||
<p><tt class="docutils literal"><span class="pre">lmc</span></tt> is an abbreviation for livemedia-creator.</p>
|
||||
<p><tt class="docutils literal"><span class="pre">builder</span></tt> is the system where livemedia-creator is being run</p>
|
||||
<p><tt class="docutils literal"><span class="pre">image</span></tt> is the disk image being created by running livemedia-creator</p>
|
||||
<div class="section" id="livemedia-creator-cmdline-arguments">
|
||||
<h2>livemedia-creator cmdline arguments<a class="headerlink" href="#livemedia-creator-cmdline-arguments" title="Permalink to this headline">¶</a></h2>
|
||||
<p>Create Live Install Media</p>
|
||||
<pre class="literal-block">
|
||||
usage: livemedia-creator [-h]
|
||||
(--make-iso | --make-disk | --make-fsimage | --make-appliance | --make-ami | --make-tar | --make-pxe-live | --make-ostree-live | --make-oci | --make-vagrant)
|
||||
[--iso ISO] [--iso-only] [--iso-name ISO_NAME]
|
||||
[--ks KS] [--image-only] [--no-virt] [--proxy PROXY]
|
||||
[--anaconda-arg ANACONDA_ARGS]
|
||||
[--armplatform ARMPLATFORM] [--location LOCATION]
|
||||
[--logfile LOGFILE]
|
||||
[--lorax-templates LORAX_TEMPLATES] [--tmp TMP]
|
||||
[--resultdir RESULT_DIR] [--macboot] [--nomacboot]
|
||||
[--disk-image DISK_IMAGE] [--keep-image]
|
||||
[--fs-image FS_IMAGE] [--image-name IMAGE_NAME]
|
||||
[--fs-label FS_LABEL] [--image-type IMAGE_TYPE]
|
||||
[--qemu-arg QEMU_ARGS] [--qcow2]
|
||||
[--qcow2-arg QEMU_ARGS] [--compression COMPRESSION]
|
||||
[--compress-arg COMPRESS_ARGS] [--app-name APP_NAME]
|
||||
[--app-template APP_TEMPLATE] [--app-file APP_FILE]
|
||||
[--ram MEMORY] [--vcpus VCPUS] [--vnc VNC]
|
||||
[--arch ARCH] [--kernel-args KERNEL_ARGS]
|
||||
[--ovmf-path OVMF_PATH] [--virt-uefi] [--no-kvm]
|
||||
[--dracut-arg DRACUT_ARGS]
|
||||
[--live-rootfs-size LIVE_ROOTFS_SIZE]
|
||||
[--live-rootfs-keep-size] [--oci-config OCI_CONFIG]
|
||||
[--oci-runtime OCI_RUNTIME]
|
||||
[--vagrant-metadata VAGRANT_METADATA]
|
||||
[--vagrantfile VAGRANTFILE] [--title TITLE]
|
||||
[--project PROJECT] [--releasever RELEASEVER]
|
||||
[--volid VOLID] [--squashfs_args SQUASHFS_ARGS]
|
||||
[--timeout TIMEOUT]
|
||||
</pre>
|
||||
<dl class="docutils">
|
||||
<dt>Options:</dt>
|
||||
<dd><table class="first last docutils option-list" frame="void" rules="none">
|
||||
<col class="option" />
|
||||
<col class="description" />
|
||||
<tbody valign="top">
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--make-iso=False</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Build a live iso</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--make-disk=False</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Build a partitioned disk image</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--make-fsimage=False</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Build a filesystem image</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--make-appliance=False</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Build an appliance image and XML description</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--make-ami=False</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Build an ami image</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--make-tar=False</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Build a tar of the root filesystem</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--make-pxe-live=False</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Build a live pxe boot squashfs image</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--make-ostree-live=False</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Build a live pxe boot squashfs image of Atomic Host</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--make-oci=False</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Build an Open Container Initiative image</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--make-vagrant=False</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Build a Vagrant Box image</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--iso</span></kbd></td>
|
||||
<td>Anaconda installation .iso path to use for qemu</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--iso-only=False</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Remove all iso creation artifacts except the boot.iso, combine with –iso-name to rename the boot.iso</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--iso-name</span></kbd></td>
|
||||
<td>Name of output iso file for –iso-only. Default is boot.iso</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--ks</span></kbd></td>
|
||||
<td>Kickstart file defining the install.</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--image-only=False</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Exit after creating fs/disk image.</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--no-virt=False</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Run anaconda directly on host instead of using qemu</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--proxy</span></kbd></td>
|
||||
<td>proxy URL to use for the install</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--anaconda-arg</span></kbd></td>
|
||||
<td>Additional argument to pass to anaconda (no-virt mode). Pass once for each argument</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--armplatform</span></kbd></td>
|
||||
<td>the platform to use when creating images for ARM, i.e., highbank, mvebu, omap, tegra, etc.</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--location</span></kbd></td>
|
||||
<td>location of iso directory tree with initrd.img and vmlinuz. Used to run qemu with a newer initrd than the iso.</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--logfile=./livemedia.log</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Name and path for primary logfile, other logs will be created in the same directory.</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--lorax-templates</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Path to mako templates for lorax</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--tmp=/var/tmp</span></kbd></td>
|
||||
<td>Top level temporary directory</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--resultdir</span></kbd></td>
|
||||
<td>Directory to copy the resulting images and iso into. Defaults to the temporary working directory</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--macboot=True</span></kbd></td>
|
||||
<td>Undocumented</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--nomacboot=True</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Undocumented</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--disk-image</span></kbd></td>
|
||||
<td>Path to existing disk image to use for creating final image.</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--keep-image=False</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Keep raw disk image after .iso creation</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--fs-image</span></kbd></td>
|
||||
<td>Path to existing filesystem image to use for creating final image.</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--image-name</span></kbd></td>
|
||||
<td>Name of output file to create. Used for tar, fs and disk image. Default is a random name.</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--fs-label=Anaconda</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Label to set on fsimage, default is ‘Anaconda’</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--image-type</span></kbd></td>
|
||||
<td>Create an image with qemu-img. See qemu-img –help for supported formats.</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--qemu-arg=[]</span></kbd></td>
|
||||
<td>Arguments to pass to qemu-img. Pass once for each argument, they will be used for ALL calls to qemu-img.</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--qcow2=False</span></kbd></td>
|
||||
<td>Create qcow2 image instead of raw sparse image when making disk images.</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--qcow2-arg=[]</span></kbd></td>
|
||||
<td>Arguments to pass to qemu-img. Pass once for each argument, they will be used for ALL calls to qemu-img.</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--compression=xz</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Compression binary for make-tar. xz, lzma, gzip, and bzip2 are supported. xz is the default.</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--compress-arg=[]</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Arguments to pass to compression. Pass once for each argument</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--app-name</span></kbd></td>
|
||||
<td>Name of appliance to pass to template</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--app-template</span></kbd></td>
|
||||
<td>Path to template to use for appliance data.</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--app-file=appliance.xml</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Appliance template results file.</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--ram=1024</span></kbd></td>
|
||||
<td>Memory to allocate for installer in megabytes.</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--vcpus</span></kbd></td>
|
||||
<td>Passed to qemu -smp command</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--vnc</span></kbd></td>
|
||||
<td>Passed to qemu -display command. eg. vnc=127.0.0.1:5, default is to choose the first unused vnc port.</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--arch</span></kbd></td>
|
||||
<td>System arch to build for. Used to select qemu-system-* command. Defaults to qemu-system-<arch></td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--kernel-args</span></kbd></td>
|
||||
<td>Additional argument to pass to the installation kernel</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--ovmf-path=/usr/share/OVMF/</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Path to OVMF firmware</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--virt-uefi=False</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Use OVMF firmware to boot the VM in UEFI mode</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--no-kvm=False</span></kbd></td>
|
||||
<td>Skip using kvm with qemu even if it is available.</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--dracut-arg</span></kbd></td>
|
||||
<td>Argument to pass to dracut when rebuilding the initramfs. Pass this once for each argument. NOTE: this overrides the default. (default: )</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--live-rootfs-size=0</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Size of root filesystem of live image in GiB</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--live-rootfs-keep-size=False</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Keep the original size of root filesystem in live image</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--oci-config</span></kbd></td>
|
||||
<td>config.json OCI configuration file</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--oci-runtime</span></kbd></td>
|
||||
<td>runtime.json OCI configuration file</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--vagrant-metadata</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>optional metadata.json file</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--vagrantfile</span></kbd></td>
|
||||
<td>optional vagrantfile</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--title=Linux Live Media</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Substituted for @TITLE@ in bootloader config files</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--project=Linux</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>substituted for @PROJECT@ in bootloader config files</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--releasever=25</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>substituted for @VERSION@ in bootloader config files</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--volid</span></kbd></td>
|
||||
<td>volume id</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--squashfs_args</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>additional squashfs args</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--timeout</span></kbd></td>
|
||||
<td>Cancel installer after X minutes</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</dd>
|
||||
</dl>
|
||||
</div>
|
||||
<div class="section" id="quickstart">
|
||||
<h2>Quickstart<a class="headerlink" href="#quickstart" title="Permalink to this headline">¶</a></h2>
|
||||
<p>Run this to create a bootable live iso:</p>
|
||||
@ -202,8 +455,8 @@ to save a bit of space on the build system.</p>
|
||||
--ks=./docs/fedora-livemedia.ks --lorax-templates=./share/
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>If you want to watch the install you can pass <tt class="docutils literal"><span class="pre">--vnc</span> <span class="pre">vnc</span></tt> and use a vnc client
|
||||
to connect to localhost:0</p>
|
||||
<p>You can observe the installation using vnc. The logs will show what port was
|
||||
chosen, or you can use a specific port by passing it. eg. <tt class="docutils literal"><span class="pre">--vnc</span> <span class="pre">vnc:127.0.0.1:5</span></tt></p>
|
||||
<p>This is usually a good idea when testing changes to the kickstart. lmc tries
|
||||
to monitor the logs for fatal errors, but may not catch everything.</p>
|
||||
</div>
|
||||
@ -214,27 +467,26 @@ as its output, and the boot media creation which uses the image as its input.
|
||||
Normally you would run both stages, but it is possible to stop after the
|
||||
install stage, by using <tt class="docutils literal"><span class="pre">--image-only</span></tt>, or to skip the install stage and use
|
||||
a previously created disk image by passing <tt class="docutils literal"><span class="pre">--disk-image</span></tt> or <tt class="docutils literal"><span class="pre">--fs-image</span></tt></p>
|
||||
<p>When creating an iso virt-install boots using the passed Anaconda installer iso
|
||||
<p>When creating an iso qemu boots using the passed Anaconda installer iso
|
||||
and installs the system based on the kickstart. The <tt class="docutils literal"><span class="pre">%post</span></tt> section of the
|
||||
kickstart is used to customize the installed system in the same way that
|
||||
current spin-kickstarts do.</p>
|
||||
<p>livemedia-creator monitors the install process for problems by watching the
|
||||
install logs. They are written to the current directory or to the base
|
||||
directory specified by the –logfile command. You can also monitor the install
|
||||
by passing <tt class="docutils literal"><span class="pre">--vnc</span> <span class="pre">vnc</span></tt> and using a vnc client. This is recommended when first
|
||||
modifying a kickstart, since there are still places where Anaconda may get
|
||||
stuck without the log monitor catching it.</p>
|
||||
by using a vnc client. This is recommended when first modifying a kickstart,
|
||||
since there are still places where Anaconda may get stuck without the log
|
||||
monitor catching it.</p>
|
||||
<p>The output from this process is a partitioned disk image. kpartx can be used
|
||||
to mount and examine it when there is a problem with the install. It can also
|
||||
be booted using kvm.</p>
|
||||
<p>When creating an iso the disk image’s / partition is copied into a formatted
|
||||
disk image which is then used as the input to lorax for creation of the final
|
||||
media.</p>
|
||||
<p>The final image is created by lorax, using the templates in /usr/share/lorax/
|
||||
or the directory specified by <tt class="docutils literal"><span class="pre">--lorax-templates</span></tt></p>
|
||||
<p>Currently the standard lorax templates are used to make a bootable iso, but
|
||||
it should be possible to modify them to output other results. They are
|
||||
written using the Mako template system which is very flexible.</p>
|
||||
filesystem image which is then used as the input to lorax for creation of the
|
||||
final media.</p>
|
||||
<p>The final image is created by lorax, using the templates in /usr/share/lorax/live/
|
||||
or the live directory below the directory specified by <tt class="docutils literal"><span class="pre">--lorax-templates</span></tt>. The
|
||||
templates are written using the Mako template system with some extra commands
|
||||
added by lorax.</p>
|
||||
<div class="admonition note">
|
||||
<p class="first admonition-title">Note</p>
|
||||
<p class="last">The output from –make-iso includes the artifacts used to create the boot.iso;
|
||||
@ -305,24 +557,24 @@ memtest86+
|
||||
syslinux</p>
|
||||
</li>
|
||||
</ol>
|
||||
<p>One drawback to using virt-install is that it pulls the packages from
|
||||
the repo each time you run it. To speed things up you either need a local
|
||||
mirror of the packages, or you can use a caching proxy. When using a proxy
|
||||
you pass it to livemedia-creator like this:</p>
|
||||
<p>One drawback to using qemu is that it pulls the packages from the repo each
|
||||
time you run it. To speed things up you either need a local mirror of the
|
||||
packages, or you can use a caching proxy. When using a proxy you pass it to
|
||||
livemedia-creator like this:</p>
|
||||
<blockquote>
|
||||
<div><tt class="docutils literal"><span class="pre">--proxy=http://proxy.yourdomain.com:3128</span></tt></div></blockquote>
|
||||
<p>You also need to use a specific mirror instead of mirrormanager so that the
|
||||
packages will get cached, so your kickstart url would look like:</p>
|
||||
<blockquote>
|
||||
<div><tt class="docutils literal"><span class="pre">url</span> <span class="pre">--url="http://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/x86_64/os/"</span></tt></div></blockquote>
|
||||
<p>You can also add an update repo, but don’t name it updates. Add –proxy to
|
||||
it as well.</p>
|
||||
<p>You can also add an update repo, but don’t name it updates. Add –proxy to it
|
||||
as well.</p>
|
||||
</div>
|
||||
<div class="section" id="anaconda-image-install-no-virt">
|
||||
<h2>Anaconda image install (no-virt)<a class="headerlink" href="#anaconda-image-install-no-virt" title="Permalink to this headline">¶</a></h2>
|
||||
<p>You can create images without using virt-install by passing <tt class="docutils literal"><span class="pre">--no-virt</span></tt> on the
|
||||
cmdline. This will use Anaconda’s directory install feature to handle the install.
|
||||
There are a couple of things to keep in mind when doing this:</p>
|
||||
<p>You can create images without using qemu by passing <tt class="docutils literal"><span class="pre">--no-virt</span></tt> on the
|
||||
cmdline. This will use Anaconda’s directory install feature to handle the
|
||||
install. There are a couple of things to keep in mind when doing this:</p>
|
||||
<ol class="arabic simple">
|
||||
<li>It will be most reliable when building images for the same release that the
|
||||
host is running. Because Anaconda has expectations about the system it is
|
||||
@ -415,9 +667,9 @@ from <tt class="docutils literal"><span class="pre">--releasever</span></tt></p>
|
||||
</div>
|
||||
<div class="section" id="filesystem-image-creation">
|
||||
<h2>Filesystem Image Creation<a class="headerlink" href="#filesystem-image-creation" title="Permalink to this headline">¶</a></h2>
|
||||
<p>livemedia-creator can be used to create un-partitined filesystem images using the
|
||||
<tt class="docutils literal"><span class="pre">--make-fsimage</span></tt> option. As of version 21.8 this works with both virt-install and no-virt modes
|
||||
of operation. Previously it was only available with no-virt.</p>
|
||||
<p>livemedia-creator can be used to create un-partitined filesystem images using
|
||||
the <tt class="docutils literal"><span class="pre">--make-fsimage</span></tt> option. As of version 21.8 this works with both qemu and
|
||||
no-virt modes of operation. Previously it was only available with no-virt.</p>
|
||||
<p>Kickstarts should have a single / partition with no extra mountpoints.</p>
|
||||
<blockquote>
|
||||
<div><tt class="docutils literal"><span class="pre">livemedia-creator</span> <span class="pre">--make-fsimage</span> <span class="pre">--iso=/path/to/boot.iso</span> <span class="pre">--ks=./docs/fedora-minimal.ks</span></tt></div></blockquote>
|
||||
@ -450,8 +702,8 @@ for installations of Atomic Host. Example kickstart for such an installation
|
||||
using Atomic installer iso with local repo included in the image can be found
|
||||
in docs/rhel-atomic-pxe-live.ks.</p>
|
||||
</div>
|
||||
<div class="section" id="using-mock-to-create-images">
|
||||
<h2>Using Mock to Create Images<a class="headerlink" href="#using-mock-to-create-images" title="Permalink to this headline">¶</a></h2>
|
||||
<div class="section" id="using-mock-and-no-virt-to-create-images">
|
||||
<h2>Using Mock and –no-virt to Create Images<a class="headerlink" href="#using-mock-and-no-virt-to-create-images" title="Permalink to this headline">¶</a></h2>
|
||||
<p>As of lorax version 22.2 you can use livemedia-creator and anaconda version
|
||||
22.15 inside of a mock chroot with –make-iso and –make-fsimage.</p>
|
||||
<div class="admonition note">
|
||||
@ -508,6 +760,65 @@ including anaconda logs and livemedia-creator logs. The new iso will be
|
||||
located at ~/results/try-1/images/boot.iso, and the ~/results/try-1/
|
||||
directory tree will also contain the vmlinuz, initrd, etc.</p>
|
||||
</div>
|
||||
<div class="section" id="using-mock-and-qemu-to-create-images">
|
||||
<h2>Using Mock and qemu to Create Images<a class="headerlink" href="#using-mock-and-qemu-to-create-images" title="Permalink to this headline">¶</a></h2>
|
||||
<p>Version 25.0 of livemedia-creator switches to using qemu for virtualization.
|
||||
This allows creation of all image types, and use of the KVM on the host if
|
||||
/dev/kvm is present in the mock environment.</p>
|
||||
<p>On the host system:</p>
|
||||
<ol class="arabic">
|
||||
<li><p class="first">yum install -y mock</p>
|
||||
</li>
|
||||
<li><p class="first">Add a user to the mock group to use for running mock. eg. builder</p>
|
||||
</li>
|
||||
<li><p class="first">Create a new /etc/mock/ config file based on the rawhide one, or modify the
|
||||
existing one so that the following options are setup:</p>
|
||||
<div class="highlight-python"><div class="highlight"><pre><span class="n">config_opts</span><span class="p">[</span><span class="s">'chroot_setup_cmd'</span><span class="p">]</span> <span class="o">=</span> <span class="s">'install @buildsys-build lorax qemu'</span>
|
||||
|
||||
<span class="c"># build results go into /home/builder/results/</span>
|
||||
<span class="n">config_opts</span><span class="p">[</span><span class="s">'plugin_conf'</span><span class="p">][</span><span class="s">'bind_mount_opts'</span><span class="p">][</span><span class="s">'dirs'</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="s">'/home/builder/results'</span><span class="p">,</span><span class="s">'/results/'</span><span class="p">))</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>If you are creating images for a branched release of Fedora you should also enable
|
||||
the updates-testing repository so that you get the latest builds in your mock chroot.</p>
|
||||
</li>
|
||||
</ol>
|
||||
<p>The following steps are run as the builder user who is a member of the mock
|
||||
group.</p>
|
||||
<ol class="arabic" start="4">
|
||||
<li><p class="first">Make a directory for results matching the bind mount above
|
||||
<tt class="docutils literal"><span class="pre">mkdir</span> <span class="pre">~/results/</span></tt></p>
|
||||
</li>
|
||||
<li><p class="first">Copy the example kickstarts
|
||||
<tt class="docutils literal"><span class="pre">cp</span> <span class="pre">/usr/share/docs/lorax/*ks</span> <span class="pre">.</span></tt></p>
|
||||
</li>
|
||||
<li><p class="first">Make sure tar and dracut-network are in the %packages section and that the
|
||||
<tt class="docutils literal"><span class="pre">url</span> <span class="pre">points</span> <span class="pre">to</span> <span class="pre">the</span> <span class="pre">correct</span> <span class="pre">repo</span></tt></p>
|
||||
</li>
|
||||
<li><p class="first">Init the mock
|
||||
<tt class="docutils literal"><span class="pre">mock</span> <span class="pre">-r</span> <span class="pre">fedora-rawhide-x86_64</span> <span class="pre">--init</span></tt></p>
|
||||
</li>
|
||||
<li><p class="first">Copy the kickstart inside the mock
|
||||
<tt class="docutils literal"><span class="pre">mock</span> <span class="pre">-r</span> <span class="pre">fedora-rawhide-x86_64</span> <span class="pre">--copyin</span> <span class="pre">./fedora-minimal.ks</span> <span class="pre">/root/</span></tt></p>
|
||||
</li>
|
||||
<li><p class="first">Copy the Anaconda boot.iso inside the mock
|
||||
<tt class="docutils literal"><span class="pre">mock</span> <span class="pre">-r</span> <span class="pre">fedora-rawhide-x86_64</span> <span class="pre">--copyin</span> <span class="pre">./boot.iso</span> <span class="pre">/root/</span></tt></p>
|
||||
</li>
|
||||
<li><p class="first">Make a minimal iso:</p>
|
||||
<div class="highlight-python"><div class="highlight"><pre>mock -r fedora-rawhide-x86_64 --chroot -- livemedia-creator \
|
||||
--resultdir=/results/try-1 --logfile=/results/logs/try-1/try-1.log \
|
||||
--make-iso --ks /root/fedora-minimal.ks --iso /root/boot.iso
|
||||
</pre></div>
|
||||
</div>
|
||||
</li>
|
||||
</ol>
|
||||
<p>Results will be in ./results/try-1 and logs under /results/logs/try-1/
|
||||
including anaconda logs and livemedia-creator logs. The new iso will be
|
||||
located at ~/results/try-1/images/boot.iso, and the ~/results/try-1/
|
||||
directory tree will also contain the vmlinuz, initrd, etc.</p>
|
||||
<p>This will run qemu without kvm support, which is going to be very slow. You can
|
||||
add <tt class="docutils literal"><span class="pre">mknod</span> <span class="pre">/dev/kvm</span> <span class="pre">c</span> <span class="pre">10</span> <span class="pre">232;</span></tt> to create the device node before running lmc.</p>
|
||||
</div>
|
||||
<div class="section" id="openstack-image-creation">
|
||||
<h2>OpenStack Image Creation<a class="headerlink" href="#openstack-image-creation" title="Permalink to this headline">¶</a></h2>
|
||||
<p>OpenStack supports partitioned disk images so <tt class="docutils literal"><span class="pre">--make-disk</span></tt> can be used to
|
||||
@ -610,27 +921,23 @@ then using efibootmgr to setup the correct boot entry.</p>
|
||||
</div>
|
||||
<div class="section" id="debugging-problems">
|
||||
<h2>Debugging problems<a class="headerlink" href="#debugging-problems" title="Permalink to this headline">¶</a></h2>
|
||||
<p>Sometimes an installation will get stuck. When using virt-install the logs will
|
||||
<p>Sometimes an installation will get stuck. When using qemu the logs will
|
||||
be written to ./virt-install.log and most of the time any problems that happen
|
||||
will be near the end of the file. lmc tries to detect common errors and will
|
||||
cancel the installation when they happen. But not everything can be caught.
|
||||
When creating a new kickstart it is helpful to use the <tt class="docutils literal"><span class="pre">--vnc</span> <span class="pre">vnc</span></tt> command so
|
||||
that you can monitor the installation as it happens, and if it gets stuck
|
||||
without lmc detecting the problem you can switch to tty1 and examine the system
|
||||
directly.</p>
|
||||
<p>If it does get stuck the best way to cancel is to use virsh to destroy the domain.</p>
|
||||
<ol class="arabic simple">
|
||||
<li>Use <tt class="docutils literal"><span class="pre">sudo</span> <span class="pre">virsh</span> <span class="pre">list</span></tt> to show the name of the virt. It will start with LiveOS and contain a UUID.</li>
|
||||
<li>Run <tt class="docutils literal"><span class="pre">sudo</span> <span class="pre">virsh</span> <span class="pre">destroy</span> <span class="pre"><name></span></tt> to destroy the domain.</li>
|
||||
<li>Wait 20 seconds or so for lmc to detect that the domain vanished. It should handle cleanup.</li>
|
||||
</ol>
|
||||
When creating a new kickstart it is helpful to use vnc so that you can monitor
|
||||
the installation as it happens, and if it gets stuck without lmc detecting the
|
||||
problem you can switch to tty1 and examine the system directly.</p>
|
||||
<p>If it does get stuck the best way to cancel is to use kill -9 on the qemu pid,
|
||||
lmc will detect that the process died and cleanup.</p>
|
||||
<p>If lmc didn’t handle the cleanup for some reason you can do this:
|
||||
1. <tt class="docutils literal"><span class="pre">sudo</span> <span class="pre">virsh</span> <span class="pre">undefine</span> <span class="pre"><name></span></tt>
|
||||
2. <tt class="docutils literal"><span class="pre">sudo</span> <span class="pre">umount</span> <span class="pre">/tmp/tmpXXXX</span></tt> to unmount the iso from its mountpoint.
|
||||
3. <tt class="docutils literal"><span class="pre">sudo</span> <span class="pre">rm</span> <span class="pre">-rf</span> <span class="pre">/tmp/tmpXXXX</span></tt>
|
||||
4. <tt class="docutils literal"><span class="pre">sudo</span> <span class="pre">rm</span> <span class="pre">/var/tmp/diskXXXXX</span></tt> to remove the disk image.</p>
|
||||
<p>The logs from the virt-install run are stored in virt-install.log,
|
||||
logs from livemedia-creator are in livemedia.log and program.log</p>
|
||||
1. <tt class="docutils literal"><span class="pre">sudo</span> <span class="pre">umount</span> <span class="pre">/tmp/lmc-XXXX</span></tt> to unmount the iso from its mountpoint.
|
||||
2. <tt class="docutils literal"><span class="pre">sudo</span> <span class="pre">rm</span> <span class="pre">-rf</span> <span class="pre">/tmp/lmc-XXXX</span></tt>
|
||||
3. <tt class="docutils literal"><span class="pre">sudo</span> <span class="pre">rm</span> <span class="pre">/var/tmp/lmc-disk-XXXXX</span></tt> to remove the disk image.</p>
|
||||
<p>Note that lmc uses the lmc- prefix for all of its temporary files and
|
||||
directories to make it easier to find and clean up leftovers.</p>
|
||||
<p>The logs from the qemu run are stored in virt-install.log, logs from
|
||||
livemedia-creator are in livemedia.log and program.log</p>
|
||||
<p>You can add <tt class="docutils literal"><span class="pre">--image-only</span></tt> to skip the .iso creation and examine the resulting
|
||||
disk image. Or you can pass <tt class="docutils literal"><span class="pre">--keep-image</span></tt> to keep it around after the iso has
|
||||
been created.</p>
|
||||
@ -690,7 +997,7 @@ report bugs against the lorax component.</p>
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'./',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>Lorax — Lorax 24.10 documentation</title>
|
||||
<title>Lorax — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="index.html"/>
|
||||
<link rel="next" title="livemedia-creator" href="livemedia-creator.html"/>
|
||||
<link rel="prev" title="Introduction to Lorax" href="intro.html"/>
|
||||
|
||||
@ -60,7 +60,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -85,6 +85,7 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="intro.html">Introduction to Lorax</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="intro.html#before-lorax">Before Lorax</a></li>
|
||||
<li class="toctree-l1 current"><a class="current reference internal" href="">Lorax</a><ul>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#lorax-cmdline-arguments">lorax cmdline arguments</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#quickstart">Quickstart</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#how-it-works">How it works</a><ul>
|
||||
<li class="toctree-l3"><a class="reference internal" href="#runtime-install-tmpl">runtime-install.tmpl</a></li>
|
||||
@ -163,6 +164,155 @@ environment. It is best to run lorax from the same release as is being targeted
|
||||
because the templates may have release specific logic in them. eg. Use the
|
||||
rawhide version to build the boot.iso for rawhide, along with the rawhide
|
||||
repositories.</p>
|
||||
<div class="section" id="lorax-cmdline-arguments">
|
||||
<h2>lorax cmdline arguments<a class="headerlink" href="#lorax-cmdline-arguments" title="Permalink to this headline">¶</a></h2>
|
||||
<p>Create the Anaconda boot.iso</p>
|
||||
<pre class="literal-block">
|
||||
usage: lorax [-h] -p PRODUCT -v VERSION -r RELEASE [-s REPOSITORY]
|
||||
[--repo REPOSITORY] [-m REPOSITORY] [-t VARIANT] [-b URL]
|
||||
[--isfinal] [-c CONFIGFILE] [--proxy HOST] [-i PACKAGE]
|
||||
[--buildarch ARCH] [--volid VOLID] [--macboot] [--nomacboot]
|
||||
[--noupgrade] [--logfile LOGFILE] [--tmp TMP]
|
||||
[--cachedir CACHEDIR] [--workdir WORKDIR] [--force]
|
||||
[--add-template ADD_TEMPLATES]
|
||||
[--add-template-var ADD_TEMPLATE_VARS]
|
||||
[--add-arch-template ADD_ARCH_TEMPLATES]
|
||||
[--add-arch-template-var ADD_ARCH_TEMPLATE_VARS] [--noverify]
|
||||
[--sharedir SHAREDIR] [--enablerepo [repo]]
|
||||
[--disablerepo [repo]] [-V]
|
||||
OUTPUTDIR
|
||||
</pre>
|
||||
<dl class="docutils">
|
||||
<dt>Positional arguments:</dt>
|
||||
<dd><table class="first last docutils option-list" frame="void" rules="none">
|
||||
<col class="option" />
|
||||
<col class="description" />
|
||||
<tbody valign="top">
|
||||
<tr><td class="option-group">
|
||||
<kbd>outputdir</kbd></td>
|
||||
<td>Output directory</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</dd>
|
||||
<dt>Options:</dt>
|
||||
<dd><table class="first last docutils option-list" frame="void" rules="none">
|
||||
<col class="option" />
|
||||
<col class="description" />
|
||||
<tbody valign="top">
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">-p</span>, <span class="option">--product</span></kbd></td>
|
||||
<td>product name</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">-v</span>, <span class="option">--version</span></kbd></td>
|
||||
<td>version identifier</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">-r</span>, <span class="option">--release</span></kbd></td>
|
||||
<td>release information</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">-s=[]</span>, <span class="option">--source=[]</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>source repository (may be listed multiple times)</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--repo=[]</span></kbd></td>
|
||||
<td>source dnf repository file</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">-m=[]</span>, <span class="option">--mirrorlist=[]</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>mirrorlist repository (may be listed multiple times)</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">-t</span>, <span class="option">--variant</span></kbd></td>
|
||||
<td>variant name</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">-b=your distribution provided bug reporting tool</span>, <span class="option">--bugurl=your distribution provided bug reporting tool</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>bug reporting URL for the product</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--isfinal=False</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Undocumented</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">-c=/etc/lorax/lorax.conf</span>, <span class="option">--config=/etc/lorax/lorax.conf</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>config file</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--proxy</span></kbd></td>
|
||||
<td>repo proxy url:port</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">-i=[]</span>, <span class="option">--installpkgs=[]</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>package glob to install before runtime-install.tmpl runs. (may be listed multiple times)</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--buildarch</span></kbd></td>
|
||||
<td>build architecture</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--volid</span></kbd></td>
|
||||
<td>volume id</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--macboot=True</span></kbd></td>
|
||||
<td>Undocumented</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--nomacboot=True</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Undocumented</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--noupgrade=True</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Undocumented</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--logfile=./lorax.log</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Path to logfile</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--tmp=/var/tmp</span></kbd></td>
|
||||
<td>Top level temporary directory</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--cachedir</span></kbd></td>
|
||||
<td>DNF cache directory. Default is a temporary dir.</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--workdir</span></kbd></td>
|
||||
<td>Work directory, overrides –tmp. Default is a temporary dir under /var/tmp</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--force=False</span></kbd></td>
|
||||
<td>Run even when the destination directory exists</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--add-template=[]</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Additional template for runtime image</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--add-template-var=[]</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Set variable for runtime image template</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--add-arch-template=[]</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Additional template for architecture-specific image</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--add-arch-template-var=[]</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Set variable for architecture-specific image</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--noverify=True</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Do not verify the install root</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">--sharedir</span></kbd></td>
|
||||
<td>Directory containing all the templates. Overrides config file sharedir</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--enablerepo=[]</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Names of repos to enable</td></tr>
|
||||
<tr><td class="option-group" colspan="2">
|
||||
<kbd><span class="option">--disablerepo=[]</span></kbd></td>
|
||||
</tr>
|
||||
<tr><td> </td><td>Names of repos to disable</td></tr>
|
||||
<tr><td class="option-group">
|
||||
<kbd><span class="option">-V</span></kbd></td>
|
||||
<td>show program’s version number and exit</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</dd>
|
||||
</dl>
|
||||
</div>
|
||||
<div class="section" id="quickstart">
|
||||
<h2>Quickstart<a class="headerlink" href="#quickstart" title="Permalink to this headline">¶</a></h2>
|
||||
<p>Run this as root to create a boot.iso in <tt class="docutils literal"><span class="pre">./results/</span></tt>:</p>
|
||||
@ -309,7 +459,7 @@ should) select the specific template directory by passing <tt class="docutils li
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'./',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>pylorax — Lorax 24.10 documentation</title>
|
||||
<title>pylorax — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="index.html"/>
|
||||
<link rel="next" title="pylorax package" href="pylorax.html"/>
|
||||
<link rel="prev" title="Product and Updates Images" href="product-images.html"/>
|
||||
|
||||
@ -60,7 +60,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -143,6 +143,7 @@
|
||||
<li class="toctree-l2"><a class="reference internal" href="pylorax.html#submodules">Submodules</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="pylorax.html#module-pylorax.base">pylorax.base module</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="pylorax.html#module-pylorax.buildstamp">pylorax.buildstamp module</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="pylorax.html#module-pylorax.cmdline">pylorax.cmdline module</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="pylorax.html#module-pylorax.decorators">pylorax.decorators module</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="pylorax.html#module-pylorax.discinfo">pylorax.discinfo module</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="pylorax.html#module-pylorax.dnfhelper">pylorax.dnfhelper module</a></li>
|
||||
@ -203,7 +204,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'./',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
Binary file not shown.
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>Product and Updates Images — Lorax 24.10 documentation</title>
|
||||
<title>Product and Updates Images — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="index.html"/>
|
||||
<link rel="next" title="pylorax" href="modules.html"/>
|
||||
<link rel="prev" title="livemedia-creator" href="livemedia-creator.html"/>
|
||||
|
||||
@ -60,7 +60,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -197,7 +197,7 @@ command or the installpkgs paramater of <a class="reference internal" href="pylo
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'./',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>Python Module Index — Lorax 24.10 documentation</title>
|
||||
<title>Python Module Index — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="index.html"/>
|
||||
|
||||
|
||||
|
||||
@ -61,7 +61,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -158,6 +158,11 @@
|
||||
<td>
|
||||
<a href="pylorax.html#module-pylorax.buildstamp"><tt class="xref">pylorax.buildstamp</tt></a></td><td>
|
||||
<em></em></td></tr>
|
||||
<tr class="cg-1">
|
||||
<td></td>
|
||||
<td>
|
||||
<a href="pylorax.html#module-pylorax.cmdline"><tt class="xref">pylorax.cmdline</tt></a></td><td>
|
||||
<em></em></td></tr>
|
||||
<tr class="cg-1">
|
||||
<td></td>
|
||||
<td>
|
||||
@ -252,7 +257,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'./',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>pylorax package — Lorax 24.10 documentation</title>
|
||||
<title>pylorax package — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="index.html"/>
|
||||
<link rel="up" title="pylorax" href="modules.html"/>
|
||||
<link rel="prev" title="pylorax" href="modules.html"/>
|
||||
|
||||
@ -60,7 +60,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -92,6 +92,7 @@
|
||||
<li class="toctree-l3"><a class="reference internal" href="#submodules">Submodules</a></li>
|
||||
<li class="toctree-l3"><a class="reference internal" href="#module-pylorax.base">pylorax.base module</a></li>
|
||||
<li class="toctree-l3"><a class="reference internal" href="#module-pylorax.buildstamp">pylorax.buildstamp module</a></li>
|
||||
<li class="toctree-l3"><a class="reference internal" href="#module-pylorax.cmdline">pylorax.cmdline module</a></li>
|
||||
<li class="toctree-l3"><a class="reference internal" href="#module-pylorax.decorators">pylorax.decorators module</a></li>
|
||||
<li class="toctree-l3"><a class="reference internal" href="#module-pylorax.discinfo">pylorax.discinfo module</a></li>
|
||||
<li class="toctree-l3"><a class="reference internal" href="#module-pylorax.dnfhelper">pylorax.dnfhelper module</a></li>
|
||||
@ -218,6 +219,21 @@
|
||||
|
||||
</dd></dl>
|
||||
|
||||
</div>
|
||||
<div class="section" id="module-pylorax.cmdline">
|
||||
<span id="pylorax-cmdline-module"></span><h2>pylorax.cmdline module<a class="headerlink" href="#module-pylorax.cmdline" title="Permalink to this headline">¶</a></h2>
|
||||
<dl class="function">
|
||||
<dt id="pylorax.cmdline.lmc_parser">
|
||||
<tt class="descclassname">pylorax.cmdline.</tt><tt class="descname">lmc_parser</tt><big>(</big><em>dracut_default=''</em><big>)</big><a class="reference internal" href="_modules/pylorax/cmdline.html#lmc_parser"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#pylorax.cmdline.lmc_parser" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Return a ArgumentParser object for live-media-creator.</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="function">
|
||||
<dt id="pylorax.cmdline.lorax_parser">
|
||||
<tt class="descclassname">pylorax.cmdline.</tt><tt class="descname">lorax_parser</tt><big>(</big><big>)</big><a class="reference internal" href="_modules/pylorax/cmdline.html#lorax_parser"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#pylorax.cmdline.lorax_parser" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Return the ArgumentParser for lorax</p>
|
||||
</dd></dl>
|
||||
|
||||
</div>
|
||||
<div class="section" id="module-pylorax.decorators">
|
||||
<span id="pylorax-decorators-module"></span><h2>pylorax.decorators module<a class="headerlink" href="#module-pylorax.decorators" title="Permalink to this headline">¶</a></h2>
|
||||
@ -296,7 +312,7 @@
|
||||
|
||||
<dl class="function">
|
||||
<dt id="pylorax.executils.execReadlines">
|
||||
<tt class="descclassname">pylorax.executils.</tt><tt class="descname">execReadlines</tt><big>(</big><em>command</em>, <em>argv</em>, <em>stdin=None</em>, <em>root='/'</em>, <em>env_prune=None</em>, <em>filter_stderr=False</em>, <em>callback=<function <lambda> at 0x7f043d1fd2f0></em>, <em>env_add=None</em>, <em>reset_handlers=True</em>, <em>reset_lang=True</em><big>)</big><a class="reference internal" href="_modules/pylorax/executils.html#execReadlines"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#pylorax.executils.execReadlines" title="Permalink to this definition">¶</a></dt>
|
||||
<tt class="descclassname">pylorax.executils.</tt><tt class="descname">execReadlines</tt><big>(</big><em>command</em>, <em>argv</em>, <em>stdin=None</em>, <em>root='/'</em>, <em>env_prune=None</em>, <em>filter_stderr=False</em>, <em>callback=<function <lambda> at 0x7ff947d61400></em>, <em>env_add=None</em>, <em>reset_handlers=True</em>, <em>reset_lang=True</em><big>)</big><a class="reference internal" href="_modules/pylorax/executils.html#execReadlines"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#pylorax.executils.execReadlines" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Execute an external command and return the line output of the command
|
||||
in real-time.</p>
|
||||
<p>This method assumes that there is a reasonably low delay between the
|
||||
@ -1117,7 +1133,7 @@ there to be a listener on the port used for the virtio log port.</p>
|
||||
<dl class="class">
|
||||
<dt id="pylorax.monitor.LogRequestHandler">
|
||||
<em class="property">class </em><tt class="descclassname">pylorax.monitor.</tt><tt class="descname">LogRequestHandler</tt><big>(</big><em>request</em>, <em>client_address</em>, <em>server</em><big>)</big><a class="reference internal" href="_modules/pylorax/monitor.html#LogRequestHandler"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#pylorax.monitor.LogRequestHandler" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Bases: <tt class="xref py py-class docutils literal"><span class="pre">socketserver.BaseRequestHandler</span></tt></p>
|
||||
<dd><p>Bases: <a class="reference external" href="https://docs.python.org/3/library/socketserver.html#socketserver.BaseRequestHandler" title="(in Python v3.5)"><tt class="xref py py-class docutils literal"><span class="pre">socketserver.BaseRequestHandler</span></tt></a></p>
|
||||
<p>Handle monitoring and saving the logfiles from the virtual install</p>
|
||||
<p>Incoming data is written to self.server.log_path and each line is checked
|
||||
for patterns that would indicate that the installation failed.
|
||||
@ -1162,7 +1178,7 @@ errors that indicate that the install failed.</p>
|
||||
<dl class="class">
|
||||
<dt id="pylorax.monitor.LogServer">
|
||||
<em class="property">class </em><tt class="descclassname">pylorax.monitor.</tt><tt class="descname">LogServer</tt><big>(</big><em>log_path</em>, <em>*args</em>, <em>**kwargs</em><big>)</big><a class="reference internal" href="_modules/pylorax/monitor.html#LogServer"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#pylorax.monitor.LogServer" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Bases: <tt class="xref py py-class docutils literal"><span class="pre">socketserver.TCPServer</span></tt></p>
|
||||
<dd><p>Bases: <a class="reference external" href="https://docs.python.org/3/library/socketserver.html#socketserver.TCPServer" title="(in Python v3.5)"><tt class="xref py py-class docutils literal"><span class="pre">socketserver.TCPServer</span></tt></a></p>
|
||||
<p>A TCP Server that listens for log data</p>
|
||||
<dl class="method">
|
||||
<dt id="pylorax.monitor.LogServer.log_check">
|
||||
@ -1427,7 +1443,7 @@ image is built with the filename “${prefix}-${kernel.version}.img”</
|
||||
<dd><p>Bases: <a class="reference internal" href="#pylorax.base.DataHolder" title="pylorax.base.DataHolder"><tt class="xref py py-class docutils literal"><span class="pre">pylorax.base.DataHolder</span></tt></a></p>
|
||||
<dl class="attribute">
|
||||
<dt id="pylorax.ArchData.bcj_arch">
|
||||
<tt class="descname">bcj_arch</tt><em class="property"> = {'ppc': 'powerpc', 'armhfp': 'arm', 'x86_64': 'x86', 'arm': 'arm', 'i386': 'x86', 'ppc64': 'powerpc', 'ppc64le': 'powerpc'}</em><a class="headerlink" href="#pylorax.ArchData.bcj_arch" title="Permalink to this definition">¶</a></dt>
|
||||
<tt class="descname">bcj_arch</tt><em class="property"> = {'ppc64': 'powerpc', 'ppc64le': 'powerpc', 'arm': 'arm', 'i386': 'x86', 'armhfp': 'arm', 'x86_64': 'x86', 'ppc': 'powerpc'}</em><a class="headerlink" href="#pylorax.ArchData.bcj_arch" title="Permalink to this definition">¶</a></dt>
|
||||
<dd></dd></dl>
|
||||
|
||||
<dl class="attribute">
|
||||
@ -1557,7 +1573,7 @@ lowest numbered directory entry is returned.</p>
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'./',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>Search — Lorax 24.10 documentation</title>
|
||||
<title>Search — Lorax 25.2 documentation</title>
|
||||
|
||||
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="Lorax 24.10 documentation" href="index.html"/>
|
||||
<link rel="top" title="Lorax 25.2 documentation" href="index.html"/>
|
||||
|
||||
|
||||
<script src="_static/js/modernizr.min.js"></script>
|
||||
@ -58,7 +58,7 @@
|
||||
|
||||
|
||||
<div class="version">
|
||||
24.10
|
||||
25.2
|
||||
</div>
|
||||
|
||||
|
||||
@ -171,7 +171,7 @@
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'./',
|
||||
VERSION:'24.10',
|
||||
VERSION:'25.2',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
|
||||
File diff suppressed because one or more lines are too long
BIN
docs/man/.doctrees/environment.pickle
Normal file
BIN
docs/man/.doctrees/environment.pickle
Normal file
Binary file not shown.
BIN
docs/man/.doctrees/index.doctree
Normal file
BIN
docs/man/.doctrees/index.doctree
Normal file
Binary file not shown.
BIN
docs/man/.doctrees/intro.doctree
Normal file
BIN
docs/man/.doctrees/intro.doctree
Normal file
Binary file not shown.
BIN
docs/man/.doctrees/livemedia-creator.doctree
Normal file
BIN
docs/man/.doctrees/livemedia-creator.doctree
Normal file
Binary file not shown.
BIN
docs/man/.doctrees/lorax.doctree
Normal file
BIN
docs/man/.doctrees/lorax.doctree
Normal file
Binary file not shown.
BIN
docs/man/.doctrees/modules.doctree
Normal file
BIN
docs/man/.doctrees/modules.doctree
Normal file
Binary file not shown.
BIN
docs/man/.doctrees/product-images.doctree
Normal file
BIN
docs/man/.doctrees/product-images.doctree
Normal file
Binary file not shown.
BIN
docs/man/.doctrees/pylorax.doctree
Normal file
BIN
docs/man/.doctrees/pylorax.doctree
Normal file
Binary file not shown.
Loading…
Reference in New Issue
Block a user