M #-: 6.10 minione onprem guide (#3032)

Signed-off-by: Pedro Ielpi <pielpi@opennebula.io>

source/installation_and_configuration/automatic_deployment/index.rst

@@ -8,5 +8,5 @@ Automatic Deployment
   :maxdepth: 2
 
   Overview <one_deploy_overview>
-  Cloud Deployment with Local Storage <one_deploy_tutorial_local_ds>
-  Cloud Deployment with Shared Storage <one_deploy_tutorial_shared_ds>
+  Cloud Deployment - Local Storage <one_deploy_tutorial_local_ds>
+  Cloud Deployment - Shared Storage <one_deploy_tutorial_shared_ds>

source/quick_start/deployment_basics/index.rst

@@ -8,6 +8,7 @@ Deployment Basics
    :maxdepth: 2
 
    Overview <overview>
+   Try OpenNebula Front-end On-prem <try_opennebula_onprem>
    Try OpenNebula Front-end on AWS <try_opennebula_on_kvm>
    Try OpenNebula Front-end on VMware <try_opennebula_on_vmware>
    Try OpenNebula Hosted Front-end <try_opennebula_hosted>

source/quick_start/deployment_basics/try_opennebula_on_kvm.rst

@@ -224,7 +224,7 @@ This is the default view for cloud administrators. From this view in Sunstone, y
 
 |
 
-Congratulations --- you have deployed an OpenNebula Front-end node, which is ready to provision resources on cloud infrastructure. 
+Congratulations — you have deployed an OpenNebula Front-end node, which is ready to provision resources on cloud infrastructure. 
 
 
 Next Steps

source/quick_start/deployment_basics/try_opennebula_onprem.rst

@@ -0,0 +1,162 @@
+.. _try_opennebula_onprem:
+
+==========================================
+Deploy an OpenNebula Front-end On-premises
+==========================================
+
+In this tutorial, we’ll install an OpenNebula Front-end in under ten minutes, using **miniONE**, the installation script provided by OpenNebula.
+
+This simple installation includes a single OpenNebula Front-end without any hypervisor nodes. You can perform the installation on any physical or virtual server that meets the system :ref:`requirements <minione_reqs>`. Later, you can use this Front-end to provision resources on cloud providers, for example as described in :ref:`Provisioning an Edge Cluster <first_edge_cluster>`.
+
+.. We’ll install the Front-end on a bare-metal host on-premises. You can later use this Front-end to provision resources on cloud providers, for example an :ref:`Edge Cluster on AWS <first_edge_cluster>`.
+
+**miniONE** is a simple Bash script. It automatically downloads, installs and configures an OpenNebula Front-end and all necessary components to manage and run virtual machines.
+
+To install an OpenNebula Front-end using miniONE, we’ll need to complete the following high-level steps:
+
+   #. Ensure that the host server meets the installation requirements.
+   #. Download and run the miniONE script.
+   #. Verify the installation.
+
+The cloud environment installed by miniONE is mainly intended for evaluation, development and testing. However, it can also serve as a base for larger short-lived deployments.
+
+.. important::
+
+   In this tutorial, we will install a Front-end only, without a KVM hypervisor. While the miniONE script offers the option to install both a Front-end and a KVM hypervisor on the same server, that configuration does not allow you to provision remote resources, and is not covered in this tutorial.
+
+.. .. important::
+
+..   In this tutorial, we will install a Front-end only, without a KVM hypervisor. While miniONE offers the option to install both a Front-end and a KVM hypervisor on the same host, this configuration uses a private IP address for communicating with Virtual Machines, so it is not suitable for provisioning remote resources.
+
+.. _minione_reqs:
+
+Step 1: Ensure System Requirements
+==================================
+
+To run the miniONE script, you will need a physical or virtual server with a fresh installation of a supported operating system, with the latest software updates and without any customizations.
+
+**Supported operating systems:**
+   - RHEL/AlmaLinux 8 or 9
+   - Debian 11 or 12
+   - Ubuntu 22.04 or 24.04
+
+**Minimum hardware:**
+   - 4 GiB RAM
+   - 80 GiB free disk space
+
+**Configuration:**
+   - Access to the privileged user (root) account
+   - A public IP address
+   - An SSH server running on port 22
+   - Open ports:
+      - 22 (SSH)
+      - 80 (for the Ruby Sunstone GUI)
+      - 2616 (for the FireEdge GUI)
+      - 5030 (for the OneGate service)
+
+Note that the server needs an internet connection to download software packages during installation.
+
+Step 2: Download and Install miniONE
+====================================
+
+To download miniONE, please fill `the required form <https://opennebula.io/get-minione/>`__.
+
+After downloading, open a terminal and use the ``sudo`` to become the ``root`` user. For example, run:
+
+.. prompt::
+
+   sudo -i
+
+Go to the folder where you downloaded the miniONE script, by using the ``cd`` command:
+
+.. prompt::
+
+   cd <path/to/folder>
+
+Next, ensure that the ``minione`` file has execute permissions, by running:
+
+.. prompt::
+
+   chmod +x minione
+
+To install miniONE, run:
+
+.. prompt::
+
+   bash minione --frontend
+
+The miniONE script will begin the installation, logging output to the terminal. Installation usually takes between one and two minutes. When it’s finished, miniONE shows a report with connection parameters and login credentials:
+
+.. prompt::
+
+   ### Report
+   OpenNebula 6.8 was installed
+   Sunstone is running on:
+   http://<omitted>/
+   FireEdge is running on:
+   http://<omitted>:2616/
+   Use following to login:
+      user: oneadmin
+      password: lCmPUb5Gwk
+
+At this point, you have successfully installed miniONE. OpenNebula services should be running, and the system should be ready for your first login.
+
+.. important::
+
+   In this configuration, the Ruby and FireEdge Sunstone endpoints, and the OneGate endpoint expose HTTP on a public network interface. miniONE is an evaluation tool, and this configuration should not be used in production environments.
+
+Step 3: Verify the Installation
+===============================
+
+We will verify the installation by logging in to OpenNebula’s FireEdge Sunstone GUI.
+
+Point your browser to the FireEdge IP and port provided by the miniONE output shown above, i.e. ``http://<public IP>:2616``. (Alternatively, if you installed locally you can go to ``http://localhost:2616``.) You should be greeted with the Sunstone login screen:
+
+.. image:: /images/sunstone-login.png
+   :align: center
+   :scale: 50%
+
+|
+
+In the **Username** input field, type ``oneadmin``. For **Password**, enter the password provided by miniONE at the end of the report (in this example, ``lCmPUb5Gwk``) then press ``Enter`` or click **SIGN IN**.
+
+The screen should display the Sunstone Dashboard:
+
+.. image:: /images/sunstone-dashboard.png
+   :align: center
+
+|
+
+This is the default view for cloud administrators. From this view in Sunstone, you have complete control over your OpenNebula infrastructure. (The :ref:`Cloud View <fireedge_cloud_view>` interface is much simpler, intended for end users.) To explore what you can do in the GUI, open the left-hand panel by clicking on the hamburger icon on the top left:
+
+.. image:: /images/sunstone-dashboard_hamb_menu.png
+   :align: center
+   :scale: 50%
+
+|
+
+Congratulations — you have deployed an OpenNebula Front-end node, which is ready to provision resources on cloud infrastructure.
+
+Additional Installation Options
+===============================
+
+The miniONE script offers several options for installation, which you can check by passing the ``-h`` flag, e.g.:
+
+.. prompt::
+
+   bash minione -h
+
+Options include setting parameters for the virtual network, passwords for new VMs, and others.
+
+.. tip::
+
+   If you run miniONE without any options, it will install an OpenNebula Front-end and a KVM hypervisor node on the local machine. With this configuration you will be able to deploy VMs to the local machine, but you will not be able to provision remote resources, since this type of installation uses a private IP address for communicating with VMs.
+
+Next Steps
+==========
+
+The :ref:`Operations Guide <operation_basics>` allows you to quickly and easily provision your cloud, by adding a remote Edge Cluster on AWS.
+
+.. |images-sunstone-dashboard| image:: /images/sunstone-dashboard.png
+.. |images-sunstone-change-view| image:: /images/sunstone-change-view.png
+