TP – Installer DokuWiki et structurer un wiki d'équipe

BTS SIO SISR 1re année – Bloc 1 – S16

Objectif

Installer et configurer DokuWiki sur Ubuntu Server pour créer un wiki d'équipe IT.

Prérequis

• VM Ubuntu Server 22.04 (peut réutiliser celle de S15)
• Accès sudo
• Apache et PHP déjà installés (si LAMP installé en S15)

ÉTAPE 1 — Vérifier/Installer Apache et PHP (10 min)

Si Apache/PHP déjà installés (S15) :

apache2 -v
php -v
# Si les deux fonctionnent, passer à l'étape 2

Si Apache/PHP non installés :

sudo apt update
sudo apt install apache2 php libapache2-mod-php php-xml php-gd php-zip -y
sudo systemctl start apache2
sudo systemctl enable apache2

ÉTAPE 2 — Télécharger DokuWiki (5 min)

cd /tmp
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
tar -xzf dokuwiki-stable.tgz

Identifier le dossier extrait :

ls -l /tmp
# Vous verrez un dossier dokuwiki-2024-02-06 (la date varie)

ÉTAPE 3 — Déplacer DokuWiki vers DocumentRoot (5 min)

# Remplacer 2024-02-06 par la date réelle du dossier
sudo mv /tmp/dokuwiki-2024-02-06 /var/www/dokuwiki

# Permissions
sudo chown -R www-data:www-data /var/www/dokuwiki
sudo chmod -R 755 /var/www/dokuwiki

ÉTAPE 4 — Configurer VirtualHost Apache (10 min)

sudo nano /etc/apache2/sites-available/wiki.conf

Contenu :

<VirtualHost *:80>
    ServerName wiki.local
    DocumentRoot /var/www/dokuwiki

    <Directory /var/www/dokuwiki/>
        Options FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/wiki_error.log
    CustomLog ${APACHE_LOG_DIR}/wiki_access.log combined
</VirtualHost>

Activer le site :

sudo a2ensite wiki.conf
sudo systemctl reload apache2

ÉTAPE 5 — Configurer /etc/hosts (Poste Client) (3 min)

Sur votre poste client (pas le serveur) :

Windows :

# Notepad en Administrateur
# C:\Windows\System32\drivers\etc\hosts

192.168.X.X    wiki.local

Linux/macOS :

sudo nano /etc/hosts

192.168.X.X    wiki.local

ÉTAPE 6 — Installation Web de DokuWiki (15 min)

Ouvrir le navigateur : http://wiki.local/install.php

Configuration de DokuWiki :

Champ	Valeur
Nom du wiki	Wiki Technique IT
Compte superutilisateur	admin
Nom complet	Administrateur Wiki
Email	admin@wiki.local
Mot de passe	AdminWiki2024!
Politique ACL	Public (lecture publique, écriture utilisateurs)
Licence	CC BY-SA (Creative Commons)

Cliquer "Sauvegarder"

Résultat : "DokuWiki est maintenant configuré."

ÉTAPE 7 — Sécuriser l'Installation (5 min)

# Supprimer le fichier d'installation (obligatoire)
sudo rm /var/www/dokuwiki/install.php

# Vérifier
ls /var/www/dokuwiki/install.php
# Résultat : No such file or directory

ÉTAPE 8 — Première Connexion (7 min)

Navigateur : http://wiki.local

Se connecter : - Cliquer "Connexion" (en haut à droite) - Identifiant : admin - Mot de passe : AdminWiki2024!

Explorer l'interface : - Éditer : Cliquer sur l'icône crayon pour éditer la page d'accueil - Créer une page : Taper [[:nouvelle_page]] dans l'éditeur → enregistrer → cliquer sur le lien rouge

TP PARTIE 2 — CRÉER LA STRUCTURE DU WIKI

Objectif

Créer une structure documentaire cohérente pour un wiki d'équipe IT.

ÉTAPE 1 — Créer l'Arborescence (15 min)

Structure recommandée pour un wiki IT :

Accueil
├── Serveurs
│   ├── Serveur Web (Apache)
│   ├── Serveur Base de Données (MySQL)
│   └── Serveur Fichiers
├── Réseau
│   ├── Architecture Réseau
│   ├── Configuration Switches
│   └── Configuration Firewall
├── Procédures
│   ├── Création Utilisateur AD
│   ├── Backup Serveurs
│   └── Déploiement WordPress
├── Incidents
│   └── Base d'Incidents Connus
└── Projet_1
    ├── Architecture
    ├── Planning
    └── Documentation Technique

Créer les pages :

1. Sur la page d'accueil, cliquer Éditer
2. Remplacer le contenu par :

====== Wiki Technique IT ======

Bienvenue sur le wiki de l'équipe IT.

===== Navigation =====

  * [[serveurs:accueil|Serveurs]]
  * [[reseau:accueil|Réseau]]
  * [[procedures:accueil|Procédures]]
  * [[incidents:accueil|Incidents]]
  * [[projet_1:accueil|Projet 1]]

===== Guide d'utilisation =====

Pour créer une nouvelle page :
  - Tapez le lien entre doubles crochets : ''<nowiki>[[nom_de_la_page]]</nowiki>''
  - Cliquez sur le lien rouge
  - Rédigez le contenu
  - Enregistrez

===== Règles de rédaction =====

  * **Toujours dater** les procédures
  * **Toujours indiquer l'auteur**
  * **Utiliser des captures d'écran** pour les procédures techniques
  * **Mettre à jour** les procédures obsolètes

1. Enregistrer

ÉTAPE 2 — Créer une Page "Serveurs" (10 min)

Cliquer sur le lien Serveurs (rouge) → Vous arrivez sur la page vide.

Contenu de la page serveurs:accueil :

====== Serveurs ======

Liste des serveurs de l'infrastructure.

===== Serveurs de Production =====

^ Nom       ^ IP            ^ Rôle           ^ OS                  ^ Responsable ^
| SRV-WEB01 | 192.168.10.10 | Serveur Web    | Ubuntu Server 22.04 | Admin       |
| SRV-DB01  | 192.168.10.11 | Base de données| Ubuntu Server 22.04 | Admin       |
| SRV-DC01  | 192.168.10.20 | Contrôleur AD  | Windows Server 2022 | Admin       |

===== Documentation par Serveur =====

  * [[serveurs:srv-web01|SRV-WEB01 — Serveur Web Apache]]
  * [[serveurs:srv-db01|SRV-DB01 — Serveur Base de Données MySQL]]
  * [[serveurs:srv-dc01|SRV-DC01 — Contrôleur de Domaine AD]]

Enregistrer

ÉTAPE 3 — Créer une Procédure Technique (15 min)

Aller sur la page d'accueil → cliquer Procédures → cliquer Création Utilisateur AD

Contenu de la page procedures:creation_utilisateur_ad :

====== Procédure : Création d'un Utilisateur Active Directory ======

**Auteur :** Admin \\
**Date de création :** 2024-02-16 \\
**Dernière mise à jour :** 2024-02-16 \\
**Version :** 1.0

===== Objectif =====

Créer un compte utilisateur dans Active Directory et l'affecter à la bonne Unité Organisationnelle (OU).

===== Prérequis =====

  * Accès au serveur contrôleur de domaine (SRV-DC01)
  * Droits d'administration sur Active Directory
  * Informations de l'utilisateur (nom, prénom, service)

===== Durée Estimée =====

5 minutes

===== Procédure =====

==== 1. Ouvrir la console Active Directory ====

  - Sur SRV-DC01, ouvrir **Utilisateurs et ordinateurs Active Directory**
  - Menu Démarrer → Outils d'administration Windows → Utilisateurs et ordinateurs AD

==== 2. Sélectionner l'Unité Organisationnelle ====

  - Dérouler l'arborescence : **techcorp.local** → **Utilisateurs** → **[Service]**
  - Exemple : **techcorp.local/Utilisateurs/Comptabilite**

==== 3. Créer l'utilisateur ====

  - Clic droit sur l'OU → **Nouveau** → **Utilisateur**
  - Remplir les champs :
    * Prénom : Pierre
    * Nom : Durand
    * Nom d'ouverture de session : pdurand
  - Cliquer **Suivant**

==== 4. Définir le mot de passe ====

  - Mot de passe : **Pass@2024!** (temporaire)
  - Cocher : ☑ L'utilisateur doit changer le mot de passe à la prochaine ouverture de session
  - Cliquer **Suivant** → **Terminer**

==== 5. Validation ====

  - L'utilisateur apparaît dans l'OU sélectionnée
  - Double-cliquer sur l'utilisateur → vérifier les propriétés

===== Vérification =====

  - Tenter une connexion avec le compte créé depuis un poste client
  - L'utilisateur doit être invité à changer son mot de passe

===== Troubleshooting =====

^ Problème ^ Cause Probable ^ Solution ^
| "Le nom d'utilisateur existe déjà" | Login déjà utilisé | Choisir un login différent (ex : pdurand2) |
| "Mot de passe ne respecte pas les exigences" | Politique de MDP trop stricte | Utiliser 12+ caractères, maj+min+chiffres+symboles |

===== Historique des Versions =====

^ Version ^ Date       ^ Auteur ^ Modifications ^
| 1.0     | 2024-02-16 | Admin  | Création initiale |

Enregistrer

---