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 15._How_to_use_a_wrapper IV._Various_Information 16._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 17._AMANDA_FAQ 18._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 ... 19._AMANDA_WISHLIST 20._AMANDA_Survey_Results V._Technical_Background 21._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 22._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 23._AMANDA_Internals Protocols server_and_amandad_on_client planner_and_driver driver_and_dumper taper(read)_and_taper(write) 24._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 25._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 26._Virtual_Tape_API 27._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 28._Response_to_CPIO_Security_Notice_Issue_11: Affected_Versions Workaround Acknowledgements 29._Upgrade_Issues 30._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 31._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 32._Thoughts_about_a_Strategy_API 33._Y2K_Compliancy 34._Usage_of_floppy_tape_drives_on_Linux VII._Appendixes 35._The_AMANDA_Manual_Pages. 36._Web_Ressources Index List of Tables 4.1. Protocol_between_amindexd_and_amrecover 20.1. Operating_Systems_Running_on_AMANDA_Server_Hosts List of Examples 16.1. A_C_Program_to_Check_the_AMANDA_Service_Numbers ------------------------------------------------------------------------------- Next Abstract