Copyright © Xerox Corporation, Codendi Team, 2001-2006. All Rights Reserved

Chapitre 1. Installation

Pour installer le client en ligne de commande Tuleap, vous devez disposer de PHP5 installé sur votre machine (Le CLI ne fonctionnera pas avec PHP4). La dernière version de PHP5 est grandement recommandée. PHP doit également avoir été compilé sans le paramètre --disable-cli pour pouvoir être exécuté en ligne de commande.

Vous devez vérifier dans quel répertoire se trouve l'exécutable PHP installé sur votre machine. Le répertoire est celui spécifié lors de la compilation de PHP (si aucun préfixe n'a été spécifié, celui par défaut est /usr, l'exécutable PHP devrait donc se trouver dans /usr/bin/php).

Comment savoir ou se trouve l'exécutable PHP ?

Vous pouvez vérifier dans quel répertoire PHP est installé en executant la commande suivante :

# which php
/usr/bin/php
            
Dans ce cas, l'exécutable PHP est /usr/bin/php.

Si vous prévoyez d'utiliser le client en Ligne de Commande pour administrer une installation de Tuleap via une connection HTTPS, vous devez compiler PHP avec l'extension CURL (en utilisant l'option --with-curl dans le script de configuration).

Une fois que PHP est proprement installé, vous pouvez télécharger et décompresser le client en ligne de commande dans un répertoire sur votre machine locale.

Après avoir décompressé le client en ligne de commande, vous devez éditer le fichier $PREFIX/tuleap.php (où $PREFIX est le répertoire dans lequel le client a été décompressé) avec votre éditeur préféré et modifier les choses suivantes :

  1. Changer la première ligne, qui est :

    #!/usr/bin/php -q
                
    pour la faire pointer sur le chemin de l'exécutable PHP de votre machine. (si il est différent de /usr/bin/php)

  2. Trouver la section Configuration dans le script (délimitée par des commentaires) et modifier les constantes suivantes :

    • CODENDI_CLI_DIR: Pointe vers le répertoire dans lequel se trouvent les fichiers nécessaires au client. Habituellement, il s'agit de $PREFIX/include/.

    • WSDL_URL (optionel): l'URL du WSDL de votre serveur Tuleap SOAP. L'URL est très certainement http://tuleap.net/soap/index.php?wsdl. Vous pouvez vérifier l'exactitude de l'URL en la tapant dans votre navigateur, vous devriez alors obtenir un fichier XML renvoyé par le serveur. Si les variables ne sont pas affectées, le client essaiera d'utiliser le WSDL spécifié dans la variable d'environement TULEAP_WSDL.

  3. Assurez-vous que le script tuleap.php ait bien les droits d'exécution. Sinon, donnez-les lui en exécutant la commande suivante :

    chmod +x $PREFIX/tuleap.php
                    

Quand tout est installé correctement, vous pouvez tester l'installation pour voir si tout fonctionne correctement. Pour cela, essayer de vous connecter au serveur en exécutant la commande de "login". Placez-vous tout d'abord dans le répertoire dans lequel vous avez décompressé le client, et exécutez la commande suivante :

[mnazaria@linux tuleap-cli]$ ./tuleap.php -v login --username=(votre nom d'utilisateur) --password=(votre mot de passe)
CodendiSOAP::Connecting to the server http://tuleap.net/soap/index.php?wsdl...
CodendiSOAP::Connected!
CodendiSOAP::Executing command login...
Logged in as user (your user) , using session string MTAyLSotMTEyMzA4Mjg5My0qLTEyNy4wLjAuMS0qLU51U09BUC8wLjYuOSAoMS4xLjEuMSk=824c9f9010931f7872f4b9826c460ed3
Logged in.
            

Exemple 1. commande de login

Le message peut varier selon la configuration de votre serveur. Si vous obtenez une erreur ressemblant à : "Fatal error: wsdl error: HTTP ERROR: Couldn't open socket connection to server http://tuleap.net prior to connect().", cela veut dire que votre ordinateur n'arrive pas à se connecter au serveur Tuleap. Dans ce cas, vous devez vous assurer que l'adresse du serveur est correcte et que vous pouvez bien vous connecter au serveur depuis votre ordinateur.


Copyright © Xerox Corporation, Codendi Team, 2001-2006. All Rights Reserved