Imported Upstream version 3.1.0
[debian/amanda] / ndmp-src / README
1 This is a heavily-modified versino of NDMJOB, adapted to build
2 as part of Amanda.  Below is the original README file
3
4
5 ****************************************************************
6
7
8 NDMJOB is a NDMP-compatible backup/restore package, reference
9 implementation, and conformance test. It is furnished in source
10 code form to the public by Traakan, Inc. and other contributors
11 free of charge or restriction. NDMP (Network Data Management
12 Protocol) is an open protocol for network based backup enabling
13 multi-vendor backup solutions. NDMJOB may be used as a ready-to-run
14 backup package, used in conjunction with other NDMP products,
15 as the basis for new products, as a verification of NDMP products,
16 and as a reference of the NDMP protocol standards and conventions.
17
18 http://www.traakan.com/ndmjob   NDMJOB latest source and docs
19 http://www.ndmp.org             NDMP protocol status and info
20 mailto:ndmp-tech@ndmp.org       Questions, comments and bug reports.
21 mailto:ndmjob@traakan.com       Contributions and bug fixes
22
23
24
25
26
27
28
29 ================================================================
30
31 1-Mar-2000   NDMJOBLIB:1.1 Release
32
33 Howdy NDMP Folx,
34
35 A PRE-CONNECTATHON drop of NDMJOB is available. Please see
36
37         http://www.traakan.com/ndmjob/
38
39 This is NDMJOBLIB version is 1.1.
40
41 There has been a fair bit of shake-out. Many bugs
42 are fixed. There will be more shake-out before
43 Connectathon. It really is in pretty good shape.
44
45 Most of the NDMPv3 work is done. What's missing is the
46 ability to provide a name list (nlist[]) to the RECOVER
47 and RECOVER_FILEHIST. This needs to be discussed
48 because the ndmp3_name is a bit awkward for the
49 tar(1) format. Also, ndmjob -x hasn't been tried
50 and probably won't work.
51
52 It does to direct and sequential recover of the image
53 stream. There are lots and lots of DATA_READ messages
54 passed around if you enable them with -E RECOVER_DIRECT=yes.
55
56 The MD5 stuff isn't integrated, but will be by Connectathon.
57 It looks pretty good, and won't take much time.
58
59 There are template files ndmos_xxx.h and ndmos_xxx.c for the
60 O/S specific portions. ndmos_freebsd.[ch] and ndmos_solaris.[ch]
61 are here, and use the tape simulator. No SCSI support. If you
62 make a new ndmos_xxx.[ch], or fix the ones already here, please
63 be a good sport and contribute them back.
64
65 There is a new file in the source directory called
66 ThingsToTry. This represents what Traakan will try
67 with NDMJOB as a CONTROL agent (client) at Connectathon.
68
69 Please send comments, questions, bug reports to ndmp-tech@ndmp.org.
70 Please send contributions, like ndmos_xxx.[ch] and bug fixes, to
71 ndmjob@traakan.com.
72
73 Regards,
74         -gww
75
76
77
78
79 PLANNED DROPS
80 =============
81
82 1.2 Connectathon, Mar-2-2000. Improved tests. Integration
83     of contributions and bug fixes. While at Connectathon,
84     NDMJOB will be adapted real-time to reflect consensus.
85
86 1.3 Post Connectathon. Week of Mar-13-2000. Changes at
87     Connectathon integrated.
88
89
90
91
92
93 ================================================================
94
95 18-Feb-2000   NDMJOBLIB:1.0 Release
96
97
98 Howdy NDMP Folx,
99
100 A PREVIEW drop of NDMJOB is available. Please see
101
102         http://www.traakan.com/ndmjob/
103
104 This is the PREVIEW drop of NDMJOB. The NDMJOBLIB version is 1.0.
105
106 The NDMPv3 work isn't quite finished. It's close. It's taking
107 more than I expected. The Makefile here disables the NDMPv3
108 features. You can re-enable them. It does compile, and some
109 things work.
110
111 There are template files ndmos_xxx.h and ndmos_xxx.c for the
112 O/S specific portions. ndmos_freebsd.[ch] and ndmos_solaris.[ch]
113 are here, and use the tape simulator. No SCSI support. If you
114 make a new ndmos_xxx.[ch], or fix the ones already here, please
115 be a good sport and contribute them back.
116
117 It's been quite a while and a few hundred changes since I've
118 put NDMJOB through it's paces. Bugs and quirks are likely.
119
120 Please send comments, questions, bug reports to ndmp-tech@ndmp.org.
121 Please send contributions, like ndmos_xxx.[ch] and bug fixes, to
122 ndmjob@traakan.com.
123
124 Regards,
125         -gww
126
127
128
129
130 PLANNED DROPS
131 =============
132
133 1.1 Week of Feb-21-2000. NDMPv3 work completed. Most DATA agent
134     functions working. Some improvement in -o test-tape and
135     -o test-mover. Lots of work on the docs
136
137 1.2 Connectathon, Mar-2-2000. Improved tests. Integration
138     of contributions and bug fixes. While at Connectathon,
139     NDMJOB will be adapted real-time to reflect consensus.
140
141 1.3 Post Connectathon. Week of Mar-13-2000. Changes at
142     Connectathon integrated.
143
144
145
146 ((THINGS TO TRY moved to file ThingsToTry))