Exécution de l'utilitaire ddlGen

Vous pouvez générer un langage de définition de données (DDL) si des fonctions de la configuration serveur nécessitent un accès à une base de données.

Avant de commencer

Effectuez les étapes suivantes avant d'exécuter l'utilitaire ddlGen :
  1. Démarrez le serveur.
  2. Exportez le code JAVA_HOME=<java64_path>, où <java64_path> est le chemin d'un SDK Java 8.0 64 bits.
  3. Exportez le code PATH=$JAVA_HOME/bin:$PATH. A présent, l'utilitaire ddlGen peut trouver Java.
  4. Exportez le code WLP_USER_DIR=<wlp_path>, où <wlp_path> représente le chemin menant à la racine de la configuration du serveur Liberty. Par exemple, si server1 est configuré à l'emplacement /wlpconfig/servers/server1, la valeur de WLP_USER_DIR sera /wlpconfig.
  5. Si le serveur est configuré pour écrire sa sortie à un emplacement différent, défini par le code WLP_OUTPUT_DIR=<output_path> dans le fichier server.env, exportez également ce code avant d'exécuter l'utilitaire ddlGen. Faute de quoi, ddlGen échouera avec le message suivant : CWWKD0101E: The server named <server> is not configured to accept local JMX requests.

Pourquoi et quand exécuter cette tâche

L'utilitaire génère un langage de définition de données (DDL) pour chaque fonction configurée sur le serveur qui requiert un accès à une base de données. Vous pouvez modifier le chemin d'accès employé par l'utilitaire ddlGen pour la recherche du serveur en exportant la variable d'environnement, WLP_USER_DIR, sur la ligne de commande depuis laquelle l'utilitaire est exécuté.

Procédure

  1. Dans le fichier server.xml, ajoutez la fonction localConnector-1.0 sous la balise featureManager.
    <featureManager>
         <feature>localConnector-1.0</feature>
    </featureManager>
  2. En ligne de commande, exécutez la commande wlp/bin/ddlGen {generate|help} <server_name>, où <server_name> est le nom du serveur pour lequel vous voulez générer un langage de définition de données (DDL).

Résultats

Le tableau ci-dessous répertorie les codes différents de zéro qui peuvent être renvoyés :

Tableau 1. Codes retour et explications pour l'utilitaire ddlGen
Code retour Explication
0 Réussite. Le langage de définition de données est généré dans ${server.output.dir}/ddl.
20 L'action fournie est incorrecte.
21 Le serveur est introuvable. le message CWWKD0100E indique le répertoire de système de fichiers dans lequel l'utilitaire a recherché le serveur. Cet emplacement peut être modifié par l'exportation de la variable, WLP_USER_DIR, à partir de la ligne de commande depuis laquelle l'utilitaire est exécuté.
22 La fonction localConnector n'est pas présente dans la configuration de serveur ou le serveur n'a pas été démarré.
23 Le bean géré qui génère le langage de définition de données est introuvable.
24 Le bean géré qui génère le langage de définition de données a signalé une erreur. Les journaux serveur contiennent des détails supplémentaires sur l'erreur.
255 Une erreur inattendue est survenue.

Icône indiquant le type de rubrique Rubrique Tâche

Nom du fichier : twlp_ddlgen.html