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'.
|