Note préalable :
Dans le souci du respect du droit d'auteur, rappelons que l'utilisation d'Orbacus est limitée à un usage strictement personnel. Toute utilisation commerciale devra faire l'objet d'un achat de license pour la modique somme de 99 euros.
Pré-installation
Malgré le souci de clareté du présent document, il est vivement conseillé de lire les fichiers suivants :
README, RELNOTES, INSTALL et ob/README.GCC (après décompression de l'archive, cf suite).
Procédure d'installation 1. Décompresser l'archive OB-4[1].1.3-eval.tar.gz dans /usr/local/orbacus par exemple (à noter que la suite tiendra compte de ce répertoire comme étant le répertoire d'installation).
# tar zxvf OB-4[1].1.3-eval.tar.gz
2. Se placer dans le répertoire décompressé : /usr/local/orbacus/orbacus-4.1/OB-4.1.3-eval
# cd /usr/local/orbacus/orbacus-4.1/OB-4.1.3-eval
3. Lancer la configuration afin de renseigner les variables liées au système pour la génération du makefile
# ./runconfig
Le but de l'opération est de répondre aux questions posées. A noter : A. Les informations entre crochets [] sont les réponses proposées par défaut. Pour valider une réponse par defaut, il faut appuyer simplement sur <entree> B. Pour connaitre la version de GCC du systeme : > gcc -v C. GCC doit avoir ete compile avec l'option "--enable-threads" sinon Orbacus ne fonctionnera pas ! A priori, ceci est fait par défaut, du moins sous la Mandrake. La commande "gcc -v" permet de vérifier à la fois la version de GCC et les option activées lors de la compilation.
Voici la liste des questions posées :
************************
* ORBacus Configurator *
************************
Enter 'c' if you use a C shell, or 'b' for a bourne shell:
[b] b
//Certaines installations systèmes peuvent utiliser "csh" (C SHell) au lieu de "bash" (Bourne Again SHell).
//Il faut donc entrer ce qui est utilisé sur sa configuration système.
(1) SUN Forte 6 update 2 C++ 5.3 SUN Solaris 2.6, 7 and 8
(2) GCC 2.95.3 SUN Solaris, Linux
(3) GCC 3.2.3 Linux
Please choose your compiler/platform combination:
[1] 3
//en somme, la version de GCC du système cible. Si celle-ci est plus récente que les options proposées ci-dessus,
//choisir la plus récente
Do you want to create shared libraries?
[yes] yes
//Indispensable, creation des *.so (Shared Object) dans /lib
Do you want optimized code to be generated?
[no] yes
//Apparemment, déconseille pour GCC (c.f. ob/README.GCC) mais fonctionne quand même...
Add debug information to the generated code?
[no] no
//à moins de vouloir se polluer la vie pour pas grand chose...
Please enter any extra preprocessor flags, like -I/some/directory:
[]
//Si des headers standards (.h) ne sont pas dans les emplacements par défaut du systeme
//exemple de syntaxe : -I/usr/include
Please enter any extra compiler flags, like -pipe:
[]
Please enter any extra linker flags, like -L/some/directory:
[]
//Si des librairies partagées (.so) ne sont pas dans les emplacements par défaut du système
//exemple de syntaxe : -L/usr/lib
The -R needs to be replaced with whatever is appropriate for that platform.
Please enter any extra archiver flags, like -xarch=v9:
[]
Where do you want to install everything?
[/usr/local] /usr/local/orbacus/ob-4.1.3
//ou tout autre répertoire, celui par défaut est bien si on ne souhaite pas installer Orbacus
//dans un répertoire séparé
//remarque : en utilisant le répertoire par défaut, les étapes 9 et 10 ne sont pas utiles. Cependant, utiliser
//un répertoire personnalisé peut présenter quelque intérêt. D'une part, cela permettra de centraliser
//les éléments spécifiquement relatifs à Orbacus (facilité pour retrouver une librairie ou commande Orbacus
//par exemple). D'autre part, il sera possible d'installer de nouvelles versions d'Orbacus en conservant l'ancienne
//et surtout en permettant l'utilisation de la version plus ancienne dans le cas d'une incompatibilité.
Directory ... does not exist. Create it?
[no] yes
//dans le cas ou un répertoire personnalisé non existant a été mentionné
To run configure, execute the following code in your shell:
. ./go
4. Lancer, pour la vérification du systeme et le paramétrage de l'installation :
# . ./go
5. Il s'agit maintenant de compiler Orbacus, les tests et les demos (Oh la la).
Deux choix possibles: tout compiler ou compiler seulement Orbacus.
Il est conseillé de compiler dans un premier temps Orbacus puis les tests et les démos (facultatifs). Ceci afin de pouvoir quand même installer Orbacus, meme si la compilation des tests et des demos échoue.
6a. Compilation d'Orbacus (core librairies)
# make min
6b. Compilation du reste (tests et demos)
# make
Pour éviter ces deux commandes et tout faire en une fois :
# make
Sur certains systèmes ou pour les plus malchanceux, l'erreur suivante peut survenir :
System exception `COMM_FAILURE'
Reason: temporary error, try again
Locality: exception has been generated locally
Completed: no
Minor code: 0x4f4f000e (gethostbyname() failed)
...
make[1]: *** [min] Error 1
Cette erreur est dûe a une mauvaise configuration du systeme. En effet, cela signifie que la procédure d'installation n'arrive pas à resoudre le hostname (nom_machine) de la machine en une adresse IP, a savoir 127.0.0.1.
Pour résoudre ce problème, il faut s'assurer que le mapping hostname/IP est correctement configuré dans /etc/hosts.
Maintenant, vous avez le temps de dormir un peu car la compilation est longue voir très longue sur les vieilles bouriques.
Par la meme occasion, une prière peut être bien utile, car les usines a gaz explosent parfois ...
6. (Facultatif) Lancer les utilitaires de test et les demos
7. Il faut ensuite, une fois que tout est bien compilé, installer Orbacus. Celui-ci sera installé dans le répertoire mentionné au lancement de runconfig, il y a bien quelques heures maintenant... ;-)
# make install
Là encore, il est possible de n'installer que les "core librairies and binaries" en tapant à la place :
# make install_min
Remarque : si les tests n'ont pas ete compilés, ça ne sert a rien de lui demander de tout installer, bien sur ;-)
8. Pour supprimer le dossier décompressé :
# cd ..
# rm -Rf OB-4.1.3-eval
Remarque : il est toutefois préférable de le garder pour conserver à disposition les nombreuses démos souvent bien utiles pour débuter...
9. Ceci peut être utile sur certains systèmes :
9a. Editer le fichier /etc/ldconfig.so.conf pour y ajouter le chemin d'accès aux librairies d'Orbacus :
/usr/local/orbacus/ob-4.1.3/lib
9b. Lancer "ldconfig"
10. Modifier le PATH pour y ajouter le chemin vers les commandes Orbacus :
/usr/local/orbacus/ob-4.1.3/bin
La variable PATH se modifie dans l'un des trois fichiers suivants : => /etc/bashrc => /etc/profile (préférable de la modifier ici) => /etc/skel/.bash_profile
