From 8f659dc0f2a285a28b1353e5e2f79379cbc0abcc Mon Sep 17 00:00:00 2001
From: Mitch <watchthepuppetshow@gmail.com>
Date: Sun, 14 Jul 2019 14:33:52 -0400
Subject: [PATCH 1/4] Update and rename README to README.MD
---
README => README.MD | 110 ++++++++++++++++++++++++--------------------
1 file changed, 60 insertions(+), 50 deletions(-)
rename README => README.MD (75%)
diff --git a/README b/README.MD
similarity index 75%
rename from README
rename to README.MD
index 3b88446d9c..c980a42cd2 100644
--- a/README
+++ b/README.MD
@@ -1,6 +1,15 @@
-Amanda (The Advanced Maryland Automatic Network Disk Archiver) Backup
-Software
-
+# Amanda Backup Software
+## (The Advanced Maryland Automatic Network Disk Archiver)
+
+[License](#license)
+[What is Amanda?](#what-is-amanda)
+[Requirements](#requirements)
+[Supported Systems](#supported-systems)
+[Download](#download)
+[Running it](#running-it)
+[Community](#community)
+
+## License
Copyright (c) 1991-1998 University of Maryland at College Park
Copyright (c) 2007-2012 Zmanda, Inc. All Rights Reserved.
All Rights Reserved.
@@ -10,109 +19,108 @@ no warranties that it will work for you. As such there is no support
available other than users helping each other on the Amanda mailing
lists or forums. Formal support may be available through vendors.
+[TOP](#amanda-backup-software)
-WHAT IS AMANDA?
----------------
-
+## What is Amanda?
Amanda is a backup system designed to backup and archive many
computers on a network to disk, tape changer/drive or cloud storage.
Here are some features of Amanda:
- * Written in C and Perl.
+ - Written in C and Perl.
- * Freely distributable source and executable. University of Maryland
+ - Freely distributable source and executable. University of Maryland
(BSD style) license and GPL.
- * Built on top of standard backup software: Unix dump/restore, GNU
+ - Built on top of standard backup software: Unix dump/restore, GNU
Tar and other archival tools. It is extensible to support new
archival applications.
- * Open file and tape formats. If necessary, you can use standard
+ - Open file and tape formats. If necessary, you can use standard
tools like mt and GNU Tar to recover data.
- * Backs up 32 and 64 bit Windows machines.
+ - Backs up 32 and 64 bit Windows machines.
- * Will back up multiple machines in parallel to a holding disk. Once
+ - Will back up multiple machines in parallel to a holding disk. Once
a dump is complete, Amanda will copy finished dumps one by one to
virtual tape on a disk or tape as fast as it can. For example:
- * A 30 GB backup to virtual tape on disk may take less than 75
+ - A 30 GB backup to virtual tape on disk may take less than 75
minutes.
- * A 41GB backup to AIT5 (25MB/s transfer) may take 40 minutes of
+ - A 41GB backup to AIT5 (25MB/s transfer) may take 40 minutes of
tape time.
- * Maintains a catalog of files being backed up and their location on
+ - Maintains a catalog of files being backed up and their location on
the media.
- * Does tape management: e.g. Amanda will not overwrite the wrong
+ - Does tape management: e.g. Amanda will not overwrite the wrong
tape.
- * For a restore, tells you what tapes you need, and finds the proper
+ - For a restore, tells you what tapes you need, and finds the proper
backup image on the tape for you.
- * Supports tape changers via a generic interface. Easily
+ - Supports tape changers via a generic interface. Easily
customizable to any type of tape library, carousel, robot,
stacker, or virtual tape that can be controlled via the unix
command line.
- * Device API provides a pluggable interface to storage
+ - Device API provides a pluggable interface to storage
devices. Bundled drivers support tapes and virtual tapes on disk,
DVD-RW, RAIT, and Amazon S3. The bundled amvault can then copy to
removable media for off-site (D2D2T) or cloud storage (D2D2C).
- * Supports secure communication between server and client using
+ - Supports secure communication between server and client using
OpenSSH, allowing secure backup of machines in a DMZ or out in the
Internet.
- * Can encrypt backup archives on Amanda client or on Amanda server
+ - Can encrypt backup archives on Amanda client or on Amanda server
using GPG or any encryption program.
- * Can compress backup archives before sending or after sending over
+ - Can compress backup archives before sending or after sending over
the network, with compress, gzip or a custom program.
- * Supports Kerberos 5 security, including encrypted dumps.
+ - Supports Kerberos 5 security, including encrypted dumps.
- * Recovers gracefully from errors, including down or hung machines.
+ - Recovers gracefully from errors, including down or hung machines.
- * Reports results in detail, including all errors, via email.
+ - Reports results in detail, including all errors, via email.
- * Dynamically adjusts the backup schedule to keep within
+ - Dynamically adjusts the backup schedule to keep within
constraints: no more juggling by hand when adding disks and
computers to your network.
- * Backup normalization: Amanda schedules full and incremental
+ - Backup normalization: Amanda schedules full and incremental
backups so you don't have to, and so as to spread the load across
the backup cycle. Amanda will intelligently promote a backup level
in case it is determines that is optimal for resources.
- * Includes a pre-run checker program, that conducts sanity checks on
+ - Includes a pre-run checker program, that conducts sanity checks on
both the tape server host and all the client hosts (in parallel),
and will send an e-mail report of any problems that could cause
the backups to fail.
- * IPv6 friendly.
+ - IPv6 friendly.
- * Runs transparently from cron as needed.
+ - Runs transparently from cron as needed.
- * Span tapes, i.e. if a single backup is too large for one tape,
+ - Span tapes, i.e. if a single backup is too large for one tape,
Amanda will split it and put the pieces on multiple tapes
automatically.
- * Application API allows custom backups for applications such as
+ - Application API allows custom backups for applications such as
relational databases, or for special file systems.
- * Executes user-provided pre- and post-backup scripts, for,
+ - Executes user-provided pre- and post-backup scripts, for,
e.g. enforcing database referential integrity.
- * Award-winning! Including: Linux Journal Readers' Choice Award.
+ - Award-winning! Including: Linux Journal Readers' Choice Award.
- * Lots of other options; Amanda is very configurable.
+ - Lots of other options; Amanda is very configurable.
-WHAT ARE THE SYSTEM REQUIREMENTS FOR AMANDA?
---------------------------------------------
+[TOP](#amanda-backup-software)
+## Requirements
Amanda requires a host that has access to disks (local, NAS or SAN) or
a large capacity tape drive or library. All modern tape formats,
e.g. LTO, EXABYTE, DAT or DLT are supported. This becomes the "backup
@@ -142,10 +150,9 @@ larger than the holding disk: Amanda will send those dumps directly to
tape one at a time. If you have many such dumps you will be limited
by the dump speed of those machines.
+[TOP](#amanda-backup-software)
-WHAT SYSTEMS DOES AMANDA RUN ON?
---------------------------------
-
+## Supported systems
Amanda should run on any modern Unix system that supports dump or GNU
tar, has sockets and inetd (or a replacement such as xinetd), and
either system V shared memory, or BSD mmap implemented.
@@ -161,25 +168,24 @@ the following systems:
HP-UX 9.x and 10.x (x >= 01)
IRIX 6.5.2 and up
NetBSD 1.0
- Nextstep 3 (*)
+ Nextstep 3 (\*)
OpenBSD 2.5 x86, sparc, etc (ports available)
Solaris 10
Ultrix 4.2
Mac OS X 10
Windows: XP Pro (Server pack 2), 2003 server, Vista, 2008
- server R2, Windows 7 (*)
+ server R2, Windows 7 (\*)
-(*) The Amanda server side is known to run on all of the other
+(\*) The Amanda server side is known to run on all of the other
machines except on those marked with an asterisk.
Backup operations can be CPU and Memory intensive (e.g. for
compression and encryption operations). It is recommended that you
have a server class CPU in the backup server.
+[TOP](#amanda-backup-software)
-WHERE DO I GET AMANDA?
-----------------------
-
+## Download
Amanda, including its source tree, is on SourceForge:
http://sourceforge.net/projects/amanda
@@ -193,8 +199,9 @@ available at:
http://www.zmanda.com/download-amanda.php
-HOW DO I GET AMANDA UP AND RUNNING?
------------------------------------
+[TOP](#amanda-backup-software)
+
+## Running it
Read the file docs/INSTALL. There are a variety of steps, from
compiling Amanda to installing it on the backup server host and the
@@ -211,8 +218,9 @@ and at the Amanda wiki:
http://wiki.zmanda.com
-WHO DO I TALK TO IF I HAVE A PROBLEM?
--------------------------------------
+[TOP](#amanda-backup-software)
+
+## Community
You can get Amanda help and questions answered from the mailing lists and
Amanda forums:
@@ -253,3 +261,5 @@ Amanda Platform Experts: http://wiki.zmanda.com/index.php/Platform_Experts
Backup, Share and Enjoy,
The Amanda Development Team
+
+[TOP](#amanda-backup-software)
From 6cf03ffb9564747e5d59783228e26a2b59cc3961 Mon Sep 17 00:00:00 2001
From: Mitch <watchthepuppetshow@gmail.com>
Date: Sun, 14 Jul 2019 14:34:18 -0400
Subject: [PATCH 2/4] Update README.MD
---
README.MD | 14 +++++++-------
1 file changed, 7 insertions(+), 7 deletions(-)
diff --git a/README.MD b/README.MD
index c980a42cd2..412a12ded3 100644
--- a/README.MD
+++ b/README.MD
@@ -1,13 +1,13 @@
# Amanda Backup Software
## (The Advanced Maryland Automatic Network Disk Archiver)
-[License](#license)
-[What is Amanda?](#what-is-amanda)
-[Requirements](#requirements)
-[Supported Systems](#supported-systems)
-[Download](#download)
-[Running it](#running-it)
-[Community](#community)
+- [License](#license)
+- [What is Amanda?](#what-is-amanda)
+- [Requirements](#requirements)
+- [Supported Systems](#supported-systems)
+- [Download](#download)
+- [Running it](#running-it)
+- [Community](#community)
## License
Copyright (c) 1991-1998 University of Maryland at College Park
From c064e2a38966a4682aa5641e928400f737769ea8 Mon Sep 17 00:00:00 2001
From: Mitch <watchthepuppetshow@gmail.com>
Date: Thu, 18 Jul 2019 03:26:08 -0400
Subject: [PATCH 3/4] Updated file extension from MD to md
---
README.MD => README.md | 0
1 file changed, 0 insertions(+), 0 deletions(-)
rename README.MD => README.md (100%)
diff --git a/README.MD b/README.md
similarity index 100%
rename from README.MD
rename to README.md
From 16a7fe8ca2b71db55247546708b73b363157b7dd Mon Sep 17 00:00:00 2001
From: Mitch <watchthepuppetshow@gmail.com>
Date: Thu, 22 Aug 2019 13:31:54 -0400
Subject: [PATCH 4/4] Fixed email strings
Should we request people contact LISTNAME-request@amanda.org if amanda-lists@amanda.org is more general and we already request the list name in the body of the message?
---
README.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/README.md b/README.md
index 412a12ded3..bb3a909992 100644
--- a/README.md
+++ b/README.md
@@ -226,9 +226,9 @@ You can get Amanda help and questions answered from the mailing lists and
Amanda forums:
==> To join a mailing list, DO NOT, EVER, send mail to that list. Send
- mail to <listname>-request@amanda.org, or amanda-lists@amanda.org,
+ mail to *LISTNAME*-request@amanda.org, or amanda-lists@amanda.org
with the following line in the body of the message:
- subscribe <listname> <your-email-address>
+ subscribe *LISTNAME* *YOUR_EMAIL_ADDRESS*
You will receive an email acknowledging your subscription. Keep
it. Should you ever wish to depart our company, it has unsubscribe