Elles fournissent des informations de haut niveau sur l'outil lui-même et sur le déploiement du serveur d'applications Web disponible. Pour les utiliser, il n'est pas nécessaire de spécifier de noms de serveur, de propriétés ou d'actions. Par exemple :
○ wdeploy.sh help
○ wdeploy.sh listappservers
● Commandes de déploiement
Elles permettent de déployer des applications Web spécifiques sur un serveur d'applications Web spécifique.
Ces commandes suivent toujours le format : serveur, propriétés, action. Par exemple : wdeploy.sh
<SERVEUR_APP_WEB>
[-D
<PROPRIETE>
=
<valeur>
]
<ACTION>
Où :
○
<SERVEUR_APP_WEB>
est le nom du serveur Web ou du serveur d'applications Web et doit correspondre au nom du fichier de configuration WDeploy
<REP_INSTALL_PBI>
/sap_bobj/enterprise_xi40/ wdeploy/conf/config.
<SERVEUR_APP_WEB>
.
Par exemple, pour SAP NetWeaver Java 7.3, le nom du fichier de configuration est
<REP_INSTALL_BIP>
/sap_bobj/enterprise_xi40/wdeploy/conf/config.sapappsvr73. Par conséquent, le nom attribué au paramètre
<SERVEUR_APP_WEB>
est sapappsvr73.
○ -D
<PROPRIETE>
=
<valeur>
est au moins une paire clé-valeur. Les paramètres indiqués sur la ligne de commande remplacent ceux du fichier de configuration.
Par exemple, pour déployer l'application Web BOE, utilisez -DAPP=BOE. Cela remplace toute valeur de -
DAPP= stockée dans le fichier de configuration du serveur d'applications Web config.
<SERVEUR_APP_WEB>
.
○
<ACTION>
est le nom de l'opération à effectuer.
Par exemple, l'action deployall déploiera toutes les applications Web sur le serveur d'applications Web indiqué comme
<SERVEUR_APP_WEB>
dans le premier paramètre.
4.6.1 Syntaxe
4.6.1.1 Noms des serveurs WDeploy
WDeploy utilise un nom de serveur dans la ligne de commande qui fait partie du nom du fichier pour les fichiers de configuration du serveur. Le nom du serveur est le premier paramètre renseigné dans la ligne de commande lors de l'exécution de l'outil WDeploy : wdeploy.sh
<SERVEUR_APP_WEB>
[-D
<PROPRIETE>
=
<valeur>
]
<ACTION>
<SERVEUR_APP_WEB>
désigne le nom du serveur Web ou le serveur d'applications Web. Le nom attribué doit correspondre au nom du fichier de configuration dans
<REP_INSTALL_PBI>
/sap_bobj/enterprise_xi40/ wdeploy/conf.
Pour obtenir la liste de tous les noms valides pour le
<SERVEUR_APP_WEB>
, voir
[page 49].
40
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de déploiement d'applications Web
Déploiement d'applications Web à l'aide de l'outil WDeploy
4.6.1.2 Paramètres des propriétés WDeploy
Les propriétés WDeploy peuvent être configurées dans la ligne de commande à l'aide du paramètre de commutation -D
<PROPRIETE>
. Répétez le paramètre de commutation -D
<PROPRIETE>
pour chaque propriété à configurer.
Par exemple, dans la commande suivante, plusieurs invocations du paramètre de commutation -D
<PROPRIETE>
sont utilisées pour définir plusieurs propriétés d'un serveur d'applications Web Tomcat 6 (as_dir, as_instance, as_service_name et APP : wdeploy.sh Tomcat6
-Das_dir=/opt/tomcat6
-Das_instance=localhost
-Das_service_name=Tomcat6
-DAPP=BOE
deployonly
Les propriétés peuvent également être configurées dans le fichier de configuration wdeploy.config. Les propriétés peuvent ainsi être configurées par défaut et remplacées à partir de la ligne de commande si nécessaire.
Pour en savoir plus sur le fichier de configuration wdeploy.conf, voir
Fichier de configuration WDeploy
Le tableau suivant répertorie toutes les propriétés de WDeploy.
Table 9 : Propriétés de WDeploy
Propriété
APP
Description Exemple de valeur
Nom de l'application Web à déployer tel qu'indiqué dans le fichier WAR ou EAR et dans le fichier de propriétés de l'application Web :
BOE
<REP_INSTALL_PBI>
/sap_bobj/enterprise_xi40/wdeploy/conf/apps/
<APP_WEB>
.properties
Cette propriété est utilisée lors de l'utilisation d'applica tions Web particulières, comme c'est le cas avec les commandes wdeploy predeploy, wdeploy deploy ou wdeploy deployonly.
app_source_dir app_source_tree
Emplacement des fichiers source d'une application
Web particulière.
Cette propriété est utilisée lors de l'utilisation d'applica tions Web particulières, comme c'est le cas avec les commandes wdeploy predeploy, wdeploy deploy ou wdeploy deployonly.
<REP_INSTALL_PBI>
/ sap_bobj/enterprise_xi40/warfiles/ webapps/
<APP_WEB>
Emplacement des fichiers source de toutes les applica tions Web disponibles (dossier parent de app_source_dir).
Cette propriété est utilisée lors de l'utilisation simulta née de toutes les applications Web disponibles, comme c'est le cas avec les commandes wdeploy prede-
<REP_INSTALL_PBI>
/ sap_bobj/enterprise_xi40/warfiles/ webapps
Guide de déploiement d'applications Web
Déploiement d'applications Web à l'aide de l'outil WDeploy
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
41
Propriété as_admin_is_secure
Description Exemple de valeur ployall, wdeploy deployall ou wdeploy deployonlyall.
Pour les serveurs d'applications Web qui utilisent le cryptage SSL pendant le déploiement des applications
Web, tels que WebSphere.
False (par défaut) true
Remarque
La définition de cette valeur sur True nécessite que vous indiquiez également un nom et un mot de passe de compte administrateur.
as_admin_password as_admin_port as_admin_username as_dir as_domain_dir as_instance as_lang
Obligatoire pour NetWeaver.
Mot de passe du compte administrateur du serveur d'applications Web.
password
Obligatoire pour NetWeaver.
Numéro de port pour l'accès d'administration au ser veur d'applications Web.
8080
Obligatoire pour NetWeaver.
Nom d'utilisateur du compte administrateur du serveur d'applications Web.
administrator
Répertoire d'installation du serveur d'applications Web. /opt/tomcat6
Répertoire d'installation du serveur d'applications Web.
/opt/bea/weblogic
Pour les serveurs d'applications WebLogic, as_domain_dir représente la racine du domaine.
Obligatoire pour tous les serveurs d'applications.
Nom de l'instance du serveur d'applications Web.
localhost
Langue préférée pour l'interface utilisateur de WDeploy. ● Tchèque : CS
● Danois : DA
● Néerlandais : NL
● Anglais : EN
● Finnois : FI
● Français : FR
● Allemand : DE
● Hongrois : HU
● Italien : IT
● Japonais : JA
42
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de déploiement d'applications Web
Déploiement d'applications Web à l'aide de l'outil WDeploy
Propriété Description Exemple de valeur
● Coréen : KO
● Norvégien bokmål :
NB
● Polonais : PL
● Portugais : PT
● Roumain : RO
● Russe : RU
● Chinois simplifié : zh_CN
● Slovaque : SK
● Espagnol : ES
● Suédois : SV
● Thaïlandais : TH
● Chinois traditionnel : zh_TW
● Turc : TR as_mode
Type de déploiement d'application Web.
standalone
Un serveur autonome est un serveur d'applications
Web qui sert à la fois le contenu Web statique et dyna mique. Un déploiement divisé utilise un serveur Web dédié pour servir le contenu statique et un serveur d'ap plications Web pour servir le contenu dynamique.
split as_service_key Pour Tomcat exécuté sur Windows.
Pour une installation en tant que service, nom de la clé de registre Windows stockant les paramètres de dé marrage de la JVM.
HKLM\SOFTWARE\Apache
Software Foundation
\Procrun 2.0\
<AS_SER-
VICE_NAME>
\Parameters\Java as_service_key_value
Pour Tomcat exécuté sur Windows.
Pour une installation en tant que service, valeur de la clé de registre Windows stockant les paramètres de dé marrage de la JVM.
as_service_name as_sid as_soap_port
Pour Tomcat exécuté sur Windows.
Nom du service Tomcat.
Tomcat6
Obligatoire pour NetWeaver. ID système de l'instance cible.
AS1
Obligatoire pour WebSphere. Numéro de port pour l'ad ministration du serveur d'applications SOAP. S'il n'est pas défini, le numéro de port SOAP par défaut est uti lisé.
8880
Guide de déploiement d'applications Web
Déploiement d'applications Web à l'aide de l'outil WDeploy
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
43
Propriété as_virtual_host connector_type
Description
Pour WebSphere uniquement.
Exemple de valeur default_host
Hôte virtuel auquel l'application doit être liée.
Pour les serveurs Web s'exécutant en mode divisé, tels qu'Apache.
Définissez connector_type sur le nom du serveur d'applications Web dédié utilisé par le serveur Web.
tomcat6 deploy_as_a_filetree Pour les serveurs d'applications Web WebLogic.
Indique si l'application doit être déployée en tant qu'ar borescence de fichiers (format développé) ou en tant que fichier WAR ou EAR prêt à l'emploi.
deployment_dir disable_CmcApp
Désactive l'application Web CMC lorsque défini sur true.
False (par défaut) true
Répertoire sous lequel WDeploy crée un sous-réper toire pour le contenu statique servi par un serveur Web dédié.
/opt/apache2
WDeploy crée un répertoire virtuel sur le serveur Web en mappant le sous-répertoire à l'URL.
false true disable_InfoView recent_app_svr root_context_path
Désactive l'application Web Zone de lancement BI lors que défini sur true.
false true enforce_file_limit
Indique à WDeploy si l'application Web contient plus de
65 535 fichiers.
Défini sur false par défaut sauf pour WebSphere.
False (par défaut) true
JCoStandalone
A utiliser lorsque la plateforme de BI est intégrée au système SAP BW.
Défini à false lors d'un déploiement sur un serveur d'applications Web SAP NetWeaver.
Défini à true lors d'un déploiement sur tout autre ser veur d'applications.
false true
Dernier serveur d'applications Web sur lequel les appli cations Web ont été déployées.
Tomcat6
Chemin du contexte racine de l'application Web dans le quel toutes les applications Web sont déployées. Pour déployer une application Web dans un dossier du con texte racine, voir le paramètre appvdir dans le fichier de configuration .properties de l'application Web.
/BOE
44
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de déploiement d'applications Web
Déploiement d'applications Web à l'aide de l'outil WDeploy
Propriété work_dir ws_dir ws_instance ws_type war_dir
Description
Le dossier dans lequel WDeploy manipule les archives
WAR ou EAR des applications Web (par exemple, pour diviser le contenu statique et le contenu dynamique d'une application Web). Ce dossier stocke les résultats de l'action wdeploy predeploy ainsi que les données requises pour annuler le déploiement des applications
Web.
Exemple de valeur
<REP_INSTALL_PBI>
/ sap_bobj/enterprise_xi40/wdeploy/ workdir
Pour les serveurs Web s'exécutant en mode divisé, tels qu'Apache.
Répertoire racine du serveur Web.
/opt/apache2
Pour WebSphere uniquement.
En mode divisé, nom du serveur Web sur lequel l'appli cation est installée.
webserver1
Pour les serveurs Web s'exécutant en mode divisé, tels qu'Apache.
Nom du serveur Web tel qu'il apparaît dans le fichier
<REP_INSTALL_PBI>
/sap_bobj/enterprise_xi40/wdeploy/conf/config.
<SER-
VEUR_WEB>
.
apache
Remarque
Les serveurs Apache, IBM HTTP Server ont tous deux un paramètre ws_type avec pour valeur apache.
Emplacement des archives WAR ou EAR à déployer ou emplacement de sortie cible où créer les fichiers WAR génériques.
/myGenericWarFiles
4.6.1.2.1 Paramètres de propriétés obligatoires pour les déploiements de niveau Web divisé
Certaines propriétés sont obligatoires pour les déploiements de niveau Web divisé (serveurs Web et d'applications Web séparés). Lors d'un déploiement de niveau Web divisé, assurez-vous que les paramètres de propriétés suivants sont soit indiqués dans la ligne de commande, soit configurés dans le fichier de configuration du serveur Web ou du serveur d'applications Web (config.
<SERVEUR_APP_WEB>
).
● Définissez la propriété -Das_mode=split pour séparer le contenu statique sur le serveur Web et le contenu dynamique sur le serveur d'applications Web.
● Définissez la propriété -Dconnector_type=
<TYPE_CONNECTEUR>
sur le type de connecteur approprié.
Définissez connector_type sur le nom du serveur d'applications Web dédié utilisé par le serveur Web. Par
Guide de déploiement d'applications Web
Déploiement d'applications Web à l'aide de l'outil WDeploy
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
45
exemple, lorsque vous utilisez un serveur Web Apache et un serveur d'applications Web Tomcat 6, type_connecteur doit être défini sur tomcat6.
● Pour les déploiements dans lesquels le serveur Web est exécuté sur le même hôte que le serveur d'applications Web, vous devez indiquer les propriétés -Dws_type=
<TYPE_SERVEUR_WEB>
et -
Dws_dir=
<REP_SERVEUR_WEB>
.
4.6.1.3 Actions de WDeploy
Le dernier paramètre d'une commande WDeploy correspond à l'action à exécuter. La section suivante définit chaque action valide et son résultat.
Table 10 : Actions WDeploy
Action Description predeploy
La commande wdeploy predeploy prépare le déploiement d'une application Web sur le serveur d'applications Web cible.
Le fichier de configuration web.xml de l'application Web est mis à jour, ainsi que tou tes les modifications requises pour que l'application Web puisse être déployée sur le serveur d'applications Web cible.
Une fois configurée, l'application Web est prête à l'emploi dans un fichier WAR ou
EAR et enregistrée dans
<REP_INSTALL_PBI>
/sap_bobj/enterprise_xi40/ wdeploy/workdir/
<SERVEUR_APP_WEB>
.
Le fichier peut être déployé manuellement via la console d'administration du serveur d'applications Web ou la commande wdeploy deploy.
Utilisez wdeploy predeploy pour préparer l'application Web BOE afin qu'elle soit prête à être déployée sur un serveur d'applications Web donné. Par exemple : wdeploy.sh
<SERVEUR_APP_WEB>
-DAPP=BOE
predeploy predeployall
La commande wdeploy predeployall exécute la commande wdeploy predeploy pour toutes les applications Web situées dans le répertoire source d'applica tions Web de la plateforme de BI :
<REP_INSTALL_PBI>
/sap_bobj/enterprise_xi40/warfiles/webapps
Utilisez wdeploy predeployall pour appliquer la commande wdeploy predeploy à toutes les applications Web. Par exemple : wdeploy.sh
<SERVEUR_APP_WEB>
predeployall
46
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de déploiement d'applications Web
Déploiement d'applications Web à l'aide de l'outil WDeploy
Action deploy deployall deployonly deployonlyall
Description
Remarque
L'accès au serveur d'applications Web n'est pas indispensable pour le prédéploie ment, sauf dans le cas de WebSphere. Pour le déploiement sur WebSphere, le pa ramètre default_virtual_host est obligatoire.
La commande wdeploy deploy est une concaténation des commandes wdeploy predeploy et wdeploy deployonly qui prépare et déploie une application Web sur le serveur d'applications Web cible par le biais d'une seule commande.
Utilisez wdeploy deploy pour préparer et déployer l'application Web BOE sur le serveur d'applications Web cible.
wdeploy.sh
<SERVEUR_APP_WEB>
-DAPP=BOE
deploy
La commande wdeploy deployall exécute la commande wdeploy deploy pour toutes les applications Web situées dans le répertoire source d'applications Web de la plateforme de BI :
<REP_INSTALL_PBI>
/sap_bobj/enterprise_xi40/warfiles/webapps
Utilisez wdeploy deployall pour appliquer la commande wdeploy deploy à tou tes les applications Web. Par exemple : wdeploy.sh
<SERVEUR_APP_WEB>
deployall
La commande wdeploy deployonly déploie une application Web préparée sur le serveur d'applications Web cible.
Les fichiers déployables WAR ou EAR situés dans
<REP_INSTALL_PBI>
/sap_bobj/ enterprise_xi40/wdeploy/workdir/
<SERVEUR_APP_WEB>
sont déployés sur le serveur d'applications Web via la commande wdeploy deployonly qui appelle l'in terface de type ligne de commande du serveur d'applications Web.
Si une application Web n'a pas été préparée pour être déployée, la commande wdeploy predeploy est appelée automatiquement.
Pour déployer une application Web BOE préparée sur un serveur d'applications Web, utilisez wdeploy deployonly. Par exemple : wdeploy.sh
<SERVEUR_APP_WEB>
-DAPP=BOE
deployonly
La commande wdeploy deployonlyall exécute la commande wdeploy deployonly pour toutes les applications Web préparées.
Guide de déploiement d'applications Web
Déploiement d'applications Web à l'aide de l'outil WDeploy
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
47
Action buildwarall listapps listdeployedapps undeploy undeployall validateconfig
Description
Utilisez wdeploy deployonlyall pour appliquer la commande wdeploy deployonly à toutes les applications Web préparées. Par exemple : wdeploy.sh
<SERVEUR_APP_WEB>
deployonlyall
Crée un fichier WAR générique en se servant de l'arborescence source de l'applica tion Web. Par exemple : wdeploy.sh buildwarall
-Dapp_source_tree=
<EMPLACEMENT_ARBORESCENCE_SOURCE_APP>
-Dwar_dir=
<EMPLACEMENT_CIBLE_FICHIER_WAR_GENERIQUE>
Répertorie toutes les applications Web disponibles pour le déploiement sur un ser veur d'applications Web. Par exemple : wdeploy.sh
<SERVEUR_APP_WEB>
listapps
Répertorie toutes les applications Web actuellement déployées sur un serveur d'ap plications Web. Cette action ne peut être exécutée que sur un serveur Web ou sur un système de serveurs d'applications Web. Par exemple : wdeploy.sh
<SERVEUR_APP_WEB>
listdeployedapps
La commande wdeploy undeploy appelle l'interface de type ligne de commande du serveur d'applications Web cible pour supprimer du serveur une application Web de la plateforme de BI déployée.
Utilisez la commande wdeploy undeploy pour annuler le déploiement d'une appli cation Web BOE sur le serveur d'applications Web cible.
wdeploy.sh
<SERVEUR_APP_WEB>
-DAPP=BOE
undeploy
La commande wdeploy undeployall exécute la commande wdeploy undeploy pour toutes les applications Web de la plateforme de BI déployées sur le serveur d'applications Web cible. Par exemple : wdeploy.sh
<SERVEUR_APP_WEB>
undeployall
Valide la configuration WDeploy des serveurs d'applications Web pris en charge afin de garantir la réussite du déploiement. Par exemple : wdeploy.sh
<SERVEUR_APP_WEB>
validateconfig
Remplacez
<SERVEUR_APP_WEB>
par le nom du serveur d'applications Web.
48
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de déploiement d'applications Web
Déploiement d'applications Web à l'aide de l'outil WDeploy
Публичная ссылка обновлена
Публичная ссылка на ваш чат обновлена.
