Pour tout problème contactez-nous par mail : support@froggit.fr | La FAQ :grey_question: | Rejoignez-nous sur le Chat :speech_balloon:

Skip to content
Snippets Groups Projects
Installation_fr.md 2.95 KiB
Newer Older
  • Learn to ignore specific revisions
  • Philippe Coicadan's avatar
    Philippe Coicadan committed
    ## Installation
    
    Cette section s'adresse aux personnes ayant des connaissances en construction et installation de logiciels.
    
    Pour utiliser **AROLIOS WebUI**, vous devez en premier lieu installer les prérequis puis récupérer les sources qui sont écrits en langage JavaScript.
    
    ### Prérequis
    
    **AROLIOS WebUI** dépend du logiciel [React-Admin](http://marmelab.com/react-admin) qui sera installé avec toutes ses dépendances. Au préalable il faut installer **node.js** qui est un logiciel serveur interprétant le JavaScript et **npm** son gestionnaire de paquets.
    
    Il y a plusieurs méthodes dépendantes de votre système d'exploitation pour installer ces deux logiciels.
    Suivez les instructions que vous trouverez sur Internet, par exemple [ici](https://docs.npmjs.com)
    
    
     ### Construction
    
     1. Copiez les sources téléchargés dans un nouveau répertoire.
     2. Placez-vous dans ce répertoire et tapez la commande: npm install  
     Cette commande installe tous les paquets React-Admin nécessaires ainsi que les paquets dont ils dépendent.
     3. Pour construire la version de production, 
        1. modifiez dans le fichier .env le paramètre VITE_BACKEND_URL pour lui indiquer l'URL du serveur qui implémente l'**API AROLIOS**. Exemple: https://my_arolios_server
        2. tapez la commande: npm build  
        Un répertoire dist est créé avec les fichiers nécessaires à l'exécution
    
    ### Déploiement
    
    1. Copiez le répertoire dist créé dans l'emplacement adéquat pour le serveur web (par exemple Apache) qui servira aux utilisateurs **AROLIOS WebUI**. Exemple /var/www/arolios_webui
    2. Vérifiez la présence du fichier .htaccess fourni pour le serveur Apache. Si vous l'utilisez, il faut configurer Apache avec, par exemple sur Linux,  les commandes suivantes:
        1. sudo a2enmode rewrite
        2. sudo systemctl apache2 restart
    3. Configurez votre serveur web (Apache par exemple) pour servir **AROLIOS WebUI**. Par exemple avec Apache sur Linux:
        1. Placez vous dans le repertoire /etc/apache2/sites-available
        2. Copiez le fichier 000-default.conf (par exemple arolios.conf)
    
    Philippe Coicadan's avatar
    Philippe Coicadan committed
        3. Dans cette copie, renseignez les paramètres ServerName (l'URL pour adresser **AROLIOS WebUI**, par exemple www.my-arolios.example.com)  et DocumentRoot (l'emplacement du fichier index.html, par exemple /var/www/arolios_webui)
    
    Philippe Coicadan's avatar
    Philippe Coicadan committed
        4. Passez la commande: sudo a2ensite /etc/apache/sites-available/arolios.conf
        5. Redémarrez le serveur Apache: sudo systemctl restart apache2
    
    Philippe Coicadan's avatar
    Philippe Coicadan committed
    4. Si le serveur de l'API AROLIOS que vous avez renseigné dans le paramètre VITE_BACKEND_URL est lancé ainsi que votre serveur web servant **AROLIOS WebUI**  (Apache par exemple), vous pouvez démarrer **AROLIOS WebUI** depuis votre navigateur web en l'adressant avec l'URL renseigné dans la configuration de votre serveur Web ( par exemple www.my-arolios.example.com)
    
    Philippe Coicadan's avatar
    Philippe Coicadan committed
    En cas de difficulté, référez-vous à la documentation de votre serveur web ou aux articles disponibles sur Internet pour y déployer une application React.