Git-Url: http://git.frugalware.org/gitweb/gitweb.cgi?p=frugalware-0.7.git;a=commitdiff;h=fc167a4d59179fb1fec6fca92714a24116e9f224
commit fc167a4d59179fb1fec6fca92714a24116e9f224 Author: VMiklos <[EMAIL PROTECTED]> Date: Sat Oct 13 01:37:02 2007 +0200 docs/upgrade: added an upgrade howto diff --git a/docs/index-user.txt b/docs/index-user.txt index 6ad1c02..a28c312 100644 --- a/docs/index-user.txt +++ b/docs/index-user.txt @@ -18,6 +18,8 @@ Documentations: * link:quickref.html[Quick reference] +* link:upgrade.html[Upgrading from Frugalware 0.5] + * link:install.html[Installation] * link:postinst.html[Post-install configuration] diff --git a/docs/index.txt b/docs/index.txt index 6be992a..6fc9600 100644 --- a/docs/index.txt +++ b/docs/index.txt @@ -17,6 +17,8 @@ Documentation for users: * link:quickref.html[Quick reference] +* link:upgrade.html[Upgrading from Frugalware 0.5] + * link:install.html[Installation] * link:postinst.html[Post-install configuration] diff --git a/docs/upgrade.txt b/docs/upgrade.txt new file mode 100644 index 0000000..cfa04b6 --- /dev/null +++ b/docs/upgrade.txt @@ -0,0 +1,96 @@ += Upgrading from Frugalware 0.6 to 0.7 + +== Preamble + +The aim of this howto is to show how you can upgrade a Frugalware-0.6 +(Terminus) system to Frugalware-0.7 (Sayshell). + +== libpacman + +Terminus comes with a new package magement library, called libpacman. It is +provided by the `pacman-g2` package, so the first step is to install it: + +------------------------------------------------------------------------------- +# pacman-g2 -Sy pacman-g2 +------------------------------------------------------------------------------- + +NOTE: Don't worry, this will upgrade glibc and the timezone database, too. This +is expected. + +== Removing obsolete packages + +Some software has been removed from Sayshell, after the upgrade you can install +their alternates. To remove them: + +---- +# pacman-g2 -Rd gst-plugins-bad-swfdec gst-plugins-bad-wavpack libgc +---- + +NOTE: Of course if you don't have these packages (which is not the default) you +can skip this step. + +== Upgrading the system + +Now it's time to upgrade the system itself: + +------------------------------------------------------------------------------- +# pacman-g2 -Su +------------------------------------------------------------------------------- + +You will be asked to replace a few packages automatically. The following ones +are normal and you are expected to answer 'Y' to these questions (or just hit +ENTER): + +---- +: Starting local database upgrade... +:: Replace cvsup with frugalware/csup? [Y/n] +:: Replace frugalpkg with frugalware/gfpm? [Y/n] +:: Replace control-center with frugalware/gnome-control-center? [Y/n] +:: Replace libgksu2 with frugalware/libgksu? [Y/n] +:: Replace gaim with frugalware/pidgin? [Y/n] +:: Replace gaim-plugin-encryption with frugalware/pidgin-encryption? [Y/n] +:: Replace gaim-plugin-guifications with frugalware/pidgin-plugin-guifications? [Y/n] +:: Replace scrollkeeper with frugalware/rarian? [Y/n] +:: Replace util-linux with frugalware/util-linux-ng? [Y/n] +:: Replace x-cursors-industrial with frugalware/x-cursors-dmz? [Y/n] +---- + +After this the list of to-be-upgraded packages is displayed. Just hit anter and +wait. Make some tea, it can take a while :-) + +== Install replacement softwares + +---- +# pacman-g2 -S gst-plugins-bad gst-plugins-good-wavpack libgc --noconfirm +---- + +NOTE: If you did not remove the equivalent of these packages before the +upgrade, then you can skip this step. + +== amavis and munin + +The upgrade of these packages are not fully automated. You have to read the +documents located at `/usr/share/doc/amavisd-new-2.5.2/README.Frugalware` and +`/usr/share/doc/munin-1.2.5/README.Frugalware` to complete the upgrade if you +have these packages installed. + +== Device name changes + +Intel users will have `/dev/sd*` devices rather than `/dev/hd*` ones. The +reason is the following: It was not possible to boot the kernel on some +machines without this change. See link:http://bugs.frugalware.org/2243[this +bugreport] for more details. So after upgrading, you need to: + +* Check if you have an Intel IDE controller using `lspci |grep -i intel.*ide` + as `root`. If you got no result then probably you're not affected. + +* Edit `/etc/fstab`: change all occurrences of `/dev/hd` to `/dev/sd`. + +* Edit `/boot/grub/menu.lst`: change all occurrences of `/dev/hd` to `/dev/sd` + in the Frugalware entry. + +== Rebooting + +Since the kernel is upgraded, too, you have to reboot your machine now. + +Done! _______________________________________________ Frugalware-git mailing list [email protected] http://frugalware.org/mailman/listinfo/frugalware-git
