
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

