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
ouapache2
ouwww-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