https://pve.proxmox.com/mediawiki/api.php?action=feedcontributions&user=Brice+Burgess&feedformat=atom
Proxmox VE - User contributions [en]
2024-03-28T12:23:25Z
User contributions
MediaWiki 1.35.11
https://pve.proxmox.com/mediawiki/index.php?title=Command_line_tools_-_PVE_3.x&diff=5980
Command line tools - PVE 3.x
2013-10-11T16:06:23Z
<p>Brice Burgess: /* Usage */</p>
<hr />
<div>= Introduction =<br />
<br />
This page lists the important Proxmox VE and Debian command line tools. All CLI tools have also manual pages. <br />
<br />
= KVM specific =<br />
<br />
== qm ==<br />
<br />
qm - qemu/kvm manager - see [[Manual: qm]] and [[Qm manual]] <br />
<br />
= OpenVZ specific =<br />
<br />
== vzctl ==<br />
<br />
vzctl - utility to control an OpenVZ container - see [[Vzctl manual]] <br />
<br />
== vztop ==<br />
<br />
vztop - display top CPU processes<br />
<br />
<pre><br />
10:28:52 up 31 days, 11:18, 1 user, load average: 0.07, 0.06, 0.02<br />
197 processes: 196 sleeping, 1 running, 0 zombie, 0 stopped<br />
CPU0 states: 0.2% user 0.1% system 0.0% nice 0.0% iowait 99.2% idle<br />
CPU1 states: 1.3% user 2.1% system 0.0% nice 0.0% iowait 96.1% idle<br />
CPU2 states: 6.3% user 0.1% system 0.0% nice 0.0% iowait 93.1% idle<br />
CPU3 states: 2.0% user 1.0% system 0.0% nice 0.0% iowait 96.4% idle<br />
Mem: 16251688k av, 16032764k used, 218924k free, 0k shrd, 364120k buff<br />
4448576k active, 10983652k inactive<br />
Swap: 15728632k av, 36k used, 15728596k free 14170784k cached<br />
<br />
PID USER PRI NI SIZE RSS SHARE STAT %CPU %MEM TIME CPU COMMAND<br />
390694 root 20 0 759M 528M 2432 S 6.7 3.3 244:53 1 kvm<br />
566767 root 20 0 40464 8908 5320 S 6.7 0.0 0:54 0 apache2<br />
7898 root 20 0 181M 34M 4076 S 0.3 0.2 73:12 2 pvestatd<br />
1 root 20 0 10604 848 744 S 0.0 0.0 0:16 0 init<br />
2 root 20 0 0 0 0 SW 0.0 0.0 0:00 2 kthreadd<br />
3 root RT 0 0 0 0 SW 0.0 0.0 0:00 0 migration/0<br />
4 root 20 0 0 0 0 SW 0.0 0.0 0:19 0 ksoftirqd/0<br />
5 root RT 0 0 0 0 SW 0.0 0.0 0:00 0 migration/0<br />
6 root RT 0 0 0 0 SW 0.0 0.0 0:02 0 watchdog/0<br />
7 root RT 0 0 0 0 SW 0.0 0.0 0:00 1 migration/1<br />
8 root RT 0 0 0 0 SW 0.0 0.0 0:00 1 migration/1<br />
9 root 20 0 0 0 0 SW 0.0 0.0 0:24 1 ksoftirqd/1<br />
10 root RT 0 0 0 0 SW 0.0 0.0 0:01 1 watchdog/1<br />
11 root RT 0 0 0 0 SW 0.0 0.0 0:01 2 migration/2<br />
12 root RT 0 0 0 0 SW 0.0 0.0 0:00 2 migration/2<br />
13 root 20 0 0 0 0 SW 0.0 0.0 0:12 2 ksoftirqd/2<br />
14 root RT 0 0 0 0 SW 0.0 0.0 0:01 2 watchdog/2<br />
15 root RT 0 0 0 0 SW 0.0 0.0 0:07 3 migration/3<br />
..<br />
..<br />
</pre><br />
<br />
== user_beancounters ==<br />
<br />
cat /proc/user_beancounters<br />
<br />
<br />
<pre><br />
Version: 2.5<br />
uid resource held maxheld barrier limit failcnt<br />
101: kmemsize 11217945 16650240 243269632 268435456 0<br />
lockedpages 0 418 65536 65536 0<br />
privvmpages 134161 221093 9223372036854775807 9223372036854775807 0<br />
shmpages 16 3232 9223372036854775807 9223372036854775807 0<br />
dummy 0 0 0 0 0<br />
numproc 56 99 9223372036854775807 9223372036854775807 0<br />
physpages 96245 122946 0 131072 0<br />
vmguarpages 0 0 0 9223372036854775807 0<br />
oomguarpages 53689 78279 0 9223372036854775807 0<br />
numtcpsock 49 82 9223372036854775807 9223372036854775807 0<br />
numflock 8 20 9223372036854775807 9223372036854775807 0<br />
numpty 0 6 9223372036854775807 9223372036854775807 0<br />
numsiginfo 0 33 9223372036854775807 9223372036854775807 0<br />
tcpsndbuf 927856 1619344 9223372036854775807 9223372036854775807 0<br />
tcprcvbuf 802816 1343488 9223372036854775807 9223372036854775807 0<br />
othersockbuf 152592 481248 9223372036854775807 9223372036854775807 0<br />
dgramrcvbuf 0 4624 9223372036854775807 9223372036854775807 0<br />
numothersock 124 152 9223372036854775807 9223372036854775807 0<br />
dcachesize 6032652 12378728 121634816 134217728 0<br />
numfile 629 915 9223372036854775807 9223372036854775807 0<br />
dummy 0 0 0 0 0<br />
dummy 0 0 0 0 0<br />
dummy 0 0 0 0 0<br />
numiptent 20 20 9223372036854775807 9223372036854775807 0<br />
0: kmemsize 34634728 65306624 9223372036854775807 9223372036854775807 0<br />
lockedpages 1360 6721 9223372036854775807 9223372036854775807 0<br />
privvmpages 317475 507560 9223372036854775807 9223372036854775807 0<br />
shmpages 4738 9645 9223372036854775807 9223372036854775807 0<br />
dummy 0 0 9223372036854775807 9223372036854775807 0<br />
numproc 190 220 9223372036854775807 9223372036854775807 0<br />
physpages 3769163 3867750 9223372036854775807 9223372036854775807 0<br />
vmguarpages 0 0 0 0 0<br />
oomguarpages 182160 205746 9223372036854775807 9223372036854775807 0<br />
numtcpsock 12 29 9223372036854775807 9223372036854775807 0<br />
numflock 9 13 9223372036854775807 9223372036854775807 0<br />
numpty 4 12 9223372036854775807 9223372036854775807 0<br />
numsiginfo 3 84 9223372036854775807 9223372036854775807 0<br />
tcpsndbuf 249512 1760544 9223372036854775807 9223372036854775807 0<br />
tcprcvbuf 198920 1142000 9223372036854775807 9223372036854775807 0<br />
othersockbuf 233512 276832 9223372036854775807 9223372036854775807 0<br />
dgramrcvbuf 0 2576 9223372036854775807 9223372036854775807 0<br />
numothersock 179 193 9223372036854775807 9223372036854775807 0<br />
dcachesize 18688898 47058779 9223372036854775807 9223372036854775807 0<br />
numfile 1141 1410 9223372036854775807 9223372036854775807 0<br />
dummy 0 0 9223372036854775807 9223372036854775807 0<br />
dummy 0 0 9223372036854775807 9223372036854775807 0<br />
dummy 0 0 9223372036854775807 9223372036854775807 0<br />
numiptent 20 20 9223372036854775807 9223372036854775807 0<br />
<br />
</pre><br />
<br />
== vzlist ==<br />
<br />
:example:<br />
<pre>vzlist<br />
CTID NPROC STATUS IP_ADDR HOSTNAME<br />
101 26 running - localhost.fantinibakery.com<br />
102 121 running 10.100.100.18 mediawiki.fantinibakery.com<br />
114 49 running - fbc14.fantinibakery.com<br />
</pre><br />
<br />
From PVE 3.0 onwards, the display will be:<br />
<pre>vzlist<br />
CTID NPROC STATUS IP_ADDR HOSTNAME<br />
101 26 running - localhost<br />
102 121 running 10.100.100.18 mediawiki<br />
114 49 running - fbc14<br />
</pre><br />
* The fields for ('''-o''' option) selective display are: '''ctid, nproc, status, ip, hostname'''.<br />
* All are case sensitive and are used with the options '''-H''' (no header) and '''-o''' [field1, field2, ...]<br />
* The binary is at: <tt>/usr/sbin/vzlist</tt><br />
=== USAGE ===<br />
<pre><br />
Usage: vzlist [-a | -S] [-n] [-H] [-o field[,field...] | -1] [-s [-]field]<br />
[-h pattern] [-N pattern] [-d pattern] [CTID [CTID ...]]<br />
vzlist -L | --list<br />
<br />
Options:<br />
-a, --all list all containers<br />
-S, --stopped list stopped containers<br />
-n, --name display containers' names<br />
-H, --no-header suppress columns header<br />
-t, --no-trim do not trim long values<br />
-j, --json output in JSON format<br />
-o, --output output only specified fields<br />
-1 synonym for -H -octid<br />
-s, --sort sort by the specified field<br />
('-field' to reverse sort order)<br />
-h, --hostname filter CTs by hostname pattern<br />
-N, --name_filter filter CTs by name pattern<br />
-d, --description filter CTs by description pattern<br />
-L, --list get possible field names<br />
</pre><br />
<br />
= Backup =<br />
<br />
== vzdump ==<br />
<br />
vzdump - backup utility for virtual machine - see [[Vzdump manual]] <br />
<br />
== vzrestore ==<br />
<br />
vzrestore - restore OpenVZ vzdump backups - see [[Vzrestore manual]] <br />
<br />
== qmrestore ==<br />
<br />
qmrestore - restore KVM vzdump backups - see [[Qmrestore manual]] <br />
<br />
= Cluster management =<br />
<br />
== pveca ==<br />
<br />
PVE Cluster Administration Toolkit <br />
<br />
=== USAGE ===<br />
<br />
*pveca -l # show cluster status <br />
*pveca -c # create new cluster with localhost as master <br />
*pveca -s [-h IP] # sync cluster configuration from master (or IP) <br />
*pveca -d ID # delete a node <br />
*pveca -a [-h IP] # add new node to cluster <br />
*pveca -m # force local node to become master <br />
*pveca -i # print node info (CID NAME IP ROLE)<br />
<br />
= Software version check =<br />
<br />
== pveversion ==<br />
<br />
Proxmox VE version info - Print version information for Proxmox VE packages. <br />
<br />
=== USAGE ===<br />
<br />
pveversion [--verbose] <br />
<br />
*without any argument shows the version of pve-manager, something like:<br />
<br />
:pve-manager/1.5/4660<br />
or<br />
:pve-manager/3.0/957f0862<br />
<br />
*with -v argument it shows a list of programs versions related to pve, like:<br />
<br />
:pve-manager: 1.5-7 (pve-manager/1.5/4660) <br />
:running kernel: 2.6.18-2-pve <br />
:proxmox-ve-2.6.18: 1.5-5 <br />
:pve-kernel-2.6.18-2-pve: 2.6.18-5 <br />
:pve-kernel-2.6.18-1-pve: 2.6.18-4 <br />
:qemu-server: 1.1-11 <br />
:pve-firmware: 1.0-3 <br />
:libpve-storage-perl: 1.0-10 <br />
:vncterm: 0.9-2 <br />
:vzctl: 3.0.23-1pve8 <br />
:vzdump: 1.2-5 <br />
:vzprocps: 2.0.11-1dso2 <br />
:vzquota: 3.0.11-1 <br />
:pve-qemu-kvm-2.6.18: 0.9.1-5<br />
or<br />
:pve-manager: 3.0-23 (pve-manager/3.0/957f0862)<br />
:running kernel: 2.6.32-20-pve<br />
:proxmox-ve-2.6.32: 3.0-100<br />
:pve-kernel-2.6.32-20-pve: 2.6.32-100<br />
:lvm2: 2.02.95-pve3<br />
:clvm: 2.02.95-pve3<br />
:corosync-pve: 1.4.5-1<br />
:openais-pve: 1.1.4-3<br />
:libqb0: 0.11.1-2<br />
:redhat-cluster-pve: 3.2.0-2<br />
:resource-agents-pve: 3.9.2-4<br />
:fence-agents-pve: 4.0.0-1<br />
:pve-cluster: 3.0-4<br />
:qemu-server: 3.0-20<br />
:pve-firmware: 1.0-22<br />
:libpve-common-perl: 3.0-4<br />
:libpve-access-control: 3.0-4<br />
:libpve-storage-perl: 3.0-8<br />
:vncterm: 1.1-4<br />
:vzctl: 4.0-1pve3<br />
:vzprocps: 2.0.11-2<br />
:vzquota: 3.1-2<br />
:pve-qemu-kvm: 1.4-13<br />
:ksm-control-daemon: 1.1-1<br />
<br />
== aptitude ==<br />
<br />
Standard Debian package update tool <br />
<br />
= LVM =<br />
<br />
Most of the commands in LVM are very similar to each other. Each valid command is preceded by one of the following: <br />
<br />
*Physical Volume = pv <br />
*Volume Group = vg <br />
*Logical Volume = lv<br />
<br />
=== USAGE ===<br />
<br />
{| width="200" border="1" align="center" cellpadding="1" cellspacing="1"<br />
|-<br />
| '''<br>''' <br />
| <br />
| '''Physical Volume''' <br />
| '''Volume Group''' <br />
| '''Logical Volume'''<br />
|-<br />
| <br />
| '''LVM''' <br />
| '''PV''' <br />
| '''VG''' <br />
| '''LV'''<br />
|-<br />
| s <br />
| No <br />
| Yes <br />
| <br />
Yes <br />
<br />
| Yes<br />
|-<br />
| display <br />
| No <br />
| Yes <br />
| Yes <br />
| Yes<br />
|-<br />
| create <br />
| No <br />
| Yes <br />
| Yes <br />
| Yes<br />
|-<br />
| rename <br />
| No <br />
| No <br />
| Yes <br />
| Yes<br />
|-<br />
| change <br />
| Yes <br />
| Yes <br />
| Yes <br />
| Yes<br />
|-<br />
| move <br />
| No <br />
| Yes <br />
| Yes <br />
| No<br />
|-<br />
| extend <br />
| No <br />
| No <br />
| Yes <br />
| Yes<br />
|-<br />
| reduce <br />
| No <br />
| No <br />
| Yes <br />
| Yes<br />
|-<br />
| resize <br />
| No <br />
| Yes <br />
| No <br />
| Yes<br />
|-<br />
| split <br />
| No <br />
| No <br />
| Yes <br />
| No<br />
|-<br />
| merge <br />
| No <br />
| No <br />
| Yes <br />
| No<br />
|-<br />
| convert <br />
| No <br />
| No <br />
| Yes <br />
| Yes<br />
|-<br />
| import <br />
| No <br />
| No <br />
| Yes <br />
| No<br />
|-<br />
| export <br />
| No <br />
| No <br />
| Yes <br />
| No<br />
|-<br />
| importclone <br />
| No <br />
| No <br />
| Yes <br />
| No<br />
|-<br />
| cfgbackup <br />
| No <br />
| No <br />
| Yes <br />
| No<br />
|-<br />
| cfgrestore <br />
| No <br />
| No <br />
| Yes <br />
| No<br />
|-<br />
| ck <br />
| No <br />
| Yes <br />
| Yes <br />
| No<br />
|-<br />
| scan <br />
| diskscan <br />
| Yes <br />
| Yes <br />
| Yes<br />
|-<br />
| mknodes <br />
| No <br />
| No <br />
| Yes <br />
| No<br />
|-<br />
| remove <br />
| No <br />
| Yes <br />
| Yes <br />
| Yes<br />
|-<br />
| dump <br />
| Yes <br />
| No <br />
| No <br />
| No<br />
|}<br />
<br />
<br><br />
<br />
= iSCSI =<br />
<br />
= DRBD =<br />
<br />
See [[DRBD]] <br />
<br />
= Debian Appliance Builder =<br />
<br />
== dab ==<br />
<br />
See [[Debian Appliance Builder]] <br />
<br />
= Other useful tools =<br />
<br />
== pveperf ==<br />
<br />
Simple host performance test. <br />
<br />
(from man page) <br />
<br />
=== USAGE ===<br />
<br />
:pveperf [PATH]<br />
<br />
=== DESCRIPTION ===<br />
<br />
:Tries to gather some CPU/Hardisk performance data on the hardisk mounted at PATH (/ is used as default)<br />
<br />
It dumps on the terminal: <br />
<br />
*CPU BOGOMIPS: bogomips sum of all CPUs <br />
*REGEX/SECOND: regular expressions per second (perl performance test), should be above 300000 <br />
*HD SIZE: harddisk size <br />
*BUFFERED READS: simple HD read test. Modern HDs should reach at least 40 MB/sec <br />
*AVERAGE SEEK TIME: tests average seek time. Fast SCSI HDs reach values &lt; 8 milliseconds. Common IDE/SATA disks get values from 15 to 20 ms. <br />
*FSYNCS/SECOND: value should be greater than 200 (you should enable "write back" cache mode on you RAID controller - needs a battery backed cache (BBWC)). <br />
*DNS EXT: average time to resolve an external DNS name <br />
*DNS INT: average time to resolve a local DNS name<br />
<br />
Note: this command may require root privileges (or sudo) to run, otherwise you get an error after "HD SIZE" value, like: &lt;&lt;sh: /proc/sys/vm/drop_caches: Permission denied unable to open HD at /usr/bin/pveperf line 149.&gt;&gt; <br />
<br />
=== Example output ===<br />
<pre><br />
CPU BOGOMIPS: 26341.80<br />
REGEX/SECOND: 1554770<br />
HD SIZE: 94.49 GB (/dev/mapper/pve-root)<br />
BUFFERED READS: 49.83 MB/sec<br />
AVERAGE SEEK TIME: 14.16 ms<br />
FSYNCS/SECOND: 1060.47<br />
DNS EXT: 314.58 ms<br />
DNS INT: 236.94 ms (mypve.com)<br />
</pre><br />
<br />
== pvesubscription ==<br />
<br />
For managing a node's subscription key<br />
<br />
=== Usage ===<br />
<br />
To set the key use:<br />
<br />
* pvesubscription set <key><br />
<br />
The following updates the subscription status<br />
<br />
* pvesubscription update -force<br />
<br />
To print subscription status use<br />
<br />
* pvesubscription get <br />
<br />
<pre><br />
USAGE: pvesubscription <COMMAND> [ARGS] [OPTIONS]<br />
pvesubscription get <br />
pvesubscription set <key><br />
pvesubscription update [OPTIONS]<br />
<br />
pvesubscription help [<cmd>] [OPTIONS]<br />
</pre><br />
<br />
== Third party CLI Tools ==<br />
* [https://raymii.org/s/software/ProxBash.html ProxBash]<br />
<br />
[[Category:HOWTO]] [[Category:Installation]]</div>
Brice Burgess
https://pve.proxmox.com/mediawiki/index.php?title=Command_line_tools_-_PVE_3.x&diff=5975
Command line tools - PVE 3.x
2013-10-09T20:09:21Z
<p>Brice Burgess: /* Other useful tools */</p>
<hr />
<div>= Introduction =<br />
<br />
This page lists the important Proxmox VE and Debian command line tools. All CLI tools have also manual pages. <br />
<br />
= KVM specific =<br />
<br />
== qm ==<br />
<br />
qm - qemu/kvm manager - see [[Manual: qm]] and [[Qm manual]] <br />
<br />
= OpenVZ specific =<br />
<br />
== vzctl ==<br />
<br />
vzctl - utility to control an OpenVZ container - see [[Vzctl manual]] <br />
<br />
== vztop ==<br />
<br />
vztop - display top CPU processes<br />
<br />
<pre><br />
10:28:52 up 31 days, 11:18, 1 user, load average: 0.07, 0.06, 0.02<br />
197 processes: 196 sleeping, 1 running, 0 zombie, 0 stopped<br />
CPU0 states: 0.2% user 0.1% system 0.0% nice 0.0% iowait 99.2% idle<br />
CPU1 states: 1.3% user 2.1% system 0.0% nice 0.0% iowait 96.1% idle<br />
CPU2 states: 6.3% user 0.1% system 0.0% nice 0.0% iowait 93.1% idle<br />
CPU3 states: 2.0% user 1.0% system 0.0% nice 0.0% iowait 96.4% idle<br />
Mem: 16251688k av, 16032764k used, 218924k free, 0k shrd, 364120k buff<br />
4448576k active, 10983652k inactive<br />
Swap: 15728632k av, 36k used, 15728596k free 14170784k cached<br />
<br />
PID USER PRI NI SIZE RSS SHARE STAT %CPU %MEM TIME CPU COMMAND<br />
390694 root 20 0 759M 528M 2432 S 6.7 3.3 244:53 1 kvm<br />
566767 root 20 0 40464 8908 5320 S 6.7 0.0 0:54 0 apache2<br />
7898 root 20 0 181M 34M 4076 S 0.3 0.2 73:12 2 pvestatd<br />
1 root 20 0 10604 848 744 S 0.0 0.0 0:16 0 init<br />
2 root 20 0 0 0 0 SW 0.0 0.0 0:00 2 kthreadd<br />
3 root RT 0 0 0 0 SW 0.0 0.0 0:00 0 migration/0<br />
4 root 20 0 0 0 0 SW 0.0 0.0 0:19 0 ksoftirqd/0<br />
5 root RT 0 0 0 0 SW 0.0 0.0 0:00 0 migration/0<br />
6 root RT 0 0 0 0 SW 0.0 0.0 0:02 0 watchdog/0<br />
7 root RT 0 0 0 0 SW 0.0 0.0 0:00 1 migration/1<br />
8 root RT 0 0 0 0 SW 0.0 0.0 0:00 1 migration/1<br />
9 root 20 0 0 0 0 SW 0.0 0.0 0:24 1 ksoftirqd/1<br />
10 root RT 0 0 0 0 SW 0.0 0.0 0:01 1 watchdog/1<br />
11 root RT 0 0 0 0 SW 0.0 0.0 0:01 2 migration/2<br />
12 root RT 0 0 0 0 SW 0.0 0.0 0:00 2 migration/2<br />
13 root 20 0 0 0 0 SW 0.0 0.0 0:12 2 ksoftirqd/2<br />
14 root RT 0 0 0 0 SW 0.0 0.0 0:01 2 watchdog/2<br />
15 root RT 0 0 0 0 SW 0.0 0.0 0:07 3 migration/3<br />
..<br />
..<br />
</pre><br />
<br />
== user_beancounters ==<br />
<br />
cat /proc/user_beancounters<br />
<br />
<br />
<pre><br />
Version: 2.5<br />
uid resource held maxheld barrier limit failcnt<br />
101: kmemsize 11217945 16650240 243269632 268435456 0<br />
lockedpages 0 418 65536 65536 0<br />
privvmpages 134161 221093 9223372036854775807 9223372036854775807 0<br />
shmpages 16 3232 9223372036854775807 9223372036854775807 0<br />
dummy 0 0 0 0 0<br />
numproc 56 99 9223372036854775807 9223372036854775807 0<br />
physpages 96245 122946 0 131072 0<br />
vmguarpages 0 0 0 9223372036854775807 0<br />
oomguarpages 53689 78279 0 9223372036854775807 0<br />
numtcpsock 49 82 9223372036854775807 9223372036854775807 0<br />
numflock 8 20 9223372036854775807 9223372036854775807 0<br />
numpty 0 6 9223372036854775807 9223372036854775807 0<br />
numsiginfo 0 33 9223372036854775807 9223372036854775807 0<br />
tcpsndbuf 927856 1619344 9223372036854775807 9223372036854775807 0<br />
tcprcvbuf 802816 1343488 9223372036854775807 9223372036854775807 0<br />
othersockbuf 152592 481248 9223372036854775807 9223372036854775807 0<br />
dgramrcvbuf 0 4624 9223372036854775807 9223372036854775807 0<br />
numothersock 124 152 9223372036854775807 9223372036854775807 0<br />
dcachesize 6032652 12378728 121634816 134217728 0<br />
numfile 629 915 9223372036854775807 9223372036854775807 0<br />
dummy 0 0 0 0 0<br />
dummy 0 0 0 0 0<br />
dummy 0 0 0 0 0<br />
numiptent 20 20 9223372036854775807 9223372036854775807 0<br />
0: kmemsize 34634728 65306624 9223372036854775807 9223372036854775807 0<br />
lockedpages 1360 6721 9223372036854775807 9223372036854775807 0<br />
privvmpages 317475 507560 9223372036854775807 9223372036854775807 0<br />
shmpages 4738 9645 9223372036854775807 9223372036854775807 0<br />
dummy 0 0 9223372036854775807 9223372036854775807 0<br />
numproc 190 220 9223372036854775807 9223372036854775807 0<br />
physpages 3769163 3867750 9223372036854775807 9223372036854775807 0<br />
vmguarpages 0 0 0 0 0<br />
oomguarpages 182160 205746 9223372036854775807 9223372036854775807 0<br />
numtcpsock 12 29 9223372036854775807 9223372036854775807 0<br />
numflock 9 13 9223372036854775807 9223372036854775807 0<br />
numpty 4 12 9223372036854775807 9223372036854775807 0<br />
numsiginfo 3 84 9223372036854775807 9223372036854775807 0<br />
tcpsndbuf 249512 1760544 9223372036854775807 9223372036854775807 0<br />
tcprcvbuf 198920 1142000 9223372036854775807 9223372036854775807 0<br />
othersockbuf 233512 276832 9223372036854775807 9223372036854775807 0<br />
dgramrcvbuf 0 2576 9223372036854775807 9223372036854775807 0<br />
numothersock 179 193 9223372036854775807 9223372036854775807 0<br />
dcachesize 18688898 47058779 9223372036854775807 9223372036854775807 0<br />
numfile 1141 1410 9223372036854775807 9223372036854775807 0<br />
dummy 0 0 9223372036854775807 9223372036854775807 0<br />
dummy 0 0 9223372036854775807 9223372036854775807 0<br />
dummy 0 0 9223372036854775807 9223372036854775807 0<br />
numiptent 20 20 9223372036854775807 9223372036854775807 0<br />
<br />
</pre><br />
<br />
== vzlist ==<br />
<br />
:example:<br />
<pre>vzlist<br />
CTID NPROC STATUS IP_ADDR HOSTNAME<br />
101 26 running - localhost.fantinibakery.com<br />
102 121 running 10.100.100.18 mediawiki.fantinibakery.com<br />
114 49 running - fbc14.fantinibakery.com<br />
</pre><br />
<br />
From PVE 3.0 onwards, the display will be:<br />
<pre>vzlist<br />
CTID NPROC STATUS IP_ADDR HOSTNAME<br />
101 26 running - localhost<br />
102 121 running 10.100.100.18 mediawiki<br />
114 49 running - fbc14<br />
</pre><br />
* The fields for ('''-o''' option) selective display are: '''ctid, nproc, status, ip, hostname'''.<br />
* All are case sensitive and are used with the options '''-H''' (no header) and '''-o''' [field1, field2, ...]<br />
* The binary is at: <tt>/usr/sbin/vzlist</tt><br />
=== USAGE ===<br />
<pre><br />
Usage: vzlist [-a | -S] [-n] [-H] [-o field[,field...] | -1] [-s [-]field]<br />
[-h pattern] [-N pattern] [-d pattern] [CTID [CTID ...]]<br />
vzlist -L | --list<br />
<br />
Options:<br />
-a, --all list all containers<br />
-S, --stopped list stopped containers<br />
-n, --name display containers' names<br />
-H, --no-header suppress columns header<br />
-t, --no-trim do not trim long values<br />
-j, --json output in JSON format<br />
-o, --output output only specified fields<br />
-1 synonym for -H -octid<br />
-s, --sort sort by the specified field<br />
('-field' to reverse sort order)<br />
-h, --hostname filter CTs by hostname pattern<br />
-N, --name_filter filter CTs by name pattern<br />
-d, --description filter CTs by description pattern<br />
-L, --list get possible field names<br />
</pre><br />
<br />
= Backup =<br />
<br />
== vzdump ==<br />
<br />
vzdump - backup utility for virtual machine - see [[Vzdump manual]] <br />
<br />
== vzrestore ==<br />
<br />
vzrestore - restore OpenVZ vzdump backups - see [[Vzrestore manual]] <br />
<br />
== qmrestore ==<br />
<br />
qmrestore - restore KVM vzdump backups - see [[Qmrestore manual]] <br />
<br />
= Cluster management =<br />
<br />
== pveca ==<br />
<br />
PVE Cluster Administration Toolkit <br />
<br />
=== USAGE ===<br />
<br />
*pveca -l # show cluster status <br />
*pveca -c # create new cluster with localhost as master <br />
*pveca -s [-h IP] # sync cluster configuration from master (or IP) <br />
*pveca -d ID # delete a node <br />
*pveca -a [-h IP] # add new node to cluster <br />
*pveca -m # force local node to become master <br />
*pveca -i # print node info (CID NAME IP ROLE)<br />
<br />
= Software version check =<br />
<br />
== pveversion ==<br />
<br />
Proxmox VE version info - Print version information for Proxmox VE packages. <br />
<br />
=== USAGE ===<br />
<br />
pveversion [--verbose] <br />
<br />
*without any argument shows the version of pve-manager, something like:<br />
<br />
:pve-manager/1.5/4660<br />
or<br />
:pve-manager/3.0/957f0862<br />
<br />
*with -v argument it shows a list of programs versions related to pve, like:<br />
<br />
:pve-manager: 1.5-7 (pve-manager/1.5/4660) <br />
:running kernel: 2.6.18-2-pve <br />
:proxmox-ve-2.6.18: 1.5-5 <br />
:pve-kernel-2.6.18-2-pve: 2.6.18-5 <br />
:pve-kernel-2.6.18-1-pve: 2.6.18-4 <br />
:qemu-server: 1.1-11 <br />
:pve-firmware: 1.0-3 <br />
:libpve-storage-perl: 1.0-10 <br />
:vncterm: 0.9-2 <br />
:vzctl: 3.0.23-1pve8 <br />
:vzdump: 1.2-5 <br />
:vzprocps: 2.0.11-1dso2 <br />
:vzquota: 3.0.11-1 <br />
:pve-qemu-kvm-2.6.18: 0.9.1-5<br />
or<br />
:pve-manager: 3.0-23 (pve-manager/3.0/957f0862)<br />
:running kernel: 2.6.32-20-pve<br />
:proxmox-ve-2.6.32: 3.0-100<br />
:pve-kernel-2.6.32-20-pve: 2.6.32-100<br />
:lvm2: 2.02.95-pve3<br />
:clvm: 2.02.95-pve3<br />
:corosync-pve: 1.4.5-1<br />
:openais-pve: 1.1.4-3<br />
:libqb0: 0.11.1-2<br />
:redhat-cluster-pve: 3.2.0-2<br />
:resource-agents-pve: 3.9.2-4<br />
:fence-agents-pve: 4.0.0-1<br />
:pve-cluster: 3.0-4<br />
:qemu-server: 3.0-20<br />
:pve-firmware: 1.0-22<br />
:libpve-common-perl: 3.0-4<br />
:libpve-access-control: 3.0-4<br />
:libpve-storage-perl: 3.0-8<br />
:vncterm: 1.1-4<br />
:vzctl: 4.0-1pve3<br />
:vzprocps: 2.0.11-2<br />
:vzquota: 3.1-2<br />
:pve-qemu-kvm: 1.4-13<br />
:ksm-control-daemon: 1.1-1<br />
<br />
== aptitude ==<br />
<br />
Standard Debian package update tool <br />
<br />
= LVM =<br />
<br />
Most of the commands in LVM are very similar to each other. Each valid command is preceded by one of the following: <br />
<br />
*Physical Volume = pv <br />
*Volume Group = vg <br />
*Logical Volume = lv<br />
<br />
=== USAGE ===<br />
<br />
{| width="200" border="1" align="center" cellpadding="1" cellspacing="1"<br />
|-<br />
| '''<br>''' <br />
| <br />
| '''Physical Volume''' <br />
| '''Volume Group''' <br />
| '''Logical Volume'''<br />
|-<br />
| <br />
| '''LVM''' <br />
| '''PV''' <br />
| '''VG''' <br />
| '''LV'''<br />
|-<br />
| s <br />
| No <br />
| Yes <br />
| <br />
Yes <br />
<br />
| Yes<br />
|-<br />
| display <br />
| No <br />
| Yes <br />
| Yes <br />
| Yes<br />
|-<br />
| create <br />
| No <br />
| Yes <br />
| Yes <br />
| Yes<br />
|-<br />
| rename <br />
| No <br />
| No <br />
| Yes <br />
| Yes<br />
|-<br />
| change <br />
| Yes <br />
| Yes <br />
| Yes <br />
| Yes<br />
|-<br />
| move <br />
| No <br />
| Yes <br />
| Yes <br />
| No<br />
|-<br />
| extend <br />
| No <br />
| No <br />
| Yes <br />
| Yes<br />
|-<br />
| reduce <br />
| No <br />
| No <br />
| Yes <br />
| Yes<br />
|-<br />
| resize <br />
| No <br />
| Yes <br />
| No <br />
| Yes<br />
|-<br />
| split <br />
| No <br />
| No <br />
| Yes <br />
| No<br />
|-<br />
| merge <br />
| No <br />
| No <br />
| Yes <br />
| No<br />
|-<br />
| convert <br />
| No <br />
| No <br />
| Yes <br />
| Yes<br />
|-<br />
| import <br />
| No <br />
| No <br />
| Yes <br />
| No<br />
|-<br />
| export <br />
| No <br />
| No <br />
| Yes <br />
| No<br />
|-<br />
| importclone <br />
| No <br />
| No <br />
| Yes <br />
| No<br />
|-<br />
| cfgbackup <br />
| No <br />
| No <br />
| Yes <br />
| No<br />
|-<br />
| cfgrestore <br />
| No <br />
| No <br />
| Yes <br />
| No<br />
|-<br />
| ck <br />
| No <br />
| Yes <br />
| Yes <br />
| No<br />
|-<br />
| scan <br />
| diskscan <br />
| Yes <br />
| Yes <br />
| Yes<br />
|-<br />
| mknodes <br />
| No <br />
| No <br />
| Yes <br />
| No<br />
|-<br />
| remove <br />
| No <br />
| Yes <br />
| Yes <br />
| Yes<br />
|-<br />
| dump <br />
| Yes <br />
| No <br />
| No <br />
| No<br />
|}<br />
<br />
<br><br />
<br />
= iSCSI =<br />
<br />
= DRBD =<br />
<br />
See [[DRBD]] <br />
<br />
= Debian Appliance Builder =<br />
<br />
== dab ==<br />
<br />
See [[Debian Appliance Builder]] <br />
<br />
= Other useful tools =<br />
<br />
== pveperf ==<br />
<br />
Simple host performance test. <br />
<br />
(from man page) <br />
<br />
=== USAGE ===<br />
<br />
:pveperf [PATH]<br />
<br />
=== DESCRIPTION ===<br />
<br />
:Tries to gather some CPU/Hardisk performance data on the hardisk mounted at PATH (/ is used as default)<br />
<br />
It dumps on the terminal: <br />
<br />
*CPU BOGOMIPS: bogomips sum of all CPUs <br />
*REGEX/SECOND: regular expressions per second (perl performance test), should be above 300000 <br />
*HD SIZE: harddisk size <br />
*BUFFERED READS: simple HD read test. Modern HDs should reach at least 40 MB/sec <br />
*AVERAGE SEEK TIME: tests average seek time. Fast SCSI HDs reach values &lt; 8 milliseconds. Common IDE/SATA disks get values from 15 to 20 ms. <br />
*FSYNCS/SECOND: value should be greater than 200 (you should enable "write back" cache mode on you RAID controller - needs a battery backed cache (BBWC)). <br />
*DNS EXT: average time to resolve an external DNS name <br />
*DNS INT: average time to resolve a local DNS name<br />
<br />
Note: this command may require root privileges (or sudo) to run, otherwise you get an error after "HD SIZE" value, like: &lt;&lt;sh: /proc/sys/vm/drop_caches: Permission denied unable to open HD at /usr/bin/pveperf line 149.&gt;&gt; <br />
<br />
=== Example output ===<br />
<pre><br />
CPU BOGOMIPS: 26341.80<br />
REGEX/SECOND: 1554770<br />
HD SIZE: 94.49 GB (/dev/mapper/pve-root)<br />
BUFFERED READS: 49.83 MB/sec<br />
AVERAGE SEEK TIME: 14.16 ms<br />
FSYNCS/SECOND: 1060.47<br />
DNS EXT: 314.58 ms<br />
DNS INT: 236.94 ms (mypve.com)<br />
</pre><br />
<br />
== pvesubscription ==<br />
<br />
For managing a node's subscription key<br />
<br />
=== Usage ===<br />
<pre><br />
USAGE: pvesubscription <COMMAND> [ARGS] [OPTIONS]<br />
pvesubscription get <br />
pvesubscription set <key><br />
pvesubscription update [OPTIONS]<br />
<br />
pvesubscription help [<cmd>] [OPTIONS]<br />
</pre><br />
<br />
<br />
== Third party CLI Tools ==<br />
* [https://raymii.org/s/software/ProxBash.html ProxBash]<br />
<br />
[[Category:HOWTO]] [[Category:Installation]]</div>
Brice Burgess