Version 29.1 von Jens Gruber am 2022/05/16 10:34

Zeige letzte Bearbeiter
1 Mit den nachfolgenden Schritten können Sie eine neue Nextcloud Instanz auf einem Server mit dem Datenbank-Container pgsql13 installieren.
2
3
4 **1.** Stellen Sie sicher dass ihr logoDIDACT Server mindestens die Puppet-Version 1.4.0 besitzt. Dies ist für eine Aktivierung des Containers {{code language="bash"}}pgsql13{{/code}} notwendig.
5
6
7 **2.** Aktivieren Sie die Container {{code language="bash"}}nextcloud-g1{{/code}} ,  {{code language="bash"}}pgsql13{{/code}} und falls gewünscht den {{code language="bash"}}collabora-g1{{/code}} Container in der guest.conf im Puppeteer Container:
8
9 {{code language="bash"}}
10 root@ldhost:~ # lxc-ssh -n puppeteer
11 {{/code}}
12
13 {{code language="bash"}}
14 root@puppeteer:~ # vim /etc/logodidact/hosts/ldhost/guest.conf
15 {{/code}}
16
17 Ergänzen Sie die guest.conf um folgende Einträge:
18
19 {{code language="bash"}}
20 [Guest nextcloud-g1]
21 Ensure running
22
23 [Guest pgsql13]
24 Ensure running
25
26 # Falls gewünscht
27 [Guest collabora-g1]
28 Ensure running
29 {{/code}}
30
31 Übernehmen Sie die Änderungen ins git mit folgenden Befehlen:
32
33 {{code language="bash"}}
34 root@puppeteer:~ # cd /etc/logodidact
35 root@puppeteer:/etc/logodidact # git add .
36 root@puppeteer:/etc/logodidact # git commit -am "Aktivierung von Nextcloud und Collabora in der guest.conf."
37 {{/code}}
38
39
40 **3.** Kopieren Sie die nextcloud-g1.yaml und/oder collabora.yaml aus dem Template Verzeichnis:
41
42 Bei einer Nextcloud Nutzung mit Collabora kopieren Sie beide Dateien mit folgenden Befehl:
43
44 {{code language="bash"}}
45 root@puppeteer: # cp /usr/share/doc/ld-puppet10/templates/cloud/with_collabora/custom.d/* /etc/logodidact/hiera/custom.d/
46 {{/code}}
47
48
49 Sollten Sie nur die Nextcloud ohne Collabora nutzen wollen, führen Sie folgenden Befehl aus:
50
51 {{code language="bash"}}
52 root@puppeteer: # cp /usr/share/doc/ld-puppet10/templates/cloud/without_collabora/custom.d/* /etc/logodidact/hiera/custom.d/
53 {{/code}}
54
55
56 **4. (Führen Sie diesen Schritt nur durch wenn Sie Collabora nutzen möchten) **Bearbeiten Sie die **collabora-g1.yaml** so dass Sie den Platzhalter **"ShortName"** gegen den Shortname Ihrer Schule austauschen.
57
58 {{code language="bash"}}
59 root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/collabora-g1.yaml
60 {{/code}}
61
62 {{code language="bash"}}
63 ld_collabora::config::allowed_hosts:
64 - nextcloud.ShortName.logoip.de
65
66 {{/code}}
67
68
69 **5.** Bearbeiten Sie die **nextcloud-g1.yaml** und fügen Sie die ersten beiden Abschnitte hinzu, um pgsql13 als Datenbank zu verwenden.
70
71 Passen Sie außerdem die Platzhalter **"ShortName"** gegen den Shortname Ihrer Schule an.
72
73 {{code language="bash"}}
74 root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/nextcloud-g1.yaml
75 {{/code}}
76
77 {{code language="bash"}}
78 ld_nextcloud::install::params:
79 admin-user: ncadmin
80 database-host: &dbhost pgsql13
81 database-name: &dbname nextcloud
82 database-user: &dbuser nextcloud
83 data-dir: /var/lib/nextcloud
84
85 ld_nextcloud::db:
86 server: *dbhost
87
88 ld_nextcloud::config::app:
89 richdocuments.wopi_url:
90 value: 'https://collabora.ShortName.logoip.de'
91
92 ld_nextcloud::config::system:
93 trusted_domains:
94 - nextcloud.ShortName.logoip.de
95 {{/code}}
96
97
98 **6.** Übernehmen Sie die Änderungen ins git:
99
100 {{code language="bash"}}
101 root@puppeteer:~ # cd /etc/logodidact
102 root@puppeteer:/etc/logodidact # git add .
103 root@puppeteer:/etc/logodidact # git commit -am "nextcloud-g1.yaml angepasst."
104 {{/code}}
105
106
107 **7. **Damit die Nextcloud von außen erreichbar wird, müssen Sie den Rev-Proxy Container aktiviert haben und folgende Einträge in der **revproxy.conf** setzen:
108
109 Wechseln Sie in den Puppeteer:
110
111 {{code language="bash"}}
112 root@ldhost:~ # lxc-ssh -n puppeteer
113 {{/code}}
114
115 Fügen Sie folgende Zeilen in die **revproxy.conf **ein und tauschen die Platzhalter** "SCHULKUERZEL" **durch den jeweiligen Shortname Ihrer Schule:
116
117 {{code language="bash"}}
118 root@puppeteer:~ # vim /etc/logodidact/hosts/rev-proxy/revproxy.conf
119 {{/code}}
120
121 {{code language="bash"}}
122 [ReverseProxy nextcloud.SCHULKUERZEL.logoip.de]
123 Url https://nextcloud
124
125 # Falls gewünscht
126 [ReverseProxy collabora.SCHULKUERZEL.logoip.de]
127 Url https://collabora
128 {{/code}}
129
130
131 Übernehmen Sie die Änderungen ins Git:
132
133 {{code language="bash"}}
134 root@puppeteer:~ # cd /etc/logodidact
135 root@puppeteer:/etc/logodidact # git add .
136 root@puppeteer:/etc/logodidact # git commit -am "revproxy.conf um Einträge für Nextcloud und Collabora ergänzt."
137 {{/code}}
138
139
140 **9.** Nun sollten Sie Zertifikate für die Nextcloud und evlt. Collabora Adressen beantragen. Hier gibt es je nach verwendetem Programm (acmetool & acme.sh) zwei Wege:
141
142 Sollte es bei der Nutzung des acmetools zu Problemen kommen, kann die Einrichtung von Split-DNS helfen. Eine Anleitung zur Einrichtung finden Sie unter folgender Adresse: [[Einrichtung Split-DNS>>https://kb.logodidact.com/xwiki/bin/view/Main/LD%20Server/Allgemein/Einrichtung%20Split-DNS/]]
143
144 ===== __
145 acmetool__ =====
146
147 Wechseln Sie in den puppeteer Container:
148
149 {{code language="bash"}}
150 root@ldhost:~ # lxc-ssh -n puppeteer
151 {{/code}}
152
153
154 Fordern Sie die Zertifikate für die Nextcloud und Collabora Adressen mit folgendem Befehl an (Ersetzen Sie **"SCHULKUERZEL"** mit dem jeweiligen Shortname):
155
156 {{code language="bash"}}
157 root@puppeteer:~ # acmetool want nextcloud.SCHULKUERZEL.logoip.de
158
159 # Falls gewünscht
160 root@puppeteer:~ # acmetool want collabora.SCHULKUERZEL.logoip.de
161 {{/code}}
162
163 ===== =====
164
165 ===== =====
166
167 ===== __
168 acme.sh__ =====
169
170 Wechseln Sie in den puppeteer Container:
171
172 {{code language="bash"}}
173 root@ldhost:~ # lxc-ssh -n puppeteer
174 {{/code}}
175
176
177 Wechseln Sie im puppeteer Container in die Umgebung für das Verwalten der Zertifikate:
178
179 {{code language="bash"}}
180 root@puppeteer:~ # sle
181 {{/code}}
182
183
184 Beantragen Sie ein neues Zertifikat mit folgendem Befehl (Ersetzen Sie **"SCHULKUERZEL"** mit dem jeweiligen Shortname):
185
186 {{code language="bash"}}
187 le-acme@puppeteer:~ $ issue nextcloud.SCHULKUERZEL.logoip.de
188
189 # Falls gewünscht
190 le-acme@puppeteer:~ $ issue collabora.SCHULKUERZEL.logoip.de
191 {{/code}}
192
193
194 **10.** Um Nutzern Zugriff auf die Nextcloud zu ermöglichen, muss in der LogoDIDACT-Console eine Rolle mit dem Namen **"ld-sg-nextcloud" **erstellen werden.
195
196 Fügen Sie Benutzer der Rolle ld-sg-nextcloud hinzu. Nur Nutzer in dieser Gruppe können sich an der Nextcloud-Plattform anmelden, es kann bis zu 5-Minuten dauern bis die Aktivierung erfolgt.
197
198 [[image:1652079923794-166.png]]
199
200
201 **11.** Zu guter Letzt können Sie die Anmeldung wie folgt überprüfen:
202
203
204 Rufen Sie in ihrem Browser folgende Adresse auf (Ersetzen Sie **"SCHULKUERZEL"** durch den Shortname):
205
206 {{code language="bash"}}
207 https://nextcloud.SCHULKUERZEL.logoip.de/
208 {{/code}}
209
210
211 Melden Sie sich mit einem zur Gruppe hinzugefügtem Benutzer an:
212
213 [[image:1652080106839-833.png]]