# Verbinden mit SSH (bei Linux und Mac OS X mit dem verfügbaren ssh Kommando, bei Windows wird z. B. Putty verwendet)
apt-get install python3 python3-pip
# Docker Installation nach Vorgabe in https://docs.docker.com/install/linux/docker-ce/ubuntu/ (zum Teil werden von Hosting-Anbietern auch Images mit vorinstalliertem Docker angeboten)
apt-get remove docker docker-engine docker.io containerd runc
apt-get update
apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg-agent \
    software-properties-common
# Ubuntu
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
# Fingerprint Check (siehe Docker Doku)
add-apt-repository \
   "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
   $(lsb_release -cs) \
   stable"
# Debian
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -
# Fingerprint Check (siehe Docker Doku)
add-apt-repository \
   "deb [arch=amd64] https://download.docker.com/linux/debian \
   $(lsb_release -cs) \
   stable"

# Ab hier unterscheidet sich das Vorgehen zwischen Ubuntu oder Debian nicht mehr
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io
# Installation von docker-compose nach Vorgabe in https://docs.docker.com/compose/install/
curl -L "https://github.com/docker/compose/releases/download/1.27.4/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
# Sicherstellen, dass auf dem Server kein weiterer Webserver läuft (das Projekt beinhaltet einen Nginx Reverse Proxy und benötigt freie Ports 80 und 443)
apt-get remove nginx apache2
# oder
systemctl disable nginx
systemctl stop nginx
systemctl disable apache2
systemctl stop apache2

cd /srv #Dieses Verzeichnis kann frei gewählt werden und ist nur ein Vorschlag (bitte Befehle entsprechend anpassen, wenn in ein anderes Verzeichnis installiert wird)
git clone https://github.com/Snap-School-Tools/snap-school.git
cd snap-school
# Pfad zur PATH-Variable hinzufügen, damit das Kontroll-Skript von überall aus aufgerufen werden kann
echo "export PATH=\$PATH:/srv/snap-school" >> ~/.bashrc
source ~/.bashrc # Alternativ aus- und wieder einloggen
bpctl -h # Hilfe für das Skript anzeigen
usage: bpctl [-h] {configure,start,stop,update,backup,purge} ...

Control script to control the digital learning environment

positional arguments:
  {configure,start,stop,update,backup,purge}
    configure           Configures the environment. Configure tools to use and
                        (sub) domains to install them on.
    start               Starts all docker containers
    stop                Stops all docker containers
    update              Updates all docker images and recreates changed
                        containers
    backup              Creates backups of all docker volumes and recreates
                        changed containers. Will pause containers during
                        backup operation.
    purge               Purges configuration, images, volumes but not backups
                        of the complete environment. Purge operation can
                        include other docker data that is not referenced
                        anymore (calls docker system prune)

optional arguments:
  -h, --help            show this help message and exit

bpctl configure
Enter an email address that will be used for letsencrypt (will receive warnings if certificates expire)
webmaster@example.org
Enter the client you want to activate during installation (default/school)
school
Enter all ILIAS instance's hostnames (one host name per line, for example ilias.my-school.com, ilias.my-school.provider.com, etc.)
ilias-school1.example.org
ilias-school2.example.org
ilias-school3.example.org

['ilias-school1.example.org', 'ilias-school2.example.org', 'ilias-school3.example.org']
Admin email: webmaster@example.org
ILIAS client: school
Configuration will be generated for the following domains:
ILIAS:
['ilias-school1.example.org', 'ilias-school2.example.org', 'ilias-school3.example.org']
Is that correct? (Y/N)
y
Nginx-proxy configuration is being generated
Nginx-proxy configuration ready
Ilias configuration is being generated
ilias-school1.example.org Mysql root password: "<pw1>"
ilias-school2.example.org Mysql root password: "<pw2>"
ilias-school3.example.org Mysql root password: "<pw3>"
ILIAS configuration ready.
[✓] Configuration finished successfully

bpctl start

Starting hosted blue print...
[*] Creating elearning docker network
70e530ea068a303980858d6725effbce0c0dd5e916dce810b2aa366cc1c5a8a3
[*] Starting Nginx reverse proxy...
Creating volume "nginx_nginx-proxy-certs" with default driver
Creating volume "nginx_nginx-proxy-vhosts" with default driver
Creating volume "nginx_nginx-proxy-html" with default driver
Creating nginx-proxy ... done
Creating nginx-letsencrypt ... done
[*] Waiting Nginx to launch on Port 80...
[*] Starting docker image with env file: ilias/env_ilias-school1.example.org
Creating volume "ilias-school1exampleorg_ilias_www" with default driver
Creating volume "ilias-school1exampleorg_ilias_data" with default driver
Creating volume "ilias-school1exampleorg_ilias_mysql" with default driver
Pulling ilias (digitallearningforschools/ilias-school:5.4)...
5.4: Pulling from digitallearningforschools/ilias-school
68ced04f60ab: Already exists
1d2a5d8fa585: Already exists
5d59ec4ae241: Already exists
d42331ef4d44: Already exists
408b7b7ee112: Already exists
570cd47896d5: Already exists
2419413b2a16: Already exists
c66b5dbcbf27: Already exists
fbe2e5e30914: Already exists
3657e888189a: Already exists
df6a9028e5fe: Already exists
31e8b5dd7268: Already exists
0b37cac42026: Already exists
3dfcad9611ac: Already exists
a1e292ea4302: Pull complete
98a6a90f7fa6: Pull complete
55421a3d4a90: Pull complete
caf8ea66ad0c: Pull complete
fb24c9610fca: Pull complete
a0d462320ee8: Pull complete
66ee6194624c: Pull complete
6f2302675cbf: Pull complete
8c014f074efa: Pull complete
1738562f3b49: Pull complete
b186250ae142: Pull complete
Digest: sha256:63e7b32273778862556de33548ca27ee9798ae85d13cdedbf9c09d846933a1e5
Status: Downloaded newer image for digitallearningforschools/ilias-school:5.4
Creating ilias-school1exampleorg_mysql_1 ... done
Creating ilias-school1exampleorg_ilias_1 ... done
[*] Starting docker image with env file: ilias/env_ilias-school2.example.org
Creating volume "ilias-school2exampleorg_ilias_www" with default driver
Creating volume "ilias-school2exampleorg_ilias_data" with default driver
Creating volume "ilias-school2exampleorg_ilias_mysql" with default driver
Creating ilias-school2exampleorg_mysql_1 ... done
Creating ilias-school2exampleorg_ilias_1 ... done
[*] Starting docker image with env file: ilias/env_ilias-school3.example.org
Creating volume "ilias-school3exampleorg_ilias_www" with default driver
Creating volume "ilias-school3exampleorg_ilias_data" with default driver
Creating volume "ilias-school3exampleorg_ilias_mysql" with default driver
Creating ilias-school3exampleorg_mysql_1 ... done
Creating ilias-school3exampleorg_ilias_1 ... done
[✓] All containers in the environment started successfully.

# Der erste Start kann eine ganze Weile dauern
# Das Login-Passwort für Ilias steht im Logfile nach der ersten Installation, z. B. für school1.example.org aus dem Beispiel:
cd ilias
docker-compose --env-file env_ilias-school1.example.org logs

[...]
ilias_1  | =======================================================
ilias_1  | ILIAS installed successfully!
ilias_1  | Log in using the following credentials:
ilias_1  | 
ilias_1  | User:           root
ilias_1  | Password:       <root_pw>
ilias_1  | Setup Password: <setup_pw>
ilias_1  | =======================================================
[...]

git pull # Bei Release Updates
bpctl update
The following operation will update all container images defined in docker-compose files of the projects. You should backup or create a VM snapshot before doing that. Do you want to start? (Y/N) y
[*] Pulling nginx images...

Pulling nginx-proxy             ... done
Pulling nginx-proxy-letsencrypt ... done
[*] Pulling ilias images (you can ignore warning messages that variables are not set)...
WARNING: The ILIAS_AUTO_SETUP variable is not set. Defaulting to a blank string.
WARNING: The ILIAS_DB_USER variable is not set. Defaulting to a blank string.
WARNING: The ILIAS_DB_PASSWORD variable is not set. Defaulting to a blank string.
WARNING: The ILIAS_HOST_NAME variable is not set. Defaulting to a blank string.
WARNING: The ILIAS_CLIENT_NAME variable is not set. Defaulting to a blank string.
WARNING: The ILIAS_DB_DUMP variable is not set. Defaulting to a blank string.
WARNING: The ILIAS_DEFAULT_SKIN variable is not set. Defaulting to a blank string.
WARNING: The ILIAS_DEFAULT_STYLE variable is not set. Defaulting to a blank string.
WARNING: The VIRTUAL_HOST variable is not set. Defaulting to a blank string.
WARNING: The LETSENCRYPT_HOST variable is not set. Defaulting to a blank string.
WARNING: The MYSQL_ROOT_PASSWORD variable is not set. Defaulting to a blank string.
WARNING: The MYSQL_DATABASE variable is not set. Defaulting to a blank string.
Pulling mysql ... done
Pulling ilias ... done
[*] Recreating containers...
Starting hosted blue print...
[*] Creating elearning docker network
[*] Starting Nginx reverse proxy...
nginx-proxy is up-to-date
nginx-letsencrypt is up-to-date
[*] Waiting Nginx to launch on Port 80...
[*] Starting docker image with env file: ilias/env_ilias-school1.example.org
ilias-school1exampleorg_mysql_1 is up-to-date
ilias-school1exampleorg_ilias_1 is up-to-date
[*] Starting docker image with env file: ilias/env_ilias-school2.example.org
ilias-school2exampleorg_mysql_1 is up-to-date
ilias-school2exampleorg_ilias_1 is up-to-date
[*] Starting docker image with env file: ilias/env_ilias-school3.example.org
ilias-school3exampleorg_mysql_1 is up-to-date
ilias-school3exampleorg_ilias_1 is up-to-date
[✓] All containers in the environment started successfully.
[✓] Updated successfully