Changes to "Installation_OVH" between 2022-08-14 15:14:40 and 2022-08-14 16:07:30

1

2
3

4
5

6
7
8

9
10

11
12

13
14

15
16
17


18
19
20

21
22
23
24

25
26

27
28

29
30

31
32
33
34

35
36
37
38

39
40
41
42

43
44

45
46

47

48
49
50
51
52
53






54

55
56

57
58

59
60
61

62
63
64
65

66
67

68
69

70
71

72
73
74
75
76
77
78

1
2

3
4

5

6

7
8

9
10

11
12

13
14


15
16
17
18

19
20
21
22

23
24

25
26

27
28

29

30


31

32


33

34


35

36
37
38

39
40
41






42
43
44
45
46
47
48
49
50

51
52

53
54


55


56

57
58

59
60

61
62

63
64
65
66
67
68
69
70
-
+

-
+

-
+
-

-
+

-
+

-
+

-
+

-
-
+
+


-
+



-
+

-
+

-
+

-
+
-

-
-
+
-

-
-
+
-

-
-
+
-

+

-
+

+
-
-
-
-
-
-
+
+
+
+
+
+

+

-
+

-
+

-
-
+
-
-

-
+

-
+

-
+

-
+







# Comment installer Garradin sur hébergement mutualisé OVH
# Installer Garradin sur hébergement mutualisé OVH

Bonjour, voici le descriptif de l’installation sur un hébergement  mutualisé OVH pro remis à jour par Philippe35 en octobre 2014 avec :
Pré-requis : téléchargez la dernière version (fichier `.tar.gz`) depuis la [page d'accueil](/).

*   la dernière version de Garradin  (une archive tar.bz2 que vous aurez téléchargée [à cette adresse](/uvlist) )
## 1. Création d'un sous-domaine
*   un hébergement mutualisé OVH pro (version2012, j'ai raté le basculement sur pro 2014, mais à ma connaissance, cela ne changera pas la procédure d'installation)

Dans le cas de notre association, nous avons déjà notre site sur le sous-domaine "www". Nous sommes intéressés par Garradin pour permettre aux membres du bureau de gérer les comptes, et le fichier des membres. Nous ne sommes pas intéressés par la fonctionnalité wiki et site web. 
![](https://fossil.kd2.org/garradin/raw/ac3b6adc21c7874177382cad82cf3ca01fdb845dc8b8ff6b716dc026d321dda4?m=image/png)

## 1) Création d'un sous-domaine
Avec le [manager OVH](https://www.ovh.com/manager) , dans le menu : **Web Cloud** / **Hébergements**, sélectionner le nom de domaine de l'association dans le menu de gauche.

Avec le manager OVH <https://www.ovh.com/manager> , dans le menu : Domaines / hébergement / Sous-domaine
Cliquer sur le bouton **Actions** et choisir **Ajouter un domaine ou sous-domaine**.

Créer un sous domaine :
Créer un sous-domaine :

*  Nom du sous domaine : compta.mondomaine.tld
*  Dossier cible : /compta-garradin/www
*  Nom du sous domaine : `compta.mondomaine.tld`
*  Dossier cible : `/garradin/www`
*  Pays : IP française
*  Sousdomaine www : non
*  Ipv6 : ( non )
*  IPv6 : oui

La création du sous-domaine prend du temps à se propager dans les DNS ( jusqu'à 24h dit le message ). J'ai constaté une nuit. 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.

L’installation sous forme de sous-domaine « compta » permet de compartimenter et sécuriser les applications. Seul, le répertoire www de Garradin est exposé sur le web.
L’installation sous forme de sous-domaine « compta » permet de compartimenter et sécuriser les applications. Seul le répertoire `www` de Garradin est exposé sur le web.

## 2) Installation des fichiers
## 2. Installation des fichiers

Avec Putty (ou ftp), à la racine de votre arborescence user ( au-dessus de www ), créer un répertoire compta-garradin, et y transférer le contenu de l’archive Garradin.
Il est possible d'utiliser une connexion FTP mais le plus simple est d'utiliser l'explorateur net2ftp fourni par OVH. Pour cela assurez-vous déjà d'avoir un identifiant FTP et d'en connaître le mot de passe, en passant par l'onglet **FTP - SSH** puis en cliquant sur le bouton **FTP Explorer**.


![](https://fossil.kd2.org/garradin/raw/28b3ce00ab7357de42405bbed5d6c0e44e24a3a963e87771e7885adb6feda3a0?m=image/png)
Sur le répertoire compta-garradin, avec Putty (ou en ftp), modifier les droits des fichiers avec la valeur 604 ( +X pour les répertoires ) en propageant sur les sous-répertoires.

Si vous vous connectez en ssh, vous verrez que du point de vue Unix, le fichier appartient à votre compte(login), et au group « users » ( c'est à dire que votre compte est membre du groupe de tous les utilisateurs d'OVH mutualisé). Il est donc logique que les droits pour le groupe soient nuls (les autres comptes mutualisés n'ont pas à voir vos fichiers, même pas en lecture seule). Dans cette logique, le serveur apache d'OVH est configuré pour générer une « erreur interne » 5xx s'il lui est demandé de servir des fichiers avec des droits groupes non nuls.

Commencez par vous connecter avec l'identifiant et mot de passe FTP.
## 3) Configuration fichier .ovhconfig

Depuis 2014, OVH permet de configurer des fonctionnalités propres à OVH :

![](https://fossil.kd2.org/garradin/raw/ff47b5d8fb500eb5345e6e341251f975db86a1b01901f3647176ab3d2ce5baf0?m=image/png)
* choisir une version de PHP ( actuellement, Garradin demande une version PHP 7.4 ou supérieure )

* d'activer le firewall applicatif ( si j'ai bien compris, OVH analyse les requêtes qui arrivent à votre site, et les filtre si il détecte des tentatives d'attaques, comme des injections SQL, ou autres. Je n'ai pas trop trouvé de documentation ovh sur le sujet. OVH doit enrichir les filtres dans le temps selon l'évolution des types d'attaque. )

Puis cliquez sur le bouton **Upload**.
* mode production ou development ( en mode développement, les éventuels messages d'erreurs apparaissent directement dans le navigateur, sinon, il faut consulter les fichiers logs d'erreur dans l'interface OVH ) : donc mettre en mode development, le temps de l'installation.

![](https://fossil.kd2.org/garradin/raw/9fdce498551f46caffa3a453e0bfb7dfb500770aadbb96ad0dd82a59674ef051?m=image/png)

Exemple et documentation : [Changer la version PHP de son hébergement chez OVH](https://docs.ovh.com/fr/hosting/configurer-le-php-sur-son-hebergement-web-mutu-2014/)
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.

![](https://fossil.kd2.org/garradin/raw/8ad62a660eae86246ff74e14beca303946d5e38a63f567bfd3a2ff886f712517?m=image/png)
<pre>
    app.engine=php
    app.engine.version=7.4
    http.firewall=security
    environment=development
</pre>

Une fois le fichier décompressé, appuyez sur le bouton de retour.

![](https://fossil.kd2.org/garradin/raw/0be2f2fdc7ca303dd41fd1d0988f0bbf6cddf78f6128d7165a4886d0f7f95f6e?m=image/png)

Sélectionnez ensuite le répertoire créé par la décompression et renommez-le en `garradin` (sans le numéro de version).

![](https://fossil.kd2.org/garradin/raw/524107e47d9b11930f639ece1887770aebd3485f5419fe250d96df8d7eb1b64a?m=image/png)

## 4) Configuration fichier robot.txt
![](https://fossil.kd2.org/garradin/raw/0be1af6ec892dcbbe438fe70a37e8efa3ae3ab2ad450d7e213078427aa401ede?m=image/png)

Comme nous sommes dans une optique d'utilisation "privée" des fonctionnalités comptabilité et gestion des membres, et que nous ne comptons pas utiliser de manière publique les fonctionnalités wiki et CMS, nous mettons à la racine de notre sous-domaine, (dans le répertoire "*/user/compta-garradin/www"), un fichier "robot.txt" dissuadant tous les robots respectueux d'indexer notre comptabilité !
## 3. Configuration de la version de PHP

<pre>
    User-agent: *
Si besoin, vous pouvez modifier la version de PHP utilisée en [suivant ce guide](https://docs.ovh.com/fr/hosting/configurer-le-php-sur-son-hebergement-web-mutu-2014/).
    Disallow:/
</pre>

## 5) Test
## 4. 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.
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
## API

OVH n'a pas correctement configuré son serveur web, et le résultat est que l'API ne peut pas fonctionner. Vous aurez le message d'erreur suivant :
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` :