F.3. Obtenir les sources via CVSup

F.3.1. Préparer un système client CVSup

Deux groupes de répertoires sont nécessaires à CVSup : un répertoire contenant le référentiel CVS local (ou simplement un groupe de répertoires si vous ne récupérez qu'un extrait plutôt que le référentiel complet ; voir plus loin) et une zone dans laquelle CVSup enregistre ses propres données. Ces deux groupes de répertoires peuvent coexister dans la même arborescence.

Décidez où vous souhaitez garder votre copie locale du référentiel CVS. Sur un de nos systèmes, nous avons récemment créé un référentiel dans /home/cvs/, mais nous avions jusque là utilisé /opt/postgres/cvs/ comme arbre de développement pour PostgreSQL. Si vous souhaitez placer votre référentiel dans /home/cvs/, alors ajoutez

setenv CVSROOT /home/cvs
    

dans votre fichier .cshrc, ou une ligne similaire dans votre .bashrc ou dans votre .profile, en fonction de votre interpréteur de commandes (shell).

La zone de référentiel de cvs doit être initialisée. Une fois que CVSROOT est initialisée, il suffit de faire :

$ cvs init
    

après quoi vous devriez au moins voir un répertoire CVSROOT en listant le répertoire CVSROOT :

$ ls $CVSROOT
CVSROOT/
    

F.3.2. Utiliser un client CVSup

Vérifiez que cvsup est dans votre chemin. Sur la plupart des systèmes, cela se fait en tapant

which cvsup
    

Puis, lancez simplement cvsup en faisant :

$ cvsup -L 2 postgres.cvsup
    

où -L 2 active certains messages de statut pour vous permettre de suivre le progrès pour la mise à jour et postgres.cvsup est la chemin et le nom que vous avez donné à votre fichier de configuration CVSup.

Voici un fichier de configuration CVSup modifié pour une installation spécifique, et maintient un référentiel CVS local complet.

# Ce fichier représente le fichier de distribution CVSup standard
# pour le projet de SGBDRO PostgreSQL
# Modifié par lockart@fourpalms.org 1997-08-28
# - Pointe vers mon arborescence de référence locale
# - Extrait le référentiel CVS complet, pas seulement la
#   dernière version
#
#Valeurs par défaut qui s'appliquent à toutes les collections
*default host=cvsup.postgresql.org
*default compress
*default release=cvs
*default delete use-rel-suffix
# Activez la ligne suivante pour récupérer la dernière version
#*default tag=.
# Activez la ligne suivante récupérer ce qui est précisé en dessus ou 
# par défaut à la date précisée en dessous
#*default date=97.08.29.00.00.00

# répertoire de base où CVSup stocke ses fichiers 'marque page'
# créera un sous répertoire sup/
#*default base=/opt/postgres # /usr/local/pgsql
*default base=/home/cvs

# répertoire préfixe où CVSup stocke les distributions.
*default prefix=/home/cvs

# Distribution complète, avec tout ce qui est en dessous
pgsql

# distributions partielles
# pgsql-doc
# pgsql-perl5
# pgsql-src

   

Si vous indiquez repository au lieu de pgsql dans la configuration précédente, vous obtiendrez une copie complète du dépôt sur cvsup.postgresql.org, incluant son répertoire CVSROOT. Si vous faites cela, vous voudrez probablement exclure ces fichiers du répertoire que vous voulez modifier localement, en utilisant un fichier nommé refuse. Par exemple, pour la configuration précédente, vous auriez pu placer ceci dans /home/cvs/sup/repository/refuse :

CVSROOT/config*
CVSROOT/commitinfo*
CVSROOT/loginfo*

Voir les pages man de CVSup pour savoir comment utiliser les fichiers refuse.

Ce qui suit est une suggestion de fichier de configuration CVSup issu du site ftp de PostgreSQL, qui ne récupère que la version courante :

# Ce fichier représente la distribution CVSup standard pour le
# projet de SGBDRO PostgreSQL.
#
# Valeurs par défaut qui d'appliquent à toutes les collections.
*default host=cvsup.postgresql.org
*default compress
*default release=cvs
*default delete use-rel-suffix
*default tag=.

# répertoire de base où CVSup stocke ses fichiers 'marque page'
*default base=/usr/local/pgsql

# répertoire préfixe où CVSup stocke les distributions.
*default prefix=/usr/local/pgsql

# Distribution complète, avec tout ce qui est en dessous
pgsql

# distributions partielles
# pgsql-doc
# pgsql-perl5
# pgsql-src

    

F.3.3. Installer CVSup

CVSup est disponible sous forme de fichiers source, de binaires pré-compilés ou de RPM Linux. Il est beaucoup plus simple d'utiliser les binaires plutôt que de compiler les sources, principalement parce que cela nécessite le compilateur Modula-3, qui est très puissant mais volumineux.

F.3.4. Installation à partir des sources

Installer CVSup n'est pas entièrement trivial, principalement parce que la plupart des systèmes auront besoin du compilateur Modula-3. Ce compilateur est disponible sous forme de RPM Linux, de paquetage FreeBSD ou de code source.