Skip to content

Commit

Permalink
update docs
Browse files Browse the repository at this point in the history
  • Loading branch information
Manuel Sopena Ballesteros committed Jun 16, 2024
1 parent cac64c8 commit 955aa16
Show file tree
Hide file tree
Showing 2 changed files with 100 additions and 3 deletions.
101 changes: 100 additions & 1 deletion docs/basics.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@ Manta commands have a nomal and a short version

## List configurations

A configuration is a list of layers, each being a git repository containing ansible playbooks, these playbooks will run in order to create an image or to configure nodes during runtime.

List/filter the configurations in the system

Normal version
Expand Down Expand Up @@ -64,8 +66,93 @@ manta g c -H zinal -l 2`
+--------------------------------------------------------------+----------------------+----------------------------------------------------+
```

If manta realise only one configuration is returned, then it will fetch extra information for each configuration layers, the example below will fetch the details of all configuration layers related to the most recent configuration created across all clusters I have access.

```bash
manta g c -m`
+--------------------------------------------+----------------------+----------------------------------------------------+--------------------------------------------------------+
| Configuration Name | Last updated | Layers | Derivatives |
+=================================================================================================================================================================================+
| eiger-mc-compute-config-cscs-24.3.0.r1-0.1 | 2024-06-14T17:29:38Z | Name: csm-packages-1.5.0 | CFS sessions: |
| | | Branch: cray/csm/1.16.26 | - batcher-3e4e38eb-db3c-45b3-bc00-992ffe4a7792 |
| | | Tag: | - batcher-b5329f53-8121-49ab-b7dd-7de7f17bf4bb |
| | | Date: 2024-03-22T10:54:39Z | |
| | | Author: crayvcs - cf-gitea-import | BOS sessiontemplates: |
| | | Commit: 6423c550ea38a3b6befc4867ea7319157b48c554 | - eiger-mc-compute-template-cscs-24.3.0.r1-0.1.x86_64 |
| | | Playbook: csm_packages.yml | |
| | | | IMS images: |
| | | Name: shs-cassini_install-cscs-24.3.0 | - eiger-mc-compute-cscs-24.3.0.r1-0.1 |
| | | Branch: cscs-24.3.0cscs-24.5.0 | |
| | | Tag: | |
| | | Date: 2024-05-03T10:24:28+02:00 | |
| | | Author: Riccardo Di Maria | |
| | | Commit: 4dead2f7ebd1080d6a65d4b374618cf727624215 | |
| | | Playbook: shs_cassini_install.yml | |
| | | | |
| | | Name: cos-compute-cscs-24.3.0 | |
| | | Branch: cscs-24.3.0 | |
| | | Tag: | |
| | | Date: 2024-06-14T15:44:11+02:00 | |
| | | Author: Gennaro Oliva | |
| | | Commit: f8247821fa3c220159f31694cc995f24e07bb8f1 | |
| | | Playbook: cos-compute.yml | |
| | | | |
| | | Name: csm-diags-compute-1.5.26 | |
| | | Branch: cray/csm-diags/1.5.26 | |
| | | Tag: | |
| | | Date: 2024-03-22T17:11:47Z | |
| | | Author: crayvcs - cf-gitea-import | |
| | | Commit: 3b59bd64682b8e55c7f49c6317442b48cea6bb53 | |
| | | Playbook: csm-diags-compute.yml | |
| | | | |
| | | Name: sma-ldms-compute-1.9.14 | |
| | | Branch: cray/sma/1.9.14 | |
| | | Tag: | |
| | | Date: 2024-03-22T16:24:29Z | |
| | | Author: crayvcs - cf-gitea-import | |
| | | Commit: 09b922e6a608f273dd28dfbc9eaf089b355a56b8 | |
| | | Playbook: sma-ldms-compute.yml | |
| | | | |
| | | Name: cscs | |
| | | Branch: cscs-24.3.0 | |
| | | Tag: | |
| | | Date: 2024-06-14T19:26:31+02:00 | |
| | | Author: Gennaro Oliva | |
| | | Commit: a58fc02eb298cd2b472c616d2ef641ee2c456181 | |
| | | Playbook: site.yml | |
| | | | |
| | | Name: cpe-pe_deploy-cscs-24.3.0 | |
| | | Branch: cscs-24.5.0 | |
| | | Tag: | |
| | | Date: 2024-06-14T13:51:32+02:00 | |
| | | Author: Gennaro Oliva | |
| | | Commit: f9105c8172af7521910e849d274c91103bfbde75 | |
| | | Playbook: site-cscs.yml | |
| | | | |
| | | Name: slurm-site-cscs-24.3.0 | |
| | | Branch: cscs-24.3.0 | |
| | | Tag: | |
| | | Date: 2024-06-05T15:58:19+02:00 | |
| | | Author: Gennaro Oliva | |
| | | Commit: e75324a1a35f20fda131fded61a486025fce6d41 | |
| | | Playbook: site-cscs.yml | |
| | | | |
| | | Name: cos-compute-last-cscs-24.3.0 | |
| | | Branch: | |
| | | Tag: | |
| | | Date: 2024-06-04T18:31:44+02:00 | |
| | | Author: Chris Gamboni | |
| | | Commit: 6bf3f82608686da8dbf857656f1e37c4c84054d1 | |
| | | Playbook: cos-compute-last.yml | |
+--------------------------------------------+----------------------+----------------------------------------------------+--------------------------------------------------------+
```

> Note: manta will try to resolve the `git tag` related to each `configuration layer`

## List sessions

A session is an instance of a configuration to create an image or configure a compute node. When a session is created, user would expect to have an image ready to boot compute nodes or configure nodes during runtime.

## List images

## List cluster details/summary
Expand All @@ -74,11 +161,23 @@ manta g c -H zinal -l 2`

## Set runtime configuration

??? info "**WIP**"
This is work in progress

## Set boot image

??? info "**WIP**"
This is work in progress

???+ warning "**Highly discourage**"
only do this if sessions in the system has been deleted
Use this command only if `manta set boot-configuration` fails because it can't find the sessions linking the configuration with the image (meaning information in the system has been deleted)
## Set boot configuration
??? info "**WIP**"
This is work in progress
## Set kernel parameters
??? info "**WIP**"
This is work in progress
2 changes: 0 additions & 2 deletions docs/configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,5 +108,3 @@ HSM available: ["adula", "alps", "burst", "burst_gh", "burst_mc", "eiger", "fora
Current HSM:
Parent HSM: nodes_free
```

0 comments on commit 955aa16

Please sign in to comment.