util-vserver:Cheatsheet

2011-06-25T18:10:32Z

Nicholi: /* Where to find the latest util-vserver ? */ using git repo now

This is a cheatsheet for util-vserver. Some of these recipes have been arrived at by users, using trial and error, so they may not always be the "official" solutions.

== Where to find the latest util-vserver ? ==

:Look here:

:<pre>http://people.linux-vserver.org/~dhozac/t/uv-testing/</pre>

:or checkout git repository:

:<pre>git clone http://git.linux-vserver.org/git/util-vserver.git util-vserver</pre>

:And for the lastest kernel patch:

:<pre>http://vserver.13thfloor.at/Experimental/</pre>

== How to debug an issue with the vserver command ?==

Simply add the --debug flag , beware this will be quite verbose !<br>
<code>vserver --debug ......</code>

== How to add an IP address to a live guest ?==

# create the address on the host: <pre>ifconfig eth0:10 172.16.0.145/12</pre> or <pre>ip addr add dev eth0 172.16.0.145/12</pre> or even <pre>ip addr add dev dummy0 172.16.0.145/12</pre>
# add the adress:<pre>naddress --nid guestname --add --ip 172.16.0.145 --bcast 172.31.255.255</pre>
#* Depending on what you use the vserver for, you may not want the broadcast thing at all; you can also use a /32 mask for the IP in this case.
# add the ip to the config directory to make it stick if you restart <br/>
# enter the guest and verify services that need to listen on the ip, restart if necessary (for me it was not).

== How to change the machine type live ?==

: For this you can use the '''vuname''' command,
:: <pre>sudo vuname --xid 40133 -s -t 'machine=i686'</pre>

: Possible values for TAG are:
:: <pre>context, sysname, nodename, release, version, machine, domainname</pre>

:To make those change permanent you have to modify the files in your /etc/vservers/<vserver-name>/uts/machine file see the great flower page for details.

== What are the main vutils commands ?==

: '''Main ones are''' :

:# vserver : to create enter , start, stop, destroy etc the vserver guests.
:# vuname : to change live guest : context, sysname, nodename, release, version, machine or domainname.
:# vattribute: to change capabilities of a live guest (bcap, ccap and flags).
:# nattribute: to change network capabilities and flags of a live guest (ncaps and flags).
:# vlimit : to change the limits of a live guest (cpu, fsize, data, stack, core, rss, nproc,nofile, memlock, as, locks, msgqueue, nsock, openfd, anon, shmem, semary,nsems, and dentry).
:# vsched : to change schheduling parameters of live guest.
:# vdevmap : to remap device or give permission to a guest to create/read/open specific devices.
:# vdlimit : to change the directory limits of a live guest.
:: those parameters can be '''setup permanently''' in the configuration files, see the vutil flower page for details ([http://www.nongnu.org/util-vserver/doc/conf/configuration.html The Great Flower Page]).

:'''Other usefull vutils''' :

:# vapt-get : to run apt-get from the host in one or more guest.
:# vemerge : to run emerge from the host in one or more guest.
:# vmount : to mount file systems inside guest from the host.
:# vsomething : to run one command to all vserver in one go.

: '''daily usage one''':

:# vps : ps in a guest aware way (see all the process of host+guest).
:# vtop : top in a guest aware way (see all the process of host+guest).
:# vserver-info : gives version and other usefull information about the utils installed.
:# vserver-stat : gives informations about running guests.

== What are the services that need to be running in a basic setup ?==

: '''Services to allow on boot''' :

:# vprocunhide : this one is mandatory to allow access to required parts of /proc on the guest
:# vservers-default: this one will start the vservers on reboot, most users need this one
:# util-vserver : ? do not know what it does.

: this article in incomplete, please do not hesistate to add your comments !

Linux-VServer - User contributions [en]

util-vserver:Cheatsheet