OpenBSD
Upgrade Guide: 5.8 to 5.9
[FAQ Index] |
[5.7 -> 5.8]
[5.9 -> 6.0]
Note: Upgrades are only supported from one release to the release immediately
following it.
It is highly recommended that you read through and fully understand this process
before attempting it.
Especially for critical or physically remote machines, it is recommended that
you test it on an identical, local system first.
Boot from the install kernel, bsd.rd.
This can be done by booting from an
install CD, or other
bootable install media.
Alternatively, you can place the 5.9 version of bsd.rd
in the root of
your file system and instruct the boot loader to boot this kernel instead
of your usual kernel -- on amd64 and i386:
boot> boot bsd.rd
Once this kernel is booted, choose the (U)pgrade
option and follow the
prompts.
The upgrade process retains all your configuration info.
If you absolutely have to, you can follow the
manual upgrade process instead.
Final steps:
-
Run sysmerge(8)
as root:
# sysmerge
The sysmerge(8)
utility will compare the files that are currently on your system with
those that would be installed in a fresh install.
It will assist you in merging the changes into your system, using
sdiff(1).
The section on configuration changes lists
some important cases that need extra care.
-
Remove some files.
-
Upgrade your packages using
pkg_add(1):
# pkg_add -u
In many cases, that will be all you need to do.
Check the section below to see if any of your
installed packages require workarounds to upgrade.
Configuration changes
- ntpd.conf(5):
The
rtable
option was removed from server
and
servers
.
Users of server * rtable X
will need to switch to launching
ntpd with
# route -T X exec /usr/sbin/ntpd
- pf.conf(5):
set debug
no longer accepts the none
, urgent
,
misc
and loud
arguments, which were deprecated several
releases ago.
Use emerg
, alert
, crit
, err
,
warning
, notice
, info
or debug
instead.
Change this before updating, or your pf.conf will not load.
-
smtpd.conf(5):
The
pki
keyword no longer accepts a ca
parameter.
Custom CA certificates must be declared using the new ca
keyword:
ca mail.example.org certificate "/etc/mail/CA.pem"
- netstart(8):
Options
multicast_host
and multicast_router
have been
merged into a single multicast
option.
In order to enable multicast the following line should be added in
rc.conf.local(8):
multicast=YES
If you previously set these options to something other than YES
or
the interface carrying the default route, you will also need to add a static
route for 224.0.0.0/4
.
- tun(4):
This was previously a "dual mode" device.
By default it would act as a layer-3 "routed" device, but by use
of the
link0
flag it would change to a layer-2 "ethernet" mode.
This layer-2 mode has now been has been split off to a separate
tap(4)
device.
For some use cases (e.g. ssh tunnel-forwarding run as a non-root user),
permissions on the device nodes would have been modified; these should
be applied to the new device nodes as necessary.
hostname.tun*
files using the link0
flag should be moved
to hostname.tap*
instead, and the flag should be removed.
Other configuration may need to be adjusted to use the new device
name, for example for software like QEMU, OpenVPN or SIMH.
Networking configuration (bridges, PF) referring to these devices
may also need to change.
Files to delete
rm -f /usr/libexec/smtpd/makemap
# People requiring these backends should install the opensmtpd-extras main package.
rm -f /usr/libexec/smtpd/table-ldap
rm -f /usr/libexec/smtpd/table-passwd
rm -f /usr/libexec/smtpd/table-sqlite
rm -f /usr/share/man/man5/table_passwd.5
rm -f /usr/share/misc/termcap.db /usr/share/misc/terminfo.db
rm -f /usr/X11R6/include/intel_*.h
rm -f /usr/X11R6/include/r600_pci_ids.h
rm -f /usr/X11R6/include/radeon_*.h
rm -f /usr/include/malloc.h
rm -f /usr/libexec/auth/login_tis
rm -f /etc/rc.d/yppasswdd /usr/sbin/rpc.yppasswdd
cd /usr/X11R6/include/freetype2
rm -rf config
rm -f freetype.h ftadvanc.h ftbbox.h ftbdf.h ftbitmap.h ftbzip2.h \
ftcache.h ftcffdrv.h ftchapters.h ftcid.h fterrdef.h \
fterrors.h ftfntfmt.h ftgasp.h ftglyph.h ftgxval.h ftgzip.h \
ftimage.h ftincrem.h ftlcdfil.h ftlist.h ftlzw.h ftmac.h \
ftmm.h ftmodapi.h ftmoderr.h ftotval.h ftoutln.h ftpfr.h \
ftrender.h ftsizes.h ftsnames.h ftstroke.h ftsynth.h \
ftsystem.h fttrigon.h fttypes.h ftwinfnt.h t1tables.h \
ttnameid.h tttables.h tttags.h ttunpat.h
Special packages
- php-fpm:
To allow installing multiple versions of php-fpm on the same system,
the rc script has been renamed to include the version number.
Modify references to
php_fpm
in
/etc/rc.conf.local
to e.g. php56_fpm
.
- gophernicus:
in.gophernicus
moved from /usr/local/sbin/
to
/usr/local/libexec
.
Update your /etc/inetd.conf
accordingly.
- puppetboard:
The default configuration file (
default_settings.py
) format has
changed and needs to be merged with default_settings.py.dist
before restarting the puppetboard
service.
- cfs:
The security/cfs port has been removed.
Users are encouraged to use another data encryption method.
Possible alternatives are:
softraid(4) crypto, encrypted vnd(4) devices or the security/encfs port.
Delete the package with
# pkg_delete cfs
-
node modules:
All modules for lang/node have been removed in favor of directly using npm.
Native modules need to be built with
-std=gnu++0x
, so npm
internally sets CXX=eg++
when building native modules.
To remove any installed modules:
for i in node-always node-async node-bcrypt node-bindings \
node-buffer-writer node-canvas node-cloned node-daemon \
node-expresso node-fibers node-generic-pool node-gir \
node-java node-mnm node-pg node-rmdir node-sqlite3 \
node-syslog node-typescript coffeescript;
do
pkg_delete $i
done
Upgrade without the install kernel
This is NOT the recommended process.
Use the install kernel method if at all possible!
Sometimes, you need to do an upgrade of a machine for which the normal upgrade
process is not possible.
The most common case is a machine in a remote location and there is no easy
access to the system console.
Preparation
- Place install files in a good location.
Make sure you have sufficient space!
Running out of space on a remote upgrade could be...unfortunate.
Note that using softdeps can exaggerate the situation as deleted and
overwritten files do not release their space immediately.
Consider disabling the
softdep
mount option in /etc/fstab
and rebooting before undertaking a manual upgrade.
Having at least 200MB free on /usr
would be recommended.
- Becoming root.
While using
doas(1)
before each command is generally a good practice, the command will likely
be broken by the last steps, so you should become root before starting
this process.
It might be good to verify your access to root using a method other than
doas at this point, i.e., direct login or using
su(1).
- Stop and/or disable any appropriate applications.
During this process, all the userland applications will be replaced but
may not be runnable, and strange things may happen as a result.
You may also have issues with DNS resolution during the first reboot, so
PF rules and NFS mounts dependent upon DNS may cause boot-up problems.
There may be other applications which you wish to keep from running
immediately after the upgrade, stop and disable them as well.
- Install new boot blocks.
This should actually be done at the end of any upgrade.
If this has been neglected, then failure to do this now may break serial
console or other things, depending on your platform.
Use
installboot(8),
assuming
sd0
is your boot disk:
installboot -v sd0
Upgrading manually
[FAQ Index] |
[5.7 -> 5.8]
[5.9 -> 6.0]
$OpenBSD: upgrade59.html,v 1.36 2020/08/31 07:06:03 bentley Exp $
¡®Yes, sir. I felt sure you understood that. She said she had told you.¡¯ "Why, eh,--I--I don't know that my movements need have anything to do with his. Yours, of course,--" "Ah, but if it saved your life!" "No, I'm not," grumbled the Doctor, "I've had enough of this wild-goose chase. And besides, it's nearly dinner time." "I am coming to that," Lawrence said, lighting a fresh cigarette. "As soon as Bruce was in trouble and the plot began to reel off I saw that it was mine. Of course there were large varyings in the details, but the scheme was mine. It was even laid on the same spot as my skeleton story. When I grasped that, I knew quite well that somebody must have stolen my plot." Judy In a coach-house, through which we passed on our way to see the prince's favourite horses with the state carriages¡ªquite commonplace and comfortable, and made at Palitana¡ªwas a chigram,[Pg 68] off which its silk cover was lifted; it was painted bright red and spangled with twinkling copper nails. This carriage, which is hermetically closed when the Ranee goes out in it, was lined with cloth-of-gold patterned with Gohel Sheri's initials within a horseshoe: a little hand-glass on one of the cushions, two boxes of chased silver, the curtains and hangings redolent of otto of roses. "Are you certain of it? You have seen so very little of him, and you may be mistaken." "And your wife?" "I drawed on my man's bundle o' wood," said Gid, "and then dropped a little, so's to git him where he was biggest and make sure o' him." HoME²¨¶àÒ°½áÒÂ×óÏßÊÓÆµ
ENTER NUMBET 0016guoanedu.org.cn
hlcitq.com.cn
www.huas97.com.cn
hrmsh.com.cn
www.o1bb.org.cn
mz360.net.cn
www.qzjkkj.org.cn
tjfhs.org.cn
mtwu.com.cn
www.qrogmm.com.cn