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
 


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.

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


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


Notes



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