fix(bare-metal): rename RV1 page and document kernel update options (#…

…3455)
scaleway · Jul 15, 2024 · 380f45e · 380f45e
1 parent 6398ed7
commit 380f45e
Show file tree

Hide file tree

Showing 2 changed files with 24 additions and 7 deletions.
diff --git a/...elastic-metal-understanding-rv1-usage.mdx → ...-content/elastic-metal-rv1-guidelines.mdx b/...elastic-metal-understanding-rv1-usage.mdx → ...-content/elastic-metal-rv1-guidelines.mdx
@@ -1,10 +1,10 @@
 ---
 meta:
-  title: Understanding Elastic Metal RV1 usage
-  description: This page provides more information and advanced ways for using EM-RV1 servers.
+  title: Elastic Metal RV1 guidelines
+  description: This page provides guidelines to use your EM-RV1 server.
 content:
-  h1: Understanding Elastic Metal RV1 usage
-  paragraph: This page provides more information and advanced ways for using EM-RV1 servers.
+  h1: Elastic Metal RV1 guidelines
+  paragraph: This page provides guidelines to use your EM-RV1 server.
 tags: elastic-metal server riscv em-rv1
 dates:
   validation: 2024-03-15
@@ -116,5 +116,22 @@ custom upgrade channel. Follow the steps below to update your kernel:
     ```bash
     sudo rv1 update-kernel
     ```
+
+    <Message type="note">
+    If you prefer to run a more recent Linux kernel instead of the
+    vendor-provided kernel, you can append the `--tree mainline` option.
+
+    Although we do not recommend it, you can also enable support for vector
+    instructions with the `--enable-vector` flag. Be aware that this feature
+    implements an unratified version of RISC-V vector instructions (RVV 0.7.1)
+    which requires specific development efforts.
+
+    For a comprehensive list of options, refer to `rv1 update-kernel --help`.
+    </Message>
 4. Wait for the update to complete. This step can take a few minutes.
 5. Reboot the server in normal mode.
+
+<Message type="note">
+If you are updating from kernel version `5.10.113-scw0` or lower, note that
+newer kernels disable vector instructions by default. Refer to the process above if you still wish to keep them enabled.
+</Message>
diff --git a/menu/navigation.json b/menu/navigation.json
@@ -819,8 +819,8 @@
                     "slug": "elastic-metal-stock-levels"
                   },
                   {
-                    "label": "Understanding Elastic Metal RV1 usage",
-                    "slug": "elastic-metal-understanding-rv1-usage"
+                    "label": "Elastic Metal RV1 guidelines",
+                    "slug": "elastic-metal-rv1-guidelines"
                   }
                 ],
                 "label": "Additional Content",
@@ -4889,4 +4889,4 @@
     ],
     "label": "Additional Services"
   }
-]
+]