revert config/* to upstream versions, let rules configure target handle update
[debian/amanda] / docs / index.txt
index 0c84738a1c3f5e8d175943aa743ea4e26de58b2a..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 100644 (file)
@@ -1,908 +0,0 @@
-
-The Official AMANDA Documentation
-                             Next
-
--------------------------------------------------------------------------------
-
-
-The Official AMANDA Documentation
-
-
-Edited by
-
-
-Stefan G. Weichinger
-
-AMANDA Core Team
-<sgw@amanda.org>
-
-Edited by
-
-
-Amanda Core Team
-
-AMANDA Core Team
--------------------------------------------------------------------------------
-Table of Contents
-
-
-  Abstract
-
-  Copyright_Information
-
-  Attributions
-
-  I._Installation
-
-
-        1._Amanda_2.5.0_-_System-Specific_Installation_Notes
-
-
-              Solaris_2.6
-
-              Solaris
-
-              Trusted_Solaris
-
-              SunOS_4.x
-
-              Ultrix
-
-              HP/UX
-
-              Linux
-
-              Digital_Unix_4
-
-              Sinix_5.43_(Reliant_Unix)
-
-              IRIX_(all)
-
-              IRIX_6
-
-              IRIX_6.5.x
-
-              SCO
-
-              FreeBSD_3.0
-
-              FreeBSD_4.9
-
-              FreeBSD_5.1
-
-              AIX
-
-              Microsoft_Windows
-
-              Mac_OS_X
-
-
-        2._Amanda_Installation_Notes
-
-
-              Before_doing_anything
-
-              Compiling_the_Amanda_sources
-
-              Setting_up_your_Amanda_Configuration
-
-
-                    Setting_up_the_Tape_Server_Host
-
-                    Set_up_the_Backup_Client_Hosts
-
-
-
-        3._Excluding
-
-
-              Introduction
-
-              Please_Read
-
-              Before_We_Begin
-
-              Choosing_an_exclude_mechanism
-
-
-                    Exclude_Mechanisms
-
-
-              Expression
-
-              Wildcard_Expansion
-
-              Troubleshooting
-
-
-                    Broken_gnutar?
-
-                    The_ps_command_is_your_friend.
-
-
-
-        4._Indexing_with_Amanda
-
-
-              Database_Format
-
-              Database_Browsing
-
-              File_Extraction
-
-              Protocol_Between_amindexd_and_amrecover
-
-              Installation_Notes
-
-              Permissions
-
-              Changes_from_amindex-1.0
-
-              Changes_from_amindex-0.3
-
-              Changes_from_amindex-0.2
-
-              Changes_from_amindex-0.1
-
-              Changes/additions_to_2.3.0
-
-              Known_Bugs
-
-
-        5._Backup_PC_hosts_using_Samba
-
-
-              Installation
-
-              Setup
-
-              Example
-
-              Bugs_and_notes
-
-
-        6._Restore
-
-
-  II._About_Tapes_and_Changers
-
-
-        7._Tapetypes
-
-        8._Amanda_Tape_Changer_Support
-
-
-              Introduction
-
-              Specifying_a_tape_changer_in_amanda.conf
-
-              Device-specific_tapechanger_script
-
-              Slot_names_and_the_"current"_slot
-
-              Operator_interface
-
-              How_amdump_interacts_with_the_tape_changer
-
-              Builtin_tape-changers
-
-
-                    chg-multi_(formerly_chg-generic)
-
-                    chg-manual_(formerly_no-changer)
-
-                    chg-mtx_(formerly_hp-changer)
-
-                    chg-zd-mtx
-
-                    chg-scsi-chio_(formerly_seagate-changer,_then_chg-chio)
-
-                    chg-scsi_(new_interface,_try_to_drive_a_robot_with_direct
-                    scsi_commands)
-
-                    chg-chio
-
-                    chg-chs
-
-                    chg-rth
-
-                    chg-juke
-
-                    chg-rait
-
-                    chg-disk
-
-                    chg-iomega
-
-                    chg-null
-
-
-
-        9._chg-scsi
-
-
-              Command_line_options
-
-              Notes_about_changer.conf
-
-              Amanda's_actual_usage_of_chg-scsi
-
-              Configuration_notes
-
-              Hacking_notes
-
-
-        10._RAIT_(Redundant_Array_of_Inexpensive_Tape)_Support
-
-
-              What_is_a_RAIT?
-
-              Using_a_RAIT
-
-              Disaster_Recovery
-
-
-        11._Printing_of_Labels
-
-
-              The_New_Feature
-
-              Labels_provided
-
-              History
-
-              How_it_works
-
-
-
-  III._HOWTOs
-
-
-        12._Amanda_on_Cygwin_HOWTO
-
-
-              Install_Cygwin
-
-              Other_Preparation
-
-              Compile_Amanda
-
-              Configure_Cygwin_files
-
-              Configure_Windows_System_Files
-
-              Configure_inetd_to_run_automatically_as_a_service
-
-              Windows_98/ME
-
-              Windows_NT/2000/XP
-
-              Notes_on_Amanda_backup_options
-
-
-                    Compression
-
-                    Exclude_Lists
-
-                    Debugging_Files
-
-
-
-        13._How_to_use_the_Amanda_file-driver
-
-
-              Introduction
-
-              Possible_Uses
-
-              Setup
-
-
-                    Basics
-
-
-              Recovery
-
-
-        14._AFS_HOWTO
-
-        15._How_to_use_a_wrapper
-
-
-              Bert_de_Ridder's_suggestions
-
-              Paul_Bijnens's_suggestions
-
-
-        16._How_to_do_Amanda-server-side_gpg-encrypted_backups.
-
-
-              Setup
-
-              Test
-
-              Plans
-
-
-        17._How_to_use_different_auth_with_Amanda
-
-
-              Introduction
-
-              BSD
-
-              BSDTCP
-
-              BSDUDP
-
-              KRB4
-
-              KRB5
-
-              RSH
-
-              SSH
-
-
-                    For_amdump:
-
-                    For_amrecover:
-
-
-
-
-  IV._Various_Information
-
-
-        18._Using_Amanda
-
-
-              An_Introduction
-
-              Amanda_Features
-
-              Future_Capabilities_of_Amanda
-
-              Amanda_Resources
-
-              Installing_Amanda
-
-
-                    Install_Related_Packages
-
-                    Perform_Preliminary_Setup
-
-                    Configure_the_Amanda_Build
-
-                    Build_and_Install_Amanda
-
-                    Configuring_Amanda
-
-                    Decide_on_a_Tape_Server
-
-                    Decide_Which_Tape_Devices_to_Use
-
-                    Decide_Whether_to_Use_Compression
-
-                    Decide_Where_the_Holding_Space_Will_Be
-
-                    Compute_Your_Dump_Cycle
-
-                    Copy_and_Edit_the_Default_Configuration_File
-
-                    Configure_the_Holding_Disk
-
-                    Configure_Tape_Devices_and_Label_Tapes
-
-                    Configure_Backup_Clients
-
-                    Test_and_Debug_Setup
-
-
-              Operating_Amanda
-
-
-                    Run_amdump
-
-                    Read_Amanda's_Reports
-
-                    Monitor_Tape_and_Holding_Disk_Status
-
-                    Adding_Tapes_at_a_Particular_Position_in_the_Cycle
-
-                    Miscellanous_Operational_Notes
-
-
-              Advanced_Amanda_Configuration
-
-
-                    Adjust_the_Backup_Cycle
-
-                    Adjust_Parallelism
-
-                    Monitor_for_Possible_Improvements
-
-                    Excluding_Files
-
-
-              Restoring_with_Amanda
-
-
-                    Configuring_and_Using_amrecover
-
-                    Using_amrestore
-
-                    Restoring_Without_Amanda
-
-
-
-        19._Amanda_FAQ
-
-        20._Collection_of_the_top_ten_Amanda_questions._And_answers.
-
-
-              Reason_for_starting_this_list.
-
-              the_DLE-question
-
-              the_localhost-question
-
-              the_friday-tape-question
-
-              the_multiple-dumps-question
-
-              the_mailing-list-question
-
-              the_distro-question
-
-              the_index-question
-
-              the_tapetype-questions
-
-              the_size-question
-
-              the_GUI-question
-
-              the_holding-disk_question
-
-              ...
-
-
-        21._Amanda_WISHLIST
-
-
-  V._Technical_Background
-
-
-        22._How_Amanda_uses_UDP_and_TCP_ports
-
-
-              TCP_port_allocation
-
-              User_TCP_port_range_(--with-tcpportrange)_summary
-
-              UDP_port_allocation
-
-              User_UDP_port_range_(--with-udpportrange)_summary
-
-              Firewalls_and_NAT
-
-
-        23._Amanda_dumper_API
-
-
-              Introduction
-
-              The_Problem
-
-              Overview_of_the_API
-
-
-                    The_`support'_command
-
-
-              The_`selfcheck'_command
-
-              The_`estimate'_and_`estimate-parse'_commands
-
-              The_`backup'_and_`backup-parse'_commands
-
-              The_`index-from-output'_and_`index-from-image'_commands
-
-              The_`restore'_command
-
-              The_`print-command'_command
-
-              Conclusion
-
-
-        24._Amanda_Internals
-
-
-              Protocols
-
-              server_and_amandad_on_client
-
-              planner_and_driver
-
-              driver_and_dumper
-
-              taper(read)_and_taper(write)
-
-
-        25._Amanda_Event_API
-
-
-              Introduction
-
-              The_API
-
-
-                    event_register
-
-                    event_release
-
-                    event_loop
-
-                    event_wait
-
-                    event_wakeup
-
-
-              Data_types
-
-
-                    event_handle_t
-
-                    event_id_t
-
-                    event_type_t
-
-                    event_fn_t
-
-
-              Event_Types
-
-
-                    EV_READFD
-
-                    EV_WRITEFD
-
-                    EV_SIG
-
-                    EV_TIME
-
-                    EV_WAIT
-
-
-
-        26._Amanda_Security_API
-
-
-              Introduction
-
-              The_Problem
-
-              The_API
-
-
-                    protocol_packet_transmission_functions
-
-                    stream_functions
-
-
-              Data_Types
-
-
-                    security_driver_t
-
-                    security_handle_t
-
-                    security_stream_t
-
-                    security_status_t
-
-
-              SECURITY_DRIVERS
-
-
-                    name
-
-                    connect
-
-                    accept
-
-                    close
-
-                    sendpkt
-
-                    recvpkt
-
-                    recvpkt_cancel
-
-                    stream_server
-
-                    stream_accept
-
-                    stream_client
-
-                    stream_close
-
-                    stream_auth
-
-                    stream_id
-
-                    stream_write
-
-                    stream_read
-
-                    stream_read_cancel
-
-
-
-        27._Virtual_Tape_API
-
-        28._Using_Kerberos_with_Amanda
-
-
-              Amanda_2.5.0_-_KERBEROS_v4_SUPPORT_NOTES
-
-
-                    Configuration
-
-                    Installation
-
-                    conf_file
-
-
-              Amanda_2.5.0_-_KERBEROS_v5_SUPPORT_NOTES
-
-
-                    Building
-
-                    Installation
-
-                    conf_file
-
-                    Destination_Host_Permissions_file
-
-
-
-
-  VI._Historical_files
-
-
-        29._Response_to_CPIO_Security_Notice_Issue_11:
-
-
-              Affected_Versions
-
-              Workaround
-
-              Acknowledgements
-
-
-        30._Upgrade_Issues
-
-        31._What_once_was_new
-
-
-              What's_new_in_Amanda_2.3
-
-
-                    Indexing_backups_for_easier_restore
-
-                    Samba_Support
-
-                    GnuTar_Support
-
-                    Multiple_backups_in_parallel_from_one_client_host
-
-                    Multiple_tapes_in_one_run
-
-                    Bottleneck_determination
-
-                    2_Gb_limit_removed
-
-                    amadmin_import/export
-
-
-              What's_new_in_Amanda_2.2
-
-
-                    Client_side_setup_has_changed
-
-                    Version_suffixes_on_executables
-
-                    Kerberos
-
-                    Multiple_holding_disks
-
-                    Remote_self-checks
-
-                    mmap_support
-
-                    gzip_support
-
-                    Mount_point_names_in_disklist
-
-                    Initial_tape-changer_support_included
-
-                    Generic_tape_changer_wrapper_script
-
-                    New_command_amtape
-
-                    Changer_support_added_to_command_amlabel
-
-                    Tape_changer_support_improved
-
-                    A_few_words_about_multi-tape_runs
-
-                    Big_planner_changes
-
-                    Level-0_dumps_allowed_with_no_tape
-
-
-
-        32._Multitape_support_in_Amanda_2.2
-
-
-              Introduction
-
-              New_Planner_Algorithm
-
-
-                    Time
-
-                    Full_Backups
-
-                    Schedule_Balancing
-
-                    Overwrite_Detection
-
-
-              Taper_Algorithm
-
-
-                    Choosing_a_tape
-
-                    End_of_tape_handling
-
-                    Tape_Format_Changes
-
-                    Tapelist_File_Changes
-
-
-
-        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.
-
-              amflush \14 flush Amanda backup files from holding disk to tape
-
-              amgetconf \14 look up amanda.conf variables
-
-              amlabel \14 label an Amanda tape
-
-              ammt \14 Amanda version of mt
-
-              amoverview \14 display file systems processed by Amanda over time
-
-              amplot \14 visualize the behavior of Amanda
-
-              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
-
-List of Tables
-
-
-  4.1. Protocol_between_amindexd_and_amrecover
-
-List of Examples
-
-
-  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
-
--------------------------------------------------------------------------------
-
-         Next
-     Abstract
-