This is an old revision of the document!
Table of Contents
nfs-ganesha builds and conventions
NFS Ganesha CI is hosted on Openshift and it is located here: https://jenkins-nfs-ganesha.apps.ocp.cloud.ci.centos.org.
Shaman builds are located here: https://shaman.ceph.com/builds/nfs-ganesha/
Stable releases are located here: https://github.com/nfs-ganesha/nfs-ganesha/releases
Version Logic
Last updated 2023-08-24
The current release is ganesha 5.5.
There may be some obscure corner cases, but every recent version (going back to ganesha 3) of ganesha should work with any version of Ceph. Version 5.5 should work with pacific, quincy, reef, and beyond.
If you want to use the packages that ganesha builds, you can get packages from:
- The CentOS Storage SIG for el8 and el9 by first
dnf install -y centos-release-nfs-ganesha5, thendnf install -y nfs-ganesha nfs-ganesha-ceph. - Ubuntu launchpad PPA at https://launchpad.net/~nfs-ganesha. Instructions for adding the PPA can be found there.
- Debian packages in an apt repo at https://download.nfs-ganesha.org/5, specifically at https://download.nfs-ganesha.org/5/5.5/Debian/. Note: there is no nfs-ganesha-ceph package. The README.txt there tells how to add the repo to your system.
(If someone is so inclined, they can use Ganesha 4 by installing centos-release-ganesha4 or the nfs-ganesha-4 ppa instead.)
Ganesha releases happen periodically. Packages usually get built pretty quickly. If you use CentOS, Launchpad, or the Debian repo you'll get the latest build available.
Jenkins Job
Last updated 2023-09-06
This is the Jenkins job that continually builds nfs-ganesha Shaman builds: https://jenkins.ceph.com/job/nfs-ganesha/
If Ceph centos Shaman builds are failing due to something with nfs-ganesha, you'll want to check the nfs-ganesha Jenkins job to see if something is amiss.
Currently, the Jenkins job auto-builds nfs-ganesha V5.5, which is the latest stable build.
As of 2023-09-06, this is the yaml bit in the ceph-build repo that defines which branch to build: https://github.com/ceph/ceph-build/blob/71bf6746bb90692075e245ff08cc11da2a09e0e5/nfs-ganesha/config/definitions/nfs-ganesha.yml#L36-L41
concurrent: true
parameters:
- string:
name: NFS_GANESHA_BRANCH
description: "The git branch (or tag) to build"
default: "V5.5"
To manually schedule a build:
- Select “log in” in the upper right corner
- Select “Rebuid last” or “Build with Parameters” on the left panel, depending on which you need.
