Bering-uClibc 5.x - User Guide - Upgrade LEAF Bering-uClibc

From bering-uClibc
Revision as of 12:39, 8 December 2015 by Etitl (Talk | contribs)

Jump to: navigation, search
Upgrade LEAF Bering-uClibc
Bering-uClibc 5.x - User Guide


Upgrade LEAF Bering-uClibc

Starting with LEAF Bering-uClibc 5.2.2 the new tool upgrade is available. It allows to upgrade your LEAF software online using a server at sourceforge.net.


Invocation

Upgrade is a command line tool. Just establish a terminal connection to your LEAF box and enter upgrade and your prefered option. Without options upgrade will use the current stable version as defined on the repository server. Below you can find the options you can use with upgrade. SALT# upgrade --help Usage: upgrade [-s] [-c] [-vv | --vvv] [--stable | --latest | --release x.y.z] [--compact-modules] [-u | --use_apkg]

-c just check the version on the server -s be silent -vv | -vvv be more chatty --stable upgrade to stable release, this is the default behaviour --latest upgrade to latest release --release x.y.z upgrade to release x.y.z --compact_modules remove unloaded modules -u | --use_apkg use apkg -u to handle modified packages instead of the internal routines -h | --help show this page

Prerequisites Your LEAF box must have the software stored on a RW medium, which excludes all CD based systems. There must be some free space on the storage medium as the distribution tends to grow. You need a working internet connection and use either shorewall as your firewalling software or your router must be able to open a http connection to sourceforge. How does it work Upgrade connects to a repository server at sourceforge.net and tries to find the software you specified according to the chosen options. It then inspects the running system and selects the packages to be upgraded. The packages are downloaded to your storage medium. Upgrade inspects your configuration files and tries to detect the modifications you made to the originals. It patches the new configuration files using those modifications with the goal to provide a seamless upgrade. All operations are logged to syslog with the syslog facility local0 for you to inspect and, if needed, fix inconsistencies before you reboot the system. If a configuration file cannot be patched safely, then copies of the old and new files are left in the /tmp directory. If an error occurs by upgrade a non null status code is returned by upgrade. If you decide to inspect your modifications manually, the option -u lets you invoke the apkg -u tool to freely check and select your configuration files for each package. You must save the newly built configuration files to storage before you reboot. Suggestions and hints Before you start upgrade save your configuration files to storage using the web GUI or lrcfg. Save your current software by connecting to the LEAF box and copying everything from storage using a tool like scp. It is best to run upgrade on a dual boot system, so you have a fallback should there be a problem booting the new software. Examples Check for the current stable release SALT# upgrade -c 5.2.0 Check for the latest available release SALT# upgrade -c –latest 5.2.2 Run upgrade to latest SALT# upgrade –latest upgrade: starting upgrade: retrieve http://sourceforge.net/p/leaf/packages/ci/master/tree/latest upgrade: retrieve http://sourceforge.net/p/leaf/packages/ci/5.2.2/tree/i386/linux-geode upgrade: retrieve http://sourceforge.net/p/leaf/packages/ci/5.2.2/tree/i386/initrd.lrp upgrade: retrieve http://sourceforge.net/p/leaf/packages/ci/5.2.2/tree/i386/initmod-geode.lrp upgrade: retrieve http://sourceforge.net/p/leaf/packages/ci/5.2.2/tree/i386/moddb-geode.lrp upgrade: retrieve http://sourceforge.net/p/leaf/packages/ci/5.2.2/tree/i386/modules-geode.sqfs upgrade: retrieve http://sourceforge.net/p/leaf/packages/ci/5.2.2/tree/geode/firmware/e100 upgrade: build /tmp/moddb.lrp upgrade: retrieve http://sourceforge.net/p/leaf/packages/ci/5.2.2/tree/i386/sha1sum.list upgrade: retrieve http://sourceforge.net/p/leaf/packages/ci/5.2.2/tree/i386/dnsmasq.lwp upgrade: retrieve http://sourceforge.net/p/leaf/packages/ci/5.2.2/tree/i386/hostapd.lwp upgrade: retrieve http://sourceforge.net/p/leaf/packages/ci/5.2.2/tree/i386/webconf.lwp upgrade: retrieve http://sourceforge.net/p/leaf/packages/ci/5.2.2/tree/i386/wpasupp.lwp upgrade: upgrade terminated successfully


Up