add pveperf section and man page
authorFabian Gr├╝nbichler <f.gruenbichler@proxmox.com>
Fri, 7 Oct 2016 07:58:42 +0000 (09:58 +0200)
committerDietmar Maurer <dietmar@proxmox.com>
Fri, 7 Oct 2016 08:09:48 +0000 (10:09 +0200)
this is a bit ugly, because pveperf is not an instance of
PVE::CLIHandler - the actual installed man page is still
generated via the pod data contained in
pve-manager/bin/pveperf ...

Makefile
pve-admin-guide.adoc
pve-doc-generator.mk
pve-system-requirements.adoc
pveperf.1-synopsis.adoc [new file with mode: 0644]
pveperf.adoc [new file with mode: 0644]

index 21dcf29..1791ce7 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -54,7 +54,8 @@ COMMAND_LIST=         \
        pvesm           \
        pveum           \
        vzdump          \
-       ha-manager
+       ha-manager      \
+       pveperf
 
 SERVICE_LIST=          \
        pve-firewall    \
@@ -151,6 +152,7 @@ PVE_ADMIN_GUIDE_SOURCES=                    \
        ${PVEAM_MAN1_SOURCES}                   \
        ${PVESUBSCRIPTION_MAN1_SOURCES}         \
        ${PVECEPH_MAN1_SOURCES}                 \
+       ${PVEPERF_MAN1_SOURCES}                 \
        pve-bibliography.adoc                   \
        $(addsuffix .adoc, ${COMMAND_LIST})     \
        $(addsuffix .adoc, ${SERVICE_LIST})     \
index 93b204c..63a9d3c 100644 (file)
@@ -67,6 +67,8 @@ include::pveceph.adoc[]
 
 include::pvesubscription.adoc[]
 
+include::pveperf.adoc[]
+
 
 :leveloffset: 1
 
@@ -96,6 +98,14 @@ include::pvesubscription.1-synopsis.adoc[]
 
 :leveloffset: 0
 
+*pveperf* - {pve} Benchmark Script
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+:leveloffset: 1
+include::pveperf.1-synopsis.adoc[]
+
+:leveloffset: 0
+
 *pveceph* - Manage CEPH Services on {pve} Nodes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
index e8eea64..4998074 100644 (file)
@@ -139,6 +139,11 @@ PMXCFS_MAN8_SOURCES=                       \
        pmxcfs.8-cli.adoc               \
        ${PVE_COMMON_DOC_SOURCES}
 
+PVEPERF_MAN1_SOURCES=                  \
+       pveperf.adoc                    \
+       pveperf.1-synopsis.adoc         \
+       ${PVE_COMMON_DOC_SOURCES}
+
 attributes.txt docinfo.xml:
        cp ${DGDIR}/$@ $@.tmp
        mv $@.tmp $@
@@ -151,6 +156,9 @@ attributes.txt docinfo.xml:
        ${DGDIR}/gen-$*-adoc.pl >$@.tmp
        mv $@.tmp $@
 
+pveperf.1-synopsis.adoc:
+       echo '*pveperf* `[PATH]`' > pveperf.1-synopsis.adoc
+
 %.1-synopsis.adoc:
        perl -I. -e "use PVE::CLI::$(subst -,_,$*);print PVE::CLI::$(subst -,_,$*)->generate_asciidoc_synopsis();" > $@.tmp
        mv $@.tmp $@
index 64a4ac5..19ddd2c 100644 (file)
@@ -42,6 +42,16 @@ Recommended System Requirements
 
 * At least two NICs, depending on the used storage technology you need more
 
+
+Simple Performance Overview
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+On an installed {pve} system, you can run the included `pveperf` script
+to obtain an overview of the CPU and hard disk performance.
+
+NOTE: this is just a very quick and general benchmark. More detailed tests
+are recommended, especially regarding the I/O performance of your system.
+
 Supported web browsers for accessing the web interface
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 To use the web interface you need a modern browser, this includes:
diff --git a/pveperf.1-synopsis.adoc b/pveperf.1-synopsis.adoc
new file mode 100644 (file)
index 0000000..7a163e2
--- /dev/null
@@ -0,0 +1 @@
+*pveperf* `[PATH]`
diff --git a/pveperf.adoc b/pveperf.adoc
new file mode 100644 (file)
index 0000000..b0f7322
--- /dev/null
@@ -0,0 +1,48 @@
+ifdef::manvolnum[]
+PVE({manvolnum})
+================
+include::attributes.txt[]
+
+NAME
+----
+
+pveperf - the Proxmox benchmark
+
+
+SYNOPSIS
+--------
+
+include::pveperf.1-synopsis.adoc[]
+
+DESCRIPTION
+-----------
+endif::manvolnum[]
+
+ifndef::manvolnum[]
+pveperf - Proxmox VE Benchmark Script
+=====================================
+include::attributes.txt[]
+endif::manvolnum[]
+
+Tries to gather some CPU/hard disk performance data on the hard disk
+mounted at `PATH` (`/` is used as default):
+
+CPU BOGOMIPS:: bogomips sum of all CPUs
+
+REGEX/SECOND:: regular expressions per second (perl performance test), should
+be above 300000
+
+HD SIZE:: hard disk size
+
+BUFFERED READS:: simple HD read test. Modern HDs should reach at least 40
+MB/sec
+
+AVERAGE SEEK TIME:: tests average seek time. Fast SCSI HDs reach values < 8
+milliseconds. Common IDE/SATA disks get values from 15 to 20 ms.
+
+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)).
+
+DNS EXT:: average time to resolve an external DNS name
+
+DNS INT:: average time to resolve a local DNS name