BeeGFS Upgrade Steps: Version 2015.03 to 6.x

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
  7. Upgrade from 7.0-rc3

General Information

With the 6.x release series the BeeGFS versioning scheme was changed. Up to 2015.03 the BeeGFS version was formed by the year and the month of the initial release of a major version (e.g. 2015.03), followed by a maintenance release number (e.g. -r20). The new major release introduces a simpler versioning scheme, namely MAJOR.MINOR. As BeeGFS 2015.03 was the 5th major release of BeeGFS, the first major release series with the new naming scheme is 6.x, starting with 6.0 as initial release.

To upgrade your installation from 2015.03 to 6.x no migration of your stored data is needed. The 6.x release BeeGFS services can read and modify existing data in the 2015.03 release series on-disk data format.

If you used metadata mirroring with the 2015.03 release series (which was marked as experimental feature), please note that the mirroring mechanism has changed. Metadata that was mirrored using the 2015.03 release can still be accessed, but changes won't be mirrored. The old directory named "mirror" is no longer accessed after the upgrade and should be deleted to free up disk space. Please refer to the page about Buddy Mirroring for information on how mirroring is implemented in the 6.x release series.

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)
5.x yum
(Save to: /etc/yum.repos.d/)
6.x yum
(Save to: /etc/yum.repos.d/)
7.x yum
(Save to: /etc/yum.repos.d/)
Suse Linux
(and derivatives,
e.g. OpenSuse)
11.x zypper
(Save to: /etc/zypp/repos.d/)
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/)
(Save to: /etc/apt/sources.list.d/)
Table 1: BeeGFS Repository Files

Note: When using apt, please do not forget to run "apt-get 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-get or zypper).

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

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 6.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


Upgrade from 7.0-rc3

If you were using BeeGFS 7.0-rc3 before, instead of using yum update, the yum downgrade option together with the explicit BeeGFS versions can be used, e.g. if all BeeGFS packages are installed:
$ yum downgrade beegfs-mgmtd-7.0-el7.x86_64 beegfs-meta-7.0-el7.x86_64 beegfs-storage-7.0-el7.x86_64 beegfs-helperd-7.0-el7.x86_64 beegfs-client-7.0-el7.noarch beegfs-opentk-lib-7.0-el7.x86_64 beegfs-common-7.0-el7.noarch beegfs-admon-7.0-el7.x86_64 beegfs-mon-7.0-el7.x86_64 beegfs-utils-7.0-el7.x86_64

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