Changes

Jump to: navigation, search
/* Load Balancer as a Service (LBaaS) - Account example */
=== Load Balancer as a Service (LBaaS) - Account example ===
The following example shows the OpenLDAP directory entry for the stoney wiki Load Balancer as a Service (LBaaS) account with the uid number 3730083:
<source lang="ldif">
shadowWarning: 7
sstIsActive: TRUE
 sstLBaaSFrontendURI: https://www.example.com/ # Uniform Resource Identifier with optional label.sstLBaaSFrontendURI: https://example.com/ # Uniform Resource Identifier with optional label.sstLBaaSFrontendURI: https://api.example.com/ # Uniform Resource Identifier with optional label .
sstLBaaSBackendURI: https://sst-int-001.os.stoney-cloud.com/ # Uniform Resource Identifier with optional label.
sstLBaaSBackendURI: https://sst-int-002.os.stoney-cloud.com/ # Uniform Resource Identifier with optional label.
sstLBaaSHost: haproxy-001.os.stoney-cloud.com # Fully qualified domain name (FQDN).sstLBaaSHost: haproxy-002.os.stoney-cloud.com # Fully qualified domain name (FQDN).
sstProvisioningMode: add
sstProvisioningExecutionDate: 0
sstBelongsToResellerUID: 4000000
sstBelongsToCustomerUID: 4000001
sstBelongsToPersonUIDsstBelongsToServiceUID: 4000002 4000003 # TBD: We don't really want this The service belongs to be attached to a personthe backend host defined in the variabe (sstLBaaSBackendURI: https://sst-int-001.os.stoney-cloud.com/).sstBelongsToServiceUID: 4000003 4000004 # TBD: To which service would we attach this service? The service belongs to the backend hosts host defined in the variabe (sstLBaaSBackendURI: https://sst-int-002.os.stoney-cloud.com/)?.
</source>
This will result in The LDIF above can be queried via the following cli command <code>getent passwd</code> entry:<syntaxhighlight lang='bash'>getent passwd 3730083</syntaxhighlight> This will result in the following output:
<syntaxhighlight lang='text'>
# .------------------------------------------------------------------------------- login name# | .----------------------------------------------------------------------- encrypted password indicator# | | .--------------------------------------------------------------------- numerical user ID# | | | .------------------------------------------------------------- numerical group ID# | | | | .----------------------------------------------------- gecos field (the typical format is a comma-delimited list)# | | | | | .---------------------- user home directory# | | | | | | .-------- user command interpreter# | | | | | | |# | | | | | | |
3730083:x:3730083:3730083:Example Ltd. (www.example.com):/home/3730083:/bin/false
</syntaxhighlight>
<code>iconv("UTF-8", "ASCII//TRANSLIT", "Tüpfelhyänenöhrchen")</code><br />
Please be aware, that some characters don't get converted properly ... For example: Ø and £. The characters $ and € work.
 
This appears in the 'getent passwd' output. Company name and the main fully qualified domain name (FQDN). For example: <code>Example Ltd. (www.example.com)</code>.
|-
| <center>MAY</center>
| <center>x</center>
| Is the wiki Load Balancer as a Service (LBaaS) account active? Either <code>TRUE</code> (yes) or <code>FALSE</code> (no). Default is <code>TRUE</code> (yes).
|-
| <center>MUST</center>
| <center>x</center>
| This multi-valued attribute stores one or more Load Balancer as a Service (LBaaS) frontend servers in the form of a Uniform Resource Identifier with optional label. Some examples:* <code>https://www.example.com/</code>* <code>https://example.com/</code>* <code>https://api.example.com/</code>
|-
| <center>MUST</center>
| <center>x</center>
| This multi-valued attribute stores one or more Load Balancer as a Service (LBaaS) backend servers in the form of a Uniform Resource Identifier with optional label. Some examples:* <code>https://sst-int-001.os.stoney-cloud.com/</code>* <code>https://sst-int-002.os.stoney-cloud.com/</code>
|-
| <center>MUST</center>
| <center>x</center>
| This multi-valued attribute stores one or more Load Balancer as a Service (LBaaS) servers in the form of a fully qualified domain name. Some examples:* <code>haproxy-001.os.stoney-cloud.com</code>* <code>haproxy-002.os.stoney-cloud.com</code>
|-
| <center>x</center>
| Stores the customer UID the leaf belongs to.
 
|-
| sstBelongsToPersonUID
| sstRelationship
| <center>MAY</center>
| <center>x<sup>3</sup></center>
| Stores the person UID the leaf belongs to.
|-
| sstRelationship
| <center>MAY</center>
| <center>x<sup>3</sup></center>| Stores the service UID(s) the leaf this entry belongs to. The service belongs to the backend host(s) defined in the variable(s) (sstLBaaSBackendURI). This multi-valued attribute can point to multiple services (one or more LBaaS backends).
|}
Legend:
* '''x''': Mandatory in all cases.
* '''x<sup>1</sup>''': Only show, if the number is larger than zero.
* '''x<sup>2</sup>''': Only show, if <code>sstWikiWarningOn</code> is set to <code>TRUE</code>.
* '''x<sup>3</sup>''': Either <code>sstBelongsToPersonUID</code> or <code>sstBelongsToServiceUID</code> must bei set.
== Load Balancer as a Service (LBaaS) - Groups ==
description: The sub tree for the groups of the Load Balancer as a Service (LBaaS).
</source>
 
The following table describes the different attributes:
{| border="1" style="border-collapse: collapse; font-size:80%;" width="100%" class="wikitable sortable"
! style="text-align:left; width: 180px" | Attribute
! style="text-align:left; width: 220px" | Objectclass
! style="width: 80px" | Existance
! style="width: 80px" | Mandatory
! style="text-align:left;" | Description
 
|-
| ou
| organizationalUnit
| <center>MUST</center>
| <center>x</center>
| The name of the leaf.
 
In this case: <code>groups</code>.
 
|-
| description
| organizationalUnit
| <center>MAY</center>
| <center>x</center>
| The description of the leaf.
 
In this case: <code>The sub tree for the groups of the Load Balancer as a Service (LBaaS).</code>
 
|}
 
Legend:
* '''x''': Mandatory in all cases.
=== Load Balancer as a Service (LBaaS) - Group example ===
The following example shows the OpenLDAP directory entry for the Load Balancer as a Service (LBaaS) group with the uid number 3730083:
 
<source lang="ldif">
dn: cn=3730083,ou=groups,ou=lbaas,ou=services,dc=stoney-cloud,dc=org
cn: 3730083
gidNumber: 3730083
sstIsActive: TRUE
sstBelongsToResellerUID: 4000000
sstBelongsToCustomerUID: 4000001
sstBelongsToPersonUIDsstBelongsToServiceUID: 40000024000003 # The service belongs to the backend host defined in the variabe (sstLBaaSBackendURI: https://sst-int-001.os.stoney-cloud.com/).sstBelongsToServiceUID: 4000004 # The service belongs to the backend host defined in the variabe (sstLBaaSBackendURI: https://sst-int-002.os.stoney-cloud.com/).
</source>
 
The following table describes the different attributes:
{| border="1" style="border-collapse: collapse; font-size:80%;" width="100%" class="wikitable sortable"
! style="text-align:left; width: 180px" | Attribute
! style="text-align:left; width: 220px" | Objectclass
! style="width: 80px" | Existance
! style="width: 80px" | Mandatory
! style="text-align:left;" | Description
 
|-
| cn
| posixGroup
| <center>MUST</center>
| <center>x</center>
| As we don't use this attribute (but the attribute is mandatory and is part of the dn), we set this to <code>uid</code> value. For example: <code>3730083</code>.
 
|-
| gidNumber
| posixGroup
| <center>MUST</center>
| <center>x</center>
| The numerical group ID of the Load Balancer as a Service (LBaaS) group.
 
|-
| sstBelongsToResellerUID
| sstRelationship
| <center>MUST</center>
| <center>x</center>
| Stores the reseller UID the leaf belongs to.
 
|-
| sstBelongsToCustomerUID
| sstRelationship
| <center>MUST</center>
| <center>x</center>
| Stores the customer UID the leaf belongs to.
 
|-
| sstBelongsToServiceUID
| sstRelationship
| <center>MAY</center>
| <center>x</center>
| Stores the service UID(s) this entry belongs to. The service belongs to the backend host(s) defined in the variable(s) (sstLBaaSBackendURI). This multi-valued attribute can point to multiple services (one or more LBaaS backends).
 
|}
 
Legend:
* '''x''': Mandatory in all cases.
= Links =
3,368
edits