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         15._How_to_use_a_wrapper
 302
 303
 304   IV._Various_Information
 305
 306
 307         16._Using_AMANDA
 308
 309
 310               An_Introduction
 311
 312               AMANDA_Features
 313
 314               Future_Capabilities_of_AMANDA
 315
 316               AMANDA_Resources
 317
 318               Installing_AMANDA
 319
 320
 321                     Install_Related_Packages
 322
 323                     Perform_Preliminary_Setup
 324
 325                     Configure_the_AMANDA_Build
 326
 327                     Build_and_Install_AMANDA
 328
 329                     Configuring_AMANDA
 330
 331                     Decide_on_a_Tape_Server
 332
 333                     Decide_Which_Tape_Devices_to_Use
 334
 335                     Decide_Whether_to_Use_Compression
 336
 337                     Decide_Where_the_Holding_Space_Will_Be
 338
 339                     Compute_Your_Dump_Cycle
 340
 341                     Copy_and_Edit_the_Default_Configuration_File
 342
 343                     Configure_the_Holding_Disk
 344
 345                     Configure_Tape_Devices_and_Label_Tapes
 346
 347                     Configure_Backup_Clients
 348
 349                     Test_and_Debug_Setup
 350
 351
 352               Operating_Amanda
 353
 354
 355                     Run_amdump
 356
 357                     Read_AMANDA's_Reports
 358
 359                     Monitor_Tape_and_Holding_Disk_Status
 360
 361                     Adding_Tapes_at_a_Particular_Position_in_the_Cycle
 362
 363                     Miscellanous_Operational_Notes
 364
 365
 366               Advanced_AMANDA_Configuration
 367
 368
 369                     Adjust_the_Backup_Cycle
 370
 371                     Adjust_Parallelism
 372
 373                     Monitor_for_Possible_Improvements
 374
 375                     Excluding_Files
 376
 377
 378               Restoring_with_AMANDA
 379
 380
 381                     Configuring_and_Using_amrecover
 382
 383                     Using_amrestore
 384
 385                     Restoring_Without_AMANDA
 386
 387
 388
 389         17._AMANDA_FAQ
 390
 391         18._Collection_of_the_top_ten_AMANDA_questions._And_answers.
 392
 393
 394               Reason_for_starting_this_list.
 395
 396               the_DLE-question
 397
 398               the_localhost-question
 399
 400               the_friday-tape-question
 401
 402               the_multiple-dumps-question
 403
 404               the_mailing-list-question
 405
 406               the_distro-question
 407
 408               the_index-question
 409
 410               the_tapetype-questions
 411
 412               the_size-question
 413
 414               the_GUI-question
 415
 416               the_holding-disk_question
 417
 418               ...
 419
 420
 421         19._AMANDA_WISHLIST
 422
 423         20._AMANDA_Survey_Results
 424
 425
 426   V._Technical_Background
 427
 428
 429         21._How_AMANDA_uses_UDP_and_TCP_ports
 430
 431
 432               TCP_port_allocation
 433
 434               User_TCP_port_range_(--with-tcpportrange)_summary
 435
 436               UDP_port_allocation
 437
 438               User_UDP_port_range_(--with-udpportrange)_summary
 439
 440               Firewalls_and_NAT
 441
 442
 443         22._AMANDA_dumper_API
 444
 445
 446               Introduction
 447
 448               The_Problem
 449
 450               Overview_of_the_API
 451
 452
 453                     The_`support'_command
 454
 455
 456               The_`selfcheck'_command
 457
 458               The_`estimate'_and_`estimate-parse'_commands
 459
 460               The_`backup'_and_`backup-parse'_commands
 461
 462               The_`index-from-output'_and_`index-from-image'_commands
 463
 464               The_`restore'_command
 465
 466               The_`print-command'_command
 467
 468               Conclusion
 469
 470
 471         23._AMANDA_Internals
 472
 473
 474               Protocols
 475
 476               server_and_amandad_on_client
 477
 478               planner_and_driver
 479
 480               driver_and_dumper
 481
 482               taper(read)_and_taper(write)
 483
 484
 485         24._AMANDA_Event_API
 486
 487
 488               Introduction
 489
 490               The_API
 491
 492
 493                     event_register
 494
 495                     event_release
 496
 497                     event_loop
 498
 499                     event_wakeup
 500
 501
 502               Data_types
 503
 504
 505                     event_handle_t
 506
 507                     event_id_t
 508
 509                     event_type_t
 510
 511                     event_fn_t
 512
 513
 514               Event_Types
 515
 516
 517                     EV_READFD
 518
 519                     EV_WRITEFD
 520
 521                     EV_SIG
 522
 523                     EV_TIME
 524
 525                     EV_WAIT
 526
 527
 528
 529         25._AMANDA_Security_API
 530
 531
 532               Introduction
 533
 534               The_Problem
 535
 536               The_API
 537
 538
 539                     protocol_packet_transmission_functions
 540
 541                     stream_functions
 542
 543
 544               Data_Types
 545
 546
 547                     security_driver_t
 548
 549                     security_handle_t
 550
 551                     security_stream_t
 552
 553                     security_status_t
 554
 555
 556               SECURITY_DRIVERS
 557
 558
 559                     name
 560
 561                     connect
 562
 563                     accept
 564
 565                     close
 566
 567                     sendpkt
 568
 569                     recvpkt
 570
 571                     recvpkt_cancel
 572
 573                     stream_server
 574
 575                     stream_accept
 576
 577                     stream_client
 578
 579                     stream_close
 580
 581                     stream_auth
 582
 583                     stream_id
 584
 585                     stream_write
 586
 587                     stream_read
 588
 589                     stream_read_cancel
 590
 591
 592
 593         26._Virtual_Tape_API
 594
 595         27._Using_Kerberos_with_AMANDA
 596
 597
 598               AMANDA_2.5.0_-_KERBEROS_v4_SUPPORT_NOTES
 599
 600
 601                     Configuration
 602
 603                     Installation
 604
 605                     conf_file
 606
 607
 608               AMANDA_2.5.0_-_KERBEROS_v5_SUPPORT_NOTES
 609
 610
 611                     Building
 612
 613                     Installation
 614
 615                     conf_file
 616
 617                     Destination_Host_Permissions_file
 618
 619
 620
 621
 622   VI._Historical_files
 623
 624
 625         28._Response_to_CPIO_Security_Notice_Issue_11:
 626
 627
 628               Affected_Versions
 629
 630               Workaround
 631
 632               Acknowledgements
 633
 634
 635         29._Upgrade_Issues
 636
 637         30._What_once_was_new
 638
 639
 640               What's_new_in_AMANDA_2.3
 641
 642
 643                     Indexing_backups_for_easier_restore
 644
 645                     Samba_Support
 646
 647                     GnuTar_Support
 648
 649                     Multiple_backups_in_parallel_from_one_client_host
 650
 651                     Multiple_tapes_in_one_run
 652
 653                     Bottleneck_determination
 654
 655                     2_Gb_limit_removed
 656
 657                     amadmin_import/export
 658
 659
 660               What's_new_in_AMANDA_2.2
 661
 662
 663                     Client_side_setup_has_changed
 664
 665                     Version_suffixes_on_executables
 666
 667                     Kerberos
 668
 669                     Multiple_holding_disks
 670
 671                     Remote_self-checks
 672
 673                     mmap_support
 674
 675                     gzip_support
 676
 677                     Mount_point_names_in_disklist
 678
 679                     Initial_tape-changer_support_included
 680
 681                     Generic_tape_changer_wrapper_script
 682
 683                     New_command_amtape
 684
 685                     Changer_support_added_to_command_amlabel
 686
 687                     Tape_changer_support_improved
 688
 689                     A_few_words_about_multi-tape_runs
 690
 691                     Big_planner_changes
 692
 693                     Level-0_dumps_allowed_with_no_tape
 694
 695
 696
 697         31._Multitape_support_in_AMANDA_2.2
 698
 699
 700               Introduction
 701
 702               New_Planner_Algorithm
 703
 704
 705                     Time
 706
 707                     Full_Backups
 708
 709                     Schedule_Balancing
 710
 711                     Overwrite_Detection
 712
 713
 714               Taper_Algorithm
 715
 716
 717                     Choosing_a_tape
 718
 719                     End_of_tape_handling
 720
 721                     Tape_Format_Changes
 722
 723                     Tapelist_File_Changes
 724
 725
 726
 727         32._Thoughts_about_a_Strategy_API
 728
 729         33._Y2K_Compliancy
 730
 731         34._Usage_of_floppy_tape_drives_on_Linux
 732
 733
 734   VII._Appendixes
 735
 736
 737         35._The_AMANDA_Manual_Pages.
 738
 739         36._Web_Ressources
 740
 741
 742   Index
 743
 744 List of Tables
 745
 746
 747   4.1. Protocol_between_amindexd_and_amrecover
 748
 749   20.1. Operating_Systems_Running_on_AMANDA_Server_Hosts
 750
 751 List of Examples
 752
 753
 754   16.1. A_C_Program_to_Check_the_AMANDA_Service_Numbers
 755
 756 -------------------------------------------------------------------------------
 757
 758          Next
 759      Abstract
 760