stoney backup: OpenLDAP directory data organisation - Revision history

Michael: /* Backup accounts - S3 bucket based backup account example */

2025-02-06T13:57:10Z

Backup accounts - S3 bucket based backup account example

← Older revision		Revision as of 15:57, 6 February 2025
Line 1,802:		Line 1,802:

	For example: '''10737418240''' (10 Gibibyte or 10 GiB).		For example: '''10737418240''' (10 Gibibyte or 10 GiB).
			\|-

			\| <!-- Attribute --> style="text-align: left;" \| sstBackupSize
			\| <!-- Objectclass --> style="text-align: left;" \| sstS3Bucket
			\| <!-- Existance --> style="text-align: center;" \| MUST
			\| <!-- Mandatory --> style="text-align: center;" \| x
			\| <!-- Description --> style="text-align: left;" \| The size of the actual backup in bytes. Default is '''0''' . This attribute will be updated by the <code>writeAccountSize.pl</code> script, which is called during the daily backup run by the <code>rsnapshotPostExecWrapper.sh</code> script.

			For example: '''0''' (0 Gibibyte or 0 GiB).
	\|-		\|-

Michael: /* Backup accounts - S3 bucket based backup account example */

2025-02-06T13:55:46Z

Backup accounts - S3 bucket based backup account example

← Older revision		Revision as of 15:55, 6 February 2025
Line 1,674:		Line 1,674:
	sstBillable: FALSE		sstBillable: FALSE
	sstQuota: 10737418240		sstQuota: 10737418240
			sstBackupSize: 0
	sstS3BucketLifecycleDays: 1		sstS3BucketLifecycleDays: 1
	sstS3BucketWormDays: 1		sstS3BucketWormDays: 1
Line 1,706:		Line 1,707:
	sstBillable: FALSE		sstBillable: FALSE
	sstQuota: 10737418240		sstQuota: 10737418240
			sstBackupSize: 0
	sstS3BucketLifecycleDays: 1		sstS3BucketLifecycleDays: 1
	sstS3BucketWormDays: 1		sstS3BucketWormDays: 1

Michael: /* Backup accounts - S3 bucket based backup account example */

2024-08-20T11:29:15Z

Backup accounts - S3 bucket based backup account example

← Older revision		Revision as of 13:29, 20 August 2024
Line 1,777:		Line 1,777:
	\| <!-- Mandatory --> style="text-align: center;" \| x		\| <!-- Mandatory --> style="text-align: center;" \| x
	\| <!-- Description --> style="text-align: left;" \| Is the non-successful backup notification warning turned on or not? Either <code>true</code> (yes) or <code>false</code> (no). Default is true (yes) and is taken from the "ou=settings,uid=<UID>,ou=reseller,ou=configuration,ou=backup,ou=services,dc=stoney-cloud,dc=org" entry.		\| <!-- Description --> style="text-align: left;" \| Is the non-successful backup notification warning turned on or not? Either <code>true</code> (yes) or <code>false</code> (no). Default is true (yes) and is taken from the "ou=settings,uid=<UID>,ou=reseller,ou=configuration,ou=backup,ou=services,dc=stoney-cloud,dc=org" entry.
			\|-

			\| <!-- Attribute --> style="text-align: left;" \| sstNotificationWarningLevel
			\| <!-- Objectclass --> style="text-align: left;" \| sstS3Bucket
			\| <!-- Existance --> style="text-align: center;" \| MUST
			\| <!-- Mandatory --> style="text-align: center;" \| x
			\| <!-- Description --> style="text-align: left;" \| The quota notification level in percent, when the owner of the backup needs to warned. A value between 0 and 100. The default is 85 percent and is taken from the "ou=defaults,uid=<UID>,ou=reseller,ou=configuration,ou=backup,ou=services,dc=stoney-cloud,dc=org" entry.
	\|-		\|-

Michael: /* Backup accounts - S3 bucket based backup account example */

2024-08-20T08:04:13Z

Backup accounts - S3 bucket based backup account example

← Older revision		Revision as of 10:04, 20 August 2024
Line 1,755:		Line 1,755:
	For example: <code>The leaf for the S3 bucket based backup account with the uid '4000907' belonging to the user 'Support stepping stone AG'.</code>		For example: <code>The leaf for the S3 bucket based backup account with the uid '4000907' belonging to the user 'Support stepping stone AG'.</code>

	Or: <code>The leaf for the S3 bucket based backup account with the uid '4000907' belonging to the server 'sst-int-001: stepping stone AG: AlmaLinux 9 (LBaaS 1 Active))'.</code>		Or: <code>The leaf for the S3 bucket based backup account with the uid '4000907' belonging to the server 'sst-int-001: stepping stone AG: AlmaLinux 9 (LBaaS 1 Active)'.</code>
	\|-		\|-

Michael: /* Backup accounts - S3 bucket based backup account example */

2024-08-18T09:20:41Z

Backup accounts - S3 bucket based backup account example

← Older revision		Revision as of 11:20, 18 August 2024
Line 1,703:		Line 1,703:
	sstBackupWarningOn: TRUE		sstBackupWarningOn: TRUE
	sstNotificationWarningMedium: mail		sstNotificationWarningMedium: mail
	~~preferredLanguage: de-CH~~
	sstIsActive: TRUE		sstIsActive: TRUE
	sstBillable: FALSE		sstBillable: FALSE

Michael: /* Backup accounts - S3 bucket based backup account example */

2024-08-18T09:19:46Z

Backup accounts - S3 bucket based backup account example

← Older revision		Revision as of 11:19, 18 August 2024
Line 1,659:		Line 1,659:
	Each (Online) Backup service account has it's own change root (chroot, jail) directory. The following example shows the OpenLDAP directory entry for the (online) backup account with the uid number 4000907:		Each (Online) Backup service account has it's own change root (chroot, jail) directory. The following example shows the OpenLDAP directory entry for the (online) backup account with the uid number 4000907:
	<source lang="ldif">		<source lang="ldif">
	dn: uid=4000907,ou=accounts,ou=backup,ou=services,o=~~stepping~~-~~stone~~,c=ch		dn: uid=4000907,ou=accounts,ou=backup,ou=services,dc=stoney-cloud,dc=org
	objectclass: top		objectclass: top
	objectclass: sstS3Bucket		objectclass: sstS3Bucket
Line 2,004:		Line 2,004:
	* '''x<sup>1</sup>''': If <code>sstAutoGrow</code> is set to <code>TRUE</code>, either <code>sstAutoGrowStepPercentage</code> or <code>sstAutoGrowStepBytes</code> must be set.		* '''x<sup>1</sup>''': If <code>sstAutoGrow</code> is set to <code>TRUE</code>, either <code>sstAutoGrowStepPercentage</code> or <code>sstAutoGrowStepBytes</code> must be set.
	* '''x<sup>2</sup>''': Either <code>sstBelongsToPersonUID</code> or <code>sstBelongsToServiceUID</code> must be set.		* '''x<sup>2</sup>''': Either <code>sstBelongsToPersonUID</code> or <code>sstBelongsToServiceUID</code> must be set.
	* '''x<sup>3</sup>''': ~~If the backup account belongs to a service (<code>sstBelongsToServiceUID</code>) instead of a person (<code>sstBelongsToPersonUID</code>), the attribute <code>preferredLanguage</code> must be set.~~		* '''x<sup>3</sup>''': See notes below!

	Notes:		Notes:

Michael: /* Backup accounts - S3 bucket based backup account example */

2024-08-18T09:17:35Z

Backup accounts - S3 bucket based backup account example

← Older revision		Revision as of 11:17, 18 August 2024
Line 2,005:		Line 2,005:
	* '''x<sup>2</sup>''': Either <code>sstBelongsToPersonUID</code> or <code>sstBelongsToServiceUID</code> must be set.		* '''x<sup>2</sup>''': Either <code>sstBelongsToPersonUID</code> or <code>sstBelongsToServiceUID</code> must be set.
	* '''x<sup>3</sup>''': If the backup account belongs to a service (<code>sstBelongsToServiceUID</code>) instead of a person (<code>sstBelongsToPersonUID</code>), the attribute <code>preferredLanguage</code> must be set.		* '''x<sup>3</sup>''': If the backup account belongs to a service (<code>sstBelongsToServiceUID</code>) instead of a person (<code>sstBelongsToPersonUID</code>), the attribute <code>preferredLanguage</code> must be set.

			Notes:
			* sstInformPersonUID (sstRelationship): We should use <code>sstInformPersonUID</code>, if <code>sstBelongsToServiceUID</code> instead <code>sstBelongsToPersonUID</code> is set. The multi-valued attribute may be set on three levels:
			** <code>uid=<backup_uid>,ou=accounts,ou=backup,ou=services,dc=stoney-cloud,dc=org</code>
			** <code>ou=settings,uid=<customer_uid>,ou=customers,ou=configuration,ou=backup,ou=services,dc=stoney-cloud,dc=org</code>
			** <code>ou=settings,uid=<reseller_uid>,ou=reseller,ou=configuration,ou=backup,ou=services,dc=stoney-cloud,dc=org</code>
			* preferredLanguage (sstS3Bucket): The same applies here.

	== Backup groups ==		== Backup groups ==

Michael: /* Backup accounts - S3 bucket based backup account example */

2024-08-18T08:58:50Z

Backup accounts - S3 bucket based backup account example

← Older revision		Revision as of 10:58, 18 August 2024
Line 1,853:		Line 1,853:
	\| <!-- Objectclass --> style="text-align: left;" \| sstS3Bucket		\| <!-- Objectclass --> style="text-align: left;" \| sstS3Bucket
	\| <!-- Existance --> style="text-align: center;" \| MAY		\| <!-- Existance --> style="text-align: center;" \| MAY
	\| <!-- Mandatory --> style="text-align: center;" \|		\| <!-- Mandatory --> style="text-align: center;" \| x<sup>3</sup>
	\| <!-- Description --> style="text-align: left;" \| The notification language according to [http://www.ietf.org/rfc/rfc1766.txt RFC 1766] ([http://www.iso.org/iso/english_country_names_and_code_elements ISO 3166-1-alpha-2 code]-[http://www.loc.gov/standards/iso639-2/php/code_list.php ISO 639-1 Code].		\| <!-- Description --> style="text-align: left;" \| The notification language according to [http://www.ietf.org/rfc/rfc1766.txt RFC 1766] ([http://www.iso.org/iso/english_country_names_and_code_elements ISO 3166-1-alpha-2 code]-[http://www.loc.gov/standards/iso639-2/php/code_list.php ISO 639-1 Code].

	For example '''de-CH''' or '''en-GB'''.		For example '''de-CH''' or '''en-GB'''.

	The content of this value is taken from the person entry from the attribute <code>preferredLanguage</code>. If the backup account belongs to a service, ~~the user~~ must be ~~asked for the notification language~~.		The content of this value is taken from the person entry from the attribute <code>preferredLanguage</code>. If the backup account belongs to a service instead of a person, this attribute must be set.
	\|-		\|-

Line 2,004:		Line 2,004:
	* '''x<sup>1</sup>''': If <code>sstAutoGrow</code> is set to <code>TRUE</code>, either <code>sstAutoGrowStepPercentage</code> or <code>sstAutoGrowStepBytes</code> must be set.		* '''x<sup>1</sup>''': If <code>sstAutoGrow</code> is set to <code>TRUE</code>, either <code>sstAutoGrowStepPercentage</code> or <code>sstAutoGrowStepBytes</code> must be set.
	* '''x<sup>2</sup>''': Either <code>sstBelongsToPersonUID</code> or <code>sstBelongsToServiceUID</code> must be set.		* '''x<sup>2</sup>''': Either <code>sstBelongsToPersonUID</code> or <code>sstBelongsToServiceUID</code> must be set.
			* '''x<sup>3</sup>''': If the backup account belongs to a service (<code>sstBelongsToServiceUID</code>) instead of a person (<code>sstBelongsToPersonUID</code>), the attribute <code>preferredLanguage</code> must be set.

	== Backup groups ==		== Backup groups ==

Michael: /* Backup accounts - S3 bucket based backup account example */

2024-08-06T12:09:42Z

Backup accounts - S3 bucket based backup account example

← Older revision		Revision as of 14:09, 6 August 2024
Line 1,987:		Line 1,987:
	\| <!-- Objectclass --> style="text-align: left;" \| sstRelationship		\| <!-- Objectclass --> style="text-align: left;" \| sstRelationship
	\| <!-- Existance --> style="text-align: center;" \| MAY		\| <!-- Existance --> style="text-align: center;" \| MAY
	\| <!-- Mandatory --> style="text-align: center;" \| x		\| <!-- Mandatory --> style="text-align: center;" \| x<sup>2</sup>
	\| <!-- Description --> style="text-align: left;" \| Stores the UID of the service the leaf belongs to. This UID can be used to look up other information. A unique value with 7 digits or more. <code>4000123</code>.		\| <!-- Description --> style="text-align: left;" \| Stores the UID of the service the leaf belongs to. This UID can be used to look up other information. A unique value with 7 digits or more. <code>4000123</code>.
	\|-		\|-
Line 1,994:		Line 1,994:
	\| <!-- Objectclass --> style="text-align: left;" \| sstRelationship		\| <!-- Objectclass --> style="text-align: left;" \| sstRelationship
	\| <!-- Existance --> style="text-align: center;" \| MAY		\| <!-- Existance --> style="text-align: center;" \| MAY
	\| <!-- Mandatory --> style="text-align: center;" \|		\| <!-- Mandatory --> style="text-align: center;" \| x<sup>2</sup>
	\| <!-- Description --> style="text-align: left;" \| Stores the UID of the service the leaf belongs to. This UID can be used to look up other information. A unique value with 7 digits or more. <code>4000123</code>.		\| <!-- Description --> style="text-align: left;" \| Stores the UID of the service the leaf belongs to. This UID can be used to look up other information. A unique value with 7 digits or more. <code>4000123</code>.
	\|-		\|-
Line 2,002:		Line 2,002:
	Legend:		Legend:
	* '''x''': Mandatory in all cases.		* '''x''': Mandatory in all cases.
	* '''x<sup>1</sup>''': If <code>sstAutoGrow</s> is set to <code>TRUE</code>, either <code>sstAutoGrowStepPercentage</code> or <code>sstAutoGrowStepBytes</code> must be set.		* '''x<sup>1</sup>''': If <code>sstAutoGrow</code> is set to <code>TRUE</code>, either <code>sstAutoGrowStepPercentage</code> or <code>sstAutoGrowStepBytes</code> must be set.
			* '''x<sup>2</sup>''': Either <code>sstBelongsToPersonUID</code> or <code>sstBelongsToServiceUID</code> must be set.

	== Backup groups ==		== Backup groups ==

Michael: /* Backup accounts - S3 bucket based backup account example */

2024-08-05T14:06:59Z

Backup accounts - S3 bucket based backup account example

← Older revision		Revision as of 16:06, 5 August 2024
Line 1,745:		Line 1,745:
	\| <!-- Description --> style="text-align: left;" \| The human readable display name. Either the human readable server name the S3 bucket belongs to or the persons full name the S3 bucket belongs to.		\| <!-- Description --> style="text-align: left;" \| The human readable display name. Either the human readable server name the S3 bucket belongs to or the persons full name the S3 bucket belongs to.

	For example: ~~'''~~sst-int-001: stepping stone AG: AlmaLinux 9 (LBaaS 1 Active))~~'''~~ or ~~'''~~Support stepping stone AG~~'''~~.		For example: <code>sst-int-001: stepping stone AG: AlmaLinux 9 (LBaaS 1 Active))</code> or <code>Support stepping stone AG</code>.
	\|-		\|-

Line 1,754:		Line 1,754:
	\| <!-- Description --> style="text-align: left;" \| The description of the leaf.		\| <!-- Description --> style="text-align: left;" \| The description of the leaf.

	For example: ~~'''~~The leaf for the S3 bucket based backup account with the uid '4000907' belonging to the user 'Support stepping stone AG'.~~'''~~		For example: <code>The leaf for the S3 bucket based backup account with the uid '4000907' belonging to the user 'Support stepping stone AG'.</code>

	Or: ~~'''~~The leaf for the S3 bucket based backup account with the uid '4000907' belonging to the server 'sst-int-001: stepping stone AG: AlmaLinux 9 (LBaaS 1 Active))'.~~'''~~		Or: <code>The leaf for the S3 bucket based backup account with the uid '4000907' belonging to the server 'sst-int-001: stepping stone AG: AlmaLinux 9 (LBaaS 1 Active))'.</code>
	\|-		\|-

← Older revision		Revision as of 13:29, 20 August 2024
Line 1,777:		Line 1,777:
	\| <!-- Mandatory --> style="text-align: center;" \| x		\| <!-- Mandatory --> style="text-align: center;" \| x
	\| <!-- Description --> style="text-align: left;" \| Is the non-successful backup notification warning turned on or not? Either <code>true</code> (yes) or <code>false</code> (no). Default is true (yes) and is taken from the "ou=settings,uid=<UID>,ou=reseller,ou=configuration,ou=backup,ou=services,dc=stoney-cloud,dc=org" entry.		\| <!-- Description --> style="text-align: left;" \| Is the non-successful backup notification warning turned on or not? Either <code>true</code> (yes) or <code>false</code> (no). Default is true (yes) and is taken from the "ou=settings,uid=<UID>,ou=reseller,ou=configuration,ou=backup,ou=services,dc=stoney-cloud,dc=org" entry.
			\|-

			\| <!-- Attribute --> style="text-align: left;" \| sstNotificationWarningLevel
			\| <!-- Objectclass --> style="text-align: left;" \| sstS3Bucket
			\| <!-- Existance --> style="text-align: center;" \| MUST
			\| <!-- Mandatory --> style="text-align: center;" \| x
			\| <!-- Description --> style="text-align: left;" \| The quota notification level in percent, when the owner of the backup needs to warned. A value between 0 and 100. The default is 85 percent and is taken from the "ou=defaults,uid=<UID>,ou=reseller,ou=configuration,ou=backup,ou=services,dc=stoney-cloud,dc=org" entry.
	\|-		\|-