X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=blobdiff_plain;f=sysadmin.adoc;h=21537f1d9d9cf9eac2aa00945833ea7f89dab5a5;hp=8683aac8df91e3f5404fb76792d5f161e67cf9e9;hb=dd1aa0e01624f5927fb65143c9a070672ccbeb92;hpb=6089239a714b50b9a3c72887d4e01f3d192364d3 diff --git a/sysadmin.adoc b/sysadmin.adoc index 8683aac..21537f1 100644 --- a/sysadmin.adoc +++ b/sysadmin.adoc @@ -1,11 +1,15 @@ +[[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 provide a +Administrator\'s Handbook] is available online, and provides a comprehensive introduction to the Debian operating system (see xref:Hertzog13[]). @@ -22,218 +26,59 @@ 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 +topics. They either explain things which are different on {pve}, or tasks which are commonly used on {pve}. For other topics, please refer to the standard Debian documentation. -System requirements -------------------- -For production servers, high quality server equipment is needed. Keep -in mind, if you run 10 Virtual Servers on one machine and you then -experience a hardware failure, 10 services are lost. {pve} -supports clustering, this means that multiple {pve} installations -can be centrally managed thanks to the included cluster functionality. +ifdef::wiki[] -{pve} can use local storage (DAS), SAN, NAS and also distributed -storage (Ceph RBD). For details see xref:chapter-storage[chapter storage]. +See Also +-------- -Minimum requirements, for evaluation -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +* link:/wiki/Package_Repositories[Package Repositories] -* CPU: 64bit (Intel EMT64 or AMD64) +* link:/wiki/Network_Configuration[Network Configuration] -* RAM: 1 GB RAM +* link:/wiki/System_Software_Updates[System Software Updates] -* Hard drive +* link:/wiki/External_Metric_Server[External Metric Server] -* One NIC +* link:/wiki/Disk_Health_Monitoring[Disk Health Monitoring] -Recommended system requirements -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +* link:/wiki/Logical_Volume_Manager_(LVM)[Logical Volume Manager (LVM)] -* CPU: 64bit (Intel EMT64 or AMD64), Multi core CPU recommended +* link:/wiki/ZFS_on_Linux[ZFS on Linux] -* RAM: 8 GB is good, more is better +* link:/wiki/Certificate_Management[Certificate Management] +endif::wiki[] -* Hardware RAID with batteries protected write cache (BBU) or flash - based protection -* Fast hard drives, best results with 15k rpm SAS, Raid10 +ifndef::wiki[] -* At least two NIC´s, depending on the used storage technology you need more +include::pve-package-repos.adoc[] +include::system-software-updates.adoc[] -Getting Help ------------- +include::pve-network.adoc[] -There are basically two different support channels. {pve} itself if -fully open source, so we always encourage our users to discuss and -share their knowledge using the http://forum.proxmox.com/[Community -Support Forum]. The forum is fully moderated by the Proxmox support -team. Up to now, the forum has about 25.000 members, and more than -120.000 messages. Needless to say that such a large forum is a great -place to get information. +include::system-timesync.adoc[] -The second channel is the commercial support provided by -{proxmoxGmbh}. {pve} server subscriptions can be ordered online, see -http://shop.maurer-it.com[{pve} Shop]. For all details see -http://www.proxmox.com/proxmox-ve/pricing[{pve} Subscription Service -Plans]. +include::pve-external-metric-server.adoc[] -Please contact the mailto:office@proxmox.com[Proxmox sales team] for -commercial support requests or volume discounts. +include::pve-disk-health-monitoring.adoc[] -Package Repositories --------------------- +include::local-lvm.adoc[] -All Debian based systems use -http://en.wikipedia.org/wiki/Advanced_Packaging_Tool[APT] as package -management tool. The list of repositories is defined in -'/etc/apt/sources.list' and '.list' files found inside -'/etc/apt/sources.d/'. Updates can be installed directly using -'apt-get', or via the GUI. +include::local-zfs.adoc[] -Apt 'sources.list' files lists one package repository per line, with -the most preferred source listed first. Empty lines are ignored, and a -'#' character anywhere on a line marks the remainder of that line as a -comment. The information available from the configured sources is -acquired by 'apt-get update'. +include::certificate-management.adoc[] -.File '/etc/apt/sources.list' ----- -deb http://ftp.debian.org/debian jessie main contrib +endif::wiki[] -# security updates -deb http://security.debian.org jessie/updates main contrib ----- - -In addition, {pve} provides three different package repositories. - -{pve} Enterprise Repository -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -This is the default, stable and recommended repository, available for -all {pve} subscription users. It contains the most stable packages, -and is suitable for production use. You need a valid subscription key -to access this repository. The `pve-enterprise` repository is enabled -by default: - -.File '/etc/apt/sources.list.d/pve-enterprise.list' ----- -deb https://enterprise.proxmox.com/debian jessie pve-enterprise ----- - -NOTE: You can disable this repository by commenting out the above line -using a '#' (at the start of the line). This prevents error messages -if you do not have a subscription key. Please configure the -`pve-no-subscription` repository in that case. - -As soon as updates are available, the `root@pam` user is notified via -email about the available new packages. On the GUI, the change-log of -each package can be viewed (if available), showing all details of the -update. So you will never miss important security fixes. - -{pve} No-Subscription Repository -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -As the name suggests, you do not need a subscription key to access -this repository. It can be used for testing and non-production -use. Its not recommended to run on production servers, as these -packages are not always heavily tested and validated. - -We recommend to configure this repository in '/etc/apt/sources.list'. - -.File '/etc/apt/sources.list' ----- -deb http://ftp.debian.org/debian jessie main contrib - -# PVE pve-no-subscription repository provided by proxmox.com, -# NOT recommended for production use -deb http://download.proxmox.com/debian jessie pve-no-subscription - -# security updates -deb http://security.debian.org jessie/updates main contrib ----- - - -{pve} Test Repository -~~~~~~~~~~~~~~~~~~~~~~ - -Finally, there is a repository called `pvetest`. This one contains the -latest packages and is heavily used by developers to test new -features. As usual, you can configure this using -'/etc/apt/sources.list' by adding the following line: - -.sources.list entry for `pvetest` ----- -deb http://download.proxmox.com/debian jessie pvetest ----- - - -Installing {pve} ----------------- - -{pve} ships as a set of Debian packages, so you can simply install it -on top of a normal Debian installation. After configuring the -repositories, you need to run: - -[source,bash] ----- -apt-get update -apt-get install proxmox-ve ----- - -While this looks easy, it presumes that you have correctly installed -the base system, and you know how you want to configure and use the -local storage. Network configuration is also completely up to you. - -In general, this is not trivial, especially when you use LVM or -ZFS. This is why we provide an installation CDROM for {pve}. That -installer just ask you a few questions, then partitions the local -disk(s), installs all required packages, and configures the system -including a basic network setup. You can get a fully functional system -within a few minutes, including the following: - -* Complete operating system (Debian Linux, 64-bit) -* Partition the hard drive with ext4 (alternative ext3 or xfs) or ZFS -* {pve} Kernel with LXC and KVM support -* Complete toolset -* Web based management interface - -NOTE: By default, the complete server is used and all existing data is -removed. - -Further configuration is done via the Proxmox web interface. Just -point your browser to the IP address given during installation -(https://youripaddress:8006). Proxmox VE is tested for IE9, Firefox 10 -and higher, Google Chrome (latest). - - -Network Configuration ---------------------- - -Basic network setup. - -image::images/cluster-nwdiag.svg[{pve} Cluster Network] - -image::images/node-nwdiag.svg[{pve} Default Network Setup] - - -Local Storage -------------- - -Logical Volume Manager (LVM) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -TODO: info about LVM. - - -ZFS on Linux -~~~~~~~~~~~~ - -TODO: info about ZFS. +//// +TODO: Working with 'systemd' ---------------------- @@ -243,9 +88,4 @@ Journal and syslog TODO: explain persistent journal... - - - - - - +////