From 3563d18c0c6299963adab395804a49e27b958ecf Mon Sep 17 00:00:00 2001
From: Benjamin Bohard <bbohard@cadoles.com>
Date: Mon, 7 Sep 2020 16:43:21 +0200
Subject: [PATCH] =?UTF-8?q?=C3=A9l=C3=A9ments=20pour=20les=20exercices?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../creole-dictionnaire-structure.tex         |   7 +
 .../modules_EOLE_envole/exercices/creole.dtd  | 237 ++++++++++++++++++
 .../exercices/vnstat-activation.tex           |   2 +
 .../exercices/vnstat-contrainte.tex           |   2 +
 .../exercices/vnstat-documentation.tex        |   2 +
 .../exercices/vnstat-gestion-reseau.tex       |   2 +
 .../exercices/vnstat-gestion-service.tex      |   2 +
 .../exercices/vnstat-template.tex             |   2 +
 .../ressources/vnstat/90-vnstat               |  16 ++
 .../ressources/vnstat/vnstat.conf             | 170 +++++++++++++
 10 files changed, 442 insertions(+)
 create mode 100644 content/modules_EOLE_envole/exercices/creole-dictionnaire-structure.tex
 create mode 100644 content/modules_EOLE_envole/exercices/creole.dtd
 create mode 100644 content/modules_EOLE_envole/exercices/vnstat-activation.tex
 create mode 100644 content/modules_EOLE_envole/exercices/vnstat-contrainte.tex
 create mode 100644 content/modules_EOLE_envole/exercices/vnstat-documentation.tex
 create mode 100644 content/modules_EOLE_envole/exercices/vnstat-gestion-reseau.tex
 create mode 100644 content/modules_EOLE_envole/exercices/vnstat-gestion-service.tex
 create mode 100644 content/modules_EOLE_envole/exercices/vnstat-template.tex
 create mode 100755 content/modules_eole_envole/ressources/vnstat/90-vnstat
 create mode 100644 content/modules_eole_envole/ressources/vnstat/vnstat.conf

diff --git a/content/modules_EOLE_envole/exercices/creole-dictionnaire-structure.tex b/content/modules_EOLE_envole/exercices/creole-dictionnaire-structure.tex
new file mode 100644
index 0000000..091d067
--- /dev/null
+++ b/content/modules_EOLE_envole/exercices/creole-dictionnaire-structure.tex
@@ -0,0 +1,7 @@
+\skbheading{Explorer la structure d’un dictionnaire Creole}
+
+Un dictionnaire Creole est une description de la configuration à l’aide du format de fichier \emph{xml}.
+
+fichier content/modules\_EOLE\_envole/exercices/creole-dictionnaire-structure.tex à éditer
+
+\inputminted[]{xml}{./content/modules_EOLE_envole/exercices/creole.dtd}
diff --git a/content/modules_EOLE_envole/exercices/creole.dtd b/content/modules_EOLE_envole/exercices/creole.dtd
new file mode 100644
index 0000000..91cec67
--- /dev/null
+++ b/content/modules_EOLE_envole/exercices/creole.dtd
@@ -0,0 +1,237 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+
+<!-- ===================================================================== -->
+
+<!-- Definition de la DTD du fichier creole -->
+
+<!-- ===================================================================== -->
+
+<!--
+#    Conception :
+#    Eole (http://eole.orion.education.fr)
+
+#    Copyright (C) 2005-2018
+
+#    distribue sous la licence GPL-2
+
+#    En attendant une traduction officielle de la GPL, la notice de
+#    copyright demeure en anglais.
+
+#    This program is free software; you can redistribute it and/or modify
+#    it under the terms of the GNU General Public License as published by
+#    the Free Software Foundation; either version 2 of the License, or
+#    (at your option) any later version.
+
+#    This program is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU General Public License for more details.
+
+#    You should have received a copy of the GNU General Public License
+#    along with this program; if not, write to the Free Software
+#    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+#    Se reporter a la documentation envoyee avec le programme pour la notice.
+
+-->
+<!--================ -->
+<!-- root element    -->
+<!-- =============== -->
+
+<!ELEMENT creole (containers | files | family_action | variables | constraints | help)*>
+
+<!-- ============== -->
+<!-- files element  -->
+<!-- ============== -->
+
+<!ELEMENT family_action (action)>
+<!ATTLIST family_action name CDATA #REQUIRED>
+<!ATTLIST family_action description CDATA #IMPLIED>
+<!ATTLIST family_action color CDATA #IMPLIED>
+<!ATTLIST family_action image CDATA #IMPLIED>
+<!ELEMENT action ((input* | profile* | ewtapp* | tag* | saltaction*)*)>
+<!ATTLIST action type (form|custom|external|reader|apache) "custom">
+<!ATTLIST action title CDATA #REQUIRED>
+<!ATTLIST action description CDATA #REQUIRED>
+<!ATTLIST action rewrite CDATA #IMPLIED>
+<!ATTLIST action image CDATA #IMPLIED>
+<!ATTLIST action actionlist CDATA #IMPLIED>
+<!-- for apache action -->
+<!ATTLIST action apache_path CDATA #IMPLIED>
+<!ATTLIST action apache_path_type (FilenameOption|SymLinkOption) "FilenameOption">
+<!-- for external action -->
+<!ATTLIST action url CDATA #IMPLIED>
+<!ATTLIST action url_type (URLOption|SymLinkOption) "URLOption">
+<!-- for form action -->
+<!ATTLIST action save (True|False) "False">
+<!ELEMENT files ((service* | service_access* | service_restriction* | package* | file*)*)>
+
+<!ELEMENT containers ((container* | all*)*)>
+
+<!ELEMENT container ((service* | service_access* | service_restriction* | interface* | package* | file* | disknod* | host* | fstab*)*) >
+<!ATTLIST container name CDATA #REQUIRED >
+<!ATTLIST container id CDATA #IMPLIED >
+<!ATTLIST container group CDATA #IMPLIED >
+
+<!ELEMENT all ((service* | interface* | package* | file* | disknod* | host* | fstab*)*) >
+
+<!ELEMENT service (#PCDATA)>
+<!ATTLIST service servicelist CDATA #IMPLIED >
+<!ATTLIST service instance_mode (when_container|when_no_container|always) "always">
+<!ATTLIST service method (systemd|upstart|apache|network|restartonly) "systemd">
+<!ATTLIST service redefine (True|False) "False">
+
+<!ELEMENT input (#PCDATA)>
+<!ELEMENT profile (#PCDATA)>
+<!ELEMENT ewtapp (#PCDATA)>
+<!ELEMENT tag (#PCDATA)>
+<!ELEMENT saltaction (#PCDATA)>
+
+<!ELEMENT service_access ((port | tcpwrapper)*)>
+<!ATTLIST service_access service CDATA #REQUIRED >
+
+<!ELEMENT port (#PCDATA)> <!--port_type-->
+<!ATTLIST port port_type (PortOption|SymLinkOption) "PortOption">
+<!ATTLIST port service_accesslist CDATA #IMPLIED >
+<!ATTLIST port protocol (tcp|udp) "tcp">
+
+<!ELEMENT tcpwrapper (#PCDATA)> <!--tcpwrapper_type-->
+<!ATTLIST tcpwrapper tcpwrapper_type (UnicodeOption|SymLinkOption) "UnicodeOption">
+<!ATTLIST tcpwrapper service_accesslist CDATA #IMPLIED >
+
+<!ELEMENT service_restriction (ip*)>
+<!ATTLIST service_restriction service CDATA #REQUIRED >
+
+<!ELEMENT ip (#PCDATA)> <!--ip_type-->
+<!ATTLIST ip service_restrictionlist CDATA #IMPLIED >
+<!ATTLIST ip ip_type (NetworkOption|SymLinkOption) "NetworkOption">
+<!ATTLIST ip interface_type (UnicodeOption|SymLinkOption) "UnicodeOption">
+<!ATTLIST ip interface CDATA #REQUIRED> <!--interface_type-->
+<!ATTLIST ip netmask_type (NetmaskOption|SymLinkOption) "NetmaskOption">
+<!ATTLIST ip netmask CDATA "255.255.255.255"> <!--netmask_type-->
+
+<!ELEMENT interface (#PCDATA)>
+<!ATTLIST interface interfacelist CDATA #IMPLIED >
+<!ATTLIST interface linkto CDATA #REQUIRED >
+<!ATTLIST interface ip CDATA #REQUIRED> <!--SymLinkOption-->
+<!ATTLIST interface ip_type (SymLinkOption) "SymLinkOption">
+<!ATTLIST interface mask CDATA #REQUIRED> <!--SymLinkOption-->
+<!ATTLIST interface mask_type (SymLinkOption) "SymLinkOption">
+<!ATTLIST interface bcast CDATA #IMPLIED> <!--SymLinkOption-->
+<!ATTLIST interface bcast_type (SymLinkOption) "SymLinkOption">
+<!ATTLIST interface gateway CDATA #IMPLIED> <!--SymLinkOption-->
+<!ATTLIST interface gateway_type (SymLinkOption) "SymLinkOption">
+<!ATTLIST interface method (bridge|macvlan) "macvlan" >
+<!ATTLIST interface redefine (True|False) "False">
+
+<!ELEMENT host EMPTY >
+<!ATTLIST host hostlist CDATA #IMPLIED >
+<!ATTLIST host name CDATA #REQUIRED > <!--SymLinkOption-->
+<!ATTLIST host name_type (SymLinkOption) "SymLinkOption">
+<!ATTLIST host ip CDATA #REQUIRED > <!--SymLinkOption-->
+<!ATTLIST host ip_type (SymLinkOption) "SymLinkOption">
+<!ATTLIST host crossed (True|False) "True" >
+<!ATTLIST host instance_mode (when_container|when_no_container|always) "always">
+<!ATTLIST host comment CDATA #IMPLIED >
+
+<!ELEMENT fstab EMPTY >
+<!ATTLIST fstab name CDATA #REQUIRED> <!--name_type-->
+<!ATTLIST fstab name_type (FilenameOption|SymLinkOption) "FilenameOption">
+<!ATTLIST fstab type (bind|normal) "bind">
+<!ATTLIST fstab fstype (auto|ext3|ext4|nfs|smb) "auto">
+<!ATTLIST fstab mount_point CDATA #IMPLIED> <!--mount_point_type-->
+<!ATTLIST fstab mount_point_type (FilenameOption|SymLinkOption) "FilenameOption">
+<!ATTLIST fstab options CDATA #IMPLIED>
+<!ATTLIST fstab checks CDATA #IMPLIED>
+<!ATTLIST fstab fstablist CDATA #IMPLIED>
+<!ATTLIST fstab instance_mode (when_container|when_no_container|always) "when_container">
+
+<!ELEMENT package (#PCDATA)>
+<!ATTLIST package instance_mode (when_container|when_no_container|always) "always">
+
+<!ELEMENT disknod (#PCDATA)>
+
+<!ELEMENT file EMPTY>
+<!ATTLIST file name CDATA #REQUIRED >
+<!ATTLIST file name_type (UnicodeOption|SymLinkOption) "UnicodeOption">
+<!ATTLIST file source CDATA #IMPLIED>
+<!ATTLIST file mode CDATA #IMPLIED >
+<!ATTLIST file owner CDATA #IMPLIED >
+<!ATTLIST file group CDATA #IMPLIED >
+<!ATTLIST file filelist CDATA #IMPLIED >
+<!ATTLIST file mkdir (True|False) "False">
+<!ATTLIST file instance_mode (when_container|when_no_container|always) "always">
+<!ATTLIST file rm (True|False) "False">
+<!ATTLIST file del_comment CDATA #IMPLIED >
+<!ATTLIST file redefine (True|False) "False">
+
+<!ELEMENT variables (family*, separators*)>
+<!ELEMENT family (#PCDATA | variable)*>
+<!ATTLIST family name CDATA #REQUIRED>
+<!ATTLIST family description CDATA #IMPLIED>
+<!ATTLIST family mode (basic|normal|expert) "basic">
+<!ATTLIST family icon CDATA #IMPLIED>
+<!ATTLIST family hidden (True|False) "False">
+<!ATTLIST family dynamic CDATA #IMPLIED>
+
+<!ELEMENT variable (#PCDATA | value)*>
+<!ATTLIST variable name CDATA #REQUIRED>
+<!ATTLIST variable type CDATA #IMPLIED>
+<!ATTLIST variable description CDATA #IMPLIED>
+<!ATTLIST variable hidden (True|False) "False">
+<!ATTLIST variable disabled (True|False) "False">
+<!ATTLIST variable multi (True|False) "False">
+<!ATTLIST variable redefine (True|False) "False">
+<!ATTLIST variable exists (True|False) "True">
+<!ATTLIST variable mandatory (True|False) "False">
+<!ATTLIST variable auto_freeze (True|False) "False">
+<!ATTLIST variable auto_save (True|False) "False">
+<!ATTLIST variable mode (basic|normal|expert) "normal">
+<!ATTLIST variable remove_check (True|False) "False">
+<!ATTLIST variable remove_condition (True|False) "False">
+
+<!ELEMENT separators (separator*)>
+
+<!ELEMENT separator (#PCDATA)>
+<!ATTLIST separator name CDATA #REQUIRED>
+<!ATTLIST separator never_hidden CDATA #IMPLIED>
+
+<!ELEMENT value (#PCDATA)>
+
+<!ELEMENT constraints ((fill* | check* | condition* | auto* | group*)*)>
+<!ELEMENT fill (param*)>
+<!ATTLIST fill name CDATA #REQUIRED>
+<!ATTLIST fill target CDATA #REQUIRED>
+
+<!ELEMENT check (param*)>
+<!ATTLIST check name CDATA #REQUIRED>
+<!ATTLIST check target CDATA #REQUIRED>
+<!ATTLIST check level (error|warning) "error">
+
+<!ELEMENT auto ((param)*)>
+<!ATTLIST auto name CDATA #REQUIRED>
+<!ATTLIST auto target CDATA #REQUIRED>
+
+<!ELEMENT condition ((target | param)+ )>
+<!ATTLIST condition name CDATA #REQUIRED>
+<!ATTLIST condition source CDATA #REQUIRED>
+<!ATTLIST condition fallback (True|False) "False">
+
+<!ELEMENT group (slave+)>
+<!ATTLIST group master CDATA #REQUIRED>
+<!ATTLIST group description CDATA #IMPLIED>
+
+<!ELEMENT param (#PCDATA)>
+<!ATTLIST param type (string|eole|number|container|context|python) "string">
+<!ATTLIST param name CDATA #IMPLIED>
+<!ATTLIST param hidden (True|False) "True">
+<!ATTLIST param optional (True|False) "False">
+
+<!ELEMENT target (#PCDATA)>
+<!ATTLIST target type (family|filelist|servicelist|interfacelist|variable|service_accesslist|service_restrictionlist|hostlist|fstablist|actionlist) "variable">
+<!ATTLIST target optional (True|False) "False">
+
+<!ELEMENT slave (#PCDATA)>
+
+<!ELEMENT help ((variable* | family*)*)>
+
diff --git a/content/modules_EOLE_envole/exercices/vnstat-activation.tex b/content/modules_EOLE_envole/exercices/vnstat-activation.tex
new file mode 100644
index 0000000..f34aefd
--- /dev/null
+++ b/content/modules_EOLE_envole/exercices/vnstat-activation.tex
@@ -0,0 +1,2 @@
+\skbheading{vnstat-activation.tex}
+fichier content/modules\_EOLE\_envole/exercices/vnstat-activation.tex à éditer
\ No newline at end of file
diff --git a/content/modules_EOLE_envole/exercices/vnstat-contrainte.tex b/content/modules_EOLE_envole/exercices/vnstat-contrainte.tex
new file mode 100644
index 0000000..5c7283d
--- /dev/null
+++ b/content/modules_EOLE_envole/exercices/vnstat-contrainte.tex
@@ -0,0 +1,2 @@
+\skbheading{vnstat-contrainte.tex}
+fichier content/modules\_EOLE\_envole/exercices/vnstat-contrainte.tex à éditer
\ No newline at end of file
diff --git a/content/modules_EOLE_envole/exercices/vnstat-documentation.tex b/content/modules_EOLE_envole/exercices/vnstat-documentation.tex
new file mode 100644
index 0000000..3baace4
--- /dev/null
+++ b/content/modules_EOLE_envole/exercices/vnstat-documentation.tex
@@ -0,0 +1,2 @@
+\skbheading{vnstat-documentation.tex}
+fichier content/modules\_EOLE\_envole/exercices/vnstat-documentation.tex à éditer
\ No newline at end of file
diff --git a/content/modules_EOLE_envole/exercices/vnstat-gestion-reseau.tex b/content/modules_EOLE_envole/exercices/vnstat-gestion-reseau.tex
new file mode 100644
index 0000000..fd42937
--- /dev/null
+++ b/content/modules_EOLE_envole/exercices/vnstat-gestion-reseau.tex
@@ -0,0 +1,2 @@
+\skbheading{vnstat-gestion-reseau.tex}
+fichier content/modules\_EOLE\_envole/exercices/vnstat-gestion-reseau.tex à éditer
\ No newline at end of file
diff --git a/content/modules_EOLE_envole/exercices/vnstat-gestion-service.tex b/content/modules_EOLE_envole/exercices/vnstat-gestion-service.tex
new file mode 100644
index 0000000..3d34969
--- /dev/null
+++ b/content/modules_EOLE_envole/exercices/vnstat-gestion-service.tex
@@ -0,0 +1,2 @@
+\skbheading{vnstat-gestion-service.tex}
+fichier content/modules\_EOLE\_envole/exercices/vnstat-gestion-service.tex à éditer
\ No newline at end of file
diff --git a/content/modules_EOLE_envole/exercices/vnstat-template.tex b/content/modules_EOLE_envole/exercices/vnstat-template.tex
new file mode 100644
index 0000000..3c38491
--- /dev/null
+++ b/content/modules_EOLE_envole/exercices/vnstat-template.tex
@@ -0,0 +1,2 @@
+\skbheading{vnstat-template.tex}
+fichier content/modules\_EOLE\_envole/exercices/vnstat-template.tex à éditer
\ No newline at end of file
diff --git a/content/modules_eole_envole/ressources/vnstat/90-vnstat b/content/modules_eole_envole/ressources/vnstat/90-vnstat
new file mode 100755
index 0000000..0a6dbbf
--- /dev/null
+++ b/content/modules_eole_envole/ressources/vnstat/90-vnstat
@@ -0,0 +1,16 @@
+#!/bin/bash
+
+#set -e
+. /usr/lib/eole/diagnose.sh
+EchoGras "*** Service de statistique réseau"
+
+if [ "$(CreoleGet activer_vnstat)" = "oui" ]; then
+    TestPid vnStat vnstatd
+    echo
+    vnstat
+else
+    Inactif vnStat
+fi
+
+echo
+exit 0
diff --git a/content/modules_eole_envole/ressources/vnstat/vnstat.conf b/content/modules_eole_envole/ressources/vnstat/vnstat.conf
new file mode 100644
index 0000000..f600eb3
--- /dev/null
+++ b/content/modules_eole_envole/ressources/vnstat/vnstat.conf
@@ -0,0 +1,170 @@
+# vnStat 1.18 config file
+##
+
+# default interface
+%set %%interfaces = []
+%for interface in %%vnstat_interface
+%set %%zone = 'nom_zone_eth' + interface
+%silent %%interfaces.append(%%getVar(%%zone))
+%end for
+Interface "%%custom_join(%%interfaces,'+']"
+
+# location of the database directory
+DatabaseDir "/var/lib/vnstat"
+
+# locale (LC_ALL) ("-" = use system locale)
+Locale "-"
+
+# on which day should months change
+MonthRotate 1
+
+# date output formats for -d, -m, -t and -w
+# see 'man date' for control codes
+DayFormat    "%x"
+MonthFormat  "%b '%y"
+TopFormat    "%x"
+
+# characters used for visuals
+RXCharacter       "%"
+TXCharacter       ":"
+RXHourCharacter   "r"
+TXHourCharacter   "t"
+
+# how units are prefixed when traffic is shown
+# 0 = IEC standard prefixes (KiB/MiB/GiB/TiB)
+# 1 = old style binary prefixes (KB/MB/GB/TB)
+UnitMode 0
+
+# how units are prefixed when traffic rate is shown
+# 0 = IEC binary prefixes (Kibit/s...)
+# 1 = SI decimal prefixes (kbit/s...)
+RateUnitMode 1
+
+# output style
+# 0 = minimal & narrow, 1 = bar column visible
+# 2 = same as 1 except rate in summary and weekly
+# 3 = rate column visible
+OutputStyle 3
+
+# used rate unit (0 = bytes, 1 = bits)
+RateUnit 1
+
+# number of decimals to use in outputs
+DefaultDecimals 2
+HourlyDecimals 1
+
+# spacer for separating hourly sections (0 = none, 1 = '|', 2 = '][', 3 = '[ ]')
+HourlySectionStyle 2
+
+# try to detect interface maximum bandwidth, 0 = disable feature
+# MaxBandwidth will be used as fallback value when enabled
+BandwidthDetection 1
+
+# maximum bandwidth (Mbit) for all interfaces, 0 = disable feature
+# (unless interface specific limit is given)
+MaxBandwidth 1000
+
+# interface specific limits
+#  example 8Mbit limit for eth0 (remove # to activate):
+#MaxBWeth0 8
+
+# how many seconds should sampling for -tr take by default
+Sampletime 5
+
+# default query mode
+# 0 = normal, 1 = days, 2 = months, 3 = top10
+# 4 = exportdb, 5 = short, 6 = weeks, 7 = hours
+QueryMode 0
+
+# filesystem disk space check (1 = enabled, 0 = disabled)
+CheckDiskSpace 1
+
+# database file locking (1 = enabled, 0 = disabled)
+UseFileLocking 1
+
+# how much the boot time can variate between updates (seconds)
+BootVariation 15
+
+# log days without traffic to daily list (1 = enabled, 0 = disabled)
+TrafficlessDays 1
+
+
+# vnstatd
+##
+
+# switch to given user when started as root (leave empty to disable)
+DaemonUser "%%vnstat_user"
+
+# switch to given user when started as root (leave empty to disable)
+DaemonGroup "%%vnstat_group"
+
+# how many minutes to wait during daemon startup for system clock to
+# sync time if most recent database update appears to be in the future
+TimeSyncWait 5
+
+# how often (in seconds) interface data is updated
+UpdateInterval 30
+
+# how often (in seconds) interface status changes are checked
+PollInterval 5
+
+# how often (in minutes) data is saved to file
+SaveInterval 5
+
+# how often (in minutes) data is saved when all interface are offline
+OfflineSaveInterval 30
+
+# how often (in minutes) bandwidth detection is redone when
+# BandwidthDetection is enabled (0 = disabled)
+BandwidthDetectionInterval 5
+
+# force data save when interface status changes (1 = enabled, 0 = disabled)
+SaveOnStatusChange 1
+
+# enable / disable logging (0 = disabled, 1 = logfile, 2 = syslog)
+UseLogging 2
+
+# create dirs if needed (1 = enabled, 0 = disabled)
+CreateDirs 1
+
+# update ownership of files if needed (1 = enabled, 0 = disabled)
+UpdateFileOwner 1
+
+# file used for logging if UseLogging is set to 1
+LogFile "/var/log/vnstat/vnstat.log"
+
+# file used as daemon pid / lock file
+PidFile "/var/run/vnstat/vnstat.pid"
+
+
+# vnstati
+##
+
+# title timestamp format
+HeaderFormat "%x %H:%M"
+
+# show hours with rate (1 = enabled, 0 = disabled)
+HourlyRate 1
+
+# show rate in summary (1 = enabled, 0 = disabled)
+SummaryRate 1
+
+# layout of summary (1 = with monthly, 0 = without monthly)
+SummaryLayout 1
+
+# transparent background (1 = enabled, 0 = disabled)
+TransparentBg 0
+
+# image colors
+CBackground     "FFFFFF"
+CEdge           "AEAEAE"
+CHeader         "606060"
+CHeaderTitle    "FFFFFF"
+CHeaderDate     "FFFFFF"
+CText           "000000"
+CLine           "B0B0B0"
+CLineL          "-"
+CRx             "92CF00"
+CTx             "606060"
+CRxD            "-"
+CTxD            "-"