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__not allowed..."? QUESTION:_Why_does_amcheck_report_"ip_address_#.#.#.#"_is_not_in the_ip_list_list_for_'? 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