1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<html>
<head>
<meta http-equiv="Content-type" content="text/html; charset=utf-8" />
<title>Quick Start</title>
<!-- (en) Add your meta data here -->
<link href="css/larchdocs.css" rel="stylesheet" type="text/css"/>
<!--[if lte IE 7]>
<link href="css/yaml/core/iehacks.css" rel="stylesheet" type="text/css" />
<![endif]-->
</head>
<body>
<!-- skip link navigation -->
<ul id="skiplinks">
<li><a class="skip" href="#col1">Skip to main content (Press Enter).</a></li>
</ul>
<div class="page_margins">
<div class="page">
<div id="top"><div id="tm"></div></div>
<!-- begin: #col1 -->
<div id="col1" role="main">
<div id="col1_content">
<div id="header" role="banner">
<h1><span><em>live Arch Linux</em> builder</span></h1>
</div>
<!-- begin: #col3 navigation column -->
<div id="col3" role="complementary">
<div id="col3_content">
<img class="indent2" alt="larch logo" src="css/screen/larch150x.png" width="150" height="150" />
<div class="vlist">
<ul>
<li><a href="index.html"><h6>Table Of Contents</h6></a></li>
<li><a href="archin.html"><h6>Next:</h6>
<div class="indent1">Installation of the base Arch system</div></a></li>
<li><a href="larch_quick-console.html"><h6>Previous:</h6>
<div class="indent1">Quick Start - Console</div></a></li>
</ul>
</div>
</div>
</div>
<!-- end: #col3 -->
<div class="larchdocs">
<h2 id="pagetitle" level="1">Quick Start</h2>
<p>The gui should make exploration of the possibilities offered by <em>larch</em>
quite straightforward. The documentation should provide enough information to
understand how a <em>larch live</em> system works, so that further customizations
can be performed beyond those directly supported.
</p>
<p>The general sequence of events starts with creating a 'project', which will
determine certain aspects of the build environment (such as where to place the
installation files), and select a profile. The profile describes the system to be
installed (primarily which packages, but also various other aspects). All this
configuration information is stored in the user's home directory (~/.config/larch),
so that it is retained from one <em>larch</em> run to the next.
</p>
<ul>
<li>At present I only maintain a repository for 'i686', as I don't run a 64-bit
<em>Arch</em> machine, but as all the current <em>larch</em> packages
have architecture 'any', both architectures should be supported.
</li>
<li>Make sure you have 'pyqt' and 'python-pexpect' packages installed.
</li>
<li>Download the latest
<a href="ftp://ftp.berlios.de/pub/larch/larch7.2/i686/larch-setup">
<strong>larch-setup</strong></a> script
to an empty working directory. Then run it (it is a shell script).
It will download and prepare the 'larch' and 'larch-profiles' packages so that
<em>larch</em> can be run from this directory.
</li>
<li>Run './larch' in the working directory.
As it is a gui program, you must of course be running xorg (see
<a href="larch_quick-console.html">Command-Line Interface</a>
for use from the command line). In general you should start <em>larch</em>
as a normal, unprivileged user, so that the access to the configuration
files is as the correct user. It will ask for the <em>sudo</em>
password when it needs it.
</li>
<li>To build a <em>larch live</em> system you basically just have to go through
the tabs one after the other.
</li>
<li>The first tab allows you to create a project and select a profile. The 'mini'
(no <em>xorg</em>) and 'xmini' (a fairly minimal <em>xfce</em> desktop) examples
(from the supplied 'profiles' folder) might be good places to start.
The default installation path should be alright for most purposes,
but you might need to move it if you don't have enough space on that partition.
Be careful! If you put a silly path in here you might overwrite your system.
</li>
<li>The 'Installation' tab performs the installation of the system to be squashed,
by downloading and installing all the requested packages to the installation path
set for the project. You can adjust a few aspects of this process, for example
to use a local package mirror, or to add repositories to pacman.conf. The default
is to use the mirror set on the host system and also to use the host's package
cache, so that repeated builds don't need to download the packages all over
again.
</li>
<li>The 'Larchify' tab compresses the installation using squashfs, also building
a squashed overlay containing all the customizations necessary for the
<em>live</em> system and those specified in the profile.
</li>
<li>A few customizations of the medium are accessible on the 'Medium Profile' tab,
for example the bootloader configurations.
</li>
<li>Finally the 'Medium' tab writes the prepared <em>larch</em> files to an
<em>iso</em> file (for CD or DVD), or to the partition of your choice (be careful!),
so that you end up with a bootable <em>larch</em> system.
</li>
<li>Particular things that you might want to customize even in a first test run might
be the supported <strong>locales</strong> and <strong>rc.conf</strong> (both on the
'Larchify' tab).
</li>
<li>Further details of the customization process are in the section
<a href="profiles.html">Profiles</a> and in the documentation to the individual
gui tabs.
</li>
<li> Share and Enjoy!</li>
</ul>
</div>
<div class="topref"><a href="#top">Top</a></div>
</div>
<!-- begin: #footer -->
<div id="footer">
<div id="footer-content" role="contentinfo">© 2010 Michael Towers<br />
Page layout assisted by <a href="http://www.yaml.de/">YAML</a> and
<a href="http://www.kuwata-lab.com/tenjin/">pyTenjin</a>
</div>
</div>
<!-- end: #footer -->
</div>
<!-- end: #col1 -->
<div id="bottom"><div id="bl"><div id="bm"></div></div></div>
</div>
</div>
<!-- full skiplink functionality in webkit browsers -->
<script src="css/yaml/core/js/webkit-focusfix.js" type="text/javascript"></script>
</body>
</html>
|
