Imported Upstream version 2.5.2p1
[debian/amanda] / docs / index.txt
index 9ab300f7e3242c879d1e4af9b51c201542325a5a..0c84738a1c3f5e8d175943aa743ea4e26de58b2a 100644 (file)
@@ -13,9 +13,15 @@ Edited by
 
 Stefan G. Weichinger
 
-
 AMANDA Core Team
+<sgw@amanda.org>
+
+Edited by
+
 
+Amanda Core Team
+
+AMANDA Core Team
 -------------------------------------------------------------------------------
 Table of Contents
 
@@ -29,11 +35,13 @@ Table of Contents
   I._Installation
 
 
-        1._AMANDA_2.4.x_-_System-Specific_Installation_Notes
+        1._Amanda_2.5.0_-_System-Specific_Installation_Notes
 
 
               Solaris_2.6
 
+              Solaris
+
               Trusted_Solaris
 
               SunOS_4.x
@@ -69,14 +77,14 @@ Table of Contents
               Mac_OS_X
 
 
-        2._AMANDA_Installation_Notes
+        2._Amanda_Installation_Notes
 
 
               Before_doing_anything
 
-              Compiling_the_AMANDA_sources
+              Compiling_the_Amanda_sources
 
-              Setting_up_your_AMANDA_Configuration
+              Setting_up_your_Amanda_Configuration
 
 
                     Setting_up_the_Tape_Server_Host
@@ -113,7 +121,7 @@ Table of Contents
 
 
 
-        4._Indexing_with_AMANDA
+        4._Indexing_with_Amanda
 
 
               Database_Format
@@ -161,7 +169,7 @@ Table of Contents
 
         7._Tapetypes
 
-        8._AMANDA_Tape_Changer_Support
+        8._Amanda_Tape_Changer_Support
 
 
               Introduction
@@ -217,7 +225,7 @@ Table of Contents
 
               Notes_about_changer.conf
 
-              AMANDA's_actual_usage_of_chg-scsi
+              Amanda's_actual_usage_of_chg-scsi
 
               Configuration_notes
 
@@ -250,14 +258,14 @@ Table of Contents
   III._HOWTOs
 
 
-        12._AMANDA_on_Cygwin_HOWTO
+        12._Amanda_on_Cygwin_HOWTO
 
 
               Install_Cygwin
 
               Other_Preparation
 
-              Compile_AMANDA
+              Compile_Amanda
 
               Configure_Cygwin_files
 
@@ -269,7 +277,7 @@ Table of Contents
 
               Windows_NT/2000/XP
 
-              Notes_on_AMANDA_backup_options
+              Notes_on_Amanda_backup_options
 
 
                     Compression
@@ -280,7 +288,7 @@ Table of Contents
 
 
 
-        13._How_to_use_the_AMANDA_file-driver
+        13._How_to_use_the_Amanda_file-driver
 
 
               Introduction
@@ -298,168 +306,139 @@ Table of Contents
 
         14._AFS_HOWTO
 
+        15._How_to_use_a_wrapper
 
-  IV._Various_Information
 
+              Bert_de_Ridder's_suggestions
 
-        15._Using_AMANDA
+              Paul_Bijnens's_suggestions
 
 
-              An_Introduction
+        16._How_to_do_Amanda-server-side_gpg-encrypted_backups.
 
-              AMANDA_Features
 
-              Future_Capabilities_of_AMANDA
+              Setup
 
-              AMANDA_Resources
+              Test
 
-              Installing_AMANDA
+              Plans
 
 
-                    Install_Related_Packages
+        17._How_to_use_different_auth_with_Amanda
 
-                    Perform_Preliminary_Setup
 
-                    Configure_the_AMANDA_Build
+              Introduction
 
-                    Build_and_Install_AMANDA
+              BSD
 
-                    Configuring_AMANDA
+              BSDTCP
 
-                    Decide_on_a_Tape_Server
+              BSDUDP
 
-                    Decide_Which_Tape_Devices_to_Use
+              KRB4
 
-                    Decide_Whether_to_Use_Compression
+              KRB5
 
-                    Decide_Where_the_Holding_Space_Will_Be
+              RSH
 
-                    Compute_Your_Dump_Cycle
+              SSH
 
-                    Copy_and_Edit_the_Default_Configuration_File
 
-                    Configure_the_Holding_Disk
-
-                    Configure_Tape_Devices_and_Label_Tapes
+                    For_amdump:
 
-                    Configure_Backup_Clients
+                    For_amrecover:
 
-                    Test_and_Debug_Setup
 
 
-              Operating_Amanda
 
+  IV._Various_Information
 
-                    Run_amdump
 
-                    Read_AMANDA's_Reports
+        18._Using_Amanda
 
-                    Monitor_Tape_and_Holding_Disk_Status
 
-                    Adding_Tapes_at_a_Particular_Position_in_the_Cycle
-
-                    Miscellanous_Operational_Notes
+              An_Introduction
 
+              Amanda_Features
 
-              Advanced_AMANDA_Configuration
+              Future_Capabilities_of_Amanda
 
+              Amanda_Resources
 
-                    Adjust_the_Backup_Cycle
+              Installing_Amanda
 
-                    Adjust_Parallelism
-
-                    Monitor_for_Possible_Improvements
 
-                    Excluding_Files
+                    Install_Related_Packages
 
+                    Perform_Preliminary_Setup
 
-              Restoring_with_AMANDA
+                    Configure_the_Amanda_Build
 
+                    Build_and_Install_Amanda
 
-                    Configuring_and_Using_amrecover
+                    Configuring_Amanda
 
-                    Using_amrestore
+                    Decide_on_a_Tape_Server
 
-                    Restoring_Without_AMANDA
+                    Decide_Which_Tape_Devices_to_Use
 
+                    Decide_Whether_to_Use_Compression
 
+                    Decide_Where_the_Holding_Space_Will_Be
 
-        16._AMANDA_FAQ
+                    Compute_Your_Dump_Cycle
 
+                    Copy_and_Edit_the_Default_Configuration_File
 
-              QUESTION:_Why_does_AMANDA_fail_to_build_on_my_system?
+                    Configure_the_Holding_Disk
 
-              QUESTION:_Why_does_amdump_report_that_all_disks_failed?
+                    Configure_Tape_Devices_and_Label_Tapes
 
-              QUESTION:_Why_does_amcheck_say_"port_NNN_is_not_secure"?
+                    Configure_Backup_Clients
 
-              QUESTION:_Why_does_amcheck_claim_that_the_tape_is_"not_an_amanda
-              tape"?
+                    Test_and_Debug_Setup
 
-              QUESTION:_Why_does_amcheck_report_"selfcheck_request_timed_out"?
 
-              QUESTION:_Why_does_amandad.debug_contain_"error_receiving
-              message"?
+              Operating_Amanda
 
-              QUESTION:_Why_does_amcheck_say_"access_as_<username>_not
-              allowed..."?
 
-              QUESTION:_Why_does_amcheck_report_"ip_address_#.#.#.#"_is_not_in
-              the_ip_list_list_for_<hostname>'?
+                    Run_amdump
 
-              QUESTION:_Why_does_amcheck_say_"cannot_overwrite_active_tape"?
+                    Read_Amanda's_Reports
 
-              QUESTION:_Why_does_amcheck_tell_me_"DUMP_program_not_available"?
+                    Monitor_Tape_and_Holding_Disk_Status
 
-              QUESTION:_Which_tape_changer_configuration_should_I_use_in
-              amanda.conf?
+                    Adding_Tapes_at_a_Particular_Position_in_the_Cycle
 
-              QUESTION:_Should_I_use_software_or_hardware_compression?
+                    Miscellanous_Operational_Notes
 
-              QUESTION:_How_can_I_configure_AMANDA_so_that_it_performs_full
-              backups_on_the_week-end_and_incrementals_on_weekdays?
 
-              QUESTION:_What_if_my_tape_unit_uses_expensive_tapes,_and_I_don't
-              want_to_use_one_tape_per_day?_Can't_AMANDA_append_to_tapes?
+              Advanced_Amanda_Configuration
 
-              QUESTION:_How_can_I_configure_AMANDA_for_long-term_archiving?
 
-              QUESTION:_Can_I_backup_separate_disks_of_the_same_host_in
-              different_configurations?
+                    Adjust_the_Backup_Cycle
 
-              QUESTION:_Can_AMANDA_span_large_filesystems_across_multiple
-              tapes?
+                    Adjust_Parallelism
 
-              QUESTION:_What's_the_difference_between_option_"skip-full"_and
-              "strategy_nofull"?
+                    Monitor_for_Possible_Improvements
 
-              QUESTION:_Why_does_amdump_report_"results_missing"?
+                    Excluding_Files
 
-              QUESTION:_Why_does_amdump_report_"disk_offline"?
 
-              QUESTION:_What_if_amdump_reports_"dumps_way_too_big,_must_skip
-              incremental_dumps"?
+              Restoring_with_Amanda
 
-              QUESTION:_amdump_reported_"infofile_update_failed"._What_should_I
-              do?
 
-              QUESTION:_Why_does_AMANDA_sometimes_promote_full_dumps?
+                    Configuring_and_Using_amrecover
 
-              QUESTION:_Why_does_amrecover_report_"no_index_records"_or_"disk
-              not_found"?
+                    Using_amrestore
 
-              QUESTION:_Ok,_I'm_done_with_testing_AMANDA,_now_I_want_to_put_it
-              in_production._How_can_I_reset_its_databases_so_as_to_start_from
-              scratch?
+                    Restoring_Without_Amanda
 
-              QUESTION:_The_man-page_of_dump_says_that_active_filesystems_may
-              be_backed_up_inconsistently._What_does_AMANDA_do_to_prevent
-              inconsistent_backups?
 
-              QUESTION:_Which_version_of_GNU-tar_should_I_use?
 
+        19._Amanda_FAQ
 
-        17._Collection_of_the_top_ten_AMANDA_questions._And_answers.
+        20._Collection_of_the_top_ten_Amanda_questions._And_answers.
 
 
               Reason_for_starting_this_list.
@@ -489,15 +468,13 @@ Table of Contents
               ...
 
 
-        18._AMANDA_WISHLIST
-
-        19._AMANDA_Survey_Results
+        21._Amanda_WISHLIST
 
 
   V._Technical_Background
 
 
-        20._How_AMANDA_uses_UDP_and_TCP_ports
+        22._How_Amanda_uses_UDP_and_TCP_ports
 
 
               TCP_port_allocation
@@ -511,7 +488,7 @@ Table of Contents
               Firewalls_and_NAT
 
 
-        21._AMANDA_dumper_API
+        23._Amanda_dumper_API
 
 
               Introduction
@@ -539,7 +516,7 @@ Table of Contents
               Conclusion
 
 
-        22._AMANDA_Internals
+        24._Amanda_Internals
 
 
               Protocols
@@ -553,7 +530,7 @@ Table of Contents
               taper(read)_and_taper(write)
 
 
-        23._AMANDA_Event_API
+        25._Amanda_Event_API
 
 
               Introduction
@@ -567,6 +544,8 @@ Table of Contents
 
                     event_loop
 
+                    event_wait
+
                     event_wakeup
 
 
@@ -597,7 +576,7 @@ Table of Contents
 
 
 
-        24._AMANDA_Security_API
+        26._Amanda_Security_API
 
 
               Introduction
@@ -661,12 +640,12 @@ Table of Contents
 
 
 
-        25._Virtual_Tape_API
+        27._Virtual_Tape_API
 
-        26._Using_Kerberos_with_AMANDA
+        28._Using_Kerberos_with_Amanda
 
 
-              AMANDA_2.5.0_-_KERBEROS_v4_SUPPORT_NOTES
+              Amanda_2.5.0_-_KERBEROS_v4_SUPPORT_NOTES
 
 
                     Configuration
@@ -676,7 +655,7 @@ Table of Contents
                     conf_file
 
 
-              AMANDA_2.5.0_-_KERBEROS_v5_SUPPORT_NOTES
+              Amanda_2.5.0_-_KERBEROS_v5_SUPPORT_NOTES
 
 
                     Building
@@ -693,7 +672,7 @@ Table of Contents
   VI._Historical_files
 
 
-        27._Response_to_CPIO_Security_Notice_Issue_11:
+        29._Response_to_CPIO_Security_Notice_Issue_11:
 
 
               Affected_Versions
@@ -703,12 +682,12 @@ Table of Contents
               Acknowledgements
 
 
-        28._Upgrade_Issues
+        30._Upgrade_Issues
 
-        29._What_once_was_new
+        31._What_once_was_new
 
 
-              What's_new_in_AMANDA_2.3
+              What's_new_in_Amanda_2.3
 
 
                     Indexing_backups_for_easier_restore
@@ -728,7 +707,7 @@ Table of Contents
                     amadmin_import/export
 
 
-              What's_new_in_AMANDA_2.2
+              What's_new_in_Amanda_2.2
 
 
                     Client_side_setup_has_changed
@@ -765,7 +744,7 @@ Table of Contents
 
 
 
-        30._Multitape_support_in_AMANDA_2.2
+        32._Multitape_support_in_Amanda_2.2
 
 
               Introduction
@@ -795,19 +774,87 @@ Table of Contents
 
 
 
-        31._Thoughts_about_a_Strategy_API
+        33._Thoughts_about_a_Strategy_API
+
+        34._Y2K_Compliancy
+
+        35._Usage_of_floppy_tape_drives_on_Linux
+
+
+  VII._Appendixes
+
+
+        36._The_Amanda_Manual_Pages.
+
+
+              amadmin \14 administrative interface to control Amanda backups
+
+              amaespipe \14 wrapper program for aespipe
+
+              amanda \14 Advanced Maryland Automatic Network Disk Archiver
+
+              amanda.conf \14 Main configuration file for Amanda, the Advanced
+              Maryland Automatic Network Disk Archiver
+
+              amanda-client.conf \14 Client configuration file for Amanda, the
+              Advanced Maryland Automatic Network Disk Archiver
+
+              amcheck \14 run Amanda self-checks
+
+              amcheckdb \14 check Amanda database for tape consistency
+
+              amcleanup \14 run the Amanda cleanup process after a failure
+
+              amcrypt \14 reference crypt program for Amanda symmetric data
+              encryption
+
+              amcrypt-ossl \14 crypt program for Amanda symmetric data encryption
+              using OpenSSL
+
+              amcrypt-ossl-asym \14 crypt program for Amanda asymmetric data
+              encryption using OpenSSL
+
+              amdd \14 Amanda version of dd
+
+              amdump \14 back up all disks in an Amanda configuration
+
+              amfetchdump \14 extract backup images from multiple Amanda tapes.
 
-        32._Y2K_Compliancy
+              amflush \14 flush Amanda backup files from holding disk to tape
 
-        33._Usage_of_floppy_tape_drives_on_Linux
+              amgetconf \14 look up amanda.conf variables
 
+              amlabel \14 label an Amanda tape
 
-  VII._References
+              ammt \14 Amanda version of mt
 
+              amoverview \14 display file systems processed by Amanda over time
 
-        34._Web_Ressources
+              amplot \14 visualize the behavior of Amanda
 
-        35._The_AMANDA_Manual_Pages.
+              amrecover \14 Amanda index database browser
+
+              amreport \14 generate a formatted output of statistics for an
+              Amanda run
+
+              amrestore \14 extract backup images from an Amanda tape
+
+              amrmtape \14 remove a tape from the Amanda database
+
+              amstatus \14 display the state of an Amanda run
+
+              amtape \14 user interface to Amanda tape changer controls
+
+              amtapetype \14 generate a tapetype definition.
+
+              amtoc \14 generate TOC (Table Of Contents) for an Amanda run
+
+              amverify \14 check an Amanda tape for errors
+
+              amverifyrun \14 check the tapes written by the last Amanda run
+
+
+        37._Web_Ressources
 
 
   Index
@@ -817,12 +864,42 @@ List of Tables
 
   4.1. Protocol_between_amindexd_and_amrecover
 
-  19.1. Operating_Systems_Running_on_AMANDA_Server_Hosts
-
 List of Examples
 
 
-  15.1. A_C_Program_to_Check_the_AMANDA_Service_Numbers
+  2.1. /etc/crontab
+
+  2.2. /etc/services
+
+  2.3. /etc/inetd.conf
+
+  2.4. /etc/xinetd.d/amandaidx
+
+  2.5. /etc/xinetd.d/amidxtape
+
+  2.6. /etc/amanda/supervise/amandaidx/run
+
+  2.7. /etc/amanda/supervise/amidxtape/run
+
+  2.8. /etc/services
+
+  2.9. /etc/inetd.conf
+
+  2.10. /etc/xinetd.d/amanda
+
+  2.11. /etc/amanda/supervise/amanda/run
+
+  15.1.
+
+  15.2.
+
+  16.1. /usr/local/libexec/amgtar
+
+  16.2. /usr/local/bin/amaespipe
+
+  16.3. bz2aespipe.patch
+
+  18.1. A_C_Program_to_Check_the_Amanda_Service_Numbers
 
 -------------------------------------------------------------------------------