The Official AMANDA Documentation Next ------------------------------------------------------------------------------- The Official AMANDA Documentation Edited by Stefan G. Weichinger AMANDA Core Team 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  administrative interface to control Amanda backups amaespipe  wrapper program for aespipe amanda  Advanced Maryland Automatic Network Disk Archiver amanda.conf  Main configuration file for Amanda, the Advanced Maryland Automatic Network Disk Archiver amanda-client.conf  Client configuration file for Amanda, the Advanced Maryland Automatic Network Disk Archiver amcheck  run Amanda self-checks amcheckdb  check Amanda database for tape consistency amcleanup  run the Amanda cleanup process after a failure amcrypt  reference crypt program for Amanda symmetric data encryption amcrypt-ossl  crypt program for Amanda symmetric data encryption using OpenSSL amcrypt-ossl-asym  crypt program for Amanda asymmetric data encryption using OpenSSL amdd  Amanda version of dd amdump  back up all disks in an Amanda configuration amfetchdump  extract backup images from multiple Amanda tapes. amflush  flush Amanda backup files from holding disk to tape amgetconf  look up amanda.conf variables amlabel  label an Amanda tape ammt  Amanda version of mt amoverview  display file systems processed by Amanda over time amplot  visualize the behavior of Amanda amrecover  Amanda index database browser amreport  generate a formatted output of statistics for an Amanda run amrestore  extract backup images from an Amanda tape amrmtape  remove a tape from the Amanda database amstatus  display the state of an Amanda run amtape  user interface to Amanda tape changer controls amtapetype  generate a tapetype definition. amtoc  generate TOC (Table Of Contents) for an Amanda run amverify  check an Amanda tape for errors amverifyrun  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