(r119) HowtoInformatique < Main

Main Web>HowtoInformatique (revision 119) (raw view)~~EditAttach~~
---+!! HOWTO INFORMATIQUE


<!--
Autoriser tout le monde à voir cette page (alors que le web Main n'est visible que si on est connecté) :
   * Set ALLOWTOPICVIEW = Main.AllUsersGroup
-->

Cette page donne des réponses à diverses questions informatique (Etienne Pallier)

Voir aussi ComputerScience

%TOC%


---++ Accéder aux ressources du labo depuis l'extérieur


https://intranet.irap.omp.eu/spip.php?article103

---+++ Accès à l'Intranet depuis l'extérieur du labo (avec tunnel)

Comment accéder à l'intranet depuis l'extérieur ?

1) Créer un tunnel (entre le port local 9443 et le port distant 443 du serveur web du labo, via la passerelle)

ssh -L 9443:SERVEURINTRANET.irap.omp.eu:443 MON_LOGIN_DU_LABO@SERVEURGATEWAY.irap.omp.eu

(Pour les personnes qui utilisent Windows, vous pouvez faire la même chose avec le logiciel Putty, en vous inspirant de ce qui est décrit sur cette même page au point 4) a) de l'article http://planetoweb.cesr.fr/twiki/bin/view/Main/HowtoInformatique#Se_connecter_un_serveur_linux_en)

2) Pointer son navigateur sur https://localhost:9443

Accepter le certificat, et le tour est joué, vous êtes sur l'intranet !


---+++ Redmine depuis l'extérieur du labo (avec tunnel)

Comment accéder au site redmine depuis l'extérieur ?

C'est la même chose qu'au point précédent, mais en remplaçant SERVEURINTRANET par SERVEURREDMINE 

---+++ Réservation des ressources depuis l'extérieur du labo (avec tunnel)

Pour acce&#769;der au site de re&#769;servation des ressources, il suffit de faire comme au premier point ci-dessus (intranet), et de renseigner l&#8217;adresse du site : https://localhost:9443/grr

---+++ Accès à hyperion avec Putty

Comment accéder à un serveur interne au labo depuis l'extérieur, avec le logiciel Putty (souvent utilisé sur Windows)

(NB : si vous voulez vraiment utiliser ce logiciel sur Mac OS, il faut le faire via macport ; voici un lien utile : http://korben.info/installer-putty-mac.html)

*A. Solution simple, sans tunnel*

1) Démarrer Putty

2) Remplir les champs suivants :

Host Name = GATEWAY (nom à remplacer par le VRAI que je tairai sur cette page publique)

port = 22

connection type = ssh

3) Cliquer sur la catégorie "SSH" (à gauche), et sélectionner X11

4) Cocher "Enable X11 forwarding"

5) Cliquer sur la catégorie "Session" (à gauche, tout en haut)

6) Donner un nom à cette session dans le champ "Saved Sessions", par exemple "passerelle_labo"

7) Cliquer sur le bouton "Save"

From here, si on veut pouvoir visualiser des plots idl, il faut aussi démarrer le logiciel Xming (qu'on peut trouver ici : http://www.clubic.com/lancer-le-telechargement-202646-0-xming.html)

8) Exécuter cette session en cliquant sur le bouton "Open"

9) Saisir votre login puis votre mot de pass (ceux du webmail)

==> c'est bon, on est sur la passerelle

10) pour se loguer sur hyperion, taper ceci :

ssh -X monlogin@hyperion.cesr.fr

(le "-X" pas nécessaire si on ne veut pas d'affichage graphique)

(attention, ici utiliser le login hyperion, pas celui du webmail)

puis entrer votre mot de passe de hyperion (pas celui du webmail)

==> c'est bon, on est sur hyperion

11) Tester si on a bien une connexion graphique

xterm

ou bien démarrer idl et faire un plot

Si ça ne marche pas c'est qu'il faut donner le nom exact du DISPLAY dans la session putty.

Depuis hyperion, pour voir le numero exact du display (normalement quelque chose comme localhost:11.0 ou 11.1...), taper :

echo $DISPLAY

et mettre ce nom dans putty, dans SSH/X11/"X display location" (avec "Enable X11 forwarding" coché)


*A. Solution avec tunnel*

Si on a besoin de faire ça souvent, il vaut mieux "creuser" un tunnel d'accès direct au serveur hyperion (ou autre),
afin de pouvoir s'y connecter directement (sans l'étape passerelle, qui devient un intermédiaire transparent).

//TODO


---++ MAC OS X

---+++ locate

Il faut créer la bd une première fois :

sudo launchctl load -w /System/Library/LaunchDaemons/com.apple.locate.plist

---+++ VIM

http://macvim.org/OSX/index.php

By default, Vim runs in "compatible" mode. That is, it acts a lot like traditional vi, without the improvements. Unless you want a maximally vi-compatible version of vim, I recommend that you copy the standard startup files to your home directory, and name them .vimrc and .gvimrc.

Ce que j'ai fait simplement :

1) recherche de vimrc_example :

locate vimrc

2) Copie locale :

cp /usr/share/vim/vim73/vimrc_example.vim .vimrc


---+++ Installation AMP avec XAMPP (solution la plus simple, bien pour le développement, mais pas très blindée pour un serveur de production)

Version 1.7.3

http://www.apachefriends.org/en/xampp-macosx.html

(ou aussi en french, mais moins à jour, http://www.apachefriends.org/fr/xampp-macosx.html)


1) Download

2) Install (environ 300Mo)

XAMPP est installé dans le répertoire/Applications/XAMPP

3) Démarrer

sudo /Applications/XAMPP/xamppfiles/xampp start

Sur l'écran devrait apparaitre les instructions suivantes:

Démarre XAMPP pour MacOS X 1.7.3...
XAMPP: Démarre Apache avec SSL...
XAMPP: Démarre MySQL...
XAMPP: Démarre ProFTPD...
XAMPP démarré.

Moi j'ai plutôt un pb avec proftpd, sans doute incompatible avec mac :

File permissions are being checked...ok.
Starting XAMPP for Mac OS X 1.7.3...
XAMPP: Starting Apache...ok.
XAMPP: Starting MySQL...ok.
XAMPP: Starting ProFTPD...XAMPP/XAMPP/xamppfiles/xampp: line 184: /Applications/XAMPP/xamppfiles//var/proftpd/start.err: No such file or directory
fail.
Contents of "/Applications/XAMPP/xamppfiles//var/proftpd/start.err":
cat: /Applications/XAMPP/xamppfiles//var/proftpd/start.err: No such file or directory

4) Tester

http://localhost/ pointe automatiquement sur :

http://localhost/xampp/splash.php

et ça marche !

Si plus tard on remplace la page d'accueil de XAMPP par la sienne, on peut toujours joindre la page d'accueil de XAMPP avec http://localhost/xampp/

5) Aspects sécurité 

Comme cela a déjà été expliqué antérieurement XAMPP n'est pas fait pour l'emploi de production, mais seulement pour développeur et l'environnement du développement. Cela a pour suite que XAMPP est volontairement préconfiguré pour ne pas être restrictif et être au contraire trés ouvert. Pour un développeur cela est idéal qu'il ne soit pas limité par les limites du systéme. Par contre pour un emploi en production cela est absolument pas recommendable.

Ici, une liste de choses donc XAMPP est volontairement(!) insécurisé:

    1. L'administrateur (root)MySQL n'a pas de mot de passe.
    2. Le démon MySQL est joignable par le réseau.
    3. Le démon ProFTPD utilise le mot de passe "xampp".
    4. PhpMyAdmin est joignable par le réseau.
    5. MySQL et Apache fonctionne sous le même utilisateur (nobody)

Dans la page XAMPP-Demo (que l'on trouve sous http://localhost) il y a le point "Security check". À cet endroit on peut faire apparaître le niveau de sécurité actuel de XAMPP.

Si on veut utiliser XAMPP en réseau , pour que le serveur XAMPP soit accessible par d'autres utilisateurs, alors il faut impérativement exécuter les commandes suivantes avec lesquelles ont pourra alors limiter les failles de sécurité:

/Applications/XAMPP/xamppfiles/xampp security


6) START et STOP

To start XAMPP simply open XAMPP Control and start Apache, MySQL and ProFTPD.

Mais, on peut aussi utiliser la commande /Applications/XAMPP/xamppfiles/xampp :

on peut non seulement démarrer Xampp mais aussi exécuter d'autres commandes :

Pour arrêter XAMPP simplement entrer cette commande:

/Applications/XAMPP/xamppfiles/xampp stop

Pour démarrer Apache avec support SSL suivre les commandes suivantes:

/Applications/XAMPP/xamppfiles/xampp startssl

Et Apache avec support SSL fonctionne déjà. Joignable sous https://localhost.

Liste des autres commandes : http://www.apachefriends.org/fr/xampp-macosx.html#3413



7) FICHIERS ET RÉPERTOIRES IMPORTANTS

/Applications/XAMPP/xamppfiles/bin

	Ici les commandes pour XAMPP.

(il suffit de placer /Applications/XAMPP/xamppfiles/bin  dans mon $PATH pour que j'ai accès à toutes les commandes de xampp directement, telles que "mysql")

/Applications/XAMPP/xamppfiles/bin/mysql appelle par ex .MySQL.

/Applications/XAMPP/htdocs/

	Le répertoire Root du serveur web Apache. Ici sont les pages web d'Apache.

/Applications/XAMPP/etc/httpd.conf

	Le fichier central de configuration du serveur web Apache.

/Applications/XAMPP/etc/my.cnf

	Le fichier de configuration pour le serveur MySQL-Base de données.

/Applications/XAMPP/etc/php.ini

	Le fichier de configuration de PHP.

/Applications/XAMPP/etc/proftpd.conf

	le fichier de configuration de ProFTPd. 

8) Mes Sites Webs

You can put your Websites in /Applications/XAMPP/htdocs/ and access them via http://localhost/

Or you put your Websites in the Sites-Folder in your Home and access them via http://localhost/~pallier/.

Whats the username and the password for MySQL?

Username:	root
Password:	No password


9) Désinstallation

To uninstall XAMPP just stop it and move it to the Trash.

Ou bien

sudo rm -rf /Applications/XAMPP



---+++ Installation AMP (Apache Mysql Php) en utilisant MacPort

http://www.blogafab.com/installer-apache-2-mysql-5-et-php-5-3-sur-mac-os-10-7-lion-avec-macport/

Install XCode4 via AppleStore (1,8 Go) (AC)

Install MacPort2 (1,7Mo only) :

    Téléchargez MacPorts 2.0 sur le site officiel http://www.macports.org/

    Ouvrez le fichier .dmg que vous venez de télécharger

    Lancez le fichier .pkg et suivez les instructions

    Crée un fichier ~pallier/.bash_login qui ajoute /opt/local/bin au PATH

sudo port -v selfupdate

---++++ Installation Apache 2

    Téléchargez et installez Apache2 et ses dépendances :

    sudo port install apache2

    Une fois l&#8217;installation terminée, vous pouvez activer lancement automatique de Apache au démarrage de l&#8217;ordinateur :

    sudo port load apache2

fichiers sont dans /Library/LaunchDaemons/org.macports.apache2.plist

 
---++++ Installation MySQL 5

    Téléchargez et installez MySQL 5 et ses dépendances :

    sudo port install mysql5

    Installez/Activez le serveur MySQL 5 :

    sudo port install mysql5-server

    Une fois l&#8217;installation terminée, vous pouvez activer le lancement automatique de MySQL au démarrage de l&#8217;ordinateur :

    sudo port load mysql5-server

    Terminez l&#8217;installation de MySQL :

    sudo -u _mysql mysql_install_db5

    Une fois l&#8217;installation terminée, vous pouvez lancer MySQL au démarrage de l&#8217;ordinateur :

    sudo port load mysql5

 
---++++ Installation PHP 5.3

    Téléchargez et installez PHP 5.3 et ces dépendances. A noter ici que je choisi également d&#8217;activer le PEAR, d&#8217;où le +pear.

    sudo port install php5 +pear

    Ajoutez le module PHP pour Apache 2 :

    sudo /opt/local/apache2/bin/apxs -a -e -n "php5" /opt/local/apache2/modules/libphp5.so

    Créez le fichier de configuration php.inide PHP :

    sudo cp /opt/local/etc/php5/php.ini-development /opt/local/etc/php5/php.ini

    Installez et activez MySQL pour PHP :

    sudo port install php5-mysql

    Étape optionnelle : Installez quelques extensions utiles pour PHP (apc, curl, gd, iconv, mbstring, &#8230;).

    sudo port install php5-apc php5-curl php5-gd php5-iconv php5-intl php5-mbstring php5-mcrypt php5-posix php5-sqlite php5-xdebug php5-zip

   * Configuration de votre environnement LAMP


---++++ Configuration Apache 2

Les étapes ci-dessous permettent de configurer le support de PHP dans Apache et d&#8217;activer le module UserDir (facultatif).

    Activer PHP dans Apache
        Éditez le fichier /opt/local/apache2/conf/httpd.conf
        Ajoutez à la fin du fichier

        # Include PHP configuration
        Include conf/extra/mod_php.conf

    Ajouter index.php dans les pages d&#8217;index reconnues par Apache
        Éditez le fichier /opt/local/apache2/conf/httpd.conf
        Recherchez la ligne ci-dessous :

        DirectoryIndex index.html

        Ajoutez sur la même ligne, à la fin :

         index.php

    Étape optionnelle : Activer l&#8217;extension UserDir pour Apache. Cette extension permet d&#8217;avoir des urls dédiées pour chaque utilisateur de l&#8217;ordinateur du type http://localhost/~utilisateur/
        Éditez le fichier /opt/local/apache2/conf/httpd.conf
        Recherchez et décommentez la ligne ci-dessous :

        #Include conf/extra/httpd-userdir.conf

        Étape optionnelle : Autoriser l&#8217;ajout/suppression d&#8217;options via un .htaccess (exemple Options +FollowSymLinks)
            Éditez le fichier /opt/local/apache2/conf/extra/httpd-userdir.conf
            Recherchez la ligne ci-dessous :

            AllowOverride FileInfo AuthConfig Limit Indexes

            Ajoutez sur la même ligne, à la fin :

             Options

    Une fois les modifications effectuées, vous pouvez (re)démarrer Apache :

    sudo /opt/local/apache2/bin/apachectl restart

---++++ Configuration MySQL 5

Les étapes ci-dessous ont pour objectif de configurer et sécuriser votre serveur MySQL.

    Démarrez le serveur MySQL

    sudo /opt/local/lib/mysql5/bin/mysqld_safe &

    Sécurisez votre serveur MySQL. Je vous recommande de configurer le mot de passe root et de répondre « Yes » à toutes les questions.

    sudo /opt/local/lib/mysql5/bin/mysql_secure_installation

---++++ Configuration PHP 5

    Configurer MySQL pour PHP
        Éditez le fichier /opt/local/etc/php5/php.ini
        Recherchez les paramètres pdo_mysql.default_socket, mysql.default_socket, mysqli.default_socketet mettez comme valeur ceci :

        /opt/local/var/run/mysql5/mysqld.sock

    Configurer le fuseau horaire par défaut
        Éditez le fichier /opt/local/etc/php5/php.ini
        Recherchez la ligne suivante :

        ;date.timezone =

        Remplacez par :

        date.timezone = "Europe/Paris"

    Étape optionnelle : Activer les archives Phar
        Éditez le fichier /opt/local/etc/php5/php.ini
        Recherchez et décommentez la ligne ci-dessous

        ;phar.readonly = On

    Une fois les modifications terminées, redémarrez votre serveur Apache 2.


---++++ Gestion

Apache :

Fichier gestion : /Library/LaunchDaemons/org.macports.apache2.plist

start : sudo port load apache2 (apachectl start/stop ne semble pas marcher)

Voir les processus apache : ps -efl|grep apac

stop : sudo port load apache2

(le Apache d'origine de Mac est démarré via les préférences systèmes, partage, web : on voit alors les processus avec "ps -efl | grep http")






---+++ Installation AMP (Apache Mysql Php) en utilisant les packages Mac OS pré-existant

apache déjà installé, mais pas activé

php déjà installé mais pas activé

mysql à installer

---++++ Apache

Pour activer le serveur, allez dans Préférences système -> Partage et cochez la case Partage Web. Si elle est déjà cochée, décochez-la pour arrêter le serveur et recochez-là pour que la modification du fichier httpd.conf soit prise en compte.

v2.2.20

/usr/sbin/

Documents : /Library/Webserver/Documents/

---++++ PHP

v5.3.6

Php : /usr/lib/

Pour activer PHP il faut décommenter la ligne #LoadModule php5_module libexec/apache2/libphp5.so du fichier httpd.conf situé dans le dossier apache2 du dossier etc.

Ensuite réactiver le serveur apache (voir ci-dessus)

Ajouter test.php dans le rep doc de apache qui contient :

<?php phpinfo() ?>

http://localhost/test

ou encore http://localhost:80/test

---++++ Mysql 5.5.20

http://www.patpro.net/blog/index.php/2008/01/27/135-mysql-sur-mac-os-x-105-en-5-minutes/

Download :

http://dev.mysql.com/downloads/

Community server

version 64 bits (format DMG) pour Mac OS 10.6


---+++ Configuration

masquer/afficher le dock (barre du bas) : cmd-alt-D

Avoir accès au labo depuis l'extérieur (via la passerelle SSH du labo) : suivre la procédure décrite sur l'intranet (https://intranet.irap.omp.eu/spip.php?article103)


   * *Créer un mot de passe pour root*

Par défaut, root n'a pas de mot de passe, il faut donc en définir un :

su passwd root

Ensuite, pour passer root, comme d'hab :

su -

ou

su - root

ou

sudo -s



   * *changer définitivement le nom du mac (hostname) : pour moi c'était "mac-13"*

pomme, préférences systèmes, partage : changer le nom, puis fermer

(sudo hostname newname ne change que temporairement)

sudo scutil --set HostName hostname[.domain]

(if the domain is not specified the hostname will be automatically configured as .local)



   * *Créer un script de démarrage bash*

vi .bash_login :
source .bash_rc

vi .bash_rc :
alias l="ls -l"


   * *Installer sprinter*

Pref Sys / Imprimantes

bouton "+"

bouton "IP"

rechercher "sprinter.cesr.fr"

elle est trouvée en tant que "hp laserjet 2300 series"



   * *Partitionnement du disque :*

http://www.osxfacile.com/partition.html

Applications / Utilitaires / Utilitaire de disque

onglet "Partition"

Diminuer la partition unique "Macintosh HD" de 500 à 100Go

Bouton "+" pour ajouter une nouvelle partition de 400Go


   * *modif du mapping clavier :*

 http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&item_id=ukelele

http://support.apple.com/kb/HT1220


   * *Firefox*

 ScrapBook plugin : Volumes/DATA/ScrapBook


---+++ Transition depuis le monde Windows

Visualiser un dossier ou fichier caché : http://perso.univ-lyon2.fr/~brogniar/articles/mosx-fichier-invisible.html

maj-pom-G

Pour montrer les éléments cachés il faut taper la commande "defaults write com.apple.finder AppleShowAllFiles 1".
Pour cacher à nouveau les fichiers et dossiers spéciaux il faut taper la commande "defaults write com.apple.finder AppleShowAllFiles 0".
L'utilitaire TinkerTool de Marcel Bresink permet de régler ces préférences d'une manière plus conviviale.

   * *Déplacement clavier :*

home : cmd left
end : cmd right
mot : alt left/right
Effacer le mot suivant Ctrl+Suppr


   * *Navigation :*

entre applis : Cmd Tab
entre onglets d'une mm appli : ctrl tab
entre fenêtres d'une mm appui : (alt tab ???)
cmd * (sur clavier mac, c'est cmd `, sous le £), à droite de la lettre "m"





---+++ Transition depuis le monde Linux

packages = .dmg

   * *Gestion des Services*

Pas de /etc/init.d/

A la place :

/System/Library/StartupItems et /Library/StartupItems

Apple provides a program called SystemStarter which is used to start and stop scripts in the /System -> Library -> StartupItems and /Library -> StartupItems folders. You can use it to restart services like so:
 % sudo SystemStarter restart NetInfo
Or if you've just installed GimpPrint and need to restart CUPS for it to find your printer:
 % sudo SystemStarter restart PrintingServices
The one caveat is that all the start, stop, and restart options do is pass this argument to the various scripts. If the script doesn't respond to that argument, nothing happens. An example is AppServices, which controls coreservicesd. Sending stop or restart to this script has no effect. 

Type man SystemStarter and browse through the various scripts to learn more about the program and the scripts.


---+++ Astuces, raccourcis clavier

RACCOURCIS

caractère DIESE : maj alt * (touche à droite du "m")

Refaire (Ctrl+Maj+Z) Cmd+Maj+Z
Ouvrir un menu contextuel (Maj+F10) Ctrl+Espace

(Windows-E) Cmd-Maj-C Ouvre la fenêtre Computer sous Windows. / Va sur la vue Computer dans le Finder sous Mac OS X

(Ctrl-Maj-Echap) Cmd-Option-Esc Ouvre une fenêtre permettant de forcer l'arrêt d'une application

Quitter un programme <Command> + <Q>

Afficher les propriétés <verbatim><Command> + <I></verbatim>

Forcer à quitter : Command + Option + Escape

Capture d'écran : Command + Shift + 3

Bureau : F11

Voir l'ensemble des appris en réduction : F9 et F10

Masquer finder : cmd H

Masquer les autres : cmd alt H

Créer un alias : Pom-alt + déplacer une icone sur bureau

Créer un alias/raccourci : Command + L


=============================================================

---++ JAVA

---+++ Start a Java program

http://www.vogella.de/articles/JavaIntroduction/article.html#classpath

Run your program outside Eclipse :

Open a command shell, e.g. under Microsoft Windows select Start -> Run and type in cmd. This should open a consle.

Switch to your output directory, e.g. by typing cd path, e.g. if you jar is located in "c:\temp" type "cd c:\temp".

To run this program you need to include the jar file into your classpath.

<pre>				
java -classpath myprogram.jar de.vogella.eclipse.ide.first.MyFirstClass
</pre>		

You can use the classpath to run the program from another place in your directory.

Switch to the command line, e.g. under Windows Start-> Run -> cmd. Switch to any directory you want. Type:
				
<pre>
java HelloWorld
</pre>

If you are not in the directory in which the compiled class is stored then the system should result an error message Exception in thread "main" java.lang.NoClassDefFoundError: test/TestClass

To use the class type the following command. Replace "mydirectory" with the directory which contains the test directory. You should again see the "HelloWorld" output.
	
<pre>			
java -classpath "mydirectory" HelloWorld
</pre>		

Create an executable JAR

A JAR file is a Java Archive based on the pkzip file format. A jar files can contain java classes and other resources (icons, property files) and can be executable.

JAR files are the deployment format for Java. You can distribute your program in a jar file or you can use exiting java code via jars by putting them into your classpath.

An executable JAR means the end-user doesn't have to pull the class files out before running the program. This is done via a manifest.txt file which tells the JVM which class has the main() method. The content of the manifest.txt file:

 Manifest-Version: 1.0 Main-Class: MyApp Class-Path:
				. lib/jcommon-1.0.6.jar lib/itext-1.4.6.jar "Empty Line"
			

An empty line is required otherwise the jar won't be executable. Space after a new line is also required

To create one executable JAR file run on the command line

<pre>
 jar -cvmf mainfest.txt app1.jar *.class
</pre>		





---++ ECLIPSE

---+++ SVN : Supprimer une location (une adresse de dépôt)

Window -> show view -> Other... -> SVN repositories

sélectionner une location et la supprimer (touche suppr)

---+++ Install Eclipse Indigo (3.7) sur Mac OS X (10.7.2) avec Yoxos : NE MARCHE PAS

1) Download Yoxos :

 http://eclipsesource.com/en/downloads/eclipse-indigo-download/

download for mac 64 bits


2) Run Yoxos :

Add "Eclipse for java developpers"

SwingDesigner (inclus) : http://code.google.com/intl/fr/javadevtools/wbpro/whatsnew/index.html

WindowBuilder (inclus) : http://code.google.com/intl/fr/javadevtools/wbpro/quick_start.html

(Junit est déjà inclut)

Add subclipse

Add pdt

Add MakeGood (TDD intégré à pdt)

Add php source feature (automatic php code generation, getters, setters...)

FEST ??? : 
http://code.google.com/p/fest/
http://fest.easytesting.org/
http://docs.codehaus.org/display/FEST/Home

CA NE MARCHE PAS !!!

DONC, INSTALLATION MANUELLE (ci-dessous)




---+++ SVN avec le plugin Subclipse

1) (Pas sûr que ça soit nécessaire) install client subversion en local sur le disque (avec JavaHL)

(http://subclipse.tigris.org/wiki/JavaHL#head-5bf26515097c3231c1b04dfdb22c036bc511926b)

http://www.open.collab.net/downloads/community/

downloaded subversion 1.6.x

Installé dans /opt/subversion (/opt a été créé pour l'occasion lors de l'installation !!!!)

Uninstallation Notes
To uninstall the Subversion 1.6.17 Universal binary, just run the following:

sudo rm -fR /opt/subversion
pkgutil --forget net.collab.subversion



2) install subclipse (plugin eclipse)
 
Help / Install new software

http://subclipse.tigris.org/update_1.6.x/ (la version 1.8 ne marchait pas)

(pour info, voir http://subclipse.tigris.org)




---+++ JUnit

1) installer Eclipse pour Java (testé avec 3.7 Indigo)

Download "Eclipse IDE for Java Developers" from http://www.eclipse.org/downloads

2) installer Junit

http://www.vogella.de/articles/JUnit/article.html

http://junit.sourceforge.net/doc/cookbook/cookbook.htm

When you need to test something, here is what you do:
<pre>
    Annotate a method with @org.junit.Test
    When you want to check a value, import org.junit.Assert.* statically, call assertTrue() and pass a boolean that is true if the test succeeds
    (Use a method provides by JUnit to check the expected result of the code execution versus the actual result)
</pre>

For example, to test that the sum of two Moneys with the same currency contains a value which is the sum of the values of the two Moneys, write:
<pre>
@Test 
public void simpleAdd() {
        Money m12CHF= new Money(12, "CHF"); 
        Money m14CHF= new Money(14, "CHF"); 
        Money expected= new Money(26, "CHF"); 
        Money result= m12CHF.add(m14CHF); 
        assertTrue(expected.equals(result));
}
</pre>

Fixture :

What if you have two or more tests that operate on the same or similar sets of objects?

Tests need to run against the background of a known set of objects. This set of objects is called a test fixture. When you are writing tests you will often find that you spend more time writing the code to set up the fixture than you do in actually testing values.

To some extent, you can make writing the fixture code easier by paying careful attention to the constructors you write. However, a much bigger savings comes from sharing fixture code. Often, you will be able to use the same fixture for several different tests. Each case will send slightly different messages or parameters to the fixture and will check for different results.

When you have a common fixture, here is what you do:

    Add a field for each part of the fixture
    Annotate a method with @org.junit.Before and initialize the variables in that method
    Annotate a method with @org.junit.After to release any permanent resources you allocated in setUp

For example, to write several test cases that want to work with different combinations of 12 Swiss Francs, 14 Swiss Francs, and 28 US Dollars, first create a fixture:

public class MoneyTest { 
    private Money f12CHF; 
    private Money f14CHF; 
    private Money f28USD; 
    
    @Before public void setUp() { 
        f12CHF= new Money(12, "CHF"); 
        f14CHF= new Money(14, "CHF"); 
        f28USD= new Money(28, "USD"); 
    }
}

Once you have the Fixture in place, you can write as many Test Cases as you'd like. Add as many test methods (annotated with @Test) as you'd like. 


You use a tool like Eclipse or the class "org.junit.runner.JUnitCore" to run the test. 

Download junit-dep-4.10 from https://github.com/KentBeck/junit/downloads

3) Créer un projet Java

Create a new project "de.vogella.junit.first". 

We want to create the unit tests in a separate folder. Create therefore a new source folder "test" via right mouse click on your project, select properties and choose the "Java Build Path". Select the tab source code. 
Press "Add folder" then then press "Create new folder". Create the folder "test". 
The creation of an separate folder for the test is not mandatory. But it is good advice to keep the test coding separate from the normal coding. 

Create a Java class

Create a package "de.vogella.junit.first" and the following class.

<pre>
package de.vogella.junit.first; 
public class MyClass { 
public int multiply(int x, int y) { return x / y; } 
}
</pre>
			

4) Create a JUnit test 

Select your new class, right mouse click and select New ->JUnit Test case, change the source folder to JUnit. Select "New JUnit 4 test". Make sure you change the source folder to test.

Press next and select the methods which you want to test. 

If you have not yet JUnit in your classpath, Eclipse will asked you if it should be added to the classpath. 

Create a test with the following code.

<pre>

package de.vogella.junit.first; 
import org.junit.Test; 
import static org.junit.Assert.assertEquals; 

public class MyClassTest {
@Test public void testMultiply() { 
MyClass tester = new MyClass(); 
assertEquals("Result", 50, tester.multiply(10, 5)); 
} 
}

</pre>
			

5) Run your test via Eclipse

Right click on your new test class and select Run-As-> Junit Test. 

The test should be failing (indicated via a red bar). This is due to the fact that our multiplier class is currently not working correctly (it does a division instead of multiplication). Fix the bug and re-run test to get a green light. 

If you have several tests you can combine them into a test suite. All test in this test suite will then be executed if you run the test suite. To create a new test suite, select your test classes, right mouse click-> New-> Other -> JUnit -Test Suite

Select next and select the methods you would like to have test created for. 

cela crée une classe AllTests.java :

<pre>
package de.vogella.junit.first;

import org.junit.runner.RunWith;
import org.junit.runners.Suite;
import org.junit.runners.Suite.SuiteClasses;

@RunWith(Suite.class)
@SuiteClasses({ MyClassTest.class, OtherClassTest.class })
public class AllTests {

}

</pre>

If you later develop another test you can add it to @Suite.SuiteClasses 


6) Run your test via code 

You can also run your test via your own coding. The class "org.junit.runner.JUnitCore" provides the method runClasses() which allows you to run one or several tests classes. As a return parameter you receive an object of type "org.junit.runner.Result". This object can be used to retrieve information about the tests and provides information about the failed tests.

Create in your "test" folder a new class "MyTestRunner" with the following coding. This class will execute your test class and write potential failures to the console.

<pre>			
package de.vogella.junit.first;

import org.junit.runner.JUnitCore;
import org.junit.runner.Result;
import org.junit.runner.notification.Failure;

public class MyTestRunner {
	public static void main(String[] args) {
		Result result = JUnitCore.runClasses(MyClassTest.class);
		for (Failure failure : result.getFailures()) {
			System.out.println(failure.toString());
		}
	}
}
</pre>
		

7) Annotations and Assert statements

a) Annotations

The following give an overview of the available annotations in JUnit 4.x 	

<pre>
Annotation 	Description
@Test public void method() 	Annotation @Test identifies that this method is a test method.
@Before public void method() 	Will perform the method() before each test. This method can prepare the test environment (called a "fixture"), e.g. read input data, initialize the class)
@After public void method() 	Test method must start with test
@BeforeClass public void method() 	Will perform the method before the start of all tests. This can be used to perform time intensive activities for example be used to connect to a database
@AfterClass public void method() 	Will perform the method after all tests have finished. This can be used to perform clean-up activities for example be used to disconnect to a database
@Ignore 	Will ignore the test method, e.g. useful if the underlying code has been changed and the test has not yet been adapted or if the runtime of this test is just to long to be included.
@Test(expected=IllegalArgumentException.class) 	Tests if the method throws the named exception
@Test(timeout=100) 	Fails if the method takes longer then 100 milliseconds
</pre>


b) Assert statements

The following gives an overview of the available test methods:

<pre>
Statement 	Description
fail(String) 	Let the method fail, might be usable to check that a certain part of the code is not reached.
assertTrue(true); 	True
assertsEquals([String message], expected, actual) 	Test if the values are the same. Note: for arrays the reference is checked not the content of the arrays
assertsEquals([String message], expected, actual, tolerance) 	Usage for float and double; the tolerance are the number of decimals which must be the same
assertNull([message], object) 	Checks if the object is null
assertNotNull([message], object) 	Check if the object is not null
assertSame([String], expected, actual) 	Check if both variables refer to the same object
assertNotSame([String], expected, actual) 	Check that both variables refer not to the same object
assertTrue([message], boolean condition) 	Check if the boolean condition is true.
</pre>


8) Fixture (see http://junit.sourceforge.net/doc/cookbook/cookbook.htm)

9) Running Tests FROM JAVA (see http://junit.sourceforge.net/doc/cookbook/cookbook.htm)

10) Expected Exceptions (see http://junit.sourceforge.net/doc/cookbook/cookbook.htm)




---++ WIKI

Voir aussi Main.InformationAboutThisTwiki

Tutoriel : TWiki.TWikiTutorial

---+++ Niveau Utilisateur

---++++ Créer un raccourci vers une icône :

Par exemple, créer %TD% comme raccourci de l'icône TODO :

Editer Main.TWikiPreferences
<pre>
* Set TD = %ICONURL{todo}%
* Set DO = <img src="%ICONURLPATH{done}%" alt="DONE" title="DONE" height="16" border="0" />
</pre>


---++++ Commentaire

<pre>
Html comment = <!-- comment -->
Twiki comment = # comment
</pre>

---++++ Voir ce qui change sur le site

Pour savoir ce qui a changé (en ordre chronologique) sur le web !Team, consulter cette page : Team.WebChanges

Changements survenus sur le web "twiki" : TWiki.WebChanges

on peut aussi s'inscrire sur cette page pour recevoir les changements du web Team par email : Team.WebNotify

---++++ Contribuer (enrichir le site) 

Vous êtes vivement encouragés à contribuer au contenu de ce site.

Pour modifier n'importe quelle page du site :
   * cliquez sur bouton "Edit", faites vos modifs, puis cliquez sur le bouton "Save".
   * si vous êtes plus à l'aise avec la souris, cliquez plutot sur le bouton "WYSIWYG"


---++++ Faire une copie (de sauvegarde) d'un Web (pour consultation offline) :
   * Grace au plugin !PublishContrib, on peut obtenir une copie du Web à tout instant (attention, cette copie est READ ONLY, ce n'est plus un wiki, mais juste des pages web).
   * Pour publier la version courante du Web, aller sur le topic ChemCam.PublishWeb, et cliquer sur le bouton "Publish" (en milieu de page). Par défaut, c'est l'option "zip" qui est sélectionnée, ce qui crée un zip du Web.
   * Il suffit maintenant de cliquer en bas de la page générée par la requete, sur le lien "Published To: !NomduWeb.zip", pour télécharger ce zip (L'accès à cette adresse est protégé pour que seuls les personnes enregistrées puissent y acceder)
   * Dézipper et cliquer sur la page !WebHome.html. Le résultat n'est pas très joli, mais le contenu y est...
   * Un historique de la dernière publication se trouve dans le topic PublishContribHistory (utile pour voir si tout s'est bien passé)

---++++ Mise à jour d'une pièce attachée (remarque) : 

Il vaut mieux utiliser des noms de fichier assez génériques (par exemple !FDD.pdf au lieu de !FF_v1.4.pdf) ainsi on peut mettre à jour un document sans changer son nom et les liens vers ce fichier

---++++ Insérer une icone:
| <verbatim>%Y%</verbatim> | %Y% |
| <verbatim>%TD%</verbatim> ou <verbatim>%ICONURL{todo}%</verbatim> | %ICONURL{todo}% |
| <verbatim>%DO%</verbatim> ou <verbatim>%ICONURL{done}%</verbatim> | %ICONURL{done}% |
| <verbatim>%CL%</verbatim> ou <verbatim>%ICONURL{closed}%</verbatim> | %ICONURL{closed}% |
Pour en savoir plus: TWiki.TWikiDocGraphics#Status_flag_LED_tag_icons


---++++ RACCOURCIS PRATIQUES

   * !ActionTrackerPlugin info : http://twiki.org/cgi-bin/view/Plugins/ActionTrackerPlugin et https://www.seegrid.csiro.au/twiki/bin/view/TWiki/ActionTrackerPlugin

   * Liste de tous les users twiki enregistrés : Main.UserList

   * Liste plus générale des users twiki : Main.TWikiUsers

   * Liste de tous les groupes du twiki : Main.TWikiGroups

   * Liste de tous les topics : WebTopicList

   * Notifications : WebNotify


---+++ Niveau Administrateur

Voir aussi Main.InformationAboutThisTwiki





---++ IDL

---+++ Utiliser mon IDL perso (de mon pc) depuis l'extérieur du labo (mais aussi à l'intérieur) (en une seule config)

Problème : Comment exécuter mon idl (celui qui est installé localement sur mon pc/mac) à l'extérieur du labo (mais aussi à l'intérieur) ???

Réponse : en profitant des licences du serveur hyperion

Il s'agit de faire une configuration unique qui vous permettra d'utiliser votre idl installé sur votre portable, quelque soit votre situation, aussi bien :
   * à l'extérieur du labo
   * en wifi (y-compris wifi IRAP au labo)
   * à l'intérieur du labo, dans votre bureau, branché avec un câble réseau

Comprenez bien qu'il s'agit d'exécuter l'idl de votre portable, PAS CELUI d'HYPERION.
Donc, vous n'aurez pas accès aux données qui sont sur hyperion, sauf si vous en avez une copie locale sur votre portable.
Si vous voulez exécutez idl SUR HYPERION, alors c'est différent, il s'agit seulement de se connecter à hyperion via la passerelle
(voir à ce sujet la section "Accès à hyperion avec Putty")

Si vous êtes toujours partants, allez directement au point 2)

*1) Travail à faire pour l'administrateur système sur hyperion* (vous pouvez sauter cette section)

Modifier le fichier de licences /usr/local/itt/license/license.dat, remplacer la ligne : "DAEMON idl_lmgrd" par "DAEMON idl_lmgrd port=1701"

(cela force flexlm à utiliser le port 1701 pour idl_lmgrd)

Relancer les service lmgrd et idl_lmgrd

Si tout s'est bien passé, la commande "nmap hyperion.cesr.fr -p1700-1701" permet de voir que le port 1701 est bien ouvert

<pre>
$ nmap hyperion.cesr.fr -p1700-1701

Starting Nmap 4.11 ( http://www.insecure.org/nmap/ ) at 2012-10-08 18:10 CEST
Interesting ports on hyperion.cesr.fr (195.83.102.174):
PORT     STATE SERVICE
1700/tcp open  unknown
1701/tcp open  unknown

Nmap finished: 1 IP address (1 host up) scanned in 0.119 seconds
</pre>


*2) Pour vous (côté client), voici ce qui est à faire sur votre pc/mac*

NB: For English readers, go to section 3) below

*PREREQUIS* : idl doit être installé localement sur votre pc

*a) Positionner une variable d'environnement*

Positionner la variable d'environnement avec 2 serveurs de jetons (pour pouvoir bosser à l'INTERIEUR (port 1700 de hyperion) ET à l'EXTERIEUR (port 9700 de localhost) du labo sans jamais rien modifier) :

*Pour les utilisateurs de Windows*: 

Faire un clic droit sur Poste de Travail, puis onglet "Variables d'environnement", puis entrer la variable nommée LM_LICENSE_FILE avec la valeur "1700@hyperion.cesr.fr:9700@localhost")</i>

*Pour les utilisateurs !MacOS ou Linux*: 

Placer les 2 lignes suivantes (une fois pour toutes) dans votre fichier de démarrage *.bash_login* (depuis votre répertoire home, ou bien ~/.bash_login directement depuis n'importe où), pour ne plus avoir à les taper :
<pre>
export PATH=$PATH:PATH_TO_IDL_BIN
export LM_LICENSE_FILE="1700@hyperion.cesr.fr:9700@localhost"
</pre>
Il vous faudra remplacer PATH_TO_IDL_BIN par le chemin vers VOTRE installation d'idl (par exemple pour idl 8.3 sur Mac : /Applications/exelis/idl83/bin ou bien /Users/monlogin/Applications/exelis/idl83/bin si c'est une installation seulement sur votre compte)


Si vous travaillez à l'intérieur du labo, pas besoin de l'étape suivante, il vous suffit maintenant de lancer votre idl LOCAL (votre logiciel idl installé sur votre pc/mac).

Si vous êtes à l'extérieur du labo, continuez la lecture...


*b) Fichier de licence idl minimum*

Créer un fichier de licence nommé "license.dat" dans le repertoire "license" de votre installation d'idl (quelquechose comme C:\Programmes\exelis\license sur Windows et /Applications/exelis/license sur Mac), contenant les 6 lignes suivantes :
<pre>
############ license file comments, do not delete ###############  
# License Number(s):35689, 500181, 500448, 501255, 502304  
SERVER localhost 0021856ceeec 9700  
USE_SERVER  
DAEMON idl_lmgrd  
##################### end of license file #######################
</pre>


*c) "Creuser" un tunnel*

*Utilisateurs Mac et Linux :*

Pour les personnes qui utilisent Windows, aller à la section suivante "Utilisateurs Windows (avec Putty)"

Ouvrir un tunnel avec mise en correspondance de 2 ports :

   * Avec un éditeur de texte (style "vi" ou "emacs" ou "gedit"...), créer un fichier "A_EXECUTER_DEPUIS_CHEZ_MOI_AVANT_IDL.sh"
   * Y placer cette ligne unique :
   * ssh -L9700:hyperion.cesr.fr:1700 -L1701:hyperion.cesr.fr:1701 MON_LOGIN_EMAIL@GATEWAY
   * (remplacer MON_LOGIN_EMAIL par votre login utilisé pour le mail ou pour vous connecter à la passerelle du labo, et GATEWAY par le serveur passerelle du labo)
   * Sauvegarder ce fichier
   * Rendre ce fichier exécutable en tapant la commande suivante : chmod +x A_EXECUTER_DEPUIS_CHEZ_MOI_AVANT_IDL.sh
   * Exécuter ce fichier : ./A_EXECUTER_DEPUIS_CHEZ_MOI_AVANT_IDL.sh
   * Entrer votre login et mot de passe (du webmail)

(Remarque pour l'admin système : attention, sur le localhost on a le choix de la correspondance du port 1700 d'hyperion (port 9700 local) mais pas pour le 1701)

Allez maintenant à la section "d) Lancer idl"


*Utilisateurs Windows (avec Putty) :*

   * Télécharger Putty (http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe)

(NB : si vous voulez vraiment utiliser ce logiciel sur Mac OS, il faut le faire via macport ; voici un lien utile : http://korben.info/installer-putty-mac.html)

   * Démarrer Putty

   * Remplir les champs suivants :

Host Name = GATEWAY (nom à remplacer par le VRAI, avec son adresse complète (nom + domaine), nom que je tairai sur cette page publique)

port = 22

connection type = ssh

   * Déployer la catégorie "Connection/Session" (dans le panneau de gauche, en bas), et sélectionner "Tunnels"

   * Créer 2 tunnels :
      * local:9700 vers hyperion:1700 : 
         * Source port : 9700
         * Destination : hyperion.cesr.fr:1700
         * cliquer sur bouton Add
      * local:1701 vers hyperion:1701 : 
         * Source port : 1701
         * Destination : hyperion.cesr.fr:1701
         * cliquer sur bouton Add

   * Sauvegarder cette session

Cliquer sur la catégorie "Session" (dans le panneau de gauche, en haut)

Donner un nom à cette session dans le champ "Saved Sessions", par exemple "use_hyperion_idl_license" 

Cliquer sur le bouton "Save"

   * Exécuter cette session

Cliquer sur le nom de la session, et sur le bouton "Open"

Entrer votre login et mot de passe (du webmail)



*d) Lancer idl*

Voilà, vous avez créé un tunnel entre votre pc/mac et hyperion, passant par GATEWAY (vous êtes d'ailleurs connecté à la passerelle).

Il vous suffit maintenant de lancer votre idl LOCAL (votre logiciel idl installé sur votre pc/mac), comme d'habitude.

Attention, une fois la session idl terminée, ne pas oublier de détruire le tunnel en vous déconnectant d'hyperion !!! (il suffit de taper "exit" et vous serez déconnecté de GATEWAY)

*e) ON RECAPITULE ?*

Une fois les étapes ci-dessus réalisées, voici ce que vous avez à faire pour exécuter idl :

Je suis au labo : Rien à faire ! Juste lancer idl (ou idlde), c'est tout !

Je suis chez moi :

   * Mon poste tourne avec MacOS ou Linux :
<pre>
Ouvrir un terminal
Exécuter le fichier de creation du tunnel vers hyperion :
./A_EXECUTER_DEPUIS_CHEZ_MOI_AVANT_IDL.sh
Lancer votre idl
Fermer le tunnel vers hyperion seulement quand vous avez terminé de travailler avec idl : (taper "exit" dans le terminal)
</pre>

   * Mon poste tourne avec Windows :
<pre>
Ouvrir Putty et exécuter votre session nommée "use_hyperion_idl_license" (ou autre nom que vous avez donné à cette session)
Lancer votre idl
Fermer cette session seulement quand vous avez terminé de travailler avec idl
</pre>

Bon, on peut encore améliorer les choses... si ça vous dit, allez voir un peu plus loin, juste après la partie IN ENGLISH.

*3) Now, IN ENGLISH (and for Mac/Linux users only) :*

(First, be sure you have removed any remaining license.dat file from your itt/license/ directory ; just drop it, you don't need it)

3.1) set and export LM_LICENSE_FILE

Open a new terminal and set this variable :

$ export LM_LICENSE_FILE="1700@hyperion.cesr.fr:9700@localhost"

(you can also write this line once and for all in your ~/.bash_profile file, so that you won't have to do it every day)

If you are INSIDE the lab, you are finished. Just launch your (local) idl : $ idlde (or idl) (or from the Applications launcher)

If you are OUTSIDE the lab, you need one last step...


3.2) set a tunnel

Open a new terminal and create this tunnel :

$ ssh -L9700:hyperion.cesr.fr:1700 -L1701:hyperion.cesr.fr:1701 MYLOGIN@GATEWAY

You are now connected to the lab gateway.

Keep it open as long as you are running idl !

Only once finished with idl, don't forget to destroy the tunnel by closing the connexion to GATEWAY !!!


---

*4) ETAPE FACULTATIVE : On peut encore améliorer les choses... Comment ?*

En s'arrangeant pour ne plus avoir aucun mot de passe à entrer grâce aux clés publique&privée.

Voici comment faire...

*4.1) Créer une paire de clés privée/publique sur mon pc*

<pre>
$ ssh-keygen -t dsa
Generating public/private dsa key pair.
Enter file in which to save the key (/Users/pallier/.ssh/id_dsa): 
Enter passphrase (empty for no passphrase): 
Enter same passphrase again: 
Your identification has been saved in /Users/pallier/.ssh/id_dsa.
Your public key has been saved in /Users/pallier/.ssh/id_dsa.pub.
</pre>

*4.2) Distribuer ensuite la clé publique de mon pc sur la passerelle du labo (que nous appelerons GATEWAY pour raison de sécurité)*

La clé publique, doit être copiée sur le serveur distant dans ~/.ssh/authorized_keys. (La clé privée reste sur votre poste client)

Aller dans votre HOME

<pre>
ssh-copy-id -i .ssh/id_dsa.pub GATEWAY
(
ou bien, si on ne dispose pas de la commande ssh-copy-id, l'exemple est ici donné pour moi :
$ cat .ssh/id_dsa.pub | ssh epallier@GATEWAY "cat - >>.ssh/authorized_keys" 
)

</pre>

*4.3) Tester maintenant la connexion à GATEWAY*

ssh monlogin@GATEWAY

On peut désormais se connecter directement sans mot de passe !!!

*4.4) Faire de même entre GATEWAY et hyperion*

Maintenant, il suffit de faire la même chose que 2) et 3) mais depuis GATEWAY (et vers hyperion)

Quand c'est fait, depuis GATEWAY, on peut maintenant se connecter directement à hyperion sans mot de passe :

ssh monlogin@hyperion.cesr.fr

(je tape 2 fois "exit" pour revenir à mon pc)

Voilà, on peut maintenant créer le tunnel (voir ci-dessus) sans avoir aucun mot de passe à entrer.

Pour faire encore plus simple, on peut se créer un alias nommé "tunnel" :

alias tunnel = 'ssh -t -L 9700:localhost:1700 YOUR_IRAP_LOGIN@GATEWAY ssh -L 1700:localhost:1700 YOUR_HYPERION_LOGIN@hyperion.cesr.fr'

Il suffit alors de taper "tunnel" pour qu'il soit créé.


*Autre Méthode (pour info)*

Pour automatiser le "rebond" via GATEWAY*

On va maintenant rendre transparent le passage via GATEWAY. Il suffit pour cela de créer un fichier de config :

DEPUIS MON PC, j'édite le fichier .ssh/config, et j'y mets le contenu suivant :

<verbatim>
Host hyp
        Hostname hyperion.cesr.fr
        ProxyCommand ssh GATEWAY nc %h %p 2> /dev/null
</verbatim>

(Pour plus de détails : http://franek.chicour.net/post/2009/10/16/SSH-%3A-simplifier-les-connexions-avec-rebond)

VOILA C FINI, OUF !

Désormais, depuis votre pc, il suffit de faire un bête ssh :

ssh hyp (éventuellemtn avec l'option -X pour l'affichage graphique, si nécessaire)

(il suffit de taper une seule fois "exit" pour revenir à mon pc)


---+++ IDL 8.1 installer SVN

Selectionner  Window/Source Control Tools/Subversion

Selectionner le connecteur SVN nommé SVNKit 1.3.0 (for svn 1.6.2) (ou un plus ancien car le serveur svn qui est sur planetoweb est une ancienne version 1.4.4)

Terminer l'installation, redémarrer IDL, c'est fait

Le depot (repository) svn de chemcam est http://planetoweb.cesr.fr/chemcam_svn et accepte les comptes créés sur ce wiki



---+++ IDL 8.1 workbench (idlde) crash sous Mac OS 10.7

Voici ce qu'il faut faire pour corriger le pb :

cd /Applications/itt/idl/idl81/bin/bin.darwin.x86_64/

mv libcurl.4.0.1.dylib libcurl.4.0.1.dylib.bak

mv libcurl.4.dylib libcurl.4.dylib.bak

mv libcurl.dylib libcurl.dylib.bak

Lire l'article complet sur le pb :

http://www.exelisvis.com/Support/HelpArticleDetail/ArticleId/4698/IDL-8-1-Workbench-crashing-on-Mac-OS-X-10-7-2-and-10-7-3.aspx


---+++ OpenGL Direct Hardware Rendering on Linux

The "Direct Rendering Infrastructure" (DRI) or "Direct hardware rendering" is described here :

http://www.ittvis.com/services/techtip.asp?ttid=3524

As it currently does not work on hyperion, we have to deactivate it and activate "software rendering" instead (slower).

How to set IDL to use "software rendering" (IDL 8 issue) ?

   * From IDLDE

Fenêtre/Préférences/IDL/Graphiques :

Méthode de rendu pour les objets graphiques : sélectionner "Logiciel" au lieu de "Matériel"

   * From the idl console

There are a couple of ways to set IDL to use software rendering, besides from the IDLDE.  

If you want to set the entire IDL session to use software rendering, then when you start up IDL, you could use this command:

     idl -IDL_GR_WIN_RENDERER 1  (for Windows)
        or
     idl -IDL_GR_X_RENDERER 1  (for X Windows) 

If you want to switch from the default hardware rendering to software rendering in the middle of an IDL session, you could use this command:

     PREF_SET, 'IDL_GR_WIN_RENDERER', '1', /COMMIT  (for Windows)
        or
     PREF_SET, 'IDL_GR_X_RENDERER', '1', /COMMIT   (for X Windows)


---+++ Conseils pour bien documenter son code

   * Voir conseils généraux (Michael Galloy) "A style guide" : [[%ATTACHURL%/styleguide.pdf][styleguide.pdf]]

Je livre ici une synthèse des conseils de Michael Galloy pour bien documenter un code !IDL (Lire "A style guide" pour la version complète avec justifications) :

---++++ 1. General principles

1. Code is for humans. 

2. Do not mix styles. 

3. Avoid redundancy.

4. Use an easy to maintain style. 

---++++ 2. Layout 

1. Layout should enhance the logical structure of the code.

2. Use two spaces (not tabs) per indentation level. 

3. Use a maximum line length of 79 characters. 

4. Write code in paragraphs. 

Example:
<pre>
function mg_sample, nValues, nIndices, seed=seed 
  compile_opt strictarr 

  ; get random nIndices by finding the indices of the smallest 
  ; nIndices in an array of random values 
  values = randomu(seed, nValues) 

  ; our random values are uniformly distributed, so ideally 
  ; the nIndices smallest values are in the first bin of the 
  ; below histogram 
  nBins = nValues / nIndices 
  h = histogram(values, nbins=nBins, reverse_indices=ri)

  ; the candidates for being in the first nIndices will live in 
  ; bins 0..bin 
  nCandidates = 0L 
  for bin = 0L, nBins - 1L do begin 
    nCandidates += h[bin] 
    if (nCandidates ge nIndices) then break 
  endfor 

  ; get the candidates and sort them 
  candidates = ri[ri[0] : ri[bin + 1L] - 1L] 
  sortedCandidates = sort(values[candidates]) 

  ; return the first nIndices of them 
  return, (candidates[sortedCandidates])[0:nIndices-1L] 
end 
</pre>

5. Insert two blank lines between routines. 

One blank line separates "paragraphs"; two blank lines separate "sections." 


---++++ 3. Comments 

1. Document intent. 

2. Keep comments up to date with the code. 

3. For a short comment, use a phrase with lowercase first letter and no period. For longer comments, use all 
normal grammar rules. 

5. Write a complete header for each routine. 

Use comments between ;+ and ;- before the routine. Document the purpose of the routine, the return value (if 
a function), and side effects of the routine (which you should strive to eliminate). Each parameter should be 
documented with whether it is an input and/or output, optional or required, data type expected, default value (if 
any) and a description of its purpose. 

For example, the below is an IDLdoc formatted header for the routine listed above: 

<pre>
;+ 
; Get nIndices random indices for an array of size nValues (do 
; not repeat an index). 
;
; :Returns: lonarr(nIndices) 
;
; :Params: 
;     nValues : in, required, type=long 
;          size of array to choose indices from 
;     nIndices : in, required, type=long 
;         number of indices needed 
;
; :Keywords: 
;     seed : in, out, optional, type=long or lonarr(36) 
;         seed to use for random number generation, a new seed 
;         will be output 
;- 
function mg_sample, nValues, nIndices, seed=seed 
</pre>

6. Indent a comment along with the code it's documenting. 

7. Document paragraph by paragraph. 

Each paragraph of code may need a comment to document its purpose, but inside a paragraph use only end-of-line 
comments to comment particular lines. 
It can be helpful to write the comments first, providing an outline of the code to write. 

ex of end-of-line comment : 

if (event.type eq 2) then begin                    ; type 2 = motion events 

9. Don't repeat the code in the comments. 

Don't document the obvious. 

10. Don't add extra comments for convoluted code; improve the code. 

Don't document bad code&#8212;rewrite it. (Kernighan and Plauger, The Elements of Programming Style)

---++++ 4. Statement formatting 

---+++++ 4.1. Use lowercase for reserved words, operators, and compile_opt option names. 

For example, use: 
<pre>
compile_opt strictarr 
if (not done) then readf, lun, line 
</pre>

---+++++ 4.2. Use only one statement per line. 

For example, don't write: 

a = 1 & b = 2 

---+++++ 4.3. Prefer begin/end blocks unless the entire statements fits on one line. 

For a single, long statement, use: 
<pre>
for i = 0, 10 do begin 
  print, i, format='("The index is ", I0, ".")' 
end 
</pre>

But never write: 
<pre>
for i = 0, 10 do $ 
  print, i, format='("The index is ", I0, ".")' 
</pre>

---+++++ 4.5. Define structures one field per line unless the entire definition can fit on one line. 

For example, use: 
<verbatim>
point = { x: 0.0, y:0.0 } 
state = { x: 0.0, $ 
          y: 0.0, $ 
          pdata: ptr_new(), $ ; image data 
          drawId: 0L $ ; window identifier 
        } 
</verbatim>

---+++++  4.6. Add one space around most operators. 

ex:

slope = (y0 - y1) / (x0 - x1) 

tvscl, im, true=1 

bin = arr[r[r[i]:r[i + 1] - 1]] 

point = { x: 0.0, y: 0.0 } 

Also, don't add extra spaces in order to align values.

---+++++  4.7. Use single quotes for strings. 

Use double single quotes if you need a single quote. For example, 

sign = 'Eat at Joe''s' 

---+++++  4.9. Use capital letters to indicate the type of constant, use lowercase to indicate base of integers. 

Use 0L not 0l because "l" (lowercase letter el) looks like "1" (integer one). Use '5'o and '5'x, not '5'O and 
'5'X. 

---+++++  4.10. Use square brackets for array indices. 

Use 

compile_opt strictarr 

in each routine to prevent issues with IDL confusing arrays and functions calls. 


---++++  5. Variables 

1. Use good variable names. 

2. Variable names should be in camel case. 

Camel case uppercases the first letter of each word in the name except for the first letter. 

Uppercase each letter in an abbreviation that appears in a variable name unless it starts the name:

noaaWeatherURL. 

Prefix the name with "n" for variables that hold counts, "o" for object references, "p" for pointers, "id" for 
iTools identifiers. 

Examples that follow this convention, 
<pre>
nFiles 
oModel 
pState 
idPlot 
</pre>

3. Prefer pointers, objects, and passing local variables over common blocks or system variables. 

Occasionally there is a reason to use common blocks or system variables, but you should have a good argument 
for it. 

When using direct graphics, prefer using graphics keywords of the plotting routines over setting system 
variables directly.

4. Define common blocks and named structures in only one location. 

Define the variables in a common block only once in a batch file. Include that file where needed. 

map_proj_init_commonblock.pro is an example of this. 

Define a named structure using automatic structure definition. For example, define MG_Point in a routine 
named MG_POINT__DEFINE in a file named mg_point__define.pro. 


---++++  6. Routines 

1. For any file containing IDL code, filenames should always be in lower case and use the ".pro" extension. 

2. Each file should include only one routine called from outside the file. 

Each file should contain only one routine called from outside that file. Add the ".pro" extension to the routine 
name of the externally called routine to get the filename. For example, the routine MG_LINEAR_FUNCTION 
should be in a file named mg_linear_function.pro. If there are multiple routines in the file, make sure the 
externally called routine is last in the file.

3. Routine names should be lower case, begin with a short organization prefix, and separate words with 
underscores. 

The prefix indicates the individual or group responsible for the code. It is usually the initials of the individual or 
orgranization. Limit to two or three letters. Don't use the "IDL", "RSI", "ITT", "cw", "it", or empty prefixes. 

4. Routines should fit on one screen. 

5. Keywords should always be optional for the caller; positional parameters should generally be required. 

Keywords should either be an optional input with a reasonable default value or an extra output (i.e. not the 
main purpose of the routine). 

6. Keyword names should be lowercase and separate words with underscores.

For example, 
<pre>
filename 
ntests 
eye_separation 
left_image 
</pre>

7. Always use the full keyword name when calling the routine. 

8. If the purpose of a routine is to return a value, use a function, otherwise use a procedure. 

9. Status and error codes should be returned via keyword. 


---++++  7. Object-oriented programming 

1. Class names should begin with a prefix indicating organization and a code indicating the class' area of use. 
Each word should be capitalized 

Use the same prefix as given to normal routine names; avoid "IDL", "ITT", "RSI", and the empty prefix. 

Codes already in use by IDL: an (analysis), com (COM), db (database), ex (example), ff (file format), gr 
(graphics), it (iTools), sys (system), net (network), and _ (general use). Make use of the existing codes and 
make up new ones as necessary.

Use all caps for abbreviations in class names, as in IDLnetURL. 

2. Put all the methods and the routine defining the instance variables for a class into a single file. 

For the definition of MGexClass, the file should be named mgexclass__define.pro. The last routine in this file 
should be MGEXCLASS__DEFINE and should define the instance variables for the class (i.e. create a named 
structure with name MGexClass). 

Define only one structure/class name in the __DEFINE routine. 

3. Method names should be a verb phrase in camel case. 

For example, here are some method names following these conventions: 
<pre>
getProperty 
setProperty 
add 
findTestNames 
runTest 
reportTestResult 
</pre>

Use the conventions that are used by the IDL library classes. For example, use the GETPROPERTY and 
SETPROPERTY scheme of procedures to handle getting and setting properties of a class. 

4. Begin "protected" methods' names with a underscore. 

For example, 

MGexSomeClass::_helperMethod 

is a helper method called by other methods in MGexSomeClass, but should not be called from outside of 
MGexSomeClass. 

5. Beware of multiple inheritance. 

Use multiple inheritance as a last resort. Prefer delegation for one of the parent classes i.e. make the new class 
contain the secondary parent class as an instance variable. 


---++++  8. Exemple de commentaires proposé par ITT dans examples/template.pro

<pre>
;+
; NAME:
; ROUTINE_NAME
;
; PURPOSE:
; Tell what your routine does here.  I like to start with the words:
; "This function (or procedure) ..."
; Try to use the active, present tense.
;
; CATEGORY:
; Put a category (or categories) here.  For example:
; Widgets.
;
; CALLING SEQUENCE:
; Write the calling sequence here. Include only positional parameters
; (i.e., NO KEYWORDS). For procedures, use the form:
;
; ROUTINE_NAME, Parameter1, Parameter2, Foobar
;
; Note that the routine name is ALL CAPS and arguments have Initial
; Caps.  For functions, use the form:
; 
; Result = FUNCTION_NAME(Parameter1, Parameter2, Foobar)
;
; Always use the "Result = " part to begin. This makes it super-obvious
; to the user that this routine is a function!
;
; INPUTS:
; Parm1:  Describe the positional input parameters here. Note again
;   that positional parameters are shown with Initial Caps.
;
; OPTIONAL INPUTS:
; Parm2:  Describe optional inputs here. If you don't have any, just
;   delete this section.
; 
; KEYWORD PARAMETERS:
; KEY1: Document keyword parameters like this. Note that the keyword
;   is shown in ALL CAPS!
;
; KEY2: Yet another keyword. Try to use the active, present tense
;   when describing your keywords.  For example, if this keyword
;   is just a set or unset flag, say something like:
;   "Set this keyword to use foobar subfloatation. The default
;    is foobar superfloatation."
;
; OUTPUTS:
; Describe any outputs here.  For example, "This function returns the
; foobar superflimpt version of the input array."  This is where you
; should also document the return value for functions.
;
; OPTIONAL OUTPUTS:
; Describe optional outputs here.  If the routine doesn't have any, 
; just delete this section.
;
; COMMON BLOCKS:
; BLOCK1: Describe any common blocks here. If there are no COMMON
;   blocks, just delete this entry.
;
; SIDE EFFECTS:
; Describe "side effects" here.  There aren't any?  Well, just delete
; this entry.
;
; RESTRICTIONS:
; Describe any "restrictions" here.  Delete this section if there are
; no important restrictions.
;
; PROCEDURE:
; You can describe the foobar superfloatation method being used here.
; You might not need this section for your routine.
;
; EXAMPLE:
; Please provide a simple example here. An example from the
; DIALOG_PICKFILE documentation is shown below. Please try to
; include examples that do not rely on variables or data files
; that are not defined in the example code. Your example should
; execute properly if typed in at the IDL command line with no
; other preparation. 
;
;       Create a DIALOG_PICKFILE dialog that lets users select only
;       files with the extension `pro'. Use the `Select File to Read'
;       title and store the name of the selected file in the variable
;       file. Enter:
;
;       file = DIALOG_PICKFILE(/READ, FILTER = '*.pro') 
;
; MODIFICATION HISTORY:
;   Written by: Your name here, Date.
; July, 1994  Any additional mods get described here.  Remember to
;     change the stuff above if you add a new keyword or
;     something!
;-

PRO TEMPLATE

  PRINT, "This is an example header file for documenting IDL routines"

END
</pre>


Le même bloc de commentaires, mais vide :

<pre>
;+
; NAME:
;
;
;
; PURPOSE:
;
;
;
; CATEGORY:
;
;
;
; CALLING SEQUENCE:
;
;
;
; INPUTS:
;
;
;
; OPTIONAL INPUTS:
;
;
;
; KEYWORD PARAMETERS:
;
;
;
; OUTPUTS:
;
;
;
; OPTIONAL OUTPUTS:
;
;
;
; COMMON BLOCKS:
;
;
;
; SIDE EFFECTS:
;
;
;
; RESTRICTIONS:
;
;
;
; PROCEDURE:
;
;
;
; EXAMPLE:
;
;
;
; MODIFICATION HISTORY:
;
;-
</pre>



---+++ OUTILS pour documenter le code

---++++ doc_library

doc_library affiche seulement "tel quel" le bloc de commentaires complet compris entre ";+" et ";-", et affiche le chemin du fichier.

Pour documenter une fonction ou une procédure :

   * Fonction "dist":

<pre>
IDL> doc_library, 'DIST'

----- Documentation for C:\Program Files\ITT\IDL\IDL80\lib\dist.pro

 NAME:
	DIST

 PURPOSE:
	Create a rectangular array in which each element is proportional
	to its frequency.  This array may be used for a variety
	of purposes, including frequency-domain filtering and
	making pretty pictures.

 CATEGORY:
	Signal Processing.

 CALLING SEQUENCE:
	Result = DIST(N [, M])

 INPUTS:
	N = number of columns in result.
	M = number of rows in result.  If omitted, N is used to return
		a square array.

 OUTPUTS:
	Returns an (N,M) floating array in which:

	R(i,j) = SQRT(F(i)^2 + G(j)^2)   where:
		 F(i) = i  IF 0 <= i <= n/2
		      = n-i  IF i > n/2
		 G(i) = i  IF 0 <= i <= m/2
		      = m-i  IF i > m/2

 SIDE EFFECTS:
	None.

 RESTRICTIONS:
	None.

 PROCEDURE:
	Straightforward.  The computation is done a row at a time.

 MODIFICATION HISTORY:
	Very Old.
 	SMR, March 27, 1991 - Added the NOZERO keyword to increase efficiency.
				(Recomended by Wayne Landsman)
	DMS, July, 1992.  - Added M parameter to make non-square arrays.
   CT, RSI, March 2000: Changed i^2 to i^2. to avoid overflow.
</pre>

   * Fonction plot:

<pre>
IDL> doc_library, 'plot'

----- Documentation for C:\Program Files\ITT\IDL\IDL80\lib\graphics\plot.pro

 :Description:
    Create IDL Plot graphic.

 :Params:
    arg1 : optional generic argument
    arg2 : optional generic argument

 :Keywords:
    _REF_EXTRA
</pre>

Dans ce dernier exemple (plot), on se rend compte que depuis idl 8, les nouvelles fonctions/procédures (telles que la fonction plot) ne sont plus commentées
au format "idl" mais "rst", qui semble donc être le nouveau format à utiliser pour commenter du code idl.

---++++ mk_html_help

Cet outil génère une doc html d'un fichier ou même d'un répertoire complet :

ex: documentation du fichier dist.pro:

MK_HTML_HELP, 'C:\Program Files\ITT\IDL\IDL80\lib\dist.pro', 'help_dist.html'   ; La doc générée est help_dist.html

ex: documentation d'une arborescence complète:

MK_HTML_HELP, 'C:\Program Files\ITT\IDL\IDL80\lib', 'help.html'   ; La doc générée est help.html


---++++  !IdlDoc

   * Voir !IDLDoc (tutoriel) : [[%ATTACHURL%/idldoc-tutorial.pdf][idldoc-tutorial.pdf]]

   * Voir !IDLDoc (ref) : [[%ATTACHURL%/idldoc-reference.pdf][idldoc-reference.pdf]]

home: http://idldoc.idldev.com/

download: http://idldoc.idldev.com/wiki/Downloads

tutoriel: http://idldoc.idldev.com/wiki/GettingStarted

idldoc est un outil qui permet de générer une doc à partir du code idl

Il propose 3 formats différents :

   * rst : le format le plus récent, qui tend à devenir le nouveau standard, il apporte beaucoup de possibilités
   * idldoc : le format historique de idldoc, qui ressemble à celui utilisé par des outils plus génériques, tels que !Doxygen
   * idl : le format utilisé par ITT (et proposé dans examples/template.pro)

Ce dernier format ("idl") a juste le "mérite" d'être un standard pour les routines IDL, mais il est peu et mal exploité par IdlDoc qui ne reconnait que très peu de balises de commentaires (seulement 6) parmis celles proposées dans template.pro, et les met mal en valeur dans la doc générée.

Les 6 balises exploitées sont :

; PURPOSE:

; SIDE EFFECTS:

; RESTRICTIONS:

; PROCEDURE:

; EXAMPLE:

; MODIFICATION HISTORY:

Cette dernière balise est affichée en tant que "Author information" dans la doc générée

Quant à la balise suivante...

; CALLING SEQUENCE:

... elle n'est pas reconnue, mais elle semble inutile puisque cette information est automatiquement générée par idldoc.


Voir mes commentaires à l'auteur du logiciel et ses réponses:

http://michaelgalloy.com/2010/10/20/idldoc-3-3-released.html


---+++++ Installation

(NB: sur hyperion, c'est déjà installé sous /usr/local/itt/idldoc/idldoc)

1) Download 

2) Copier et dézipper dans un dossier de mon choix (ex : D:/idldoc/idldoc-3.3)

3) Ajouter le chemin vers idldoc dans le IDL_PATH (Fenêtre/Preferences/IDL/Chemins/Insérer (puis Appliquer)


---+++++ Utilisation

Pour générer la doc avec idldoc :

IDL> idldoc, root='path_vers_mon_repertoire_source', output='path_vers_mon_repertoire_doc'

Puis, 2clic sur index.html

Exemple plus complet:

IDL> idldoc, root='path_vers_mon_repertoire_source', output='path_vers_mon_repertoire_doc', title='DOC pour mon projet', subtitle='generated with idldoc 3.3', format_style='rst', overview='path_vers_mon_fichier_overview'

Remarque: format_style peut prendre les 3 valeurs "rst", "idl" ou "idldoc"



---+++ Enregistrer une image dans un fichier

<pre>
; envoi vers fichier postscript
set_plot, 'ps'

; éventuellement donner un nom
device, filename='toto.ps'

plot, findgen(2)

; retour à l'affichage sur écran
device, /close
set_plot, 'x'
</pre>


---++ PHP


---+++ Fonctions anonymes (lambda) et closures (php 5.3)

---++++ Fonctions anonymes (lambda)

http://blog.pascal-martin.fr/post/php-5.3-1-closures-et-lambdas

<verbatim>
$f1= function () {
    echo "<p>Hello, World!</p>";
};
 
$f2= function ($param) {
    echo "<p>Hello, $param!</p>";
};
</verbatim>

call :

$f1();

$f2('there');

call_user_func($f1);
 
call_user_func($f2, 'You');

call_user_func_array($f1, array());
 
call_user_func_array($f2, array('You'));

Exemple d'utilisation avec array_map :

<verbatim>
$data = array('iron maiden', 'judas priest', 'rammstein');
$output = array_map(function ($item) {
        return ucwords($item);
    },
    $data);
var_dump($output);
</verbatim>

Résultat :

<verbatim>
array
  0 => string 'Iron Maiden' (length=11)
  1 => string 'Judas Priest' (length=12)
  2 => string 'Rammstein' (length=9)
</verbatim>

Un autre exemple, en utilisant cette fois-ci array_walk, qui attend une fonction de callback travaillant avec un paramètre passé par référence :

<verbatim>
$data = array('iron maiden', 'judas priest', 'rammstein');
array_walk($data, function (& $item) {
        $item = ucwords($item);
    });
var_dump($data);
</verbatim>

Le résultat obtenu sera exactement le même que juste au-dessus, à savoir :

<verbatim>
array
  0 => string 'Iron Maiden' (length=11)
  1 => string 'Judas Priest' (length=12)
  2 => string 'Rammstein' (length=9)
</verbatim>

Utilisé pour les fonctions anonymes, le mot-clef "use" permet d&#8217;importer (en lecture seule) des variables externes, issues de l&#8217;espace de noms « global », au sein de la fonction lambda.

<verbatim>
$var = 'World';
$f2 = function () use ($var) {
    echo "<p>Hello, $var!</p>";
};

$f2();   // Hello, World!
</verbatim>


En quelque sorte, "use" fait penser à l&#8217;instruction "global", que nous rencontrions parfois auparavant&#8230; Mais global ne répond pas aux besoins des closures

Import de variable par référence :

<verbatim>

$var = 0;

$func2 = function () use (& $var) {
    echo "<p>Début 2 : $var</p>";
    $var = 2;
    echo "<p>Fin 2 : $var</p>";
};

et le résultat :

echo "<p>Avant 2 : $var</p>";   // Avant 2 : 0
$func2();                       // Début 2 : 0
                                // Fin 2 : 2
echo "<p>Après 2 : $var</p>";   // Après 2 : 2

</verbatim>

Mais, qu'est-ce qu'une fonction anonyme pour php ?

<verbatim>
$func = function ($param) {
    echo "<p>Hello, $param!</p>";
};
 
var_dump($func);

Le résultat obtenu est le suivant :

object(Closure)[1]
</verbatim>

Pour PHP, une fonction anonyme &#8212; une lambda &#8212; est un objet : une instance de classe Closure&#8230;


---++++ Closures

http://blog.pascal-martin.fr/post/php-5.3-2-closures-et-lambdas

    Une closure est une fonction qui est évaluée dans un environnement contenant une ou plusieurs variables liées, auxquelles elle peut accéder au moment de son exécution.

    Dans certains langages &#8212; dont Javascript, et PHP >= 5.3 &#8212; une closure peut exister lorsqu&#8217;une fonction est définie au sein d&#8217;une autre, et que la fonction interne fait référence à des variables de la fonction externe.
    A l&#8217;exécution, une closure est formée : elle est constituée du code de la fonction interne et des références aux variables externes utilisées par celle-ci.

En PHP, une closure se construit de la manière suivante :

   * Une variable locale est créée dans une première fonction "externe",
   * Une seconde fonction "interne" est définie à l&#8217;intérieur de la première fonction, sous forme d&#8217;une fonction anonyme,
   * Et cette fonction "interne" importe la variable locale de la fonction "externe", à l&#8217;aide du mot-clef use.

   * Closure en lecture-seule :

Ex :

<verbatim>
$func = function ($arg) {
    $compteur = $arg;  // Copie privée, en lecture seule
    return function () use ($compteur) {
        return ++$compteur;
    };
};

$a1 = $func(10);
$a2 = $func(50);


Nous venons ici de créer deux fonctions anonymes

echo 'a1 : ' . $a1() . "\n";   // 11
echo 'a2 : ' . $a2() . "\n";   // 51
echo 'a1 : ' . $a1() . "\n";   // 11
echo 'a2 : ' . $a2() . "\n";   // 51
echo 'a1 : ' . $a1() . "\n";   // 11
echo 'a2 : ' . $a2() . "\n";   // 51

</verbatim>


   * Closure en lecture-écriture 

<verbatim>
$func = function ($arg) {
    $compteur = $arg;  // Copie privée, en lecture / écriture
    return function () use (& $compteur) {
        return ++$compteur;
    };
};

echo 'a1 : ' . $a1() . "\n";   // 11
echo 'a2 : ' . $a2() . "\n";   // 51
echo 'a1 : ' . $a1() . "\n";   // 12
echo 'a2 : ' . $a2() . "\n";   // 52
echo 'a1 : ' . $a1() . "\n";   // 13
echo 'a2 : ' . $a2() . "\n";   // 53

</verbatim>

Le mécanisme de closure permet donc de créer des variables au sein de la fonction "externe", qui conserveront leur valeur aussi longtemps que l&#8217;on aura conservé un pointeur sur la fonction "interne".
Ces variables seront accessibles par la fonction interne, éventuellement en écriture si nous avons utilisé & lors de leur import, tout en n&#8217;étant pas visibles du reste de notre script.


   * Appel de fonction sur un objet

PHP 5.3 ajoute la possibilité d&#8217;utiliser la syntaxe d&#8217;un appel de fonction sur un objet, en lui appliquant l&#8217;opérateur ().

Pour cela, une nouvelle méthode magique a été ajoutée : __invoke : 

lors d&#8217;un appel de fonction sur une instance de classe comportant une méthode __invoke, c&#8217;est cette méthode qui sera appelée.

Voici une classe d&#8217;exemple :

<verbatim>
class MyString {
    public $str;
    public function __construct($a) {
        $this->str = $a;
    }
 
    // Appelée quand on appelle dynamiquement un 
    // objet instance de cette classe
    public function __invoke($a) {
        var_dump(__METHOD__);
        $this->str = $a;
    }
}
</verbatim>


---+++ Session

Endroit où sont stockés les fichiers (temporaires) de session : session.save_path (php.ini)

Dans xampp : session.save_path = "D:\xampp\tmp"

Sur linux : session.save_path = "/var/lib/php/session" (/etc/php.ini)

La façon la plus sécurisée est d'utiliser les cookies

1) Le client (navigateur) demande un identifiant de session (jeton)

2) Le serveur crée l'identifiant et le retourne au client

3) Le client stocke sur son disque dur cet identifiant sous la forme d'un cookie qu'il enverra désormais à chaque requête

Nom du jeton par défaut  = PHPSESSID (cf php.ini session.name et fonction session_name())

Sur le serveur, ce jeton aura le nom "sess_" suivi de sa valeur

Valeur du jeton = string générée aléatoirement par php (fonction session_id() retourne cette valeur et permet éventuellement de la fixer, mais déconseilllé)

Paramètres php.ini à positionner (on peut utiliser session_set_cookie_params() pour cela, il y a aussi ini_get() et ini_set()) :

<pre>
session.use_cookies = 1
session.use_only_cookies = 1
session.use_trans_sid = 0 (si cookies pas acceptés, ne pas pour autant transmettre l'id de session dans l'url)
session.cookie_lifetime = 0 (jusqu'au moment de quitter le navigateur)
session.auto_start = 0
session.save_handler = files
session.save_path = ...
</pre>

La fonction session_start() crée ou restaure une session (à mettre en première ligne du bootstrap)

session_regenerate_id() regénère l'id de session afin d'éviter une fixation de la session

appeler session_destroy() à la déconnexion du user








---+++ Gestion de l'authentification avec Zend_Auth

http://r-benyacoub.developpez.com/tutoriels/php/zend-framework/zend-auth/

http://framework.zend.com/manual/1.11/en/zend.auth.adapter.dbtable.html

best : 
   * Zend_Db : http://blog.aurevec.be/?p=93
   * Zend_Auth : http://blog.aurevec.be/?p=140
   * ALL : http://blog.aurevec.be/?author=1



---+++ Créer un projet Zend

http://framework.zend.com/manual/en/learning.quickstart.create-project.html

Le contrôleur de Zend Framework réserve une action "index" comme action par défaut. C'est-à-dire que pour l'URI "http://localhost/tutoriel-zf/actualités/", l'action "index" est exécutée. Le framework réserve également un nom de contrôleur si aucun n'est fourni dans l'URI : aucune surprise qu'il soit également appelé "index". Ainsi, l'URI "http://localhost/tutoriel-zf/" appelle le contrôleur "index" avec l'action "index". 

1) install

Download zf

Copier dans D:\ProgFilesNoInstall\zf

Ajouter D:\ProgFilesNoInstall\zf\bin dans PATH windows

2) Créer un projet

http://blog.aurevec.be/?p=71

Dans Eclipse, créer un projet PHP nommé "zfquickstart"

Ouvrir une console DOS

Aller dans xampp/htdocs

zf create project zfquickstart

crée 3 dossiers :

- application/ qui contient Bootstrap.php et configs/application.ini

- public/

- library/

public/ contient 2 fichiers importants :

.htaccess :

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} -s [OR]
RewriteCond %{REQUEST_FILENAME} -l [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^.*$ - [NC,L]
RewriteRule ^.*$ index.php [NC,L]

index.php : qui lance $application->bootstrap() et ->run()





3) The Bootstrap

Your Bootstrap class defines what resources and components to initialize. By default, Zend Framework's Front Controller is initialized, and it uses the application/controllers/ as the default directory in which to look for action controllers

<verbatim>

    // application/Bootstrap.php
     
    class Bootstrap extends Zend_Application_Bootstrap_Bootstrap
    {
    }
</verbatim>

4) Configuration

While Zend Framework is itself configurationless, you often need to configure your application. The default configuration is placed in application/configs/application.ini, and contains some basic directives for setting your PHP environment (for instance, turning error reporting on and off), indicating the path to your bootstrap class (as well as its class name), and the path to your action controllers. 

<verbatim>
    ; application/configs/application.ini
     
    [production]
    phpSettings.display_startup_errors = 0
    phpSettings.display_errors = 0
    includePaths.library = APPLICATION_PATH "/../library"
    bootstrap.path = APPLICATION_PATH "/Bootstrap.php"
    bootstrap.class = "Bootstrap"
    appnamespace = "Application"
    resources.frontController.controllerDirectory = APPLICATION_PATH "/controllers"
    resources.frontController.params.displayExceptions = 0
     
    [staging : production]
     
    [testing : production]
    phpSettings.display_startup_errors = 1
    phpSettings.display_errors = 1
     
    [development : production]
    phpSettings.display_startup_errors = 1
    phpSettings.display_errors = 1
</verbatim>

First, when using INI-style configuration, you can reference constants directly and expand them; APPLICATION_PATH is actually a constant. 

Additionally note that there are several sections defined: production, staging, testing, and development. The latter three inherit settings from the "production" environment. This is a useful way to organize configuration to ensure that appropriate settings are available in each stage of application development. 

5) Action Controllers

Your application's action controllers contain your application workflow, and do the work of mapping your requests to the appropriate models and views.

An action controller should have one or more methods ending in "Action"; these methods may then be requested via the web. By default, Zend Framework URLs follow the schema /controller/action, where "controller" maps to the action controller name (minus the "Controller" suffix) and "action" maps to an action method (minus the "Action" suffix).

Typically, you always need an IndexController, which is a fallback controller and which also serves the home page of the site, and an ErrorController, which is used to indicate things such as HTTP 404 errors (controller or action not found) and HTTP 500 errors (application errors).

<verbatim>
    // application/controllers/IndexController.php
     
    class IndexController extends Zend_Controller_Action
    {
     
        public function init()
        {
            /* Initialize action controller here */
        }
     
        public function indexAction()
        {
            // action body
        }
    }

And the default ErrorController is as follows:

    // application/controllers/ErrorController.php
     
    class ErrorController extends Zend_Controller_Action
    {
     
        public function errorAction()
        {
            $errors = $this->_getParam('error_handler');
     
            switch ($errors->type) {
                case Zend_Controller_Plugin_ErrorHandler::EXCEPTION_NO_ROUTE:
                case Zend_Controller_Plugin_ErrorHandler::EXCEPTION_NO_CONTROLLER:
                case Zend_Controller_Plugin_ErrorHandler::EXCEPTION_NO_ACTION:
     
                    // 404 error -- controller or action not found
                    $this->getResponse()->setHttpResponseCode(404);
                    $this->view->message = 'Page not found';
                    break;
                default:
                    // application error
                    $this->getResponse()->setHttpResponseCode(500);
                    $this->view->message = 'Application error';
                    break;
            }
     
            $this->view->exception = $errors->exception;
            $this->view->request   = $errors->request;
        }
    }
</verbatim>

You'll note that the IndexController contains no real code, and the ErrorController makes reference to a "view" property. That leads nicely into our next subject.


6) Views

Views in Zend Framework are written in plain old PHP. View scripts are placed in application/views/scripts/, where they are further categorized using the controller names. In our case, we have an IndexController and an ErrorController, and thus we have corresponding index/ and error/ subdirectories within our view scripts directory. Within these subdirectories, you will then find and create view scripts that correspond to each controller action exposed; in the default case, we thus have the view scripts index/index.phtml and error/error.phtml.

View scripts may contain any markup you want, and use the <?php opening tag and ?> closing tag to insert PHP directives.

<verbatim>
    <!-- application/views/scripts/index/index.phtml -->
    <style>
     
        a:link,
        a:visited
        {
            color: #0398CA;
        }
     
        span#zf-name
        {
            color: #91BE3F;
        }
     
        div#welcome
        {
            color: #FFFFFF;
            background-image: url(http://framework.zend.com/images/bkg_header.jpg);
            width:  600px;
            height: 400px;
            border: 2px solid #444444;
            overflow: hidden;
            text-align: center;
        }
     
        div#more-information
        {
            background-image: url(http://framework.zend.com/images/bkg_body-bottom.gif);
            height: 100%;
        }
     
    </style>
    <div id="welcome">
        <h1>Welcome to the <span id="zf-name">Zend Framework!</span><h1 />
        <h3>This is your project's main page<h3 />
        <div id="more-information">
            <p>
                <img src="http://framework.zend.com/images/PoweredBy_ZF_4LightBG.png" />
            </p>
     
            <p>
                Helpful Links: <br />
                <a href="http://framework.zend.com/">Zend Framework Website</a> |
                <a href="http://framework.zend.com/manual/en/">Zend Framework
                    Manual</a>
            </p>
        </div>
    </div>
    <="" span="">

The error/error.phtml view script is slightly more interesting as it uses some PHP conditionals:

    <!-- application/views/scripts/error/error.phtml -->
    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN";
        "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd>
    <html xmlns="http://www.w3.org/1999/xhtml">
    <head>
      <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
      <title>Zend Framework Default Application</title>
    </head>
    <body>
      <h1>An error occurred</h1>
      <h2><?php echo $this->message ?></h2>
     
      <?php if ('development' == $this->env): ?>
     
      <h3>Exception information:</h3>
      <p>
          <b>Message:</b> <?php echo $this->exception->getMessage() ?>
      </p>
     
      <h3>Stack trace:</h3>
      <pre><?php echo $this->exception->getTraceAsString() ?>
      </pre>
     
      <h3>Request Parameters:</h3>
      <pre><?php echo var_export($this->request->getParams(), 1) ?>
      </pre>
      <?php endif ?>
     
    </body>
    </html>
</verbatim>


7) Create a virtual host

Dans "D:\xampp\apache\conf\extra\myvhosts", créer un fichier "zfquickstart.conf"

<verbatim>
Listen 8087
<VirtualHost *:8087>

   ServerName zfquickstart.local
   ServerAlias zfquickstart.local zfquickstart
   #ServerName .local
   DocumentRoot "D:/xampp/htdocs/zfquickstart/public"

   # This should be omitted in the production environment
   SetEnv APPLICATION_ENV "development"
    
   <Directory "D:/xampp/htdocs/zfquickstart/public">
	 DirectoryIndex index.php
       #Options Indexes MultiViews FollowSymLinks
       AllowOverride All
       Order allow,deny
       Allow from all
   </Directory>
    
</VirtualHost>
</verbatim>

There are several things to note. First, note that the DocumentRoot setting specifies the public subdirectory of our project; this means that only files under that directory can ever be served directly by the server. Second, note the AllowOverride, Order, and Allow directives; these are to allow us to use htacess files within our project. During development, this is a good practice, as it prevents the need to constantly restart the web server as you make changes to your site directives; however, in production, you should likely push the content of your htaccess file into your server configuration and disable this. Third, note the SetEnv directive. What we are doing here is setting an environment variable for your virtual host; this variable will be picked up in the index.php and used to set the APPLICATION_ENV constant for our Zend Framework application. In production, you can omit this directive (in which case it will default to the value "production") or set it explicitly to "production". 

Avec un <VirtualHost *:80>, il faudrait aussi faire ceci :

Finally, you will need to add an entry in your hosts file corresponding to the value you place in your ServerName directive. On *nix-like systems, this is usually /etc/hosts; on Windows, you'll typically find it in C:\WINDOWS\system32\drivers\etc. Regardless of the system, the entry will look like the following:

    127.0.0.1 zfquickstart.local

Start your webserver (or restart it), and you should be ready to go. 

http://localhost:8087

NB: il faut ajouter le chemin vers ZF ("D:\ProgFilesNoInstall\zf\library") :

   * soit dans php.ini, 
   * soit, mieux, dans le fichier index.php du dossier "public/" du projet : chercher la ligne "set_include_path" et insérer en tête de liste, ce qui donne :

<verbatim>
// Ensure library/ is on include_path
set_include_path(implode(PATH_SEPARATOR, array(

	//EP added :
	"D:\ProgFilesNoInstall\zf\library",

    realpath(APPLICATION_PATH . '/../library'),
    get_include_path(),
)));
</verbatim>


8) Create A Layout

http://framework.zend.com/manual/en/learning.quickstart.create-layout.html

To get started using Zend_Layout, first we need to inform our bootstrap to use the Layout resource. This can be done using the zf enable layout command:

<verbatim>
    % zf enable layout
    Layouts have been enabled, and a default layout created at
    application/layouts/scripts/layout.phtml
    A layout entry has been added to the application config file.
</verbatim>

As noted by the command, application/configs/application.ini is updated, and now contains the following within the production section:

<verbatim>
    ; application/configs/application.ini
     
    ; Add to [production] section:
    resources.layout.layoutPath = APPLICATION_PATH "/layouts/scripts"
</verbatim>

We also want to ensure we have an XHTML DocType declaration for our application. To enable this, we need to add a resource to our bootstrap.

The simplest way to add a bootstrap resource is to simply create a protected method beginning with the phrase _init. In this case, we want to initialize the doctype, so we'll create an _initDoctype() method within our bootstrap class.

Within that method, we need to hint to the view to use the appropriate doctype. But where will the view object come from? The easy solution is to initialize the View resource; once we have, we can pull the view object from the bootstrap and use it.

To initialize the view resource, add the following line to your application/configs/application.ini file, in the section marked production:

    resources.view[] =

This tells us to initialize the view with no options (the '[]' indicates that the "view" key is an array, and we pass nothing to it).

Now that we have a view, let's flesh out our _initDoctype() method. In it, we will first ensure the View resource has run, fetch the view object, and then configure it:

<verbatim>
    // application/Bootstrap.php
     
    class Bootstrap extends Zend_Application_Bootstrap_Bootstrap
    {
        protected function _initDoctype()
        {
            $this->bootstrap('view');
            $view = $this->getResource('view');
            $view->doctype('XHTML1_STRICT');
        }
    }
</verbatim>

Now that we've initialized Zend_Layout and set the Doctype, let's create our site-wide layout: 

<verbatim>
    <!-- application/layouts/scripts/layout.phtml -->
    <?php echo $this->doctype() ?>
    <html xmlns="http://www.w3.org/1999/xhtml">
    <head>
      <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
      <title>Zend Framework Quickstart Application</title>
      <?php echo $this->headLink()->appendStylesheet('/css/global.css') ?>
    </head>
    <body>
    <div id="header" style="background-color: #EEEEEE; height: 30px;">
        <div id="header-logo" style="float: left">
            <b>ZF Quickstart Application</b>
        </div>
        <div id="header-navigation" style="float: right">
            <a href="<?php echo $this->url(
                array('controller'=>'guestbook'),
                'default',
                true) ?>">Guestbook</a>
        </div>
    </div>
     
    <?php echo $this->layout()->content ?>
     
    </body>
    </html>
</verbatim>

We grab our application content using the layout() view helper, and accessing the "content" key. You may render to other response segments if you wish to, but in most cases, this is all that's necessary.

Note also the use of the headLink() placeholder. This is an easy way to generate the HTML for <link> elements, as well as to keep track of them throughout your application. If you need to add additional CSS sheets to support a single action, you can do so, and be assured it will be present in the final rendered page. 


9) Create a Model and Database Table

http://framework.zend.com/manual/en/learning.quickstart.create-model.html

Your application bootstrap will by default use the module prefix "Application". As such, our models, forms, and table classes will all begin with the class prefix "Application_". 

zf configure db-adapter 'adapter=PDO_SQLITE&dbname=APPLICATION_PATH "/../data/db/guestbook.db"' production

php scripts/load.sqlite.php --withdata

zf create db-table Guestbook guestbook

zf create model GuestbookMapper

zf create model Guestbook

zf create controller Guestbook

This will create a new controller, GuestbookController, in application/controllers/GuestbookController.php, with a single action method, indexAction(). It will also create a view script directory for the controller, application/views/scripts/guestbook/, with a view script for the index action.

We'll use the "index" action as a landing page to view all guestbook entries. 

Now, let's flesh out the basic application logic. On a hit to indexAction(), we'll display all guestbook entries. This would look like the following:

<verbatim>
    // application/controllers/GuestbookController.php
     
    class GuestbookController extends Zend_Controller_Action
    {
        public function indexAction()
        {
            $guestbook = new Application_Model_GuestbookMapper();
            $this->view->entries = $guestbook->fetchAll();
        }
    }


And, of course, we need a view script to go along with that. Edit application/views/scripts/guestbook/index.phtml to read as follows:

    <!-- application/views/scripts/guestbook/index.phtml -->
     
    <p><a href="<?php echo $this->url(
        array(
            'controller' => 'guestbook',
            'action'     => 'sign'
        ),
        'default',
        true) ?>">Sign Our Guestbook</a></p>
     
    Guestbook Entries: <br />
    <dl>
        <?php foreach ($this->entries as $entry): ?>
        <dt><?php echo $this->escape($entry->email) ?></dt>
        <dd><?php echo $this->escape($entry->comment) ?></dd>
        <?php endforeach ?>
    </dl>

</verbatim>

Now browse to "http://localhost/guestbook"


10) Create A Form

http://framework.zend.com/manual/en/learning.quickstart.create-form.html

% zf create form Guestbook

Next, we will add a signAction() to our GuestbookController which will process the form upon submission. To create the action and related view script, execute the following:

% zf create action sign Guestbook

Now browse to "http://localhost/guestbook/sign".


---+++ php.ini

Depuis v5.3 : http://fr.php.net/manual/fr/migration53.ini.php

Le fichier standard php.ini a été réorganisé, et renommé : 

   * php.ini-development contient les options qui sont recommandées pour un environnement de développement. 
   * php.ini-production contient les configurations recommandées pour la production.

On les trouve dans /usr/share/doc/php-common-5.3.3

Voici la différence entre les 2 :

<pre>
[root@planetoweb etc]# diff /usr/share/doc/php-common-5.3.3/php.ini-development /usr/share/doc/php-common-5.3.3/php.ini-production
514c514
< error_reporting = E_ALL | E_STRICT
---
> error_reporting = E_ALL & ~E_DEPRECATED
531c531
< display_errors = On
---
> display_errors = Off
542c542
< display_startup_errors = On
---
> display_startup_errors = Off
586c586
< track_errors = On
---
> track_errors = Off
604c604
< html_errors = On
---
> html_errors = Off
1248a1249,1256
> ; Allow accessing, from PHP's perspective, local files with LOAD DATA statements
> ; http://php.net/mysqli.allow_local_infile
> ;mysqli.allow_local_infile = On
>
> ; Allow or prevent persistent links.
> ; http://php.net/mysqli.allow-persistent
> mysqli.allow_persistent = On
>
1297c1305
< mysqlnd.collect_memory_statistics = On
---
> mysqlnd.collect_memory_statistics = Off
1566c1574
< session.bug_compat_42 = On
---
> session.bug_compat_42 = Off
1575c1583
< session.bug_compat_warn = On
---
> session.bug_compat_warn = Off
1593d1600
< session.entropy_file =

</pre>

---+++ !HereDoc


La syntaxe Heredoc se comporte exactement comme une chaîne à guillemets doubles, sans les guillemets doubles. Cela signifie que vous n'avez pas à échapper les guillemets (simples ou doubles) dans cette syntaxe. Les variables sont remplacées par leur valeur et le même soin doit leur être apporté que dans les chaînes à guillemets doubles.
Exemple de chaîne HereDoc

<verbatim>

<?php
$str = <<<EOD
  Exemple de chaîne
  s'étalant sur
  plusieurs lignes
  avec la syntaxe heredoc
EOD;

/* Exemple plus complexe, avec des variables. */
class foo {
    var $foo;
    var $bar;
    function foo() {
        $this->foo = 'Foo';
        $this->bar = array('Bar1', 'Bar2', 'Bar3');
    }
}

$foo = new foo();
$name = 'MonNom';

echo <<<EOT
  Mon nom est "$name". J'affiche des $foo->foo.
  Maintenant, j'affiche un {$foo->bar[1]}.
  Ceci se traduit par un 'A' majuscule : \x41
EOT;
?>


<?php
class foo {
  public $bar = <<<EOT
bar
EOT;
}
?>

</verbatim>

---+++ Fonctions anonymes (exemples d'algo de tri et de somme)

<verbatim>
<?php

    $t = array (2,3,6,7,9,2,43,5,2,54,65,34,23,54,23,654,43);

    print_r ($t);

    uasort ($t, function ($x,$y) { return $x > $y;});

    print_r ($t);

    printf ("somme = %d\n", array_reduce ($t, function ($x,$y) { return $x+$y;}));
?> 
</verbatim>


---+++ Travail sur les chaînes

- Supprimer une partie de la chaîne : str_replace()

- sous-chaîne : substr()

- tester la présence d'une sous-chaine dans la chaine (et récupérer sa position) : strpos()

- parser une chaine de paramètres html, et les placer dans un tableau : parse_str($chaine, $args)

- remplacer une partie de la chaine : $bodytag = str_replace("%body%", "black", "<body text='%body%'>");


---+++ Travail sur les arrays

- merge : $GET = array_merge($GET,$args)

- dispatcher contenu array dans n strings (explode) : 
$data = "foo:*:1023:1000::/home/foo:/bin/sh";
list($user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":", $data);

- regrouper contenu array dans 1 string (implode) :
$array = array('lastname', 'email', 'phone');
$comma_separated = implode(",", $array);
echo $comma_separated; // lastname,email,phone



---+++ Reflection

print __FUNCTION__." in ".__FILE__." at ".__LINE__."\n";

Ou bien (php5) :
		
$modelReflector = new ReflectionClass(__CLASS__);

$method = $modelReflector->getMethod(__METHOD__);


---+++ ATTENTION !!!

- echo "cette variable n'existe pas mais ca ne génère aucune erreur !!!!!!!" . $nimportekoi;

- echo "cette propriété (attribut, variable) n'existe pas mais ca ne génère aucune erreur !!!!!!!" . $this->nimportekoi;


---+++Afficher un bloc de code html dans php (ou tout autre texte long) :

http://forum.webrankinfo.com/petite-astuce-pour-afficher-simplement-code-html-t32812.html

La commande top classe tous les processus par leur consommation de la CPU et de la mémoire

Elle affiche le "top 20" sous forme d'une table

top -n 1 -b > top.txt affiche tous les processus 

top -n 1 -b -p <PID> affiche de l'information à propos d'un processus en désignant ce dernier par son PID. 


---++ LINUX


---+++ Utilisation




---++++ netstat

http://www.simplehelp.net/2009/01/19/monitor-your-linux-machine-with-netstat/

Voir les connexions au port 8080 sur mon pc :

<pre>
$> netstat -ant|grep 8080

tcp4       0      0  195.83.102.52.54533    195.83.102.176.8080    ESTABLISHED
tcp6       0      0  ::1.8080               ::1.53481              ESTABLISHED
tcp6       0      0  ::1.53481              ::1.8080               ESTABLISHED
tcp6       0      0  ::1.8080               ::1.50287              ESTABLISHED
tcp6       0      0  ::1.50287              ::1.8080               ESTABLISHED
tcp46      0      0  *.8080                 *.*                    LISTEN   
</pre>

Je vois ainsi que ma machine est connectée à 195.83.102.176 via le port 8080 en TCP

Pour savoir qui c'est, j'utilise la commande "host" ou "nslookup" :

$> host 195.83.102.176

Idem pour mysql :

<pre>
$> netstat -ant | grep 3306
</pre>

This tells me how many connections of different types of state I have on my machine. 
I can run a similar command to see a complete picture of the state of all the connections made to my web server:

<pre>
$> netstat -ant | grep 80 | awk &#8216;{print $6}&#8217; | sort | uniq -c | sort -n

1 FIN_WAIT1
4 LISTEN
6 FIN_WAIT2
17 CLOSE_WAIT
94 ESTABLISHED
534 TIME_WAIT
</pre>

---++++ Informations sur le hardware

   * RAM

cat /proc/meminfo

   * CPU(s)

http://www.cyberciti.biz/faq/linux-display-cpu-information-number-of-cpus-and-their-speed/

cat /proc/cpuinfo

Plus précisément :

Exact number of available cores, virtual or not (8 pour hyperion, soit 2 proc x 4 cores) : grep -c processor /proc/cpuinfo 

Nb de processeurs "physiques" (2 pour hyperion) : grep core\ id /proc/cpuinfo | grep -c \ 0$

The following (clumsy) group of commands will return the number of physical CPUs regardless of if there is only a single core per CPU (2 pour planetoweb et surfasafe) :

grep core\ id /proc/cpuinfo | grep -c \ 0$ | grep ^0$ >> /dev/null && grep -c processor /proc/cpuinfo || grep core\ id /proc/cpuinfo | grep -c \ 0$

Processeur(s) virtualisable(s) ? (cpuinfo doit contenir le flag vmx pour un processeur intel, et svm pour AMD) : egrep '(vmx|svm)' /proc/cpuinfo 

Information détaillée : dmidecode

dmidecode --type 4 | grep -c Socket


*CPU utilization*

TOP : Informations sur la charge CPU et la consommation mémoire provoquée par les processus

http://www.loligrub.be/contrib/tlepoint/BASE/node104.html

http://www.cyberciti.biz/tips/how-do-i-find-out-linux-cpu-utilization.html

La commande top classe tous les processus par leur consommation de la CPU et de la mémoire. 

Elle affiche le "top 20" sous forme d'une table

top -n 1 -b > top.txt affiche tous les processus

top -n 1 -b -p <PID> affiche de l'information à propos d'un processus en désignant ce dernier par son PID. 

O N pour trier par occupation mémoire

O K pour trier par charge CPU (par défaut)

1 pour montrer/cacher chaque processeur séparément

mpstat (fait partie du package sysstat)

mpstat -P ALL

You can display today&#8217;s CPU activity, with sar 

sar

For example display comparison of CPU utilization; 2 seconds apart; 5 times, use:

# sar -u 2 5

(for each 2 seconds. 5 lines are displayed)

To get multiple samples and multiple reports, set an output file for the sar command. Run the sar command as a background process using.

# sar -o output.file 12 8 >/dev/null 2>&1 &

Better use nohup command so that you can logout and check back report later on:

# nohup sar -o output.file 12 8 >/dev/null 2>&1 &

puis pour lire : sar -f output.file

%user = % temps cpu utilisé par les applications

%system = % temps cpu utilisé par le kernel

%iowait = % temps cpu utilisé à attendre une requête I/O


displays the top 10 CPU users :

ps -eo pcpu,pid,user,args | sort -k 1 -r | head -10

ps command displays every process (-e) with a user-defined format (-o pcpu). First field is pcpu (cpu utilization). It is sorted in reverse order to display top 10 CPU eating process.

iostat :

It can be use to find out your system's average CPU utilization since the last reboot.

$ iostat

This gives you three outputs every 5 seconds (as previous command gives information since the last reboot):

$ iostat -xtc 5 3

gnome-system-monitor : allows you to view and control the processes

Voir aussi http://www.cyberciti.biz/tips/top-linux-monitoring-tools.html


---++++ SSH

---+++++ Exécuter une commande sur un serveur distant

   * De manière générale:

# ssh user@server bash -c "ls -l"

Mode raccourci:

# ssh user@server "ls -l"

   * depuis planetoweb:

# ssh surfasafe "ls -l"

# ssh root@surfasafe "ls -l"

# ssh root@surfasafe bash -c "ls -l"

   * Non autorisé vers sauvcesr2:

# ssh pallier@sauvcesr2 bash -c "ls -l"

This account is restricted by rssh.

Allowed commands: scp sftp rsync

If you believe this is in error, please contact your system administrator.


---+++++ Simplifier une connexion ssh avec rebond

Par exemple, depuis chez moi, je veux me connecter à hyperion

Il me faut donc passer par GATEWAY (la passerelle du labo)

*1) le plus simple, méthode manuelle (depuis mon pc)*

ssh GATEWAY (entrer le mot de passe utilisé pour le mail)

puis

ssh hyperion.cesr.fr (entrer votre mot de passe hyperion)

(NB : "ssh -X GATEWAY", puis "ssh -X hyperion" si on veut l'affichage graphique)

Il faut taper 2 fois "exit" pour revenir à mon pc.


*2) Pour accélérer la connexion : ETAPE 1, générer des clés ssh*

DEPUIS MON PC, je génère une paire de clés privée et publique :

ssh-keygen -t dsa

Puis, je distribue ensuite la clé publique à la fois sur GATEWAY ET sur hyperion :

ssh-copy-id -i /home/USERNAME/.ssh/id_dsa.pub GATEWAY

ssh-copy-id -i /home/USERNAME/.ssh/id_dsa.pub hyperion.cesr.fr

Tester maintenant à nouveau la double connexion (GATEWAY, puis hyperion) :

ssh GATEWAY (sans mot de passe)

puis

ssh hyperion.cesr.fr (avec mot de passe)

Malheureusement, il faut encore entrer un mot de passe pour se connecter à hyperion, bouh...

(je tape 2 fois "exit" pour revenir à mon pc)


*3) Pour accélérer la connexion : ETAPE 2, automatiser le "rebond" par GATEWAY*

On va maintenant rendre transparent le passage via GATEWAY. Il suffit pour cela de créer un fichier de config :

DEPUIS MON PC, j'édite le fichier /home/USERNAME/.ssh/config, et j'y mets le contenu suivant :

<verbatim>
Host hyp hyperion hyperion.cesr.fr
        Hostname hyperion.cesr.fr
        ProxyCommand ssh GATEWAY nc %h %p 2> /dev/null
</verbatim>

(Pour plus de détails : http://franek.chicour.net/post/2009/10/16/SSH-%3A-simplifier-les-connexions-avec-rebond)

VOILA C FINI, OUF !

Désormais, depuis votre pc, il suffit de faire un bête ssh :

ssh hyp (avec l'option -X pour l'affichage graphique)

(ou "ssh hyperion" ou "ssh hyperion.cesr.fr")

On n'a plus besoin de rentrer aucun mot de passe (ni de GATEWAY, ni de hyperion), c'est direct !

(il suffit de taper une seule fois "exit" pour revenir à mon pc)


---++++ SED (substitution de texte)

Pleins d'exemples ici : http://sed.sourceforge.net/sed1line_fr.html

   * remplacer tutu par toto, mais seulement des lignes 3 à 6 :

cat monfichier.txt | sed -e 3,6"s/tutu/toto/" >| monfichiertemp.txt

   * remplacer tutu par toto, mais seulement entre les lignes "titi" et "toto" :

/titi/,/toto/s/tutu/toto/

ou encore :

sed -e "/$debut/,/$fin/"'s#HostId="t3://.*\n#HostId="t3://'"$WLS_ADM_HOST:$PORT\"/" < "$file1" > "$file2"


---++++ GREP (recherche textuelle)

Afficher uniquement les lignes de commentaire:

egrep '^#' fichier

Ne pas afficher les lignes de commentaire:

egrep -v '^#' fichier

N'afficher que les lignes utiles (tout sauf commentaires et lignes vides) :

egrep -v '^(#|$)' fichier


---++++ RSYNC

Sauvegarder (de façon incrémentielle) des répertoires du poste A vers le poste B :

1) Depuis A...

A#> rsync -avz /rep/rep1 /rep/rep2 B:/rep/

option -v = verbose

attention aux slashes '/' :

/rep/rep1 écrit un répertoire rep1 sur B

/rep/rep1/ écrit directement le contenu du répertoire rep1 sur B

2) ... ou Depuis B

rsync -avz A:/rep/rep1 A:/rep/rep2 ./rep


---++++ FIND

Chercher le fichier "foo" sur tout le disque :

find / -name foo

(si on n'est pas root, on voit plein de messages d'erreur, donc pour éviter ça :

find / -name foo 2>/dev/null


Supprimer tous les répertoires CVS/ dans toute une arborescence (à partir du répertoire courant) :

find . -name "CVS" -exec \rm -r {} \; > /dev/null 2>&1

Combien de fichiers dans un répertoire (y-compris les sous-rep) :

find rep | wc -l

Affecter des droits spécifiques à certains éléments d'un répertoire (tout le contenu, y-compris sous-dossiers) :

dossiers:

find /home/jsmith/awstats/ -type d | xargs chmod 0755

fichiers:

find /home/jsmith/awstats/ -type f | xargs chmod 0644

fichiers perl:

find /home/jsmith/awstats/ -type f -name *.pl | xargs chmod 0755




---++++ Forwarder les mails du serveur

http://www.feep.net/sendmail/tutorial/intro/forward.html

Par exemple, je veux forwarder mes mails de pallier@planetoweb.cesr.fr vers ma boite LABO ou encore ma boite perso :

cd ~

créer un fichier ".forward" contenant mon adresse LABO ou perso

S'il s'agit de forwarder les mails adressés à root@planetoweb.cesr.fr, on peut utiliser la même solution, mais on peut aussi 
ajouter cette ligne tout à la fin du fichier /etc/aliases

root:           etienne.pallier@cesr.fr


---++++ Rechercher un fichier (dans une hiérarchie de répertoires)

	 find . -name filename_searched

---++++ Rechercher un mot dans un ou plusieurs fichiers 

   * rechercher "mot" dans les fichiers idl du répertoire courant

grep "mot" *.pro

   * rechercher "mot" dans tous les fichiers du répertoire courant

grep -i "mot" .

L'option "-i" permet de ne pas tenir compte de la casse

   * rechercher "mot" dans tous les fichiers du répertoire courant ainsi que dans tous les sous-rep (récursif) :

grep -r -i "mot" .


---++++ Faire une action sur un ensemble de dossiers et fichiers

Depuis répertoire courant, supprimer tous les dossiers "CVS" (récursivement) :

	 find . -name CVS -exec rm -rf {} \;


---++++ Créer un alias

Exemple : quand on tape "l" ça fera "ls -l"

alias l="ls -l"

Cette ligne doit être placée dans votre ~/.bashrc

---++++ Configurer mon environnement

Pour les configurations perso, les placer dans son ~/.bash_profile (ce script appelle ~/.bashrc qui doit contenir les alias et fonctions)

Mettre les configurations générales dans /etc/profile.d/profile_etienne.sh (elles seront ainsi valables pour TOUS les users du serveur)

Ce fichier est automatiquement lu par /etc/profile au démarrage d'une session


---++++ Imprimer sur linux

Pour installer l'imprimante "sprinter", voir Computers.SprinterPrinter

Pour faire de cette imprimante l'imprimante par défaut, ajouter cette ligne dans votre ~/.bash_profile :

export PRINTER=sprinter (mettre le nom de votre imprimante à la place de "sprinter")

Pour imprimer du texte, on peut utiliser les utilitaires "a2ps" ou "enscript"


---++++ Visualiser des images (jpeg, ps, ...) en mode console
display

Note : display permet aussi de convertir une image d'un format vers un autre (enregistrer sous...)

Voir aussi "xv" et "gthumb"


---++++ Convertir une image d'un format vers un autre

PS to PDF : ps2pdf

Voir aussi l'utilitaire convert

En mode interactif, On peut aussi utiliser display (voir ci-dessus)

---++++ Réduire la taille d'un fichier PDF


Taper dans un terminal la commande suivante

gs -dBATCH -dNOPAUSE -q -sDEVICE=pdfwrite -sOutputFile=fichier_reduit.pdf fichier_a_reduire.pdf

La commande peut se faire avec l'option suivante (non obligatoire):

-dPDFSETTINGS=/screen     (qualité faible - compression forte)
-dPDFSETTINGS=/ebook      (qualité moyenne - compression moyenne)
-dPDFSETTINGS=/printer     (qualité élevée - compression faible)


---+++ Administration


---++++ IPTABLES (FIREWALL)

   * *Quelles sont lès règles actuelles ?*

/etc/init.d/iptables status

   * *Fichiers :*

ls /etc/sysconfig/iptables*

   * *Modifs :*

cd /etc/sysconfig/

1) modifs à faire sur iptables.clean

2) cp iptables.clean iptables

3) /etc/init.d/iptables restart

4) /etc/init.d/iptables save

5) /etc/init.d/iptables status (vérifier que les nouvelles règles apparaissent bien)









---++++ SVN (SUBVERSION)

Voir l'exemple du projet Europlanet : http://planetoweb.cesr.fr/twiki/bin/view/Team/EuroplanetProject#Serveur_SVN

Voir l'exemple de la configuration pour chemcam : /etc/httpd/conf.d/vhosts/chemcam.conf (planetoweb)

Besoins à considérer avant de mettre en place une solution svn :

- accès via apache (et non pas seulement en svnserve) pour assurer un accès depuis l'extérieur et qui passe les firewall

- AUTH : accès authentifié (AuthType, AuthUserFile et Require valid-user)

Exceptionnellement, sur un projet avec différents groupes (mais uniquement si nécessaire car ralentit les accès svn et alourdit la gestion) :

- ACL : contrôle d'accès basé sur les chemins :
(grâce au module authz_svn_module et à la directive AuthzSVNAccessFile), pour pouvoir réserver certains répertoires à certains groupes...


Exemple de config (chemcam) authentifiée mais SANS ACL :

<pre>

<Location /chemcam_svn>
        DAV svn

        ErrorDocument 404 default
        # Only 1 repository :
        SVNPath /home/projects/chemcam/svn
        # Many repositories :
        # any "/svn/foo" URL will map to a repository /home/svn/foo
        #SVNParentPath /home/svn 
        #SVNListParentPath on

        # Desactiver completement les controles sur les chemins (par defaut = on)
        SVNPathAuthz off

        # For any operations other than these (GET, PROFIND...), require an authenticated user
        #<LimitExcept GET PROPFIND OPTIONS REPORT> 
                Require valid-user
        #</LimitExcept>

        # AUTH
        AuthType Basic
        AuthName "CHEMCAM Subversion repository"
        # password file :
        AuthUserFile /chemin/vers/fichier/des/mots/de/passe

        # For any operations other than these, require an authenticated user (this would allow anybody to READ without authentication)
</Location>

# Custom log file and format :
LogFormat "%t %u %h %{SVN-ACTION}e" svn
CustomLog logs/journal-svn.log svn env=SVN-ACTION

</pre>


Exemple de config (chemcam) authentifiée et AVEC ACL :

<pre>

<Location /chemcam_svn>
        DAV svn

        ErrorDocument 404 default
        # Only 1 repository :
        SVNPath /home/projects/chemcam/svn
        # Many repositories :
        # any "/svn/foo" URL will map to a repository /home/svn/foo
        #SVNParentPath /home/svn 
        #SVNListParentPath on

        # Desactiver completement les controles sur les chemins (par defaut = on)
        SVNPathAuthz on

        # ACL
        # politique de controle d'acces (uses apache module mod_authz_svn)
        AuthzSVNAccessFile /chemin/vers/fichier/police_acces_svn

        # For any operations other than these (GET, PROFIND...), require an authenticated user
        #<LimitExcept GET PROPFIND OPTIONS REPORT> 
                Require valid-user
        #</LimitExcept>

        # AUTH
        AuthType Basic
        AuthName "CHEMCAM Subversion repository"
        # password file :
        AuthUserFile /chemin/vers/fichier/des/mots/de/passe

        # For any operations other than these, require an authenticated user (this would allow anybody to READ without authentication)
</Location>

# Custom log file and format :
LogFormat "%t %u %h %{SVN-ACTION}e" svn
CustomLog logs/journal-svn.log svn env=SVN-ACTION

</pre>

Format du fichier de police d'accès aux répertoires du projet svn (nommé police_acces_svn ci-dessus) :

<pre>

[groups]
# Virtual Machine only group :
cc-vm = user1, user20, user7
# Privileged access group :
cc-privileged = user3, user2, user6, user8, user30

[/]
# cc-privileged group has total access to the project (and no one else)
@cc-privileged = rw
# access given to ALL users !!!
#* = rw

[/trunk/vm]
# cc-vm group has read only access to the /vm dir (and no other dir)
@cc-vm = r
# cc-vm group has no access at all to the /vm dir
#@cc-vm =

</pre>

---++++ LVM (Logical Volume Management)

http://www.linux-mag.com/id/7454

LVM can be used to effectively manage storage to make expansion, snapshots, and other aspects of storage fairly easy.

LVM allows you to abstract various pieces of physical storage into groups that can be carved into chunks that form the basis of file systems (virtual partitions if you like). It also allows you to combine physical partitions into groups, resize these groups (grow or shrink), and effectively manage these groups.

1) h physical hd découpés chacun en p physical partitions (PP) (pas forcément le même nb de partitions pour chaque hd)

ex : sda découpé en /dev/sda1, /dev/sda2 et sdb découpé en /dev/sdb1, /dev/sdb2, /dev/sdb3

2) mapping identité entre les partitions physiques (PP) et virtuelles (PV) : 1 PV = 1 PP

Make sure the partition type for the physical volumes is correct. The partition type should be &#8220;8e&#8221;.

<pre>
# fdisk -l /dev/sdb

Disk /dev/sdb: 500.1 GB, 500107862016 bytes
255 heads, 63 sectors/track, 60801 cylinders
Units = cylinders of 16065 * 512 = 8225280 bytes

   Device Boot      Start         End      Blocks   Id  System
/dev/sdb1               1       30400   244187968+  8e  Linux LVM
/dev/sdb2           30401       60801   244196032+  8e  Linux LVM
</pre>

<pre>
# pvcreate /dev/sdb1 /dev/sdb2 /dev/sdc1 /dev/sdc2
  Physical volume "/dev/sdb1" successfully created
  Physical volume "/dev/sdb2" successfully created
  Physical volume "/dev/sdc1" successfully created
  Physical volume "/dev/sdc2" successfully created
</pre>

<pre>
# pvdisplay
  "/dev/sdb1" is a new physical volume of "232.88 GB"
  --- NEW Physical volume ---
  PV Name               /dev/sdb1
  VG Name
  PV Size               232.88 GB
  Allocatable           NO
  PE Size (KByte)       0
  Total PE              0
  Free PE               0
  Allocated PE          0
  PV UUID               j4XKT6-OI2y-cPMK-YpNR-gmgc-es67-ey4CV2

  "/dev/sdb2" is a new physical volume of "232.88 GB"
  --- NEW Physical volume ---
...
</pre>

Notice that each PV is given a PV UUID

3) Les PV sont regroupés en 1 à n volume group (VG) (a VG can be seen as a "virtual hd")

ex : le VG primary_vg regroupera /dev/sda1, /dev/sda2 , /dev/sdb1, et /dev/sdb3

<pre>
# vgcreate primary_vg /dev/sdb1 /dev/sdb2 /dev/sdc1 /dev/sdc2
  Volume group "primary_vg" successfully created
</pre>

<pre>
# vgdisplay
  --- Volume group ---
  VG Name               primary_vg
  System ID
  Format                lvm2
  Metadata Areas        4
  Metadata Sequence No  1
  VG Access             read/write
  VG Status             resizable
  MAX LV                0
  Cur LV                0
  Open LV               0
  Max PV                0
  Cur PV                4
  Act PV                4
  VG Size               931.52 GB
  PE Size               4.00 MB
  Total PE              238468
  Alloc PE / Size       0 / 0
  Free  PE / Size       238468 / 931.52 GB
  VG UUID               oNH6jk-PBE0-mR0c-aaDi-3Fys-y5SQ-0tVaxX
</pre>

If you don't happen to remember the name of a VG or you happen upon a new system to administer, then you can use a command called "vgscan" that will tell what VG's are on the system.

<pre>
# vgscan
  Reading all physical volumes.  This may take a while...
  Found volume group "primary_vg" using metadata type lvm2
</pre>

4) Chaque VG est redécoupé en m logical volume (LV) : 1 VG = m LV (a LV can be seen as a "virtual partition")

ex : le VG primary_vg est redécoupé en 2 LV : /dev/primary_vg/home_lv et /dev/primary_vg/data_lv

<pre>
# lvcreate --name /dev/primary_vg/home_lv --size 450G
  Logical volume "home_lv" created

lvdisplay...

lvscan...

</pre>

5) Sur chaque LG, on monte un système de fichier (FS) :

ex : /home monté en ext3 sur le LV home_lv et /data monté en xfs sur le LV data_lv
Comment 
<pre>
# mkfs.ext3 /dev/primary_vg/home_lv
...
</pre>


*Comment faire un snaphot ?*

http://www.linux-mag.com/id/7454/2/

For example, if the file system says it has 29G used (29 GB), then you should snapshot a little larger &#8211; perhaps 30-32 GB (always good to have a cushion). This cushion isn&#8217;t strictly necessary, but a little safety never hurts...



---++++ soft RAID (Redundant Array of Inexpensive Disks)

http://smpfr.mesdiscussions.net/smpfr/Software/soft-linux-nuls-sujet_338_1.htm

Vous pouvez faire vos tests sur des fichiers ou des clefs USB pour commencer...
Remplacez simplement le "device" par un fichier existant. Ex : /dev/sdX par /home/moi/raid-test/disque-1.img.
 
Pour créer un fichier quelque part avec la bonne taille : dd if=/dev/zero of=/home/moi/raid-test/disque-1.img count=10000 bs=65535.
Pour en savoir plus : man dd.
 
Apres on fait un :  mdadm --create /dev/md0 --level=1 --raid-devices=/home/moi/raid-test/disque-1.img,/home/moi/raid-test/disque-2.img
 
Et voila un RAID 1 créé avec deux fichiers stockés sur le disque dur.

J'ai testé le Raid0 sur 2DD externes de 2,5" en USB, et j'arrive à 45Mo sec avec mon portable...

Avant de mettre un raid sur une machine en production VERIFIEZ les noms des disques et des partitions !!! Préférez les /dev/disk/by-id, vous ferez moins facilement des erreurs qu'en mettant seulement /dev/sde, surtout si vous ajoutez des disques par la suite...
 
L'outil magique de management du RAID sous Linux : mdadm
 
Quelques exemples : (vous noterez que l'on utilise la syntaxe /dev/sdX alors que c'est mal.. mais c'est plus lisible que /dev/disk/by-id/ata-ST3250310AS_6RY7R988-part1)
 
création d'une pile raid :

mdadm --create /dev/mdX --level=[01456] --raid-devices={/dev/sdYZ, missing, ...}
 
crée un device /dev/mdX (X étant un chiffre) de niveau (--level)  0 (stripping), 1 (mirroring), 4 (comme le 5 mais la parité est toujours sur le même disque), 5 ou 6 (2 disques de parité) à partir des devices /dev/sdYZ (Y est une lettre indiquant un disque physique , Z un chiffre indicant un numéro de partition).
On peut également mettre missing dans la liste des devices. C'est très utile lorsque l'on passe son système sur un raid 1 :D
 
Mise en échec d'un disque (pour test par ex.) :
mdadm --manage /dev/mdX --failed /dev/sdYZ
 
"Ejection" d'un disque d'une pile :
mdadm --manage /dev/mdX --remove /dev/sdYZ
 
Ajout d'un disque à une pile :
mdadm --manage /dev/mdX --add /dev/sdYZ
 
Liste des périphériques d'une pile :
mdadm --misc --detail /dev/mdX

On peux aussi faire :

cat /proc/mdstat


---++++ Agrandir une partition 

La première étape consiste à repérer quel device correspond aux partitions que tu veux redimensionner. Pour cela tu peux utiliser la commande :

sudo fdisk -l

<pre>
# fdisk -l

Disque /dev/sda: 250.0 Go, 250059350016 octets
255 heads, 63 sectors/track, 30401 cylinders
Unités = cylindres de 16065 * 512 = 8225280 octets

Périphérique Amorce    Début         Fin      Blocs    Id  Système
/dev/sda1   *           1          25      200781   83  Linux
/dev/sda2              26         535     4096575   82  Linux swap / Solaris
/dev/sda3             536       30401   239898645   83  Linux

Disque /dev/sdb: 250.0 Go, 250059350016 octets
255 heads, 63 sectors/track, 30401 cylinders
Unités = cylindres de 16065 * 512 = 8225280 octets

Périphérique Amorce    Début         Fin      Blocs    Id  Système
/dev/sdb1   *           1       30401   244196001   fd  Linux raid autodetect

Disque /dev/sdc: 250.0 Go, 250059350016 octets
255 heads, 63 sectors/track, 30401 cylinders
Unités = cylindres de 16065 * 512 = 8225280 octets

Périphérique Amorce    Début         Fin      Blocs    Id  Système
/dev/sdc1   *           1       30401   244196001   fd  Linux raid autodetect

Disque /dev/sdd: 250.0 Go, 250059350016 octets
255 heads, 63 sectors/track, 30401 cylinders
Unités = cylindres de 16065 * 512 = 8225280 octets

Périphérique Amorce    Début         Fin      Blocs    Id  Système
/dev/sdd1   *           1       30401   244196001   fd  Linux raid autodetect

Disque /dev/md0: 500.1 Go, 500113080320 octets
2 heads, 4 sectors/track, 122097920 cylinders
Unités = cylindres de 8 * 512 = 4096 octets

Disque /dev/md0 ne contient pas une table de partition valide
</pre>

Pour avoir un résultat plus parlant (tailles en octets + système de fichiers) tu peux utiliser cfdisk : sudo cfdisk /dev/sda

L'ext3 c'est en fait de l'ext2 mais avec un "journal" et c'est pour ça qu'il est facile de passer d'ext2 à ext3 et réciproquement.

Les outils de redimensionnement s'appliquent à de l'ext2 ce qui nécessitera de passer d'ext3 à ext2, redimensionner, puis repasser en ext3

http://www.webactus.net/coin-du-geek/linux/2704-linux-augmenter-la-taille-dune-partition-ext3/


---++++ Redimensionner une partition (avec gparted)

http://www.oxygenepc.com/forum/cloner-un-disque-dur-t486.html

---++++ Copie de disque ou partition avec dd (création d'image "ghost")

http://www.oxygenepc.com/forum/cloner-un-disque-dur-t486.html

http://www.linuxquestions.org/linux/answers/Applications_GUI_Multimedia/How_To_Do_Eveything_With_DD

http://www.debianhelp.co.uk/ddcommand.htm

The basic command is structured as follows:

dd if=<source> of=<target> bs=<byte size>(usually some power of 2, not less than 512 bytes(ie, 512, 1024, 2048, 4096, 8192, 16384, but can be any number.) skip= seek= conv=<conversion>.

Source is the data being read. Target is where the data gets written. If you mess up, and accidentally reverse the source and target, you can wipe out a lot of data.

(http://www.efense.com/helix is a good boot cd : The helix boot environment contains the DoD version of dd called dcfldd. It works the same way, but is has a progress bar)


Using dd you can create backups of an entire harddisk or just a parts of it. This is also usefull to quickly copy installations to similar machines. It will only work on disks that are exactly the same in disk geometry, meaning they have to the same model from the same brand.

Examples:

   * full hard disk copy

dd if=/dev/hdx of=/dev/hdy
dd if=/dev/hdx of=/path/to/image
dd if=/dev/hdx | gzip > /path/to/image.gz

Hdx could be hda, hdb etc. In the second example gzip is used to compress the image if it is really just a backup.

   * Restore Backup of hard disk copy

dd if=/path/to/image of=/dev/hdx

gzip -dc /path/to/image.gz | dd of=/dev/hdx

   * MBR backup

In order to backup only the first few bytes containing the MBR and the partition table you can use dd as well.

dd if=/dev/hdx of=/path/to/image count=1 bs=512

   * MBR restore

dd if=/path/to/image of=/dev/hdx

Add "count=1 bs=446" to exclude the partition table from being written to disk. You can manually restore the table.

   * Copy one hard disk partition to another hard disk:

dd if=/dev/sda2 of=/dev/sdb2 bs=4096 conv=notrunc,noerror

sda2, sdb2 are partitions. You want to copy sda2 to sdb2. If sdb2 doesn't exist, dd will start at the beginning of the disk, and create it. Be careful with order of if and of. You can write a blank disk to a good disk if you get confused.

   * Make an iso image of a CD:

dd if=/dev/hdc of=/home/sam/mycd.iso bs=2048 conv=notrunc

CD sectors are 2048 bytes, so this copies sector for sector. The result will be a hard disk image file of the CD. You can use "chmod a+rwx mycd.iso" to make the image writable. You can mount the image with "mkdir /mnt/mycd", this line in fstab: "/home/sam/mycd.iso /mnt/mycd iso9660 rw,user,noauto 0 0", save fstab, "mount -o loop /mnt/mycd". Then the file system will be viewable as files and directories in the directory /mnt/mycd. You can edit the image as you wish, and the new file will be "/home/sam/mycd.iso" dd does not write to CD's. You need to use a burning utility, or the cdrdao command

   * Cloning an entire hard disk:

dd if=/dev/sda of=/dev/sdb conv=notrunc,noerror

In this example, sda is the source. sdb is the target. Do not reverse the intended source and target. Surprisingly many people do. notrunc means to not truncate. noerror means to keep going if there is an error. Normally dd stops at any error. if you have a question about a hard drive on whether or not it works, you can try to use it as the source drive for the dd command. You should get an error if it is not working. target drives need to be really messed up to give an error in dd.

   * Copy MBR only of a hard drive:

dd if=/dev/sda of=/home/sam/MBR.image bs=446 count=1

this will copy the first 446 bytes of the hard drive to a file. If you haven't already guessed, reversing the objects of if and of, in the dd command line reverses the direction of the write.

   * Back up your MBR

dd if=/dev/sda of=mbr.bin count=1

Put this on a floppy you make with

dd if=boot.img of=/dev/fd0

Along with dd. Boot from the floppy and

dd if=mbr.bin of=/dev/sda count=1

Will restore the MBR

   * Copy a disk partition to a file on a different partition (Do not copy a partition to the same partition)

dd if=/dev/sdb2 of=/home/sam/partition.image bs=4096 conv=notrunc,noerror

This will make a file that is an exact duplicate of the sdb2 partition. You can substitue hdb, sda, hda, or whatever the disk is called.

   * Restore a disk partition from an image file.

dd if=/home/sam/partition.image of=/dev/sdb2 bs=4096 conv=notrunc,noerror

This way you can get a bazonga hard drive and partition it so you can back up your root partition. If you mess up your root partition, you just boot from the helix cd and restore the image.



---++++ Copie de disque ou partition (image "ghost") avec partimage (SystemRescueCd)

J'ai un disque qui montre des faiblesses

Je veux le remplacer par un nouveau disque

Je dois donc faire une image du disque et la copier ensuite sur le nouveau disque

1) Télécharger une ISO de SystemRescueCd (x86)

http://www.sysresccd.org/Download

2) Vérifier le checksum de cette ISO

md5sum systemrescuecd-x86-2.1.1.iso

Pour faire ça depuis Windows, télécharger md5deep (http://sourceforge.net/projects/md5deep/files/md5deep/md5deep-1.12/md5deep-1.12.zip/download)

Il contient md5sum, que l'on peut appeler sous Dos : md5sum systemrescuecd-x86-2.1.1.iso

3) Créer un DVD à partir de cette ISO

4) Identifier les partitions du disque à copier (avec df, fdisk, et /proc/partitions)

Dans mon cas, c'était le disque système qui montrait des faiblesses

Il s'appelle /dev/sda et contient 3 partitions

<pre>

# df -h
Sys. de fich.         Tail. Occ. Disp. %Occ. Monté sur
/dev/sda3             222G   18G  193G   9% /
/dev/sda1             190M   18M  163M  10% /boot
...


# fdisk -l

Disque /dev/sda: 250.0 Go, 250059350016 octets
255 heads, 63 sectors/track, 30401 cylinders
Unités = cylindres de 16065 * 512 = 8225280 octets

Périphérique Amorce    Début         Fin      Blocs    Id  Système
/dev/sda1   *           1          25      200781   83  Linux
/dev/sda2              26         535     4096575   82  Linux swap / Solaris
/dev/sda3             536       30401   239898645   83  Linux

Disque /dev/sdb: 250.0 Go, 250059350016 octets
255 heads, 63 sectors/track, 30401 cylinders
Unités = cylindres de 16065 * 512 = 8225280 octets

Périphérique Amorce    Début         Fin      Blocs    Id  Système
/dev/sdb1   *           1       30401   244196001   fd  Linux raid autodetect

Disque /dev/sdc: 250.0 Go, 250059350016 octets
255 heads, 63 sectors/track, 30401 cylinders
Unités = cylindres de 16065 * 512 = 8225280 octets

Périphérique Amorce    Début         Fin      Blocs    Id  Système
/dev/sdc1   *           1       30401   244196001   fd  Linux raid autodetect

Disque /dev/sdd: 250.0 Go, 250059350016 octets
255 heads, 63 sectors/track, 30401 cylinders
Unités = cylindres de 16065 * 512 = 8225280 octets

Périphérique Amorce    Début         Fin      Blocs    Id  Système
/dev/sdd1   *           1       30401   244196001   fd  Linux raid autodetect

Disque /dev/md0: 500.1 Go, 500113080320 octets
2 heads, 4 sectors/track, 122097920 cylinders
Unités = cylindres de 8 * 512 = 4096 octets

Disque /dev/md0 ne contient pas une table de partition valide


# fdisk /dev/sda
...

Commande (m pour l'aide): p

Périphérique Amorce    Début         Fin      Blocs    Id  Système
/dev/sda1   *           1          25      200781   83  Linux
/dev/sda2              26         535     4096575   82  Linux swap / Solaris
/dev/sda3             536       30401   239898645   83  Linux

# cat /proc/partitions
major minor  #blocks  name

   8     0  244198584 sda
   8     1     200781 sda1
   8     2    4096575 sda2
   8     3  239898645 sda3
   8    16  244198584 sdb
   8    17  244196001 sdb1
   8    32  244198584 sdc
   8    33  244196001 sdc1
   8    48  244198584 sdd
   8    49  244196001 sdd1
   9     0  488391680 md0


# cat /etc/fstab

LABEL=/                 /                       ext3    defaults        1 1
LABEL=/boot1            /boot                   ext3    defaults        1 2
devpts                  /dev/pts                devpts  gid=5,mode=620  0 0
tmpfs                   /dev/shm                tmpfs   defaults        0 0
/dev/md0                /home                   ext3    defaults        1 2
proc                    /proc                   proc    defaults        0 0
sysfs                   /sys                    sysfs   defaults        0 0
LABEL=SWAP-sda2         swap                    swap    defaults        0 0
/dev/cdrom              /media/cdrom            udf,iso9660 user,noauto,exec    0 0

</pre>


---++++ Virtualisation

La virtualisation consiste à faire cohabiter plusieurs (VM) machines "virtuelles" (OS) sur une même machine physique

Prérequis :

   * Les processeurs doivent être virtualisables (cpuinfo doit contenir le flag vmx pour un processeur intel, et svm pour AMD) : egrep '(vmx|svm)' /proc/cpuinfo

   * RAM : au moins 8Go (pour 2 VM)

   * Disques : 
      * au moins 2x500Go (en raid1 par exemple)
      * bonne config type : 
         * 2 disques raid1 pour le système de base
         * 3 disques raid5 avec un LVM dessus pour stocker les images disques des VM


---++++ Serveur de gestion de versions (de code source) SUBVERSION

http://planetoweb.cesr.fr/twiki/bin/view/Team/EuroplanetProject#Serveur_SVN

---++++ Connexion X11

http://en.wikipedia.org/wiki/X_display_manager

http://en.wikipedia.org/wiki/X_Window_System_protocols_and_architecture

http://tldp.org/HOWTO/XDMCP-HOWTO/intro.html

Le serveur X tourne localement sur mon pc (win ou lin), c'est à dire le pc avec un écran (output), un clavier et une souris (inputs).

Il se connecte à un display manager (xdm ou gdm ou kdm...) qui peut être local ou distant (sur un autre pc) :
   * Si le DM est local, il démarre un ou plusieurs serveurs X, affiche l'écran de connexion (login) au démarrage et chaque fois qu'un user se délogge.
   * Si le DM est distant, il est utilisé via le protocole XDMCP : un user lance des programmes depuis le pc distant (qui exécute le DM) alors que ses input/output se passent sur son pc local.

Ainsi, le serveur X (local) communique avec différents clients graphiques (qui peuvent être distants) à qui il envoit les inputs et de qui il reçoit les outputs.

Pour CentOS, le DM par défaut est sélectionné dans /etc/X11/prefdm (qui regarde si un DM par défaut est donné dans /etc/sysconfig/desktop)

C'est le fichier /etc/X11/xinit/Xsession qui exécute notre environnement.

xdm : voir /etc/X11/

kdm : voir /etc/kdm/

gdm : voir /etc/gdm/ Il devrait s'y trouver un gdm.conf

gdm appelle /etc/X11/xinit/Xsession avec les bonnes options

http://projects.gnome.org/gdm/docs/gdmtalk.pdf

Attention, X et XDMCP sont tous les 2 non sécurisés !!!

Vérifier /etc/resolv.conf

Vérifier /etc/init.d/xfs (font server)

Vérifier que dans /etc/inittab, le default runlevel est bien 5 :

id:5:initdefault:

Vérifier /etc/X11/xorg.conf

Sur serveur boulot, on voit bien que c'est gdm qui tourne :

<pre>
[root@hyperion xinit]# ps -efl|grep gdm
4 S root      3815     1  0  76   0 - 41936 429493  2010 ?        00:00:00 /usr/sbin/gdm-binary -nodaemon
5 S root      3917  3815  0  76   0 - 48714 pipe_w  2010 ?        00:00:00 /usr/sbin/gdm-binary -nodaemon
4 S root      3919     1  0  77   0 - 47464 304555  2010 ?        00:00:04 /usr/libexec/gdm-rh-security-token-helper
4 S root      3920  3917  0  75   0 - 22128 -       2010 tty7     00:03:08 /usr/bin/Xorg :0 -br -audit 0 -auth /var/gdm/:0.Xauth -nolisten tcp vt7
4 S gdm       3946  3917  0  75   0 - 56317 -       2010 ?        00:00:02 /usr/libexec/gdmgreeter
</pre>

Log de X : /var/log/Xorg.0.log

Config de X : /etc/X11/xorg.conf


---++++ BOOT LINUX

---+++++ I - Le boot : tryptique noyau, arguments, et ramdisk
Synthèse du workflow : 
bootloader ==> noyau + initramfs + arguments ==> montage de la racine

---++++++ 1) Chargeur de boot (bootloader)
C'est le 1er prog à s'exécuter. Différent selon les architectures (pc x86, station Sun, Mac PPC...)
Rôle: mettre en RAM le noyau (kernel), lui passer des arguments, copier un ramdisk en RAM, et passer la main au noyau
Ex: lilo, grup, outils syslinux (bien adapté à partifion FAT, clé usb, cd)
Etapes :
- allumage électrique
- POST (Power On Self Test)
- BIOS (dans lequel le periph d'amorçage est défini)
- lancement bootloader installé sur periph amorcé
Ex: noyau grub, /boot/bzImage-2.6
Ex: ramdisk grub, /boot/initrd.img

---++++++ 2) Le noyau
Rôle : monter la racine et lancer /sbin/init situé dessus
Au boot, le noyau décourvre son environnement (ram, cpu, disque...). Ces périph sont gérés par des pilotes (drivers), des "modules" qui sont compilés dans le noyau ou dans des fichiers externes (souvent dans /lib/modules/). Les fichiers modules sont situés sur une partition qui n'est pas encore montée, et donc les périph correspondants ne peuvent pas être utilisés.
Le noyau monte sa racine avec /bin/mount
ex: montage de /dev/sda1 en lecture seule avec sys de fichier ext4
$ mount -t ext4 -o ro /dev/sda1 /
Les arguments passés au noyau peuvent être relus après boot :
$ cat /proc/cmdline
On peut aussi passer l'argument "init=/bin/bash" pour accéder au système au démarrage avec un shell bash.

---++++++ 3) Le ramdisk initial : initramfs
Rôle : permettre une détection plus intelligente de la racine ainsi qu'une facilité de configuration.
 S'appelait initrd, mais est de plus en plus remplacé par initramfs
L'initramsf est un ensemble de fichiers qui vont être directement copiés dans le cache de système de fichiers sous la racine (tous les sys 2.6 utilisent un rootfs, cf "cat /proc/mounts"). Il doit au moins contenir un programme /init exécutable que le noyau va lancer pour qu'il trouve la racine et la monte. C'est un microsystème linux à part entière. Le prog /init est souvent un script shell, simple à lire.
Avec un initramfs, il devient possible de conserver un noyau minimal et de mettre les modules essentiels au boot dans l'initramfs (évite de devoir recompiler le noyau). Il contient aussi l'image qui permet un affichage graphique pendant le boot.
/init parse donc la ligne /proc/cmdline, cherche la racine, et la monte pour ensuite basculer le noyau dessus, et enfin s'autoremplace par le vrai binaire /sbin/init.

---+++++ II - init et inittab

Arrivé à ce point, la noyau tourne, la racine de la distrib est montée (souvent en "ro") et le binaire /sbin/init est lancé, premier processus.

Si ce processus meurt (pid=1), le noyau fait un kernel panic. Il est aussi responsable de l'extinction de la machine.
Si on passe au noyau l'argument "init=/bin/bash", seul "bash" est lancé (à la place de /sbin/init) et on a ainsi un accès root sur la racine (utile pour réparer une distrib, ou modifier mot passe root dans /etc/shadow)

/sbin/init a pour fichier de conf, /etc/inittab : décrit les processus lancés au démarrage et à surveiller durant le fonctionnement normal du système.
Init à 7 runlevels (0=stop, ...,  6=reboot). Runlevel 1 est pour la maintenance (nb minimum de processus et user root only).
Chaque ligne est composée de 4 paramètres :
référence:runlevel:manière de lancer la commande:commande
Runlevel par défaut (ici, le 3):
id:3:initdefault:
On peut modifier ça avec un argument au noyau, par ex:
root=/dev/hda2 ro 1
Runlevel courant ?
$ runlevel
Changer de runlevel ?
$ init n

sysinit est lancé au boot, mais avant les cdes boot:
si::sysinit:/etc/rc.d/rc.sysinit

reset:
ca::ctrlaltdel:/sbin/shutdown -t3 -r now

wait, lance un process et attend sa fin pour continuer:
l5:5:wait:/etc/rc.d/rc 5

respawn, relance le process quand il se termine (ex: les gettys texte, alt-F1... relancés dès qu'on se délogue)
5:2345:respawn:/sbin/mingetty tty5

Relecture de inittab après modif ?
kill -HUP 1

inittab lance des script rc (run command) de 2 façons selon les familles de systèmes linux :
   * façon systemV (RedHat et Debian)
   * façon BSD (slackware)

Voyons ici la façon SystemV (plus élaborée que BSD)

en fait, inittab lance le script rc général et lui passe le runlevel en argument:
l5:5:wait:/etc/rc.d/rc 5
rc va lancer les scripts du runlevel associé, dans l'ordre alpha.
/etc/rc.d/ contient un dossier rcN.d/ par runlevel (N)
ex: /etc/rc.d/rc5.d/
Ce dossier contient simplement des liens vers les scripts de /etc/init.d/ (qui doivent accepter au moins les arguments "start" et "stop")
Ces liens sont préfixés par S (Start) ou K (Kill).
Quand on entre dans un runlevel, tous les liens S* de ce runlevel sont exécutés (dans l'ordre alpha)
Quand on sort d'un runlevel, tous les liens K* de ce runlevel sont exécutés
Ex:
S85httpd lancera "/etc/init.d/httpd start"
Un lien /etc/rc.d/rc5.d/S42foobar sera exécuté à l'entrée du runlevel 5, et appellera /etc/init.d/foobar start
Il sera exécuté avant l'appel de S95barqux
Sur RedHat, seul le runlevel 5 lance X :
x:5:respawn:/etc/X11/prefdm -nodaemon

Le dernier script à être lancé est /etc/rc.d/rc.local
(on peut y mettre tout ce qu'on veut voir exécuter au boot)
Le prog update-rc.d peut être utilisé pour activer/désactiver des scripts au démarrage.

Ubuntu propose Upstart en remplacement du couple init/inittab
MacOS propose un "super-daemon" launchd qui regroupe les fonctionnalités de init (lance démon lors du démarrage), crond (lance démon lors de top horaires), et (x)inetd (lance démon lors de requêtes réseaux)


---++++ CRON

Pour tester manuellement une entrée du cron.daily : 

run-parts /etc/cron.daily


---++++ FTP

ex: installation ftp pour l'expérience RAMAN (sur ExoMars)

http://www.obs-mip.fr/index.php/fre/recherche/techniques-missions-spatiales/Exomars-RAMAN

   * Mission

La mission ExoMars, de l&#8217;Agence Spatiale Européenne (ESA), est une mission du programme Aurora. Son objectif est de caractériser l&#8217;environnement biologique martien pour préparer l&#8217;exploration humaine de la planète rouge.

   * Instrument LABO

EXLIBRIS serait capable d&#8217;effectuer une ablation des roches puis l&#8217;analyse de la composition de cette roche à la fois en chimie élémentaire (ultra-violet), en minéraux et composés organiques (Raman). Le LABO serait responsable de la partie LIBS (ultra-violet) et de la calibration de l&#8217;instrument. F. Rull Pérez (Centro de Astrobiologia , Espagne) serait en charge de la partie Raman.
Contexte de réalisation

Mission ESA : Tir prévu en 2013.

Voir en ligne (Site Officiel d&#8217;ExoMars à l&#8217;ESA) : http://www.esa.int/esaSC/SEMGB7MJ74G_index_0.html

   * Installation ftp

Ajout 2 users ftpread et ftpw (groupe ftpgroup) dans /etc/passwd (et /etc/shadow), et leur donner pour home /projects/raman/ftp/files

Leur attribuer un pass via "password"

Leur donner un accès exclusif a leur home:

chown ftpw:ftpgroup /projects/raman/ftp/files/

Faire en sorte que ftpread n'est qu'un accès en lecture seule (via son groupe ftpgroup) :

chmod 755 /projects/raman/ftp/files/ --> "rwxr-xr-x"

Les autoriser en les ajoutant dans dans /etc/vsftpd/user_list

(chroot doit être activé par défaut pour tous les users internes)

/etc/init.d/vsftpd restart







---++++ LOGS

/var/log

auth.log ou secure (sur Redhat)

Outil de visualisation graphique des logs : gnome-system-log

Common Linux log files name and usage :
<pre>
    /var/log/message: General message and system related stuff
    /var/log/auth.log: Authenication logs
    /var/log/kern.log: Kernel logs
    /var/log/cron.log: Crond logs (cron job)
    /var/log/maillog: Mail server logs
    /var/log/qmail/ : Qmail log directory (more files inside this directory)
    /var/log/httpd/: Apache access and error logs directory
    /var/log/lighttpd: Lighttpd access and error logs directory
    /var/log/boot.log : System boot log
    /var/log/mysqld.log: MySQL database server log file
    /var/log/secure: Authentication log
    /var/log/utmp or /var/log/wtmp : Login records file
    /var/log/yum.log: Yum log files
</pre>

In short /var/log is the location where you should find all Linux logs file. However some applications such as httpd have a directory within /var/log/ for their own log files. You can rotate log file using logrotate software and monitor logs files using logwatch software.


---+++++ logrotate

/etc/logrotate.conf

/etc/logrotate.d/

Forcer une rotation : 

sudo logrotate -f /etc/logrotate.conf

==> new file "messages", "messages" devient "messages1", "messages1" devient "messages2"...

---+++++ logwatch

by default, runs daily on yesterday's logs (/etc/cron.daily/0logwatch qui pointe sur /usr/share/logwatch/scripts/logwatch.pl), includes all services, and sends a mail to root

Configuration locale :
   * Générale : /usr/share/logwatch/default.conf/logwatch.conf
   * Locale : /etc/logwatch/conf/logwatch.conf

Exemples :

info sur l'activité sshd d'aujourd'hui : 

logwatch --service sshd --range=Today

Plus de détails :

logwatch --service sshd --range=Today --detail=Medium (ou High)

Pour créer un fichier au lieu d'un mail : --save=logwatch.today

Bonne config de logwatch.conf :

Range=All (au lieu de "Yesterday")
Detail=High
Archives=Yes (ajoute les logs des semaines précédentes, pas seulement le log en cours)

Equivalent commande : --range=All --archives

Exemple de config sur planetoweb (aug 2010) :

Création d'une config locale /etc/logwatch/conf/logwatch.conf :
<pre>
Range = All
Detail = High
Archives = Yes
Output = html
Save = /var/www/html/servers/planetoweb/logwatch.html
</pre>

Résultat sur http://planetoweb/servers/planetoweb/logwatch.html

---+++++ swatch

http://www.linux-mag.com/id/7807

yum install swatch

<pre>
[root@planetoweb planetoweb]# rpm -ql swatch
/usr/bin/swatch
/usr/lib/perl5/vendor_perl/5.8.8/Swatch
/usr/lib/perl5/vendor_perl/5.8.8/Swatch/Actions.pm
/usr/lib/perl5/vendor_perl/5.8.8/Swatch/Threshold.pm
/usr/lib/perl5/vendor_perl/5.8.8/Swatch/Throttle.pm
/usr/lib/perl5/vendor_perl/5.8.8/auto/Swatch
/usr/lib/perl5/vendor_perl/5.8.8/auto/Swatch/Actions
/usr/lib/perl5/vendor_perl/5.8.8/auto/Swatch/Actions/autosplit.ix
/usr/share/doc/swatch-3.2.1
/usr/share/doc/swatch-3.2.1/CHANGES
/usr/share/doc/swatch-3.2.1/COPYING
/usr/share/doc/swatch-3.2.1/COPYRIGHT
/usr/share/doc/swatch-3.2.1/KNOWN_BUGS
/usr/share/doc/swatch-3.2.1/README
/usr/share/doc/swatch-3.2.1/examples
/usr/share/doc/swatch-3.2.1/examples/SendMail.pm
/usr/share/doc/swatch-3.2.1/tools
/usr/share/doc/swatch-3.2.1/tools/reswatch
/usr/share/doc/swatch-3.2.1/tools/swatch_oldrc2newrc
/usr/share/man/man1/swatch.1.gz
/usr/share/man/man3/Swatch::Actions.3pm.gz
/usr/share/man/man3/Swatch::Threshold.3pm.gz
/usr/share/man/man3/Swatch::Throttle.3pm.gz
</pre>

/usr/share/doc/swatch

Créer un startup script : vi /etc/init.d/swatch
<pre>
#!/bin/sh
# Simple Log Watcher Program

case "$1" in
'start')
		/usr/bin/swatch --daemon --config-file=/etc/swatch.conf --tail-file=/var/log/auth.log --pid-file=/var/run/swatch.pid
		;;
'stop')
		PID=`cat /var/run/swatch.pid`
		kill $PID
		;;
*)
		echo "Usage: $0 { start | stop }"
		;;
esac
exit 0
</pre>

chmod 755 /etc/init.d/swatch

Make sure swatch starts automatically at my runlevels :
<pre>
# ln -s /etc/init.d/swatch /etc/rc2.d/S99swatch
# ln -s /etc/init.d/swatch /etc/rc3.d/S99swatch
# ln -s /etc/init.d/swatch /etc/rc5.d/S99swatch
</pre>

Créer un fichier de conf /etc/swatch.conf :
<pre>
watchfor /invalid|repeated|incomplete/
         echo
	 write khess
	 mail addresses=khess@localhost, subject=Authentication Problems
</pre>

/etc/init.d/swatch start ==> créer un pid dans /var/run/swatch.pid et un fichier /root/.swatch_script.xxxx (avec xxxx = pid - 2)


---++++ SSH, config plus stricte


1) Accès ssh direct en root autorisé seulement depuis mon pc

http://www.ibm.com/developerworks/aix/library/au-ssh_restrict/

vi /etc/ssh/sshd_config :
<pre>
PermitRootLogin yes
AllowUsers moi@MONPC moi@MONPC.domain root@MONPC root@MONPC.domain moi@PASSERELLE 
</pre>

(le moi@PASSERELLE est nécessaire pour que je puisse aussi me connecter depuis chez moi)

/etc/init.d/sshd restart

Si j'essaye une connexion (moi ou root) depuis MONPC, ça passe

Si j'essaye une connexion (moi ou root) depuis un AUTREPC, je suis rejeté

On voit le refus de connexion dans /var/log/secure :
<pre>
User root from AUTREPC not allowed because not listed in AllowUsers
Jul 16 14:57:06 planetoweb sshd[28008]: input_userauth_request: invalid user root
Jul 16 14:57:11 planetoweb sshd[28007]: pam_unix(sshd:auth): authentication failure; logname= uid=0 euid=0 tty=ssh ruser= rhost=AUTREPC  user=root
Jul 16 14:57:13 planetoweb sshd[28007]: Failed password for invalid user root from AUTREPC_IP port 60246 ssh2
</pre>

2) Encore plus strict, AUCUN accès ssh direct en root autorisé

http://www.howtogeek.com/howto/linux/security-tip-disable-root-ssh-login-on-linux/

<pre>
vi /etc/ssh/sshd_config

(Port 22 : on pourrait mettre ici un autre port, genre 2010, histoire de brouiller les pirates...)

PermitRootLogin yes
changed to :
PermitRootLogin no

LoginGraceTime 2m 
changed to : 
LoginGraceTime 30

/etc/init.d/sshd restart 
</pre>

---++++ Surveiller un serveur

last reboot

lastlog

dmesg

lspci

/var/log/messages

/var/log/secure

/var/log/boot.log

Voir aussi section suivante (test des disques)

---++++ Tester les disques durs

Occupation disques : df -h
<pre>
[root@hyperion home]# df -h
Sys. de fich.         Tail. Occ. Disp. %Occ. MontÃ© sur
/dev/sda3             178G   63G  106G  38% /
/dev/sdb1             2,7T  1,4T  1,3T  52% /data
/dev/sda1              99M   29M   65M  31% /boot
tmpfs                  24G  4,0K   24G   1% /dev/shm
</pre>

cat /proc/partitions

cat /etc/mtab

cat /proc/mounts (equivalent de la commande "mount")

cat /proc/scsi/scsi

Voir aussi si messages d'erreur disques dans /var/log/messsages

Tester aussi la commande dmesg (equivalent à /var/log/dmesg)


---++++ Yum

Annuler l'information sur les updates disponibles :

/etc/init.d/yum-updatesd stop

su -c 'chkconfig --level 2345 yum-updatesd off'  

Every other workaround seems to only kill yum-updatesd for runlevel 5. 

Try yum update after that. 

Keep in mind that you will no longer be informed that there updates available and as such you will need to check periodically with *yum check-update*

Quels sont les packages commençant par "mesa-" installés + à installer ? --> yum list mesa-*



---++++ Samba

*Installation du service sur le serveur :*

service smb start

chkconfig --level 345 smb on

Est-ce que samba est à l'écoute ? : service smb status

Redémarrer samba : service smb restart

Corriger un bug sur Mac Leopard (pas sur Tiger) : samba ne suit pas les liens qui vont vers un disque différent

Pour corriger ce bug, il suffit d'ajouter cette ligne dans la partie "[global]" du smb.conf :

unix extensions = no


*Gestion des utilisateurs :*

Les utilisateurs enregistrés sont dans /etc/samba/smbpasswd

Créer un new user "toto" : sbmpasswd -a toto

Pour modifier le mot de passe de "toto" : smbpasswd toto


*Connexion depuis un poste client Windows :*

clic droit sur Poste de Travail / Créer un lecteur réseau / "\\nom_du_serveur\mon_nom"

Cas particulier des clients Windows 8 :
<pre>
Try making the following adjustments on the Windows 8 machine that needs to connect to the Samba share.

This type of problem usually requires that you change the lanman server parameters in order to get Windows 8 working with older servers.

Control Panel - Administrative Tools - Local Security Policy

Local Policies - Security Options

Network security: LAN Manager authentication level
Set to Send LM & NTLM responses only

Set the Minimum session security for NTLM SSP
Disable Require 128-bit encryption

Reboot
</pre>






*Connexion depuis un poste client Mac :*

CMD-K sur une fenetre (finder), puis saisir "smb://hyperion" (ou encore "smb://pallier@hyperion")

Problèmes sur Mavericks (Mac OS 10.9) : http://cammodude.blogspot.fr

Workaround Option 1:

To force your connection to be SMB1, simply type cifs://servername instead of smb://servername when connecting to a Windows or NAS share.  
This is by far easier and requires no real configuration changes.

Workaround Option 2:

To force all connections to be SMB1:

    Open A terminal window
    paste in the following line followed by the return key(should be all on one line):  

<pre>
echo "[default]" >> ~/Library/Preferences/nsmb.conf; 
echo "smb_neg=smb1_only" >> ~/Library/Preferences/nsmb.conf
</pre>
Reboot

This command adds directives to force SMB connections to use the SMB1 protocol.  This is slower but stable.




---

---++ WINDOWS

---+++ Se connecter à un serveur linux en mode graphique

Il s'agit ici de récupérer le bureau complet d'un serveur linux distant sur l'écran de mon pc Windows (ou Linux) depuis le boulot (ou la maison).

*1) L'administrateur du serveur linux doit y avoir installé freenx (yum install freenx)*

C'est fait pour hyperion

*2) Installer sur mon pc Windows (ou linux) un client de connexion au serveur freenx*

Pour Windows, télécharger et installer "NX client for Windows" ici : http://www.nomachine.com/download.php

(ou NX client for Linux pour un pc linux)

(Si nécessaire, voici les instructions d'installation pour le client Windows : http://www.nomachine.com/documents/client/install.html#2)

*3) Exemple : Configurer une session graphique vers hyperion* (depuis le boulot)

Démarrer le "NX Connection Wizard" (un des programmes installés avec le client)

Cliquer sur Next

   * Session : donner un nom à votre session graphique (par exemple "connexion à hyperion depuis le boulot")

   * Host : hyperion.cesr.fr (port 22)

Cliquer sur Next

   * Sélectionner "Unix" et "GNOME"

<!--
   * Cocher "Disable encryption of all traffic" (pour accélerer la connexion)
-->

Cliquer sur Next

   * Cocher "Create shortcut on desktop"

Cliquer sur Next

Une fenetre de connexion s'affiche (que vous pourrez relancer à loisir en cliquant sur votre raccourci bureau portant le nom de votre session)

Cliquer sur "Configure"

   * Cocher "Remember my password"

   * Cliquer sur le bouton Key et y coller l'intégralité de la clé publique suivante à la place de la clé courante :

(pour info, cette clé provient du fichier /etc/nxserver/client.id_dsa.key dans l'installation du serveur freenx)

Par soucis de sécurité, je ne diffuse pas la clé ici (vous l'avez reçue par mail)

   * cliquer sur "Save", puis "Ok" pour revenir à la fenêtre de connexion

Entrer votre login/pass pour hyperion

Cliquer sur "Login"

Et voilà !

(Lorsque votre bureau hyperion s'affiche, répondre à la question posée en choisissant "GNOME")

Si le clavier est qwerty, pour passer à un clavier azerty :

   * aller dans le menu Système / Préférences / Clavier
   * cliquer sur onglet "Agencements"
   * cliquer sur bouton "+ Ajouter"
   * sélectionner France puis cliquer sur Valider
   * sélectionner France puis cliquer sur "Vers le haut"
   * cliquer sur bouton "X Fermer"

(Plus d'information sur la configuration du client ici : http://www.nomachine.com/documents/configuration/client-guide.php)

(pour savoir qui est connecté : ps -efl|grep NX)


*4) C'est très bien tout ça, mais comment je fais depuis chez moi ???*

C'est un peu plus compliqué car il faut installer un tunnel qui passe par le GATEWAY LABO.

*a) Creuser un tunnel*

Sur Windows, on crée le tunnel avec le logiciel Putty

Exécuter Putty

Si vous avez déjà une session vers GATEWAY, inutile d'en recréer une autre, vous pouvez l'utiliser. Sinon, il faut créer une nouvelle session :

Host name : GATEWAY

Port : 22

Saved Sessions : GATEWAY (ou ce que vous voulez, par exemple "le GATEWAY du LABO")

Dans le panneau de gauche (Category:), cliquer sur l'arbre "Connection", puis "SSH", puis "Tunnels"

(si vous avez déjà un ou plusieurs tunnels créés, pas de problème, vous pouvez en ajouter un de plus)

Source Port : 9022

Destination : hyperion.cesr.fr:22

Cliquer sur bouton "Add"

Dans le panneau de gauche (Category:), cliquer sur l'arbre "Session"

Cliquer sur bouton "Save"

Ouvrir cette session (GATEWAY) que vous venez de créer, et se connecter sur GATEWAY (avec votre mot de passe mail).


*b) Créer une session graphique*

Suivre toutes les étapes du point 3) mais en remplaçant "hyperion.cesr.fr (port 22)" par "localhost (port 9022)"

Ya pu ka tester !














---+++ Visualiser les fichiers Postscript

Installer !GhostScript (engine) puis !GhostView (frontend)

http://pages.cs.wisc.edu/~ghost/

---+++ Convertir un fichier Postscript en JPEG (ou autre) avec !GhostScript (en mode batch)

Pour info, sur Linux, c'est très simple, il suffit d'utiliser la commande "convert" (ou plus spécifique "ps2...")

Sous Windows, c'est un peu plus compliqué.

!GhostScript converts PS to PNG, JPEG, PNM, TIFF, BMP, PCX, PSD, PDF, EPS, PCL-XL.

1) Télécharger la version Windows de !GhostScript et l'installer

http://pages.cs.wisc.edu/~ghost/

ou encore:

http://ghostscript.com/releases/

2) Ajouter le dossier exécutable de GhosScript dans votre PATH windows

set PATH=%PATH%;C:\Program Files\gs\gs9.00\bin

3) Exemple de conversion d'un fichier PS en JPG:

Aller dans le dossier qui contient le fichier PS (somefile.ps) à convertir (cd ...)

L'instruction suivante créera un fichier somefile.jpg dans c:\temp :

gswin32c -sDEVICE=jpeg -o c:\temp\somefile.jpg somefile.ps

Pour plus d'information sur les possibilités de !GhostScript : http://pages.cs.wisc.edu/~ghost/doc/cvs/Use.htm

REMARQUE : pour faire la même chose en mode graphique,
il existe une interface graphique qui s'installe par-dessus !GhostScript (en frontend),
c'est !GhostView (gsview) :

http://pages.cs.wisc.edu/~ghost/gsview/index.htm







---+++ Migrer de Windows XP vers Windows 7

Il faut acheter la licence Microsoft. La démarche dépend de la marque du PC.

Pour un hp : aller sur le site hp et rechercher "windows upgrade"

Modèles éligibles : http://h41112.www4.hp.com/promo/win7web/fr/fr/eligmodels.html

http://welcome.hp.com/country/fr/fr/mda/windows7/upgrade/which_version.html?jumpid=reg_R1002_FRFR

http://h41112.www4.hp.com/promo/win7web/fr/fr/




---+++ Envoyer des mails avec Outlook quand on n'est pas au LABO


1) "Creuser" un tunnel avec Putty

Créer une nouvelle session que vous appelerez par exemple "tunnel_mail_LABO",
et qui créera un tunnel entre le port local 9025 et le port SMTP (25) du serveur de mail LABO (GATEWAY).

La procédure est décrite sur la faq informatique du LABO :
http://www1.cesr.fr/intranet/informatique/faq/ssh-tunnels/ssh.htm#_Toc150503764
(Exemple 1, cas numéro 2)

Il faudra lancer cette session (et la garder ouverte en tâche de fond) avant d'envoyer un mail

2) Configurer votre client mail Outlook

   * Menu Outils/Paramètres du compte
   * Clic sur bouton "Modifier"
   * Dans le champ "Serveur de courrier sortant (SMTP)", remplacer "mailhost.cesr.fr" par "localhost"
   * Clic sur bouton "Paramètres supplémentaires...", clic sur onglet "Options avancées"
   * Dans le champ "Serveur Sortant (SMTP)", remplacer "25" par "9025"

Bien sûr, il faut tout remettre en place quand on revient au LABO (en fait, on pourrait aussi fonctionner en permanence avec le tunnel, même au LABO...)


---+++ Synchroniser Outlook 2007 Calendar et Google Calendar

http://content.techrepublic.com.com/2346-10877_11-191016.html 


---+++ Installer un serveur X sur Windows pour afficher les fenêtres graphiques de linux

On propose d'utiliser Xming qui est un serveur X gratuit pour Windows

Il suffit d'éxécuter Xming avant de lancer une session graphique via putty (ou autre shell)

Installation : http://sourceforge.net/projects/xming

Cliquer sur Download

1) Installer Xming

2) Installer Xming-fonts (surtout nécessaire pour Emacs)




---++ HARDWARE

---+++ Disques SATA


Les jumper sur les disque sata ne sont pas la pour specifier si le disque est slave, master ou en cable select
 
mais pour pouvoir brider le disque en sata1 ( dans certain cas ca peut resoudre un probleme de compatibilité)

http://support.seagate.com/kbimg/3178-1.gif

donc pas de jumper == sata2 , le jumper est mis == sata1

Comme il est mis la il est en sata 1 donc bridé à 150Mo/sec
Si on l'enlève on passe en sata2 donc 375Mo/sec
 
Mais comme ton disque ne doit pas dépasser 100Mo/sec tu ne veras pas du tout la difference




---++ GWIS

(should be later moved to : http://planetoweb.cesr.fr/twiki/bin/view/Team/EuroplanetProject)

Réalisation d'un site web générique de projet en s'inspirant du site Europlanet : GWIS (Generic Web Information System)

Il s'agit de concevoir un système d'information web professionnel à l'aide d'un framework Php nommé Cakephp (http://cakephp.org)

Pour cakephp, voir aussi http://bakery.cakephp.org/

Nouvelle version 2.1.1 sortie le 26/3/12 : http://bakery.cakephp.org/articles/lorenzo/2012/03/26/cakephp_2_1_1_and_1_3_15_released

Version 2.1.0 sortie le 5/3/12

Version en cours : http://cakephp.lighthouseapp.com/projects/42648-cakephp/milestones/current

Roadmaps (pas très à jour) : 
   * http://cakephp.lighthouseapp.com/projects/42648/development-roadmap
   * http://cakephp.lighthouseapp.com/projects/42648/2-0-development-roadmap

Code completion for cakephp in Eclipse : http://mark-story.com/posts/view/code-completion-for-cakephp-in-eclipse

---+++ ROADMAP (PLAN OF WORK, CAHIER DES CHARGES)

Ne pas oublier de noter tout ce que tu fais. Rédige au fur et à mesure (avec OpenOffice).

*NOUVELLES MODIFS FAITES :* 

4 juin :
   * VII-3 c) relation 1-1

16 mai :
   * IX-5
   * X - Documentation

15 mai :
   * IX-2 et 3

14 mai :
   * IX-1
   * VI-4

3 mai :

   * section VI-3 (lost password)

   * section IX-1 (logout)

5 Avril :

   * section VII-3 (crud)

Plus tard :

   * (pas encore sûr, à réfléchir) ajouter un script qui permet de définir un tableau de champs obligatoires pour un Modèle donné ==> Ces champs devront obligatoirement être saisis dans les vues associées au Modèle (voir http://book.cakephp.org/1.3/view/1147/required)


---+++++ I - Installation des outils

Serveur web+php+mysql Xampp : Télécharger et installer un serveur web apache/php/mysql avec xampp pour windows, c'est très facile : http://www.apachefriends.org/fr/xampp-windows.html 

Framework php CakePhp : Télécharger et installer cakephp, la version 2.1 (la plus récente, bientôt officielle) 

IDE Eclipse : Télécharger et installer Eclipse + plugin PDT pour php



---+++++ II - Familiarisation avec Cakephp : Lecture documentation + test des tutoriels

http://cakephp.org/ (la doc de la version 2 est ici : http://book.cakephp.org/2.0/en) 

1) Lire le MVC : http://book.cakephp.org/2.0/en/cakephp-overview/understanding-model-view-controller.html 
Lire un peu plus sur le sujet :
- les Controlleurs : http://book.cakephp.org/2.0/en/controllers.html 
- les Vues : http://book.cakephp.org/2.0/en/views.html 
- les Modèles : http://book.cakephp.org/2.0/en/models.html 

2) tester les tutoriels sur le "blog" : 
a) tester le tutoriel cakephp "blog", très simple : http://book.cakephp.org/2.0/en/tutorials-and-examples/blog/blog.html 
b) tester la 2e partie du tutoriel "blog" : http://book.cakephp.org/2.0/en/getting-started.html#blog-tutorial-adding-a-layer 

3) comprendre la génération de code avec l'outil important de cakephp : "bake" 
http://book.cakephp.org/2.0/en/console-and-shells/code-generation-with-bake.html 

4) AUTH et ACL : 

Tester le tutoriel blog avec l'ajout de auth et acl : http://book.cakephp.org/2.0/en/tutorials-and-examples/blog-auth-example/auth.html 

(voir aussi ce tutoriel plus complet : part1 http://book.cakephp.org/2.0/en/tutorials-and-examples/simple-acl-controlled-application/simple-acl-controlled-application.html, part2 http://book.cakephp.org/2.0/en/tutorials-and-examples/simple-acl-controlled-application/part-two.html) 

doc sur AUTH : http://book.cakephp.org/2.0/en/core-libraries/components/authentication.html

doc sur ACL : http://book.cakephp.org/2.0/en/core-libraries/components/access-control-lists.html

5) important aussi, disponible uniquement depuis cakephp 2.1, la gestion des événements : http://book.cakephp.org/2.0/en/core-libraries/events.html 

6) A lire aussi, le cycle de développement complet : 
http://book.cakephp.org/2.0/en/development.html 
surtout lire : 
- Exceptions
- Error Handling
- Debugging
- Testing


---+++++ III - En s'inspirant du tutoriel "blog", commmencer à construire une architecture à partir d'un sous-ensemble de la BDD Europlanet

1) Ce projet est géré en versions avec subversion (plugin Eclipse subclipse)

2) Construire un schéma d'une petite BDD avec MysqlWorkbench
Ce schéma contient 7 tables principales :
- people (lien N-1 avec institutes, status, et profiles, et 1-N avec resources) : id, name, firstname, email, password, status, active, job, created, updated (le champ "active" est un booléen VRAI par défaut)
- status : id, name (avec les valeurs suivantes pour name : NULL, 'registered', 'invalidated', 'validated')
- profiles : id, name, level (level indique la hiérarchie ; name et level ont les valeurs suivantes : {'admin',10}, {'priv',5}, {'validator',3}, {'normal',0} ; donc on a la hiérarchie admin > priv > validator > normal)
- institutes : id, name, created, updated
- expertises : id, name (lien M-N avec people)
- resources (lien M-N avec sciencases) : id, name, created, updated
- sciencecases : id, name, created, updated

Pour gérer les relation M-N, il faudra créer les tables intermédiaires suivantes (voir la convention de nommage dans cakephp : http://book.cakephp.org/2.0/en/models/associations-linking-models-together.html#hasandbelongstomany-habtm) :
   * resources_sciencecases : avec les champs resources_id et sciencecases_id (les 2 clés étrangères formant la clé primaire de la table)
   * expertises_people : avec les champs expertises_id et people_id (les 2 clés étrangères formant la clé primaire de la table)

Tous les champs sont obligatoires (NOT NULL), sauf people.job (default NULL).

Toutes les clés primaires (id) sont autoincrémentées.

Les champs "created" et "updated" sont gérés automatiquement par cakephp.

Ajouter la contrainte "on delete CASCADE" (avec MysqlWorkbench) sur les clés étrangères des tables M-N (resources_sciencecases et expertises_people)

Ajouter la contrainte "on delete NULL" sur toutes les clés étrangères des autres tables (people, resources)

Générer le script sql de création de la base.

Vérifier que MysqlWorkbench ajoute bien les contraintes sur les clés étrangères (FK = "Foreign Key")

Alimenter les tables avec des données quelconques

3) Configurer l'accès à la BDD
login : epn
pass : pass

4) Avec l'outil "bake", construire un premier échafaudage (scaffolding) automatique MVC (modèles, vues, contrôleurs) + tests unitaires PhpUnit
http://book.cakephp.org/2.0/en/console-and-shells/code-generation-with-bake.html
(cake bake project &#8230;)
cake bake model all
cake bake controller all
cake bake view all

Par défaut, l'action "people/index" ne doit afficher que les personnes dont le champ "active" est à TRUE et le champ "status" vaut "validated"

5) Lancer les tests générés par "bake" (avec phpUnit, inclus dans Xampp ?) pour tester les modèles et les contrôleurs
http://book.cakephp.org/2.0/en/development/testing.html
cake bake fixture all ?
cake bake test all ?
Depuis cakephp 2.1 :
Console/cake test app/Model/Post.php
Console/cake test app/Controller/PostsController.php

6) Ajouter la validation des champs de tous les formulaires
http://book.cakephp.org/2.0/en/models/data-validation.html
"bake" ajoute des validations par défaut. Les étendre si nécessaire pour que toutes les validations soient générées automatiquement, en fonction du type des champs.
Vérifier que les champs obligatoires sont bien obligatoires en saisie.
Ajouter un test pour s'assurer qu'une personne est obligée de remplir tous les champs (sauf people.job) quand elle s'enregistre.



---+++++ IV - Gestion du projet avec ICESCRUM

http://planetoweb2.cesr.fr:8080/icescrum

http://www.icescrum.org/

doc plus complète : 

https://www.kagilum.com/fr/blog

ex : https://www.kagilum.com/fr/blog/les-taches-selon-son-role-icescrum/

Un diagramme des classes uml pour décrire SCRUM (intéressant à mettre dans le rapport de stage), et décrivant les 3 types de stories (user, technical et defect) :
http://www.aubryconseil.com/post/Un-%C3%A9l%C3%A9ment-du-backlog-de-produit

diagramme d'état uml pour montrer les différents états d'un élément du backlog (c'est à dire une feature ou une user story ; rappel : une feature = 1 grosse user story qui doit être décomposée en N user stories) :
http://www.aubryconseil.com/post/2007/06/21/251-les-etats-significatifs-d-un-element-de-backlog


---+++++ V - Authentification et Contrôle d'accès

1) Ajouter l'authentification (AUTH) 
Login = email
Auth (et Acl) doivent avoir pour support la table "people" (et status et profiles).
Auth (et Acl) impliquent aussi l'usage des Sessions (http://book.cakephp.org/2.0/en/development/sessions.html)
Astuce : dans la session, stocker l'id de la personne, et non pas son email (car l'email peut changer, mais pas l'id)

Toute personne non authentifiée (accès anonyme) peut :
- lire (R ) toutes les tables, sauf la table "resources"
- s'enregistrer (droit C sur la table people)

Toute personne authentifiée peut :
- lire (R ) toutes les tables (y-compris "resources")
- modifier (U) sa fiche (sauf son profil), mais pas celle des autres
- créer (C ) une ressource
- modifier/supprimer (UD) une ressource qu'elle a créée, mais pas celles des autres
- modifier (U) un institut auquel elle appartient 

Gérer le login et le logout

Ajouter les tests nécessaires :
(Utiliser des "fixtures", cf section "Fixtures" dans http://book.cakephp.org/2.0/en/development/testing.html)
(cake bake fixture all ?)
Tester qu'une personne non authentifiée :
- peut lire la table 'resource'
- peut s'enregistrer
- ne peut pas modifier une table
Tester qu'une personne authentifiée peut :
&#8230;
Faire un test login/logout complet selon le scénario suivant :
- une personne se logue
- vérifier qu'elle peut créer une ressource
- elle se délogue
- vérifier qu'elle ne peut plus créer une ressource


2) Ajouter le contrôle d'accès (ACL)

Créer quelques personnes avec des rôles (profils) différents :
   * 'user1', profil 'admin' (tous les droits)
   * 'user2' et 'user3', profil 'normal', utilisateur normal
   * 'user4', profil 'priv', utilisateur privilégié
   * 'user5', profil 'validator', utilisateur pouvant valider d'autres utilisateurs

Une personne de profil 'admin' a un droit CRUD (créer/lire/modifier/supprimer) sur toutes les tables.

Une personne de profil 'priv' :
   * a un droit CRUD seulement sur la table 'institutes'
   * peut modifier le profil de toutes les personnes (sauf le sien)

Ajouter les tests nécessaires :
   * tester que 'user1' peut tout faire (faire juste quelques tests, pas tout)
   * tester que 'user4' :
     * peut ajouter un nouvel institut
     * peut modifier le profil d'une personne (mais pas le sien)
   * tester que 'user2' :
     * ne peut pas modifier une ressource qui ne lui appartient pas
     * peut ajouter une nouvelle ressource, et la modifier ensuite
     * peut modifier son email (login) et/ou son mot de passe
...


---+++++ VI - ENREGISTREMENT DES UTILISATEURS (registration)

1) Réalisation de la procédure d'enregistrement (inscription) d'une personne :

(voir s'il n'existe pas déjà un plugin cakephp pour gérer ça, car c'est assez classique au début)

a) une personne remplit sa fiche d'enregistrement et la soumet (SUBMIT) ==> elle est enregistrée dans la table people avec "status" à NULL

b) elle reçoit un 1er mail de confirmation avec un lien de validation

c) elle clique sur le lien de validation, ce qui valide son inscription ==> son champ "status" passe à "registered" ; les validateurs reçoivent un mail pour les avertir de cette inscription, avec un lien vers la page du site permettant de valider ou invalider la personne

d) elle reçoit un 2e mail de confirmation lui disant qu'elle est inscrite, MAIS qu'elle doit attendre que son inscription soit validée par un 'validateur', et qu'elle recevra un mail pour le lui confirmer

e) si un validateur valide l'inscription, la personne reçoit un mail pour l'en informer (à partir de là, elle peut se connecter au site) ==> son "status" passe à "validated"

f) si un validateur invalide l'inscription, la personne reçoit un mail pour l'en informer ==> son "status" passe à "invalidated"

Ajouter les actions suivantes au Contrôleur "person" :
   * validate (profil 'validator') : pour valider une personne (champ "status")
   * invalidate (profil 'validator') : pour invalider une personne
   * deleteInvalidated (profil 'priv') : pour supprimer les personnes ayant un statut "invalidated"
   * activate (profil 'priv') : pour activer une personne (champ "active")
   * deactivate (profil 'priv') : pour désactiver une personne

Ajouter/modifier les tests nécessaires

2) Ajouter un captcha sur la fiche d'inscription

Ajouter/modifier les tests nécessaires :
   * tester qu'une personne ne peut pas s'enregistrer si le captcha n'est pas bon
   * tester qu'une personne peut s'enregistrer si le captcha est bon (et tout le reste)


3) Récupération du mot de passe (lost password)

Sur le formulaire de login, ajouter (à droite du bouton LOGIN) un lien "register" (pour s'enregistrer) et un lien "forgot password" (mot de passe oublié)

Le lien "forgot password" pointe vers un formulaire de modification du mot de passe (Person/PasswordUpdate) contenant juste 1 champ "email" et un bouton "SUBMIT"

L'utilisateur saisit son email et clique sur "submit" pour qu'on lui envoie un nouveau mot de passe par mail (le mot de passe est aussi mis à jour dans la database)

Test


4) Procédure de désinscription (ACTION unregister)

a) une personne clique sur un lien "unregister"

b) une confirmation est demandée via une fenêtre javascript : "Are you sure that you want to unregister ?" OK/CANCEL

c) l'action "unregister" est exécutée, la personne n'est pas supprimée de la base, mais juste marquée "inactive"

d) la personne est automatiquement déconnectée

e) Test



   

---+++++ VII - Améliorer le CRUD

1) Bien gérer complètement les relations 1-N

Actions sur Person (relation N-1 avec Institute) :
   * create : doit permettre d'associer la personne à un institut (via liste de noms)
   * update : doit permettre de modifier l'institut associé (via liste de noms)
   * index : doit permettre de voir toutes les personnes avec le nom (name) de l'institut associé ; un clic sur un institut doit amener à sa vue détaillée
   * view : doit afficher le nom (name) de l'institut associé

Action sur Institute (relation 1-N avec Person) :
   * view : doit afficher toutes les personnes associées

2) Bien gérer complètement les relations M-N

Actions sur Person (relation M-N avec Expertise) :
   * create : doit permettre d'ajouter des expertises (ET une date "since")
   * update : doit permettre de modifier les expertises associées
   * view : doit permettre de voir toutes les expertises associées
Idem pour Expertise (lien vers Person)

Même chose pour Resource (relation M-N avec Sciencecase)

Gestion des champs supplémentaires d'une table associative : exemple de la relation entre Person et Expertise :
   
   * expertises_people : avec les champs expertises_id et people_id (les 2 clés étrangères formant la clé primaire de la table) et le champ supplémentaire "since" (date à laquelle l'expertise a été acquise)


3) Gérer d'autres types de relations

a) Ajout de plusieurs rôles différents entre 2 mêmes tables

voir http://book.cakephp.org/2.0/en/models/associations-linking-models-together.html#multiple-relations-to-the-same-model

Une personne peut avoir plusieurs liens avec une ressource (plusieurs liens entre les tables "people" et "resources"), ce qui veut dire qu'elle peut jouer plusieurs rôles par rapport à une ressource.
Ainsi, au lieu d'avoir seulement une clé étrangère "resources_id" dans la table "people", nous en aurons plusieurs avec des noms différents :
   * resource_provider_id : la personne qui a donné l'information sur la ressource (et qui l'a saisit)
   * resource_owner_id : le propriétaire de la ressource
   * resource_contact_id : le contact pour la ressource
Ces 3 clés pointent toutes vers la même clé primaire resource.id, et sont donc des "alias".
Améliorer les actions CRUD en conséquence

b) Relation réflexive (d'une table sur elle-même)

Ajout d'une relation réflexive sur "institutes" (dans ce cas particulier, il s'agit d'une relation hiérarchique) :
   * un institut peut appartenir à un autre institut (de niveau hiérarchique supérieur ; par exemple, le "CNRS" regroupe plusieurs instituts, "l'OMP" regroupe plusieurs laboratoires dont l'IRAP&#8230;)
   * cela revient seulement à ajouter un champ "institute_id" dans la table institutes (qui pointe sur la table institute, lien réflexif)
   * améliorer les actions CRUD en conséquence

c) Relation d'héritage ou spécialisation (1:1)

Une ressource peut être de différents types (ajouter la table "resourcetype") :

   * data
   * info (information, document...)
   * website
   * datacenter

chaque type de ressource est une spécialisation du type général "resource".

On aura donc 4 nouvelles tables filles "resourcedata", "resourceinfo", "resourcewebsite", "resourcedatacenter" qui "hériteront" de la table mère (générique) "resource" pour l'étendre chacune avec sa spécificité.

On peut représenter ce lien d'héritage par une relation 1-1 entre chacune de ces 4 tables filles et la table mère "resource".

Aucune des tables filles n'a d'existence propre, chacune dépend de la table mère "resource".

Ainsi, les tables filles n'ont pas de clé primaire, mais juste une clé étrangère (resource_id) qui pointe vers la clé primaire de la table mère (cette clé étrangère peut aussi leur servir de clé primaire).

Cette relation d'héritage a un impact sur toutes les VUES de la table "resource", car à chaque fois qu'on veut accéder à une ressource, 
il faut récupérer aussi les informations spécifiques à son type dans la table fille associée (via la clé étrangère resource_id).

Plus particulièrement, la vue "Create" (et "Update") devra contenir un sélecteur de type ("Type de ressource"),
et n'afficher que les champs spécifiques au type sélectionné (en plus des champs généraux de la table mère).

Ajouter dans la table resource un champ "URL" (général à tous les types)

Voici les informations spécifiques à chaque type, et donc présent dans les tables filles respectives :

   * table data :
      * volume (en MB) :
      * restricted (oui/non)
   
   * table info (information, document...) :
      * langage (champ texte liste : English, French, Spanish...)

   * table website :
      * restricted (oui/non)
      * nom du webmaster (champ texte libre)

   * table datacenter :
      * nom du responsable (champ texte libre)

4) Ajouter les nouveaux tests nécessaires


---+++++ VIII - Ajout d'une nouvelle action dans TOUS les Contrôleurs : search

ex : Person/search

Cela amène à une nouvelle vue !PersonSearch qui est équivalente au formulaire de Person/create,
sauf qu'au lieu de servir à créer une nouvelle personne, il sert à en CHERCHER.

L'ensemble des personnes trouvées sont affichées dans une vue "FOUND" semblable à Person/index (sauf que c'est une vue PARTIELLE et non pas COMPLETE).
Les recherches se font sans tenir compte des majuscules ou minuscules.

En bas du formulaire, 2 boutons :
   * SEARCH
   * EXACT SEARCH

Exemples de requêtes possibles :

   * j'entre "Pallier" dans le champ "name" :
      * un clic sur "EXACT SEARCH" me donne la liste des personnes dont le nom EST EGAL à "Pallier"
      * un clic sur "SEARCH" me donne la liste des personnes dont le nom CONTIENT "Pallier", par exemple "Apallieri"...
   * j'entre "Pallier" dans le champ "name", "Etienne" dans le champ "firstname", et "informaticien" dans le champ "job" :
      * un clic sur "EXACT SEARCH" me donne la liste des personnes dont le nom EST EGAL à "Pallier" ET le prénom EST EGAL à "Etienne" ET le job EST EGAL à "informaticien"
      * un clic sur "SEARCH" me donne la liste des personnes dont le nom CONTIENT "Pallier" ET le prénom CONTIENT "Etienne" et le job CONTIENT "informaticien"
   
Cette VUE "search" doit être accessible par un lien qui se trouve au début de la vue "index", sous la forme d'une icône en forme de LOUPE suivie de la mention "Search"

Faire les tests d'acceptation (ACCEPTANCE TESTS)


---+++++ IX - Améliorer les vues

1) ajouter les liens généraux suivants :
   * "login" (qui n'apparaît que si l'utilisateur n'est pas logué) 
   * et les liens "logout", "update my registration" et "unregister" (qui n'apparaissent que si l'utilisateur est logué) 

2) Vue "view" : vue détaillée d'une ligne de table

Ajouter une checkbox "Show dates" (visible uniquement avec profil "admin"), désactivée par défaut : quand on l'active, il faut afficher les dates (created, updated)

Ajouter les boutons "Edit", "Delete" et "Create a copy" (visibles uniquement avec le profil "admin")

Pour le formulaire Person, le bouton "Edit" est aussi visible si la personne connectée correspond à la fiche visualisée.

3) Action "index" : vue globale d'une table

Ajouter une checkbox "Show dates" (visible uniquement avec profil "admin"), désactivée par défaut : quand on l'active, il faut afficher les dates (created, updated)

Masquer la clé primaire (id)

La colonne du champ "name" est triable : en cliquant sur la colonne "name", on trie en ordre croissant, puis décroissant

Le champ "name" est cliquable : en cliquant sur un nom, on va à la vue détaillée correspondante

Afficher le champ "name" des clés étrangères ; en cliquant dessus on va sur la vue détaillée

Les colonnes des clés étrangères sont filtrables : dans la vue people/index, en cliquant sur la colonne "institutes_id" on doit pouvoir sélectionner un nom d'institut (name) et filtrer la vue en conséquence

Au-dessus de la liste d'une table, ajouter un "filtre externe" pour chaque table M-N associée :
par exemple, pour la vue people/index, ajouter au-dessus de la liste des personnes une liste d'expertises : en sélectionnant une expertise, on ne voit plus que les personnes associées à cette expertise

En début de page, ajouter un bouton "Add a new one"

4) Ajouter les nouveaux tests nécessaires

5) Ajouter une page contenant tous les tests, avec un bouton permettant de lancer tous les tests à la suite "LAUNCH ALL TESTS"

---+++++ X - Documentation

Installer phpdocumentor v2 et l'intégrer dans eclipse (http://www.phpdoc.org) :
   * http://ugeshgali.blogspot.fr/2011/02/how-to-integrate-phpdocumentor-in.html
   * http://jpablobr.com/past/integration-of-phpdocumentor-into-eclipse-or-aptana-ide
   * http://blog.bsoftco.com/2009/04/24/tutoriel-sur-comment-generer-une-phpdoc-avec-eclipse/

phpdocumentor respecte les standards de codage du format phpdoc : http://en.wikipedia.org/wiki/PHPDoc

Suivre les standards de codage de cakephp 2 : http://book.cakephp.org/2.0/en/contributing/cakephp-coding-conventions.html


---+++++ XI - Ajout d'un menu

Ajout d'une gestion de menu



---+++++ XII - Ajout de modules

Ajout d'un module de News

Ajout d'un module d'upload de documents

Newsletter

...

---+++++ XIII - Charte graphique

Gestion de la présentation avec CSS


...

---+++++ XIV - Intégrer la BDD Europlanet complète



---+++++ Annexe : A lire aussi

Associations : http://book.cakephp.org/2.0/en/models/associations-linking-models-together.html

Callback : http://book.cakephp.org/2.0/en/models/callback-methods.html

Behaviors : http://book.cakephp.org/2.0/en/models/behaviors.html

Transactions : http://book.cakephp.org/2.0/en/models/transactions.html

Virtual fields : http://book.cakephp.org/2.0/en/models/virtual-fields.html










-- Main.EtiennePallier - 25 Dec 2009
Attachments
Topic attachments
I	Attachment	History	Action	Size	Date	Who
pdf	idldoc-reference.pdf	r1	manage	120.0 K	2010-11-09 - 21:28	EtiennePallier
pdf	idldoc-tutorial.pdf	r1	manage	109.7 K	2010-11-09 - 21:27	EtiennePallier
pdf	styleguide.pdf	r1	manage	57.3 K	2010-11-09 - 21:27	EtiennePallier
Topic revision: r119 - 2014-11-03 - EtiennePallier
Main
TWiki Tip of the Day
Inline search
To embed a search in a topic, use the % SEARCH{ parameters TWiki Variable. The search variable is... Read on
Go to Web :
Copyright © 2008-2025 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding PlanetoWiki? Send feedback