revert config/* to upstream versions, let rules configure target handle update
[debian/amanda] / docs / index.txt
index 9ab300f7e3242c879d1e4af9b51c201542325a5a..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 100644 (file)
@@ -1,831 +0,0 @@
-
-The Official AMANDA Documentation
-                             Next
-
--------------------------------------------------------------------------------
-
-
-The Official AMANDA Documentation
-
-
-Edited by
-
-
-Stefan G. Weichinger
-
-
-AMANDA Core Team
-
--------------------------------------------------------------------------------
-Table of Contents
-
-
-  Abstract
-
-  Copyright_Information
-
-  Attributions
-
-  I._Installation
-
-
-        1._AMANDA_2.4.x_-_System-Specific_Installation_Notes
-
-
-              Solaris_2.6
-
-              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
-
-
-  IV._Various_Information
-
-
-        15._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
-
-
-
-        16._AMANDA_FAQ
-
-
-              QUESTION:_Why_does_AMANDA_fail_to_build_on_my_system?
-
-              QUESTION:_Why_does_amdump_report_that_all_disks_failed?
-
-              QUESTION:_Why_does_amcheck_say_"port_NNN_is_not_secure"?
-
-              QUESTION:_Why_does_amcheck_claim_that_the_tape_is_"not_an_amanda
-              tape"?
-
-              QUESTION:_Why_does_amcheck_report_"selfcheck_request_timed_out"?
-
-              QUESTION:_Why_does_amandad.debug_contain_"error_receiving
-              message"?
-
-              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>'?
-
-              QUESTION:_Why_does_amcheck_say_"cannot_overwrite_active_tape"?
-
-              QUESTION:_Why_does_amcheck_tell_me_"DUMP_program_not_available"?
-
-              QUESTION:_Which_tape_changer_configuration_should_I_use_in
-              amanda.conf?
-
-              QUESTION:_Should_I_use_software_or_hardware_compression?
-
-              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?
-
-              QUESTION:_How_can_I_configure_AMANDA_for_long-term_archiving?
-
-              QUESTION:_Can_I_backup_separate_disks_of_the_same_host_in
-              different_configurations?
-
-              QUESTION:_Can_AMANDA_span_large_filesystems_across_multiple
-              tapes?
-
-              QUESTION:_What's_the_difference_between_option_"skip-full"_and
-              "strategy_nofull"?
-
-              QUESTION:_Why_does_amdump_report_"results_missing"?
-
-              QUESTION:_Why_does_amdump_report_"disk_offline"?
-
-              QUESTION:_What_if_amdump_reports_"dumps_way_too_big,_must_skip
-              incremental_dumps"?
-
-              QUESTION:_amdump_reported_"infofile_update_failed"._What_should_I
-              do?
-
-              QUESTION:_Why_does_AMANDA_sometimes_promote_full_dumps?
-
-              QUESTION:_Why_does_amrecover_report_"no_index_records"_or_"disk
-              not_found"?
-
-              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?
-
-              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?
-
-
-        17._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
-
-              ...
-
-
-        18._AMANDA_WISHLIST
-
-        19._AMANDA_Survey_Results
-
-
-  V._Technical_Background
-
-
-        20._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
-
-
-        21._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
-
-
-        22._AMANDA_Internals
-
-
-              Protocols
-
-              server_and_amandad_on_client
-
-              planner_and_driver
-
-              driver_and_dumper
-
-              taper(read)_and_taper(write)
-
-
-        23._AMANDA_Event_API
-
-
-              Introduction
-
-              The_API
-
-
-                    event_register
-
-                    event_release
-
-                    event_loop
-
-                    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
-
-
-
-        24._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
-
-
-
-        25._Virtual_Tape_API
-
-        26._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
-
-
-        27._Response_to_CPIO_Security_Notice_Issue_11:
-
-
-              Affected_Versions
-
-              Workaround
-
-              Acknowledgements
-
-
-        28._Upgrade_Issues
-
-        29._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
-
-
-
-        30._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
-
-
-
-        31._Thoughts_about_a_Strategy_API
-
-        32._Y2K_Compliancy
-
-        33._Usage_of_floppy_tape_drives_on_Linux
-
-
-  VII._References
-
-
-        34._Web_Ressources
-
-        35._The_AMANDA_Manual_Pages.
-
-
-  Index
-
-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
-
--------------------------------------------------------------------------------
-
-         Next
-     Abstract
-