Files
leonarski_fandClaude Fable 220e88de8a Analysis reference and server pages: state the behaviour, not the measurement campaign
The data-analysis reference keeps the rationale for each decision but no
longer quotes battery arms, per-set counts and medians, or the history of
how a default came to be. The deployment, repository, release-contents
and writer pages describe the current packages and formats without the
renames and removals of earlier versions.

Co-Authored-By: Claude Fable <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HVeDQsU5a8AJUdJPgWevAK
2026-11-10 17:18:40 +01:00

57 lines
3.2 KiB
Markdown

# Linux package repositories
For convenience, we are providing package repositories, in versions including and excluding CUDA linking.
We recommend installing the Jungfraujoch viewer from a `nocuda` repository (published in the `slsdet8` flavour only) and the remaining packages from a `cuda12`/`cuda13` repository.
The repository name encodes two choices: the [slsDetectorPackage](DETECTORS.md) version the packages
were built against (`slsdet8` = 8.0.2, `slsdet9` = 9.2.0 — it must match the detector firmware) and
whether CUDA is linked in. What ends up inside each package, and what it needs on the target
machine, is described in [Release contents](RELEASE_CONTENTS.md).
## RHEL based systems
For RHEL systems we provide the following repositories:
| RHEL version | slsDetectorPackage | CUDA | Repository file |
|--------------|--------------------|------|------------------------------------------------------------------------|
| 8.x | 8.0.2 | 12.x | https://gitea.psi.ch/api/packages/mx/rpm/centos/el8/slsdet8-cuda12.repo |
| 8.x | 9.2.0 | 12.x | https://gitea.psi.ch/api/packages/mx/rpm/centos/el8/slsdet9-cuda12.repo |
| 8.x | 8.0.2 | - | https://gitea.psi.ch/api/packages/mx/rpm/centos/el8/slsdet8-nocuda.repo |
| 9.x | 8.0.2 | 13.x | https://gitea.psi.ch/api/packages/mx/rpm/centos/el9/slsdet8-cuda13.repo |
| 9.x | 9.2.0 | 13.x | https://gitea.psi.ch/api/packages/mx/rpm/centos/el9/slsdet9-cuda13.repo |
| 9.x | 8.0.2 | - | https://gitea.psi.ch/api/packages/mx/rpm/centos/el9/slsdet8-nocuda.repo |
To install the repository, run:
```bash
dnf config-manager --add-repo https://gitea.psi.ch/api/packages/mx/rpm/centos/el8/slsdet8-cuda12.repo
```
RPMs are signed by the Gitea package registry as they are uploaded. If your system cannot verify the
signature, set `gpgcheck=0` in the repository file or install with `--nogpgcheck`.
We provide the following packages in the repository:
* jfjoch — broker, web frontend, FPGA and detector command-line tools
* jfjoch-driver-dkms — PCIe kernel-module source, built by DKMS
* jfjoch-writer — HDF5 writer service
* jfjoch-viewer — desktop viewer and the XDS plugin
* Rugnux — [offline analysis CLI](RUGNUX.md), independent of the acquisition stack
Note that `rugnux` is named without the `jfjoch-` prefix, matching the program and the release
archive.
## Ubuntu based systems
For Ubuntu systems, we also provide the following repositories:
```
sudo curl https://gitea.psi.ch/api/packages/mx/debian/repository.key -o /etc/apt/keyrings/gitea-mx.asc
echo "deb [signed-by=/etc/apt/keyrings/gitea-mx.asc] https://gitea.psi.ch/api/packages/mx/debian $distribution $component" | sudo tee -a /etc/apt/sources.list.d/gitea.list
sudo apt update
```
`$distribution` uses Ubuntu names `jammy` (22.04) and `noble` (24.04). `$component` can be set to either `cuda13` or `nocuda`.
Only slsDetectorPackage 8.0.2 is built for Ubuntu.
The same five packages as above are provided: `jfjoch`, `jfjoch-driver-dkms`, `jfjoch-writer`,
`jfjoch-viewer` and `rugnux`.
Ubuntu packages currently undergo only very limited testing.