Guide d'utilisation et de référence


Vérification de l'installation

Après avoir installé DB2 Extension Spatiale, créez une base de données, puis exécutez le programme de vérification de l'installation pour vous assurer que DB2 Extension Spatiale a été installé et configuré correctement.

Remarque :
Pour les installations sous AIX, assurez-vous que vous avez défini l'environnement d'instance de DB2 Extension Spatiale avant d'exécuter le programme de vérification de l'installation.

Pour vérifier l'installation, vous pouvez utiliser le programme exemple DB2 Extension Spatiale (runGseDemo). Les paramètres de configuration de la base de données peuvent être modifiés à partir de la ligne de commande avec les outils DB2 ou avec l'interface utilisateur du Centre de contrôle DB2. Les instructions qui suivent concernent AIX, Windows NT et Windows 2000.

Pour vérifier l'installation, procédez comme suit :

  1. Connectez-vous en tant que propriétaire de l'instance (AIX uniquement).
  2. Dans la configuration du gestionnaire de bases de données, augmentez la mémoire UDF de 2048 au minimum. Par exemple, tapez db2 update dbm cfg using UDF_MEM_SZ 2048. Si la valeur 2048 est inadéquate, augmentez la valeur du paramètre UDF_MEM_SZ par incréments de 256.
    Remarque :
    Les besoins en mémoire UDF augmentent en proportion du nombre de fonctions UDF utilisées dans une application, particulièrement lorsque des fonctions UDF spatiales avec des types de données spatiales sont utilisées comme paramètres d'entrée et/ou de sortie.
  3. Créez une base de données. Par exemple, tapez db2 create database mabd, où mabd représente le nom de votre base de données.
  4. Augmentez la taille du fichier journal DB2 pour votre base de données.

    Pour ce faire, procédez comme suit :

    1. Connectez-vous à la base de données que vous venez de créer. Par exemple, tapez db2 connect to mabd, où mabd représente le nom de votre base de données.
    2. Augmentez la taille du fichier journal. Par exemple, tapez db2 update db logfilesize using LOGFILE 1000.
    3. Déconnectez-vous de votre base de données. Par exemple, tapez db2 connect reset.
    Remarque :
    Vous devez augmenter la taille du fichier journal DB2 pour chaque base de données que vous activez pour la prise en charge des données spatiales.
  5. Localisez le programme de vérification de l'installation. Par exemple, tapez runGseDemo.

    Sous AIX, tapez cd $HOME/sqllib/samples/spatial, où $HOME représente le répertoire personnel du propriétaire de l'instance.

    Sous Windows NT et Windows 2000, tapez cd c:\sqllib\samples\spatial, où c:\sqllib représente le répertoire d'installation de DB2 Extension Spatiale.

  6. Exécutez le programme de vérification de l'installation. Par exemple, tapez :
    runGseDemo mabd IDutil mot_de_passe
    

    Le paramètre mabd représente le nom de la base de données.

Conseils d'identification et de résolution des incidents d'utilisation du programme exemple

Le programme exemple DB2 est conçu pour détecter les anomalies éventuelles de votre installation. Pendant la vérification de l'installation, il se peut que vous receviez des messages d'erreur qui pourront vous aider à diagnostiquer des incidents système particuliers. La plupart de ces messages sont dus à un petit nombre d'erreurs classiques commises par l'utilisateur. Pour les éviter, respectez les règles suivantes chaque fois que vous exécutez le programme de vérification de l'installation :

Client d'administration

Si vous n'avez pas sélectionné l'option DB2 Administration Client (pour les installations sous Windows NT) ou l'option Client DB2 Extension Spatiale (pour les installations sous AIX) lors de l'installation de DB2 Extension Spatiale, vous recevez le message d'erreur suivant : "Le nom indiqué n'est pas reconnu comme une commande interne ou externe, un programme exécutable ou un fichier par lots".

Cette erreur est due au fait que le programme exemple n'est pas disponible sur votre système. Le programme exemple est installé en même temps que le client DB2 Administration Client et le client DB2 Extension Spatiale. Si aucun de ces logiciels n'est installé sur votre système, le programme exemple n'est donc pas disponible.

Pour résoudre cet incident, procédez comme suit :

  1. Réinstallez DB2 Extension Spatiale. Sélectionnez DB2 Administration Client dans le programme d'installation sous Windows NT ou Windows 2000, ou Client DB2 Extension Spatiale dans le programme d'installation de DB2 sous AIX.
  2. Exécutez de nouveau le programme exemple en suivant les étapes décrites à la section Vérification de l'installation.

Base de données déjà activée pour les données spatiales

Si la base de données que vous utilisez avec le programme exemple est déjà activée pour les données spatiales, vous recevez le message d'erreur suivant :

Activation de logtst pour la base de données...
Retour de ENABLE_DB :
Code retour = -14
Texte du message renvoyé =
GSE0014E  La base de données a déjà été activée pour des opérations spatiales.
 

Pour résoudre cet incident, supprimez la base de données et répétez les étapes décrites à la section Vérification de l'installation.

Remarque :
Assurez-vous que la base de données dont vous vérifiez l'installation est bien nouvelle et qu'aucune opération spatiale n'y est associée. Si tel n'est pas le cas, le programme exemple échouera.

Configuration du gestionnaire de bases de données

Si vous n'augmentez pas la taille de la mémoire UDF dans la configuration du gestionnaire de bases de données, vous recevez le message d'erreur suivant :

Une erreur SQL inattendue ("SQL0973N  Pas assez d'espace disponible dans
la mémoire dynamique "UDF_MEM" pour traiter l'instruction.") s'est produite.  SQLSTATE=57011

Pour savoir comment augmenter la taille de la mémoire UDF dans la configuration du gestionnaire de bases de données, reportez-vous à l'étape 2 de la section Vérification de l'installation.

Taille du fichier journal

Si vous n'augmentez pas la taille du fichier journal, vous recevez le message d'erreur suivant :

Activation de logtst pour la base de données...
Retour de ENABLE_DB :
 Code retour = -8
Texte du message renvoyé =
GSE0008E  Une erreur SQL inattendue ("SQL3306N  Une erreur SQL "-964"
s'est produite lors de l'insertion d'une ligne dans   ") s'est produite.

Pour savoir comment augmenter la taille du fichier journal, reportez-vous à l'étape 4 de la section Vérification de l'installation.


[ Début de page | Page précédente | Page suivante | Table des matières | Index ]