From 7159502451b71d0d159d7f1b5c2e94906ad178f2 Mon Sep 17 00:00:00 2001 From: Alberto Larraz Date: Mon, 9 May 2022 11:48:22 +0000 Subject: [PATCH] Update docs/post-install.ca.md --- docs/post-install.ca.md | 161 ++++++++++++++++++++++++---------------- 1 file changed, 95 insertions(+), 66 deletions(-) diff --git a/docs/post-install.ca.md b/docs/post-install.ca.md index 3117175..22001e9 100644 --- a/docs/post-install.ca.md +++ b/docs/post-install.ca.md @@ -9,60 +9,6 @@ * WORDPRESS: https://wp.DOMINI/wp-login.php?normal -## -1. Instal·lació de software: - -Per generar certificats multidomini i del domini principal: -``` -apt install rsync vim tmux certbot -y -DOMAIN=digitaldemocratic.net -certbot certonly --preferred-challenges dns --manual --email digitaldemocratic@$DOMAIN --agree-tos -d *.$DOMAIN,$DOMAIN - -``` - -Donar d'alta al dns el wildcard o els subdominis: - - moodle - - nextcloud - - wp - - oof - - sso - - pad - - admin - - - -## 0. Esborrar dades i/o configs - -Si volem començar des de cero podem esborrar les dades i el repositori de codi (opcional) - -Esborrar dades: -``` -./dd-ctl reset-1714 - -``` - -Esborrar dades, configs, codi i certificats: - -``` -cd /opt/digitaldemocratic/src -./dd-ctl reset-1714 -cd .. -rm -rf /opt/digitaldemocratic/src - -hostname=test1 -cp /opt/src/digitaldemocratic/digitaldemocratic.conf /opt/src/digitaldemocratic.conf.backup - -git clone https://gitlab.com/digitaldemocratic/digitaldemocratic /opt/src/digitaldemocratic -cd /opt/src/digitaldemocratic -cp digitaldemocratic.conf.sample digitaldemocratic.conf -cp -r custom.sample custom -./securize_conf.sh -# Canvia els noms de domini de la configuració del dd pel hostname de la màquina -sed -i "s/DOMAIN=mydomain.com/DOMAIN=$hostname.digitaldemocratic.net/g" digitaldemocratic.conf -sed -i "s/LETSENCRYPT_DNS=/LETSENCRYPT_DNS=$hostname.digitaldemocratic.net/g" digitaldemocratic.conf -sed -i "s/LETSENCRYPT_EMAIL=/LETSENCRYPT_EMAIL=info@digitaldemocratic.net/g" digitaldemocratic.conf - -./dd-ctl repo-update -``` ## 1. Instal·lació des de Zero: @@ -74,12 +20,16 @@ git clone https://gitlab.com/digitaldemocratic/digitaldemocratic /opt/src/digita cd /opt/src/digitaldemocratic cp digitaldemocratic.conf.sample digitaldemocratic.conf -#update del repo i subrepos -./dd-ctl repo-update - #variables aleatories de config bash securize_conf.sh + +#copiem directori custom +cp -r custom.sample custom + + ``` + + - Canviem el nom del domini i si omplim les variables de LETSENCRYPT ja genera els certificats ```bash TITLE="Digital Democratic" @@ -95,15 +45,29 @@ LETSENCRYPT_EMAIL=suport-baixeras@digitaldemocratic.net LETSENCRYPT_DOMAIN_ROOT=true ``` -- Copiem el custom.sample i fem un ./dd-ctl all -```bash -cp -r custom.sample custom + +- repo update y dd-ctl all per arrencar +``` + +#update del repo i subrepos la primera vegada +./dd-ctl repo-update + +#per arrencar ./dd-ctl all + ``` ## 2. Configuració: +### 2.0. Crear primer usuari a saml per poder fer proves + +- anar a admin.DOMAIN +- crear un grup, per exemple: "docents" +- clic al botó de administration Resync +- anar a groups i verificar que apareix +- anar a users i crear l'usuari "docent01" del grup "docents" amb role "teacher" + ### 2.1. Configuració del Keycloak Go to https://sso.DOMINI/auth/admin/master/console @@ -145,7 +109,7 @@ Configurem d'aquest manera: **CLIENT**: -- [ ] Clients -> Ajustos -> Afegir "https://moodle.DOMINI.net/*" a més de la de wp "https://wp.DOMINI.net/*" +- [ ] Clients -> Account-console -> Settings -> Afegir a *Valid Redirect URIs* "https://moodle.DOMINI.net/*" a més de la de wp "https://wp.DOMINI.net/*" ![](https://i.imgur.com/vgamSuC.png) @@ -159,6 +123,10 @@ Configurem d'aquest manera: ### 2.2. Configuració Wordpress + + + + ![](img/snapshot/Nk8YPCI.png) ![](img/snapshot/3ZRPyzd.png) @@ -185,11 +153,6 @@ Afegim aquests paràmetres: Guardem la configuració. -Verificar que el plugin GenerateBlock i el tema GeneratePress estan instal·lats i activats. - -![](img/snapshot/gZGNZXY.png) - -![](img/snapshot/iThTdIa.png) @@ -386,6 +349,7 @@ docker exec isard-sso-admin python3 /admin/saml_scripts/moodle_saml.py **6. Cal fer uns últims retocs:** +(això ja està fet, cal eliminar aquesta part del manual de post-install) A la mateixa pàgina on ens trobem: - Per a que ja no et demani entrar com a Moodle i vagi automàticament al SSO: @@ -411,6 +375,15 @@ A la mateixa pàgina on ens trobem: ### 4.3. Configuració de WordPress + + +Verificar que el plugin GenerateBlock i el tema GeneratePress estan instal·lats i activats. + +![](img/snapshot/gZGNZXY.png) + +![](img/snapshot/iThTdIa.png) + + - Per configurar la hora i l'idioma ![](img/snapshot/JbyHUqJ.png) @@ -421,6 +394,62 @@ A la mateixa pàgina on ens trobem: +## Troubleshooting + +## -1. Instal·lació de software: + +Per generar certificats multidomini i del domini principal: +``` +apt install rsync vim tmux certbot -y +DOMAIN=digitaldemocratic.net +certbot certonly --preferred-challenges dns --manual --email digitaldemocratic@$DOMAIN --agree-tos -d *.$DOMAIN,$DOMAIN + +``` + +Donar d'alta al dns el wildcard o els subdominis: + - moodle + - nextcloud + - wp + - oof + - sso + - pad + - admin + + + +## 0. Esborrar dades i/o configs + +Si volem començar des de cero podem esborrar les dades i el repositori de codi (opcional) + +Esborrar dades: +``` +./dd-ctl reset-1714 + +``` + +Esborrar dades, configs, codi i certificats: + +``` +cd /opt/digitaldemocratic/src +./dd-ctl reset-1714 +cd .. +rm -rf /opt/digitaldemocratic/src + +hostname=test1 +cp /opt/src/digitaldemocratic/digitaldemocratic.conf /opt/src/digitaldemocratic.conf.backup + +git clone https://gitlab.com/digitaldemocratic/digitaldemocratic /opt/src/digitaldemocratic +cd /opt/src/digitaldemocratic +cp digitaldemocratic.conf.sample digitaldemocratic.conf +cp -r custom.sample custom +./securize_conf.sh +# Canvia els noms de domini de la configuració del dd pel hostname de la màquina +sed -i "s/DOMAIN=mydomain.com/DOMAIN=$hostname.digitaldemocratic.net/g" digitaldemocratic.conf +sed -i "s/LETSENCRYPT_DNS=/LETSENCRYPT_DNS=$hostname.digitaldemocratic.net/g" digitaldemocratic.conf +sed -i "s/LETSENCRYPT_EMAIL=/LETSENCRYPT_EMAIL=info@digitaldemocratic.net/g" digitaldemocratic.conf + +./dd-ctl repo-update +```