Build from Source Code on

Overview

Mon, 17 Feb 2025 00:00:00 +0000

How Should I Read This Chapter

You should be reading this Chapter if you are trying to build OpenNebula from source code or trying to extend the Sunstone functionality.

This Chapter covers what the OpenNebula software dependencies are, how to compile OpenNebula, and how to extend Sunstone functionality.

Hypervisor Compatibility

All sections of this Chapter apply to all hypervisors.

Building from Source Code

Mon, 17 Feb 2025 00:00:00 +0000

This page will show you how to compile and install OpenNebula from the sources.

Warning

Do not forget to check the Building Dependencies for a list of specific software requirements to build OpenNebula.

Note

If you need to build customized OpenNebula packages you can find the source packages for publicly released versions available in the download repositories for easy rebuilds and customizations. If you need to access the packaging tools, please get in touch at <community-manager@opennebula.io>.

Compiling the Software

Follow these simple steps to install the OpenNebula software:

Build Dependencies

Mon, 17 Feb 2025 00:00:00 +0000

This page lists the build dependencies for OpenNebula.

g++ compiler (>= 5.0)
xmlrpc-c development libraries (>= 1.06)
scons build tool (>= 0.98)
sqlite3 development libraries (if compiling with sqlite support) (>= 3.6)
mysql client development libraries (if compiling with mysql support) (>= 5.1, >= 5.6 is recommended for pool search)
libxml2 development libraries (>= 2.7)
libvncserver development libraries (>= 0.9)
openssl development libraries (>= 0.9.8)
ruby interpreter (>= 2.0.0)

Ubuntu 22.04, 24.04

bash-completion
libcurl4-openssl-dev
libmysqlclient-dev
libnode-dev (>= 10)
libnsl-dev
libsqlite3-dev
libssl-dev
libsystemd-dev
libvncserver-dev
libxml2-dev
libxmlrpc-c++8-dev
nodejs (>= 10)
npm
python3
python3-pip
python3-setuptools
rake
scons
unzip
protobuf-compiler-grpc
libgrpc++-dev
libabsl-dev
ruby gem grpc-tools

For Ubuntu 22.04 is recommended a updated version of Node.js:

Sunstone Development

Mon, 17 Feb 2025 00:00:00 +0000

OpenNebula FireEdge server provides a next-generation web-management interface.

Sunstone GUI: <http://<OPENNEBULA-FRONTEND>:2616/fireedge/sunstone> (automatically redirected from <http://<OPENNEBULA-FRONTEND>:2616/)

This second Sunstone incarnation is written in React / Redux and Material-UI is used for the styles and layout of the web.

If you want to do development work over Sunstone, you need to install OpenNebula from source. For this, you will need build dependencies, git, nodeJS v12 and npm v6.

Once the environment has been prepared, you need to clone one repository and follow the steps to compile the OpenNebula software.

Cloud Servers Authentication

Mon, 17 Feb 2025 00:00:00 +0000

When a user interacts with Sunstone, the server authenticates the request and then forwards the requested operation to the OpenNebula daemon.

The forwarded requests between the server and the core daemon include the original user name and are signed with the credentials of a special server user.

In the current guide this request forwarding mechanism is explained, and how it is secured with a symmetric-key algorithm is also detailed.