BeeGFS Upgrade Steps: Version 6.x To 7.0



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 to 7.0 no migration of your stored data is needed other than the quota issue above.
The 7.0 release BeeGFS services can read and modify existing data in the 6.X release series on-disk data format.

Please see the Changelog and the Upgrade Notes before proceeding.

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
Download
(Save to: /etc/yum.repos.d/)
7.x yum
Download
(Save to: /etc/yum.repos.d/)
SLES Linux
(and derivatives,
e.g. OpenSuse)
12.x zypper
Download
(Save to: /etc/zypp/repos.d/)
Debian GNU Linux
(and derivatives,
e.g. Ubuntu)
8.x
(wheezy)
apt
Download
(Save to: /etc/apt/sources.list.d/)
9.x
(stretch)
apt
Download
(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 https://www.beegfs.io/release/beegfs_7/gpg/RPM-GPG-KEY-beegfs


To add the key on Debian, use the following command:
$ wget -q https://www.beegfs.io/release/beegfs_7/gpg/DEB-GPG-KEY-beegfs -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 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.x, 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


Notes



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