Utilitaires Unica Platform

Cette section fournit une présentation des utilitaires Unica Platform, notamment des détails qui s'appliquent à tous les utilitaires et qui ne sont pas inclus dans les descriptions individuelles des utilitaires.

Emplacement des utilitaires

Les utilitaires Unica Platform se trouvent dans le répertoire tools/bin sous votre installation de Unica Platform.

Liste et descriptions des utilitaires

Unica Platform fournit les utilitaires suivants.

  • Clientdetails - Génère une clé pour une application client telle que Unica Journey pour s’authentifier auprès d’une instance Unica Platform.
  • alertConfigTool : enregistre les alertes et les configurations définies pour les produits Unica
  • configTool : importe, exporte et supprime les paramètres de configuration, y compris les enregistrements de produits
  • datafilteringScriptTool : crée des filtres de données
  • encryptPasswords : chiffre et stocke les mots de passe
  • encryptTomcatDBPasswords : chiffre les mots de passe de base de données que le serveur d'applications Tomcat utilise en interne
  • partitionTool : crée les entrées de base de données pour les partitions
  • populateDb : remplit la base de données Unica Platform
  • quartzjobtool - Met à jour les travaux du planificateur créés dans la version 11.1 et dans les versions ultérieures
  • restoreAccess : restaure un utilisateur avec le rôle platformAdminRole
  • scheduler_console_client : répertorie et démarre les travaux du planificateur d'Unica qui sont configurés pour écouter un déclencheur.
  • insightsdbutil - Le programme d'installation place les fichiers de conception de rapport qui possèdent des jetons de connexion à la base de données. Vous devez les mettre à jour pour la base de données de votre système. Vous devez exécuter l'utilitaire insightsdbutil.sh/bat pour la mettre à jour. Pour en savoir plus, consultez le document Unica Insights - Guide d'installation et de configuration.

Conditions requises pour l'exécution des utilitaires Unica Platform

Les conditions requises pour l'exécution de tous les utilitaires Unica Platform sont les suivantes.

  • Exécutez tous les utilitaires depuis le répertoire où ils se trouvent (par défaut, le répertoire tools/bin sous votre installation de Unica Platform).
  • Sous UNIX™, la meilleure pratique consiste à exécuter les utilitaires avec le même compte utilisateur que celui exécutant le serveur d'applications sur lequel Unica Platform est déployé. Si vous exécutez un utilitaire avec un autre compte utilisateur, réglez les droits au niveau du fichier platform.log pour permettre au compte utilisateur d'y accéder en écriture. Si vous ne réglez pas les droits, l'utilitaire n'est pas en mesure d'écrire dans le fichier journal et vous pourriez rencontrer certains messages d'erreur, bien que l'outil fonctionne toujours correctement.

Authentification des utilitaires

Les utilitaires tels que configTool ou les utilitaires d'arrière-plan Unica sont conçus pour être utilisés par des administrateurs système et exigent un accès physique aux serveurs hôtes pour pouvoir être appelés. C'est pourquoi leur authentification a été conçue pour être indépendante du mécanisme d'authentification de l'interface utilisateur. L'accès à ces utilitaires est disponible aux utilisateurs disposant de droits d'administrateur Unica Platform. Il doit être défini en interne dans Unica Platform et authentifié par rapport aux mêmes conditions.

Dépannage des problèmes de connexion

Tous les utilitaires Unica Platform, sauf encryptPasswords, interagissent avec les tables système Unica Platform. Pour vous connecter à la base de données des tables système, ces utilitaires utilisent les informations de connexion suivantes qui sont définies par le programme d'installation à l'aide des informations fournies lors de l'installation de Unica Platform. Ces informations sont stockées dans le fichier jdbc.properties, situé dans le répertoire tools/bin sous votre installation de Unica Platform.

  • Nom du pilote JDBC
  • URL de connexion JDBC (qui inclut l'hôte, le port et le nom de la base de données)
  • Identifiant de connexion à la source de données
  • Mot de passe de la source de données (chiffré)

En outre, ces utilitaires se basent sur la variable d'environnement JAVA_HOME, définie soit dans le script setenv situé dans le répertoire tools/bin de votre installation de Unica Platform, soit sur la ligne de commande. Le programme d'installation de Unica Platform doit avoir défini cette variable automatiquement dans le script setenv, mais il s'agit également d'une bonne pratique que de vérifier que la variable JAVA_HOME est définie si vous rencontrez un problème d'exécution d'un utilitaire. Le kit JDK doit être la version de Sun (et non, par exemple, le kit JDK JRockit disponible avec WebLogic).

Caractères spéciaux

Les caractères désignés comme caractères réservés dans le système d'exploitation doivent être évités. Consultez la documentation de votre système d'exploitation pour obtenir une liste des caractères réservés et comment les éviter.

Options standard des utilitaires Unica Platform

Les options suivantes sont disponibles dans tous les utilitaires Unica Platform.

-l logLevel

Définit le niveau des informations de journal affichées dans la console. Les options sont high (haut), medium (moyen) et low (bas). La valeur par défaut est low.

-L

Définit les paramètres régionaux pour les messages de la console. Les paramètres régionaux par défaut sont en_US. Les valeurs disponibles sont déterminées par les langues dans lesquelles Unica Platform a été traduit. Spécifiez les paramètres régionaux à l'aide de l'identificateur des paramètres régionaux ICU, conformément aux normes ISO 639-1 et ISO 3166.

-h

Affiche un message d'utilisation court dans la console.

-m

Affiche la page de manuel de cet utilitaire dans la console.

-v

Affiche davantage de détails d'exécution dans la console.