This file documents the instructions for upgrading to Bluewhite64 12.0, the packages added, removed, renamed, and/or split during the development cycle from Bluewhite64 11.0 through Bluewhite64 12.0, and some potential "gotchas" that users can avoid by arming themselves with a little knowledge. *** INSTRUCTIONS FOR UPGRADING FROM 11.0: *** Note: Follow these steps in this order 1. Go into single user mode (runlevel 1) with "telinit 1" 2. Upgrade the a/glibc-solibs package. 3. Upgrade the a/pkgtools and a/sed packages. 4. Remove all of the x/ series packages ( cd /var/log/packages ; removepkg x11-* fontconfig* dejavu-ttf* ttf-indic-fonts* ). 5. Upgrade the aaa_base package - this MUST be done before the next step. 6. Using "upgradepkg --install-new" install the new l/expat, x/libfontenc, x/fontconfig, x/mkfontdir, x/mkfontscale, and x/x11-skel packages. 7. Upgrade/install everything else using "upgradepkg --install-new" - note that you can skip the KDEI series if your only language is English. Even if you do need something in this series, it might be best to skip it for now and then install only what you need later. 8. Remove all of the packages listed above in the "PACKAGE REMOVALS" section. 9. Make sure the paths in /etc/lilo.conf point to a valid kernel and run "/sbin/lilo" to reinstall LILO. Note that by default, /boot/vmlinuz will be a symlink to the "huge" kernel. 10. Be sure to move your *.new config files into place and merge any custom changes you had made to the originals. To find them, run: find /etc -name "*.new" You will need to leave passwd, shadow, group, and gshadow alone for the most part (do not copy the *.new versions over the existing ones), but you will need to add any new user/group accounts in passwd.new and group.new to the existing files. There have also been some changes to the network scripts, so pay close attention to those as well. 11. You can either reboot or do "telinit 3" to go back to runlevel 3. You will need to generate a new /etc/X11/xorg.conf file after upgrading, and you will also need to have each user run /usr/bin/xwmconfig again to copy the updated xinitrc files to $HOME/.xinitrc (if using runlevel 3). If you're using fluxbox, you will probably want to verify all of the paths defined in $HOME/.fluxbox/startup (and maybe other files there) too. The old contents of /usr/X11R6 has been moved to a /usr/X11R6.bak directory. This setup should allow third party video drivers to find X in the old places. Anything you really want to keep will need to be merged back by hand, although you should strongly consider recompiling anything still there. If you had any custom additions to /etc/X11/xkb (such as in ./symbols/pc/), the contents of the old directory will be present after upgrading at: /etc/X11/xkb.old.bak.$$ If you had not made any custom additions, this directory might still be present - it is safe to remove. If you have problems (especially regarding fonts) after the upgrade, run pkgtool and re-run the mkfontdir and fontconfig setup scripts. sysvinit and udev were upgraded, and the actual init scripts were split out into the sysvinit-scripts package. Be sure to install it, and don't forget to move/merge all of the associated *.new files into place or your system will not boot. If you have more than one network card and have been using /etc/udev/rules.d/network-devices.rules, the new syntax requires using ATTR{address} instead of SYSFS{address}, and the file is now called /etc/udev/rules.d/75-network-devices.rules. While we're on the subject of udev, all udev rules files should now have numerical prefixes, so you should remove any leftover rules files that do not have numerical prefixes and rename any custom rules files. Some of the syntax in the network initialization scripts has changed in this release (particularly that relating to WLAN_IWPRIV in rc.inet1.conf and IWPRIV in rc.wireless.conf). The /dev/cdrom line in /etc/fstab is commented out by default, as it interferes with HAL. HAL defaults to on, so if you do not wish to use it, you will need to chmod -x /etc/rc.d/rc.hald and uncomment the /dev/cdrom line in /etc/fstab Note that HAL will honor settings in /etc/fstab if a device is present there, so you could technically have removable devices defined in /etc/fstab, but if the fstab settings do not allow normal users to mount them (with the "user" or "users" option), then HAL/dbus will not allow them to be mounted either. Also note that you will need to run "/etc/rc.d/rc.messagebus reload" after adding any users to plugdev, power, or video groups so that it re-reads the /etc/group file. The Bluewhite64 kernels now include support for the "magic SysRQ key." For more information about what this is and how it can be used, see /usr/src/linux-2.6.21.5/Documentation/sysrq.txt After you've read this, if you would like to disable it, there are at least two ways to do so. 1. Add the following to /etc/sysctl.conf (note that this file does not exist by default, so you'll have to create it): kernel.sysrq = 0 2. Add the following to one of the init scripts (preferably rc.local): echo 0 > /proc/sys/kernel/sysrq The first method has the advantage of being run from rc.S when the system first comes up, while the second will be run only after the system is in multi-user mode. It's up to you as to which is better. All php extensions built in /usr/lib/php/extensions are activated by default; if you don't want any of them, comment them out in /etc/httpd/php.ini gcc-3.4.6 has been moved to /pasture. We've upgraded to gcc-4.1.2, but gcc-3.4.6 is being kept around because some things still aren't ready for gcc-4. The upgrade to gcc-4.1.2 is likely to cause problems with building some software from source. Please complain to the upstream maintainers... :) *** PACKAGE ADDITIONS SINCE 11.0: *** A software series/aaa_terminfo: split from the pkgtools package. A software series/cryptsetup: add cryptsetup package. A software series/cxxlibs-6.0.8: added cxxlibs-6.0.8 A software series/dialog: split from the pkgtools package. A software series/dosfstools: split from the bin package. A software series/ed: split from the bin package. A software series/eject: split from the bin package. A software series/file: split from the bin package. A software series/lha: split from the bin package. A software series/kernel-generic: moved from /extra, requires initrd. A software series/kernel-huge: added full-featured kernel (no initrd needed). A software series/mtx: added the mtx package. A software series/ncompress: split from the bin package. A software series/patch: split from the bin package. A software series/rpm2tgz: split from the bin package. A software series/splitvt: split from the bin package. A software series/sysvinit-scripts: split from the sysvinit package. A software series/time: split from the bin package. A software series/tree: split from the bin package. A software series/unarj: split from the bin package. A software series/which: split from the bin package. A software series/zoo: split from the bin package. AP software series/dmidecode: added the dmidecode package. AP software series/ghostscript-fonts-std: added - this replaces the gnu-gs-fonts package. AP software series/hplip: moved from /testing (replaces hpijs) AP software series/lsscsi: added the lsscsi tool. AP software series/nano: added the nano editor. AP software series/mtx: added the mtx package. D software series/cmake: added the CMake package. D software series/gcc-gfortran: this package replaces the gcc-g77 package. D software series/gperf: added gperf package. D software series/pkg-config: renamed from pkgconfig. L software series/dbus: added dbus IPC library. L software series/dbus-glib: added glib bindings for dbus. L software series/svgalib: added svgalib-1.9.25. L software series/dbus-qt3: added qt3 bindings for dbus. L software series/gamin: added gamin library. L software series/gmime: added gmime library - used by new pan version. L software series/hal: added hardware abstraction layer. L software series/hal-info: added hal-info package (device information). L software series/libkarma: added libkarma - used by amarok L software series/lzo: added lzo library. L software series/mcs: added mcs library. L software series/poppler: added poppler library. L software series/poppler-data: added poppler data. L software series/svgalib_helper: this package contains the kernel helper module(s) needed by the svgalib package. L software series/vte: added vte library used by Xfce's Terminal program. KDE software series/knemo: added knemo package. KDE software series/k3b: added (moved from /extra). N software series/biff+comsat: split from old n/tcpip package. N software series/bluez-firmware: added bluez-firmware. N software series/bluez-hcidump: added bluez-hcidump. N software series/bluez-libs: added bluez-libs. N software series/bluez-utils: added bluez-utils. N software series/bridge-utils: split from old n/tcpip package. N software series/bsd-finger: split from old n/tcpip package. N software series/dirmngr: added dirmngr. N software series/ethtool: split from old n/tcpip package. N software series/gnutls: added GNU TLS library. N software series/gnupg2: added GnuPG 2 - this is *not* a replacement for gnupg-1.4.x. N software series/gpa: added gpa. N software series/gpgme: added gpgme. N software series/icmpinfo: split from old n/tcpip package. N software series/iputils: split from old n/tcpip package. N software series/libassuan: added libassuan. N software series/libksba: added libksba. N software series/pinentry: added pinentry. N software series/net-snmp: added net-snmp. N software series/mcabber: added mcabber package. N software series/mtr: added mtr. N software series/net-tools: split from old n/tcpip package. N software series/netatalk: the AppleTalk Protocol Suite. N software series/netdate: split from old n/tcpip package. N software series/netkit-*: split from old n/tcpip package. N software series/network-scripts: split from old n/tcpip package. N software series/netwrite: split from old n/tcpip package. N software series/pinentry: added pinentry. N software series/pth: added pth. N software series/tcp_wrappers: split from old n/tcpip package. N software series/telnet: split from old n/tcpip package. N software series/tftp-hpa: split from old n/tcpip package. N software series/openobex: Object Exchange protocol library N software series/obexftp: added obexftp. N software series/vlan: split from old n/tcpip package. X software series/*: except for fontconfig, all packages here are new. They replace the old x11-* with the X.org modular release. XAP software series/audacious: added Audacious media player. XAP software series/audacious-plugins: added plugins for audacious. XAP software series/gqview: added GQView image browser. XAP software series/blackbox: added blackbox window manager. XAP software series/seyon: added seyon - communications package XAP software series/xfractint: added xfractint XAP software series/pidgin: added pidgin (replaced gaim). EXTRA software/btmgr: added btmgr-3.7. *** PACKAGE REMOVALS SINCE 11.0: *** A software series/hotplug: removed since this is for 2.4.x kernels. A software series/pcmcia-cs: removed since this is for 2.4.x kernels. AP software series/gnu-gs-fonts: removed (replaced by the ghostscript-fonts-std package). AP software series/hpijs: removed (replaced by hplip). AP software series/raidtools: moved to /pasture (use mdadm). D software series/byacc: removed since pretty much everything uses bison now. D software series/gcc-g77: this package was replaced by the gcc-gfortran package. D software series/pkgconfig: removed - renamed to d/pkg-config. L software series/gdk-pixbuf: removed; no Bluewhite64 packages link to this old library. L software series/glut: removed since MesaGLUT is now included with the Mesa package. L software series/gnet: removed; was needed by Pan newsreader, but no Bluewhite64 packages link to this any more. X software series/x11-*: removed old x/x11-* packages - replaced by new modular x11. XAP software series/gaim: removed (replaced by pidgin). XAP software series/xfm: moved to /pasture - it was recompiled, so it should still work on -current, but there are better file manager choices now... XAP software series/xmms: removed. Dropped the /lib64 and /usr/lib64 directories. Now all libraries should be in the new locations, /lib and /usr/lib. If you found packages that still using the /lib64 and /urs/lib64 please report to arny at bluewhite64 dot com. *** OTHER NOTABLE CHANGES AND HINTS: *** A software series/aaa_base: rebuilt. The old contents of /usr/X11R6 will be backed up to /usr/X11R6.bak. This package needs to be upgraded *before* any of the new X/ series packages are installed. A software series/bin: Most of the utilities were split from this package (see the Additions section above). {A,L software series}/glibc-*: upgraded to version 2.5 - be sure to do this upgrade in runlevel 1 (according to the usual instructions in UPGRADE.TXT). Also note that you MUST be running a 2.6 kernel before performing this upgrade! A software series/mdadm: moved from AP series. A software series/mt-st: moved from AP series. A software series/pkgtools: upgraded to remove several stale bits. AP software series/hplip: now depends on n/net-snmp (and some other things probably will too). L software series/qca: moved from KDE series. L software series/qca-tls: moved from KDE series. L software series/qt: moved from KDE series. L software series/svgalib_helper: if you build a custom kernel and need to use the helper module for svgalib, you will need to rebuild this package to create the needed module for your custom kernel. N software series/tcpip: this package was split up and removed (see Additions above). KDE software series/amarok: This is now linked with libkarma, but you'll need to get the omfs kernel module for it to work. KDE software series/kdegraphics: this package requires the l/poppler package. KDE software series/koffice: this package requires the l/poppler package. KDE software series/*: KDE is now built with --prefix=/usr instead of /opt/kde, so it's now much easier to follow the freedesktop.org standards for unifying all of the various Linux desktop environments. X software series/xaw3d: moved from L series. XAP software series/rdesktop: moved from N series. xtra/xf86-video-ati-6.6.3: Added an alternate ati driver for xorg due to some reports of the 6.6.192 driver not working on some hardware. If the 6.6.192 driver does not work for you, try this one. extra/intel-wlan-ipw3945: Added kernel patches and support sources for using the Intel ipw3945 wireless drivers. Due to the need to patch the kernel for a newer ieee80211 subsystem, these are all in source form rather than as packages. Consider it an opportunity to learn. :-) xcdroast has been moved to unsupported (but recompiled for this release). (Based on the CHANGES_AND_HINTS.TXT by rworkman)