File: UPGRADE

package info (click to toggle)
ndtpd 3.1.2-2
  • links: PTS
  • area: main
  • in suites: woody
  • size: 2,524 kB
  • ctags: 690
  • sloc: ansic: 8,565; sh: 7,275; perl: 655; makefile: 175
file content (254 lines) | stat: -rw-r--r-- 8,556 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254

		    Notes for Upgrade Installation

======================================================================
<< Generic Hints >>

* Use `udtpugrade' to upgrade a configuration file.

Use `ndtpupgrade' if you want to upgrade a configuration file (ndtpd.conf)
with ease.  `ndtpupgrade' reads a configuration file for earlier version
of NDTPD, then generates a new one which is suitable for this version
of NDTPD.

`ndtpupgrade' reads the default NDTPD configuration file, and outputs
new configuration to the file `<default-configuration-file>.new'.  You
can replace your configuration file by the sequence of commands.

	/usr/local/sbin/ndtpupgrade
	mv /usr/local/etc/ndtpd.conf /usr/local/etc/ndtpd.conf.orig
	mv /usr/local/etc/ndtpd.conf.new /usr/local/etc/ndtpd.conf

It supposes that NDTPD has been installed under `/usr/local' and if 
directories for system administrative executables (`sbindir') and for
read-only single-machine data ('sysconfdir') have not been changed at
the installation.

`ndtpupgrade' also reports how does it modify a configuration file.
The reports are output to standard error.

	ndtpd.conf: 8: server-name' is obsoleted (comment out)
	ndtpd.conf: 38: ident-hosts' is obsoleted (comment out)
	ndtpd.conf: 42: ident-timeout' is obsoleted (comment out)
	ndtpd.conf: 89: netmask in `hosts' must be an integer. (fixed)

Try `ndtpupgrade --help' for information about command line options.

======================================================================
<< Incompatible Changes >>

* Letters in book name must be lower case.

Condition:
	Upgrade from version 3.0alpha2 or earlier.

Description:
	In configuration file, allowed characters of the `alias-eiwa',
	`alias-waei' `alias-kojien' sub-directive values are changed.
	While NDTPD of the ealier versions permits upper case letters,
	the later versions permits lower case letters.

	`ndtpupgrade' automatically converts directive and sub-directive
	values.

----------------------------------------------------------------------
* Netmask in `hosts' must be an integer.

Condition:
	Upgrade from version 3.0alpha2 or earlier.

Description:
	In configuration file, notation of netmask is changed from
	network number to netmask length.  For example, the pattern
	`192.168.1.0/255.255.255.0' must be replaced by `192.168.1.0/24'.

	The netmask could be used in the `hosts' directive and the
	`hosts' sub-directive.  

	`ndtpupgrade' automatically converts netmasks.

----------------------------------------------------------------------
* Remove `server-name'.

Condition:
	Upgrade from version 3.0alpha0.

Description:
	`server-name' directives is no longer supported.  Please remove
	the directives in your configuration file.

	`ndtpupgrade' automatically deletes (comment out) the directive.

----------------------------------------------------------------------
* Old log files.

Condition:
	Upgrade from version 2.3.8 or ealier.

Description:
	ndtpdaily compressed old log files by default, but the current
	version of ndtpdaily doesn't.  If you'd like to compress old log
	files, give `-c compress' option to ndtpdaily.

----------------------------------------------------------------------
* Remove `ident-hosts' and `ident-timeout'.

Condition:
	Upgrade from version 2.3.8 or ealier.

Description:
	`ident-hosts' and `ident-timeout' directives are no longer
	supported.  Please remove the directives in your configuration
	file.

	`ndtpupgrade' automatically deletes (comment out) the directives.

----------------------------------------------------------------------
* Install EB Library.

Condition:
	Upgrade from version 2.3.8 or ealier.

Description:
	The current source package doesn't include EB Library.  Please
	get EB Library source package and install it before installing
	NDTPD.

----------------------------------------------------------------------
* Owner, group, and mode of the `work-path' directory.

Condition:
	Upgrade from version 2.3beta1 or earlier.

Description:
	Earlier versions of ndtpd put no file on the `work-path directory,
	if it is invoked from inetd.  But, 2.3beta2 and later versions
	may put some files.

	Please check owner, group, and mode of the directory, if ndtpd
	on your system is invoked from inetd, and if it is not started
	correctly.

----------------------------------------------------------------------
* Modify syslog configuration.

Condition:
	Upgrade from version 2.0.2 or earlier, 2.1beta0 or 2.1beta1.

Description:
	ndtpd comes to output almost informational messages with LOG_INFO
	level that were output with LOG_NOTICE.  Please modify your
	`syslog.conf' like as following:

	    local0.info    /usr/local/var/ndtpd/log/ndtpd.log

	(It is assumed that you choose `local0' as syslog facility for
	ndtpd and `/usr/local/var/ndtpd/log/ndtpd.log' as the log file.)
	Then, restart `syslogd' on your system.

----------------------------------------------------------------------
* Don't use asterisk for IP address pattern

Condition:
	Upgrade from version 2.0beta0+3 or earlier.

Description:
	At the `hosts' directive and the `hosts' sub-directive in the
	`book' group directive in `ndtpd.conf', asterisk wildcard (`*')
	can be used for hostname pattern only (e.g. `*.foo.co.jp').
	An IP address pattern with an asterisk (e.g. `192.24.1.*') doesn't
	cause an error, but it is not recognized as you expect.
	You can use the `addrss/netmask' notation instead (e.g.
	`192.24.1.0/255.255.255.0').

----------------------------------------------------------------------
* Change default appendix directory

Condition:
	Upgrade from version 1.0.x.

Description:
	At `make install', a default appendix directory is created
	automatically.  In NDTPD version 1.0.x, the directory was
	`/usr/local/share/ndtpd/appendix', but the directory is moved
	to `/usr/local/share/eb/appendix' in later versions.
	(It assumes that NDTPD has been installed under `/usr/local'
	and a directory for read-only architecture-independent data 
	(`datadir') has not been changed at installation.)

	After NDTPD installation, move your appendix files to the new
	directory, or remove the directory created at `make install'.
	When you have move your appendix, update `appendix-path' 
	sub-directives in a configuration file (`ndtpd.conf').

----------------------------------------------------------------------
* Use `--enable-ja-doc' instead of `--enable-ja-info'

Condition:
	Upgrade from versions between 1.0.3 and 1.0.6 (including 1.0.3
	and 1.0.6).

Description:
	If you'd like to install a Japanese Info document, invoke the
	`configure' script with the `--enable-ja-doc' option instead
	of `--enable-ja-info'.  The option was renamed.

----------------------------------------------------------------------
* Erase the `pid-file' directive

Condition:
	Upgrade from version 1.0beta2 or earlier

Description:
	Erase the `pid-file' directive in your configuration file
	(`ndtpd.conf').  The directive is obsolete.
	The pid file is created at `<work-path>/pid.file', and it
	cannot be changed.

	Use `ndtpupgrade' if you want to upgrade a configuration file
	with ease.

----------------------------------------------------------------------
* Upgrade appendix data files

Condition:
	Upgrade from version 1.0beta0

Description:
	You must also upgrade appendix data files to version 2.0 or
	later.  

	Because the format of appendix file has been changed between
	1.0 and 2.0, NDTPD version 1.0beta1 and later version cannot
	recognize appendix files of version 1.0.

======================================================================
<< System Specific Information >>

* Set `max-clients' to 0.

Condition:
	On NEXTSTEP and OPENSTEP, upgrade from version 2.3beta1 or
	earlier.

Description:
	See "Frequently Asked Questions, Question 6 (reject any
	connections)" in the NDTPD document.

----------------------------------------------------------------------
* Type `make uninstall' before `make'

Condition:
	On SunOS 4.x, upgrade or downgrade from any version.

Description:
	When an executable binary of `ndtpd' is linked at compilation,
	GNU libtool in `ndtpd' distribution tries to make your linker
	link the EB library (libeb.*) installed at `libdir'.  Unless
	you have invoked `configure' with the `--with-eb-librarei'
	option, the EB library which has already installed at somewhere
	should not be linked to `ndtpd'.  It may causes a linker error,
	and even if the link is succeeded, the generated `ndtpd' may
	be unable to work correctly.  Please type delete the EB library
	installed at `libdir' before `make'.