Syntaxe. SAP Plateforme de BI

PDF

Document

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

Valeurs pour le

SERVEUR_APP_WEB

[page 49].

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

[page 32].

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

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

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 :

● 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

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

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

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

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

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.

Guide de déploiement d'applications Web

Déploiement d'applications Web à l'aide de l'outil WDeploy