Installation et mise à jour

Dans cette section de la documentation, les variables suivantes seront utilisées :

  • NAME_ZIP : Nom du fichier zip qui a été fourni pour installation ou mise à jour.

    Exemple : my-application-1.0.0.zip

  • INSTALLATION_DIR : Répertoire dans lequel est effectuée l’installation.

    Note : Ce répertoire doit être servi par Apache.

    Exemple : /var/www/html/anakeen/

  • USER : Nom de l’utilisateur sous lequel tourne apache.

    Exemple : apache ou apache2 ou www-data

Prérequis

Avoir généré ou récupéré auprès de votre intégrateur l’archive de control (${NAME_ZIP}).

Cette archive sert à faire une installation ou une mise à jour de l’application.

Une fois l’archive décompressée, un dossier control et un fichier README.md sont présents.

Installation

Afin de procéder à l’installation, il faut lancer les commandes suivantes :

WARNING

Les commandes suivantes sont à adapter en fonction du système cible.

# Extraction de l’archive en tant que l’utilisateur apache
sudo -u ${USER} unzip -o -d ${INSTALLATION_DIR} ${NAME_ZIP}

# Initialisation du contexte
${INSTALLATION_DIR}/control/anakeen-control init --pg-service=<pg-service-name> --password=<admin-password>

# Ajout du dépôt local
${INSTALLATION_DIR}/control/anakeen-control registry add local control/localRepo

# Installation
${INSTALLATION_DIR}/control/anakeen-control install

# Création d'un utilisateur avec les droits super admin (2023 et supérieure uniquement)
${INSTALLATION_DIR}/control/anakeen-control run "./ank.php --script=createUserWithAdminRight --loginUser=#login# --firstName=#firstName# --lastName=#lastName# --password=#password# --email=#email#"

Mise à jour

Afin de procéder à la mise à jour, il faut lancer les commandes suivantes :

WARNING

Les commandes suivantes sont à adapter en fonction du système cible.


# Suppression de l’ancien dépôt local afin de nettoyer les anciennes version
rm ${INSTALLATION_DIR}/control/localRepo

# Extraction de l’archive en tant que l’utilisateur apache.
sudo -u ${USER} unzip -o -d ${INSTALLATION_DIR} ${NAME_ZIP}

# Mise à jour
${INSTALLATION_DIR}/control/anakeen-control update

Vérification de l’installation / mise à jour

Afin de vérifier les modules et versions installés, il est possible d’utiliser la commande ci-dessous.

${INSTALLATION_DIR}/control/anakeen-control show

TIP

  • Le répertoire ${INSTALLATION_DIR}/control contient le code de Anakeen Control.

  • Le répertoire ${INSTALLATION_DIR}/platform contient le code de Anakeen Platform.

  • Afin de voir le statut en temps réel de l’installation ou de la mise à jour, il est possible d’exécuter la commande ci-dessous.

      ${INSTALLATION_DIR}/control/anakeen-control status -w 1
    
    • Tant que des opérations sont en cours, le détail est donné.
    • Une fois que plus aucune opération n'est en cours, la commande affiche Ready .
    • Pour sortir de cette commande, il est nécessaire de faire Ctrl + C