xref: /minix/docs/UPDATING (revision 90b80121)
120170223:
2	Edit your /etc/rc.conf to set rc_configured to YES.  If you do not,
3	your system will refuse to enter multi-user mode after the next reboot.
4	You can then still make the same edit from single user mode, but that
5	is not as easy.
6
720170222:
8	Because of naming conflicts, the MINIX 3 service(8) utility has been
9	renamed to "minix-service".  After successfully rebuilding the system
10	*and* rebooting (no earlier!), remove the old service utility:
11
12		# rm /bin/service
13
14	Better yet, use the postinstall(8) command to remove all files marked
15	as obsolete.  It is not a bad idea to do this every now and then:
16
17		# postinstall fix obsolete
18
19	..but only ever after the reboot!  Either way, deleting the old service
20	tool will avoid conflicts with the same-named NetBSD utility later on.
21
2220170218:
23	Before starting a build, you will have to update your master.passwd and
24	group files in /etc.  This is needed because we have switched over from
25	the old set of MINIX users and groups to the new set of NetBSD users
26	and groups, as needed by various imported tools.  Follow these steps.
27
28	1. Make a back-up copy of your old master.passwd and group files:
29
30		# cp /etc/master.passwd /etc/master.passwd~
31		# cp /etc/group /etc/group~
32
33	2. Install /usr/src/etc/master.passwd to /etc/master.passwd, and
34	   install /usr/src/etc/group to /etc/group.  If you have NOT created
35	   any local user accounts yourself, for example because you are
36	   upgrading a fresh MINIX 3 installation right away, all you need to
37	   do is copy over those two files:
38
39		# cp /usr/src/etc/master.passwd /etc/master.passwd
40		# cp /usr/src/etc/group /etc/group
41
42	   If you DO have custom user accounts or groups, you need to merge
43	   their lines (and only those!) into the new master.passwd and group
44	   files manually.  If you are unsure whether you have such custom
45	   entries, you can use the following commands:
46
47		# cd /usr/src
48		# git show 68804c2:etc/master.passwd | diff -u - /etc/master.passwd
49		# git show 68804c2:etc/group | diff -u - /etc/group
50
51	   This should show any changes compared to the old two templates.  If
52	   you have such changes, you need to reapply them after copying over
53	   the new two templates.  The following procedure shows one approach:
54
55		# cd /usr/src
56		# cp /etc/master.passwd /tmp/my-passwd
57		# vi /tmp/my-passwd
58		<remove any lines from /tmp/my-passwd that have no password>
59		# cp /usr/src/etc/master.passwd /etc/master.passwd
60		# cat /tmp/my-passwd >> /etc/master.passwd
61		# rm /tmp/my-passwd
62
63	   ..and follow a similar procedure for /etc/group.
64
65	3. Once the new files are in place, update all derived password files:
66
67		# pwd_mkdb -p /etc/master.passwd
68
69	   If you did everything right so far, the following command:
70
71		# postinstall check uid gid
72
73	   ..should show "postinstall checks passed: uid gid" and no failures.
74
75	4. Now perform a full build as usual:
76
77		# cd /usr/src
78		# make build
79
80	   As part of the build, all /dev files will get new proper ownership.
81
82	5. There may still be files that are owned by users and groups that now
83	   have been renumbered.  It is advisable to run at least the following
84	   three commands to apply the renumbering to the most common files:
85
86		# find / -user 2 -exec chown bin \{\} \;
87		# find / -user 5 -exec chown uucp \{\} \;
88		# find / -user 9998 -exec chown games \{\} \;
89
90	   If you have installed custom programs, you may want to check whether
91	   they are not affected by the change.  This should be rare, though.
92
93	Until a subsequent reboot, various running services will show up in
94	ps(1) output and /proc as owned by "postfix".  This is no problem.
95
9620170122:
97	MINIX 3 did not import NetBSD's passwd.conf file, which makes the
98	userland fall back by default to the old, broken UNIX password hashing
99	algorithm. Among other problems, it truncates passwords to the first
100	eight characters.
101
102	Please install /etc/passwd.conf and reset your passwords with passwd.
103
10420160702:
105	Some tools are required to generate the locale resources which are
106	embedded into libintl, which is why you need to run the following:
107
108	for t in gencat locale mkcsmapper mkesdb mklocale
109	do
110		make -C /usr/src/usr.bin/${t} all install
111	done
112
113	Then the usual "make build".
114
11520150623:
116	In order to use the new Unix98 PTYs, and to ensure that the test set
117	continues to pass, please add the following line to your /etc/fstab:
118
119	"none	/dev/pts	ptyfs	rw,rslabel=ptyfs	0	0"
120
12120140801:
122	As the ABI went under heavy changes it is not possible to do a source
123	upgrade (make build) between:
124		commit 7ebdb97a28234e0181f93a8b786331dda507482
125	        Date:   Sun Feb 16 20:08:20 2014 +0000
126	and
127		commit f1deff716ea30b28693c16f8e48ba1a369e2e922
128		Date:   Thu Jul 31 18:36:24 2014 +0200
129
130	WARNING: Attempting to do so will break your system beyond repair, and
131		 require a full reinstallation. You have been warned.
132