Vous êtes ici : Accueil → Support → Documentation → Manuels de référence → Installation et utilisation de zoperepository

Installation et utilisation de zoperepository

Note: Ceci est une impression contenant toutes les pages du Manuel de référence sur une seule page. La version paginée est disponible ici.

Ce manuel à pour but de vous donner les différentes étapes afin de pouvoir utiliser les scripts repris dans le produit zoperepository.

1. Installation

Contient les différentes étapes pour installer zoperepository ainsi que les outils dont on a besoin.

1.1. A quoi sert ZopeRepository ?

Zoperepository est un produit permettant de recueillir des informations concernant les instances Zope installées, les sites Plone, les produits utilisés et la configuration Apache.

 

Pour se faire, il est nécessaire de lancer certains scripts du produit, qui remplissent des tables PostgreSQL.

 

Il existe 2 scripts dans le répertoire .../zoperepository/scripts :

  • apache_repository_db.sh : permet de remplir les tables reprises en bleu ci-dessous.
  • zope_repository_db.sh : permet de remplir les tables reprises en noir ci-dessous.

 

Actuellement, les tables existantes sont :

  • apaches : contient les informations relatives aux serveurs apache utilisés (le nom, le fichier de configuration,...)
  • instances : contient les informations relatives aux instances Zope (le nom, le port utilisé, la version de Plone)
  • instances_products : contient les informations relatives aux produits disponibles par instance Zope (différence avec le svn, adresse du svn utilisé, ...)
  • mountpoints : contient les informations relatives aux points de montage (le nom du fichier fs, la taille, le chemin,...)
  • plonesites : contient les informations relatives aux différents sites plone se trouvant dans l'instance (le nom, le chemin,...)
  • plonesites_products : contient les informations relatives aux différents produits installés par site Plone (le numéro du produit, le statut,...)
  • products : contient le nom des différents produits présents sur le système de fichier
  • rewrites : contient les informations relatives aux rewrite rules d'apache (le port, le protocole, le domaine,...)
  • servers : contient les informations relatives aux serveurs analysés (le nom, l'adresse ip, ...)
  • virtualhosts : contient les informations relatives aux virtualhosts définis dans apache (le nom du serveur, la redirection, l'adresse IP de l'hôte virtuel,...).

 

Le fichier INSTANCES.txt doit contenir les  chemins des instances Zope à analyser.

 

1.2. Outils annexes à installer

Les outils nécessaires au bon fonctionnement de ZopeRepository

PostgreSQL

 Les données collectées via le produit ZopeRepository étant injectées dans une base de données PostgreSQL, il est nécessaire de l'installer sur votre serveur Zope.

Vous trouverez plus d'informations concernant la procédure d'installation à la page suivante : Installation PostgreSQL.

 

PGAdmin III

Pour faciliter la gestion de votre base de donnée, vous pouvez installer le logiciel PGAdmin III.

 Pour plus de détails : Travailler sur la DB.

 

1.3. Installation

Pour installer le produit ZopeRepository, il suffit de suivre la procédure mentionnée dans le fichier readme.txt de notre svn.

 

2. Comment utiliser ZopeRepository

L'utilisation se fait en deux étapes :

Alimentation de la DB zoperepos à l'aide des scripts

 

L'utilisation du produit se fait en exécutant les scripts disponibles.

Avant d'exécuter les scripts pour la première fois, vous devez les éditer afin de vous assurer que la ligne contenant le chemin d'accès au python utilisé et le chemin d'accès à votre produit correspondent bien à votre installation.

Pour exécuter le script recueillant les informations du serveur apache, il suffit de se placer dans le répertoire contenant le script apache_repository_db.sh et de taper ./apache_repository_db.sh.

Pour exécuter celui recueillant les autres informations, il suffit de se placer dans le même répertoire et de taper ./zope_repository_db.sh

Ces deux scripts peuvent également être lancés automatiquement chaque nuit.

Dès que le script a fini de travailler, les données récoltées se retrouvent dans les tables de la base de donnée zoperepos.

 

Consultation des résultats (repository et erreurs de configuration détectées)

 

Pour pouvoir visualiser les résultats, il faut incorporer dans un dossier particulier une série de templates présentes dans le produit.

Cette installation peut être automatisée grâce à un script. 

Dans un répertoire créé dans votre instance Zope:

A l'intérieur de celui-ci, vous ajoutez une méthode externe avec les paramètres suivants :

Id : mettez un nom significatif (ie. addGuiFiles, ZopeRepositoryEM, ...)

Title : [facultatif]

Module name : ZopeRepository.utils

Function name : add_Gui_Files

 

Dès que la méthode est créée, il suffit de l'exécuter (via l'onglet test) pour que celle-ci crée automatiquement dans le dossier contenant la méthode externe, l'environnement nécessaire à la visualisation des différentes pages.

Il faut ensuite modifier l'élément "server_connection" afin de changer le mot de passe éventuel à la db.

 

Le point de départ pour la visualisation est le fichier index_html.