From f2db5c30eefa2a315d126e5bfdf336c750702e51 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Laurent=20P=C3=A9tr=C3=A9?= <laurent.petre@cern.ch>
Date: Mon, 5 Sep 2022 18:50:34 +0200
Subject: [PATCH] Update p5 infrastructure
---
docs/expert/index.md | 13 ++++++-------
docs/expert/infrastructure/p5.md | 30 +++++++++++++++++++-----------
mkdocs.yml | 1 +
3 files changed, 26 insertions(+), 18 deletions(-)
diff --git a/docs/expert/index.md b/docs/expert/index.md
index 101914e..930f784 100644
--- a/docs/expert/index.md
+++ b/docs/expert/index.md
@@ -1,9 +1,8 @@
# Expert guide
-This site complements the :std`userguide:index`{.interpreted-text
-role="doc"}, and is intended to serve as a reference for the GEM DAQ
-on-call experts, teststand responsibles, and admins of remote
-teststands. It contains useful information on setting up a teststand
-from scratch, debugging software and hardware issues, and generally more
-detailed information than is necessary for operating the GEM DAQ system
-(hardware, firmware, and software).
+This site complements the user guides , and is intended to serve as a reference
+for the GEM DAQ on-call experts, teststand responsibles, and admins of remote
+teststands. It contains useful information on setting up a teststand from
+scratch, debugging software and hardware issues, and generally more detailed
+information than is necessary for operating the GEM DAQ system (hardware,
+firmware, and software).
diff --git a/docs/expert/infrastructure/p5.md b/docs/expert/infrastructure/p5.md
index 9a14ab5..b70b492 100644
--- a/docs/expert/infrastructure/p5.md
+++ b/docs/expert/infrastructure/p5.md
@@ -17,25 +17,27 @@ To open a ticket you must be a member of the appropriate e-group and then use th
GEM machines:
-| Hostname | Machine alias | Notes |
-|-------------------------|----------------|------------------------------------------|
-| `srv-s2g18-33-01` | `gem-daq01` | Data taking applications, PowerEdge R340 |
-| `srv-s2g18-31-01` | `gem-daq02` | DAQ services, PowerEdge R340 |
-| `srv-s2g18-34-01` | `gem-locdaq01` | Local DAQ readout, PowerEdge R440 |
-| `srv-s2g18-32-01` | `gem-locdaq02` | Analysis suite, PowerEdge R440 |
-| `kvm-s3562-1-ip151-107` | `gemvm-legacy` | Legacy software installation, VM |
-| `kvm-s3562-1-ip151-74` | `gemvm-test` | VM |
+| Hostname | Machine alias | Notes |
+|-------------------------|-----------------|------------------------------------------|
+| `srv-s2g18-33-01` | `gem-daq01` | Data taking applications, PowerEdge R340 |
+| `srv-s2g18-31-01` | `gem-daq02` | DAQ services, PowerEdge R340 |
+| `srv-s2g18-34-01` | `gem-locdaq01` | Local readout, PowerEdge R440 |
+| `srv-s2g18-32-01` | `gem-locdaq02` | Analysis suite, PowerEdge R440 |
+| `kvm-s3562-1-ip151-107` | `gemvm-control` | GEM DAQ head node, VM |
+| `kvm-s3562-1-ip151-74` | `gemvm-test` | Test machine[^1], VM |
+
+[^1]: Typically unmanaged services, such as the GE2/1 detector safety system
Machines used by GEM:
| Hostname | Machine alias | Notes |
|-------------------------|-----------------------------|-------------------------------------------|
-| `ctrl-s2c17-22-01` | `ctrlhub-gem-01`[^1] | `sysmgr` and `control_hub` host |
+| `ctrl-s2c17-22-01` | `ctrlhub-gem-01`[^2] | `sysmgr` and `control_hub` host |
| `kvm-s3562-1-ip151-110` | `cmsrc-gem`, `gemrc-gemdev` | `RCMS` host (i.e., function managers) |
| `bu-c2f13-16-01` | | DAQ2 BU (access to the Lustre filesystem) |
| `fu-c2f11-23-03` | | MiniDAQ DQM |
-[^1]: Additional aliases: `bridge-s2e01-04`, `bridge-s2e01-14`, `bridge-s2e01-23`
+[^2]: Additional aliases: `bridge-s2e01-04`, `bridge-s2e01-14`, `bridge-s2e01-23`
### Remote powering
@@ -59,7 +61,7 @@ link](https://twiki.cern.ch/twiki/bin/view/CMS/ClusterUsersGuide#How_to_use_the_
### Monitoring (icinga)
-Monitoring of central infrastructure is provided via `icinga` ([GPN](http://cmsicinga2.cern.ch/icinga-web/)) or ([P5](http://cmsicinga2.cms/icinga-web/)).
+Monitoring of central infrastructure is provided via `icinga`: <http://cmsicinga2.cms/icingaweb2>
SMS notifications are sent to a list of CERN mobile numbers, the DAQ expert phone is one.
Email notifications are sent to the members of the `cms-gem-online-notifications` e-group via the `cms-gem-daq-notifications` email address.
The notification polices can be changed by opening a [Jira ticket](https://its.cern.ch/jira/projects/CMSONS), using any configuration defined in [this documentation](https://docs.icinga.com/latest/en/notifications.html).
@@ -78,6 +80,12 @@ The notification polices can be changed by opening a [Jira ticket](https://its.c
| `psu-s2e01-05-01` | GE2/1 Aspiro PSU |
| `mch-s2e01-04-01` | GE2/1 demonstrator µTCA crate - FED1469 (GEMPILOT) |
+#### S2E02
+
+| Device | Notes |
+|----------------------|-------------------------------|
+| `sw-eth-s2e02-15-01` | Local readout Ethernet switch |
+
### Fibers
The complete DAQ fiber mapping can be found in [this document](fiber-mapping.txt).
diff --git a/mkdocs.yml b/mkdocs.yml
index b80ba17..eecb7dc 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -8,6 +8,7 @@ edit_uri: edit/main/docs/
theme:
name: material
features:
+ - navigation.indexes
- navigation.sections
- navigation.tabs
- navigation.top
--
GitLab