Utilitaire Run Deployment (runDeployment.sh/.bat)
L'outil de ligne de commande runDeployment vous permet de déployer un canal interactif pour un groupe de serveur spécifique depuis la ligne de commande, en utilisant les paramètres fournis par un fichier deployment.properties. Ce fichier décrit tous les paramètres possibles et est disponible dans le même emplacement que l'outil runDeployment. La possibilité d'exécuter un déploiement de canal interactif depuis la ligne de commande est particulièrement utile lorsque vous utilisez la fonctionnalité OffersBySQL. Par exemple, vous pouvez configurer un diagramme de traitement par lots Campaign afin de l'exécuter à intervalles réguliers. Lorsque l'exécution du diagramme se termine, un déclencheur peut être appelé pour initialiser le déploiement des offres dans la table OffersBySQL à l'aide de cet outil de ligne de commande.
Description
Vous pouvez trouver l'outil de ligne de commande runDeployment qui est installé automatiquement sur le serveur de phase de conception Interact, à l'emplacement suivant :
Interact_home/interactDT/tools/deployment/runDeployment.sh (ou runDeployment.bat sur un serveur Windows)
Le seul argument passé à la commande est l'emplacement d'un fichier appelé deployment.properties qui décrit tous les paramètres possibles requis pour déployer la combinaison de groupe de serveur canal interactif/exécution. Un échantillon de fichier est fourni à titre de référence.
*
Avant d'utiliser l'utilitaire runDeployment, vous devez d'abord l'éditer avec un éditeur de texte pour indiquer l'emplacement de l'environnement d'exécution Java Java sur le serveur. Par exemple, vous pouvez indiquer Interact_home/jre ou Platform_home/jre comme chemin d'accès, si l'un de ces répertoires contient l'exécution Java que l'utilitaire doit utiliser. Une autre solution consiste à indiquer le chemin d'accès à tout environnement d'exécution Java pris en charge pour cette édition des produits IBM® .
Utilisation de l'utilitaire runDeployment dans un environnement sécurisé (SSL)
Pour utiliser l'utilitaire runDeployment, lorsque la sécurité a été activée sur le serveur Interact (et par conséquent avec une connexion via un port SSL), vous devez ajouter la propriété Java du fichier de clés certifiées, comme suit :
1.
Lorsque vous éditez le fichier deployment.properties pour votre déploiement de canal interactif, modifiez la propriété deploymentURL afin d'utiliser l'URL SSL sécurisée, comme dans cet exemple :
deploymentURL=https://<HOST>.<DOMAIN>:<PORT>/Campaign/interact/InvokeDeploymentServlet
2.
Editez le script runDeployment.sh ou runDeployment.bat à l'aide d'un éditeur de texte afin d'ajouter l'argument suivant à la ligne commençant par ${JAVA_HOME} :
-Djavax.net.ssl.trustStore=<TrustStorePath>
Par exemple, la ligne se présente comme suit lorsque vous avez ajouté l'argument du fichier de clés certifiées :
${JAVA_HOME}/bin/java -Djavax.net.ssl.trustStore=<TrustStorePath> 
-cp ${CLASSPATH}com.unicacorp.Campaign.interact.deployment.tools.
InvokeDeploymentClient $1
Remplacez<TrustStorePath> par le chemin d'accès au fichier de clés certifiées SSL réel.
Exécution de l'utilitaire
Lorsque vous avez édité l'utilitaire pour qu'il fournisse l'environnement d'exécution Java, et avez personnalisé une copie du fichier deployment.properties afin qu'il corresponde à votre environnement, lancez cette commande pour exécuter l'utilitaire :
Interact_home/interactDT/tools/deployment/runDeployment.sh deployment.properties
Remplacez Interact_home par la valeur réelle de l'installation de la phase de conception Interact, et remplacez deployment.properties par le chemin et le nom réels du fichier de propriétés que vous avez personnalisé pour ce déploiement.
Echantillon de fichier deployment.properties
L'échantillon de fichier deployment.properties contient la liste commentée de tous les paramètres que vous devez personnaliser pour le faire correspondre à votre environnement. Cet échantillon de fichier contient également des commentaires qui décrivent chaque paramètre, et explique pourquoi il peut être nécessaire de personnaliser une valeur particulière.
###############################################################################
#
# Les propriétés suivantes sont envoyées au programme InvokeDeploymentClient.
# Le programme recherche un paramètre deploymentURL. Ce programme publie une demande
# concernant à cette URL. Tous les autres paramètres sont publiés en tant que paramètres
# dans cette demande. Le programme vérifie alors le statut du déploiement et
# revient lorsque le déploiement est terminé (ou si le délai
# waitTime indiqué a été atteint).
#
# La sortie de ce programme a le format suivant :
# <STATE> : <Misc Detail>
#
# où état peut être l'une des valeurs suivantes :
# ERROR
# RUNNING
# SUCCESS
#
# Misc Detail sont les données qui renseignent normalement la zone de message de statut
# dans l'interface graphique de déploiement de la page de récapitulatif IC. REMARQUE : il peut y avoir des balises HTML
# dans Misc Detail
#
###############################################################################

###############################################################################
# deploymentURL : URL du servlet InvokeDeployment qui réside dans la phase de
# conception Interact. Elle doit avoir le format suivant :
# http://dt_host:port/Campaign/interact/InvokeDeploymentServlet
###############################################################################
deploymentURL=http://localhost:7001/Campaign/interact/InvokeDeploymentServlet

###############################################################################
# dtLogin : il s'agit de la connexion que vous devez utiliser pour vous connecter à la phase de conception si
# si vous vouliez déployer IC via l'interface graphique de déploiement dans la
# page de récapitulatif IC.
###############################################################################
dtLogin=asm_admin

###############################################################################
# dtPW : PW qui accompagne le dtLogin
###############################################################################
dtPW=

###############################################################################
# icName : nom du canal interactif à déployer
###############################################################################
icName=ic1

###############################################################################
# partition : nom de la partition
###############################################################################
partition=partition1

###############################################################################
# request : type de demande à exécuter par cet outil
# Actuellement, il existe deux comportements. Si la valeur est "deploy", le déploiement
# est exécuté. Avec toutes les autres valeurs, l'outil renvoie simplement le
# statut du dernier déploiement de l'IC indiqué.
###############################################################################
request=deploy

###############################################################################
# serverGroup : Nom du groupe de serveurs qui doit
# déployer l'IC.
###############################################################################
serverGroup=defaultServerGroup

###############################################################################
# serverGroupType : Indique si ce déploiement concerne le
# un groupe de serveur de production ou de serveurs de test. 1 indique la production,
# 2 indique le test.
###############################################################################
serverGroupType=1

###############################################################################
# rtLogin : Compte utilisé pour authentifier le groupe de serveurs
# sur lequel vous effectuez le déploiement.
###############################################################################
rtLogin=asm_admin

###############################################################################
# rtPW : Mot de passe associé au rtLogin
###############################################################################
rtPW=

###############################################################################
# waitTime : Lorsque l'outil envoie la demande de déploiement, l'outil vérifie
# le statut du déploiement. Si le déploiement n'est pas terminé (ou a
# échoué), l'outil continue à sonder le système pour connaître le statut jusqu'à
# la fin du déploiement, OU l'échéance du délai waitTime indiqué (en
# secondes).
###############################################################################
waitTime=5

###############################################################################
# pollTime : Si le statut d'un déploiement est encore en cours d'exécution,
# l'outil continue à vérifier le statut. Il se met en veille entre les contrôles de statut
# pendant un nombre de secondes en fonction du paramètre pollTime.
###############################################################################
pollTime=3

###############################################################################
# global : Le choix de la valeur false empêche le déploiement des paramètres globaux par l'outil.
# La non-disponibilité de la propriété permet de déployer les paramètres globaux.
###############################################################################
global=true