Installation d'un environnement avec Pkgi

Cette procédure d'installation vous montre comment déployer rapidement un LAMP. Bien entendu, cette procédure peut être et doit être extrapolée à tous les autres modules génériques que pkgi propose.

1. Être sur une machine debian stable
2. Disposer d'un utilisateur UNIX sur la machine (non root de préférence). Pour la suite, supposons que cet utilisateur se nomme monappli et que son homedir est /applis/monappli/
3. PHP5 en ligne de commande doit être installé au niveau système sur la machine car il est utilisé pour instancier les templates de pkgi. Il suffit d'installer le package php5-cli :

   sudo apt-get install php5-cli

Placez vous a la racine de votre application /applis/monappli/ et téléchargez les sources de la dernière version :

curl -s http://www.pkgi.net/pkgi-latest.tar.gz | tar xz

Vous récupérez alors un répertoire pkgi/, il contient les templates des fichiers de configuration et des lanceurs de votre application. La commande pkgi/build est votre prochaine étape. C’est le script qui va vous permettre d'instancier les templates, il vous demandera les paramètres de votre application (port, user, group …)

Lancez pkgi/build, il suffit alors de répondre aux questions. Une fois terminé, vous aurez à votre disposition les instances des lanceurs et des fichiers de configurations dans les chemins suivants :

• /applis/monappli/etc/init.d/ : pour les lanceurs.
• /applis/monappli/etc/ : pour les fichiers de config.
• /applis/monappli/pkgi.env : les variables d’environnement de votre application (réponses aux précédentes questions).

A tout moment, vous pouvez relancer pkgi/build pour régénérer les fichiers. Les questions ne seront alors plus posées car les variables seront automatiquement extraites de /applis/monappli/pkgi.env

Si les paramètres par défaut de pkgi ne vous conviennent pas totalement, vous désirerez les personnaliser. Pour cela vous êtes très fortement encouragés à créer votre propre module pkgi plutôt que de modifier directement les fichiers générés dans le répertoire etc/

Si vous ne deviez retenir qu'une commande, c'est la suivante :

/applis/monappli/etc/init.d/appli start

Cette commande va lancer automatiquement tous les modules de votre application (ex: démons apache, mysql, ldap). Mais vous pouvez également lancer/arrêter/sonder un module en particulier :

• /applis/monappli/etc/init.d/apache2 start
• /applis/monappli/etc/init.d/apache2 stop
• /applis/monappli/etc/init.d/apache2 status
• /applis/monappli/etc/init.d/apache2 restart
• /applis/monappli/etc/init.d/mysql start
• /applis/monappli/etc/init.d/mysql stop
• …

Remarque : pour le module mysql, il est nécessaire d'initialiser la base de données avant de démarrer le démon, pour cela utilisez la commande suivante

/applis/monappli/bin/pkgi-mysqltools init

Pour vérifier que vos serveurs sont correctement lancés, vous pouvez également utilisez la commande lsof -i, elle devrait vous retourner quelque chose qui ressemble à ça :

COMMAND   PID USER   FD   TYPE DEVICE SIZE NODE NAME
apache2  7362 bcmi    3u  IPv6  42819       TCP *:55579 (LISTEN)
mysqld   7453 bcmi   12u  IPv4  43028       TCP *:55679 (LISTEN)
apache2 26124 bcmi    3u  IPv6  42819       TCP *:55579 (LISTEN)
apache2 26125 bcmi    3u  IPv6  42819       TCP *:55579 (LISTEN)

Cela signifie que le démon apache2 écoute sur le port 55579 et que le démon mysqld écoute sur le port 55679. Dans le cas où rien ne s’affiche, consultez les logs dans /applis/monappli/var/log/