leonarski_f
dd67cffde6
The changelog section had grown to 22 entries written from the commits
rather than for a user. Collapsed to 13, each saying what is gained
before what changed, with related work merged - the six anisotropy
entries into one, five space-group entries into two, five
integration-radius entries into one - and four things added that had no
entry at all: the packaging split, the statically linked cuFFT, the Ceres
back-end drop and REPORT_VERSION reaching 3.
CPU_DATA_ANALYSIS gains 9.5, the adaptive integration radius: the r80
measurement, the clamp, the constant-ring-area r3, the convergence test,
why it applies to the final pass only and the density fallback. Three
passages there had gone stale against the code: 13.1 still described the
I/sigma quantile fallback that b90fcfb98 deleted, and 13.5 said the gate
tests delta_B when it tests delta_B_linear and that the high-symmetry
caution fires wherever the Laue class leaves one free direction, which
0da593b32 narrowed.
RUGNUX gains an Installation section - there was no page anywhere saying
where rugnux comes from - a synopsis, a worked first run naming the files
that actually appear and the report keys to grep, and sections on the
unmerged export and on diffraction anisotropy. Its report section list
was one section behind: anisotropy is 9, warnings is 10.
The packaging change reached further than the changelog implied, so the
pages describing what a release ships were corrected too: the viewer
tarball no longer carries rugnux or the two developer utilities, the
Linux archives link cuFFT statically rather than shipping it beside the
binary under an $ORIGIN rpath, the aarch64 archive has a higher glibc
floor than the RHEL 8 ones and is untested on hardware, the archives
unpack with no top-level directory, and the notices live per package
under share/doc/jfjoch_<component>. The RHEL 9.5 vm_flags workaround in
FPGA_PCIE_DRIVER is obsolete and now says so.
59 lines
3.4 KiB
Markdown
59 lines
3.4 KiB
Markdown
# Linux package repositories
|
|
For convenience, we are providing package repositories. With versions including and excluding CUDA linking.
|
|
We recommend to install Jungfraujoch viewer from `nocuda` repository and remaining packages from `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. Up to 1.0.0-rc.163 it was part of `jfjoch-viewer`; the package declares that move, so
|
|
installing it upgrades an older viewer rather than colliding with it.
|
|
|
|
## 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 `cuda13` and `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`. Up to 1.0.0-rc.160 the first of them was misnamed `jfjoch-jfjoch`; the current
|
|
package replaces it, so `apt upgrade` handles the rename.
|
|
|
|
Ubuntu packages are currently only going through a very limited testing.
|