Sepia Lab Wiki

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

===== 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'', then ''dnf 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
<code>
    concurrent: true
    parameters:
      - string:
          name: NFS_GANESHA_BRANCH
          description: "The git branch (or tag) to build"
          default: "V5.5"
</code>

To manually schedule a build:
  - Visit https://jenkins.ceph.com/job/nfs-ganesha/
  - Select "log in" in the upper right corner
  - Select "Rebuid last" or "Build with Parameters" on the left panel, depending on which you need.

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Share Alike 4.0 International