Upgrade guide

1. How to upgrade all metwork modules?

1.1 If your starting version is >= 0.9

Warning

This procedure only works if your starting version is >= 0.9.

If your starting version is < 0.9, see next chapter.

CentOS/Fedora

# We stop metwork services
service metwork stop

# We upgrade metwork modules
yum upgrade "metwork-*"

# We start metwork services
service metwork start

Mageia

# We stop metwork services
service metwork stop

# We upgrade metwork modules
urpmi.update -a
urpmi "metwork-*"

# We start metwork services
service metwork start

SUSE

# We stop metwork services
service metwork stop

# We upgrade metwork modules
zypper refresh
zypper update "metwork-*"

# We start metwork services
service metwork start

Note

If your distribution does not provide service command, you can use systemctl stop metwork.service and systemctl start metwork.service instead or /etc/rc.d/init.d/metwork stop and /etc/rc.d/init.d/metwork start (if you don't have a systemd enabled machine or container).

1.2 If your starting version is < 0.9

Warning

This procedure is only necessary if your starting version is < 0.9.

If your starting version is >= 0.9, see previous chapter.

If your starting version is < 0.9 (for example: 0.8.X), the update process does not support major/minor update.

So if you want to update, you have to remove everything and, then, reinstall with the new version.

Warning

There is an automatic backup for files (but please backup by yourself your database content or anything else).

2. FAQ

2.1 Another major/minor version is available but I want to do only a patch update

Let's say you have a mfext-0.8.3 version and you want to update to mfext-0.8.5 (patch update) even if another major/minor (for example: mfext-0.9.Z) version is available.

To do that, you have first to check (and change if necessary) your packages repository configuration (see "Installation Guide"). Be sure to explicitly point to identified release like: .../release_0.8/... (for example).

Then you can use the standard procedure described at the beginning of this document.

Note

You can use use the standard procedure even if your starting version is < 0.9 as the "patch update" is supported for all versions (without reinstalling everything).

2.2 What about if I have several versions of the same module?

For this particular and complex setup, you should have several /release_x.y/ packages repository configurations.

Then, you can use the standard procedure described at the beginning of this document to do a "patch update" of each major/minor installed version.

You just have to add the corresponding -X.Y* suffix to package update commands

For example: yum update metwork-*-0.8*

Note

You can use use the standard procedure even if your starting version is < 0.9 as the "patch update" is supported for all versions (without reinstalling everything).