Common operations on X-as-a-Service » History » Version 5
  Timothée Floure, 03/20/2020 02:05 PM 
  Expand doc for MaaS VM allocation
| 1 | 1 | Timothée Floure | h1. Common operations on X-as-a-Service | 
|---|---|---|---|
| 2 | |||
| 3 | h2. Matrix-as-a-Service | ||
| 4 | |||
| 5 | 3 | Timothée Floure | h3. Contact customer for setup informations | 
| 6 | |||
| 7 | Do not forget to replace @$CUSTMER@! | ||
| 8 | |||
| 9 | <pre> | ||
| 10 | Hello $CUSTOMER, | ||
| 11 | |||
| 12 | 4 | Timothée Floure | I will deploy your Matrix homeserver and need a few configuration details from | 
| 13 | you. I do not know how familiar you are with Matrix or technical terms: | ||
| 14 | 3 | Timothée Floure | do not hesitate to tell me if I go to fast or to slow for you. | 
| 15 | |||
| 16 | First of all, each Matrix homeserver is linked to domain name (you users will look | ||
| 17 | like `@username:domain.tld`) for federation. I can offer you two options here, | ||
| 18 | but remember that the chosen domain name cannot be changed afterward: | ||
| 19 | |||
| 20 | * Your own domain (e.g. domain.tld). | ||
| 21 | * One domain controlled by ungleich (e.g. $CUSTOMER.0co2.cloud, | ||
| 22 | $CUSTOMER.ungleich.cloud). | ||
| 23 | |||
| 24 | Secondly, I will deploy a Riot web matrix client for convenience (you can use | ||
| 25 | the desktop or smartphone clients as well) and need a domain for that as well: | ||
| 26 | |||
| 27 | * Your own domain (e.g. matrix.domain.tld) | ||
| 28 | * One domain controlled by ungleich (e.g. matrix.$CUSTOMER.0c02.cloud). | ||
| 29 | |||
| 30 | Lastly, I will configure the Matrix homeserver for you. You can ask us to set | ||
| 31 | any configuration option but we at least need to know your preferences in term | ||
| 32 | of registration: | ||
| 33 | * Should it be backed by an existing user directory (LDAP)? | ||
| 34 | * Should registrations be filtered by domain of email address? (e.g. anyone | ||
| 35 | with a @domain.tld email address can register). | ||
| 36 | * Should anyone be allowed to register? | ||
| 37 | |||
| 38 | Feel free to ask me any matrix-related question, as I am a heavy matrix user | ||
| 39 | myself. | ||
| 40 | |||
| 41 | Best Regards, | ||
| 42 | |||
| 43 | -- | ||
| 44 | </pre> | ||
| 45 | |||
| 46 | 1 | Timothée Floure | h3. Deploy new MaaS instance | 
| 47 | |||
| 48 | 5 | Timothée Floure | WIP -> ask @fnux for now. | 
| 49 | 1 | Timothée Floure | |
| 50 | 5 | Timothée Floure | * Contact customer to get configuration details (this might take some time => do it first). | 
| 51 | * Allocate VM in OpenNebula, based on Debian 10 (IPv6Only). | ||
| 52 | * Attach HDD storage to created VM (Help: [[Common operations at DCLIPv6OnlyHosting]]). | ||
| 53 | - Create EXT4 filesystem: @mkfs.ext4 $DEVICE@ | ||
| 54 | - Add FSTAB entry for /var on $DEVICE. | ||
| 55 | - Get UUID with @blkid@. | ||
| 56 | - Should look like: @UUID=$MY_UUID /var ext4 errors=remount-ro 1 2@ | ||
| 57 | - Mount data disk on /mnt. | ||
| 58 | - Move content of /var to /mnt. | ||
| 59 | - Unmount data disk from /mnt. | ||
| 60 | - Mount data disk to /var with @mount -a@ (uses configuration in /etc/fstab). | ||
| 61 | - *Reboot* and make sure that /var is properly mounted. | ||
| 62 | |||
| 63 | 2 | Timothée Floure | * Upgrade VM: update/upgrade. | 
| 64 | * Add DNS entry in matrix.ungleich.cloud | ||
| 65 | * Add server to matrix-as-a-service manifest, deploy | ||
| 66 | * Have customer configure his domain. | ||
| 67 | * Create initial admin use. | ||
| 68 | |||
| 69 | 1 | Timothée Floure | h3. Upgrade a running MaaS instance | 
| 70 | |||
| 71 | TODO -> ask @fnux for now. | ||
| 72 | |||
| 73 | h3. Deploy Matterbridge application service | ||
| 74 | |||
| 75 | TODO -> ask @fnux for now. |