Gentoo Archives: gentoo-doc-cvs

From: Jan Kundrat <jkt@×××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: vserver-howto.xml
Date: Thu, 06 Oct 2005 16:43:08
Message-Id: 200510061634.j96GYO3R026417@robin.gentoo.org
1 jkt 05/10/06 16:42:48
2
3 Modified: xml/htdocs/doc/en vserver-howto.xml
4 Log:
5 #108259, "Update vserver howto to reflect latest changes" by hollow
6
7 Revision Changes Path
8 1.3 +66 -129 xml/htdocs/doc/en/vserver-howto.xml
9
10 file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/vserver-howto.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
11 plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/vserver-howto.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
12 diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/vserver-howto.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo
13
14 Index: vserver-howto.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/vserver-howto.xml,v
17 retrieving revision 1.2
18 retrieving revision 1.3
19 diff -u -r1.2 -r1.3
20 --- vserver-howto.xml 8 Aug 2005 11:08:24 -0000 1.2
21 +++ vserver-howto.xml 6 Oct 2005 16:42:48 -0000 1.3
22 @@ -1,5 +1,5 @@
23 <?xml version='1.0' encoding="UTF-8"?>
24 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/vserver-howto.xml,v 1.2 2005/08/08 11:08:24 neysx Exp $ -->
25 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/vserver-howto.xml,v 1.3 2005/10/06 16:42:48 jkt Exp $ -->
26 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
27
28 <guide link="/doc/en/vserver-howto.xml">
29 @@ -21,8 +21,8 @@
30 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
31 <license/>
32
33 -<version>1.0</version>
34 -<date>2005-06-17</date>
35 +<version>1.1</version>
36 +<date>2005-10-06</date>
37
38 <chapter>
39 <title>Introduction</title>
40 @@ -83,7 +83,7 @@
41 </chapter>
42
43 <chapter>
44 -<title>Creating a VServer template</title>
45 +<title>Host configuration</title>
46 <section>
47 <title>Install a VServer kernel</title>
48 <body>
49 @@ -102,13 +102,12 @@
50 # <i>make menuconfig</i>
51
52 Linux VServer ---&gt;
53 -<comment>(Required by current utils)</comment>
54 - [*] Enable Legacy Kernel API
55 + [ ] Enable Legacy Kernel API
56 <comment>(Do not set!)</comment>
57 [ ] Disable Legacy Networking Kernel API
58 <comment>(Highly recommended)</comment>
59 [*] Enable Proc Security
60 - [ ] Enable Hard CPU Limits
61 + [*] Enable Hard CPU Limits
62 Persistent Inode Context Tagging (UID24/GID24) ---&gt;
63 [ ] Tag NFSD User Auth and Files
64 [ ] Compile Debugging Code
65 @@ -124,7 +123,7 @@
66 # <i>make</i>
67 <comment>(Installing)</comment>
68 # <i>make modules_install</i>
69 -# <i>cp arch/i386/boot/bzImage /boot/kernel-&lt;KERNELVERSION&gt;-vs&lt;VSERVERVERSION&gt;</i>
70 +# <i>cp arch/i386/boot/bzImage /boot/kernel-&lt;KERNELVERSION&gt;-vserver-&lt;VSERVERVERSION&gt;</i>
71 <comment>(Edit bootloader config file as required and)</comment>
72 # <i>reboot</i>
73 </pre>
74 @@ -140,23 +139,25 @@
75 contains all necessary programs and many usefull features.
76 </p>
77
78 +<note>
79 +The tools and features used in this HowTo require
80 +<c>&gt;=sys-apps/util-vserver-0.30.208-r3</c>. You may have to keyword it first.
81 +</note>
82 +
83 <pre caption="Install vserver utils">
84 # <i>emerge util-vserver</i>
85 </pre>
86
87 <p>
88 -If you use Proc Security you have to "unhide" certain files in your
89 -<path>/proc</path> directory in order to make them available in virtual
90 -servers. There is a script called <c>vprocunhide</c> in
91 -<path>/usr/lib/util-vserver</path> which unhides files specified in
92 -<path>/usr/lib/util-vserver/defaults/vprocunhide-files</path>. The util-vserver
93 -ebuild installed a init-script which uses the <c>vprocunhide</c> command. Add
94 -it to your runlevel:
95 +You have to run the <c>vprocunhide</c> command after every reboot in order to
96 +setup <path>/proc</path> permissions correctly for vserver use. An init script has
97 +been installed by util-vserver. To use it you should add it to a
98 +runlevel:
99 </p>
100
101 -<pre caption="vprocunhide init script">
102 -# <i>rc-update add vprocunhide default</i>
103 -# <i>/etc/init.d/vprocunhide start</i>
104 +<pre caption="vserver init script">
105 +# <i>rc-update add vservers default</i>
106 +# <i>/etc/init.d/vservers start</i>
107 </pre>
108
109 <p>
110 @@ -171,27 +172,19 @@
111
112 </body>
113 </section>
114 +</chapter>
115 +
116 +<chapter>
117 +<title>Creating a guest template</title>
118 <section>
119 -<title>Basic Skeleton configuration</title>
120 +<title>Install a vserver stage3</title>
121 <body>
122
123 <p>
124 -You have to create some configuration files and directories to get your virtual
125 -server up and running. We use the skeleton build mode from the util-vserver
126 -package to setup our basic configuration.
127 -</p>
128 -
129 -<p>
130 -The util-vserver package uses <path>/vservers</path> to store all virtual
131 -servers by default. You can put your servers somewhere else by specifying
132 -<c>--rootdir=/path/to/vserver/root</c> to the build command below.
133 -</p>
134 -
135 -<p>
136 -There is a new baselayout-vserver ebuild in portage which supports the plain
137 -init-style, i.e.; you don't have to use the gentoo init style anymore. The
138 -plain init-style uses <c>init</c> and <path>/etc/inittab</path> to manage
139 -runlevels and init scripts (considered more stable and is the default now).
140 +We will use <c>vserver-new</c> to create the initial guest. You have to download
141 +a vserver prepared stage3 from
142 +<uri>http://dev.gentoo.org/~hollow/vserver/stages</uri> and the script will
143 +guide you through the creation process.
144 </p>
145
146 <p>
147 @@ -201,118 +194,63 @@
148 equivalent to the last two parts of the virtual servers IP).
149 </p>
150
151 -<pre caption="Basic configuration">
152 -# <i>vserver gentoo build -m skeleton \</i>
153 +<pre caption="Start stage3 installation">
154 +# <i>vserver-new gentoo-template \</i>
155 <i>--hostname gentoo \</i>
156 - <i>--initstyle plain \</i>
157 - <i>--context 1253</i>
158 - <i>--interface gentoo=eth0:192.168.1.253/24</i>
159 + <i>--context 1253 \</i>
160 + <i>--interface eth0:192.168.1.253/24 \</i>
161 + <i>stage3 /path/to/stage3-tarball.tar.bz2</i>
162 </pre>
163
164 -<impo>
165 -Per default the virtual server is allowed to set the hostname itself. Be sure
166 -to change <path>/etc/conf.d/hostname</path> in your virtual server later to
167 -match the hostname above.
168 -</impo>
169 -
170 -</body>
171 -</section>
172 -<section>
173 -<title>Installing Gentoo installation files</title>
174 -<body>
175 -
176 -<p>
177 -We are creating a Gentoo template which we can copy later to get multiple
178 -virtual servers easily. The vserver build-script created some basic directories
179 -in <path>/vservers/gentoo</path> which are installed by a stage anyway, so we
180 -remove them first.
181 -</p>
182 -
183 -<pre caption="Remove skeleton files">
184 -# <i>rm -rf /vservers/gentoo/*</i>
185 -</pre>
186 -
187 -<p>
188 -You have to install a regular Gentoo system now. You can follow most of the
189 -Gentoo Handbook with some limitations and additions:
190 -</p>
191 -
192 -<ul>
193 - <li>Replace <path>/mnt/gentoo</path> with <path>/vservers/gentoo</path></li>
194 - <li>
195 - Choose the <path>vserver/x86</path> profile in <uri
196 - link="/doc/en/handbook/handbook-x86.xml?part=1&amp;chap=6#doc_chap1_sect6">chapter
197 - 6.a</uri>
198 - </li>
199 - <li>
200 - Use the vserver stages available <uri
201 - link="http://dev.gentoo.org/~hollow/vserver/stages/">here</uri>.
202 - </li>
203 -</ul>
204 -
205 -<p>
206 -Now, follow the Gentoo Handbook from <uri
207 -link="/doc/en/handbook/handbook-x86.xml?part=1&amp;chap=5#doc_chap2"> chapter
208 -5.b</uri> to chapter 7.a and <uri
209 -link="/doc/en/handbook/handbook-x86.xml?part=1&amp;chap=8#doc_chap3"> chapter
210 -8.c</uri> to chapter 9.c
211 -</p>
212 -
213
214
215
216 --
217 gentoo-doc-cvs@g.o mailing list