M #-: Add info on miniONE and Deploying on K8s guides (#3037)

Signed-off-by: Pedro Ielpi <[email protected]>
OpenNebula · Sep 2, 2024 · 922e849 · 922e849
1 parent 2c2cabe
commit 922e849
Show file tree

Hide file tree

Showing 11 changed files with 187 additions and 47 deletions.
diff --git a/source/images/aws_cluster_images_datastore.png b/source/images/aws_cluster_images_datastore.png
diff --git a/source/images/minione-aws-ubuntu24.04.png b/source/images/minione-aws-ubuntu24.04.png
diff --git a/source/images/sunstone-aws_cluster_download_oneke.png b/source/images/sunstone-aws_cluster_download_oneke.png
diff --git a/source/images/sunstone-aws_cluster_replica_host.png b/source/images/sunstone-aws_cluster_replica_host.png
diff --git a/source/images/sunstone-aws_edge_cluster_deploying.png b/source/images/sunstone-aws_edge_cluster_deploying.png
diff --git a/source/images/sunstone-aws_edge_cluster_sys_ds.png b/source/images/sunstone-aws_edge_cluster_sys_ds.png
diff --git a/source/images/sunstone-aws_k8s_vms_list.png b/source/images/sunstone-aws_k8s_vms_list.png
diff --git a/source/images/sunstone-aws_kubernetes_vnf_ip.png b/source/images/sunstone-aws_kubernetes_vnf_ip.png
diff --git a/source/images/sunstone_kubernetes_netw_dropdowns.png b/source/images/sunstone_kubernetes_netw_dropdowns.png
diff --git a/source/quick_start/deployment_basics/try_opennebula_on_kvm.rst b/source/quick_start/deployment_basics/try_opennebula_on_kvm.rst
@@ -61,15 +61,15 @@ To run the miniONE script on AWS, you will need to instantiate a virtual machine
       - 2616 (for the FireEdge GUI)
       - 5030 (for the OneGate service)
 
-.. tip:: To quickly deploy a suitable VM, browse the AWS AMI Catalog and select ``Ubuntu Server 22.04 LTS (HVM), SSD Volume Type``:
+.. tip:: To quickly deploy a suitable VM, browse the AWS AMI Catalog and select **Ubuntu Server 24.04 LTS (HVM), SSD Volume Type**:
 
-   .. image:: /images/minione-aws-ubuntu22.04.png
+   .. image:: /images/minione-aws-ubuntu24.04.png
       :align: center
 
 Below is an example of a successfully-tested configuration (though by no means the only possible one):
 
 - Region: Frankfurt
-- Operating System: Ubuntu Server 22.04 LTS (HVM)
+- Operating System: Ubuntu Server 24.04 LTS (HVM)
 - Tier: ``t2.medium``
 - Open ports: 22, 80, 2616, 5030
 - Storage: 80 GB SSD
@@ -120,14 +120,43 @@ Once you have logged in to the VM as user ``ubuntu``, use the ``sudo`` command t
 
 .. prompt::
 
-    sudo su -
+    sudo -i
 
 Then, update the system to its latest software packages by running the following command:
 
 .. prompt::
 
    apt update && apt upgrade
 
+After updating, you will probably need to restart the VM to run the latest kernel. Check the output of the ``apt upgrade`` command for lines similar to the following:
+
+.. prompt::
+
+   Pending kernel upgrade!
+   Running kernel version:
+     6.8.0-1012-aws
+   Diagnostics:
+     The currently running kernel version is not the expected kernel version 6.8.0-1014-aws.
+
+In this example, you need to restart the VM in order to upgrade to kernel 6.8.0-1014-aws. To restart the VM, run:
+
+.. prompt::
+
+   shutdown -r now
+
+You will be immediately logged out of the VM as it restarts. Wait a few moments for the VM to finish rebooting, then log in again using the same procedure as before. After logging back into the VM, you can check the running kernel version with:
+
+.. prompt::
+
+   uname -a
+
+For example, in this case:
+
+.. prompt::
+
+   $ uname -a
+   Linux ip-172-31-3-252 6.8.0-1014-aws #15-Ubuntu SMP Thu Aug  8 19:13:06 UTC 2024 x86_64 x86_64 x86_64 GNU/Linux
+
 Your AWS VM is now ready. In the next steps, we’ll download the miniONE script, upload it to the VM, and run the installation.
 
 Step 3: Download and install miniONE
@@ -162,11 +191,25 @@ Step 3.2. Run the miniONE script on the AWS VM
 
 After copying the miniONE script to the VM, log in to the VM (as described :ref:`above <minione_log_in_to_ec2>`).
 
-Use the ``sudo`` command to become the ``root`` user.
+Use the ``sudo`` command to become the ``root`` user:
+
+.. prompt::
+
+   sudo -i
+
+If necessary, use the ``cd`` command to navigate to the folder where you copied the miniONE script. For example, if you copied it to the home directory of user ``ubuntu`` run:
+
+.. prompt::
+
+   cd ~ubuntu
+
+Next, ensure that the ``minione`` file has execute permissions, by running:
+
+.. prompt::
 
-If necessary, use the ``cd`` command to navigate to the folder where you copied the miniONE script. For example, if you copied it to the home directory of user ``ubuntu`` run ``cd ~ubuntu``.
+   chmod +x minione
 
-To install miniONE, run:
+To install miniONE, run as root:
 
 .. prompt::
 

diff --git a/source/quick_start/usage_basics/running_kubernetes_clusters.rst b/source/quick_start/usage_basics/running_kubernetes_clusters.rst