Difference between revisions of "stoney conductor: OpenLDAP directory data organisation"
From stoney cloud
| [unchecked revision] | [unchecked revision] |
(→Configuration) |
(→Virtual Machine: Operating System) |
||
| (29 intermediate revisions by the same user not shown) | |||
| Line 348: | Line 348: | ||
sstBackupRootDirectory: file:///var/backup/virtualization | sstBackupRootDirectory: file:///var/backup/virtualization | ||
sstBackupRetainDirectory: file:///var/virtualization/retain | sstBackupRetainDirectory: file:///var/virtualization/retain | ||
| + | sstBackupRamDiskLocation: file:///var/cache/kvmbackup | ||
| + | sstVirtualizationDiskImageFormat: qcow2 | ||
| + | sstVirtualizationDiskImageOwner: root | ||
| + | sstVirtualizationDiskImageGroup: vm-storage | ||
| + | sstVirtualizationDiskImagePermission: 660 | ||
| + | sstVirtualizationDiskImageDirectoryOwner: root | ||
| + | sstVirtualizationDiskImageDirectoryGroup: vm-storage | ||
| + | sstVirtualizationDiskImageDirectoryPermission: 770 | ||
sstBackupNumberOfIterations: 1 | sstBackupNumberOfIterations: 1 | ||
sstVirtualizationVirtualMachineForceStart: FALSE | sstVirtualizationVirtualMachineForceStart: FALSE | ||
sstVirtualizationBandwidthMerge: 0 | sstVirtualizationBandwidthMerge: 0 | ||
| + | |||
| + | The following table describes the different attributes: | ||
| + | {| style="border-spacing:0;" | ||
| + | | style="border-top:0.002cm solid #000000;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| '''Attribute''' | ||
| + | | style="border-top:0.002cm solid #000000;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center>'''Existence'''</center> | ||
| + | | style="border-top:0.002cm solid #000000;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center>'''Mandatory'''</center> | ||
| + | | style="border-top:0.002cm solid #000000;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center>'''Self-Service'''</center> | ||
| + | | style="border-top:0.002cm solid #000000;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center>'''Changeable'''</center> | ||
| + | | style="border:0.002cm solid #000000;padding:0.097cm;"| '''Description''' | ||
| + | |||
| + | |- | ||
| + | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| ou | ||
| + | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center>MUST</center> | ||
| + | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center>x</center> | ||
| + | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center></center> | ||
| + | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center></center> | ||
| + | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:0.002cm solid #000000;padding:0.097cm;"| ... | ||
| + | |||
| + | |||
| + | |} | ||
| + | |||
| + | Legend: | ||
| + | * '''x''': Mandatory in all cases. | ||
===== Internal Searches ===== | ===== Internal Searches ===== | ||
| Line 857: | Line 888: | ||
dhcpstatements: ddns-updates off | dhcpstatements: ddns-updates off | ||
dhcpstatements: ping-check false | dhcpstatements: ping-check false | ||
| + | sstNetfilterInterfaceAlias: pub | ||
| + | sstSourceBridge: vmbr0 | ||
sstBelongsToResellerUID: 4000000 | sstBelongsToResellerUID: 4000000 | ||
sstBelongsToCustomerUID: 4000001 | sstBelongsToCustomerUID: 4000001 | ||
| Line 923: | Line 956: | ||
| '''DHCP-Range''' (hier wird die jeweils die erste und letzte IP-Adresse vom geünschten IP-Range angegeben). Es können prinzipiell mehrer DHCP-Ranges angegeben werden. Über die Verteilung der DHCP-Leases kann jedoch kein Einfluss genommen werden. | | '''DHCP-Range''' (hier wird die jeweils die erste und letzte IP-Adresse vom geünschten IP-Range angegeben). Es können prinzipiell mehrer DHCP-Ranges angegeben werden. Über die Verteilung der DHCP-Leases kann jedoch kein Einfluss genommen werden. | ||
| nein (wird nicht verwendent, da alle IPs fix vergeben werden) | | nein (wird nicht verwendent, da alle IPs fix vergeben werden) | ||
| + | |||
| + | |- | ||
| + | | sstNetfilterInterfaceAlias: pub | ||
| + | | <center>MAY</center> | ||
| + | | <center>x</center> | ||
| + | | The netfilter interface alias, for example: pub or pub2. | ||
| + | | no | ||
| + | |||
| + | |- | ||
| + | | sstSourceBridge: vmbr0 | ||
| + | | <center>MAY</center> | ||
| + | | <center>x</center> | ||
| + | | The name of the bridge (for example vmbr0). | ||
| + | | no | ||
|} | |} | ||
| Line 2,093: | Line 2,140: | ||
ou: virtual machines | ou: virtual machines | ||
description: This sub tree contains all virtual machines and virtual machine templates of this stoney cloud installation. | description: This sub tree contains all virtual machines and virtual machine templates of this stoney cloud installation. | ||
| + | |||
| + | ===== Virtual Machine Templates ===== | ||
| + | The virtual machine templates and the virtual machines are practically the same. The only difference lies in the the type. The following example describes a '''virtual machine template''': | ||
| + | <source lang="ldif"> | ||
| + | sstVirtualMachineType: template | ||
| + | sstVirtualMachineSubType: VM-Template | ||
| + | </source> | ||
| + | |||
| + | The following example describes a '''virtual machine''': | ||
| + | <source lang="ldif"> | ||
| + | sstVirtualMachineType: persistent | ||
| + | sstVirtualMachineSubType: server | ||
| + | </source> | ||
===== Virtual Machine ===== | ===== Virtual Machine ===== | ||
The following LDIF entry shows the virtual machine kvm-0001.stoney-cloud.org. In the stoney cloud version 1.2.0 the entries <code>sstNetworkHostname: kvm-0001</code> and <code>sstNetworkDomainName: stoney-cloud.org</code> have been added. These will be used by the vm-manager in the stoney cloud version 1.4.0 to automatically set <code>sstDisplayName: kvm-0001.stoney-cloud.org</code> properly. The user will be allowed to set <code>sstNetworkHostname</code> and <code>sstNetworkDomainName</code>. The content of <code>sstDisplayName</code> will be pre-filled with the content of <code>sstNetworkHostname</code> and <code>sstNetworkDomainName</code> and will be able to be modified through the user. A typical edit could be <code>sstDisplayName: kvm-0001.stoney-cloud.org (Mail Server)</code> | The following LDIF entry shows the virtual machine kvm-0001.stoney-cloud.org. In the stoney cloud version 1.2.0 the entries <code>sstNetworkHostname: kvm-0001</code> and <code>sstNetworkDomainName: stoney-cloud.org</code> have been added. These will be used by the vm-manager in the stoney cloud version 1.4.0 to automatically set <code>sstDisplayName: kvm-0001.stoney-cloud.org</code> properly. The user will be allowed to set <code>sstNetworkHostname</code> and <code>sstNetworkDomainName</code>. The content of <code>sstDisplayName</code> will be pre-filled with the content of <code>sstNetworkHostname</code> and <code>sstNetworkDomainName</code> and will be able to be modified through the user. A typical edit could be <code>sstDisplayName: kvm-0001.stoney-cloud.org (Mail Server)</code> | ||
| − | + | <source lang="ldif"> | |
| − | + | dn: sstVirtualMachine=b543f88f-dffe-426f-86d3-c7ff85c16d2a,ou=virtual machines,ou=virtualization,ou=services,dc=stoney-cloud,dc=org | |
| − | + | objectClass: top | |
| − | + | objectClass: sstVirtualizationVirtualMachine | |
| − | + | objectClass: sstRelationship | |
| − | + | objectClass: sstSpice | |
| − | + | objectClass: labeledURIObject | |
| − | + | sstVirtualMachine: b543f88f-dffe-426f-86d3-c7ff85c16d2a | |
| − | + | description: Linux Fedora 20 (64-bit) | |
| − | + | sstVirtualMachinePool: d9c3cc0c-9ae7-40e5-8fb7-ba5297e835aa | |
| − | + | sstClockOffset: utc | |
| − | + | sstMemory: 2147483648 | |
| − | + | sstNode: vm-node-01.stoney-cloud.org | |
| − | + | sstOnCrash: destroy | |
| − | + | sstOnPowerOff: destroy | |
| − | + | sstOnReboot: restart | |
| − | + | sstOSArchitecture: x86_64 | |
| − | + | sstOSBootDevice: hd | |
| − | + | sstOSMachine: pc-i440fx-1.5 | |
| − | + | sstOSType: hvm | |
| − | + | sstStatus: running | |
| − | + | sstVirtualMachineMode: first installation | |
| − | + | sstType: kvm | |
| − | + | sstVCPU: 1 | |
| − | + | sstFeature: acpi | |
| − | + | sstFeature: pae | |
| − | + | sstVirtualMachineType: persistent | |
| − | + | sstVirtualMachineSubType: Server | |
| − | + | sstSpicePort: 5900 | |
| − | + | sstSpicePassword: Z1oQn2HrF9Lb | |
| − | + | labeledURI: ldap:///sstVirtualMachine=default,ou=default,ou=default,ou=default,ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,dc=stoney-cloud,dc=org | |
| − | + | sstNetworkDomainName: stoney-cloud.org | |
| − | + | sstNetworkHostname: kvm-0001 | |
| − | + | sstDisplayName: kvm-0001.stoney-cloud.org | |
| − | + | sstBelongsToResellerUID: 4000000 | |
| + | sstBelongsToCustomerUID: 4000001 | ||
| + | uid: 1234567 | ||
| + | </source> | ||
The following table describes the different attributes: | The following table describes the different attributes: | ||
| Line 2,388: | Line 2,451: | ||
| style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center></center> | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center></center> | ||
| style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:0.002cm solid #000000;padding:0.097cm;"| Stores the service UID the leaf belongs to. | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:0.002cm solid #000000;padding:0.097cm;"| Stores the service UID the leaf belongs to. | ||
| + | |||
| + | |- | ||
| + | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| uid | ||
| + | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center>MUST</center> | ||
| + | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center>x</center> | ||
| + | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center></center> | ||
| + | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center></center> | ||
| + | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:0.002cm solid #000000;padding:0.097cm;"| A unique integer value with 7 digits or more. For example: 1234567. The <code>uid</uid> is used for billing purposes. | ||
|} | |} | ||
| Line 2,468: | Line 2,539: | ||
====== Virtual Machine: Operating System ====== | ====== Virtual Machine: Operating System ====== | ||
| − | + | <source lang="ldif"> | |
| + | dn: ou=operating system,sstVirtualMachine=4b99c860-cf5a-435a-a87d-e9fdc2bf0ba5,ou=virtual machines,ou=virtualization,ou=services,dc=stoney-cloud,dc=org | ||
| + | objectClass: top | ||
| + | objectclass: organizationalUnit | ||
| + | objectClass: sstOperatingSystemObjectClass | ||
| + | ou: operating system | ||
| + | sstOperatingSystem: Windows | ||
| + | sstOperatingSystemType: Server 2012 | ||
| + | sstOperatingSystemVersion: Standard | ||
| + | </source> | ||
| − | + | The following table describes the different attributes: | |
| − | + | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
{| style="border-spacing:0;" | {| style="border-spacing:0;" | ||
| − | | style=" | + | | style="border-top:0.002cm solid #000000;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| '''Attribute''' |
| + | | style="border-top:0.002cm solid #000000;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| '''Objectclass''' | ||
| style="border-top:0.002cm solid #000000;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center>'''Existence'''</center> | | style="border-top:0.002cm solid #000000;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center>'''Existence'''</center> | ||
| style="border-top:0.002cm solid #000000;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center>'''Mandatory'''</center> | | style="border-top:0.002cm solid #000000;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center>'''Mandatory'''</center> | ||
| − | | style=" | + | | style="border:0.002cm solid #000000;padding:0.097cm;"| '''Description''' |
|- | |- | ||
| − | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| | + | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| sstOperatingSystem |
| + | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center>sstOperatingSystemObjectClass</center> | ||
| style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center>MUST</center> | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center>MUST</center> | ||
| style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center>x</center> | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| <center>x</center> | ||
| − | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:0.002cm solid #000000;padding:0.097cm;"| | + | | style="border-top:none;border-bottom:0.002cm solid #000000;border-left:0.002cm solid #000000;border-right:0.002cm solid #000000;padding:0.097cm;"| A manually executed maintenance window for Windows systems is significantly more time-consuming than for Linux. Therefore we need to know the operating system. Possible values are |
| + | * <code>sstOperatingSystem: Linux</code> | ||
| + | * <code>sstOperatingSystem: Windows</code>. | ||
| − | + | This attribute is only relevant, if <code>sstServiceAutomated</code> is set to <code>FALSE</code> (under <code>ou=units,ou=maintenance,ou=services,dc=stoney-cloud,dc=org</code>). See the [[stoney_maintenance:_OpenLDAP_directory_data_organisation#Maintenance_Units |Maintenance units]] documentation. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
|} | |} | ||
| − | + | Legend: | |
| − | + | * '''x''': Mandatory in all cases. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| + | ====== Virtual Machine: People ====== | ||
| + | dn: ou=people,sstVirtualMachine=b543f88f-dffe-426f-86d3-c7ff85c16d2a,ou=virtual machines,ou=virtualization,ou=services,dc=stoney-cloud,dc=org | ||
| − | + | ====== Virtual Machine: Settings ====== | |
| − | + | dn: ou=settings,sstVirtualMachine=b543f88f-dffe-426f-86d3-c7ff85c16d2a,ou=virtual machines,ou=virtualization,ou=services,dc=stoney-cloud,dc=org | |
| − | + | objectClass: top | |
| − | + | objectClass: organizationalUnit | |
| − | + | ou: settings | |
| − | + | ====== Virtual Machine: Software Stack ====== | |
| − | + | <source lang="ldif"> | |
| − | + | dn: ou=software stack,sstVirtualMachine=4b99c860-cf5a-435a-a87d-e9fdc2bf0ba5,ou=virtual machines,ou=virtualization,ou=services,dc=stoney-cloud,dc=org | |
| − | + | objectClass: top | |
| − | + | objectClass: sstGroupObjectClass | |
| − | + | objectClass: labeledURIObject | |
| − | + | ou: software stack | |
| − | + | sstDisplayName: None | |
| − | + | sstBusinessLogicRoleName: none | |
| − | + | description: No Software Stack is to be managed through the configuration management. | |
| − | + | labeledURI: ldap:///uid=3000064,ou=software stack,ou=configuration,o=stepping-stone,c=ch | |
| − | + | sstEnvironmentName: 3000060 | |
| − | + | </source> | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| + | The attribute <code>sstEnvironmentName: 3000060</code> points to the entry <code>uid=3000060,ou=environments,ou=software stack,ou=configuration,dc=stoney-cloud,dc=org</code> and means, we are in the '''Production Environment'''. | ||
[[Category:stoney conductor]][[Category:OpenLDAP directory]] | [[Category:stoney conductor]][[Category:OpenLDAP directory]] | ||
Latest revision as of 13:38, 2 January 2021
Contents
Virtualization
The sub tree ou=virtualization,ou=services,dc=stoney-cloud,dc=org contains all the information for the stoney cloud. With this information we can build and operate a multi node environment for a virtual desktop and server infrastructure.
Authentication (Authentication Realms)
The sub tree ou=authentication,ou=virtualization,ou=services,dc=stoney-cloud,dc=org stores all the authentication realms for the virtual desktop- and server-infrstructure.
dn: ou=authentication,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit ou: authentication description: This sub tree contains all the authentication realm data for the virtualization environment.
Current
As of the current stoney cloud version, the authentication realms have changed to reflect the new login process. The obsolete configuration was only suitable for static desktops and servers where as the new configuration works with static and dynamic VM-Pools as well static and dynamic Virtual Machines.
The following example shows a working authentication realm:
dn: ou=4000013,ou=authentication,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: labeledURIObject objectclass: sstLDAPAuthenticationProvider objectclass: sstRelationship ou: 4000013 description: This is the customer virtual machines authentication realm. sstDisplayName: Customer Virtual Machines sstLDAPExternalDirectory: FALSE sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001
User Search
This entry is used to check, if the user trying to log into the system, actually exists in the directory. The placeholder %s is replaced by the users login name.
dn: ou=User Search,ou=4000013,ou=authentication,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: labeledURIObject objectclass: sstLDAPSearchObjectClass objectclass: sstRelationship ou: User Search description: This is the "User Search" Bind-DN which is needed to search for the given user in the LDAP directory. sstDisplayName: "User Search" Bind-DN sstLDAPBaseDn: ou=people,dc=stoney-cloud,dc=org sstLDAPFilter: (&(objectClass=sstPerson)(cn=%s)) sstLDAPForeignStaticAttribute: uid sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001
Example search:
ldapsearch -D "cn=Manager,dc=stoney-cloud,dc=org" -w admin -H "ldap://10.1.130.14:389" -b "ou=people,dc=stoney-cloud,dc=org" "(&(objectClass=sstPerson)(cn=eichi))" uid # extended LDIF # # LDAPv3 # base <ou=people,dc=stoney-cloud,dc=org> with scope subtree # filter: (&(objectClass=sstPerson)(cn=eichi)) # requesting: uid # # 4000003, people, stoney-cloud.org dn: uid=4000003,ou=people,dc=stoney-cloud,dc=org uid: 4000003 # search result search: 2 result: 0 Success # numResponses: 2 # numEntries: 1
User Authentication
Check the given username and password combination. The placeholder %s is replaced by the users login name.
################################################################################################### # Attention: # Normally, the sstLDAPAuthUserBind is set to TRUE, meaning, the users credentials are used. In # some cases, it can make sense, that the Manager checks the credentials. In this case, # sstLDAPAuthUserBind is set to FALSE and sstLDAPBindDn as well as sstLDAPBindPassword are both # taken from the parent leaf. ################################################################################################### dn: ou=User Authentication,ou=4000013,ou=authentication,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: labeledURIObject objectclass: sstLDAPAuthenticationObjectClass objectclass: sstRelationship ou: User Authentication description: This is the users authentication Bind-DN which is needed to verify the credentials of the given user in the LDAP directory. sstDisplayName: "User Authentication" Bind-DN sstLDAPAuthUserBind: TRUE sstLDAPAuthUserBindDn: uid=%s,ou=people,dc=stoney-cloud,dc=org sstLDAPAuthUserPasswordAttribute: userPassword sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001
Example search:
ldapsearch -D "uid=4000003,ou=people,dc=stoney-cloud,dc=org" -W -H "ldap://10.1.130.14:389" -b "uid=4000003,ou=people,dc=stoney-cloud,dc=org" "(&(objectClass=sstPerson)(cn=eichi))" Enter LDAP Password: # extended LDIF # # LDAPv3 # base <uid=4000003,ou=people,dc=stoney-cloud,dc=org> with scope subtree # filter: (&(objectClass=sstPerson)(cn=eichi)) # requesting: ALL # # 4000003, people, stoney-cloud.org dn: uid=4000003,ou=people,dc=stoney-cloud,dc=org objectClass: top objectClass: sstPerson givenName: Michael mail: michael.eichenberger@stepping-stone.ch preferredLanguage: en-GB sstGender: m sstBelongsToCustomerUID: 4000001 sstTimeZoneOffset: UTC+01 sn: Eichenberger uid: 4000003 userPassword:: e1NIQX15ZStZbFJlWG1QQUR3aENLMStjazVUQXp5dVk9 cn: eichi mobile: +41 76 392 36 23 sstBelongsToResellerUID: 4000000 telephoneNumber: +41 31 332 53 63 sstGroupUID: 4000014 # search result search: 2 result: 0 Success # numResponses: 2 # numEntries: 1
User Group Search
This entry describes, how to look for the groups the user belongs to. The placeholder %s is replaced by the users login name.
dn: ou=User Group Search,ou=4000013,ou=authentication,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: labeledURIObject objectclass: sstLDAPSearchObjectClass objectclass: sstRelationship ou: User Group Search description: This is the "User Group Search", which is needed to search for all the groups, the given user belongs to. sstDisplayName: Group Search sstLDAPBaseDn: ou=people,dc=stoney-cloud,dc=org sstLDAPFilter: (&(objectClass=sstPerson)(uid=%s)) sstLDAPReturnAttribute: sstGroupUID sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001
Example search:
ldapsearch -D "cn=Manager,dc=stoney-cloud,dc=org" -w admin -H "ldap://10.1.130.14:389" -b "ou=people,dc=stoney-cloud,dc=org" "(&(objectClass=sstPerson)(cn=eichi))" sstGroupUID # extended LDIF # # LDAPv3 # base <ou=people,dc=stoney-cloud,dc=org> with scope subtree # filter: (&(objectClass=sstPerson)(cn=eichi)) # requesting: sstGroupUID # # 4000003, people, stoney-cloud.org dn: uid=4000003,ou=people,dc=stoney-cloud,dc=org sstGroupUID: 4000014 sstGroupUID: 4000015 # search result search: 2 result: 0 Success # numResponses: 2 # numEntries: 1
Group Search (used in case of external directory)
This entry describes, how to look for all the existing groups in the foreign directory:
dn: ou=Group Search,ou=4000013,ou=authentication,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: labeledURIObject objectclass: sstLDAPSearchObjectClass objectclass: sstRelationship ou: Group Search description: This is the "Group Search", which is needed to search for all existing groups in the foreign directory. sstDisplayName: Group Search sstLDAPBaseDn: ou=groups,dc=stoney-cloud,dc=org sstLDAPFilter: (&(objectClass=sstGroupObjectClass)(uid=*)) sstLDAPForeignGroupDisplayName: sstGroupName sstLDAPForeignStaticAttribute: uid sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001
Example search:
ldapsearch -D "cn=Manager,dc=stoney-cloud,dc=org" -w admin -H "ldap://10.1.130.14:389" -b "ou=groups,dc=stoney-cloud,dc=org" "(&(objectClass=sstGroupObjectClass)(uid=*))" sstGroupName uid # extended LDIF # # LDAPv3 # base <ou=groups,dc=stoney-cloud,dc=org> with scope subtree # filter: (&(objectClass=sstGroupObjectClass)(uid=*)) # requesting: sstGroupName uid # # 4000014, groups, stoney-cloud.org dn: uid=4000014,ou=groups,dc=stoney-cloud,dc=org uid: 4000014 sstGroupName: Technology # 4000015, groups, stoney-cloud.org dn: uid=4000015,ou=groups,dc=stoney-cloud,dc=org uid: 4000015 sstGroupName: Office # search result search: 2 result: 0 Success # numResponses: 3 # numEntries: 2
Working example for an external authentication
The following working example needs the stoney cloud Version 1.0.1rc3 or newer. Working example configuration from Christian Wittkowski using his internal directory for the stoney cloud and our external directory for authentication:
dn: ou=4000014,ou=authentication,ou=virtualization,ou=services,dc=devroom,dc =de objectClass: top objectClass: organizationalUnit objectClass: labeledURIObject objectClass: sstLDAPAuthenticationProvider objectClass: sstRelationship ou: 4000014 sstBelongsToCustomerUID: 4000001 sstBelongsToResellerUID: 4000000 description: This is the customer virtual machines authentication realm. labeledURI: ldap://192.168.140.13:389 sstDisplayName: Customer Virtual Machines sstLDAPBindDn: cn=Manager,dc=stoney-cloud,dc=org sstLDAPBindPassword:: YWRtaW4= sstLDAPExternalDirectory: TRUE dn: ou=Group Search,ou=4000014,ou=authentication,ou=virtualization,ou=servic es,dc=devroom,dc=de objectClass: top objectClass: organizationalUnit objectClass: labeledURIObject objectClass: sstLDAPSearchObjectClass objectClass: sstRelationship ou: Group Search sstBelongsToCustomerUID: 4000001 sstBelongsToResellerUID: 4000000 sstLDAPBaseDn: ou=groups,dc=stoney-cloud,dc=org description: This is the "Group Search", which is needed to search for all e xisting groups in the foreign directory. sstDisplayName: Group Search sstLDAPFilter: (&(objectClass=sstGroupObjectClass)(uid=*)) sstLDAPForeignGroupDisplayName: sstGroupName sstLDAPForeignStaticAttribute: uid dn: ou=User Authentication,ou=4000014,ou=authentication,ou=virtualization,ou =services,dc=devroom,dc=de objectClass: top objectClass: organizationalUnit objectClass: labeledURIObject objectClass: sstLDAPAuthenticationObjectClass objectClass: sstRelationship ou: User Authentication sstBelongsToCustomerUID: 4000001 sstBelongsToResellerUID: 4000000 sstLDAPAuthUserBind: TRUE sstLDAPAuthUserBindDn: uid=%s,ou=people,dc=stoney-cloud,dc=org sstLDAPAuthUserPasswordAttribute: userPassword description: This is the users authentication Bind-DN which is needed to ver ify the credentials of the given user in the LDAP directory. sstDisplayName: "User Authentication" Bind-DN dn: ou=User Group Search,ou=4000014,ou=authentication,ou=virtualization,ou=s ervices,dc=devroom,dc=de objectClass: top objectClass: organizationalUnit objectClass: labeledURIObject objectClass: sstLDAPSearchObjectClass objectClass: sstRelationship ou: User Group Search sstBelongsToCustomerUID: 4000001 sstBelongsToResellerUID: 4000000 sstLDAPBaseDn: ou=people,dc=stoney-cloud,dc=org description: This is the "User Group Search", which is need to search for al l the groups, the given user belongs to. sstDisplayName: Group Search sstLDAPFilter: (&(objectClass=sstPerson)(uid=%s)) sstLDAPReturnAttribute: sstGroupName dn: ou=User Search,ou=4000014,ou=authentication,ou=virtualization,ou=service s,dc=devroom,dc=de objectClass: top objectClass: organizationalUnit objectClass: labeledURIObject objectClass: sstLDAPSearchObjectClass objectClass: sstRelationship ou: User Search sstBelongsToCustomerUID: 4000001 sstBelongsToResellerUID: 4000000 sstLDAPBaseDn: ou=people,dc=stoney-cloud,dc=org description: This is the "User Search" Bind-DN which is needed to search for the given user in the LDAP directory. sstDisplayName: "User Search" Bind-DN sstLDAPFilter: (&(objectClass=sstPerson)(cn=%s)) sstLDAPForeignStaticAttribute: uid sstLDAPInternalForeignMapping: givenName:givenName sstLDAPInternalForeignMapping: sn:sn sstLDAPInternalForeignMapping: mail:mail
Configuration
The subtree ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org contains the configuration information of the stoney cloud. This sub tree is populated during the installation of the first stoney cloud node:
- Demo-System: Lets you quickly install and test the stoney cloud on a single physical machine without any further network requirements.
- Single-Node-Installation: This option lets you run the stoney cloud on a single physical machine without any high availability.
- Multi-Node-Installation: The high availability version requires al least four physical machines.
dn: ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit ou: configuration description: This sub tree contains the configuration information of the stoney cloud.
Backup
The sub tree ou=backup,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org contains the default backup plan for the whole stoney cloud installation (since version 1.2.0).
# The following backup configuration says, that the backup should be done daily, at 03:00 hours (localtime). # * * * * * command to be executed # - - - - - # | | | | | # | | | | +----- day of week (0 - 6) (Sunday=0) # | | | +------- month (1 - 12) # | | +--------- day of month (1 - 31) # | +----------- hour (0 - 23) # +------------- min (0 - 59) # localtime in the crontab entry dn: ou=backup,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=orgpools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstVirtualizationBackupObjectClass objectclass: sstCronObjectClass ou: backup description: This sub tree contains the default backup plan of the stoney cloud. sstCronMinute: 0 sstCronHour: 3 sstCronDay: * sstCronMonth: * sstCronDayOfWeek: * sstCronActive: TRUE sstBackupRootDirectory: file:///var/backup/virtualization sstBackupRetainDirectory: file:///var/virtualization/retain sstBackupRamDiskLocation: file:///var/cache/kvmbackup sstVirtualizationDiskImageFormat: qcow2 sstVirtualizationDiskImageOwner: root sstVirtualizationDiskImageGroup: vm-storage sstVirtualizationDiskImagePermission: 660 sstVirtualizationDiskImageDirectoryOwner: root sstVirtualizationDiskImageDirectoryGroup: vm-storage sstVirtualizationDiskImageDirectoryPermission: 770 sstBackupNumberOfIterations: 1 sstVirtualizationVirtualMachineForceStart: FALSE sstVirtualizationBandwidthMerge: 0
The following table describes the different attributes:
| Attribute | |
|
|
|
Description |
| ou | |
|
|
|
...
|
Legend:
- x: Mandatory in all cases.
Internal Searches
The sub tree ou=internal searches,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org contains the internal ldap searches configuration of the stoney cloud installation.
Networks
The ideal stoney cloud environment is based on four logical separated VLANs (virtual LANs):
- admin: Administrative network, used for administration and monitoring purposes.
- data: Data network, used for GlusterFS (in later versions NFS and Ceph as well) traffic.
- int: Internal network, used for internal traffic such as LDAP, libvirt and more.
- pub: Public network, used for accessing the VM-Manager web interface, Spice traffic and internet access.
The sub tree ou=networks,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org contains the services configuration information of the stoney cloud (since version 0.8.0).
dn: ou=networks,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit ou: networks description: This subtree contains the networks configuration information of the stoney cloud.
Each VLAN (network) mentioned above has it's own subtree. The naming is in the form of ou=VLAN-name. The VLAN subtree contains information about the VALN (network) and the services running therein. Administrative network, used for administration and monitoring purposes:
dn: ou=admin,ou=networks,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstNetwork ou: admin description: Administrative network, used for administration and monitoring purposes. sstNetworkVLANId: 1799 sstNetworkPrefix: 192.168.17.0/24 sstNetworkDefaultGateway: 192.168.17.1 sstNetworkBroadcastAddress: 192.168.17.255 sstNetworkDomainName: admin.stoney-cloud.org
The service(s) running are named in the form of sstName=Service. The following example shows the OpenSSH daemon, which is needed for remote administration.
# sshd: OpenSSH is used for remote management and access. dn: sstService=sshd,ou=admin,ou=networks,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstServices sstService: sshd description: OpenSSH is used for remote management and access. sstDisplayName: OpenSSH daemon # zabbix-agent: The ZABBIX-agent is used for monitoring purposes. dn: sstService=zabbix-agent,ou=admin,ou=networks,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstServices sstService: zabbix-agent description: The ZABBIX-agent is used for monitoring purposes. sstDisplayName: ZABBIX
Data network, used for GlusterFS (in later versions NFS and Ceph as well) traffic:
dn: ou=data,ou=networks,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstNetwork ou: data description: Data network, used for GlusterFS (in later versions NFS and Ceph as well) traffic. sstNetworkVLANId: 1797 sstNetworkPrefix: 10.17.97.0/24 sstNetworkDefaultGateway: 10.17.97.1 sstNetworkBroadcastAddress: 10.17.97.255 sstNetworkDomainName: data.stoney-cloud.org # glusterd: The GlusterFS File service is used as the virtual machine storage. dn: sstService=glusterd,ou=data,ou=networks,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstServices sstService: glusterd description: The GlusterFS File service is used as the virtual machine storage. sstDisplayName: GlusterFS File Service sstNetworkVirtualIPAdress: 10.17.97.87 sstNetworkVirtualHostname: glusterfs
Internal network, used for internal traffic such as LDAP, libvirt and more:
dn: ou=int,ou=networks,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstNetwork ou: int description: Internal network, used for internal traffic such as LDAP, libvirt and more. sstNetworkVLANId: 1798 sstNetworkPrefix: 10.17.98.0/24 sstNetworkDefaultGateway: 10.17.98.1 sstNetworkBroadcastAddress: 10.17.98.255 sstNetworkDomainName: int.stoney-cloud.org # libvirtd: The libvirtd daemon is used for the administration of the virtual servers. dn: sstService=libvirtd,ou=int,ou=networks,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstServices sstService: libvirtd description: The libvirtd daemon is used for the administration of the virtual servers. sstDisplayName: libvirtd Service # slapd: The OpenLDAP directory is used for the storage of all service related data. dn: sstService=slapd,ou=int,ou=networks,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstServices sstService: slapd description: The OpenLDAP directory is used for the storage of all service related data. sstDisplayName: OpenLDAP Service sstNetworkVirtualIPAdress: 10.17.98.87 sstNetworkVirtualHostname: ldapm
Public network, used for accessing the VM-Manager web interface, Spice traffic and internet access:
dn: ou=pub,ou=networks,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstNetwork ou: pub description: Public network, used for accessing the VM-Manager web interface, Spice traffic and internet access. sstNetworkVLANId: 1701 sstNetworkPrefix: 31.216.40.0/24 sstNetworkDefaultGateway: 31.216.40.1 sstNetworkBroadcastAddress: 31.216.40.255 sstNetworkDomainName: test.stoney-cloud.org sstNetworkNTPHost: 0.ch.pool.ntp.org sstNetworkNTPHost: 1.ch.pool.ntp.org sstNetworkNTPHost: 2.ch.pool.ntp.org sstNetworkNTPHost: 3.ch.pool.ntp.org sstNetworkDNSHost: 194.176.109.202 sstNetworkDNSHost: 212.103.77.109 # apache2: The Apache web server is used for the VM-Manager web interface. dn: sstService=apache2,ou=pub,ou=networks,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstServices sstService: apache2 description: The Apache web server is used for the VM-Manager web interface. sstNetworkVirtualHostname: vm-manager sstDisplayName: VM-Manager Service # dhcpd: The DHCP server is used for the distribution of IP addresses. dn: sstService=dhcpd,ou=pub,ou=networks,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstServices sstService: dhcpd description: The DHCP server is used for the distribution of IP addresses. sstNetworkVirtualHostname: dhcpd sstDisplayName: DHCP Service # qemu-system-x86_64: The QEMU (spice) service is used for the interaction with virtualized desktop devices. dn: sstService=qemu-system-x86_64,ou=pub,ou=networks,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstServices sstService: qemu-system-x86_64 description: The QEMU (spice) service is used for the interaction with virtualized desktop devices. sstNetworkVirtualHostname: vm-manager sstDisplayName: QEMU (spice) Service
Node-Types
The stoney cloud consists of different versions. Each version has different possible node types:
- Single-Node-Installation:
- Demo-System: This node type is a special single-node installation and is used for demo purposes only.
- KVM: The node subtype KVM.
- Demo-System: This node type is a special single-node installation and is used for demo purposes only.
- Multi-Node-Installation:
- Primary-Master-Node: This is the first node of a multi-node installation.
- KVM: The node subtype KVM.
- Secondary-Master-Node: This is the second node of a multi-node installation.
- KVM: The node subtype KVM.
- VM-Node: The VM-Node is used to run the actual virtual machines (VM's).
- KVM: The node subtype KVM.
- Storage-Node: The Storage-Node is used to store all the images (VM-Profiles, VM-Templates and VMs).
- GlusterFS: The node subtype GlusterFS.
- Ceph: The node subtype Ceph (could come later).
- Primary-Master-Node: This is the first node of a multi-node installation.
The subtree ou=node-types,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org contains the node-types configuration information of the stoney cloud (since version 0.8.0).
dn: ou=node-types,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit ou: networks description: This subtree contains the node-types configuration information of the stoney cloud.
The Demo-System node type is a special single-node installation and is used for demo purposes only and is used in the Single-Node-Installation.
dn: sstNodeType=Demo-System,ou=node-types,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstTypeNode sstNodeType: Demo-System sstNodeSubtype: KVM sstService: sshd sstService: zabbix-agent sstService: libvirtd sstService: slapd sstService: apache2 sstService: qemu-system-x86_64 description: This node type is a special single-node installation and is used for demo purposes only. sstDisplayName: Demo System
The Primary-Master-Node is the first node of a Multi-Node-Installation.
dn: sstNodeType=Primary-Master-Node,ou=node-types,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstTypeNode sstNodeType: Primary-Master-Node sstNodeSubtype: KVM sstService: sshd sstService: zabbix-agent sstService: libvirtd sstService: slapd sstService: apache2 sstService: qemu-system-x86_64 description: This is the first node of a multi-node installation. sstDisplayName: Primary-Master-Node
The Secondary-Master-Node is the second node of a Multi-Node-Installation.
dn: sstNodeType=Secondary-Master-Node,ou=node-types,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstTypeNode sstNodeType: Secondary-Master-Node sstNodeSubtype: KVM sstService: sshd sstService: zabbix-agent sstService: libvirtd sstService: slapd sstService: apache2 sstService: qemu-system-x86_64 description: This is the second node of a multi-node installation. sstDisplayName: Secondary-Master-Node
The VM-Node is used to run the actual virtual machines (VM's) in a Multi-Node-Installation.
dn: sstNodeType=VM-Node,ou=node-types,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstTypeNode sstNodeType: VM-Node sstNodeSubtype: KVM sstService: sshd sstService: zabbix-agent sstService: libvirtd sstService: qemu-system-x86_64 description: The VM-Node is used to run the actual virtual machines (VM's). sstDisplayName: VM-Node
The Storage-Node is used to store all the images (VM-Profiles, VM-Templates and VMs) in a Multi-Node-Installation.
dn: sstNodeType=Storage-Node,ou=node-types,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstTypeNode sstNodeType: Storage-Node sstNodeSubtype: GlusterFS sstService: sshd sstService: zabbix-agent sstService: glusterd description: The Storage-Node is used to store all the images (VM-Profiles, VM-Templates and VMs). sstDisplayName: Storage-Node
Settings
The sub tree ou=settings,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org contains the default settings for the whole stoney cloud installation (since version 1.2.0). They can be changed by the administrator.
# This entry contains some default settings for the whole stoney cloud (since version 1.2.0). dn: ou=settings,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit ou: settings description: This sub tree contains some default settings for the whole stoney cloud.
Hostname
The sub tree ou=hostname,ou=settings,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org defines pre-formated hostnames in the form of kvm-%04d. Together with the domain name, this gives you kvm-0000.example.org to kvm-9999.example.org. This is implemented in version 1.2.0 in the OpenLDAP directory. The vm-manager will be updated in version 1.4.0).
# This is where the global hostname related settings for the stoney cloud environment are stored. dn: ou=hostname,ou=settings,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstHostnameDefinitionObjectClass ou: hostname description: This sub tree defines pre-formated hostnames in the form of kvm-%04d. Together with the domain name, this gives you kvm-0000.example.org to kvm-9999.example.org. sstNetworkDomainName: example.org sstNetworkHostnameFormat: kvm-%04d sstNetworkHostnameNextFreeNumber: 1
RDP
The sub tree ou=rdp,ou=settings,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org contains the RDP related default settings for the whole stoney cloud installation (since version 1.2.0). They can be changed by the administrator.
# This is where the global RDP related settings for the stoney cloud environment are stored. dn: ou=rdp,ou=settings,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstVirtualizationSettingsObjectClass ou: rdp description: This sub tree contains the RDP related default settings for the whole stoney cloud. sstAllowRDP: FALSE
Sound
The sub tree ou=sound,ou=settings,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org contains the Sound related default settings for the whole stoney cloud installation (since version 1.2.0). They can be changed by the administrator.
# This is where the global Sound related settings for the stoney cloud environment are stored. dn: ou=sound,ou=settings,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstVirtualizationSettingsObjectClass ou: sound description: This sub tree contains the Sound related default settings of the stoney cloud. sstAllowSound: TRUE
Spice
The sub tree ou=spice,ou=settings,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org contains the Spice related default settings for the whole stoney cloud installation (since version 1.2.0). They can be changed by the administrator.
# This is where the global Spice related settings for the stoney cloud environment are stored. dn: ou=spice,ou=settings,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstVirtualizationSettingsObjectClass ou: spice description: This sub tree contains the Spice related default settings of the stoney cloud. sstAllowSpice: TRUE sstSpicePortMin: 5900 sstSpicePortMax: 5999
USB
The sub tree ou=usb,ou=settings,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org contains the USB related default settings for the whole stoney cloud installation (since version 1.2.0). They can be changed by the administrator.
# This is where the global USB related settings for the stoney cloud environment are stored. dn: ou=usb,ou=settings,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstVirtualizationSettingsObjectClass ou: usb description: This sub tree contains the USB related default settings of the stoney cloud. sstAllowUSB: FALSE
VNC
The sub tree ou=vnc,ou=settings,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org contains the VNC related default settings for the whole stoney cloud installation (since version 1.2.0). They can be changed by the administrator.
# This is where the global VNC related settings for the stoney cloud environment are stored. dn: ou=vnc,ou=settings,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstVirtualizationSettingsObjectClass ou: vnc description: This sub tree contains the VNC related default settings of the stoney cloud. sstAllowVNC: FALSE
Storage Pools
The stoney cloud environment has the following storage pools
- catalogue: This is where the global VM-Templates of the stoney cloud environment are stored. These can be used as a base for users VM-Templates.
- iso: This is where ISO-files of the stoney cloud environment are stored.
- iso-choosable: This is where the user uploads his or her ISO-files into the stoney cloud environment.
- vm-dynamic: This is where the dynamic VM's of the stoney cloud environment are stored.
- vm-persistent: This is where the static VM's of the stoney cloud environment are stored.
- vm-templates: This is where the VM-Templates of the stoney cloud environment are stored.
The sub tree ou=storage pools,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org contains the storage pools configuration information of the stoney cloud.
The attribure sstStoragePoolType can consist of one of the following values:
- catalogue: Read only storage pool, used for the global VM-Templates of the stoney cloud environment
- dynamic: Storage pool for the dynamic VM's.
- iso: Read only storage pool for the ISO-files.
- static: Storage pool for the static VM's.
- template: Storage pool for the VM-Templates.
The catalogue entry is defined as follows:
dn: ou=catalogue,ou=storage pools,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstStoragePoolConfigurationObjectClass ou: catalogue sstStoragePoolURI: file:///var/virtualization/catalogue sstStoragePoolType: catalogue
The iso entry is defined as follows:
dn: ou=iso,ou=storage pools,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstStoragePoolConfigurationObjectClass ou: iso sstStoragePoolURI: file:///var/virtualization/iso sstStoragePoolType: iso
The iso-choosable entry is defined as follows:
dn: ou=iso-choosable,ou=storage pools,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstStoragePoolConfigurationObjectClass ou: iso-choosable sstStoragePoolURI: file:///var/virtualization/iso-choosable sstStoragePoolType: iso
The vm-dynamic entry is defined as follows:
dn: ou=vm-dynamic,ou=storage pools,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstStoragePoolConfigurationObjectClass ou: vm-dynamic sstStoragePoolURI: file:///var/virtualization/vm-dynamic sstStoragePoolType: dynamic
The vm-persistent entry is defined as follows:
dn: ou=vm-persistent,ou=storage pools,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstStoragePoolConfigurationObjectClass ou: vm-persistent sstStoragePoolURI: file:///var/virtualization/vm-persistent sstStoragePoolType: static
The vm-templates entry is defined as follows:
dn: ou=vm-templates,ou=storage pools,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstStoragePoolConfigurationObjectClass ou: vm-templates sstStoragePoolURI: file:///var/virtualization/vm-templates sstStoragePoolType: template
Version
The entry ou=version,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org contains the version UUID of the stoney cloud installation.
Virtual Machine Pools
The stoney cloud environment has a Broker (Daemon), which is responsible for the proper distribution of virtual machines in the stoney cloud installation. This broker needs to be configured globally (distribution algorithm) and locally for each virtual machine pool . The distribution algorithm is stored in the attribute sstBrokerAlgorithm and can have one of the following values:
- load: The distribution of virtual machines is based on the cpu load, memory usage and disk input/output of the VM-Nodes. This option is not implemented and planned for the near future.
- quantity: The distribution of virtual machines is based on the number of virtual machines running on the VM-Nodes.
The entry ou=virtual machine pools,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org contains the virtual machine pools configuration information of the stoney cloud and has the distribution algorithm set to quantity (which is the default value for the near future):
dn: ou=virtual machine pools,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstVirtualMachinePoolBrokerConfigurationObjectClass ou: virtual machine pools sstBrokerAlgorithm: quantity
Below the sub tree ou=virtual machine pools,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org we have the following virtual machine pool configurations:
- dynamic: This is where the definitions of the dynamic virtual machine pools of the stoney cloud environment are stored.
- sstBrokerMinimalNumberOfVirtualMachines: The minimal number of virtual machines as an integer value, that need to pre started in a dynamic virtual machine pool through the broker (for example: 5).
- sstBrokerMaximalNumberOfVirtualMachines: The maximal number of virtual machines as an integer value, that are allowed to be started through the broker in a dynamic virtual machine pool (for example: 50).
- sstBrokerPreStartNumberOfVirtualMachines: The number of virtual machines as an integer value, that need to pre started in a dynamic virtual machine pool through the broker (for example: 3).
- static: This is where the definitions of the static (persistent) virtual machine pools of the stoney cloud environment are stored.
- template: This is where the definitions of the template virtual machine pools of the stoney cloud environment are stored.
The dynamic entry is defined as follows. It presumes that we should have a minimal number of 5 virtual machines runnning at all time. We need to pre start 3 virtual machines and we can have a maximum number of 20 virtual machines:
dn: ou=dynamic,ou=virtual machine pools,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstVirtualMachinePoolConfigurationObjectClass ou: dynamic sstBrokerMinimalNumberOfVirtualMachines: 5 sstBrokerMaximalNumberOfVirtualMachines: 20 sstBrokerPreStartNumberOfVirtualMachines: 3
The static entry is defined as follows:
dn: ou=static,ou=virtual machine pools,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit ou: static
The template entry is defined as follows:
dn: ou=template,ou=virtual machine pools,ou=configuration,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit ou: template
Networks (Network-Pools)
Im Subtree ou=networks,ou=virtualization,ou=services,dc=stoney-cloud,dc=org werden die Network-Pools für die virtuelle Desktop- und Server-Infrastruktur abgebildet. Pro Network-Pool gibt es zwei verschiede IP-Range Typen:
- Statischer IP-Range (es werden den VM's fixe IP-Adressen manuell via VM-Manager Web-Interface verteilt)
- Dynamischer IP-Range (die IP-Adressen werden vom VM-Manager automatisch verteilt)
Aus Sicht des DHCP-Servers sind alle IP-Addressen statisch (fix). Der VM-Manager soll den gesammten Lifecycle einer virtuellen Maschine unter seiner Hoheit haben.
Das nachfolgende LDIF zeigt den Subtree ou=networks,ou=virtualization,ou=services,o=stepping-stone,c=ch:
dn: ou=networks,ou=virtualization,ou=services,o=stepping-stone,c=ch description: This subtree contains the network pools for the virtualization environment. objectclass: top objectclass: organizationalUnit ou: networks
dn: ou=dhcp,ou=networks,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit ou: dhcp
Networks (Network-Pools): DHCP-Server
Das nachfolgende LDIF zeigt den Eintrag vom ersten DHCP-Server cn=dhcp-01.stepping-stone.ch,ou=networks,ou=virtualization,ou=services,o=stepping-stone,c=ch:
dn: cn=dhcp-01,ou=dhcp,ou=networks,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: dhcpServer cn: dhcp-01 dhcpServerDN: cn=config-01,ou=dhcp,ou=networks,ou=virtualization,ou=services,dc=stoney-cloud,dc=org
Mit dem Attribut dhcpServerDN wird auf die dazugehörige DHCP-Konfiguration verwiesen.
Networks (Network-Pools): DHCP-Konfiguration
Der Eintrag cn=config-01,ou=dhcp,ou=networks,ou=virtualization,ou=services,dc=stoney-cloud,dc=org ist gleichzeitig ein Subtree sowie ein normales Leaf.
Der nachfolgen LDIF-Auszug zeigt die DHCP-Konfiguration auf der im DHCP-Server dhcp-01.stepping-stone.ch verwiesen wird:
dn: cn=config-01,ou=dhcp,ou=networks,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: dhcpService cn: config-01 dhcpPrimaryDN: cn=dhcp-01,ou=dhcp,ou=networks,ou=virtualization,ou=services,dc=stoney-cloud,dc=org
Mit dem Attribut dhcpPrimaryDN wird auf den ersten (primary) DHCP-Server referenziert.
Networks (Network-Pools): Network-Pool (Example with network-pool-01)
Auf dem DHCP-Server dhcp-01 ist ein erster Netzwork-Pool konfiguriert:
dn: cn=172.31.255.0,cn=config-01,ou=dhcp,ou=networks,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: dhcpSubnet objectclass: dhcpOptions objectclass: sstVirtualizationNetwork cn: 172.31.255.0 sstDisplayName: network-pool-01 description: This is the first network for which the DHCP server is responsible. All default DHCP options and statements are defined within this entry. dhcpnetmask: 24 dhcpoption: domain-name "example.com" dhcpoption: domain-name-servers 172.31.255.1 dhcpoption: routers 172.31.255.1 dhcpoption: broadcast-address 172.31.255.255 dhcpoption: ip-forwarding false dhcpoption: ntp-servers 0.ch.pool.ntp.org,1.ch.pool.ntp.org,2.ch.pool.ntp.org dhcpoption: router-discovery false dhcpstatements: authoritative dhcpstatements: default-lease-time 3600 dhcpstatements: min-lease-time 600 dhcpstatements: max-lease-time 43200 dhcpstatements: ddns-update-style none dhcpstatements: ddns-updates off dhcpstatements: ping-check false sstNetfilterInterfaceAlias: pub sstSourceBridge: vmbr0 sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001
Der LDIF-Auszug liest sich wie folgt:
| AttributeType | Existence | Mandatory | Description | Changeable via Web-Interface |
|---|---|---|---|---|
| cn: 194.176.109.64 | |
Netz-Adresse (erste IP-Adresse vom gewünschten Netz-Block). | ja (erst ab Version 0.8.0) | |
| dhcpNetMask: 26 | |
|
Subnet-Mask (im CIDR-Format). | ja (erst ab Version 0.8.0) |
| dhcpOption: routers 194.176.109.65 | |
|
Default Gateway (in der Regel ist dies die erste freie IP-Adresse vom Netz-Block (cn+1)). | ja (ab Version 0.6.3) |
| dhcpOption: broadcast-address 194.176.109.127 | |
|
Broadcast (in der Regel ist dies die letzte IP-Adresse vom Netz-Block (cn). | ja (ab Version 0.6.3) |
| dhcpOption: domain-name "stepping-stone.ch" | |
|
Domain Name (Default ist stepping-stone.ch, andere Namen sind möglich). | ja (ab Version 0.6.3) |
| dhcpOption: domain-name-servers 194.176.109.202, 195.141.111.109 | |
|
DNS-Server(s) (die zwei IP-Adressen entsprechen ns-rec-01.stepping-stone.ch und ns-rec-02.stepping-stone.ch). | ja (ab Version 0.6.3) |
| dhcpOption: ntp-server ntp-01.stepping-stone.ch,ntp-02.stepping-stone.ch,ntp-03.stepping-stone.ch | |
|
NTP-Server (die stepping stone GmbH hat aktuelle drei eigene NTP-Server im Einsatz). | ja (ab Version 0.6.3) |
| dhcpRange: 194.176.109.117 194.176.109.120 | |
|
DHCP-Range (hier wird die jeweils die erste und letzte IP-Adresse vom geünschten IP-Range angegeben). Es können prinzipiell mehrer DHCP-Ranges angegeben werden. Über die Verteilung der DHCP-Leases kann jedoch kein Einfluss genommen werden. | nein (wird nicht verwendent, da alle IPs fix vergeben werden) |
| sstNetfilterInterfaceAlias: pub | |
|
The netfilter interface alias, for example: pub or pub2. | no |
| sstSourceBridge: vmbr0 | |
|
The name of the bridge (for example vmbr0). | no |
Dieser IP-Range ist wie folgt unterteilt:
Development Office Customer Internal Servers External Servers
I--------------------------------I--------------------------------I----------------I----------------I--------------------------------I
dn: cn=172.31.255.0/26,ou=ranges,cn=172.31.255.0,cn=config-01,ou=dhcp,ou=networks,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstVirtualizationNetworkRange cn: 172.31.255.0/26 sstDisplayName: Development description: This ip ranges consists the development desktops with static ip addresses. sstNetworkType: static
dn: cn=172.31.255.64/26,ou=ranges,cn=172.31.255.0,cn=config-01,ou=dhcp,ou=networks,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstVirtualizationNetworkRange cn: 172.31.255.64/26 sstDisplayName: Office description: This ip ranges consists the office desktops with dynamic ip addresses. sstNetworkType: dynamic
dn: cn=172.31.255.128/27,ou=ranges,cn=172.31.255.0,cn=config-01,ou=dhcp,ou=networks,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstVirtualizationNetworkRange cn: 172.31.255.128/27 sstDisplayName: Customer description: This ip ranges consists the customer desktops with dynamic ip addresses. sstNetworkType: dynamic
dn: cn=172.31.255.160/27,ou=ranges,cn=172.31.255.0,cn=config-01,ou=dhcp,ou=networks,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstVirtualizationNetworkRange cn: 172.31.255.160/27 sstDisplayName: Internal Servers description: This ip ranges consists the internal servers with static ip addresses. sstNetworkType: static
dn: cn=172.31.255.192/26,ou=ranges,cn=172.31.255.0,cn=config-01,ou=dhcp,ou=networks,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstVirtualizationNetworkRange cn: 172.31.255.192/26 sstDisplayName: External Servers description: This ip ranges the external servers with static ip addresses. sstNetworkType: static
Networks (Network-Pools): Virtual Machines
dn: ou=virtual machines,cn=172.31.255.0,cn=config-01,ou=dhcp,ou=networks,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit ou: virtual machines description: This subtree holds all static MAC address to IP mappings.
Networks (Network-Pools): Virtual Machine
The following LDIF entry shows the virtual machine kvm-0001.tombstone.ch with the static ip address 192.168.140.130. In the stoney cloud version 1.2.0 the entry dhcpStatements: option host-name "kvm-0001.tombstone.ch" has been added. The vm-manager will provision this entry in the next stoney cloud version 1.4.0.
dn: cn=b543f88f-dffe-426f-86d3-c7ff85c16d2a,ou=virtual machines,cn=192.168.140.0,cn=config-01,ou=dhcp,ou=networks,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: dhcpHost objectclass: sstVirtualizationNetwork cn: b543f88f-dffe-426f-86d3-c7ff85c16d2a dhcpHWAddress: ethernet 52:54:00:48:e4:1e dhcpStatements: fixed-address 192.168.140.130 dhcpStatements: option host-name "kvm-0001.tombstone.ch" sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 sstBelongsToPersonUID: 4000002
Nodes
The sub tree ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org contains all the nodes for the stoney cloud virtualization environment. The following LDIF extract shows the definition of the subtree.
dn: ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit ou: nodes description: This subtree contains all the nodes for the virtualization environment.
Example (carrier-hosting-11.test.stoney-cloud.org)
The following LDIF extract shows the example of the physical node called carrier-hosting-11.test.stoney-cloud.org. It belongs to the customer "stepping stone GmbH" (sstBelongsToCustomerUID=3723426). The customer "stepping stone GmbH" belongs to the reseller "stepping stone GmbH" (sstBelongsToResellerUID=2000000).
dn: sstNode=carrier-hosting-11.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstVirtualizationNode objectclass: sstRelationship objectclass: labeledURIObject sstNode: carrier-hosting-11.test.stoney-cloud.org description: The node carrier-hosting-11.test.stoney-cloud.org. labeledURI: ldap:///ou=virtual machines,ou=virtualization,ou=services,dc=stoney-cloud,dc=org??sub?(sstNode=carrier-hosting-11.test.stoney-cloud.org) sstBelongsToResellerUID: 2000000 sstBelongsToCustomerUID: 3723426
The same VLANs (networks) mentioned above in the chapter Networks are used here as well. The physical node needs an IP-address in each VLAN (network). The following example shows the IP-address for the physical node carrier-hosting-11.test.stoney-cloud.org with the IP-address 192.168.17.85 in the admin VLAN.
# admin: Administrative network, used for administration and monitoring purposes. # 192.168.17.0/24 # 192.168.17.1 Default Gateway # 192.168.17.255 Broadcast # VLAN: 1799 # data: Data network, used for GlusterFS (in later versions NFS and Ceph as well) traffic. # 10.17.97.0/24 # 10.17.97.1 Default Gateway # 10.17.97.255 Broadcast # VLAN: 1797 # int: Internal network, used for internal traffic such as LDAP, libvirt and more. # 10.17.98.0/24 # 10.17.98.1 Default Gateway # 10.17.98.255 Broadcast # VLAN: 1798 # pub: Public network, used for accessing the VM-Manager web interface, Spice traffic and internet access. # 31.216.40.0/24 # 31.216.40.1 Default Gateway # 31.216.40.255 Broadcast # VLAN: 1701
The networks have their own subtree:
# networks: The subtree for the four networks. dn: ou=networks,sstNode=carrier-hosting-11.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit ou: networks description: This subtree contains the network information.
The admin network:
# admin: Administrative network, used for administration and monitoring purposes. dn: ou=admin,ou=networks,sstNode=carrier-hosting-11.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstNetworkNode ou: admin description: Administrative network, used for administration and monitoring purposes. sstNetworkIPAddress: 192.168.17.85 # sshd: OpenSSH is used for remote management and access. dn: sstService=sshd,ou=admin,ou=networks,sstNode=carrier-hosting-11.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstServicesNode sstService: sshd description: OpenSSH is used for remote management and access. sstDisplayName: OpenSSH daemon
The data network:
# data: Data network, used for GlusterFS (in later versions NFS and Ceph as well) traffic. dn: ou=data,ou=networks,sstNode=carrier-hosting-11.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstNetworkNode ou: data description: Data network, used for GlusterFS (in later versions NFS and Ceph as well) traffic. sstNetworkIPAddress: 10.17.97.85
# glusterd: The GlusterFS File service is used as the virtual machine storage. dn: sstService=glusterd,ou=data,ou=networks,sstNode=carrier-hosting-11.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstServicesNode sstService: glusterd description: The GlusterFS File service is used as the virtual machine storage. sstDisplayName: GlusterFS File Service
The internal network:
# int: Internal network, used for internal traffic such as LDAP, libvirt and more. dn: ou=int,ou=networks,sstNode=carrier-hosting-11.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstNetworkNode ou: int description: Internal network, used for internal traffic such as LDAP, libvirt and more. sstNetworkIPAddress: 10.17.98.85 # libvirtd: The libvirtd daemon is used for the administration of the virtual servers. dn: sstService=libvirtd,ou=int,ou=networks,sstNode=carrier-hosting-11.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstServicesNode sstService: libvirtd description: The libvirtd daemon is used for the administration of the virtual servers. sstDisplayName: libvirtd Service # slapd: The OpenLDAP directory is used for the storage of all service related data. dn: sstService=slapd,ou=int,ou=networks,sstNode=carrier-hosting-11.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstServicesNode sstService: slapd description: The OpenLDAP directory is used for the storage of all service related data. sstDisplayName: OpenLDAP Primary Master sstNetworkHostname: ldapm-01
The public network:
# pub: Public network, used for accessing the VM-Manager web interface, Spice traffic and internet access. dn: ou=pub,ou=networks,sstNode=carrier-hosting-11.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstNetworkNode ou: pub description: Public network, used for accessing the VM-Manager web interface, Spice traffic and internet access. sstNetworkIPAddress: 31.216.40.4 # apache2: The Apache web server is used for the VM-Manager web interface. dn: sstService=apache2,ou=pub,ou=networks,sstNode=carrier-hosting-11.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstServicesNode sstService: apache2 description: The Apache web server is used for the VM-Manager web interface. sstDisplayName: VM-Manager Service sstNetworkHostname: vm-manager # dhcpd: The DHCP server is used for the distribution of IP addresses. dn: sstService=dhcpd,ou=pub,ou=networks,sstNode=carrier-hosting-11.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstServices sstService: dhcpd description: The DHCP server is used for the distribution of IP addresses. sstNetworkVirtualHostname: dhcpd sstDisplayName: DHCP Service # qemu-system-x86_64: The QEMU (spice) service is used for the interaction with virtualized desktop devices. dn: sstService=qemu-system-x86_64,ou=pub,ou=networks,sstNode=carrier-hosting-11.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstServicesNode sstService: qemu-system-x86_64 description: The QEMU (spice) service is used for the interaction with virtualized desktop devices. sstDisplayName: QEMU (spice) Service # sshd: OpenSSH is used for remote management and access. dn: sstService=sshd,ou=pub,ou=networks,sstNode=carrier-hosting-11.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstServicesNode sstService: sshd description: OpenSSH is used for remote management and access. sstDisplayName: OpenSSH daemon
In our example, we have a node which actually consists of two different node types:
- Primary-Master-Node
- Storage-Node
# node-types: The subtree for the node type definition(s). dn: ou=node-types,sstNode=carrier-hosting-11.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit ou: node-types description: This subtree contains the node type definition(s). # This is the first node of a multi-node installation. dn: sstNodeType=Primary-Master-Node,ou=node-types,sstNode=carrier-hosting-11.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstTypeNode sstNodeType: Primary-Master-Node sstNodeSubtype: KVM description: This is the first node of a multi-node installation. sstDisplayName: Primary-Master-Node sstNodeState: active # The Storage-Node is used to store all the images (VM-Profiles, VM-Templates and VMs). dn: sstNodeType=Storage-Node,ou=node-types,sstNode=carrier-hosting-11.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstTypeNode sstNodeType: Storage-Node sstNodeSubtype: GlusterFS description: The Storage-Node is used to store all the images (VM-Profiles, VM-Templates and VMs). sstDisplayName: Storage-Node sstNodeState: active
The following table explains each attribute with the possible values.
Object Class sstVirtualizationNode:
| AttributeType | Existence | Mandatory | Description | Changeable via Web-Interface |
|---|---|---|---|---|
| sstNode: carrier-hosting-11.test.stoney-cloud.org | |
|
The name of a physical node. Either the Fully Qualified Domain Name (FQDN) for public clouds or just the Host Name (without the Domain part) for private clouds. | Version 0.6.3 or higher. |
| description: The node carrier-hosting-11.test.stoney-cloud.org. | |
|
A short human readable description of the physical node. | Version 0.6.3 or higher. |
Object Class sstRelationship:
| AttributeType | |
|
Description
|
| sstBelongsToCustomerUID | |
|
Die UID des Kunden zu der die Node gehört. |
| sstBelongsToResellerUID | |
|
Die UID des Wiederverkäufers zu der die Node gehört. |
| sstBillingUID | |
Die Verrechnungs-UID. Je nach Verrechnungs-Modell wird diese UID benötigt oder auch nicht. | |
| sstBelongsToPersonUID | |
Die UID der Person zu der die Node gehört. Es macht in der Regel keinen Sinn, eine Node einer Person zuzuweisen. |
Object Class labeledURIObject:
| AttributeType | |
|
Description |
| labeledURI | |
|
Automatische Auflistung alle virtuellen Maschinen auf diesem Node. Zum Beispiel: ldap:///ou=virtual machines,ou=virtualization,ou=services,o=stepping-stone,c=ch??sub?(sstNode=carrier-hosting-09) |
Virtual Machine Pools (VM-Pools)
The virtual machine pools are stored in and below the ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org sub tree (since version 1.0.0 ou=virtual machine-pools has been renamed to ou=virtual machine pools).
dn: ou=virtual machine-pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit ou: virtual machine-pools description: This subtree contains the logical virtual machine pools for the virtualization environment.
Currenty (as of Version 1.0.0) we have three default virtual machine pools that are delivered with the stoney cloud:
- VM-template Virtual Machine Pool: This is where you can start your VM-templates.
- Static Virtual Machine Pool: This is where you can start your static virtual machines.
- Dynamic Virtual Machine Pool: This is where you can start your dynamic virtual machines.
All three have in common, that the primary master node is included in each virtual machine pool and they all have their proper storage pool defined after the installation of the primary master node. The network range is missing in all three virtual machine pools, because we don't know these at the time of the installation of the primary master node.
VM-Template Virtual Machine Pool
The following example presumes, that your primary master node is called carrier-hosting-12.test.stoney-cloud.org:
dn: sstVirtualMachinePool=40fac639-c69d-43b0-817c-dbbf3fd161fc,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstVirtualMachines objectclass: sstRelationship sstVirtualMachinePool: 40fac639-c69d-43b0-817c-dbbf3fd161fc sstDisplayName: vm-template-virtual-machine-pool-01 description: This is the default vm-template virtual machine pool vm-template-virtual-machine-pool-01. sstVirtualMachinePoolType: template sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 dn: ou=nodes,sstVirtualMachinePool=40fac639-c69d-43b0-817c-dbbf3fd161fc,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstRelationship ou: nodes description: This sub tree stores all the nodes belonging to default vm-template virtual machine pool vm-template-virtual-machine-pool-01. sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 dn: ou=carrier-hosting-12.test.stoney-cloud.org,ou=nodes,sstVirtualMachinePool=40fac639-c69d-43b0-817c-dbbf3fd161fc,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: labeledURIObject objectclass: sstRelationship ou: carrier-hosting-12.test.stoney-cloud.org description: This entry links to the node carrier-hosting-12.test.stoney-cloud.org. labeledURI: ldap:///sstNode=carrier-hosting-12.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 dn: ou=storage pools,sstVirtualMachinePool=40fac639-c69d-43b0-817c-dbbf3fd161fc,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstRelationship ou: storage pools description: This sub tree stores all the storage pools belonging to default vm-template virtual machine pool vm-template-virtual-machine-pool-01 (normally just one storage pool). sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 dn: ou=5b77d2f6-061f-410c-8ee7-9e61da6f1927,ou=storage pools,sstVirtualMachinePool=40fac639-c69d-43b0-817c-dbbf3fd161fc,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: labeledURIObject objectclass: sstRelationship ou: 5b77d2f6-061f-410c-8ee7-9e61da6f1927 description: This entry links to the vm-template storage pool 5b77d2f6-061f-410c-8ee7-9e61da6f1927. labeledURI: ldap:///sstStoragePool=5b77d2f6-061f-410c-8ee7-9e61da6f1927,ou=storage pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 dn: ou=ranges,sstVirtualMachinePool=40fac639-c69d-43b0-817c-dbbf3fd161fc,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstRelationship ou: ranges description: This sub tree stores all the ranges belonging to default vm-template virtual machine pool vm-template-virtual-machine-pool-01. sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 dn: ou=virtual machines,sstVirtualMachinePool=40fac639-c69d-43b0-817c-dbbf3fd161fc,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstRelationship ou: virtual machines description: This sub tree stores all the virtual machines belonging to default vm-template virtual machine pool vm-template-virtual-machine-pool-01. sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001
Static Virtual Machine Pool
The following example presumes, that your primary master node is called carrier-hosting-12.test.stoney-cloud.org:
dn: sstVirtualMachinePool=d9c3cc0c-9ae7-40e5-8fb7-ba5297e835aa,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstVirtualMachines objectclass: sstRelationship sstVirtualMachinePool: d9c3cc0c-9ae7-40e5-8fb7-ba5297e835aa sstDisplayName: static-virtual-machine-pool-01 description: This is the default static virtual machine pool static-virtual-machine-pool-01. sstVirtualMachinePoolType: static sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 dn: ou=nodes,sstVirtualMachinePool=d9c3cc0c-9ae7-40e5-8fb7-ba5297e835aa,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstRelationship ou: nodes description: This sub tree stores all the nodes belonging to default static virtual machine pool static-virtual-machine-pool-01. sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 dn: ou=carrier-hosting-12.test.stoney-cloud.org,ou=nodes,sstVirtualMachinePool=d9c3cc0c-9ae7-40e5-8fb7-ba5297e835aa,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: labeledURIObject objectclass: sstRelationship ou: carrier-hosting-12.test.stoney-cloud.org description: This entry links to the node carrier-hosting-12.test.stoney-cloud.org. labeledURI: ldap:///sstNode=carrier-hosting-12.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 dn: ou=storage pools,sstVirtualMachinePool=d9c3cc0c-9ae7-40e5-8fb7-ba5297e835aa,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstRelationship ou: storage pools description: This sub tree stores all the storage pools belonging to default static virtual machine pool static-virtual-machine-pool-01 (normally just one storage pool). sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 dn: ou=0f83f084-8080-413e-b558-b678e504836e,ou=storage pools,sstVirtualMachinePool=d9c3cc0c-9ae7-40e5-8fb7-ba5297e835aa,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: labeledURIObject objectclass: sstRelationship ou: 0f83f084-8080-413e-b558-b678e504836e description: This entry links to the vm storage pool 0f83f084-8080-413e-b558-b678e504836e. labeledURI: ldap:///sstStoragePool=0f83f084-8080-413e-b558-b678e504836e,ou=storage pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 dn: ou=ranges,sstVirtualMachinePool=d9c3cc0c-9ae7-40e5-8fb7-ba5297e835aa,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstRelationship ou: ranges description: This sub tree stores all the ranges belonging to default static virtual machine pool static-virtual-machine-pool-01. sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 dn: ou=virtual machines,sstVirtualMachinePool=d9c3cc0c-9ae7-40e5-8fb7-ba5297e835aa,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstRelationship ou: virtual machines description: This sub tree stores all the virtual machines belonging to default static virtual machine pool static-virtual-machine-pool-01. sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001
Dynamic Virtual Machine Pool
The following example presumes, that your primary master node is called carrier-hosting-12.test.stoney-cloud.org. In a fully configures dynamic virtual machine pool with an active Golden-Image, we would have the sstActiveGoldenImage: UUID entry (UUID would be replaced by the proper Universally Unique Identifier of the Golden-Image) directly in the sstVirtualMachinePool=dbd81080-d9f8-42e2-a261-d56b80c9c528,ou=vi... entry:
dn: sstVirtualMachinePool=dbd81080-d9f8-42e2-a261-d56b80c9c528,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstVirtualMachines objectclass: sstVirtualMachinePoolDynamicObjectClass objectclass: sstRelationship sstVirtualMachinePool: dbd81080-d9f8-42e2-a261-d56b80c9c528 sstDisplayName: dynamic-virtual-machine-pool-01 description: This is the default dynamic virtual machine pool dynamic-virtual-machine-pool-01. sstVirtualMachinePoolType: dynamic sstBrokerMinimalNumberOfVirtualMachines: 5 sstBrokerMaximalNumberOfVirtualMachines: 20 sstBrokerPreStartNumberOfVirtualMachines: 3 sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 dn: ou=nodes,sstVirtualMachinePool=dbd81080-d9f8-42e2-a261-d56b80c9c528,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstRelationship ou: nodes description: This sub tree stores all the nodes belonging to default dynamic virtual machine pool dynamic-virtual-machine-pool-01. sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 dn: ou=carrier-hosting-12.test.stoney-cloud.org,ou=nodes,sstVirtualMachinePool=dbd81080-d9f8-42e2-a261-d56b80c9c528,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: labeledURIObject objectclass: sstRelationship ou: carrier-hosting-12.test.stoney-cloud.org description: This entry links to the node carrier-hosting-12.test.stoney-cloud.org. labeledURI: ldap:///sstNode=carrier-hosting-12.test.stoney-cloud.org,ou=nodes,ou=virtualization,ou=services,dc=stoney-cloud,dc=org sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 dn: ou=storage pools,sstVirtualMachinePool=dbd81080-d9f8-42e2-a261-d56b80c9c528,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstRelationship ou: storage pools description: This sub tree stores all the storage pools belonging to default dynamic virtual machine pool dynamic-virtual-machine-pool-01 (normally just one storage pool). sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 dn: ou=c92851ab-ec8e-4eba-b60d-96cf3f72fd02,ou=storage pools,sstVirtualMachinePool=dbd81080-d9f8-42e2-a261-d56b80c9c528,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: labeledURIObject objectclass: sstRelationship ou: c92851ab-ec8e-4eba-b60d-96cf3f72fd02 description: This entry links to the vm storage pool c92851ab-ec8e-4eba-b60d-96cf3f72fd02. labeledURI: ldap:///sstStoragePool=c92851ab-ec8e-4eba-b60d-96cf3f72fd02,ou=storage pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 dn: ou=ranges,sstVirtualMachinePool=dbd81080-d9f8-42e2-a261-d56b80c9c528,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstRelationship ou: ranges description: This sub tree stores all the ranges belonging to default dynamic virtual machine pool dynamic-virtual-machine-pool-01. sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 dn: ou=virtual machines,sstVirtualMachinePool=dbd81080-d9f8-42e2-a261-d56b80c9c528,ou=virtual machine pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstRelationship ou: virtual machines description: This sub tree stores all the virtual machines belonging to default dynamic virtual machine pool dynamic-virtual-machine-pool-01. sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001
Storage Pools
The sub tree ou=storage pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org contains all the storage pools for the virtualization environment.
The following LDIF extract shows the sub tree ou=storage pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org:
dn: ou=storage pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit ou: storage pools description: This sub tree contains all the storage pools for the virtualization environment.
Template Storage Pool
The following LDIF extract shows the entry with the default template storage pool template-storage-pool-01 that is already set up when the stoney cloud is installed:
dn: sstStoragePool=5b77d2f6-061f-410c-8ee7-9e61da6f1927,ou=storage pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstStoragePoolObjectClass objectclass: sstRelationship sstStoragePool: 5b77d2f6-061f-410c-8ee7-9e61da6f1927 sstStoragePoolURI: file:///var/virtualization/vm-templates/5b77d2f6-061f-410c-8ee7-9e61da6f1927 sstStoragePoolType: template sstDisplayName: template-storage-pool-01 description: This is the default template storage pool template-storage-pool-01. sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001
Static Storage Pool
The following LDIF extract shows the entry with the default static storage pool static-storage-pool-01 that is already set up when the stoney cloud is installed:
dn: sstStoragePool=0f83f084-8080-413e-b558-b678e504836e,ou=storage pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstStoragePoolObjectClass objectclass: sstRelationship sstStoragePool: 0f83f084-8080-413e-b558-b678e504836e sstStoragePoolURI: file:///var/virtualization/vm-persistent/0f83f084-8080-413e-b558-b678e504836e sstStoragePoolType: static sstDisplayName: static-storage-pool-01 description: This is the default static storage pool static-storage-pool-01. sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001
Dynamic Storage Pool
The following LDIF extract shows the entry with the default dynamic storage pool dynamic-storage-pool-01 that is already set up when the stoney cloud is installed:
dn: sstStoragePool=c92851ab-ec8e-4eba-b60d-96cf3f72fd02,ou=storage pools,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstStoragePoolObjectClass objectclass: sstRelationship sstStoragePool: c92851ab-ec8e-4eba-b60d-96cf3f72fd02 sstStoragePoolURI: file:///var/virtualization/vm-dynamic/c92851ab-ec8e-4eba-b60d-96cf3f72fd02 sstStoragePoolType: dynamic sstDisplayName: dynamic-storage-pool-01 description: This is the default dynamic storage pool dynamic-storage-pool-01. sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001
Virtual Machines Profiles
Im Subtree ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch befinden sich die Profile der aller virtuellen Maschinen. Pro Betriebssystem gibt es ein Default-Profile, welche als Grundlage für alle weiteren Profile dienen.
Das nachfolgende LDIF zeigt den Subtree ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch:
dn: ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch objectclass: top objectclass: organizationalUnit ou: virtual machine profiles description: This subtree contains all the profiles to create virtual machine templates in the virtualization environment.
Pro Betriebssystem gibt es jeweils noch einen weiteren Subtree. Aktuell sind Linux und Windows aufgenommen. Weitere Betriebssysteme können nach Bedarf ergänzt werden. Die nachfolgenden LDIF-Auszüge zeigen den Linux- und den Windows-Subtree:
dn: ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch objectclass: top objectclass: organizationalUnit ou: linux description: This subtree contains all the Linux related profiles to create virtual machine templates in the virtualization environment.
dn: ou=windows,ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch objectclass: top objectclass: organizationalUnit ou: windows description: This subtree contains all the Windows related profiles to create virtual machine templates in the virtualization environment.
Linux Default VM-Profil
Das nachfolgende LDIF zeigt das komplette Linux Default VM-Profil:
dn: ou=default,ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch objectclass: top objectclass: organizationalUnit ou: default description: This is the default Linux VM-Profile subtree (operating system name level). dn: ou=default,ou=default,ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch objectclass: top objectclass: organizationalUnit objectclass: sstVirtualizationProfileArchitectureDefaults ou: default description: This is the default Linux VM-Profile subtree (architecture level). sstOSArchitectureDefault: x86_64 sstOSArchitectureValues: i686 sstOSArchitectureValues: x86_64 dn: ou=default,ou=default,ou=default,ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch objectclass: top objectclass: organizationalUnit objectclass: sstVirtualizationProfileLanguageDefaults ou: default description: This is the default Linux VM-Profile subtree (language level). sstLanguageDefault: multi sstLanguageValues: de-DE sstLanguageValues: de-AT sstLanguageValues: de-CH sstLanguageValues: en-US sstLanguageValues: en-GB sstLanguageValues: fr-CH sstLanguageValues: fr-FR sstLanguageValues: it-CH sstLanguageValues: it-IT dn: sstVirtualMachine=default,ou=default,ou=default,ou=default,ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch objectclass: top objectclass: sstVirtualizationVirtualMachine objectclass: sstVirtualizationVirtualMachineDefaults sstVirtualMachine: default sstDisplayName: TBD_GUI description: TBD_GUI sstMemory: -1 sstVCPU: -1 sstStatus: TBD_SYSTEM sstNode: TBD_GUI sstType: kvm sstOSArchitecture: TBD_GUI sstOSMachine: pc-0.13 sstOSType: hvm sstOSBootDevice: cdrom sstFeature: acpi sstFeature: pae sstClockOffset: TBD_GUI sstMemoryDefault: 134217728 sstMemoryMin: 134217728 sstMemoryMax: 8589934592 sstMemoryStep: 134217728 sstVCPUDefault: 1 sstVCPUValues: 1 sstVCPUValues: 2 sstVCPUValues: 4 sstClockOffsetDefault: utc sstClockOffsetValues: localtime sstClockOffsetValues: utc sstOnPowerOff: TBD_GUI sstOnPowerOffDefault: destroy sstOnPowerOffValues: destroy sstOnReboot: TBD_GUI sstOnRebootDefault: restart sstOnRebootValues: restart sstOnCrash: TBD_GUI sstOnCrashDefault: destroy sstOnCrashValues: destroy sstVirtualMachineType: profile sstVirtualMachineSubType: VM-Profile dn: ou=devices,sstVirtualMachine=default,ou=default,ou=default,ou=default,ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch objectclass: top objectclass: organizationalUnit objectclass: sstVirtualizationVirtualMachineDevices ou: devices sstEmulator: /usr/local/bin/qemu-kvm.spice sstMemBalloon: virtio dn: sstDisk=vda,ou=devices,sstVirtualMachine=default,ou=default,ou=default,ou=default,ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch objectclass: top objectclass: sstVirtualizationVirtualMachineDisk objectclass: sstVirtualizationVirtualMachineDiskDefaults sstDisk: vda sstType: file sstDevice: disk sstSourceFile: TBD_SYSTEM sstTargetBus: virtio sstReadonly: FALSE sstDriverName: qemu sstDriverType: qcow2 sstVolumeName: TBD_SYSTEM sstVolumeAllocation: 0 sstVolumeCapacity: -1 sstVolumeCapacityDefault: 10737418240 sstVolumeCapacityMin: 10737418240 sstVolumeCapacityMax: 214748364800 sstVolumeCapacityStep: 1073741824 dn: sstDisk=hdb,ou=devices,sstVirtualMachine=default,ou=default,ou=default,ou=default,ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch objectclass: top objectclass: sstVirtualizationVirtualMachineDisk sstDisk: hdb sstType: file sstDevice: cdrom sstSourceFile: TBD_GUI sstTargetBus: ide sstReadonly: TRUE dn: sstInterface=net0,ou=devices,sstVirtualMachine=default,ou=default,ou=default,ou=default,ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch objectclass: top objectclass: sstVirtualizationVirtualMachineInterface sstInterface: net0 sstType: bridge sstSourceBridge: vmbr0 sstMacAddress: TBD_SYSTEM sstModelType: virtio
Beispiel eines Linux VM-Profiles
Das nachfolgende LDIF zeigt das komplette Linux openSUSE 11.3 with KDE VM-Profile, welches auf dem Default Linux VM-Profile aufbaut:
dn: ou=openSUSE 11.3,ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch objectclass: top objectclass: organizationalUnit ou: openSUSE 11.3 description: This is the openSUSE 11.3 VM-Profile subtree (operating system name level). dn: ou=x86_64,ou=openSUSE 11.3,ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch objectclass: top objectclass: organizationalUnit ou: x86_64 description: This is the openSUSE 11.3 VM-Profile subtree (architecture level). dn: ou=multi,ou=x86_64,ou=openSUSE 11.3,ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch objectclass: top objectclass: organizationalUnit ou: multi description: This is the default Linux VM-Profile subtree (language level). dn: sstVirtualMachine=9a38a062-1f06-4bc2-94a6-bf5f4bdccddc,ou=multi,ou=x86_64,ou=openSUSE 11.3,ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch objectclass: top objectclass: sstVirtualizationVirtualMachine sstVirtualMachine: 9a38a062-1f06-4bc2-94a6-bf5f4bdccddc objectclass: labeledURIObject sstDisplayName: TBD_GUI description: openSUSE 11.3 with KDE. sstMemory: 536870912 sstVCPU: 1 sstStatus: TBD_SYSTEM sstNode: TBD_GUI sstType: kvm sstOSArchitecture: x86_64 sstOSMachine: pc-0.13 sstOSType: hvm sstOSBootDevice: cdrom sstFeature: acpi sstFeature: pae sstClockOffset: utc sstOnPowerOff: destroy sstOnReboot: restart sstOnCrash: destroy sstSourceFile: /var/virtualization/iso/images/png/Linux_OpenSUSE_Logo_16.png labeledURI: ldap:///sstVirtualMachine=default,ou=default,ou=default,ou=default,ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch sstVirtualMachineType: profile sstVirtualMachineSubType: VM-Profile dn: ou=devices,sstVirtualMachine=9a38a062-1f06-4bc2-94a6-bf5f4bdccddc,ou=multi,ou=x86_64,ou=openSUSE 11.3,ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch objectclass: top objectclass: organizationalUnit objectclass: sstVirtualizationVirtualMachineDevices ou: devices sstEmulator: /usr/local/bin/qemu-kvm.spice sstMemBalloon: virtio dn: sstDisk=vda,ou=devices,sstVirtualMachine=9a38a062-1f06-4bc2-94a6-bf5f4bdccddc,ou=multi,ou=x86_64,ou=openSUSE 11.3,ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch objectclass: top objectclass: sstVirtualizationVirtualMachineDisk sstDisk: vda sstType: file sstDevice: disk sstSourceFile: TBD_SYSTEM sstTargetBus: virtio sstReadonly: FALSE sstDriverName: qemu sstDriverType: qcow2 sstVolumeName: TBD_SYSTEM sstVolumeAllocation: 0 sstVolumeCapacity: 10737418240 dn: sstDisk=hdb,ou=devices,sstVirtualMachine=9a38a062-1f06-4bc2-94a6-bf5f4bdccddc,ou=multi,ou=x86_64,ou=openSUSE 11.3,ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch objectclass: top objectclass: sstVirtualizationVirtualMachineDisk sstDisk: hdb sstType: file sstDevice: cdrom sstSourceFile: /var/virtualization/iso/f7cf6efc-8dc3-4137-90cd-f278ce7145ae.iso sstTargetBus: ide sstReadonly: TRUE dn: sstInterface=net0,ou=devices,sstVirtualMachine=9a38a062-1f06-4bc2-94a6-bf5f4bdccddc,ou=multi,ou=x86_64,ou=openSUSE 11.3,ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,o=stepping-stone,c=ch objectclass: top objectclass: sstVirtualizationVirtualMachineInterface sstInterface: net0 sstType: bridge sstSourceBridge: vmbr0 sstMacAddress: TBD_SYSTEM sstModelType: virtio
Windows Default VM-Profile
Das nachfolgende LDIF zeigt das komplette Windows Default VM-Profil:
# Entry 1: ou=default,ou=windows,ou=virtual machine profiles,ou=virtualiz... dn: ou=default,ou=windows,ou=virtual machine profiles,ou=virtualization,ou=services,dc=stoney-cloud,dc=org description: This is the default Windows VM-Profile subtree (operating system name level). objectclass: top objectclass: organizationalUnit ou: default # Entry 2: ou=default,ou=default,ou=windows,ou=virtual machine profiles,o... dn: ou=default,ou=default,ou=windows,ou=virtual machine profiles,ou=virtualization,ou=services,dc=stoney-cloud,dc=org description: This is the default Windows VM-Profile subtree (architecture level). objectclass: top objectclass: organizationalUnit objectclass: sstVirtualizationProfileArchitectureDefaults ou: default sstOSArchitectureDefault: x86_64 sstOSArchitectureValues: i686 sstOSArchitectureValues: x86_64 # Entry 3: ou=default,ou=default,ou=default,ou=windows,ou=virtual machine... dn: ou=default,ou=default,ou=default,ou=windows,ou=virtual machine profiles,ou=virtualization,ou=services,dc=stoney-cloud,dc=org description: This is the default Windows VM-Profile subtree (language level). objectclass: top objectclass: organizationalUnit objectclass: sstVirtualizationProfileLanguageDefaults ou: default sstLanguageDefault: multi sstLanguageValues: multi sstLanguageValues: de-DE sstLanguageValues: de-AT sstLanguageValues: de-CH sstLanguageValues: en-US sstLanguageValues: en-GB sstLanguageValues: fr-CH sstLanguageValues: fr-FR sstLanguageValues: it-CH sstLanguageValues: it-IT # Entry 4: sstVirtualMachine=default,ou=default,ou=default,ou=default,ou=... dn: sstVirtualMachine=default,ou=default,ou=default,ou=default,ou=windows,ou=virtual machine profiles,ou=virtualization,ou=services,dc=stoney-cloud,dc=org description: TBD_GUI objectclass: top objectclass: sstVirtualizationVirtualMachine objectclass: sstVirtualizationVirtualMachineDefaults sstclockoffset: TBD_GUI sstclockoffsetdefault: localtime sstclockoffsetvalues: localtime sstclockoffsetvalues: utc sstdisplayname: TBD_GUI sstfeature: acpi sstfeature: pae sstmemory: -1 sstmemorydefault: 536870912 sstmemorymax: 8589934592 sstmemorymin: 268435456 sstmemorystep: 134217728 sstnode: TBD_GUI sstoncrash: TBD_GUI sstoncrashdefault: destroy sstoncrashvalues: destroy sstonpoweroff: TBD_GUI sstonpoweroffdefault: destroy sstonpoweroffvalues: destroy sstonreboot: TBD_GUI sstonrebootdefault: restart sstonrebootvalues: restart sstosarchitecture: TBD_GUI sstosbootdevice: cdrom sstosmachine: pc-1.2 sstostype: hvm sststatus: TBD_SYSTEM ssttype: kvm sstvcpu: -1 sstvcpudefault: 1 sstvcpuvalues: 1 sstvcpuvalues: 2 sstvcpuvalues: 4 sstvirtualmachine: default sstvirtualmachinepool: TBD_GUI sstVirtualMachineType: profile sstVirtualMachineSubType: VM-Profile # Entry 5: ou=devices,sstVirtualMachine=default,ou=default,ou=default,ou=... dn: ou=devices,sstVirtualMachine=default,ou=default,ou=default,ou=default,ou=windows,ou=virtual machine profiles,ou=virtualization,ou=services,dc=foss- cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstVirtualizationVirtualMachineDevices ou: devices sstemulator: /usr/bin/qemu-kvm sstmemballoon: virtio # Entry 6: sstDisk=hdb,ou=devices,sstVirtualMachine=default,ou=default,ou... dn: sstDisk=hdb,ou=devices,sstVirtualMachine=default,ou=default,ou=default,ou=default,ou=windows,ou=virtual machine profiles,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstVirtualizationVirtualMachineDisk sstdevice: cdrom sstdisk: hdb sstreadonly: TRUE sstsourcefile: TBD_GUI ssttargetbus: ide ssttype: file # Entry 7: sstDisk=hdc,ou=devices,sstVirtualMachine=default,ou=default,ou... dn: sstDisk=hdc,ou=devices,sstVirtualMachine=default,ou=default,ou=default,ou=default,ou=windows,ou=virtual machine profiles,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstVirtualizationVirtualMachineDisk sstdevice: cdrom sstdisk: hdc sstreadonly: TRUE sstsourcefile: /var/virtualization/iso/85d7e9f5-4288-4a3f-b209-c12ff11c61f3.iso ssttargetbus: ide ssttype: file # Entry 8: sstDisk=vda,ou=devices,sstVirtualMachine=default,ou=default,ou... dn: sstDisk=vda,ou=devices,sstVirtualMachine=default,ou=default,ou=default,ou=default,ou=windows,ou=virtual machine profiles,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstVirtualizationVirtualMachineDisk objectclass: sstVirtualizationVirtualMachineDiskDefaults sstdevice: disk sstdisk: vda sstdrivercache: writeback sstdrivername: qemu sstdrivertype: qcow2 sstreadonly: FALSE sstsourcefile: TBD_SYSTEM ssttargetbus: virtio ssttype: file sstvolumeallocation: 0 sstvolumecapacity: -1 sstvolumecapacitydefault: 42949672960 sstvolumecapacitymax: 214748364800 sstvolumecapacitymin: 10737418240 sstvolumecapacitystep: 1073741824 sstvolumename: TBD_SYSTEM # Entry 9: sstInterface=net0,ou=devices,sstVirtualMachine=default,ou=defa... dn: sstInterface=net0,ou=devices,sstVirtualMachine=default,ou=default,ou=default,ou=default,ou=windows,ou=virtual machine profiles,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstVirtualizationVirtualMachineInterface sstinterface: net0 sstmacaddress: TBD_SYSTEM sstmodeltype: virtio sstsourcebridge: vmbr0 ssttype: bridge
Windows XP Default VM-Profile
Das nachfolgende LDIF zeigt das komplette Windows XP Default VM-Profil:
# Entry 1: ou=Windows XP Default,ou=windows,ou=virtual machine profiles,ou=virtualiz... dn: ou=Windows XP Default,ou=windows,ou=virtual machine profiles,ou=virtualization,ou=services,dc=stoney-cloud,dc=org description: This is the default Windows VM-Profile subtree (operating system name level). objectclass: top objectclass: organizationalUnit ou: Windows XP Default # Entry 2: ou=default,ou=Windows XP Default,ou=windows,ou=virtual machine profiles,o... dn: ou=default,ou=Windows XP Default,ou=windows,ou=virtual machine profiles,ou=virtualization,ou=services,dc=stoney-cloud,dc=org description: This is the default Windows VM-Profile subtree (architecture level). objectclass: top objectclass: organizationalUnit objectclass: sstVirtualizationProfileArchitectureDefaults ou: default sstOSArchitectureDefault: i686 sstOSArchitectureValues: i686 sstOSArchitectureValues: x86_64 # Entry 3: ou=default,ou=default,ou=Windows XP Default,ou=windows,ou=virtual machine... dn: ou=default,ou=default,ou=Windows XP Default,ou=windows,ou=virtual machine profiles,ou=virtualization,ou=services,dc=stoney-cloud,dc=org description: This is the default Windows VM-Profile subtree (language level). objectclass: top objectclass: organizationalUnit objectclass: sstVirtualizationProfileLanguageDefaults ou: default sstLanguageDefault: multi sstLanguageValues: multi sstLanguageValues: de-DE sstLanguageValues: de-AT sstLanguageValues: de-CH sstLanguageValues: en-US sstLanguageValues: en-GB sstLanguageValues: fr-CH sstLanguageValues: fr-FR sstLanguageValues: it-CH sstLanguageValues: it-IT # Entry 4: sstVirtualMachine=default,ou=default,ou=default,ou=Windows XP Default,ou=... dn: sstVirtualMachine=default,ou=default,ou=default,ou=Windows XP Default,ou=windows,ou=virtual machine profiles,ou=virtualization,ou=services,dc=stoney-cloud,dc=org description: TBD_GUI objectclass: top objectclass: sstVirtualizationVirtualMachine objectclass: sstVirtualizationVirtualMachineDefaults sstclockoffset: TBD_GUI sstclockoffsetdefault: localtime sstclockoffsetvalues: localtime sstclockoffsetvalues: utc sstdisplayname: TBD_GUI sstfeature: acpi sstfeature: pae sstmemory: -1 sstmemorydefault: 536870912 sstmemorymax: 2147483648 sstmemorymin: 536870912 sstmemorystep: 134217728 sstnode: TBD_GUI sstoncrash: TBD_GUI sstoncrashdefault: destroy sstoncrashvalues: destroy sstonpoweroff: TBD_GUI sstonpoweroffdefault: destroy sstonpoweroffvalues: destroy sstonreboot: TBD_GUI sstonrebootdefault: restart sstonrebootvalues: restart sstosarchitecture: TBD_GUI sstosbootdevice: cdrom sstosmachine: pc-1.0 sstostype: hvm sststatus: TBD_SYSTEM ssttype: kvm sstvcpu: -1 sstvcpudefault: 1 sstvcpuvalues: 1 sstvirtualmachine: default sstvirtualmachinepool: TBD_GUI sstVirtualMachineType: profile sstVirtualMachineSubType: VM-Profile # Entry 5: ou=devices,sstVirtualMachine=default,ou=default,ou=default,ou=... dn: ou=devices,sstVirtualMachine=default,ou=default,ou=default,ou=Windows XP Default,ou=windows,ou=virtual machine profiles,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit objectclass: sstVirtualizationVirtualMachineDevices ou: devices sstemulator: /usr/bin/qemu-kvm sstmemballoon: virtio # Entry 6: sstDisk=hdb,ou=devices,sstVirtualMachine=default,ou=default,ou... dn: sstDisk=hdb,ou=devices,sstVirtualMachine=default,ou=default,ou=default,ou=Windows XP Default,ou=windows,ou=virtual machine profiles,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstVirtualizationVirtualMachineDisk sstdevice: cdrom sstdisk: hdb sstreadonly: TRUE sstsourcefile: TBD_GUI ssttargetbus: ide ssttype: file # Entry 7: sstDisk=hdc,ou=devices,sstVirtualMachine=default,ou=default,ou... dn: sstDisk=hdc,ou=devices,sstVirtualMachine=default,ou=default,ou=default,ou=Windows XP Default,ou=windows,ou=virtual machine profiles,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstVirtualizationVirtualMachineDisk sstdevice: cdrom sstdisk: hdc sstreadonly: TRUE sstsourcefile: /var/virtualization/iso/85d7e9f5-4288-4a3f-b209-c12ff11c61f3.iso ssttargetbus: ide ssttype: file # Entry 8: sstDisk=vda,ou=devices,sstVirtualMachine=default,ou=default,ou... dn: sstDisk=vda,ou=devices,sstVirtualMachine=default,ou=default,ou=default,ou=Windows XP Default,ou=windows,ou=virtual machine profiles,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstVirtualizationVirtualMachineDisk objectclass: sstVirtualizationVirtualMachineDiskDefaults sstdevice: disk sstdisk: vda sstdrivercache: writeback sstdrivername: qemu sstdrivertype: qcow2 sstreadonly: FALSE sstsourcefile: TBD_SYSTEM ssttargetbus: ide ssttype: file sstvolumeallocation: 0 sstvolumecapacity: -1 sstvolumecapacitydefault: 42949672960 sstvolumecapacitymax: 214748364800 sstvolumecapacitymin: 10737418240 sstvolumecapacitystep: 1073741824 sstvolumename: TBD_SYSTEM # Entry 9: sstInterface=net0,ou=devices,sstVirtualMachine=default,ou=defa... dn: sstInterface=net0,ou=devices,sstVirtualMachine=default,ou=default,ou=default,ou=Windows XP Default,ou=windows,ou=virtual machine profiles,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstVirtualizationVirtualMachineInterface sstinterface: net0 sstmacaddress: TBD_SYSTEM sstmodeltype: virtio sstsourcebridge: vmbr0 ssttype: bridge
Virtual Machines
The sub tree ou=virtual machines,ou=virtualization,ou=services,o=stepping-stone,c=ch contains all virtual machines and virtual machine templates of this stoney cloud installation.
The following LDIF shows the sub tree entry ou=virtual machines,ou=virtualization,ou=services, o=stepping-stone,c=ch:
dn: ou=virtual machines,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit ou: virtual machines description: This sub tree contains all virtual machines and virtual machine templates of this stoney cloud installation.
Virtual Machine Templates
The virtual machine templates and the virtual machines are practically the same. The only difference lies in the the type. The following example describes a virtual machine template:
sstVirtualMachineType: template sstVirtualMachineSubType: VM-Template
The following example describes a virtual machine:
sstVirtualMachineType: persistent sstVirtualMachineSubType: server
Virtual Machine
The following LDIF entry shows the virtual machine kvm-0001.stoney-cloud.org. In the stoney cloud version 1.2.0 the entries sstNetworkHostname: kvm-0001 and sstNetworkDomainName: stoney-cloud.org have been added. These will be used by the vm-manager in the stoney cloud version 1.4.0 to automatically set sstDisplayName: kvm-0001.stoney-cloud.org properly. The user will be allowed to set sstNetworkHostname and sstNetworkDomainName. The content of sstDisplayName will be pre-filled with the content of sstNetworkHostname and sstNetworkDomainName and will be able to be modified through the user. A typical edit could be sstDisplayName: kvm-0001.stoney-cloud.org (Mail Server)
dn: sstVirtualMachine=b543f88f-dffe-426f-86d3-c7ff85c16d2a,ou=virtual machines,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectClass: top objectClass: sstVirtualizationVirtualMachine objectClass: sstRelationship objectClass: sstSpice objectClass: labeledURIObject sstVirtualMachine: b543f88f-dffe-426f-86d3-c7ff85c16d2a description: Linux Fedora 20 (64-bit) sstVirtualMachinePool: d9c3cc0c-9ae7-40e5-8fb7-ba5297e835aa sstClockOffset: utc sstMemory: 2147483648 sstNode: vm-node-01.stoney-cloud.org sstOnCrash: destroy sstOnPowerOff: destroy sstOnReboot: restart sstOSArchitecture: x86_64 sstOSBootDevice: hd sstOSMachine: pc-i440fx-1.5 sstOSType: hvm sstStatus: running sstVirtualMachineMode: first installation sstType: kvm sstVCPU: 1 sstFeature: acpi sstFeature: pae sstVirtualMachineType: persistent sstVirtualMachineSubType: Server sstSpicePort: 5900 sstSpicePassword: Z1oQn2HrF9Lb labeledURI: ldap:///sstVirtualMachine=default,ou=default,ou=default,ou=default,ou=linux,ou=virtual machine profiles,ou=virtualization,ou=services,dc=stoney-cloud,dc=org sstNetworkDomainName: stoney-cloud.org sstNetworkHostname: kvm-0001 sstDisplayName: kvm-0001.stoney-cloud.org sstBelongsToResellerUID: 4000000 sstBelongsToCustomerUID: 4000001 uid: 1234567
The following table describes the different attributes:
| Attribute | |
|
|
|
Description |
| sstVirtualMachine | |
|
|
|
|
| description | |
|
|
|
|
| sstVirtualMachinePool | |
|
|
|
|
| sstClockOffset | |
|
|
|
|
| sstMemory | |
|
|
|
|
| sstNode | |
|
|
|
|
| sstOnCrash | |
|
|
|
|
| sstOnPowerOff | |
|
|
|
|
| sstOnReboot | |
|
|
|
|
| sstOSArchitecture | |
|
|
|
|
| sstOSBootDevice | |
|
|
|
|
| sstOSMachine | |
|
|
|
|
| sstOSType | |
|
|
|
|
| sstStatus | |
|
|
|
|
| sstVirtualMachineMode | |
|
|
|
Possible values are:
If the Releasing a virtual machine template for use: In Step 3: Install the Virtual Machine Template with the chosen operating system of the Lean Provisioning Work Flow, the user must release the virtual machine template:
|
| sstType | |
|
|
|
|
| sstVCPU | |
|
|
|
|
| sstFeature | |
|
|
|
|
| sstVirtualMachineType | |
|
|
|
|
| sstVirtualMachineSubType | |
|
|
|
|
| sstSpicePort | |
|
|
|
|
| sstSpicePassword | |
|
|
|
|
| labeledURI | |
|
|
|
|
| sstNetworkDomainName | |
|
|
|
|
| sstNetworkHostname | |
|
|
|
|
| sstDisplayName | |
|
|
|
|
| sstBelongsToResellerUID | |
|
|
|
Stores the reseller UID the leaf belongs to. |
| sstBelongsToCustomerUID | |
|
|
|
Stores the customer UID the leaf belongs to. |
| sstBelongsToPersonUID | |
|
|
|
Stores the person UID the leaf belongs to. |
| sstBelongsToServiceUID | |
|
|
|
Stores the service UID the leaf belongs to. |
| uid | |
|
|
|
A unique integer value with 7 digits or more. For example: 1234567. The uid</uid> is used for billing purposes.
|
Legend:
- x: Mandatory in all cases.
- x1: Only show, if the number is larger than zero.
- x2: Only show, if <code>sstBackupWarningOn is set to
TRUE. - x3: Either
sstBelongsToPersonUIDorsstBelongsToServiceUIDmust bei set.
Virtual Machine: Backup
See stoney conductor: VM Backups for details of how the virtual machine backups work.
The sub tree below which all the backups for the virtual machine b543f88f-dffe-426f-86d3-c7ff85c16d2a are stored.
dn: ou=backup,sstVirtualMachine=b543f88f-dffe-426f-86d3-c7ff85c16d2a,ou=virtual machines,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: organizationalUnit ou: backup
An example of a successful backup run for the virtual machine b543f88f-dffe-426f-86d3-c7ff85c16d2a.
dn: ou=20131224T161329Z,ou=backup,sstVirtualMachine=b543f88f-dffe-426f-86d3-c7ff85c16d2a,ou=virtual machines,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectclass: top objectclass: sstProvisioning objectclass: organizationalUnit ou: 20131224T161329Z sstProvisioningExecutionTime: snapshot: 0 sstProvisioningExecutionTime: merge: 0 sstProvisioningExecutionTime: retain: 119 sstProvisioningExecutionDate: 0 sstProvisioningMode: finished sstProvisioningReturnValue: 0 sstProvisioningState: 0
Virtual Machine: Devices
dn: ou=devices,sstVirtualMachine=b543f88f-dffe-426f-86d3-c7ff85c16d2a,ou=virtual machines,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectClass: top objectClass: organizationalUnit objectClass: sstVirtualizationVirtualMachineDevices ou: devices sstEmulator: /usr/bin/qemu-kvm sstMemBalloon: virtio
dn: sstDisk=hdb,ou=devices,sstVirtualMachine=b543f88f-dffe-426f-86d3-c7ff85c16d2a,ou=virtual machines,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectClass: top objectClass: sstVirtualizationVirtualMachineDisk sstDevice: cdrom sstDisk: hdb sstSourceFile: /var/virtualization/iso/d9f0bc41-c883-49c7-8915-4d6b6ad3403d.iso sstTargetBus: ide sstType: file sstReadonly: TRUE
dn: sstDisk=vda,ou=devices,sstVirtualMachine=b543f88f-dffe-426f-86d3-c7ff85c16d2a,ou=virtual machines,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectClass: top objectClass: sstVirtualizationVirtualMachineDisk sstDevice: disk sstDisk: vda sstSourceFile: /var/virtualization/vm-persistent/0f83f084-8080-413e-b558-b678e504836e/30909c54-877a-432c-93a7-e5e3c7389bed.qcow2 sstTargetBus: virtio sstType: file sstDriverCache: writeback sstDriverName: qemu sstDriverType: qcow2 sstReadonly: FALSE sstVolumeAllocation: 0 sstVolumeCapacity: 10737418240 sstVolumeName: 30909c54-877a-432c-93a7-e5e3c7389bed
dn: sstInterface=net0,ou=devices,sstVirtualMachine=b543f88f-dffe-426f-86d3-c7ff85c16d2a,ou=virtual machines,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectClass: top objectClass: sstVirtualizationVirtualMachineInterface sstInterface: net0 sstMacAddress: 52:54:00:48:e4:1e sstModelType: virtio sstSourceBridge: vmbr0 sstType: bridge
Virtual Machine: Groups
dn: ou=groups,sstVirtualMachine=b543f88f-dffe-426f-86d3-c7ff85c16d2a,ou=virtual machines,ou=virtualization,ou=services,dc=stoney-cloud,dc=org
Virtual Machine: Operating System
dn: ou=operating system,sstVirtualMachine=4b99c860-cf5a-435a-a87d-e9fdc2bf0ba5,ou=virtual machines,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectClass: top objectclass: organizationalUnit objectClass: sstOperatingSystemObjectClass ou: operating system sstOperatingSystem: Windows sstOperatingSystemType: Server 2012 sstOperatingSystemVersion: Standard
The following table describes the different attributes:
| Attribute | Objectclass | |
|
Description |
| sstOperatingSystem | |
|
|
A manually executed maintenance window for Windows systems is significantly more time-consuming than for Linux. Therefore we need to know the operating system. Possible values are
This attribute is only relevant, if |
Legend:
- x: Mandatory in all cases.
Virtual Machine: People
dn: ou=people,sstVirtualMachine=b543f88f-dffe-426f-86d3-c7ff85c16d2a,ou=virtual machines,ou=virtualization,ou=services,dc=stoney-cloud,dc=org
Virtual Machine: Settings
dn: ou=settings,sstVirtualMachine=b543f88f-dffe-426f-86d3-c7ff85c16d2a,ou=virtual machines,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectClass: top objectClass: organizationalUnit ou: settings
Virtual Machine: Software Stack
dn: ou=software stack,sstVirtualMachine=4b99c860-cf5a-435a-a87d-e9fdc2bf0ba5,ou=virtual machines,ou=virtualization,ou=services,dc=stoney-cloud,dc=org objectClass: top objectClass: sstGroupObjectClass objectClass: labeledURIObject ou: software stack sstDisplayName: None sstBusinessLogicRoleName: none description: No Software Stack is to be managed through the configuration management. labeledURI: ldap:///uid=3000064,ou=software stack,ou=configuration,o=stepping-stone,c=ch sstEnvironmentName: 3000060
The attribute sstEnvironmentName: 3000060 points to the entry uid=3000060,ou=environments,ou=software stack,ou=configuration,dc=stoney-cloud,dc=org and means, we are in the Production Environment.
