Easy to use deployment tool for an OpenNebula KVM evaluation environment
Clone or download
Latest commit b8bc290 Jan 23, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
screenshots MiniOne document quickstart (from one-sandbox) Jan 15, 2019
LICENSE Initial commit Nov 28, 2018
README.md MiniOne document quickstart (from one-sandbox) Jan 15, 2019
minione F #7 Support LXD deployment Jan 23, 2019

README.md

MiniONE

MiniONE is an easy to use deployment tool for the OpenNebula KVM evaluation environment. All necessary components to manage and (locally) run the virtual machines are installed and configured on your dedicated physical host with just a single command run.

Requirements

  • dedicated physical host supporting hardware virtualization
  • min. 2 GiB RAM
  • min. 20 GiB free space on disk
  • operating system CentOS 7, Ubuntu 16.04, Ubuntu 18.04, Ubuntu 18.10 or Debian 9
  • fresh default install of the operating system with the latest updates
  • privileged user access (root)

Quickstart

Download the latest release of the minione script, run it and follow the instructions from the terminal:

sudo bash minione

If the deployment ends succesfully, you now have your OpenNebula all-in-one evaluation environment ready to use! On the terminal, you'll see a deployment report with login information.

Deployment Steps

  • enable OpenNebula repository
  • install OpenNebula frontend and KVM hypervisor
  • prepare networking for virt. machines (bridge minionebr)
  • configure firewall to provide NAT for virt. machines
  • run private DNS server for virt. machines (dnsmasq)
  • start OpenNebula and prepare user, virt. networks, datastores
  • import CentOS 7 virtual machine appliance

Advanced Deployment

The evaluation deployment tool comes with default parameters suitable for most cases. You can list all the deployment parameters by running:

sudo bash minione --help

Examples

Start a verbose deployment and set own password for the default OpenNebula user:

sudo bash minione --verbose --password MySecretPassword

Specify OpenNebula virtual private network IP range for new deployment:

sudo bash minione --vnet-address 192.168.100.0 --vnet-gateway 192.168.100.1 --vnet-ar-ip-start 192.168.100.2

Try Out

Try the Admin View in the Sunstone GUI

After the minione finishes, the first thing we are going to do is to log in as oneadmin to take a look at the Admin View of Sunstone, which has more options than the other Sunstone views for a regular users.

To login to Sunstone open your browser at http://[ ip ]:9869. You should receive the login information from the minione report.

Take a look at all the already bootstrapped resources in the Sandbox.

dashboard

Try the Cloud View

With the Admin View you can do anything in OpenNebula, but you don’t want all those options for the final users! Switch to the Cloud View to see how a final user will see OpenNebula:

switch_to_cloud_view.png

The Cloud View interface is much simpler and targeted at end users.

Create a new Virtual Machine by clicking the + button. Select the only available template and click Create.

After clicking create you will be taken to the dashboard where you can see your running VMs.

vm_list

You can click on your VM and manage it: access it through VNC, Save its state, Reboot it, etc:

vm_info

Clicking on the Console icon will let you login into the VM. The default credentials are:

Login: root Password: opennebula

With the oneadmin role you can customize what your cloud users can do and see.

Quick Overview of the CLI Interface

You need to connect to the sever either using the web console or using ssh. OpenNebula runs as the oneadmin user, and the main administrator should run commands as that user, therefore the first thing you need to do is to switch to oneadmin:

su - oneadmin

From the oneadmin account you can see all the already bootstrapped resources:

onehost list

There is one network created

$ onevnet list

You can see the leases and the specific configuration of the network

$ onevnet show 0

A Centos image has been created

$ oneimage list

A Virtual Machine template is registered

$ onetemplate list

You can see the template configuration if further detail

$ onetemplate show 0

Further Exploration

This is just a quick overview to get you started with OpenNebula. If you liked it, you may want to check the OpenNebula documentation for more information on how to deploy OpenNebula in your infrastructure and a detailed version of the OpenNebula features.

Troubleshooting

Logs are located in /var/log/one. Be sure to check that in order to troubleshoot. If you need assistance, head out to our forum.

License

Copyright 2002-2019, OpenNebula Project, OpenNebula Systems (formerly C12G Labs)

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.