10 Configuration de la base de données de rapports

Oracle HSM prend en charge une base de données de rapports facultative qui stocke les informations sur les métadonnées actuelles pour chaque fichier d'un système de fichiers spécifié. Cette base de données sideband peut être d'une aide extrêmement précieuse pour gérer et générer des rapports sur les fichiers et sur les activités des systèmes de fichiers.

L'implémentation de la base de données sideband Oracle HSM est simple. Vous utilisez la commande samdb pour créer et configurer une base de données MySQL à l'aide du schéma de base de données (ou d'une alternative personnalisée) et du fichier de point de récupération fournis générés par la commande samfsdump. Ensuite, les processus du démon Oracle HSM mettent à jour automatiquement la base de données au fur et à mesure que les fichiers correspondants évoluent. Des commandes samdb supplémentaires vous permettent de faire des recherches dans la base de donnés et de la gérer. Pour plus d'informations sur les commandes et options, reportez-vous aux pages de manuel samdb et samdb.conf.

Pour utiliser la fonctionnalité de base de données sideband, effectuez les tâches suivantes :

Installation et configuration du logiciel MySQL Server

Pour activer les fonctionnalités de génération de rapports samdb, vous devez installer et configurer une base de données MySQL. Procédez comme suit :

  1. Téléchargez le Manuel de référence MySQL à l'adresse http://dev.mysql.com/doc/.

    Utilisez la procédure ci-dessous pour identifier les tâches MySQL qui sont requises lors de l'activation de la génération de rapports samdb. Mais veuillez noter que les étapes ci-dessous ne sont pas nécessairement complètes et ne font pas autorité. Utilisez-les comme guide lorsque vous consultez le manuel de référence MySQL.

  2. Connectez-vous en tant qu'utilisateur root au système qui hébergera le serveur MySQL.

    Vous pouvez installer le serveur MySQL sur l'hôte du serveur de métadonnées Oracle HSM ou sur un hôte Solaris ou Linux indépendant.

    Dans l'exemple, nous installons MySQL sur l'hôte Solaris samsql :

    [samsql]root@solaris:~# 
    
  3. Téléchargez et installez le logiciel du serveur MySQL, selon les instructions du manuel de référence MySQL. Activez le démarrage automatique.

  4. Connectez-vous au serveur MySQL à l'aide du client mysql et du compte client root. Exécutez la commande mysql --user=root -p. Lorsque vous y êtes invité, entrez le mot de passe que vous avez défini pour l'utilisateur root au moment de l'installation.

    Le shell de commande mysql démarre :

    [samsql]root@solaris:~# mysql --user=root -p
    Enter Password:
    mysql>
    
  5. Créez l'utilisateur MySQL Oracle HSM. Utilisez la commande CREATE USER 'user_name'@'host_name' IDENTIFIED BY 'user-password', où :

    • user_name est le nom de l'utilisateur MySQL Oracle HSM

    • host_name est le localhost quand MySQL est installé sur l'hôte du serveur de métadonnées Oracle HSM. Sinon, il s'agit du nom d'hôte ou de l'adresse IP du serveur de métadonnées.

    • user-password est le mot de passe que vous attribuez à l'utilisateur MySQL Oracle HSM.

    Dans l'exemple, nous créons l'utilisateur samsql sur le serveur de métadonnées Oracle HSM samqfs1mds. Nous définissons le mot de passe samsqluserpassw0rd à des fins de démonstration (ce ne serait pas un choix sûr pour utiliser une base de données de production) :

    [samsql]root@solaris:~# mysql --user=root
    Enter Password:
    mysql> CREATE USER 'samsql'@'samqfs1mds' IDENTIFIED BY 'samsqluserpassw0rd'
    mysql> 
    
  6. Accordez à l'utilisateur Oracle HSM les privilèges nécessaires. Utilisez la commande GRANT CREATE,DROP,INDEX,SELECT,INSERT,UPDATE,DELETE ON host_name TO 'user_name'@'host_name'.

    Dans l'exemple, nous accordons des privilèges à l'utilisateur samsql sur le serveur de métadonnées samqfs1mds :

    [samsql]root@solaris:~# mysql --user=root -p
    Enter Password:
    mysql> CREATE USER 'samsql'@'host_name' IDENTIFIED BY 'samsqluserpassw0rd'
    mysql> GRANT CREATE,DROP,INDEX,SELECT,INSERT,UPDATE,DELETE ON samqfs1mds TO \ 
    'samsql'@'samqfs1mds'
    mysql> 
    
  7. Fermez l'interface de commande MySQL, et revenez au shell de commande du système d'exploitation. Utilisez la commande MySQL QUIT.

    [samsql]root@solaris:~# mysql --user=root -p
    Enter Password:
    mysql> CREATE USER 'samsql'@'host_name' IDENTIFIED BY 'samsqluserpassw0rd'
    mysql> GRANT CREATE,DROP,INDEX,SELECT,INSERT,UPDATE,DELETE ON samqfs1mds TO \ 
    'samsql'@'samqfs1mds'
    mysql> QUIT
    Bye
    root@solaris:~# 
    
  8. Procédez ensuite à la création d'un fichier de chargement de base de données.

Création d'un fichier de chargement de base de données

  1. Connectez-vous au serveur de métadonnées Oracle HSM en tant qu'utilisateur root.

    Dans l'exemple, nous nous connectons à l'hôte samqfs1mds :

    [samqfs1mds]root@solaris:~# 
    
  2. Si vous disposez déjà d'un fichier de point de récupération en cours, générez le fichier de chargement de base de données à partir du contenu du fichier de point de récupération. Utilisez la commande samfsrestore -SZ output-path-name -f recoverypoint-file, où :

    • -f spécifie recoverypoint-file comme chemin d'accès et nom du fichier d'entrée.

    • -SZ ordonne à la commande d'analyser le fichier de point de récupération et de générer un fichier de chargement de base de données avec le chemin d'accès et le nom de fichier spécifiés par output-path-name.

    Pour plus d'informations, reportez-vous à la page de manuel samfsdump.

    Dans cet exemple, nous utilisons le fichier de point de récupération quotidien, /zfs1/hsmqfs1_recovery/140129, que nous avons planifié lorsque nous avons configuré le système de fichiers samqfs1 (voir la Configuration de la protection du système de fichiers). Nous envoyons la sortie au fichier de chargement de base de données /root/hsmqfs1dataload (notez que la commande ci-dessous est entrée sur une seule ligne ; le saut de ligne est échappé à l'aide de la barre oblique inverse) :

    [samqfs1mds]root@solaris:~# samfsrestore -SZ /root/hsmqfs1dataload -f \
    /zfs1/hsmqfs1_recovery/140129
    
  3. Si vous ne disposez pas d'un fichier de point de récupération en cours, créez dès maintenant un fichier de chargement de base de données. Accédez au répertoire root du système de fichiers Oracle HSM. Exécutez ensuite la commande samfsdump -SZ output-path-name.

    Pour plus d'informations, reportez-vous à la page de manuel samfsdump. Dans cet exemple, nous passons au répertoire /hsmqfs1. Nous envoyons les données de sortie sur le fichier de chargement de base de données /root/hsmqfs1dataload  :

    [samqfs1mds]root@solaris:~# cd /hsmqfs1
    [samqfs1mds]root@solaris:~# samfsdump -SZ /root/hsmqfs1dataload 
    
  4. Procédez ensuite à la création de la base de données sideband.

Création de la base de données sideband

  1. Connectez-vous à l'hôte du serveur MySQL en tant qu'utilisateur root.

    Dans l'exemple, le serveur MySQL est hébergé sur l'hôte Solaris samqfs1mds :

    [samqfs1mds]root@solaris:~# 
    
  2. Dans un éditeur de texte, ouvrez le fichier. /etc/opt/SUNWsamfs/samdb.conf

    Dans l'exemple, nous utilisons l'éditeur de texte vi. Nous commençons par ajouter une ligne d'en-tête comme commentaire :

    [samqfs1mds]root@solaris:~# vi /etc/opt/SUNWsamfs/samdb.conf
            #FS_NAME:HOST:USER:PASSWORD:NAME:PORT:CLIENT_FLAG:MOUNT_POINT
    
  3. Dans la première colonne du fichier samdb.conf, saisissez le nom de famille du système de fichiers suivi de deux points (:) comme séparateur de colonnes.

    Dans l'exemple, nous saisissons le nom de famille samqfs1 :

    [samqfs1mds]root@solaris:~# vi /etc/opt/SUNWsamfs/samdb.conf
    # /etc/opt/SUNWsamfs/samdb.conf
            #FS_NAME:HOST:USER:PASSWORD:NAME:PORT:CLIENT_FLAG:MOUNT_POINT
    samqfs1:
    
  4. Dans la deuxième colonne, saisissez le nom d'hôte pour le serveur de la base de données MySQL, suivi de deux points (:) comme séparateur de colonnes.

    Dans l'exemple, nous co-hébergeons le serveur de la base de données sur l'hôte du serveur des métadonnées Oracle HSM, samqfs1mds. Ainsi, nous entrons le nom d'hôte localhost:

    [samqfs1mds]root@solaris:~# vi /etc/opt/SUNWsamfs/samdb.conf
    # /etc/opt/SUNWsamfs/samdb.conf
            #FS_NAME:HOST:USER:PASSWORD:NAME:PORT:CLIENT_FLAG:MOUNT_POINT
    samqfs1:localhost:
    
  5. Dans la troisième colonne, saisissez le nom d'utilisateur que le logiciel Oracle HSM utilise lors de l'accès à la base de données MySQL suivi de deux points (:) comme séparateur de colonnes.

    Dans l'exemple, nous avons créé l'utilisateur samqfs afin de nous connecter à la base de données :

    [samqfs1mds]root@solaris:~# vi /etc/opt/SUNWsamfs/samdb.conf
    # /etc/opt/SUNWsamfs/samdb.conf
            #FS_NAME:HOST:USER:PASSWORD:NAME:PORT:CLIENT_FLAG:MOUNT_POINT
    samqfs1:localhost:samqfs:
    
  6. Dans la quatrième colonne, saisissez le mot de passe que le logiciel Oracle HSM utilise pour accéder à la base de données MySQL, suivi de deux points (:) comme séparateur de colonnes.

    Dans l'exemple, nous utilisons un faux mot de passe Pˆssw0rd :

    [samqfs1mds]root@solaris:~# vi /etc/opt/SUNWsamfs/samdb.conf
    # /etc/opt/SUNWsamfs/samdb.conf
            #FS_NAME:HOST:USER:PASSWORD:NAME:PORT:CLIENT_FLAG:MOUNT_POINT
    samqfs1:localhost:samqfs:Pˆssw0rd:
    
  7. Dans la cinquième colonne, saisissez le nom de la base de données MySQL, suivi de deux points (:) comme séparateur de colonnes.

    Dans l'exemple, nous nommons la base de données samqfs1db :

    [samqfs1mds]root@solaris:~# vi /etc/opt/SUNWsamfs/samdb.conf
    # /etc/opt/SUNWsamfs/samdb.conf
            #FS_NAME:HOST:USER:PASSWORD:NAME:PORT:CLIENT_FLAG:MOUNT_POINT
    samqfs1:localhost:samqfs:Pˆssw0rd:samqfs1db:
    
  8. Dans la sixième colonne, saisissez le port TCP/IP du serveur de la base de données, suivi de deux points (:) comme séparateur de colonnes.

    Dans l'exemple, nous saisissons 0 (zéro). Si nous utilisions un serveur distant, une valeur nulle (ou vide) spécifierait le port par défaut, 3306. Mais comme nous utilisons localhost, la valeur nulle sert simplement de paramètre substituable :

    [samqfs1mds]root@solaris:~# vi /etc/opt/SUNWsamfs/samdb.conf
    # /etc/opt/SUNWsamfs/samdb.conf
            #FS_NAME:HOST:USER:PASSWORD:NAME:PORT:CLIENT_FLAG:MOUNT_POINT
    samqfs1:localhost:samqfs:Pˆssw0rd:samqfs1db:0:
    
  9. Dans la septième colonne, saisissez un indicateur de client MySQL, suivi de deux points (:) comme séparateur de colonnes.

    L'indicateur de client MySQL est généralement défini sur 0 (zéro). Mais différentes combinaisons de valeurs peuvent être définies pour activer des fonctionnalités MySQL spécifiques. Pour plus d'informations, reportez-vous à la documentation MySQL de la fonction mysql_real_connect().

    Dans l'exemple, nous saisissons 0 (zéro) :

    [samqfs1mds]root@solaris:~# vi /etc/opt/SUNWsamfs/samdb.conf
    # /etc/opt/SUNWsamfs/samdb.conf
            #FS_NAME:HOST:USER:PASSWORD:NAME:PORT:CLIENT_FLAG:MOUNT_POINT
    samqfs1:localhost:samqfs:Pˆssw0rd:samqfs1db:0:0:
    
  10. Dans la huitième et dernière colonne, saisissez le point de montage du système de fichiers Oracle HSM. Enregistrez le fichier et fermez l'éditeur de texte.

    Dans cet exemple, le système de fichiers est monté sur /hsmqfs/hsmqfs1 :

    [samqfs1mds]root@solaris:~# vi /etc/opt/SUNWsamfs/samdb.conf
    # /etc/opt/SUNWsamfs/samdb.conf
            #FS_NAME:HOST:USER:PASSWORD:NAME:PORT:CLIENT_FLAG:MOUNT_POINT
    samqfs1:localhost:samqfs:Pˆssw0rd:samqfs1db:0:0:/hsmqfs/hsmqfs1
    :wq
    [samqfs1mds]root@solaris:~# 
    
  11. Créez une nouvelle base de données et les tables associées. Utilisez la commande samdb create family_set, où family_set est le nom de famille spécifié pour le système de fichiers Oracle HSM dans le fichier /etc/opt/SUNWsamfs/mcf.

    Le schéma de la base de données par défaut est /opt/SUNWsamfs/etc/samdb.schema. Vous pouvez indiquer une autre option en saisissant la commande en tant que samdb create family_set -s schema, où schema est le chemin d'accès et le nom d'un fichier de schéma.

    Dans l'exemple, nous utilisons le schéma par défaut pour créer une base de données pour la famille du système de fichiers samqfs1.

    [samqfs1mds]root@solaris:~# samdb create samqfs1 
    
  12. Remplissez la base de données à l'aide des données contenues dans le fichier de chargement de base de données que vous avez créé dans la procédure précédente. Utilisez la commande samdb load family_set input_file, où family_set est le nom de famille spécifié pour le système de fichiers dans le fichier /etc/opt/SUNWsamfs/mcf et input_file est le chemin d'accès et le nom du fichier de chargement de la base de données.

    Dans cet exemple, nous chargeons la base de données pour la famille des systèmes de fichiers samqfs1 à l'aide du fichier de chargement de base de données /root/hsmqfs1dataload.

    [samqfs1mds]root@solaris:~# samdb load samqfs1 /root/hsmqfs1dataload
    
  13. Vérifiez la cohérence de la base de données. Utilisez la commande samdb check family_set, où family_set est le nom de famille spécifié pour le système de fichiers dans le fichier /etc/opt/SUNWsamfs/mcf.

    La commande samdb check compare les entrées de la base de données avec les métadonnées des systèmes de fichiers en cours. Elle remarque et, si possible, corrige les incohérences qui peuvent apparaître pendant le processus de chargement.

    Dans cet exemple, nous chargeons la base de données pour la famille des systèmes de fichiers samqfs1 à l'aide du fichier de chargement de base de données /root/hsmqfs1dataload.

    [samqfs1mds]root@solaris:~# samdb check samqfs1
    
  14. Procédez ensuite au montage du système de fichiers Oracle HSM avec prise en charge de base de données activée.

Montage du système de fichiers Oracle HSM avec prise en charge de base de données activée

  1. Connectez-vous au serveur de métadonnées Oracle HSM en tant qu'utilisateur root.

    [samqfs1mds]root@solaris:~#  
    
  2. Sauvegardez le fichier /etc/vfstab.

    [samqfs1mds]root@solaris:~# cp /etc/vfstab /etc/vfstab.backup
    
  3. Ouvrez le fichier /etc/vfstab dans un éditeur de texte, descendez jusqu'à l'entrée du système de fichiers pour lequel vous avez créé la base de données.

    Dans l'exemple, nous utilisons l'éditeur de texte vi. Nous descendons jusqu'à l'entrée du système de fichiers samqfs1 :

    [samqfs1mds]root@solaris:~# vi /etc/vfstab 
    #File
    #Device    Device   Mount     System  fsck  Mount    Mount
    #to Mount  to fsck  Point     Type    Pass  at Boot  Options
    #--------  -------  --------  ------  ----  -------  -------------------------
    /devices   -        /devices  devfs   -     no       -
    ...
    samqfs1    -        /hsmqfs1  samfs   -     yes      ... ,partial=64
    
  4. Dans la dernière colonne du fichier /etc/vfstab, ajoutez sam_db à la liste des options de montage du système de fichiers. Ensuite, enregistrez le fichier et fermez l'éditeur de texte.

    Dans l'exemple, activez la base de données sideband sur le système de fichiers samqfs1 :

    [samqfs1mds]root@solaris:~# vi /etc/vfstab 
    #File
    #Device    Device   Mount     System  fsck  Mount    Mount
    #to Mount  to fsck  Point     Type    Pass  at Boot  Options
    #--------  -------  --------  ------  ----  -------  -------------------------
    /devices   -        /devices  devfs   -     no       -
    ...
    samqfs1    -        /hsmqfs1  samfs   -     yes      ... ,partial=64,sam_db
    :wq
    root@solaris:~# 
    
  5. Montez le système de fichiers d'archivage Oracle HSM.

    Lorsqu'un système de fichiers est monté avec l'option sam_db, le logiciel Oracle HSM démarre les processus qui mettent à jour la base de données sideband.

    Dans cet exemple, nous montons le système de fichiers /hsmqfs1 :

    [samqfs1mds]root@solaris:~# mount /hsmqfs1
    
  6. Passez ensuite à Configuration des notifications et de la journalisation