BeeGFS Upgrade Steps: Version 6.x/7.0 To 7.1

Table of Contents (Page)

  1. General Information
  2. Step 1: Stop all BeeGFS services
  3. Step 2: Install new BeeGFS Repository files
  4. Step 3: Update to new BeeGFS Packages
  5. Step 4: Start the BeeGFS services
  6. Notes

General Information

Important Note: due to a known bug in versions 7.0 to 7.1.1, quota settings can get lost when you restart the management server. For details on how to backup existing quota settings for a running system, please visit BackupRestoreQuota.

To upgrade your installation from 6.x or 7.0 to 7.1 no migration of your stored data is needed other than the quota issue above.
The 7.1 release BeeGFS services can read and modify existing data in the 7.0 or 6.X release series on-disk data format.

Please see the Changelog and the Upgrade Notes before proceeding.

Make sure, that all clients and servers are upgraded consistently to BeeGFS Version 7.1, since no mixed installations are supported.

Step 1: Stop all BeeGFS services

Before performing the upgrade, stop all BeeGFS services of the BeeGFS instance that you want to upgrade, including unmounting of all connected clients.

Before stopping the BeeGFS server-side services, you can use the beegfs-ctl tool to see the list of mounted clients to make sure that you really unmounted all of them:
$ beegfs-ctl --listnodes --nodetype=client

Step 2: Install new BeeGFS Repository files

Install the corresponding new BeeGFS repository file for your distribution on all BeeGFS clients and servers.

Linux Base DistributionVersionPackage ManagerRepository File
(Save to...)
Red Hat Linux
(and derivatives,
e.g. Fedora)
6.x yum
(Save to: /etc/yum.repos.d/)
7.x yum
(Save to: /etc/yum.repos.d/)
SLES Linux
(and derivatives,
e.g. OpenSuse)
12.x zypper
(Save to: /etc/zypp/repos.d/)
Debian GNU Linux
(and derivatives,
e.g. Ubuntu)
(Save to: /etc/apt/sources.list.d/)
(Save to: /etc/apt/sources.list.d/)
Table 1: BeeGFS Repository Files

Note: When using apt, please do not forget to run "apt update" after adding the repository.

BeeGFS repositories and packages are digitally signed. If you would like to verify the package signatures, you can add the public BeeGFS GPG key to your package manager:
To add the key on RedHat/SuSE, use the following command:
$ rpm --import

To add the key on Debian, use the following command:
$ wget -q -O- | apt-key add -

Step 3: Update to new BeeGFS Packages

Now the packages on all clients and servers can simply be updated with your distribution's package manager (e.g. yum, apt, or zypper).

On RHEL, you would use this command:
$ yum update "beegfs*"

If you are using RDMA, you need to install the new package lib-beegfs-ib in addition on all respective servers:
$ yum install "libbeegfs-ib"

Uninstall the opentk-lib package, which is no longer needed:
$ yum remove "beegfs-opentk-lib"

If systemd is used, reload the units:
$ systemctl daemon-reload

Step 4: Start the BeeGFS services

After performing the update, you can simply start the BeeGFS services again.

If you want to confirm that you are now running version 7.1, you can use the beegfs-ctl tool, e.g.:
$ beegfs-ctl --listnodes --showversion --nodetype=meta
$ beegfs-ctl --listnodes --showversion --nodetype=storage
$ beegfs-ctl --listnodes --showversion --nodetype=client

The following command will check whether all your server daemons are up and running:
$ beegfs-check-servers


Back to table of contents
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki