git.gag.com Git - debian/amanda/blob - docs/index.txt

   1
   2 The Official AMANDA Documentation
   3                              Next
   4
   5 -------------------------------------------------------------------------------
   6
   7
   8 The Official AMANDA Documentation
   9
  10
  11 Edited by
  12
  13
  14 Stefan G. Weichinger
  15
  16
  17 AMANDA Core Team
  18
  19 -------------------------------------------------------------------------------
  20 Table of Contents
  21
  22
  23   Abstract
  24
  25   Copyright_Information
  26
  27   Attributions
  28
  29   I._Installation
  30
  31
  32         1._AMANDA_2.4.x_-_System-Specific_Installation_Notes
  33
  34
  35               Solaris_2.6
  36
  37               Trusted_Solaris
  38
  39               SunOS_4.x
  40
  41               Ultrix
  42
  43               HP/UX
  44
  45               Linux
  46
  47               Digital_Unix_4
  48
  49               Sinix_5.43_(Reliant_Unix)
  50
  51               IRIX_(all)
  52
  53               IRIX_6
  54
  55               IRIX_6.5.x
  56
  57               SCO
  58
  59               FreeBSD_3.0
  60
  61               FreeBSD_4.9
  62
  63               FreeBSD_5.1
  64
  65               AIX
  66
  67               Microsoft_Windows
  68
  69               Mac_OS_X
  70
  71
  72         2._AMANDA_Installation_Notes
  73
  74
  75               Before_doing_anything
  76
  77               Compiling_the_AMANDA_sources
  78
  79               Setting_up_your_AMANDA_Configuration
  80
  81
  82                     Setting_up_the_Tape_Server_Host
  83
  84                     Set_up_the_Backup_Client_Hosts
  85
  86
  87
  88         3._Excluding
  89
  90
  91               Introduction
  92
  93               Please_Read
  94
  95               Before_We_Begin
  96
  97               Choosing_an_exclude_mechanism
  98
  99
 100                     Exclude_Mechanisms
 101
 102
 103               Expression
 104
 105               Wildcard_Expansion
 106
 107               Troubleshooting
 108
 109
 110                     Broken_gnutar?
 111
 112                     The_ps_command_is_your_friend.
 113
 114
 115
 116         4._Indexing_with_AMANDA
 117
 118
 119               Database_Format
 120
 121               Database_Browsing
 122
 123               File_Extraction
 124
 125               Protocol_Between_amindexd_and_amrecover
 126
 127               Installation_Notes
 128
 129               Permissions
 130
 131               Changes_from_amindex-1.0
 132
 133               Changes_from_amindex-0.3
 134
 135               Changes_from_amindex-0.2
 136
 137               Changes_from_amindex-0.1
 138
 139               Changes/additions_to_2.3.0
 140
 141               Known_Bugs
 142
 143
 144         5._Backup_PC_hosts_using_Samba
 145
 146
 147               Installation
 148
 149               Setup
 150
 151               Example
 152
 153               Bugs_and_notes
 154
 155
 156         6._Restore
 157
 158
 159   II._About_Tapes_and_Changers
 160
 161
 162         7._Tapetypes
 163
 164         8._AMANDA_Tape_Changer_Support
 165
 166
 167               Introduction
 168
 169               Specifying_a_tape_changer_in_amanda.conf
 170
 171               Device-specific_tapechanger_script
 172
 173               Slot_names_and_the_"current"_slot
 174
 175               Operator_interface
 176
 177               How_amdump_interacts_with_the_tape_changer
 178
 179               Builtin_tape-changers
 180
 181
 182                     chg-multi_(formerly_chg-generic)
 183
 184                     chg-manual_(formerly_no-changer)
 185
 186                     chg-mtx_(formerly_hp-changer)
 187
 188                     chg-zd-mtx
 189
 190                     chg-scsi-chio_(formerly_seagate-changer,_then_chg-chio)
 191
 192                     chg-scsi_(new_interface,_try_to_drive_a_robot_with_direct
 193                     scsi_commands)
 194
 195                     chg-chio
 196
 197                     chg-chs
 198
 199                     chg-rth
 200
 201                     chg-juke
 202
 203                     chg-rait
 204
 205                     chg-disk
 206
 207                     chg-iomega
 208
 209                     chg-null
 210
 211
 212
 213         9._chg-scsi
 214
 215
 216               Command_line_options
 217
 218               Notes_about_changer.conf
 219
 220               AMANDA's_actual_usage_of_chg-scsi
 221
 222               Configuration_notes
 223
 224               Hacking_notes
 225
 226
 227         10._RAIT_(Redundant_Array_of_Inexpensive_Tape)_Support
 228
 229
 230               What_is_a_RAIT?
 231
 232               Using_a_RAIT
 233
 234               Disaster_Recovery
 235
 236
 237         11._Printing_of_Labels
 238
 239
 240               The_New_Feature
 241
 242               Labels_provided
 243
 244               History
 245
 246               How_it_works
 247
 248
 249
 250   III._HOWTOs
 251
 252
 253         12._AMANDA_on_Cygwin_HOWTO
 254
 255
 256               Install_Cygwin
 257
 258               Other_Preparation
 259
 260               Compile_AMANDA
 261
 262               Configure_Cygwin_files
 263
 264               Configure_Windows_System_Files
 265
 266               Configure_inetd_to_run_automatically_as_a_service
 267
 268               Windows_98/ME
 269
 270               Windows_NT/2000/XP
 271
 272               Notes_on_AMANDA_backup_options
 273
 274
 275                     Compression
 276
 277                     Exclude_Lists
 278
 279                     Debugging_Files
 280
 281
 282
 283         13._How_to_use_the_AMANDA_file-driver
 284
 285
 286               Introduction
 287
 288               Possible_Uses
 289
 290               Setup
 291
 292
 293                     Basics
 294
 295
 296               Recovery
 297
 298
 299         14._AFS_HOWTO
 300
 301
 302   IV._Various_Information
 303
 304
 305         15._Using_AMANDA
 306
 307
 308               An_Introduction
 309
 310               AMANDA_Features
 311
 312               Future_Capabilities_of_AMANDA
 313
 314               AMANDA_Resources
 315
 316               Installing_AMANDA
 317
 318
 319                     Install_Related_Packages
 320
 321                     Perform_Preliminary_Setup
 322
 323                     Configure_the_AMANDA_Build
 324
 325                     Build_and_Install_AMANDA
 326
 327                     Configuring_AMANDA
 328
 329                     Decide_on_a_Tape_Server
 330
 331                     Decide_Which_Tape_Devices_to_Use
 332
 333                     Decide_Whether_to_Use_Compression
 334
 335                     Decide_Where_the_Holding_Space_Will_Be
 336
 337                     Compute_Your_Dump_Cycle
 338
 339                     Copy_and_Edit_the_Default_Configuration_File
 340
 341                     Configure_the_Holding_Disk
 342
 343                     Configure_Tape_Devices_and_Label_Tapes
 344
 345                     Configure_Backup_Clients
 346
 347                     Test_and_Debug_Setup
 348
 349
 350               Operating_Amanda
 351
 352
 353                     Run_amdump
 354
 355                     Read_AMANDA's_Reports
 356
 357                     Monitor_Tape_and_Holding_Disk_Status
 358
 359                     Adding_Tapes_at_a_Particular_Position_in_the_Cycle
 360
 361                     Miscellanous_Operational_Notes
 362
 363
 364               Advanced_AMANDA_Configuration
 365
 366
 367                     Adjust_the_Backup_Cycle
 368
 369                     Adjust_Parallelism
 370
 371                     Monitor_for_Possible_Improvements
 372
 373                     Excluding_Files
 374
 375
 376               Restoring_with_AMANDA
 377
 378
 379                     Configuring_and_Using_amrecover
 380
 381                     Using_amrestore
 382
 383                     Restoring_Without_AMANDA
 384
 385
 386
 387         16._AMANDA_FAQ
 388
 389
 390               QUESTION:_Why_does_AMANDA_fail_to_build_on_my_system?
 391
 392               QUESTION:_Why_does_amdump_report_that_all_disks_failed?
 393
 394               QUESTION:_Why_does_amcheck_say_"port_NNN_is_not_secure"?
 395
 396               QUESTION:_Why_does_amcheck_claim_that_the_tape_is_"not_an_amanda
 397               tape"?
 398
 399               QUESTION:_Why_does_amcheck_report_"selfcheck_request_timed_out"?
 400
 401               QUESTION:_Why_does_amandad.debug_contain_"error_receiving
 402               message"?
 403
 404               QUESTION:_Why_does_amcheck_say_"access_as_<username>_not
 405               allowed..."?
 406
 407               QUESTION:_Why_does_amcheck_report_"ip_address_#.#.#.#"_is_not_in
 408               the_ip_list_list_for_<hostname>'?
 409
 410               QUESTION:_Why_does_amcheck_say_"cannot_overwrite_active_tape"?
 411
 412               QUESTION:_Why_does_amcheck_tell_me_"DUMP_program_not_available"?
 413
 414               QUESTION:_Which_tape_changer_configuration_should_I_use_in
 415               amanda.conf?
 416
 417               QUESTION:_Should_I_use_software_or_hardware_compression?
 418
 419               QUESTION:_How_can_I_configure_AMANDA_so_that_it_performs_full
 420               backups_on_the_week-end_and_incrementals_on_weekdays?
 421
 422               QUESTION:_What_if_my_tape_unit_uses_expensive_tapes,_and_I_don't
 423               want_to_use_one_tape_per_day?_Can't_AMANDA_append_to_tapes?
 424
 425               QUESTION:_How_can_I_configure_AMANDA_for_long-term_archiving?
 426
 427               QUESTION:_Can_I_backup_separate_disks_of_the_same_host_in
 428               different_configurations?
 429
 430               QUESTION:_Can_AMANDA_span_large_filesystems_across_multiple
 431               tapes?
 432
 433               QUESTION:_What's_the_difference_between_option_"skip-full"_and
 434               "strategy_nofull"?
 435
 436               QUESTION:_Why_does_amdump_report_"results_missing"?
 437
 438               QUESTION:_Why_does_amdump_report_"disk_offline"?
 439
 440               QUESTION:_What_if_amdump_reports_"dumps_way_too_big,_must_skip
 441               incremental_dumps"?
 442
 443               QUESTION:_amdump_reported_"infofile_update_failed"._What_should_I
 444               do?
 445
 446               QUESTION:_Why_does_AMANDA_sometimes_promote_full_dumps?
 447
 448               QUESTION:_Why_does_amrecover_report_"no_index_records"_or_"disk
 449               not_found"?
 450
 451               QUESTION:_Ok,_I'm_done_with_testing_AMANDA,_now_I_want_to_put_it
 452               in_production._How_can_I_reset_its_databases_so_as_to_start_from
 453               scratch?
 454
 455               QUESTION:_The_man-page_of_dump_says_that_active_filesystems_may
 456               be_backed_up_inconsistently._What_does_AMANDA_do_to_prevent
 457               inconsistent_backups?
 458
 459               QUESTION:_Which_version_of_GNU-tar_should_I_use?
 460
 461
 462         17._Collection_of_the_top_ten_AMANDA_questions._And_answers.
 463
 464
 465               Reason_for_starting_this_list.
 466
 467               the_DLE-question
 468
 469               the_localhost-question
 470
 471               the_friday-tape-question
 472
 473               the_multiple-dumps-question
 474
 475               the_mailing-list-question
 476
 477               the_distro-question
 478
 479               the_index-question
 480
 481               the_tapetype-questions
 482
 483               the_size-question
 484
 485               the_GUI-question
 486
 487               the_holding-disk_question
 488
 489               ...
 490
 491
 492         18._AMANDA_WISHLIST
 493
 494         19._AMANDA_Survey_Results
 495
 496
 497   V._Technical_Background
 498
 499
 500         20._How_AMANDA_uses_UDP_and_TCP_ports
 501
 502
 503               TCP_port_allocation
 504
 505               User_TCP_port_range_(--with-tcpportrange)_summary
 506
 507               UDP_port_allocation
 508
 509               User_UDP_port_range_(--with-udpportrange)_summary
 510
 511               Firewalls_and_NAT
 512
 513
 514         21._AMANDA_dumper_API
 515
 516
 517               Introduction
 518
 519               The_Problem
 520
 521               Overview_of_the_API
 522
 523
 524                     The_`support'_command
 525
 526
 527               The_`selfcheck'_command
 528
 529               The_`estimate'_and_`estimate-parse'_commands
 530
 531               The_`backup'_and_`backup-parse'_commands
 532
 533               The_`index-from-output'_and_`index-from-image'_commands
 534
 535               The_`restore'_command
 536
 537               The_`print-command'_command
 538
 539               Conclusion
 540
 541
 542         22._AMANDA_Internals
 543
 544
 545               Protocols
 546
 547               server_and_amandad_on_client
 548
 549               planner_and_driver
 550
 551               driver_and_dumper
 552
 553               taper(read)_and_taper(write)
 554
 555
 556         23._AMANDA_Event_API
 557
 558
 559               Introduction
 560
 561               The_API
 562
 563
 564                     event_register
 565
 566                     event_release
 567
 568                     event_loop
 569
 570                     event_wakeup
 571
 572
 573               Data_types
 574
 575
 576                     event_handle_t
 577
 578                     event_id_t
 579
 580                     event_type_t
 581
 582                     event_fn_t
 583
 584
 585               Event_Types
 586
 587
 588                     EV_READFD
 589
 590                     EV_WRITEFD
 591
 592                     EV_SIG
 593
 594                     EV_TIME
 595
 596                     EV_WAIT
 597
 598
 599
 600         24._AMANDA_Security_API
 601
 602
 603               Introduction
 604
 605               The_Problem
 606
 607               The_API
 608
 609
 610                     protocol_packet_transmission_functions
 611
 612                     stream_functions
 613
 614
 615               Data_Types
 616
 617
 618                     security_driver_t
 619
 620                     security_handle_t
 621
 622                     security_stream_t
 623
 624                     security_status_t
 625
 626
 627               SECURITY_DRIVERS
 628
 629
 630                     name
 631
 632                     connect
 633
 634                     accept
 635
 636                     close
 637
 638                     sendpkt
 639
 640                     recvpkt
 641
 642                     recvpkt_cancel
 643
 644                     stream_server
 645
 646                     stream_accept
 647
 648                     stream_client
 649
 650                     stream_close
 651
 652                     stream_auth
 653
 654                     stream_id
 655
 656                     stream_write
 657
 658                     stream_read
 659
 660                     stream_read_cancel
 661
 662
 663
 664         25._Virtual_Tape_API
 665
 666         26._Using_Kerberos_with_AMANDA
 667
 668
 669               AMANDA_2.5.0_-_KERBEROS_v4_SUPPORT_NOTES
 670
 671
 672                     Configuration
 673
 674                     Installation
 675
 676                     conf_file
 677
 678
 679               AMANDA_2.5.0_-_KERBEROS_v5_SUPPORT_NOTES
 680
 681
 682                     Building
 683
 684                     Installation
 685
 686                     conf_file
 687
 688                     Destination_Host_Permissions_file
 689
 690
 691
 692
 693   VI._Historical_files
 694
 695
 696         27._Response_to_CPIO_Security_Notice_Issue_11:
 697
 698
 699               Affected_Versions
 700
 701               Workaround
 702
 703               Acknowledgements
 704
 705
 706         28._Upgrade_Issues
 707
 708         29._What_once_was_new
 709
 710
 711               What's_new_in_AMANDA_2.3
 712
 713
 714                     Indexing_backups_for_easier_restore
 715
 716                     Samba_Support
 717
 718                     GnuTar_Support
 719
 720                     Multiple_backups_in_parallel_from_one_client_host
 721
 722                     Multiple_tapes_in_one_run
 723
 724                     Bottleneck_determination
 725
 726                     2_Gb_limit_removed
 727
 728                     amadmin_import/export
 729
 730
 731               What's_new_in_AMANDA_2.2
 732
 733
 734                     Client_side_setup_has_changed
 735
 736                     Version_suffixes_on_executables
 737
 738                     Kerberos
 739
 740                     Multiple_holding_disks
 741
 742                     Remote_self-checks
 743
 744                     mmap_support
 745
 746                     gzip_support
 747
 748                     Mount_point_names_in_disklist
 749
 750                     Initial_tape-changer_support_included
 751
 752                     Generic_tape_changer_wrapper_script
 753
 754                     New_command_amtape
 755
 756                     Changer_support_added_to_command_amlabel
 757
 758                     Tape_changer_support_improved
 759
 760                     A_few_words_about_multi-tape_runs
 761
 762                     Big_planner_changes
 763
 764                     Level-0_dumps_allowed_with_no_tape
 765
 766
 767
 768         30._Multitape_support_in_AMANDA_2.2
 769
 770
 771               Introduction
 772
 773               New_Planner_Algorithm
 774
 775
 776                     Time
 777
 778                     Full_Backups
 779
 780                     Schedule_Balancing
 781
 782                     Overwrite_Detection
 783
 784
 785               Taper_Algorithm
 786
 787
 788                     Choosing_a_tape
 789
 790                     End_of_tape_handling
 791
 792                     Tape_Format_Changes
 793
 794                     Tapelist_File_Changes
 795
 796
 797
 798         31._Thoughts_about_a_Strategy_API
 799
 800         32._Y2K_Compliancy
 801
 802         33._Usage_of_floppy_tape_drives_on_Linux
 803
 804
 805   VII._References
 806
 807
 808         34._Web_Ressources
 809
 810         35._The_AMANDA_Manual_Pages.
 811
 812
 813   Index
 814
 815 List of Tables
 816
 817
 818   4.1. Protocol_between_amindexd_and_amrecover
 819
 820   19.1. Operating_Systems_Running_on_AMANDA_Server_Hosts
 821
 822 List of Examples
 823
 824
 825   15.1. A_C_Program_to_Check_the_AMANDA_Service_Numbers
 826
 827 -------------------------------------------------------------------------------
 828
 829          Next
 830      Abstract
 831