From 0929f93b3ea62e84693be65f5aef19801599d7d6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Laurent=20P=C3=A9tr=C3=A9?= <laurent.petre@cern.ch>
Date: Fri, 21 Feb 2025 18:06:40 +0100
Subject: [PATCH] Document all CAEN mainframes used by GEM at P5

---
 docs/expert/infrastructure/p5.md | 20 ++++++++++++++++++++
 docs/setups-description.md       |  4 ++--
 2 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/docs/expert/infrastructure/p5.md b/docs/expert/infrastructure/p5.md
index b82df87..7b6e1b9 100644
--- a/docs/expert/infrastructure/p5.md
+++ b/docs/expert/infrastructure/p5.md
@@ -100,3 +100,23 @@ The notification polices can be changed by opening a [Jira ticket](https://its.c
 ### Fibers
 
 The complete DAQ fiber mapping can be found in [this document](fiber-mapping.txt).
+
+## Mainframes
+
+The CAEN mainframes used to handle the low-voltage and high-voltage systems are
+physically the responsibility of the TC group, while their controlling software
+is the responsibility of the DCS group. Nevertheless, the low-level system
+administration (e.g. networking, operating system maintenance,...) is taken
+care of by the Online Systems group.
+
+Below is a list of the maintained mainframes.
+
+| Hostname         | Location  | DCS Numbering | Comments                         |
+| ---------        | --------- | --------      | ---------                        |
+| `gem-lv-01`      | S4F02     | LV            |                                  |
+| `gem-hv-01`      | S1G12     | HV #01        | GE-1/1 near side (sectors 28-09) |
+| `gem-hv-02`      | S1G12     | HV #02        | GE-1/1 far side (sectors 10-27)  |
+| `gem-hv-03`      | S1F12     | HV #03        | GE+1/1 near side (sectors 28-09) |
+| `gem-hv-04`      | S1F12     | HV #04        | GE+1/1 far side (sectors 10-27)  |
+| `gem-ge21-hv-01` | S1F13     | HV #05        | GE+2/1 near side (sectors 15-05) |
+| `gem-ge21-hv-02` | S1G13     | HV #06        | GE-2/1 near side (sectors 15-05) |
diff --git a/docs/setups-description.md b/docs/setups-description.md
index 72fea24..8b6329d 100644
--- a/docs/setups-description.md
+++ b/docs/setups-description.md
@@ -147,8 +147,8 @@ an exercise left for the reader.
 
 Newer Linux releases (e.g. AlmaLinux 9) disable the old and insecure algorithms
 or protocols by default. While technically a good thing, this newer default
-prevents connecting to older nodes, such as SYx525 CAEN mainframes or non
-patched CTP7. In such cases, you get errors such as:
+prevents connecting to older nodes, such as non updated SYx525 CAEN mainframes
+or non patched CTP7. In such cases, you get errors such as:
 
 * `ssh_dispatch_run_fatal: Connection to ww.xx.yy.zz port 22: error in libcrypto`
 * `Unable to negotiate with ww.xx.yy.zz port 22: no matching host key type found. Their offer: ssh-dss`
-- 
GitLab