Installation & Exploitation

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

Installation en mode lecture seule

Il est possible d'activer un mode lecture seule. Dans ce mode, une fois l'installation terminée l'ensemble des fichiers de code source sont passés en lecture seule pour minimiser la surface d'attaque de la plateforme.

Pour ce faire, il vous faut passer le paramètre applicatif correspondant à TRUE via la commande suivante :

{INSTALLATION_DIR}/control/anakeen-control run ./ank.php --script=setParameter --param=Core::CORE_SECURE_FILES --value=TRUE

Une fois le paramètre activé, les fichiers sont automatiquement passés en lecture seule après chaque mise à jour.

Vous pouvez aussi passer les fichiers en lecture seule manuellement :

{INSTALLATION_DIR}/control/anakeen-control run ./ank.php --system --secureDirectory

Et vous pouvez les passer en lecture/écriture via la commande :

INSTALLATION_DIR}/control/anakeen-control run ./ank.php --system --unsecureDirectory

←