--- /dev/null
+
+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
+