2.6 System update guide

Calculate Linux uses Portage to manage updates. You can update your system in two different ways:
  • from packages;
  • from an ISO image.

Updating from packages

The procedure is described below.

1. Update the calculate overlay and the Portage tree

Since our binary repos are regularly updated, make sure your have the latest versions of Portage and the calculate overlay before you install or update any packages.

To update your package tree, just execute:

eix-sync
Once eix-sync is running, it will update consecutively:
  • all of your overlays;
  • your Portage tree;
  • your eix database.

2. Update the software

For Calculate Linux 11.0 release, we created binary packages repositories for four distributions: CLD, CLDG, CLDX and CDS; now all versions of Calculate have binary profiles, so by default, update is performed from binary packages. To change the default update method enter the following:

eselect profile set X

where X is the number under which the desired profile is listed.

If you don't know this number, you can view the list of profiles available for your architecture by entering:

eselect profile list

To update from binary packages use the "binary" profile. To update from source, use the non-labelled profile.

To update the whole of the packages installed on your system, execute:

emerge -uD world

If you edited any USE flags, add the -N option:

emerge -uDN world

Some package you want to update may require a masked dependency, or changes in USE flags. The --autounmask-write option should help to resolve such dependencies.

3. Update configuration files

When you update packages, no configuration files are overwritten by default. To view and apply new settings, execute:

dispatch-conf

The main commands of this utility are: "PageUp"/"PageDown" - browse the configuration file, "u" - replace the current configuration file with the new one, "z" - delete the new configuration file, "q" - quit.

If you want your configuration files to be corrected automatically, set the variable cl_autoupdate_set to "on" in /etc/calculate/calculate.env, as shown below:

[main]
cl_autoupdate_set = on

In this case, always make sure that all config modifications are done correctly; use templates.

Updating from an ISO file

It is possible to upgrade your system by installing a new image onto the free system partition. Main settings such as user accounts, network settings, mount points, screen resolution and other will be transferred, additional settings will be adjusted by templates during installation, as well.

If you have Calculate Directory Server installed, make sure that the /var/calculate directory is mounted at a separate partition on your hard drive. If it is not so, transfer your data and add the necessary mount point in /etc/fstab.

The update procedure is described below:

Open the terminal with root privileges and follow these steps:

1. Update the installer

For a correct update, always use the latest version of calculate-install. You can update it by executing:

eix-sync && emerge calculate-utilities

2. Download the latest Stage

Weekly stages of Calculate Linux are accessible from the http mirror http://mirror.yandex.ru/calculate/, in "stages". Download the latest available image:

cd /var/calculate/remote/linux
wget http://mirror.yandex.ru/calculate/CLD/stages/i686/cld-********-i686.iso

The command shown above must contain the correct path to the file image of your distribution; choose the appropriate architecture.

3. Install the new version

cl-install

If you update Calculate Directory Server, save a copy of your server settings and the LDAP database by executing the following:

cl-backup

Reboot your computer. To restore the LDAP database and the server settings enter:

cl-rebuild

The main advantages of this method are:

  • reliability: you can always boot into the previous system, if the new one should ever become unstable;
  • speed: it will require about 5-7 minutes to complete the system upgrade.

Software included in the ISO image can be pre-modified. If interested, please read the Interactive system build guide.

Thank you!