debian-handbook.pdf - The Debian Administratoru2019s...

Unformatted text preview: The Debian Administrator’s Handbook Debian Buster from Discovery to Mastery Raphaël Hertzog and Roland Mas Freexian SARL Sorbiers The Debian Administrator’s Handbook Raphaël Hertzog and Roland Mas Copyright © 2003-2020 Raphaël Hertzog Copyright © 2006-2015 Roland Mas Copyright © 2012-2020 Freexian SARL ISBN: 979-10-91414-19-7 (English paperback) ISBN: 979-10-91414-20-3 (English ebook) This book is available under the terms of two licenses compatible with the Debian Free Software Guidelines. Creative Commons License Notice: This book is licensed under a Creative Commons AttributionShareAlike 3.0 Unported License. è GNU General Public License Notice: This book is free documentation: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version. This book is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . Show your appreciation This book is published under a free license because we want everybody to benefit from it. That said maintaining it takes time and lots of effort, and we appreciate being thanked for this. If you find this book valuable, please consider contributing to its continued maintenance either by buying a paperback copy or by making a donation through the book’s official website: è Table of Contents 1. The Debian Project . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 2 4 4 5 5 6 9 9 13 14 15 15 17 17 18 19 20 21 23 23 23 24 24 24 26 27 30 . . . . 33 34 34 35 37 1.1 What Is Debian? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ....... ........... 1.1.3 The Legal Framework: A Non-Profit Organization . 1.2 The Foundation Documents . . . . . . . . . . . . 1.2.1 The Commitment towards Users . . . . . . . . . 1.2.2 The Debian Free Software Guidelines . . . . . . . 1.3 The Inner Workings of the Debian Project . . . 1.3.1 The Debian Developers . . . . . . . . . . . . . . 1.3.2 The Active Role of Users . . . . . . . . . . . . . Reporting bugs . . . . . . . . . . . . . . . . Translation and documentation . . . . . . . . Sending fixes . . . . . . . . . . . . . . . . Other ways of contributing . . . . . . . . . . 1.3.3 Teams and Sub-Projects . . . . . . . . . . . . . Existing Debian Sub-Projects . . . . . . . . . Administrative Teams . . . . . . . . . . . . . Development Teams, Transversal Teams . . . . . 1.4 Follow Debian News . . . . . . . . . . . . . . . . . 1.5 The Role of Distributions . . . . . . . . . . . . . . 1.5.1 The Installer: debian-installer . . . . . . . . . 1.5.2 The Software Library . . . . . . . . . . . . . . . 1.6 Lifecycle of a Release . . . . . . . . . . . . . . . . 1.6.1 The Experimental Status . . . . . . . . . . . . . 1.6.2 The Unstable Status . . . . . . . . . . . . . . . 1.6.3 Migration to Testing . . . . . . . . . . . . . . . 1.6.4 The Promotion from Testing to Stable . . . . . . 1.6.5 The Oldstable and Oldoldstable Status . . . . . . 1.1.1 A Multi-Platform Operating System 1.1.2 The Quality of Free Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. Presenting the Case Study 2.1 Fast Growing IT Needs . . . . . . 2.2 Master Plan . . . . . . . . . . . . . 2.3 Why a GNU/Linux Distribution? 2.4 Why the Debian Distribution? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ........................... 2.5 Why Debian Buster? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.4.1 Commercial and Community Driven Distributions 3. Analyzing the Existing Setup and Migrating . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 42 42 42 42 43 43 43 44 45 46 47 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 52 52 53 54 54 54 54 56 57 58 58 58 59 59 59 60 61 61 61 63 65 67 67 68 69 69 70 71 3.1 Coexistence in Heterogeneous Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ..... ....... 3.1.3 Integration with Other Linux/Unix Machines . 3.2 How To Migrate . . . . . . . . . . . . . . . . . 3.2.1 Survey and Identify Services . . . . . . . . . Network and Processes . . . . . . . . . . 3.2.2 Backing up the Configuration . . . . . . . . 3.2.3 Taking Over an Existing Debian Server . . . . 3.2.4 Installing Debian . . . . . . . . . . . . . . . 3.1.1 Integration with Windows Machines 3.1.2 Integration with OS X machines 3.2.5 Installing and Configuring the Selected Services 4. Installation ........... 4.1.1 Installing from a CD-ROM/DVD-ROM . 4.1.2 Booting from a USB Key . . . . . . . . 4.1.3 Installing through Network Booting . . 4.1.4 Other Installation Methods . . . . . . . 4.2 Installing, Step by Step . . . . . . . . . . 4.2.1 Booting and Starting the Installer . . . 4.2.2 Selecting the language . . . . . . . . . 4.2.3 Selecting the country . . . . . . . . . . 4.2.4 Selecting the keyboard layout . . . . . 4.2.5 Detecting Hardware . . . . . . . . . . 4.2.6 Loading Components . . . . . . . . . . 4.2.7 Detecting Network Hardware . . . . . 4.2.8 Configuring the Network . . . . . . . . 4.2.9 Administrator Password . . . . . . . . 4.2.10 Creating the First User . . . . . . . . 4.2.11 Configuring the Clock . . . . . . . . . 4.2.12 Detecting Disks and Other Devices . . 4.2.13 Starting the Partitioning Tool . . . . . Guided partitioning . . . . . . . . . Manual Partitioning . . . . . . . . 4.1 Installation Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring Multidisk Devices (Software RAID) Configuring the Logical Volume Manager (LVM) ..... 4.2.14 Installing the Base System . . . . . . . . 4.2.15 Configuring the Package Manager (apt) . . 4.2.16 Debian Package Popularity Contest . . . . 4.2.17 Selecting Packages for Installation . . . . . Setting Up Encrypted Partitions IV The Debian Administrator’s Handbook . . . . . 37 38 . . . . . ..... 4.2.19 Finishing the Installation and Rebooting . 4.3 After the First Boot . . . . . . . . . . . . . 4.3.1 Installing Additional Software . . . . . . 4.3.2 Upgrading the System . . . . . . . . . . 4.2.18 Installing the GRUB Bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5. Packaging System: Tools and Fundamental Principles . . . . . . . . . . . . . . . . . . . . . . 77 78 80 80 81 83 83 84 86 86 87 87 89 90 90 93 94 94 96 96 101 101 101 102 103 . . . . . . . . . . . . 107 108 108 110 111 111 112 112 112 113 114 114 115 5.1 Structure of a Binary Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.2 Package Meta-Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ...... .... Conflicts: the Conflicts field . . . . . . Incompatibilities: the Breaks Field . . . Provided Items: the Provides Field . . . Replacing Files: The Replaces Field . . . 5.2.2 Configuration Scripts . . . . . . . . . . . Installation and Upgrade . . . . . . . Package Removal . . . . . . . . . . . 5.2.3 Checksums, List of Configuration Files . . 5.3 Structure of a Source Package . . . . . . . 5.3.1 Format . . . . . . . . . . . . . . . . . . 5.3.2 Usage within Debian . . . . . . . . . . . 5.4 Manipulating Packages with dpkg . . . . 5.4.1 Installing Packages . . . . . . . . . . . . 5.4.2 Package Removal . . . . . . . . . . . . . 5.2.1 Description: the control File Dependencies: the Depends Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.4.3 Querying dpkg’s Database and Inspecting .deb Files ......... ...... Enabling Multi-Arch . . . . Multi-Arch Related Changes . . . . . 5.5 Coexistence with Other Packaging Systems . 5.4.4 dpkg’s Log File 5.4.5 Multi-Arch Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6. Maintenance and Updates: The APT Tools . . . . . . . 6.1.3 Repositories for Testing /Unstable Users . The Experimental Repository . . . . . 6.1.4 Using Alternate Mirrors . . . . . . . . . . . . . . . . . . . 6.1.5 Non-Official Resources: mentors.debian.net . 6.1.6 Caching Proxy for Debian Packages . . . . . 6.1 Filling in the sources.list File ............ 6.1.2 Repositories for Stable Users . Security Updates . . . . . Stable Updates . . . . . . Proposed Updates . . . . Stable Backports . . . . . 6.1.1 Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 73 73 73 74 Table of Contents V 6.2 aptitude, apt-get, and apt Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 ....... . 6.2.3 System Upgrade . . . . . 6.2.4 Configuration Options . . . . . . 6.2.5 Managing Package Priorities . 6.2.6 Working with Several Distributions . 6.2.7 Tracking Automatically Installed Packages . 6.3 The apt-cache Command . . . . . . . . . . 6.4 The apt-file Command . . . . . . . . . . . 6.5 Frontends: aptitude, synaptic . . . . . . 6.5.1 aptitude . . . . . . . . . . . . . . . . . Managing Recommendations, Suggestions and Tasks . Better Solver Algorithms . . . . . . . . . . . . . 6.5.2 synaptic . . . . . . . . . . . . . . . . . . . . . . 6.6 Checking Package Authenticity . . . . . . . . . . . . 6.2.1 Initialization 6.2.2 Installing and Removing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.7 Upgrading from One Stable Distribution to the Next ............ ....... 6.7.3 Cleaning Up after an Upgrade . . . . . . . . . . Packages removed from the Debian Archive . . . Dummy and Transitional Packages . . . . . . . Old or Unused Configuration Files . . . . . . . Files not owned by any Package . . . . . . . . 6.8 Keeping a System Up to Date . . . . . . . . . . . 6.9 Automatic Upgrades . . . . . . . . . . . . . . . . . 6.9.1 Configuring dpkg . . . . . . . . . . . . . . . . 6.9.2 Configuring APT . . . . . . . . . . . . . . . . . 6.9.3 Configuring debconf . . . . . . . . . . . . . . . 6.9.4 Handling Command Line Interactions . . . . . . 6.9.5 The Miracle Combination . . . . . . . . . . . . 6.10 Searching for Packages . . . . . . . . . . . . . . 6.7.1 Recommended Procedure 6.7.2 Handling Problems after an Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7. Solving Problems and Finding Relevant Information 116 117 120 120 121 124 125 126 128 128 128 130 131 131 132 134 134 135 136 137 137 137 138 138 140 140 141 141 141 141 142 147 7.1 Documentation Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 ...... ..... 7.1.3 Specific Documentation . 7.1.4 Websites . . . . . . . . . 7.1.5 Tutorials (HOWTO ) . . . 7.2 Common Procedures . . . . 7.2.1 Configuring a Program . . . . . . . . . 7.2.2 Monitoring What Daemons Are Doing . 7.2.3 Asking for Help on a Mailing List . . . . 7.1.1 Manual Pages 7.1.2 info Documents VI The Debian Administrator’s Handbook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 150 151 151 152 153 153 154 155 7.2.4 Reporting a Bug When a Problem Is Too Difficult . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 8. Basic Configuration: Network, Accounts, Printing… 8.1 Configuring the System for Another Language 8.1.1 Setting the Default Language 8.1.2 Configuring the Keyboard ... 8.2 Configuring the Network . 8.2.1 Ethernet Interface . . . 8.2.2 Wireless Interface . . . 8.1.3 Migrating to UTF-8 . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing the required firmwares . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wireless specific entries in /etc/network/interfaces 8.2.3 Connecting with PPP through a PSTN Modem . Modems Supporting PPPOE . . . . . Mode...
View Full Document