SCOL SERVER pour GNU/Linux ============================ 0. NOTE ------- Ce fichier a été mis à jour le 17 octobre 2010. Le script d'installation a été mis à jour Les scripts de désinstallation et d'ajouts ont été créés Licence : le serveur Scol est placé sous licence Scol. Voyez le fichier 'COPYING' pour plus d'informations Une documentation complète du serveur est téléchargeable sur le Scolring. Pour tous renseignements, suggestions, dysfonctionnements, demandes diverses, visitez le site du Scolring à l'adresse : http://www.scolring.org/ I. INSTALLATION --------------- Décompressez l'archive dans le répertoire de votre choix tar -xzf nom_de_l_archive Placez-vous dans ce répertoire et lancez le script d'installation (éventuellement avec des droits de super-utilisateurs pour bénéficier de toutes les options) : ./install.sh Ce script demande : - le répertoire destination de SCOL - le groupe et le user propriétaires de SCOL ; s'ils n'existent pas, le script propose de les créer (il faut alors être root). - l'adresse IP d'accès aux sites SCOL - et divers paramètres de configuration SCOL peut être utilisé avec n'importe quel login Unix mais il est déconseillé d'utiliser 'root'. Utilisez plutôt un login et un groupe spécifiques 'scol'. Ensuite, le script extrait les fichiers dans le répertoire destination. Il faut ensuite définir un administrateur du serveur SCOL en donnant un login, un mot de passe et optionnellement un nom et prénom. Enfin, le script propose d'insérer SCOL dans le fichier /etc/inittab pour qu'il soit lancé automatiquement au démarrage de la machine. II. DÉSINSTALLATION ------------------- Lancez le script 'uninstall.sh' situé dans le répertoire d'installation du serveur : ./uninstall.sh Des droits root peuvent être nécessaires suivant les options voulues. Au minimum, l'utilisateur propriétaire du serveur Scol est requis. III. AJOUTS À L'INSTALLATION ---------------------------- Ce script optionnel permet à l'administrateur d'installer de façon simple des ressources nécessaires au bon fonctionnement de son serveur Scol. En l'exécutant, il aura le choix entre une et plusieurs options : 1/ dms : ajout des modules standards de la version 2.5.2 du SCS, requis pour héberger des applications Scol créées avec le SCS 2/ goodies : outils et tutoriaux divers 3/ e_maginer : ajout des modules standards version "luxury", requis pour héberger des applications Scol créées avec E_Maginer 4/ cryonics : ajout des modules standards version 1.5.1, requis pour héberger des applications Scol créées avec Cryonics 5/ 3d and textures : pack d'objets 3d et de textures associés 6/ size only : affiche les tailles des fichiers à télécharger suivant les options ci-dessus 7/ exit : quitte le script Pour faire un ou plusieurs ajouts, lancez le script avec l'utilisateur du serveur Scol : ./stuff_install.sh Note importante : si une application utilise des modules non standards, il importe à l'administrateur du serveur Scol de les installer manuellement. Contactez l'auteur de l'application ou postez sur le forum du Scolring. IV. INSTALLATION et DÉSINSTALLATION MANUELLE -------------------------------------------- Cette méthode ne devrait être réservée qu'aux experts. Elle n'apporte pas de personnalisation particulière et n'est donc pas recommandée. À toutes fins utiles, voici un canevas sommaire : créez un groupe et un utilisateur spécifique. Ceci n'est pas obligatoire mais est recommandé, notamment pour des raisons de sécurité. Il n'est pas utile d'associer un shell à cet utilisateur ('/bin/false'). Plus d'infos avec les commandes 'man addgroup' et 'man adduser'. décomppressez l'archive dans le répertoire voulu (tar -xzf archive) associez aux fichiers et répertoires à l'utilisateur créé (chowner) rendez les exécutables ... exécutables (chmod -x) éditez le fichier usm.ini qui se trouve à la racine du serveur (avec nano, vi, ...) ajoutez les lignes suivantes : echo FFFF port 1200 adminport 1201 porthttp 8080 80 log NO logwin NO #supervisor debug #memory 4 #refreshIP no update no platform unix plugin unixODBC/lib/libodbc.so plugin plugins/scolsql-2001-03-13.so SCOLloadSQL disk ./cache 64000 disk ./partition 0 disk ./common masteruser my_user_scol vous pouvez modifier les valeurs des clés. Les lignes commençant par # sont commentées et ne devraient pas être décommentées sauf cas particulier. si vous installez des bibliothèques supplémentaires, ajoutez une ligne "plugin" par bibliothèque. la valeur de la clé "masteruser" est le nom de l'utilisateur créé au début. éditez le fichier scol/data/.odbctxt/ACL ajoutez une ligne avec un login et un mot de passe (les deux derniers champs sont optionnels), séparés par un | à la racine du serveur, créez un fichier nommé "startscol.sh" contenant : # Scol install directory DSTDIR="/home/iri/scol" # unixODBC settings ODBCSYSINI="$DSTDIR"/scol/unixODBC/etc ; export ODBCSYSINI ODBCINI="$DSTDIR"/scol/unixODBC/.odbc.ini ; export ODBCINI ODBCTXT="$DSTDIR"/scol/data ; export ODBCTXT # Search path for dynamic libraries LD_LIBRARY_PATH=$LD_LIBRARY_PATH:"$DSTDIR"/scol ; export LD_LIBRARY_PATH LD_LIBRARY_PATH=$LD_LIBRARY_PATH:"$DSTDIR"/scol/bin ; export LD_LIBRARY_PATH LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/lib ; export LD_LIBRARY_PATH # Scol settings SCOLPATH="$DSTDIR"/scol/usmunix ; export SCOLPATH # Run Scol "$SCOLPATH" $* >/dev/null 2>&1 rendez le exécutable Consultez la documentation du serveur, disponible en français au format PDF, depuis le Scolring. Pour désinstaller le serveur, supprimer le répertoire d'installation et, le cas échéant, l'utilisateur et le groupe auquel il appartenait. V. UTILISATION DU SCOL ENGINE ------------------------------ Le lancement du SCOL Engine se fait par la commande : nohup ./startscol.sh & Ensuite, un script SCOL se lance en tapant : nohup ./startscol.sh partition/test.scol & pour lancer le script test.scol. VI. UTILISATION DE L'ADMINISTRATION SCOL ----------------------------------------- Le serveur SCOL est administrable par un navigateur web. L'URL d'accès est http://nom_dns_ou_ip:1201/CC/ où nom_dns_ou_ip est le nom DNS ou l'adresse IP de la machine serveur SCOL. Si on se trouve derrière un firewall interdisant l'accès au port 1201, on peut utiliser plutôt l'URL http://nom_dns_ou_ip/ControlCenter/ VII. BASE DE DONNEES SCOL ------------------------ Les sites gérés par le serveur SCOL sont définis dans une base de données en mode texte. SCOL utilise pour cela un accès ODBC en se servant d'un driver manager et d'un driver texte fournis par le projet "libre" unixODBC. Les sources utilisés de ce projet sont fournis dans le sous-répertoire unixODBC/unixODBC-2.0.8 Les modifications apportées à la version 2.0.8 sont décrites dans le fichier unixODBC/unixODBC-2.0.8/README.modif. Le projet unixODBC est utilisable et redistribuable selon la licence LGPL décrite dans le fichier unixODBC/unixODBC-2.0.8/COPYING. Pour plus d'informations, consulter le site http://www.unixodbc.org/ VIII. PORTAGE D'UN SITE SCOL WINDOWS VERS UNIX ------------------------------------------- Les fichiers sources écrit en langage SCOL (habituellement .pkg) sont bien évidemment portables. Par contre, sous Unix, il est impératif d'avoir tous les fichiers utilisés par SCOL en minuscules (à partir des partitions SCOL). Dans le répertoire d'installation de SCOL, l'utilitaire tools/bin/rkillmaj-linux permet de renommer en minuscules tous les fichiers de l'arborescence courante. Exemple : cd partition ../tools/bin/rkillmaj-linux permet de renommer en minuscules tous les fichiers du répertoire partition. ==============================================================================