aboutsummaryrefslogtreecommitdiff
path: root/DOCUMENTATION.md
diff options
context:
space:
mode:
Diffstat (limited to 'DOCUMENTATION.md')
-rw-r--r--DOCUMENTATION.md30
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 @@
1Get Started 1Get 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
58To build nixops machines 57To build nixops machines
59------------------------ 58------------------------
60 59
61The `NIX_PATH` environment variable is built in nixops/Makefile and 60The `NIX_PATH` environment variable is built in deploy/Makefile and
62contains three paths: nixpkgs, nixpkgsNext, nixpkgsPrevious. Only the 61contains three paths: nixpkgs, nixpkgsNext, nixpkgsPrevious. Only the
63first one is actually used most of the time. Derivations that need 62first one is actually used most of the time. Derivations that need
64pinned nixpkgs should declare it in `nix/sources.json` (it’s the case 63pinned 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
259Flakes 279Flakes
260------ 280------
261 281