pve-docs/sysadmin.adoc

[[chapter_system_administration]]
Host System Administration
==========================
ifndef::manvolnum[]
:pve-toplevel:
endif::manvolnum[]

{pve} is based on the famous https://www.debian.org/[Debian] Linux
distribution. That means that you have access to the whole world of
Debian packages, and the base system is well documented. The
https://debian-handbook.info/download/stable/debian-handbook.pdf[Debian
Administrator\'s Handbook] is available online, and provides a
comprehensive introduction to the Debian operating system (see
xref:Hertzog13[]).

A standard {pve} installation uses the default repositories from
Debian, so you get bug fixes and security updates through that
channel. In addition, we provide our own package repository to roll
out all {pve} related packages. This includes updates to some
Debian packages when necessary.

We also deliver a specially optimized Linux kernel, where we enable all
required virtualization and container features. That kernel includes
drivers for http://zfsonlinux.org/[ZFS], and several hardware drivers.
For example, we ship Intel network card drivers to support their
newest hardware.

The following sections will concentrate on virtualization related
topics. They either explains things which are different on {pve}, or
tasks which are commonly used on {pve}. For other topics, please refer
to the standard Debian documentation.


ifdef::wiki[]

See Also
--------

* link:/wiki/Package_Repositories[Package Repositories]

* link:/wiki/Network_Configuration[Network Configuration] 

* link:/wiki/System_Software_Updates[System Software Updates]

* link:/wiki/External_Metric_Server[External Metric Server]

* link:/wiki/Disk_Health_Monitoring[Disk Health Monitoring]

* link:/wiki/Logical_Volume_Manager_(LVM)[Logical Volume Manager (LVM)]

* link:/wiki/ZFS_on_Linux[ZFS on Linux]

* link:/wiki/Certificate_Management[Certificate Managment]
endif::wiki[]


ifndef::wiki[]

include::pve-package-repos.adoc[]

include::system-software-updates.adoc[]

include::pve-network.adoc[]

include::system-timesync.adoc[]

include::pve-external-metric-server.adoc[]

include::pve-disk-health-monitoring.adoc[]

include::local-lvm.adoc[]

include::local-zfs.adoc[]

include::certificate-managment.adoc[]

endif::wiki[]


////
TODO:

Working with 'systemd'
----------------------

Journal and syslog
~~~~~~~~~~~~~~~~~~

TODO: explain persistent journal...

////
use/define more/better block IDs 2016-10-13 09:40:48 +03:00			`[[chapter_system_administration]]`
add sysadmin docs 2016-01-05 12:24:31 +03:00			`Host System Administration`
			`==========================`
generate default output file mappings automatically 2016-10-14 08:18:04 +03:00			`ifndef::manvolnum[]`
mark toplevel docs 2016-10-08 18:22:48 +03:00			`:pve-toplevel:`
generate default output file mappings automatically 2016-10-14 08:18:04 +03:00			`endif::manvolnum[]`
mark toplevel docs 2016-10-08 18:22:48 +03:00
add sysadmin docs 2016-01-05 12:24:31 +03:00			`{pve} is based on the famous https://www.debian.org/[Debian] Linux`
			`distribution. That means that you have access to the whole world of`
			`Debian packages, and the base system is well documented. The`
			`https://debian-handbook.info/download/stable/debian-handbook.pdf[Debian`
typos, spelling 2016-04-26 10:26:59 +03:00			`Administrator\'s Handbook] is available online, and provides a`
add sysadmin docs 2016-01-05 12:24:31 +03:00			`comprehensive introduction to the Debian operating system (see`
			`xref:Hertzog13[]).`

			`A standard {pve} installation uses the default repositories from`
			`Debian, so you get bug fixes and security updates through that`
			`channel. In addition, we provide our own package repository to roll`
			`out all {pve} related packages. This includes updates to some`
			`Debian packages when necessary.`

			`We also deliver a specially optimized Linux kernel, where we enable all`
			`required virtualization and container features. That kernel includes`
			`drivers for http://zfsonlinux.org/[ZFS], and several hardware drivers.`
			`For example, we ship Intel network card drivers to support their`
			`newest hardware.`

			`The following sections will concentrate on virtualization related`
			`topics. They either explains things which are different on {pve}, or`
			`tasks which are commonly used on {pve}. For other topics, please refer`
			`to the standard Debian documentation.`


use/install separate wiki pages for sysadmin.adoc includes 2016-09-12 11:42:02 +03:00			`ifdef::wiki[]`

			`See Also`
			`--------`

			`* link:/wiki/Package_Repositories[Package Repositories]`

			`* link:/wiki/Network_Configuration[Network Configuration]`

			`* link:/wiki/System_Software_Updates[System Software Updates]`

add external metric server to sysadmin.adoc this did only exist as a wiki article, but since we ship with it, this should be in the reference documentation Signed-off-by: Dominik Csapak <d.csapak@proxmox.com> 2016-10-20 12:58:33 +03:00			`* link:/wiki/External_Metric_Server[External Metric Server]`

add section disk health monitoring to sysadmin chapter explain that we ship smartmontools, basic usage of smartctl default behaviour of smartd, and where to get more information Signed-off-by: Dominik Csapak <d.csapak@proxmox.com> 2016-10-06 16:49:19 +03:00			`* link:/wiki/Disk_Health_Monitoring[Disk Health Monitoring]`

include/improve new LVM page 2016-09-12 13:18:27 +03:00			`* link:/wiki/Logical_Volume_Manager_(LVM)[Logical Volume Manager (LVM)]`

use/install separate wiki pages for sysadmin.adoc includes 2016-09-12 11:42:02 +03:00			`* link:/wiki/ZFS_on_Linux[ZFS on Linux]`

add documentation for certificate managment * new section about certificate management in sysadmin chapter. * adaptation of pveproxy and pvenode documentation Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com> Co-authored-by: René Jochum <r.jochum@proxmox.com> 2018-05-09 19:56:21 +03:00			`* link:/wiki/Certificate_Management[Certificate Managment]`
use/install separate wiki pages for sysadmin.adoc includes 2016-09-12 11:42:02 +03:00			`endif::wiki[]`


			`ifndef::wiki[]`
add sysadmin docs 2016-01-05 12:24:31 +03:00
sysadmin.adoc: split into several smaller files 2016-01-19 19:03:26 +03:00			`include::pve-package-repos.adoc[]`
add sysadmin docs 2016-01-05 12:24:31 +03:00
sysadmin.adoc: split into several smaller files 2016-01-19 19:03:26 +03:00			`include::system-software-updates.adoc[]`
add section about soptware upgrades using apt-get 2016-01-17 13:35:58 +03:00
pve-network.adoc: move network docu into separate file 2016-09-12 10:50:41 +03:00			`include::pve-network.adoc[]`
add network configuration 2016-05-01 12:52:18 +03:00
sysadmin: add section about NTP configuration based on wiki article Configuration_of_Time_Syncronization_(NTP) 2016-10-07 16:28:31 +03:00			`include::system-timesync.adoc[]`

add external metric server to sysadmin.adoc this did only exist as a wiki article, but since we ship with it, this should be in the reference documentation Signed-off-by: Dominik Csapak <d.csapak@proxmox.com> 2016-10-20 12:58:33 +03:00			`include::pve-external-metric-server.adoc[]`

add section disk health monitoring to sysadmin chapter explain that we ship smartmontools, basic usage of smartctl default behaviour of smartd, and where to get more information Signed-off-by: Dominik Csapak <d.csapak@proxmox.com> 2016-10-06 16:49:19 +03:00			`include::pve-disk-health-monitoring.adoc[]`

include/improve new LVM page 2016-09-12 13:18:27 +03:00			`include::local-lvm.adoc[]`

add ZFS management docs partly imported from current wiki page. 2016-09-08 10:24:50 +03:00			`include::local-zfs.adoc[]`
add sysadmin docs 2016-01-05 12:24:31 +03:00
add documentation for certificate managment * new section about certificate management in sysadmin chapter. * adaptation of pveproxy and pvenode documentation Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com> Co-authored-by: René Jochum <r.jochum@proxmox.com> 2018-05-09 19:56:21 +03:00			`include::certificate-managment.adoc[]`

use/install separate wiki pages for sysadmin.adoc includes 2016-09-12 11:42:02 +03:00			`endif::wiki[]`

add sysadmin docs 2016-01-05 12:24:31 +03:00
add ZFS management docs partly imported from current wiki page. 2016-09-08 10:24:50 +03:00			`////`
			`TODO:`
add sysadmin docs 2016-01-05 12:24:31 +03:00
			`Working with 'systemd'`
			`----------------------`

			`Journal and syslog`
			`~~~~~~~~~~~~~~~~~~`

			`TODO: explain persistent journal...`

add network configuration 2016-05-01 12:52:18 +03:00			`////`