Artifact ID: | 35a924d48644122733c797a3992161a162196dfbc56333778cdf86516364ab61 |
---|---|
Page Name: | Installation_OVH |
Date: | 2022-08-14 16:17:29 |
Original User: | bohwaz |
Mimetype: | text/x-markdown |
Parent: | 7963ac927ab78a230c6cb66a93e79208d87af952169b3ebd9dd33391a3d8e735 (diff) |
Next | 49e8b839fe1fc78228067d5774c6d686af1fb9665309aa90968473310ded5658 |
Installer Garradin sur hébergement mutualisé OVH
Pré-requis : téléchargez la dernière version (fichier .tar.gz
) depuis la page d'accueil.
1. Installation des fichiers
Avec le manager OVH , dans le menu : Web Cloud / Hébergements, sélectionner le nom de domaine de l'association dans le menu de gauche et cliquez sur l'onglet FTP - SSH.
Assurez-vous déjà d'avoir un identifiant FTP et d'en connaître le mot de passe. Si besoin créez l'identifiant et le mot de passe. Puis cliquez sur le bouton FTP Explorer.
Commencez par vous connecter avec l'identifiant et mot de passe FTP.
Puis cliquez sur le bouton Upload.
Sélectionnez le fichier garradin-X.Y.Z.tar.gz
que vous avez téléchargé au début, dans le sélecteur de droite (archives), et confirmez en cliquant sur le bouton de validation vert.
Une fois le fichier décompressé, appuyez sur le bouton de retour.
Sélectionnez ensuite le répertoire créé par la décompression et renommez-le en garradin
(sans le numéro de version).
2. Configuration de la version de PHP
Si besoin, vous pouvez modifier la version de PHP utilisée en suivant ce guide.
3. Configuration du nom de domaine
Vous pouvez soit choisir d'utiliser Garradin sur votre nom de domaine principal, par exemple mon-asso.fr
(option A) ou créer un sous-domaine dédié à votre association, par exemple compta.mon-asso.fr
(option B).
3. A. Configuration du domaine principal
Avec le manager OVH , dans le menu : Web Cloud / Hébergements, sélectionner le nom de domaine de l'association dans le menu de gauche.
Cliquer sur le bouton avec trois points à droite du nom de domaine et sélectionner Modifier le domaine. Là modifiez le dossier racine pour mettre garradin/www
.
3. B. Création d'un sous-domaine
Avec le manager OVH , dans le menu : Web Cloud / Hébergements, sélectionner le nom de domaine de l'association dans le menu de gauche.
Cliquer sur le bouton Actions et choisir Ajouter un domaine ou sous-domaine.
Créer un sous-domaine :
- Nom du sous domaine :
compta.mon-asso.fr
- Dossier cible :
garradin/www
- Sousdomaine www : non
La création du sous-domaine prend du temps à se propager dans les DNS (jusqu'à 24h dit le message). Tant que la propagation n'est pas faite, on peut avoir soit une page webmail OVH qui s'affiche, soit un message d'erreur de résolution de domaine. Patience.
3. Test
Si vous avez attendu assez longtemps la propagation du nom de domaine, en tapant dans votre navigateur http://compta.mondomaine.tld
, vous devriez voir s'afficher la page d'installation de Garradin.
API
Si vous voulez utiliser l'API, cela requiert un peu de bidouille avec OVH qui n'a pas correctement configuré son serveur web, et le résultat est que l'API ne peut pas fonctionner par défaut. Vous aurez le message d'erreur suivant :
{"error":"No username or password supplied"}
Pour contourner le souci il faut ajouter ceci à la fin du fichier www/.htaccess
:
RewriteEngine on
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]
et dans config.local.php
au début :
if (!empty($_SERVER['HTTP_AUTHORIZATION'])) {
@list($_SERVER['PHP_AUTH_USER'], $_SERVER['PHP_AUTH_PW']) = explode(':', base64_decode(substr($_SERVER['HTTP_AUTHORIZATION'], 6)));
}
Cela devrait désormais fonctionner.