diff options
Diffstat (limited to 'DOCUMENTATION.md')
-rw-r--r-- | DOCUMENTATION.md | 30 |
1 files changed, 25 insertions, 5 deletions
diff --git a/DOCUMENTATION.md b/DOCUMENTATION.md index 6c68680..fcd0b15 100644 --- a/DOCUMENTATION.md +++ b/DOCUMENTATION.md | |||
@@ -1,7 +1,7 @@ | |||
1 | Get Started | 1 | Get Started |
2 | =========== | 2 | =========== |
3 | 3 | ||
4 | - You may run ./nixops/scripts/setup to setup the directory and variables | 4 | - You may run ./scripts/setup to setup the directory and variables |
5 | The script won’t do anything without asking first, you may stop at any | 5 | The script won’t do anything without asking first, you may stop at any |
6 | step. | 6 | step. |
7 | 7 | ||
@@ -43,8 +43,7 @@ The directory is divided in several sections: | |||
43 | of hosts. They tend to be less used now. But sometimes they need to | 43 | of hosts. They tend to be less used now. But sometimes they need to |
44 | have an identity (mostly to be able to send e-mails) The subsection | 44 | have an identity (mostly to be able to send e-mails) The subsection |
45 | "roles" (ou=roles,ou=hosts,dc=immae,dc=eu) was from a Puppet age and | 45 | "roles" (ou=roles,ou=hosts,dc=immae,dc=eu) was from a Puppet age and |
46 | is deprecated. Only one host remains handled by Puppet (caldance) and | 46 | is deprecated. |
47 | should be replaced with an internal VM. | ||
48 | - The "groups" section (ou=groups,dc=immae,dc=eu) contains the generic | 47 | - The "groups" section (ou=groups,dc=immae,dc=eu) contains the generic |
49 | groups of users not associated to a service. | 48 | groups of users not associated to a service. |
50 | - The "group_users" and "users" sections contain the users (usually with | 49 | - The "group_users" and "users" sections contain the users (usually with |
@@ -58,7 +57,7 @@ How does nixpkgs resolve | |||
58 | To build nixops machines | 57 | To build nixops machines |
59 | ------------------------ | 58 | ------------------------ |
60 | 59 | ||
61 | The `NIX_PATH` environment variable is built in nixops/Makefile and | 60 | The `NIX_PATH` environment variable is built in deploy/Makefile and |
62 | contains three paths: nixpkgs, nixpkgsNext, nixpkgsPrevious. Only the | 61 | contains three paths: nixpkgs, nixpkgsNext, nixpkgsPrevious. Only the |
63 | first one is actually used most of the time. Derivations that need | 62 | first one is actually used most of the time. Derivations that need |
64 | pinned nixpkgs should declare it in `nix/sources.json` (it’s the case | 63 | pinned nixpkgs should declare it in `nix/sources.json` (it’s the case |
@@ -236,13 +235,18 @@ Nextcloud | |||
236 | --------- | 235 | --------- |
237 | 236 | ||
238 | - Do not skip major versions! | 237 | - Do not skip major versions! |
238 | - Check php supported version (lib/versioncheck.php file) | ||
239 | - Update all the apps: check on https://apps.nextcloud.com/ and build with | ||
240 | ``` | ||
241 | nix-build -E "with import <nixpkgs> {};webapps.nextcloud.withApps (a: builtins.attrValues webapps.nextcloud.allApps)" | ||
242 | ``` | ||
239 | - Put nextcloud in maintenance mode : | 243 | - Put nextcloud in maintenance mode : |
240 | ``` | 244 | ``` |
241 | nextcloud-occ maintenance:mode --on | 245 | nextcloud-occ maintenance:mode --on |
242 | ``` | 246 | ``` |
243 | - Do a backup : | 247 | - Do a backup : |
244 | ``` | 248 | ``` |
245 | sudo -u postgres pg_dump -n owncloud webapps > nextcloud.sql | 249 | sudo -u postgres pg_dump owncloud > nextcloud.sql |
246 | ``` | 250 | ``` |
247 | - Upgrade | 251 | - Upgrade |
248 | - Run the upgrade task : | 252 | - Run the upgrade task : |
@@ -256,6 +260,22 @@ Nextcloud | |||
256 | - Issues : | 260 | - Issues : |
257 | https://docs.nextcloud.com/server/16/admin_manual/maintenance/manual_upgrade.html | 261 | https://docs.nextcloud.com/server/16/admin_manual/maintenance/manual_upgrade.html |
258 | 262 | ||
263 | - Farm : | ||
264 | Once a new instance thename is created, create the database: | ||
265 | ``` | ||
266 | CREATE USER nextcloud_thename WITH PASSWORD 'somepassword'; | ||
267 | CREATE DATABASE nextcloud_thename WITH OWNER nextcloud_thename; | ||
268 | ``` | ||
269 | Then add this to the config.php: | ||
270 | ``` | ||
271 | 'appstoreenabled' => false, | ||
272 | ``` | ||
273 | Then run: | ||
274 | ``` | ||
275 | nextcloud-occ-thename maintenance:install --database=pgsql --database-name=nextcloud_thename --database-host=/run/postgresql --database-user=nextcloud_thename --admin-user=immae --data-dir=/var/lib/nextcloud_farm/thename/data | ||
276 | ``` | ||
277 | Finally, edit the config.php to add the correct trusted domain | ||
278 | |||
259 | Flakes | 279 | Flakes |
260 | ------ | 280 | ------ |
261 | 281 | ||