NAME
ncm-opennebula: Configuration module for OpenNebula
DESCRIPTION
Configuration module for OpenNebula.
IMPLEMENTED FEATURES
Features that are implemented at this moment:
- oned service configuration
- Sunstone service configuration
- Adding/removing VNETs
- Adding/removing datastores (only Ceph and shared datastores for the moment)
- Adding/removing hypervirsors
- Adding/removing OpenNebula regular users
- Updates OpenNebula *_auth files
- Updates VMM kvmrc config file
OpenNebula installation is 100% automated. Therefore:
- All the new OpenNebula templates created by the component will include a QUATTOR flag
- The component only will modify/remove resources with the QUATTOR flag set, otherwise the resource is ignored
- If the component finds any issue during hypervisor host configuration then the node is included within OpenNebula infrastructure but as disabled host
INITIAL CREATION
- The schema details are annotated in the schema file.
- Example pan files are included in the examples folder and also in the test folders.
To set up the initial cluster, some steps should be taken:
-
- First install the required Ruby gems in your OpenNebula server. You can use OpenNebula installgems addon : https://github.com/OpenNebula/addon-installgems
-
- The OpenNebula server(s) should have passwordless ssh access as oneadmin user to all the hypervisor hosts of the cluster e.g. by distributing the public key(s) of the OpenNebula host over the cluster
-
- Start OpenNebula services: ### for i in '' -econe -gate -novnc -occi -sunstone; do service opennebula$i stop; done
-
- Run the component a first time
-
- The new oneadmin password will be available from
/var/lib/one
/.one/one_auth file. The old auth files are stored with .quattor.backup extension.
- The new oneadmin password will be available from
-
- It is also possible to change sunstone service password, just include 'serveradmin' user and passwd within opennebula/users tree. In that case the component also updates the sunstone_auth file.
RESOURCES
/software/components/opennebula
The configuration information for the component. Each field should be described in this section.
-
ssh_multiplex : boolean
Set ssh multiplex options
-
cfg_group : string
In some cases (such a Sunstone standalone conf with apache), some ONE conf files should be accessible by a different group (as apache). This variable sets the group name to change these files permissions.
-
host_hyp : string
Set host hypervisor type
-
kvm
Set KVM hypervisor
-
xen
Set XEN hypervisor
-
-
host_ovs : boolean (optional)
Includes the Open vSwitch network drives in your hypervisors. (OVS must be installed in each host) Open vSwitch replaces Linux bridges, Linux bridges must be disabled. More info: http://docs.opennebula.org/4.14/administration/networking/openvswitch.html
-
tm_system_ds : string (optional)
Set system datastore TM_MAD value (shared by default). Valid values:
-
shared
The storage area for the system datastore is a shared directory across the hosts.
-
vmfs
A specialized version of the shared one to use the vmfs file system.
-
ssh
Uses a local storage area from each host for the system datastore.
-
DEPENDENCIES
The component was tested with OpenNebula version 4.8 and 4.1x
Following package dependencies should be installed to run the component:
- perl-Config-Tiny
- perl-LC
- perl-Net-OpenNebula >= 0.2.2 !