L'Insomniaque

Installation de L'Insomniaque

Voici la procédure pour faire une nouvelle installation de L'Insomniaque sur un serveur donné.

Prérequis

• Apache
• PHP
• MySQL^[1]
• Une copie du code source^[2]
• Un backup de la base de données

Présomptions

• on installe le tout sur la machine "example.com" dans le "DocumentRoot" de apache, et donc que le "checkout" sera accessible de http://example.com/drupal/core/. Évidemment, le code peut être placé ailleurs, il faut simplement modifier les URLs en conséquence.
• une base de données a déjà été créée avec un usager/mot de passe y ayant accès

Procédure

1. Faire un checkout^[3] ou décompresser un backup du code source. Ceci créé une hiérarchie drupal/core, drupal/contrib et drupal/doc. C'est dans drupal/core que se trouve l'index.php qui fait rouler L'Insomniaque. drupal/core doit donc être accessible par le serveur web.
2. Créer les liens symboliques: cd drupal ; sh makesymlinks.sh^[4]
3. créer un fichier de configuration dans core/includes. Le fichier de configuration doit être nommé comme le "base url", où les "/" et les ":" on été remplacés par des points (ici, c'est donc "example.com.drupal.core.php"). Ce fichier doit être un fichier PHP valide. Les variables à définir sont $baseurl et $dburl. L'array $languages doit aussi être modifié si on veut autre chose que l'anglais comme langue par défaut. Voir core/includes/conf.php pour des exemples et plus de détails.
4. installer la DB: "gunzip -c dump.sql.gz | mysql -u user -p db" ou uploader l'image avec phpMyAdmin. Si l'on a pas d'image de la DB, on peut repartir "from scratch" avec le fichier database/core/database.mysql.
5. configurations spéciales de Apache: AllowOverride All, pour permettre mod_rewrite et l'override de certaines variables PHP
6. tester

Il est tout à fait possible que ceci ne fonctionne pas correctement, dans lequel cas il faudra immédiatement modifier cette documentation.

Notes

• Les images ne sont évidemments pas dans le SVN/CVS, et donc toute la gallerie sera brisée, ainsi que les images dans les blocs, à moins que le répertoire images/ soit copié sous core/.

Pour ce qui est du serveur de production, il y a quelques petits détails.

1. il faut faire un checkout de la branche "stable" (svn co svn://.../inso/branches/stable)
2. faire un export pour enlever tous les fichiers inutiles (svn export stable export). Ces deux étapes peuvent être fusionnées en une seule avec la commande svn export svn://.../inso/branches/stable export
3. puis faire un upload sur le serveur avec rsync ou ncftp, par exemple. On ne garde pas de checkout sur le serveur de production car Subversion n'y est pas installé, et d'ailleurs, on a pas toujours d'accès "shell". Ceci a pour "side effect" de décourager le développement sur la branche "stable".

Merger les changements entre les branches

Pour faire un merge, ça nous prend un checkout de la branche stable:

$ svn co https://anarcat.ath.cx/svn/inso/branches/stable/

On vérifie la version du dernier merge:

$ cd stable ; svn log | less

r884 | anarcat | 2004-03-28 18:37:20 -0500 (Sun, 28 Mar 2004) | 1 line

merge rev 883 (install defaults) into stable

On vérifie le diff depuis cette version pour voir ce que l'on va "merger":

$ svn diff -r884:886 https://anarcat.ath.cx/svn/inso/trunk/

Le "886", c'est la version courante du repo, on l'obtient quand on fait un checkout:

A stable/core/.htaccess Checked out revision 886.

Si tout est beau, on fait le merge:

$ svn merge -r884:886 https://anarcat.ath.cx/svn/inso/trunk/ U contrib/modules/wiki2xhtml/class.wiki2xhtml.php U contrib/modules/extrafilters/extrafilters.module $ svn status M contrib/modules/wiki2xhtml/class.wiki2xhtml.php M contrib/modules/extrafilters/extrafilters.module

On commit les changements sur la branche stable:

$ svn commit -m 'merge rev 884-886 (filter fixes) into stable' Sending contrib/modules/extrafilters/extrafilters.module Sending contrib/modules/wiki2xhtml/class.wiki2xhtml.php Transmitting file data .. Committed revision 887.

Il est important de mettre le numéro de version que l'on merge pour pouvoir faire les merges futurs plus facilement, jusqu'à ce que subversion supporte l'historique dans les merges.

--
[1] Drupal supporte d'autres DBs, mais c'est MySQL que nous utilisons
[2] ceci implique potentiellement d'avoir Subversion (SVN) d'installé.
[3] Pour faire un checkout sous SVN, on utilise une commande comme: "svn co FOO" où FOO est l'url où se trouve le "repo" du code source.
[4] si le système ne supporte pas les liens symboliques, examiner le fichier makesymlinks.sh et installer les bons fichiers à la bonne place. (Bonne chance)

Les logiciels libres: qu'est-ce que c'est?

Pour la plupart des gens qui n'oeuvrent pas dans le domaine de la programmation, le logiciel libre est un concept soit totalement inconnu, soit totalement incompris. Pourtant, les logiciels libres existent depuis le début des années 80. Pour certaines applications, ils prennent une part importante du marché. Par exemple, le serveur web qui roule plus de 50% des sites web dans le monde, Apache, possède une license libre.

La grande majorité des logiciels disponibles à l'heure actuelle sur le marché ont une license non-libre, aussi appelée license propriétaire. Ce type de license protège les droits d'auteur de la compagnie qui a produit le logiciel. La copie du logiciel est formellement interdite.

Code source?

Tous les logiciels sont définis à l'aide d'un langage de programmation: c'est ce que l'on appele le code source d'un logiciel^[1]. En gros, le code source est un peu la "recette" du logiciel. Et la grande majorité des compagnies logiciel préfèrent garder le secret de leur recette.

Le logiciel: un produit à part

Le logiciel libre s'oppose radicalement à ce modèle. L'idée vient du fait qu'il existe une différence fondamentale entre le logiciel et les marchandises "physiques" comme les voitures, les souliers et les ordinateurs. C'est qu'une fois programmé, un logiciel peut être copié plusieurs fois pour un prix dérisoire. De plus, garder le code "secret" (ou "fermé") oblige les créateurs de logiciels à tout reprendre du début à chaque fois, ce qui constitue une sérieuse perte de temps et de ressources pour la société.

Enfin, un logiciel à code "fermé", c'est un peu comme une voiture dont on ne pourrait ouvrir le capot: dès qu'il y aurait un problème, on devrait faire affaire directement avec le fabriquant. En conservant secret la mécanique de la voiture, ce dernier s'assurerait un monopole sur la maintenance; on ne pourrait ni réparer soi-même sa voiture (même si on sait comment), ni l'emmener chez son cousin, qui est garagiste. Cela paraît étrange? C'est pourtant la norme actuellement dans l'industrie du logiciel.

En reconnaissant que le logiciel est d'une nature différente, les pionniers du logiciel libre ont eu une idée exceptionnelle qui s'articule autour des principes suivants:

1. la liberté d' utiliser le logiciel
2. la liberté de consulter le code source
3. la liberté de copier le code source
4. la liberté de modifier le code source et de rendre les modifications publiques

Libre = gratuit?

Ce concept tout à fait révolutionnaire s'intègre pourtant tout à fait bien dans un système de marché. Car libre ne veut pas dire gratuit. Même si le code source (et par extension, le logiciel) est disponible gratuitement, il ne vient avec aucune garantie. Il est tout à fait possible de faire payer pour le service de soutien ou pour un CD-Rom avec une belle petite boîte et un manuel d'instructions. Plusieurs projets libres fonctionnent également en partie grâce à des dons.

Le concept de logiciel libre ramène simplement les choses à la normale. Les idées sont là pour être partagées et tenter d'en faire des objets de propriété est non seulement illogique mais antiproductif. En 1813, Thomas Jefferson, l'un des pères de la constitution américaine, écrivait en ces mots à l'un de ses correspondants:

He who receives an idea from me, receives instruction himself without lessening mine; as he who lights his taper at mine, receives light without darkening me. That ideas should freely spread from one to another over the globe, for the moral and mutual instruction of man, and improvement of his condition, seems to have been peculiarly and benevolently designed by nature, when she made them, like fire, expansible over all space, without lessening their density in any point, and like the air in which we breathe, move, and have our physical being, incapable of confinement or exclusive appropriation. Inventions then cannot, in nature, be a subject of property.^[2]

--
[1] Par exemple, la page que vous consultez présentement est écrite dans un langage appelé le HTML. Vous pouvez voir son code en sélectionnant l'option "Page Source" dans le menu "View" de votre logiciel. Vous n'y comprenez rien? Normal, si vous n'êtes par programmeur! Mais vous pouvez vous instruire en consultant notre Mini-tutoriel HTML.
[2]

Celui qui reçoit une idée de moi, s'instruit sans diminuer mon instruction ; tout comme celui qui allume sa bougie à la mienne, reçoit la lumière sans m'obscurcir. Le fait que les idées doivent se répandre librement à travers le globe, pour l'instruction morale et mutuelle de l'homme, et pour l'amélioration de son état, semble avoir été singulièrement conçu par la nature bienveillante, quand elle les a faites [les idées], comme le feu, extensibles au-dessus de tout espace, sans diminuer leur densité dans n'importe quel point, et comme l'air que nous respirons, où nous nous déplaçons, et où se trouve notre être physique, incapable d'être prisonnier ou d'être la propriété exlusive d'autrui. Les inventions ne peuvent pas, en nature, être sujettes à la propriété.