INSTALL.md 5.58 KB
Newer Older
1 2
# Installation de Kohinos

3
**PROCEDURE D'INSTALLATION EN PRODUCTION :**
ADML63 committed
4

Félicie committed
5
## Environnement requis
ADML63 committed
6 7 8

Apache >= 2

9
PHP = 7.4
ADML63 committed
10

11
Extensions PHP :
ADML63 committed
12 13 14 15

    intl
    ctype
    iconv
Félicie committed
16
    mariadb (ou mysql > 8.0)
17
    gd
ADML63 committed
18 19 20 21

Installer composer si besoin

$ curl -sS https://getcomposer.org/installer | php
ADML63 committed
22

Félicie committed
23
## Cloner le projet dans le dossier nomdudossier
ADML63 committed
24 25 26

    Sur o2switch, l'accès au clone via SSH est impossible, utilisez plutôt le mode HTTP !

27
SSH : **$ git clone git@gitlab.com:federation-kohinos/kohinos.git nomdudossier**
ADML63 committed
28 29 30 31 32 33

ou

HTTPS : $ git clone https://gitlab.com/federation-kohinos/kohinos.git nomdudossier

=> Taper login et mot de passe GITLAB
ADML63 committed
34

ADML63 committed
35 36 37
Aller à nomdudossier

$ cd nomdudossier
ADML63 committed
38

Félicie committed
39
## Installer l'environnement du projet
40

ADML63 committed
41 42 43 44 45 46
Modifier les variables d'environnement

Copier le fichier .env.dist en .env et configurer :

    l'accès à la base de données (DATABASE_URL)

ADML63 committed
47 48
    bien faire attention à copier la Version du serveur Mysql (visible sur la page d'accueil de phpmyadmin "Version du serveur :" 
    (toute la valeur avant ' - ') à la fin de la variable DATABASE_URL après "?serverVersion=". 
49 50
    Exemple : Sur Mysql on a : Version du serveur : 10.3.31-MariaDB - MariaDB Server 
    On ajoute à DATABASE_URL : => ?serverVersion=10.3.31-MariaDB
ADML63 committed
51

ADML63 committed
52 53 54
- APP_ENV=dev et APP_DEBUG=1
- l'envoi de mail (MAILER_URL)
- la variable APP_SECRET (variable secrète que vous pouvez générer à partir de cette url : http://nux.net/secret
Yvon committed
55
- s'il s'agit d'une instance TAV, mettre la variable TAV_ENV à 1 (sinon la laisser à zéro)
ADML63 committed
56 57 58

Si vous utilisez Payzen comme moyen de paiement par CB :

ADML63 committed
59 60 61 62 63
1. - PAYZEN_SITE_ID=VotreConfigPayzen
2. - PAYZEN_CERTIFICATE=VotreConfigPayzen
3. - PAYZEN_CTX_MODE=TEST
4. - PAYZEN_DEBUG=true

Félicie committed
64
Installer les dépendances via composer
ADML63 committed
65

Félicie committed
66 67 68 69 70 71 72
$ php ../composer.phar install --optimize-autoloader

ou

**$ composer install --optimize-autoloader**

## Lancer la création de la base de données et des données de base du kohinos
ADML63 committed
73 74 75

Création de la base de données, si ce n'est déjà fait avec les accès dans le .ENV :

76
**$ php bin/console doctrine:database:create**
ADML63 committed
77 78 79

Création des tables et des contraintes :

80 81
**$ php bin/console doctrine:migrations:migrate --no-interaction**

ADML63 committed
82 83
Charger les fixtures standards :

84
Pour une instance non TAV :
Yvon committed
85

86
**$ php bin/console hautelook:fixtures:load --purge-with-truncate --env=pro**
Yvon committed
87

88
Pour une instance TAV :
Yvon committed
89

Yvon committed
90
**$ php bin/console hautelook:fixtures:load --purge-with-truncate --env=tavpro**
ADML63 committed
91 92 93 94 95 96

Vous obtiendrez cette erreur ci dessous, c'est normal !

In MediaEventSubscriber.php line 96:
There is no main category related to context: rubrique

97
**$ php bin/console sonata:media:fix-media-context**
ADML63 committed
98

99
Pour une instance non TAV :
Yvon committed
100

101
**$ php bin/console hautelook:fixtures:load --append --env=pro**
Yvon committed
102

103
Pour une instance TAV :
Yvon committed
104

Yvon committed
105
**$ php bin/console hautelook:fixtures:load --append --env=tavpro**
ADML63 committed
106

ADML63 committed
107 108
Supprimer le cache (si besoin)

109
**$ php bin/console cache:clear**
ADML63 committed
110 111 112

ou

Félicie committed
113
`$ rm -rf var/cache/*`
114 115
(supprimes tous les dossiers de cache, plus rapide que clear:cache et plus efficace en cas de changement de structure de base de données)

Félicie committed
116
##Installer les assets
ADML63 committed
117

118
**$ php bin/console assets:install**
ADML63 committed
119
 
Félicie committed
120
## Générer les fichiers et la BDD des traductions (pour pouvoir les modifier via l'interface d'administration notamment)
ADML63 committed
121 122 123 124 125 126 127 128

!!! NE FONCTIONNE PLUS POUR LE MOMENT !!!

$ php bin/console translation:update --force fr --prefix=""

$ php bin/console translation:update --force en --prefix=""

$ php bin/console lexik:translations:import --case-insensitive --force -c
ADML63 committed
129

ADML63 committed
130

ADML63 committed
131 132 133 134 135
Si besoin, modifier le htaccess (si apache < 2.4, il y a le .htaccessOLD qui peut être comptatible) (pas nécessaire sur o2switch)

$ vi .htaccess

INSTALLATION SUR LE SERVEUR TERMINÉE
ADML63 committed
136

Félicie committed
137 138 139 140 141
## Mettre à jour le logo et favicon
Une fois tout installé, éventuellement changer le logo et favicon situés dans :
- `public/images/favicon/` pour le favicon
- `public/images/logo.png/` pour le logo

Félicie committed
142
## Configuration & test du Paiement Payzen
ADML63 committed
143 144 145 146 147 148 149 150 151

Une fois Payzen configuré sur le Kohinos, il faut le configurer sur le Back Office de Payzen :

    Paramétrage -> Boutique : configurer les 2 "URL de retour de la boutique" avec la page d'accueil du site.
    Paramétrage -> Règles de notification -> URL de notification à la fin du paiement : dans le 2ème encadré, renseigner les 2 champs avec [url_du_site]/payment/done

Une fois l'installation et la configuration du Kohinos terminées, il est conseillé de réaliser un premier paiement afin de tester le bon fonctionnement de la communication avec Payzen en environnement de production.

Pour cela, payez une cotisation par exemple que vous pourrez rembourser dans le Back Office de Payzen et invalider dans l'admin du Kohinos (reçu = false).
ADML63 committed
152

Félicie committed
153
## CONFIGURATION DU KOHINOS POUR VOTRE MONNAIE LOCALE
ADML63 committed
154 155

Naviguer vers l'url de votre installation du Kohinos et vous accéderez à l'écran d'installation et de configuration du nom de la monnaie, du super admin, email et mot de passe, ainsi que le nom du siège, du premier groupe local, du solde de monnaie du siège, du centre de la carte etc...
156 157 158 159 160

EN CAS D'ERREUR 500 :

- Vérifier les logs présents dans var/log/, en général, si l'environnement est PROD, on peut aller voir le fichier prod.critical-DATE-DU-JOUR.log
Pour cela on peut utiliser la commande suivante : 
161 162 163 164 165 166 167 168 169 170 171 172
**tail -f var/log/prod.xxx.log | grep CRITICAL**

## Lancer le Kohinos en local

Installer le client symfony

Permettre la simulation du https en local :

**$ symfony server:ca:install**

Lancer le serveur local

173 174
**$ symfony server:start**

Félicie committed
175

176 177 178 179 180 181 182 183
Compiler les assets (css & js) après modification pour tests

**$ yarn install** si besoin (première modif des assets)

**$ yarn run encore dev**

Compiler les assets avant de commit : 
**$ yarn run encore prod**