edhctl mirror
edhctl mirror lets you check and repair resource mirroring: the copy of third-party installation files (DCV, EFA, OpenMPI, GPU drivers, and more) that EDH stores in your S3 bucket so nodes do not download them from the internet.
Run these commands as root on the EDH controller:
source /etc/environment
EDHCTL="/opt/edh/$EDH_CLUSTER_ID/cluster_manager/edhctl"
status¶
Shows the outcome of the most recent mirror run.
$EDHCTL mirror status [--output text|json|yaml]
keys¶
Checks every file EDH manages through the mirror, and shows where nodes download it from today:
- mirrored: nodes download the file from your S3 bucket.
- upstream-only: nodes still download the file from its original website, because mirroring did not succeed for this file (or is disabled).
- absent: the setting is missing. This can only happen on environments installed with an older EDH version.
$EDHCTL mirror keys [--degraded-only] [--output text|json|yaml]
| Option | Description |
|---|---|
--degraded-only |
Only show files that are not served from your S3 bucket. |
--output |
Output format: text (default), json or yaml. |
recover¶
Copies files to your S3 bucket again, without reinstalling EDH. Files already copied and verified are skipped, so you can run it as often as you need.
$EDHCTL mirror recover [-k <config key>] [--failure-mode soft|hard] [--dry-run] [--no-wait] [--force] [--output text|json|yaml]
| Option | Description |
|---|---|
-k, --key |
The setting of the file to copy again, for example /system/openmpi/url. Repeat it for several files. Leave it out to copy every file again. |
--failure-mode |
soft or hard. Overrides your environment's setting for this run only. |
--dry-run |
Show which files would be copied, without starting anything. |
--no-wait |
Start the copy and return immediately. Check the result later with edhctl mirror status. |
--force |
Skip the confirmation prompt. |
--output |
Output format: text (default), json or yaml. |
Example:
# See which files are not mirrored, then repair them
$EDHCTL mirror keys --degraded-only
$EDHCTL mirror recover