SAP Plateforme de BI Manuel utilisateur

Plateforme SAP BusinessObjects Business Intelligence

Version du document : 4.1 Support Package 3 - 2014-03-27

Guide de déploiement d'applications

Web

Table des matières

1 Historique du document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2

2.1

Démarrage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

A propos de ce document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

2.2 Nouveautés du Guide de déploiement des applications Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

2.3 Public visé par cette documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.4 Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.5 Terminologie. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8

3

3.1

Présentation du déploiement d'applications Web.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Présentation des fichiers WAR OSGi. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

3.2 Basculement et équilibrage de charge. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

3.2.1 Prise en charge de la mise en cluster d'applications Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

3.3 Fichiers WAR et EAR de la plateforme SAP BusinessObjects de Business Intelligence. . . . . . . . . . . . . . .12

3.3.1 Pour déployer MobileOTA14.war pour la prise en charge des applications mobiles. . . . . . . . . . 15

3.3.2 Déploiement d'OpenSearch.war pour la prise en charge d'OpenSearch. . . . . . . . . . . . . . . . . .16

3.4 Racines de contexte par défaut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

3.5 Contextes racine personnalisés et chemins de contexte. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

3.5.1 Modification du contexte racine. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

3.5.2 Modification du chemin de contexte d'une application Web. . . . . . . . . . . . . . . . . . . . . . . . . . 18

4

4.1

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

Présentation de wdeploy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

4.2 Conditions préalables à l'utilisation de l'outil WDeploy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

4.2.1 Avant de déployer des applications Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

4.2.2

4.2.3

Configuration matérielle requise. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Prise en charge 64 bits. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

4.2.4 Droits minimums requis pour le déploiement d'applications Web avec un compte différent

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

4.2.5

4.2.7

Définissez ulimit sur illimité. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Pour configurer l'environnement Java. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

4.2.8 Fichiers de configuration des paramètres du serveur d'applications Web. . . . . . . . . . . . . . . . 25

4.2.9 Installation de WDeploy sur un serveur d'applications Web distant. . . . . . . . . . . . . . . . . . . . . 26

4.3 Enregistrement du répertoire du paysage système (SLD) SAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26

4.3.1 Pour activer l'enregistrement SLD pour SAP NetWeaver. . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

4.3.2

4.3.3

Pour activer l'enregistrement SLD pour Tomcat. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Pour activer l'enregistrement SLD pour WebSphere. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

4.4 Modes de déploiement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28

4.4.1 Déploiements autonomes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

4.4.2 Déploiements de niveau Web divisé. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29

2

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

Guide de déploiement d'applications Web

Table des matières

4.5 Fichiers de configuration WDeploy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

4.5.1 Fichier de configuration WDeploy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

4.5.2 Fichiers de configuration du serveur d'applications Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

4.5.3 Fichier de propriétés de configuration d'application Web. . . . . . . . . . . . . . . . . . . . . . . . . . . .38

4.6 Utilisation de l'outil de ligne de commande WDeploy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

4.6.1

4.6.2

Syntaxe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Exemples d'utilisation de WDeploy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

4.6.3

4.6.4

4.6.5

4.6.6

Remarques particulières. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Pré-déploiement de niveau Web divisé sans accès à un serveur d'applications Web. . . . . . . . . 71

Désactivation des applications Web CMC ou Zone de lancement BI. . . . . . . . . . . . . . . . . . . . 72

Modifications apportées aux langues installées. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

4.7 Utilisation de l'outil WDeploy GUI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72

4.7.1

4.7.2

4.7.3

4.7.4

Prérequis concernant l'utilisation de l'outil WDeploy GUI. . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Démarrage de l'outil WDeploy GUI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74

Fenêtre de l'outil WDeploy GUI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Mises à jour des applications Web via WDeploy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75

4.7.5

4.7.6

Options de l'outil WDeploy GUI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Ajout du mot de passe au fichier WDeploy GUI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

4.8 Après le déploiement des applications Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

4.9 Fichiers journaux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

5

5.1

Déploiement d'applications Web à l'aide de la console d'administration. . . . . . . . . . . . . . . . . . . . 78

Pour déployer manuellement les applications Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

5.1.1

5.1.2

5.1.3

5.1.4

5.1.5

Déploiement manuel de la console d'administration JBoss 7.1. . . . . . . . . . . . . . . . . . . . . . . . 79

SAP NetWeaver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

Déploiement manuel de la console d'administration Tomcat 6 et 7. . . . . . . . . . . . . . . . . . . . .82

Déploiement manuel de la console d'administration WebLogic 11gR1. . . . . . . . . . . . . . . . . . . 83

Déploiement manuel de la console d'administration WebSphere 7.0. et 8.5. . . . . . . . . . . . . . .84

6 Problèmes identifiés et résolutions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

6.1 Fins de lignes Windows dans un script wdeploy.sh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

6.2 Attribution d'un nouveau nom à l'application Web BOE ou à l'arborescence source de l'application

Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91

6.3 Utilisation de WDeploy dans un environnement purement IPv6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

6.4 Services Web sur des serveurs de niveau Web divisé. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

6.6 WDeploy avec d'autres langues que l'anglais. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

6.8 Application Web non supprimée du serveur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

6.9 Lancement de l'interface graphique utilisateur de WDeploy sur des serveurs Red Hat Linux

Enterprise. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

6.10 Copier MobileOTA14.properties après une installation de niveau Web. . . . . . . . . . . . . . . . . . . . . . . . . 93

6.11 Bouton Annuler de l'outil d'interface graphique utilisateur de WDeploy. . . . . . . . . . . . . . . . . . . . . . . . .94

6.12 JBoss. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

Guide de déploiement d'applications Web

Table des matières

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

3

6.12.1 Exception de sécurité lors du déploiement d'AdminTools, dswsbobje ou BusinessProcessBI sur JBoss 7.1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

6.13 SAP NetWeaver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95

6.13.1 Niveau de service, niveau de correctif et paramètres de noms affichés incorrects lors du déploiement de SAP NetWeaver à l'aide de SUM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

6.13.2 L'outil WDeploy ne prend pas en charge le déploiement ou l'annulation du déploiement sur

SAP NetWeaver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96

6.13.3 Configuration requise pour le déploiement de SAP BusinessObjects Explorer sur SAP

NetWeaver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

6.14 Tomcat. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

6.14.2 Annulation du déploiement d'applications Web Tomcat à l'aide de WDeploy. . . . . . . . . . . . . . 96

6.14.3 Il se peut que Tomcat ne charge pas d'applications Web au démarrage après l'exécution de

WDeploy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

6.15 WebLogic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

6.15.1 Suppression du déploiement de services Web dans WebLogic. . . . . . . . . . . . . . . . . . . . . . . . 97

6.16 WebSphere. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

6.16.1 Déploiement sur WebSphere en mode sécurisé. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

6.16.2 Erreur de serveur interne survenue à la suite du déploiement des services Web sur

WebSphere 7.0. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

6.16.3 WASX7017E : exception lors du déploiement dans WebSphere. . . . . . . . . . . . . . . . . . . . . . . 98

4

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

Guide de déploiement d'applications Web

Table des matières

1 Historique du document

Le tableau suivant fournit une présentation des principales modifications du document.

Remarque

Pour afficher une liste actualisée des serveurs d'applications Web pris en charge par cette version, voir la

Product Availability Matrix (plateformes prises en charge/PAR), disponible dans la section SAP

BusinessObjects du SAP Support Portal à l'adresse :

https://service.sap.com/bosap-support

.

Version

Plateforme SAP Busi­ nessObjects Business

Intelligence 4.1

Date

Mai 2013

Plateforme SAP Busi­ nessObjects Business

Intelligence 4.1 Sup­ port Package 1

Août 2013

Plateforme SAP Busi­ nessObjects Business

Intelligence 4.1 Sup­ port Package 2

Novembre

2013

Description

Première version de ce document.

Mise à jour de

Exception de sécurité lors du déploiement d'AdminTools, dswsbobje ou BusinessProcessBI sur JBoss 7.1

[page 94]. Une solution

de contournement peut être nécessaire pour les applications dswsbobje et BusinessProcessBI lors d'un déploiement sur

JBoss 7.1.

SAP Software Update Manager (SUM) est désormais utilisé à la place de

SAP Java Support Package Manager (JSPM) pour déployer les applica­ tions Web sur SAP NetWeaver. Mise à jour de

Déploiement de SAP Net­

Weaver avec SAP Software Update Manager (SUM)

[page 81].

● Weblogic 10 a été retiré de la liste des plateformes prises en charge.

● La section Modifications apportées aux langues installées a été mise

à jour car vous pouvez effectuer une installation de modification au lieu d'une réinstallation complète.

● Sections wdeploy predeploy et wdeploy predeployall mises à jour pour inclure le paramètre jrockit

● Ajout de WebSphere 8.5.5 à la liste des plateformes prises en charge

Guide de déploiement d'applications Web

Historique du document

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

5

2 Démarrage

2.1 A propos de ce document

Ce document explique comment déployer les applications Web de la plateforme de BI sur un serveur d'applciations Web à l'aide de l'outil WDeploy.

Pour en savoir plus sur l'installation de la plateforme de BI, voir le Guide d'installation de la plateforme SAP

BusinessObjects de Business Intelligence.

Pour en savoir plus sur l'administration d'un serveur de la plateforme SAP BusinessObjects Business Intelligence, voir le Guide d'administration de la plateforme SAP BusinessObjects Business Intelligence.

2.2 Nouveautés du Guide de déploiement des applications

Web

Prise en charge des serveurs d'applications Web

Pour afficher une liste des plateformes, bases de données, serveurs d'applications Web, serveurs Web et autres systèmes pris en charge par cette version, voir la Product Availability Matrix (plateformes prises en charge/PAR), disponible dans la section SAP BusinessObjects du SAP Support Portal à l'adresse :

https://service.sap.com/ bosap-support

. La Products Availability Matrix l'emporte sur le Guide de déploiement d'applications Web en cas de divergence.

Plateforme de BI 4.x

Les fonctionnalités suivantes ont été ajoutées à partir de la plateforme de BI 4.x :

Table 1 : Nouveautés de l'outil de déploiement WDeploy

Fonctionnalité Description

Interface utilisateur graphique (IUG)

Nouvelle IUG pour les actions deployall et undeployall.

Deux niveaux de fi­ chiers journaux

Un résumé du journal aide les administrateurs à mieux comprendre le statut du déploie­ ment et un journal détaillé les aide à dépanner les problèmes liés au déploiement.

Configuration simpli­ fiée

Fichier de configuration centralisé pour les paramètres globaux de WDeploy, le serveur d'accès et les paramètres WDeploy de WDeploy GUI.

Prise en charge de la localisation

Prise en charge de la localisation de WDeploy GUI.

6

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

Guide de déploiement d'applications Web

Démarrage

Fonctionnalité

Pas de fichiers WAR intermédiaires

Déploiement simpli­ fié

Description

Les fichiers WAR intermédiaires ne sont plus créés dans le cadre du processus de dé­ ploiement. Si vous avez besoin de créer un fichier WAR non adapté à un serveur d'appli­ cations Web spécifique, utilisez la commande wdeploy buildwarall.

Le nombre de fichiers WAR utilisés pour les applications Web de la plateforme de BI a été réduit. Cela contribue à réduire l'utilisation des ressources redondantes et le nombre de requêtes effectuées à partir du serveur d'applications Web sur le CMS.

Table 2 : Nouveautés de ce document

Fonctionnalité Description

Réorganisation du contenu Plutôt que de répertorier chaque commande WDeploy pour chaque serveur d'applications Web, les commandes WDeploy ne sont désormais affichées qu'une seule fois, avec des exemples fournis pour chaque serveur d'applica­ tions Web pris en charge.

Documentation sur les nouvel­ les fonctionnalités

Les nouvelles fonctionnalités de WDeploy font l'objet d'une documentation.

La documentation produit de la plateforme de BI est disponible dans les langues prises en charge sur le site Web de support et actualisée avec les informations à jour lorsque celles-ci deviennent disponibles entre deux versions.

Pour consulter la documentation produit la plus récente, visitez le site

http://help.sap.com

.

2.3 Public visé par cette documentation

Cette documentation s'adresse aux administrateurs système ou aux professionnels de l'informatique chargés de l'installation de la plateforme de BI. Une bonne connaissance de votre environnement réseau général, des conventions d'utilisation des ports, de votre environnement de base de données et de votre logiciel de serveur

Web est essentielle.

2.4 Variables

Les variables suivantes sont utilisées dans ce guide.

Variable

<REP_INSTALL_PBI>

<NOMHOTE_SAW>

<APP_WEB>

Description

Répertoire dans lequel est installée la plateforme de BI.

Nom d'hôte ou IP du serveur d'applications Web où les applications Web de la plateforme de BI sont déployées.

Nom d'une application Web de la plateforme de BI. Par exemple, une valeur pour

<APP_WEB>

est BOE . Cette application dispose d'un fichier de configuration nommé

BOE.properties

et l'outil WDeploy crée BOE.war

au

Guide de déploiement d'applications Web

Démarrage

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

7

Variable

<SERVEUR_APP_WEB>

Description cours des étapes de prédéploiement pour certains serveurs d'applications.

Pour obtenir la liste complète des applications Web de la plateforme de BI, voir

Fichiers WAR et EAR de la plateforme

SAP BusinessObjects de Business Intelligence

[page 12].

Nom abrégé du serveur d'applications Web utilisé par l'outil

WDeploy. Par exemple, la valeur de

<SERVEUR_APP_WEB>

pour Tomcat 7.0 est tomcat7 .

Pour obtenir la liste complète des valeurs, voir

Valeurs pour le

SERVEUR_APP_WEB

[page 49].

2.5 Terminologie

La documentation de la plateforme de BI utilise la terminologie suivante :

Terme produits de modules complémentaires

Magasin de données d'audit

Plateforme de BI base de données fournie, serveur d'applications Web fourni cluster mettre en cluster

Définition

Produits utilisant la plateforme de BI mais disposant de leur propre programme d'installation, tels que SAP Bu­ sinessObjects Explorer.

Base de données utilisée pour stocker les données d'audit

Abréviation pour Plateforme SAP BusinessObjects Bu­ siness Intelligence

Base de données ou serveur d'applications Web ac­ compagnant la plateforme de BI

Au moins deux serveurs CMS (Central Management

Servers) travaillant ensemble et utilisant une seule base de données du CMS.

Pour créer un cluster

Par exemple, pour créer un cluster :

1. Installez un CMS et une base de données du CMS sur l'ordinateur A.

2. Installez un CMS sur l'ordinateur B.

3. Dirigez le CMS installé sur l'ordinateur B vers la base de données du CMS installée sur l'ordinateur

A.

8

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

Guide de déploiement d'applications Web

Démarrage

Terme clé de cluster

CMS

Base de données du CMS déploiement l'installation ordinateur version principale migration version secondaire nœud correctif promotion serveur

Server Intelligence Agent

Guide de déploiement d'applications Web

Démarrage

Définition

Utilisée pour déchiffrer les clés de la base de données du CMS

Vous pouvez changer de clé de cluster dans le CCM mais vous ne pouvez pas réinitialiser la clé comme un mot de passe. Elle renferme un contenu chiffré et il est essentiel de ne pas la perdre.

Abréviation pour Central Management Server

Base de données utilisée par le CMS pour stocker les informations relatives à la plateforme de BI

Logiciel de la plateforme de BI installé, configuré et exécuté sur un ou plusieurs ordinateurs.

Une instance des fichiers de la plateforme de BI créée par le programme d'installation sur un ordinateur

Ordinateur sur lequel le logiciel de la plateforme de BI est installé

Version complète du logiciel, telle que 4.0

Processus de transfert de contenu BI depuis une ver­ sion principale précédente (par exemple, depuis XI 3.1)

à l'aide de l'outil de gestion de mise à niveau.

Ce terme ne concerne pas les déploiements de même version principale. Voir promotion.

Version comportant certains composants, telle que 4.1

Groupe de serveurs de la plateforme de BI qui s'exécu­ tent sur le même ordinateur et sont gérés par le même

SIA (Server Intelligence Agent)

Petite mise à jour concernant une version de Support

Package spécifique

Processus de transfert de contenu BI entre des dé­ ploiements de même version principale (par exemple, de 4.0 vers 4.0) à l'aide de l'application de gestion des promotions

Un processus de la plateforme de BI. Un serveur hé­ berge un ou plusieurs services.

Processus gérant un groupe de serveurs, notamment l'arrêt, le démarrage et le redémarrage des serveurs

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

9

Terme

Support Package

Serveurs d'applications Web mise à niveau

Définition

Mises à jour logicielle concernant une version secon­ daire ou principale

Serveur traitant du contenu dynamique. Par exemple, le serveur d'applications Web fourni pour 4.1 est Tom­ cat 7.

La planification, la préparation, la migration et le posttraitement nécessaires à la réalisation d'un processus de migration

10

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

Guide de déploiement d'applications Web

Démarrage

3 Présentation du déploiement d'applications Web.

Le programme d'installation de la plateforme de BI ne peut effectuer le déploiement d'applications Web que sur le serveur d'applications Web Tomcat fourni. Tous les autres serveurs d'applications Web pris en charge requièrent que les applications Web soient déployées une fois l'installation terminée. Il est recommandé d'utiliser l'outil de déploiement d'applications Web WDeploy. Pour des informations et des instructions sur la méthode de déploiement à l'aide de l'outil WDeploy, voir la section “Déploiement d'applications Web à l'aide de l'outil

WDeploy”.

Vous pouvez aussi déployer des applications Web à l'aide de la console d'administration de votre serveur d'applications. Les applications Web déployées via la console d'administration du serveur d'applications Web doivent d'abord être modifiées pour que leurs fichiers WAR ou EAR puissent être déployés. Les commandes wdeploy predeploy et wdeploy predeployall automatisent ce processus. Après avoir utilisé ces commandes de prédéploiement, passez à la section “Déploiement d'applications Web à l'aide de la console d'administration” de ce guide pour en suivre les instructions. Cependant, si vous possédez une connaissance approfondie de votre serveur d'applications Web et que vous savez personnaliser les applications Web en vue de leur déploiement, ce processus peut être effectué manuellement. L'ajustement manuel des applications Web en vue de leur déploiement sur un autre serveur d'applications Web n'est pas abordé dans ce guide.

3.1 Présentation des fichiers WAR OSGi

La structure OSGi pour applications Web Java simplifie le déploiement des applications Web fournies avec la plateforme de BI. Elle intègre les applications Web, les packs linguistiques, les SDK, les plug-in et autres ressources dans un même paquet pouvant être déployé sur un serveur d'applications Web en une seule étape.

Le déploiement d'un fichier WAR unique signifie également qu'un nombre moindre de sessions Web est requis lorsqu'un utilisateur accède à plusieurs applications Web, ce qui réduit l'espace mémoire, l'espace disque et la charge de traitement sollicités sur le serveur d'applications Web.

3.2 Basculement et équilibrage de charge

La plateforme de BI prend en charge les serveurs d'applications Web en cluster avec un équilibrage de charge.

Des équilibreurs de charge matériels ou logiciels peuvent être utilisés comme point d'entrée des serveurs d'applications Web pour veiller à ce que le traitement soit également réparti entre les serveurs d'applications Web.

Les équilibreurs de charge matériels suivants sont actuellement pris en charge :

● Module Cisco Application Control Engine (ACE)

● La gamme d'équilibreurs de charge F5 BIG-IP.

Les types de persistance suivants sont actuellement pris en charge :

● Persistance de l'adresse IP source.

Guide de déploiement d'applications Web

Présentation du déploiement d'applications Web.

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

11

● Persistance des cookies en mode Insertion (ArrowPoint Cookie).

L'équilibrage de charge d'un cluster de serveurs de la plateforme de BI n'est pas obligatoire car le CMS (Central

Management Server) diffuse déjà le travail entre les nœuds du cluster.

Remarque

L'application Web Central Management Console (CMC) ne prend pas en charge le basculement de session.

Cependant, la zone de lancement BI prend en charge le basculement de session, si bien que les utilisateurs ne remarqueront pas l'éventuelle défaillance sur l'un des ordinateurs de serveur de la plateforme de BI de votre déploiement.

3.2.1 Prise en charge de la mise en cluster d'applications

Web

Les applications Web Central Management Console (CMC) et Zone de lancement BI peuvent être utilisées dans des environnements comportant différentes configurations mises en cluster, équilibrées en charge ou tolérantes aux pannes. Le tableau ci-dessous répertorie les prises en charge de configuration pour les applications Web CMC et Zone de lancement BI.

Application Web Serveurs d'applications Web en cluster

Pris en charge

Equilibreurs de charge avec affinité de session

Equilibreurs de charge sans affinité de session

Tolérant aux pannes

Pris en charge Non pris en charge Oui Zone de lancement BI

(sans état)

CMC (avec état) Pris en charge Pris en charge Non pris en charge Non

Remarque

L'outil WDeploy n'est pas pris en charge dans le cas d'un déploiement sur un cluster ou un logiciel de cluster tel que le déploiement de réseau de serveurs d'applications WebSphere.

3.3 Fichiers WAR et EAR de la plateforme SAP

BusinessObjects de Business Intelligence

La fonctionnalité qui représente la plateforme de BI est répartie entre plusieurs applications Web afin de faciliter le seul déploiement des composants requis par votre organisation. Dans la plateforme de BI 4.2, un grand nombre des applications principales incluses dans les versions précédentes ont été regroupées en une archive OSGi unique. Cela permet de limiter la mémoire dédiée aux applications Web sur le serveur et de réduire le nombre de sessions Web nécessaires aux applications Web, auparavant associées à plusieurs archives.

Par exemple, la plateforme de BI XI 3.x incluait les applications Web de la CMC (Central Management Console) et d'InfoView (désormais Zone de lancement BI), archivées sous la forme CMC.war et InfoView.war. La plateforme de BI 4.2 a consolidé les applications Web de la CMC et d'InfoView (désormais zone de lancement BI), ainsi que d'autres, en une archive unique nommée BOE.war ou BOE.ear.

12

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

Guide de déploiement d'applications Web

Présentation du déploiement d'applications Web.

L'outil WDeploy permet d'automatiser le processus d'ajustement des applications Web de manière à ce qu'elles puissent être déployées sur un serveur d'applications Web pris en charge. Bien que les administrateurs expérimentés soient en mesure d'ajuster manuellement une application Web pour un serveur d'applications Web spécifique, il est fortement recommandé d'utiliser l'outil WDeploy pour automatiser le processus.

Le tableau suivant répertorie les archives d'applications Web et les applications Web associées. Les applications

Web non déployées automatiquement par le programme d'installation doivent être déployées après l'installation.

Archive d'applications Web (WAR ou EAR)

BOE

Déployée automatiquement ?

Oui

Description

BusinessProcessBI clientapi dswsbobje

(obsolète) Oui

Oui

Oui

Archive OSGi des applications Web principales, y compris :

●

Analytical Reporting

●

CMC

●

SAP Crystal Reports

●

Zone de lancement BI

(anciennement InfoView)

●

Prise en charge d'Eclipse IDE

●

Gestionnaire de cycle de vie

●

Surveillance

●

OpenDocument

●

Espace de travail BI (anciennement

Dashboard Builder)

●

Recherche de plateformes

●

Services de plateformes

●

Différence visuelle

●

SAP BusinessObjects Dashboards

(anciennement Xcelsius)

Cette application Web est obsolète. Elle assure la prise en charge des composants SDK et des services Web

Crystal Reports hérités, notamment :

●

Crystal Enterprise

●

Report Application Server (RAS)

Crystal Reports

●

SAP BusinessObjects Dashboards

(anciennement Xcelsius)

●

SAP BusinessObjects Analysis,

édition OLAP(anciennement

Voyager)

Prise en charge de l'API JavaScript de

SAP Crystal Reports

Composants de services Web, notamment :

●

Session

●

Plateforme de BI

●

Catalogue BI

●

Outil d'administration de fédération de données

Guide de déploiement d'applications Web

Présentation du déploiement d'applications Web.

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

13

Archive d'applications Web (WAR ou EAR)

Déployée automatiquement ?

Description jsfplatform

MobileOTA14

OpenSearch

AdminTools

Non

Non

Non

Oui

●

Live Office

●

Outil de requête de service Web

(anciennement Query as a Web

Service)

●

Publication

●

Moteur de rapport

●

SAP BusinessObjects Web

Intelligence (anciennement Web

Intelligence)

●

Services Web de SAP

BusinessObjects Dashboards

(anciennement Xcelsius)

Prise en charge de Java Server Faces et exemples.

Application Web de prise en charge de client mobile.

Prise en charge d'OpenSearch.

Prise en charge du générateur de requêtes.

Le tableau suivant compare les fichiers WAR inclus dans les versions précédentes et indique où trouver cette fonctionnalité dans la plateforme de BI 4.2.

Ancienne archive d'applications Web (WAR ou EAR) Nouvelle archive d'applications Web (WAR ou EAR)

AdminTools AdminTools

AnalyticalReporting

BusinessProcessBI

BOE

BusinessProcessBI (obsolète)

CmcApp

CmcAppActions

BOE

BOE

CrystalReports

Xcelsius dswsbobje

InfoViewApp

InfoViewAppActions

LCM

OpenDocument

PerformanceManagement

PlatformServices

PMC_Help

BOE

BOE dswsbobje

BOE

BOE

BOE

BOE

BOE

BOE

BOE

14

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

Guide de déploiement d'applications Web

Présentation du déploiement d'applications Web.

Ancienne archive d'applications Web (WAR ou EAR) Nouvelle archive d'applications Web (WAR ou EAR)

VoyagerClient BOE

XCTemplateUploader BOE

3.3.1 Pour déployer MobileOTA14.war pour la prise en charge des applications mobiles

Le programme d'installation de la plateforme de BI ne déploie pas l'application Web MobileOTA14 qui assure la prise en charge des applications mobiles.

Pour pouvoir utiliser des applications mobiles, vous devez déployer l'archive MobileOTA14.war

(MobileOTA14.war ou MobileOTA14.ear) manuellement une fois le processus d'installation terminé.

Remarque

L'outil d'interface utilisateur graphique WDeploy ne peut pas être utilisé pour déployer des applications Web individuelles. Pour déployer une application Web individuelle, telle que MobileOTA14, utilisez l'outil de ligne de commande WDeploy.

1. Avant de déployer l'application Web MobileOTA14, assurez-vous que le fichier de configuration de WDeploy config.

<SERVEUR_APPLICATIONS_WEB>

a été correctement configuré pour votre serveur d'applications

Web. Voir

Fichiers de configuration WDeploy

[page 32].

2. Déployez l'application Web MobileOTA14.

Pour déployer l'application Web MobileOTA, utilisez la commande WDeploy suivante : wdeploy.sh

<SERVEUR_APPLICATIONS_WEB>

-Dwar_dir=

<EMPLACEMENT_DE_MOBILEOTA14.WAR>

-DAPP=MobileOTA14

deploy

La commande suivante, par exemple, permet de déployer MobileOTA14 sur un serveur d'applications Web

WebSphere 7 : wdeploy.sh websphere7

-Dwar_dir=/sap/sap/businessobjects_xi40/mobile_14/Client

-DAPP=MobileOTA14

deploy

3. Redémarrez le serveur d'applications Web.

4. Accédez à l'URL suivante pour vous assurer du bon fonctionnement de l'application Web MobileOTA14 : http://

<NOM_HOTE>

:

<PORT>

/MobileOTA14

Remplacez

<NOM_HOTE>

par le nom d'hôte du serveur d'applications Web et

<PORT>

par le numéro de port du serveur d'applications Web.

Pour en savoir plus sur les produits Mobile, reportez-vous au Guide d'installation et de déploiement de SAP

BusinessObjects Mobile.

Guide de déploiement d'applications Web

Présentation du déploiement d'applications Web.

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

15

3.3.2 Déploiement d'OpenSearch.war pour la prise en charge d'OpenSearch

Le programme d'installation ne déploie pas l'application Web OpenSearch qui assure la prise en charge des applications OpenSearch.

Pour pouvoir utiliser des applications OpenSearch, vous devez déployer le fichier d'archive OpenSearch.war manuellement une fois que le processus d'installation est terminé.

Remarque

L'outil d'interface utilisateur graphique WDeploy ne peut pas être utilisé pour déployer des applications Web individuelles. Pour déployer une application Web individuellement, telle qu'OpenSearch, utilisez l'outil de ligne de commande WDeploy.

1. Assurez-vous que les détails de connexion du serveur d'applications Web ont été définis dans le fichier de configuration du serveur d'applications Web de WDeploy. Le fichier se trouve à l'emplacement suivant :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/conf/config.

<SERVEUR_APP_WEB>

Pour en savoir plus sur le fichier de configuration du serveur d'applications Web de WDeploy, voir la rubrique

“Fichiers de configuration” du Guide de déploiement d'applications Web de la plateforme SAP BusinessObjects

Business Intelligence.

2. Mettez à jour la configuration d'OpenSearch dans le fichier config.properties d'applications Web

OpenSearch. Le fichier se trouve à l'emplacement suivant :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/warfiles/OpenSearch/WEB-INF

Assurez-vous que les paramètres suivants sont configurés sur votre serveur :

○ cms : Nom et numéro de port du CMS. Par exemple, utilisez le format :

<NOM_HOTE_CMS>

:

<PORT>

.

○ opendoc : URL de l'application Web OpenDocument. Par exemple : http://

<NOMHOTE_SAW>

:

<PORT>

/BOE/OpenDocument/opendoc/openDocument.jsp.

○ proxy.rpurl : URL du serveur proxy inverse, si votre organisation en utilise un.

○ proxy.opendoc.rpurl : URL du serveur proxy inverse OpenDoc si votre organisation en utilise un.

3. Déployez l'application Web OpenSearch.

Pour déployer l'application Web OpenSearch, utilisez la commande WDeploy suivante : wdeploy.sh <WEB_APPLICATION_SERVER>

-Dapp_source_dir=<LOCATION_OF_OPENSEARCH_WEB_APP_SOURCE_TREE>

-DAPP=OpenSearch

deploy

La commande suivante, par exemple, permet d'effectuer le déploiement de l'application Web OpenSearch sur un serveur d'applications Web WebSphere 7 : wdeploy.sh websphere7

-Dwar=/sap/sap_bobj/enterprise_xi40/warfiles/OpenSearch

-DAPP=OpenSearch

deploy

Pour en savoir plus sur les produits associés à OpenSearch, voir la section “OpenSearch” du Guide

d'administration de la plateforme SAP BusinessObjects Business Intelligence.

16

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

Guide de déploiement d'applications Web

Présentation du déploiement d'applications Web.

3.4 Racines de contexte par défaut

Toutes les applications Web peuvent être déployées dans une racine de contexte personnalisée sur votre serveur d'applications Web. Le tableau suivant répertorie les racines de contexte pour chaque application Web.

Application Web

Central Management Console (CMC)

Zone de lancement BI

Open Document

API JavaScript de SAP Crystal Reports

Fournisseur de services Web

Processus professionnels BI (obsolète)

Chemin du contexte

/BOE/CMC

/BOE/BI

/BOE/OpenDocument

/clientapi

/dswsbobje

/BusinessProcessBI

3.5 Contextes racine personnalisés et chemins de contexte

Les applications Web de la plateforme de BI peuvent être déployées dans un emplacement personnalisé sur un serveur d'applications Web. Cet emplacement, reflété dans l'URL utilisée pour accéder à l'application Web à partir d'un navigateur Web, est souvent désigné sous le terme de contexte.

Un contexte racine correspond au dossier de niveau supérieur sur un serveur d'applications Web hébergeant des applications Web. Le contexte racine par défaut des applications Web de la plateforme de BI est /BOE. Par exemple, sur un serveur d'applications Web nommé www.mycompany.com, le préfixe de l'URL utilisée pour accéder aux applications Web du serveur serait http://www.mycompany.com/BOE/.

Un chemin de contexte (parfois désigné sous le terme de répertoire virtuel) est un dossier dans un contexte racine, dans lequel réside une application Web. Par exemple, le chemin de contexte par défaut de l'application

Zone de lancement BI est /BI. L'URL utilisée pour accéder à l'application Web Zone de lancement BI sur un serveur d'applications Web nommé www.mycompany.com serait http://www.mycompany.com/BOE/BI.

Le contexte racine et le chemin de contexte peuvent tous deux être modifiés pour mieux répondre aux exigences de votre organisation. Le tableau suivant présente des exemples de déploiement d'une application Web nommée

MyApp vers différents chemins de contexte racine et d'applications Web. Les rubriques suivantes expliquent comment personnaliser des chemins de contexte racine et d'applications Web.

3.5.1 Modification du contexte racine

Vous pouvez modifier le contexte racine utilisé par les applications Web de la plateforme de BI (à l'exclusion de l'application Web AdminTools. AdminTools doit utiliser le contexte racine par défaut pour fonctionner correctement). Par défaut, le contexte racine est vide, de sorte que le chemin de contexte est affiché directement après l'adresse du serveur dans une URL.

Par exemple, un contexte racine vide entraîne une URL telle que http://localhost:8080/BOE/CMC où http://localhost:8080/ est le serveur et le numéro de port, sans contexte racine ; BOE/CMC est le chemin de

Guide de déploiement d'applications Web

Présentation du déploiement d'applications Web.

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

17

contexte de l'application Web. Définir le contexte racine /MON_ENTITE remplacerait l'exemple d'URL ci-dessus par http://localhost:8080/MON_ENTITE/BOE/CMC.

Lors de l'utilisation de l'outil WDeploy, le contexte racine peut être défini dans l'écran

Options

. Lors de l'utilisation des outils de ligne de commande WDeploy, le contexte racine des applications Web de la plateforme de BI est défini dans le fichier de configuration suivant :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/conf/wdeploy.conf

Utilisez un éditeur de texte pour mettre à jour la valeur root_context_path spécifiée dans wdeploy.conf.

Par exemple, le fichier de configuration wdeploy.conf contient les paramètres par défaut suivants : as_lang=en work_dir= war_dir= app_source_tree= disable_CMC=false disable_InfoView=false

JCoStandalone= root_context_path= recent_app_svr=

<SERVEUR_APP_WEB>

3.5.2 Modification du chemin de contexte d'une application

Web

Vous pouvez modifier le chemin de contexte par défaut (parfois désigné sous le terme de répertoire virtuel) des applications Web de la plateforme de BI.

Par exemple, le chemin de contexte par défaut de l'application Web BOE est BOE, comme indiqué dans l'exemple d'URL http://localhost:8080/BOE/CMC. Dans cet exemple, http://localhost:8080/ est le serveur et le numéro de port, BOE est l'application Web et /CMC est un composant inclus dans l'application Web BOE.

Le chemin de contexte des applications Web de la plateforme de BI est défini dans le fichier de configuration suivant :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/conf/apps/

<APP_WEB>

.properties

Servez-vous d'un éditeur de texte pour mettre à jour la valeur du paramètre appvdir qui se trouve dans le fichier de configuration APP_WEB.properties.

Par exemple, le fichier de configuration BOE.properties contient les paramètres par défaut suivants : warfile=BOE.war

appvdir=BOE buildfile=BOE.xml

osgisupported=true

18

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

Guide de déploiement d'applications Web

Présentation du déploiement d'applications Web.

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

4.1 Présentation de wdeploy

L'outil WDeploy est inclus dans la plateforme de BI pour faciliter le déploiement d'applications Web sur des serveurs d'applications Web Java.

Il existe deux interfaces pour WDeploy :

● Une interface textuelle traditionnelle qui traite les commandes et les paramètres de la ligne de commande.

● Un nouvel assistant basé sur la console, identique au programme d'installation de la plateforme de BI, qui invite l'utilisateur à saisir les paramètres de déploiement.

Tandis que chaque serveur d'applications Web pris en charge requiert différentes commandes et packages de mises à jour des applications Web, WDeploy fournit une interface constante pour les administrateurs et automatise les ajustements nécessaires au déploiement sur un serveur d'applications Web spécifique.

Par exemple, pour déployer une application Web sur un serveur d'applications Web IBM WebSphere, une commande WDeploy unique effectue les tâches suivantes :

1. Elle crée les paramètres spécifiques à IBM WebSphere dans le fichier web.xml de l'application Web.

2. Elle place le contenu d'applications Web dans une archive Web.

3. Elle crée un fichier EAR qui contient l'application Web.

4. Elle appelle les outils de déploiement IBM WebSphere pour déployer l'application Web.

4.2 Conditions préalables à l'utilisation de l'outil WDeploy

Cette section énonce les prérequis pour le déploiement des applications Web de la plateforme de BI sur les serveurs d'applications Web compatibles.

Remarque

Avant de déployer des applications Web sur WebSphere, voir

WASX7017E : exception lors du déploiement dans

WebSphere

[page 98].

Pour en savoir plus sur les conditions préalables à l'utilisation de l'interface graphique utilisateur de WDeploy, voir

Prérequis concernant l'utilisation de l'outil WDeploy GUI

[page 73].

4.2.1 Avant de déployer des applications Web

Votre serveur d'applications Web doit être installé et en cours de fonctionnement avant d'installer la plateforme de BI. Pour obtenir les instructions d'installation, consultez la documentation de votre serveur d'applications Web.

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.

19

Votre serveur d'applications Web doit disposer d'au moins 5 Go d'espace disque disponible, en plus de l'espace requis par les autres logiciels installés sur l'ordinateur.

Il est recommandé de modifier les paramètres de taille de tas et de taille maximale autorisée de votre JVM comme suit :

-Xms128m -Xmx2048m -XX:MaxPermSize=512m

. Par exemple, si vous utilisez Tomcat, vos paramètres modifiés doivent ressembler à ceci :

JAVA_OPTS="-Xms128m -Xmx2048m -XX:MaxPermSize=512m"

Remarque

Dans le cas de SAP NetWeaver, assurez-vous que la taille de tas maximale est d'au moins 4 096 Mo. Par exemple : JAVA_OPTS="-Xms128m -Xmx4096m -XX:MaxPermSize=512m"

Pour en savoir plus sur la modification des paramètres de votre mémoire Java, consultez la documentation de votre JVM.

Avant de lancer la procédure de déploiement, vérifiez que le serveur d'applications Web est correctement installé et qu'il s'exécute correctement en lançant sa console d'administration.

4.2.2 Configuration matérielle requise

Le déploiement des applications Web sur un serveur d'applications Web avec l'outil WDeploy nécessite au moins

4 Go de RAM (8 Go pour SAP NetWeaver) et 15 Go d'espace disque libre, ainsi qu'un minimum de 5 Go d'espace libre sur la partition hébergeant le dossier temporaire /tmp pour le déploiement d'applications Web. Cette condition vient s'ajouter à toute autre condition requise par le serveur d'applications Web ou tout autre serveur ou service installé sur l'hôte.

4.2.3 Prise en charge 64 bits

La plateforme de BI n'est prise en charge que sur des systèmes d'exploitation 64 bits et ne prend en charge que des serveurs d'applications Web 64 bits avec un JDK 64 bits.

4.2.4 Droits minimums requis pour le déploiement d'applications Web avec un compte différent

Conseil

Il est recommandé d'installer la plateforme de BI et d'exécuter l'outil WDeploy (wdeploy.sh) avec le compte utilisateur utilisé pour installer le serveur d'applications Web.

Pour déployer des applications Web à l'aide de l'outil WDeploy avec un compte utilisateur différent de celui utilisé pour installer le serveur d'applications Web, vous devez vous assurer que ce compte dispose des droits

20

©

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

appropriés pour certains répertoires du serveur d'applications Web. Définissez les droits figurant dans le tableau suivant avant d'exécuter l'outil WDeploy. Vous pouvez aussi vous assurer que ce compte distinct appartient au même groupe que le compte du serveur d'applications Web et définir les droits uniquement pour les colonnes

Utilisateur et Groupe.

Remarque

Outre les droits d'exécution des fichiers ou des dossiers mentionnés dans les tableaux ci-dessous, les droits d'exécution sont également requis sur le répertoire parent.

Tomcat 6 et 7

Répertoire Récursif

Répertoire de base du compte utilisateur Tomcat et sous-répertoire du dossier utilisateur de la plateforme de BI

Non

Non Répertoire de déploiement des applications Web

(

$as_dir/ webapps )

Répertoire des fichiers binaires

Tomcat

( $as_dir/bin )

Non

Répertoire de configuration de

Tomcat

(

$as_dir/conf

)

Oui

Répertoire des bibliothèques

Tomcat

( $as_dir/lib )

Non

Utilisateur rwx

Groupe r-x rwx rwx rwx rwx rwx rwx rwx r-x

Autre r-x rwx rwx rwx r-x

Exemple de commande chmod 755

~<TOMCAT_US

ER> chmod 777

<TC_HOME>/ webapps chmod 777

<TC_HOME>/ bin chmod -R

777

<TC_HOME>/ conf chmod 755

<TC_HOME>/ lib/*

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.

21

WebLogic 11gR1

Répertoire Récursif

Répertoire de base du compte utilisateur

WebLogic et sousrépertoire du dossier utilisateur de la plateforme de

BI

Non

Non Fichiers binaires du domaine Web

( $WL_HOME/

<PROJET>/

<DOMAINE>/

<BASE>/bin )

Bibliothèques du serveur WebLogic

(

$WL_HOME/ server/lib )

Non

Utilisateur rwx

Groupe r-x rwx rwx rwx r-x

Autre r-x rwx r-x

Fichiers binaires du serveur

WebLogic

( $WL_HOME/ server/ domains/ base_domain common/bin )

Modules serveur

WebLogic

(

$WL_HOME/ server/ domains/ base_domain modules )

Java WebLogic

( $WL_HOME/ jdk150_06

)

Non

Non

Non rwx rwx rwx

22

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

rwx rwx rwx

Exemple de commande chmod 755

<WL_USER> r-x r-x r-x chmod 777

<WL_HOME>/ user_projec ts/ domains/ base_domain

/bin chmod 755

<WL_SERVER>

/ user_projec ts

/ lib chmod 775

<WL_SERVER>

/ user_projec ts /bin chmod 775

<WL_SERVER>

/ modules chmod 775

<WL_SERVER>

/ jdk150_06

Guide de déploiement d'applications Web

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

WebSphere 7.0, 8.5 et 8.5.5

Répertoire Récursif

Répertoire de base du compte utilisateur

WebSphere et sous-répertoire du dossier utilisateur de la plateforme de

BI

Non

Oui Répertoire des profils WebSphere

( $WEBS_HOME/

AppServer/ profiles )

Utilisateur rwx rwx

Groupe r-x rwx rwx r-x Script d'administration

WebSphere

( $as_dir/bin/ wsadmin.sh

)

Non

Script de plug-in

WebSphere

( $as_dir/bin/

GenPluginCfg.

sh )

Non rwx r-x

Autre r-x rwx r-x r-x

Sécurité

WebSphere

( $as_dir/bin/ securityProcs

.jacl

)

Non rwx

Sécurité

WebSphere

( $as_dir/bin/

LTPA_LDAPsecu rityProcs.jac

l )

Non rwx

Guide de déploiement d'applications Web

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

r-x r-x r-x r-x

Exemple de commande chmod 755

~<WEBSPHERE

_USER> chmod -R

777

<WEBSPHERE_

HOME>/

AppServer/ profiles chmod 755

<WEBSPHERE_

HOME>/ bin/ wsadmin.sh

chmod 755

<WEBSPHERE_

HOME>/ bin/

GenPluginCf g.sh chmod 755

<WEBSPHERE_

HOME>/ bin/ securityPro cs.jacl

chmod 755

<WEBSPHERE_

HOME>/ bin/

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

23

Répertoire Récursif

Répertoire des plug-ins

WebSphere

( $as_dir/ plugins )

Non

Répertoire Java

WebSphere

( $as_dir/java )

Non

Répertoire de l'outil de déploiement de

WebSphere

(

$as_dir/ deploytool )

Répertoire des propriétés de

WebSphere

( $as_dir/ properties )

Non

Non

Utilisateur rwx rwx rwx rwx

Groupe r-x r-x r-x r-x

Autre r-x r-x r-x r-x

Exemple de commande

LTPA_LDAPse curityProcs

.jacl chmod 755

<WEBSPHERE_

HOME>/ plugins chmod 755

<WEBSPHERE_

HOME>/ java chmod 755

<WEBSPHERE_

HOME>/ deploytool chmod 755

<WEBSPHERE_

HOME>/ properties

Remarque

Vous devez accepter le certificat SSL du serveur d'applications Web WebSphere pour pouvoir utiliser Wdeploy.

Pour accepter le certificat, utilisez la commande wsadmin dans le format

<WEBSPHERE_HOME>/AppServer/bin/wsadmin

-conntype SOAP -port <ADMIN_PORT> -user <AS_ADMIN_USERNAME>

-password <AS_ADMIN_PASSWORD>

. Par exemple :

./wsadmin -conntype SOAP

-port 8880 -user administrator -password websphere

24

©

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.2.5 Définissez ulimit sur illimité

Pour créer et déployer correctement les applications Web de la plateforme de BI, le paramètre ulimit du système d'exploitation hôte ou du compte utilisateur doit être défini sur illimité.

Définissez la configuration ulimit à l'aide la commande ulimit ou modifiez le fichier de configuration système /etc/security/limits.conf. Pour en savoir plus sur le paramètre ulimit, voir la documentation fournie avec votre système d'exploitation.

4.2.7 Pour configurer l'environnement Java

WDeploy requiert qu'un ordinateur Java virtuel soit disponible sur le système hôte. Le kit de développement Java

(JDK) est installé automatiquement par le programme d'installation de la plateforme de BI mais doit être installé ou copié à partir du serveur de la Plateforme de BI s'il a été installé manuellement sur un ordinateur dédié.

Le JDK installé par le programme d'installation de la plateforme de BI est utilisé par défaut. Si vous utilisez un serveur d'applications Web dédié, vous devez configurer le JDK en effectuant une installation de niveau Web ou en installant manuellement un JDK approprié (1.5 ou 1.6 en fonction de la prise en charge par le serveur d'applications Web). Lors d'une configuration manuelle du JDK, assurez-vous que les paramètres d'environnement suivants ont été configurés :

● WDeploy tente d'abord d'utiliser la JVM installée avec la plateforme de BI. S'il ne trouve pas cette JVM,

WDeploy tente alors d'utiliser le paramètre de variable d'environnement

<JAVA_HOME>

défini pour un répertoire Java valide. Si aucune JVM valide ou appropriée n'est trouvée, WDeploy se ferme.

● La variable d'environnement PATH du compte utilisateur inclut :

<JAVA_HOME>

/bin

● Pour que WDeploy puisse s'exécuter depuis n'importe quel répertoire, vous devez actualiser la variable d'environnement PATH de façon à ce qu'elle inclue :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy.

4.2.8 Fichiers de configuration des paramètres du serveur d'applications Web

Avant d'utiliser l'interface de ligne de commande WDeploy pour déployer une application Web, vérifiez que les paramètres sont correctement définis dans le fichier de configuration des paramètres du serveur de déploiement d'applications Web WDeploy. Les paramètres définis sont utilisés par défaut et n'ont plus besoin d'être renseignés dans la ligne de commande.

Remarque

Vous n'avez besoin de définir aucun paramètre dans ces fichiers de configuration du déploiement si vous utilisez l'interface graphique utilisateur ou si vous n'effectuez que le prédéploiement à l'aide des commandes wdeploy predeploy ou wdeploy predeployall.

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.

25

Le fichier de configuration correspondant à votre serveur d'applications Web se trouve dans le dossier suivant :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/conf. Par exemple, si vous utilisez Tomcat 7, sélectionnez /opt/sap/sap_bobj/enterprise_xi7/wdeploy/conf/config.tomcat7.

Utilisez un éditeur de texte pour mettre à jour les valeurs spécifiques au serveur d'applications Web de votre

entreprise. Pour en savoir plus sur la configuration des fichiers de configuration WDeploy, voir

Fichiers de configuration WDeploy

[page 32].

Lorsque vous appelez WDeploy depuis la ligne de commande, vous pouvez remplacer les paramètres définis dans le fichier de configuration des paramètres du serveur d'applications Web WDeploy en utilisant des commutateurs et des paramètres pour modifier le comportement par défaut. Cependant, il est vivement recommandé de configurer les paramètres dans le fichier de configuration config.

<SERVEUR_APP_WEB>

approprié pour votre déploiement.

4.2.9 Installation de WDeploy sur un serveur d'applications

Web distant

Pour déployer des applications Web sur un serveur d'applications Web dédié, effectuez une installation

Niveau

Web

ou une installation

Personnalisée/Etendue

à l'aide du programme d'installation de la plateforme de BI. Si vous préférez copier l'outil WDeploy manuellement, copiez le dossier suivant sur le serveur d'applications Web :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy.

Remarque

Lors de la copie manuelle de l'outil WDeploy, assurez-vous que la variable d'environnement JAVA_HOME est configurée de manière appropriée sur le serveur d'applications Web.

4.3 Enregistrement du répertoire du paysage système (SLD)

SAP

Votre organisation peut utiliser SAP System Landscape Directory Data Supplier (SLD-DS) pour gérer un référentiel central contenant des informations sur les logiciels SAP qu'elle utilise. Celui-ci fournit aux administrateurs des informations détaillées sur la topologie et les composants logiciels du système. Pour en savoir plus sur la configuration de la plateforme de BI pour le répertoire du paysage système, voir

“Enregistrement de la plateforme de BI dans le paysage système” dans le Guide d'administration de la plateforme

de Business Intelligence et la note SAP 1653689.

L'enregistrement SLD envoie une notification au répertoire du paysage système chaque fois qu'un déploiement d'applications Web a lieu ou est annulé, ce qui fait que la base de données du répertoire du paysage système reste

à jour et contient toujours les informations les plus récentes en ce qui concerne les déploiements d'applications

Web au sein de l'entreprise.

Les composants d'applications Web peuvent être enregistrés auprès du répertoire du paysage système sur les serveurs d'applications Web suivants :

26

©

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

● SAP NetWeaver

● Apache Tomcat 6.0 et 7.0

● IBM WebSphere 7.0

4.3.1 Pour activer l'enregistrement SLD pour SAP NetWeaver

L'intégration du fournisseur de données du répertoire du paysage système (SLD-DS) est disponible pour SAP

NetWeaver. Pour des informations sur l'intégration SLD-DS et NetWeaver, voir le document SCN du répertoire du paysage système à l'adresse :

http://scn.sap.com/docs/DOC-8042

.

4.3.2 Pour activer l'enregistrement SLD pour Tomcat

Pour utiliser le fournisseur de données du répertoire du paysage système (SLD-DS) SAP avec Apache Tomcat, l'outil d'enregistrement SLDREG doit être installé sur chaque serveur d'applications Web Apache Tomcat.

Remarque

SLDREG n'est pas installé dans le cadre de la plateforme de BI. Pour en savoir plus sur l'installation de SLDREG, voir la note SAP 1018839.

Pour configurer SLDREG de manière à ce que le SLD soit mis à jour à chaque déploiement ou annulation de déploiement d'applications Web sur un serveur d'applications Web Apache Tomcat, reportez-vous à la Note

SAP 1508421.

Remarque

Le fichier sap.com~TomcatSLDDataSupplierWEB.war joint à la Note SAP 1508421 se trouve également dans le dossier

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/warfiles/webapps lorsque la fonctionnalité

Applications Web Java

a été installée au cours d'une installation de type

Niveau Web

.

4.3.3 Pour activer l'enregistrement SLD pour WebSphere

Pour utiliser le fournisseur de données du répertoire du paysage système (SLD-DS) SAP avec WebSphere, l'outil d'enregistrement SLDREG doit être installé sur chaque serveur d'applications Web WebSphere.

Remarque

SLDREG n'est pas installé dans le cadre de la plateforme de BI. Pour en savoir plus sur l'installation de SLDREG, voir la note SAP 1018839.

Pour configurer SLDREG de manière à ce que le SLD soit mis à jour à chaque déploiement ou annulation de déploiement d'applications Web sur un serveur d'applications Web WebSphere, reportez-vous à la Note

SAP 1482727.

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.

27

4.4 Modes de déploiement

WDeploy prend en charge deux modes de déploiement différents :

1. Mode autonome (un serveur d'applications Web)

Le serveur d'applications Web distribue à la fois du contenu statique (pages HTML, images, documents,

JavaScript, feuilles de style en cascade CSS) et du contenu dynamique (Java Server Pages, fichiers JAR, fichiers XML).

2. Mode de niveau Web divisé (un serveur d'applications Web plus un serveur Web dédié)

Un serveur Web dédié reçoit des requêtes des navigateurs Web et distribue l'ensemble du contenu statique

(pages HTML, images, documents, JavaScript, feuilles de style CSS). Les requêtes concernant le contenu dynamique (Java Server Pages, fichiers JAR, fichiers XML) sont transmises au serveur d'applications dédié puis renvoyées au navigateur Web une fois que le contenu a été mis en forme.

Ce mode est adapté aux déploiements à forte production où extensibilité et performance sont primordiales.

Il est également possible d'utiliser WDeploy pour déployer des applications Web sur un serveur d'applications

Web installé sur le même système que la plateforme de BI. Cette configuration peut servir pour les systèmes à développement réduit ou pour les systèmes de test. Elle est déconseillée dans le cas des systèmes de production.

4.4.1 Déploiements autonomes

Le mode autonome fait référence à un serveur d'applications Web qui sert à la fois le contenu statique et le contenu dynamique aux clients Web. Le serveur d'applications Web peut être exécuté sur le même ordinateur que la plateforme de BI ou sur un ordinateur séparé connecté par réseau.

Dans le diagramme suivant, les clients Web se connectent via un pare-feu à un serveur d'applications Web [1] qui sert à la fois le contenu statique et le contenu dynamique. Les requêtes de traitement du serveur d'applications

Web sont envoyées au CMS (Central Management Server) de la plateforme de BI [2].

Dans le diagramme ci-dessus, le WDeploy est installé en tant que composant du CMS [2] et les applications Web sont réparties dans les répertoires pour contenu statique et dynamique. Le contenu dynamique peut désormais

être copié dans le serveur d'applications Web [1].

L'outil WDeploy peut également être installé ou copié sur un serveur d'applications Web dédié [1], facilitant ainsi le déploiement de contenu séparé reçu d'un CMS [2].

Ce mode est parfaitement adapté aux déploiements de petite taille avec un nombre d'utilisateurs limité. Un déploiement autonome a cet avantage qu'il est simple à déployer et à gérer, mais peut réduire le nombre d'utilisateurs, car le serveur d'applications Web fournit à la fois du contenu statique et du contenu dynamique.

28

©

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.4.2 Déploiements de niveau Web divisé

Un déploiement de niveau Web divisé sépare le contenu statique et dynamique des applications Web de sorte que le contenu statique soit servi par un serveur Web dédié et le contenu dynamique par un serveur d'applications

Web. Les serveurs Web et serveurs d'applications Web peuvent être exécutés sur le même ordinateur ou sur des ordinateurs distincts connectés à un réseau.

Remarque

Les applications Web suivantes ne sont pas prises en charge dans les déploiements en mode de niveau Web divisé :

● Web Services

● MobileOTA14

● OpenSearch

● jsfplatform

Dans le diagramme suivant, les clients Web se connectent via un pare-feu à un serveur Web [1] qui distribue uniquement du contenu statique (pages HTML, images, documents, JavaScript, feuilles de style CSS). Lorsque du contenu dynamique est requis, le serveur Web envoie une requête au serveur d'applications Web [2]. Toute requête nécessitant un traitement supplémentaire de la plateforme de BI est envoyée au CMS (Central

Management Server) pour y être traitée [3].

Dans le diagramme ci-dessus, le WDeploy est installé en tant que composant du CMS [3] et les applications Web sont réparties dans les répertoires pour contenu statique et dynamique. Le contenu dynamique peut désormais

être copié dans le serveur d'applications Web [2] et le contenu statique dans le serveur Web [1].

La commande WDeploy peut également être installée sur des serveurs Web [1] et des serveurs d'applications

Web [2] dédiés, facilitant ainsi le déploiement de contenu séparé reçu d'un CMS [3].

Si une entreprise implémente des mesures de sécurité visant à limiter l'accès aux ordinateurs serveurs, les contenus statiques et dynamiques séparés peuvent être envoyés séparément à ceux ayant autorité pour déployer du contenu.

Les déploiements divisés sont parfaitement adaptés aux déploiements de taille moyenne ou grande avec un nombre d'utilisateurs élevé ou en augmentation. Un déploiement divisé présente l'avantage d'être évolutif et de fournir de bonnes performances.

Remarque

Les serveurs Web, les serveurs d'applications Web et les serveurs de la plateforme de BI peuvent être regroupés en cluster pour parvenir à un niveau d'évolutivité, de disponibilité et de performances encore plus

élevé.

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.

29

4.4.2.1 Combinaisons de serveur Web et de serveur d'applications Web dédiés pris en charge

Pour les déploiements divisés, WDeploy prend en charge les configurations de serveurs Web et de serveurs d'applications Web suivantes :

● Serveur Web Apache 2.2 avec Tomcat 6 ou 7

● Serveur Web Apache 2.2 avec WebLogic 10.3.x

● Serveur Web IBM IHS 7 avec WebSphere 7.0.

● Serveur Web IBM IHS 8.5 avec WebSphere 8.5 ou 8.5.5

Remarque

Les serveurs Web Apache et IBM IHS sont tous indiqués en tant qu'apache dans les fichiers de configuration

WDeploy.

4.4.2.2 Pour déployer des applications Web sur un ordinateur distant

Utilisez la procédure ci-dessous pour déployer des applications Web sur un ordinateur distant. Dans cette procédure, la boîte 1 se rapporte à l'ordinateur qui héberge une installation de la plateforme de BI et la boîte 2 à l'ordinateur distant sur lequel le serveur d'applications Web est installé.

1. Créez sur la boîte 2 les répertoires suivants.

○

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy. Ce dossier contient les scripts et les fichiers de configuration WDeploy.

○

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/warfiles/webapps

○

<<REP_INSTALL_PBI>

/InstallData

Ces répertoires sont conformes à la structure de répertoires par défaut installée sur la boîte 1.

Conseil

Bien que vous puissiez personnaliser la structure de dossiers pour répondre à vos besoins spécifiques, il est recommandé de conserver les fichiers dans la même structure ou hiérarchie dans la boîte 2 comme dans la boîte 1.

2. Copiez les fichiers suivants de la boîte 1 vers la boîte 2.

○ Dossier

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy.

Conseil

Supprimez le contenu du dossier

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/ workdir avant la copie du fichier si ce dossier n'est pas vide.

○ Dossier

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/warfiles/webapps.

30

©

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

○ Dossier

<REP_INSTALL_BPI>

/InstallData/setup.engine.

3. Définissez la variable d'environnement JAVA_HOME au répertoire de JDK 1.5 ou 1.6.

4. Modifiez le fichier de configuration de WDeploy pour votre serveur d'applications Web. Fournissez toutes les informations requises pour permettre à WDeploy de déployer l'application Web.

Par exemple, pour modifier le fichier de configuration pour WebLogic 11, modifiez le fichier comme suit : as_domain_dir=C:\Oracle\Middleware\user_projects\domains\base_domain as_instance=AdminServer as_admin_port=7001 as_admin_username=weblogic as_admin_password=weblogic

Le fichier de configuration se trouve dans le répertoire suivant :

<REP_INSTALL_BOE>

/sap_bobj/enterprise_xi40/wdeploy/conf/config.

<SERVEUR_APP_WEB>

5. Exécutez le script WDeploy à partir de son emplacement dans la boîte 2 en ouvrant la console de ligne de commande et en saisissant la commande suivante :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/wdeploy.sh

<SERVEUR_APP_WEB>

-Dapp_source_tree=“

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/warfiles/ webapps”

deployall

Remarque

○ Vous pouvez définir des valeurs par défaut de paramètres WDeploy dans le fichier de configuration

WDeploy

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/conf/wdeploy.conf au lieu de fournir les paramètres dans la ligne de commande. Par exemple, définissez les paramètres :

○ app_source_tree ou war_dir

○ work_dir

○ root_context_path

Pour en savoir plus, voir

Fichier de configuration WDeploy

[page 32].

○ Transmettez l'argument -Dwar_dir pour spécifier l'emplacement des fichiers WAR génériques comme entrée pour le déploiement. Par exemple, pour déployer un fichier BOE.war générique :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/wdeploy.sh

<SERVEUR_APP_WEB>

-Dwar_dir="/myGenericWarFiles/BOE.war"

-DAPP=BOE

deploy

○ Pour créer des fichiers WAR génériques pour toutes les applications de la plateforme de BI, exécutez la commande suivante :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/wdeploy.sh

buildwarall

-Dapp_source_tree=“

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/ warfiles/webapps”

-Dwar_dir=“/myGenericWarFiles”

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.

31

○ Transmettez le paramètre -Dwar_dir=

<EMPLACEMENT_CIBLE_DES_FICHIERS_WAR_GENERIQUES>

pour spécifier l'emplacement de destination des fichiers WAR génériques.

4.5 Fichiers de configuration WDeploy

Les fichiers de configuration WDeploy contiennent des paramètres enregistrés au format texte sous forme de paires clé-valeur. Les options et paramètres enregistrés dans les fichiers de configuration, qui sont lus par

WDeploy à son lancement, sont utilisés comme paramètres par défaut et n'ont plus à être indiqués sur la ligne de commande. Il est toutefois possible de les indiquer sur la ligne de commande, ce qui écrase dans ce cas le fichier de configuration. Les options et les paramètres indiqués sur la ligne de commande n'entraînent aucune modification des options stockées dans les fichiers de configuration.

Remarque

Il est recommandé de ne pas stocker les mots de passe des comptes administrateur des serveurs d'applications Web dans le fichier de configuration WDeploy, mais plutôt de les transférer vers WDeploy depuis la ligne de commande en utilisant le paramètre -Das_admin_password=

<MOT DE PASSE>

.

WDeploy utilise trois fichiers de configuration, à savoir :

● Fichier de configuration WDeploy (

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/conf/ wdeploy.conf) : stocke les paramètres généraux WDeploy qui s'appliquent à tous les serveurs d'applications Web.

● Fichiers de configuration du serveur d'applications Web (

<REP_INSTALL_PBI>

/sap_bobj/ enterprise_xi40/wdeploy/conf/config.

<SERVEUR_APP_WEB>

) : stocke les paramètres d'un serveur d'applications Web donné.

● Fichier de configuration de l'application Web (

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/ wdeploy/conf/apps/

<WEB_APP>

.properties) : stocke les paramètres de déploiement de chacune des applications Web.

4.5.1 Fichier de configuration WDeploy

Le fichier de configuration

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/conf/ wdeploy.conf stocke les paramètres susceptibles d'être partagés par tous les serveurs d'applications Web de votre déploiement.

Les propriétés stockées dans le fichier de configuration WDeploy peuvent être remplacées à partir de la ligne de commande à l'aide du paramètre de commutation -D

<PROPRIETE>

. Cependant, il est vivement recommandé de configurer les paramètres dans le fichier de configuration config.

<SERVEUR_APP_WEB>

approprié pour votre déploiement.

Pour obtenir la liste complète des propriétés WDeploy, voir

Paramètres des propriétés WDeploy

[page 41].

32

©

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.5.2 Fichiers de configuration du serveur d'applications Web

Etant donné que chaque serveur Web et serveur d'applications Web nécessitent de paramètres WDeploy différents, l'outil WDeploy fait référence à un fichier de configuration pour chacun des serveurs pris en charge. Les fichiers de configuration sont stockés dans le dossier WDeploy conf comme suit :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/conf/config.

<SERVEUR_APP_WEB>

Remplacez

<SERVEUR_APP_WEB>

par le nom du serveur d'applications Web vers lequel l'outil WDeploy effectue le déploiement.

La liste suivante présente tous les fichiers de configuration pour les serveurs d'applications Web actuellement pris en charge :

● config.jboss7 (JBoss 7.1)

● config.sapappsvr73 (SAP NetWeaver)

● config.tomcat6 (Tomcat 6.0)

● config.tomcat7 (Tomcat 7.0)

● config.weblogic11 (WebLogic 10.3.x (11gR1))

● config.websphere7 (WebSphere 7.0)

● config.websphere8 (WebSphere 8.5 ou 8.5.5)

Les sections suivantes répertorient les options de configuration disponibles pour chaque serveur Web et serveur d'applications Web pris en charge.

4.5.2.1 Fichier de configuration de JBoss 7.1

Définissez les valeurs par défaut des paramètres suivants dans config.jboss7 (JBoss 7.1) pour éviter d'avoir chaque fois à les saisir sur la ligne de commande.

Table 3 : Paramètres WDeploy obligatoires pour JBoss 7.1

Nom du paramètre Description as_dir Emplacement installé du serveur d'applications Web JBoss

(

<JBOSS_HOME>

).

as_instance

Exemple

/opt/jboss-as-7.1.1.Final

: nom de l'instance du serveur d'ap­ plications JBoss.

default

4.5.2.2 Fichier de configuration SAP NetWeaver

Remarque

Actuellement, l'outil Wdeploy ne prend pas en charge le déploiement sur SAP NetWeaver. Vous devez utiliser les commandes wdeploy predeploy ou wdeploy predeployall de l'outil WDeploy pour créer des fichiers

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.

33

SCA et déployer manuellement à l'aide de SAP Software Update Manager (SUM). Vous n'avez pas besoin de définir de paramètres dans config.sapappsvr73 pour utiliser ces commandes de prédéploiement. (Notez que le fichier de configuration config.sapappsvr73 contient des paramètres pour toutes les versions prises en charge de SAP Netweaver, pas uniquement la version 7.3).

Définissez des valeurs par défaut pour les paramètres suivants dans config.sapappsvr73 pour éviter d'avoir chaque fois à les saisir sur la ligne de commande.

Table 4 : Paramètres WDeploy obligatoires pour SAP NetWeaver

Nom du paramètre Description as_dir Emplacement d'installation de SAP

NetWeaver.

as_sid as_instance

ID système de l'instance cible.

Nom de l'instance du serveur d'ap­ plications.

as_admin_port

Exemple

/opt/sap

AS1

JC01

Port de requête d'administration de

SAP NetWeaver.

50004

as_admin_username as_admin_password clear.temp.dirs

use.deploy.controller

time.to.wait.factor

Nom d'utilisateur du compte admi­ nistrateur de SAP NetWeaver.

Mot de passe du compte adminis­ trateur de SAP NetWeaver.

administrator password

Transmis à SAP NetWeaver pen­ dant le déploiement : bascule la suppression automatique des fi­ chiers temporaires. Doit être défini sur "true".

true

Transmis à SAP NetWeaver pen­ dant le déploiement : bascule l'utili­ sation du contrôleur de déploiement

SAP. Doit être défini sur "true".

true

Transmis à SAP NetWeaver pen­ dant le déploiement : attente en se­ condes du script WDeploy le temps que le serveur d'applications Web termine le déploiement (par exem­ ple, "1600").

1600

4.5.2.3 Fichier de configuration de Tomcat 6 ou 7

Définissez les valeurs par défaut des paramètres suivants dans config.tomcat6 ou config.tomcat7 pour

éviter d'avoir chaque fois à les saisir sur la ligne de commande.

34

©

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

Pour les déploiements sur un environnement divisé, où un serveur d'applications Web Tomcat est apparié avec un

serveur Web Apache dédié, voir

Déploiement sur des serveurs d'applications Web Apache et Tomcat distincts

[page 63].

Table 5 : Paramètres WDeploy obligatoires pour Tomcat 6 ou 7

Nom du paramètre Description as_instance Nom de l'instance du serveur d'applications.

as_service_name Nom du service Tomcat lors­ que le serveur d'applications est installé en tant que service

Windows (s'applique unique­ ment pour les installations sur

Microsoft Windows).

as_dir as_service_key as_service_key_value

Exemple

localhost

Tomcat6

ou

Tomcat7

Emplacement d'installation de

Tomcat 6 ou 7.

Clé de registre utilisée par

Tomcat pour fournir les para­ mètres Java (applicable uni­ quement pour les installations sur Microsoft Windows).

Paramètres Java de Tomcat : valeur de la clé de registre as_server_key.

/opt/tomcat

HKLM\SOFTWARE\Wow6432Node\Apache Software Foundation\Procrun 2.0\$<as_service_name>

\Parameters\Java

Options.

4.5.2.4 Fichier de configuration WebLogic 11gR1

Définissez des valeurs par défaut pour les paramètres suivants dans config.weblogic11 pour éviter d'avoir chaque fois à les saisir sur la ligne de commande.

Table 6 : Paramètres WDeploy obligatoires pour WebLogic 11gR1

Nom du paramètre Description as_admin_port Port de requête d'administration de

WebLogic.

Exemple

7001

as_admin_username

weblogic

as_admin_password as_instance

Nom d'utilisateur du compte admi­ nistrateur de WebLogic.

Mot de passe du compte adminis­ trateur de WebLogic.

Nom de l'instance du serveur d'ap­ plications WebLogic.

password

AdminServer

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.

35

Nom du paramètre as_domain_dir

Description

Répertoire de domaines de WebLo­ gic.

Exemple

/opt/bea/weblogic/ user_projects/domains/ base_domain

4.5.2.5 Fichier de configuration de WebSphere 7, 8.5 ou 8.5.5

Définissez les valeurs par défaut pour les paramètres suivants dans config.websphere7 ou config.websphere8 pour éviter de devoir les spécifier à chaque fois dans la ligne de commande.

Table 7 : Paramètres WDeploy obligatoires pour WebSphere 7, 8.5 ou 8.5.5

Nom du paramètre Description as_soap_port Numéro de port pour l'administration du serveur d'applications SOAP. S'il n'est pas défini, le numéro de port

SOAP par défaut est utilisé.

Exemple de valeur

8880

as_instance

server1

as_admin_password

Nom de l'instance du serveur d'appli­ cations WebSphere.

Mot de passe du compte administra­ teur de WebSphere.

password

as_admin_username as_profile_name as_virtual_host as_admin_is_secure

Nom d'utilisateur du compte adminis­ trateur de WebSphere.

administrator

Nom du profil créé pour le serveur d'applications WebSphere. Indiquez ce paramètre lorsqu'un profil autre que celui par défaut est utilisé pour le déploiement.

AppSrv01

Hôte virtuel auquel l'application doit

être liée.

default_host

Indique à WDeploy que la sécurité est activée sur WebSphere.

false

Remarque

Vous devez définir les valeurs des paramètres as_admin_username et as_admin_password lorsque la valeur du paramètre as_ad­ min_is_secure est true").

as_dir Emplacement d'installation de WebS­ phere.

/opt/IBM/WebSphere/AppServer

36

©

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

Nom du paramètre ws_instance enforce_file_limit as_plugin_cfg_dir

Description

Instance du serveur Web lorsque le déploiement est effectué dans un en­ vironnement partagé (serveur Web dédié).

Exemple de valeur

webserver1

Indique à WDeploy si le serveur d'ap­ plications Web risque ou non de ren­ contrer des problèmes lors du char­ gement d'applications contenant plus de 65 535 fichiers (

false

par défaut).

false

Emplacement du fichier plugincfg.xml WebSphere. Ce paramètre n'est requis que pour les déploie­ ments de niveau Web divisé.

/opt/

AppServers/IBM/

WebSphere7/profiles/

AppSrv01/config/ cells/

<nom_cellule>

/nodes/

<nœud_serveurweb>

/ servers/

<nom_serveurweb>

4.5.2.6 Serveurs Web dédiés dans les déploiements divisés

Lors du déploiement d'applications Web sur un serveur Web dédié en déploiements divisés, utilisez le nom du serveur Web pris en charge :

● config.apache (Apache Web Server ou IBM IHS)

Remarque

Il est recommandé de ne pas stocker les mots de passe des comptes administrateur des serveurs d'applications Web dans le fichier de configuration WDeploy, mais plutôt de les transférer vers WDeploy depuis la ligne de commande en utilisant le paramètre -Das_admin_password=

<MOT DE PASSE>

.

Les déploiements divisés utilisent un serveur d'applications Web dédié pour servir le contenu dynamique et un serveur Web dédié pour servir le contenu statique. Le tableau suivant répertorie les serveurs d'applications Web qui peuvent être configurés pour un déploiement divisé de la plateforme de BI.

Serveur d'applications

JBoss 7.1

SAP NetWeaver

Tomcat 6.0

Tomcat 7.0

WebLogic 11gR1

Serveur Web Apache

Non

Sans objet

Oui

Oui

Oui

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.

37

Serveur d'applications

WebSphere 7

WebSphere 8.5 et 8.5.5

Serveur Web Apache

Oui (IHS 7)

Oui (IHS 8.5)

4.5.2.6.1 Fichier de configuration Apache ou IBM IHS

(déploiement divisé)

Définissez les valeurs par défaut des paramètres suivants dans config.apache pour éviter de les renseigner dans la ligne de commande à chaque fois.

Remarque

Le même fichier de configuration (config.apache) est utilisé pour Apache 2.2 et IBM IHS.

Table 8 : Paramètres WDeploy obligatoires pour Apache 2.2 ou IBM IHS (déploiement divisé).

Nom du paramètre Description Exemple connector_type Type de connecteur Apache utilisé pour configurer le mode divisé.

tomcat6

deployment_dir Répertoire sous lequel WDeploy crée un sous-répertoire pour le con­ tenu statique traité par le serveur

Web. WDeploy crée un répertoire virtuel sur le serveur Web en map­ pant le sous-répertoire à l'URL

/opt/apache2/htdocs

plugin_install_dir ws_dir

Répertoire racine de l'installation du plug-in pour les serveurs d'applica­ tions WebSphere.

${ws_dir}/Plugins

Répertoire d'installation du serveur

Web Apache.

/opt/apache2

Remarque

Lorsque vous utilisez IBM IHS avec un serveur d'applications Web WebSphere 7, 8.5 ou 8.5.5, assurez-vous que as_plugin_cfg_dir est correctement configuré dans config.websphere7 ou config.websphere8.

4.5.3 Fichier de propriétés de configuration d'application

Web

Chaque application Web peut être déployée à un emplacement différent sur le serveur d'applications Web et peut

être configurée avec différentes options.

38

©

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

Chaque application Web déployable est configurée dans le fichier de configuration

<REP_INSTALL_PBI>

/ sap_bobj/enterprise_xi40/wdeploy/conf/app/

<APP_WEB>

.properties.

Les paramètres disponibles dans un fichier de configuration

<APP_WEB>

.properties sont les suivants :

Variable warfile appvdir

Description

Nom du fichier WAR à créer pour cette application Web.

Nom du chemin du contexte

(aussi connu sous le nom de répertoire virtuel) où est dé­ ployée l'application Web.

Exemple dswsbobje.war

dswsbobje buildfile Fichier Ant utilisé pour élaborer l'application Web.

dswsbobje.xml

deploy_as_a_filetree

Mode permettant le déploie­ ment d'un fichier WAR détaché avec la valeur True.

true classloading_mode classloader_package_filtering

Paramètre servant à détermi­ ner l'ordre Classloader.

Filtre pour classloader.

PARENT_LAST com.ctc.wstx.*,javax.xml.*,org.apache.*

Lors du déploiement d'une application Web à un emplacement spécifique d'un serveur d'applications Web, utilisez la variable appvdir pour définir l'emplacement de l'application Web dans le contexte racine du serveur. Par exemple, si le contexte racine d'un serveur d'applications Web est http://www.mycompany.com/BOE, le fait de définir appvdir sur mywebapp/ rend l'application Web accessible depuis http://www.mycompany.com/BOE/ mywebapp/.

4.6 Utilisation de l'outil de ligne de commande WDeploy

Avant d'utiliser l'outil de ligne de commande WDeploy, assurez-vous que les fichiers de configuration WDeploy ont

été configurés de manière appropriée pour votre serveur d'applications Web. Voir

Fichiers de configuration

WDeploy

[page 32].

Pour en savoir plus sur les conditions préalables à l'utilisation de l'outil WDeploy, voir :

●

Conditions préalables à l'utilisation de l'outil WDeploy

[page 19]

●

Prérequis concernant l'utilisation de l'outil WDeploy GUI

[page 73]

L'installation de l'outil de ligne de commande WDeploy s'effectue dans le cadre de celle de la plateforme de BI :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/wdeploy.sh

Il existe deux types de commandes :

● Commandes générales

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.

39

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].

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

[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

©

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

4.6.1.4 Commandes générales de WDeploy

Les commandes générales de WDeploy 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. Les commandes générales suivantes sont disponibles :

● wdeploy help : affiche un résumé des utilisations possibles de la ligne de commande WDeploy.

● wdeploy listappservers : répertorie tous les serveurs d'applications Web Java pris en charge par cette version de WDeploy.

● wdeploy version : affiche le numéro de version de l'outil WDeploy.

● wdeploy buildwarall: crée un fichier WAR générique en se servant de l'arborescence source de l'application Web.

Utilisation : wdeploy.sh

buildwarall

-Dapp_source_tree=<LOCATION_OF_WEB_APP_SOURCE>

-Dwar_dir=<TARGET_LOCATION_OF_GENERIC_WAR_FILES>

Exemple : wdeploy.sh

buildwarall

-Dapp_source_tree=/sap/sap_bobj/enterprise_xi40/warfiles/webapps

-Dwar_dir=/myGenericWarFiles

4.6.2 Exemples d'utilisation de WDeploy

Cette section fournit des exemples d'utilisation des commandes WDeploy pour les serveurs d'applications Web pris en charge.

N'oubliez pas

Avant d'utiliser WDeploy, assurez-vous que les fichiers de configuration WDeploy ont été configurés de

manière appropriée pour votre serveur d'applications Web. Voir

Fichiers de configuration WDeploy

[page 32].

Lisez

Remarques particulières

[page 62] pour une liste d'informations importantes spécifiques à votre

serveur d'applications Web.

4.6.2.1 Valeurs pour le SERVEUR_APP_WEB

Dans les exemples suivants, remplacez la variable

<SERVEUR_APP_WEB>

par le nom de votre serveur d'applications Web tel qu'indiqué dans le tableau suivant.

Serveur d'applications Web

JBoss 7.1

Nom

<SERVEUR_APP_WEB>

jboss7

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.

49

Serveur d'applications Web

SAP NetWeaver

Tomcat 6.0

Tomcat 7.0

WebLogic 11gR1

WebSphere 7.0

WebSphere 8.5 ou 8.5.5

Nom

<SERVEUR_APP_WEB>

sapappsvr73 tomcat6 tomcat7 weblogic11 websphere7 websphere8

4.6.2.2 wdeploy 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 interne web.xml de l'application Web est défini par WDeploy, ainsi que toutes 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/

<SERVEUR_APP_WEB>

.

Ce fichier WAR ou EAR peut être déployé manuellement via la console d'administration du serveur d'applications

Web ou la commande wdeploy deploy.

Exemple

Utilisez par exemple 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é.

wdeploy.sh

<SERVEUR_APP_WEB>

-DAPP=BOE

predeploy

Remplacez

<SERVEUR_APP_WEB>

par le nom du serveur d'applications Web tel qu'indiqué dans le tableau suivant.

Le tableau ci-dessous contient des exemples de paramètres pour le prédéploiement de l'application Web BOE pour des serveurs d'applications Web spécifiques. Tous les paramètres sont obligatoires, à moins qu'ils soient signalés comme facultatifs dans les fichiers de configuration. Les paramètres indiqués sur la ligne de commande remplacent ceux qui sont stockés dans les fichiers de configuration. Cependant, il est recommandé de configurer les paramètres dans le fichier de configuration config.

<SERVEUR_APP_WEB>

approprié pour votre déploiement.

Serveur

JBoss 7.1. (jboss7)

Paramètres wdeploy.sh jboss7

-Das_instance=default

-DAPP=BOE

predeploy

50

©

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

Serveur

SAP NetWeaver (sapappsvr73)

Paramètres wdeploy.sh sapappsvr73

-DAPP=BOE

predeploy

Tomcat 6.0 (tomcat6)

WebSphere 8.5 ou 8.5.5

(websphere8) wdeploy.sh tomcat6

-DAPP=BOE

predeploy

Tomcat 7.0 (tomcat7)

WebSphere 7.0 (websphere7) wdeploy.sh tomcat7

-DAPP=BOE

predeploy

WebLogic 11gR1 (weblogic11) wdeploy.sh weblogic11

-DAPP=BOE

predeploy

Si le serveur d'applications Web WegLogic est hébergé sur un ordinateur Linux qui utilise la Java Virtual Machine JRockit et si vous prédéployez les applica­ tions Web dswsbobje ou BOE, vous devez inclure l'option -Djvm_is_jroc­ kit=true : wdeploy weblogic11

-DAPP=dswsbobje

-Djvm_is_jrockit=true

predeploy wdeploy weblogic11

-DAPP=BOE

-Djvm_is_jrockit=true

predeploy wdeploy.sh websphere7

-Das_virtual_host=default_host

-DAPP=BOE

predeploy wdeploy.sh websphere8

-Das_virtual_host=default_host

-DAPP=BOE

predeploy

4.6.2.3 wdeploy predeployall

La commande wdeploy predeployall exécute la commande wdeploy predeploy 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

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.

51

Exemple

Utilisez par exemple wdeploy predeployall pour appliquer la commande wdeploy predeploy à toutes les applications Web.

wdeploy.sh

<SERVEUR_APP_WEB>

predeployall

Remplacez

<SERVEUR_APP_WEB>

par le nom du serveur d'applications Web tel qu'indiqué dans le tableau suivant.

Le tableau ci-dessous contient des exemples de paramètres pour le prédéploiement de toutes les applications

Web pour des serveurs d'applications Web spécifiques. Tous les paramètres sont obligatoires, à moins qu'ils soient signalés comme facultatifs dans les fichiers de configuration. Les paramètres indiqués sur la ligne de commande remplacent ceux qui sont stockés dans les fichiers de configuration. Cependant, il est recommandé de configurer les paramètres dans le fichier de configuration config.

<SERVEUR_APP_WEB>

approprié pour votre déploiement.

Serveur

JBoss 7.1. (jboss7)

Paramètres wdeploy.sh jboss7

predeployall

SAP NetWeaver (sapappsvr73) wdeploy.sh sapappsvr73

predeployall

Tomcat 6.0 (tomcat6) wdeploy.sh tomcat6

predeployall

Tomcat 7.0 (tomcat7) wdeploy.sh tomcat7

predeployall

WebLogic 11gR1 (weblogic11) wdeploy.sh weblogic11

predeployall

Si le serveur d'applications Web WegLogic est hébergé sur un ordinateur Linux qui utilise la Java Virtual Machine JRockit et si vous prédéployez les applica­ tions Web dswsbobje ou BOE, vous devez inclure l'option -Djvm_is_jroc­ kit=true : wdeploy.sh weblogic11

-Djvm_is_jrockit=true

predeployall

WebSphere 7.0 (websphere7) wdeploy.sh websphere7

-Das_virtual_host=default_host

predeployall

52

©

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

Serveur

WebSphere 8.5 et 8.5.5

(websphere8)

Paramètres wdeploy.sh websphere8

-Das_virtual_host=default_host

predeployall

4.6.2.4 wdeploy deployonly

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'interface 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.

Exemple

Utilisez par exemple wdeploy deployonly pour déployer une application Web BOE préparée sur un serveur d'applications Web.

wdeploy.sh

<SERVEUR_APP_WEB>

-DAPP=BOE

deployonly

Remplacez

<SERVEUR_APP_WEB>

par le nom du serveur d'applications Web tel qu'indiqué dans le tableau suivant.

Le tableau ci-dessous contient des exemples de paramètres pour le déploiement de l'application Web BOE sur des serveurs d'applications Web spécifiques. Tous les paramètres sont obligatoires, à moins qu'ils soient signalés comme facultatifs dans les fichiers de configuration. Les paramètres indiqués sur la ligne de commande remplacent ceux qui sont stockés dans les fichiers de configuration. Cependant, il est recommandé de configurer les paramètres dans le fichier de configuration config.

<SERVEUR_APP_WEB>

approprié pour votre déploiement.

Serveur

JBoss 7.1. (jboss7)

Paramètres

La commande wdeploy deployonly n'est pas compatible avec JBoss 7.1.

Vous devez utiliser les commandes wdeploy predeploy ou wdeploy predeployall de l'outil WDeploy pour créer des fichiers WAR et les déployer ma­ nuellement à l'aide de l'interface de ligne de commande JBoss ou du scanner de déploiement de système de fichiers.

SAP NetWeaver (sapappsvr73)

La commande wdeploy deployonly n'est pas compatible avec SAP Net­

Weaver. Vous devez utiliser les commandes wdeploy predeploy ou wde-

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.

53

Serveur

Tomcat 6.0 (tomcat6)

Tomcat 7.0 (tomcat7)

WebLogic 11gR1 (weblogic11)

Paramètres ploy predeployall de l'outil WDeploy pour créer des fichiers SCA et dé­ ployer manuellement à l'aide de SAP Software Update Manager (SUM).

wdeploy.sh tomcat6

-Das_dir=/opt/tomcat6

-Das_instance=localhost

-Das_service_name=Tomcat6

-DAPP=BOE

deployonly wdeploy.sh tomcat7

-Das_dir=/opt/tomcat7

-Das_instance=localhost

-Das_service_name=Tomcat7

-DAPP=BOE

deployonly wdeploy.sh weblogic11

-Das_domain_dir=/opt/bea/user_projects/domains/ base_domain

-Das_admin_port=7001

-Das_instance=AdminServer

-Das_admin_username=weblogic

-Das_admin_password=weblogic

-DAPP=BOE

deployonly

WebSphere 7.0 (websphere7)

WebSphere 8.5 ou 8.5.5

(websphere8) wdeploy.sh websphere7

-Das_dir=/opt/IBM/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

-DAPP=BOE

deployonly wdeploy.sh websphere8

-Das_dir=/opt/IBM/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

-DAPP=BOE

deployonly

4.6.2.5 wdeploy deployonlyall

La commande wdeploy deployonlyall exécute la commande wdeploy deployonly pour toutes les applications Web préparées.

54

©

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

Exemple

Utilisez par exemple wdeploy deployonlyall pour appliquer la commande wdeploy deployonly à toutes les applications Web préparées.

wdeploy.sh

<SERVEUR_APP_WEB>

deployonlyall

Remplacez

<SERVEUR_APP_WEB>

par le nom du serveur d'applications Web tel qu'indiqué dans le tableau suivant.

Le tableau ci-dessous contient des exemples de paramètres pour le déploiement de toutes les applications

Web sur des serveurs d'applications Web spécifiques. Tous les paramètres sont obligatoires, à moins qu'ils soient signalés comme facultatifs dans les fichiers de configuration. Les paramètres indiqués sur la ligne de commande remplacent ceux qui sont stockés dans les fichiers de configuration. Cependant, il est recommandé de configurer les paramètres dans le fichier de configuration config.

<SERVEUR_APP_WEB>

approprié pour votre déploiement.

Serveur

JBoss 7.1. (jboss7)

Paramètres

La commande wdeploy deployonlyall n'est pas compatible avec

JBoss 7.1. Vous devez utiliser les commandes wdeploy predeploy ou wdeploy predeployall de l'outil WDeploy pour créer des fichiers WAR et les dé­ ployer manuellement à l'aide de l'interface de ligne de commande JBoss ou du scanner de déploiement de système de fichiers.

SAP NetWeaver (sapappsvr73)

La commande wdeploy deployonlyall n'est pas compatible avec SAP Net­

Weaver. Vous devez utiliser les commandes wdeploy predeploy ou wdeploy predeployall de l'outil WDeploy pour créer des fichiers SCA et dé­ ployer manuellement à l'aide de SAP Software Update Manager (SUM).

Tomcat 6.0 (tomcat6) wdeploy.sh tomcat6

-Das_dir=/opt/tomcat6

-Das_instance=localhost

-Das_service_name=Tomcat6

deployonlyall

Tomcat 7.0 (tomcat7) wdeploy.sh tomcat7

-Das_dir=/opt/tomcat7

-Das_instance=localhost

-Das_service_name=Tomcat7

deployonlyall

WebLogic 11gR1 (weblogic11) wdeploy.sh weblogic11

-Das_domain_dir=/opt/bea/user_projects/domains/ base_domain

-Das_admin_port=7001

-Das_instance=AdminServer

-Das_admin_username=weblogic

-Das_admin_password=weblogic

deployonlyall

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.

55

Serveur

WebSphere 7.0 (websphere7)

WebSphere 8.5 ou 8.5.5

(websphere8)

Paramètres wdeploy.sh websphere7

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

deployonlyall wdeploy.sh websphere8

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

deployonlyall

4.6.2.6 wdeploy deploy

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.

Exemple

Utilisez par exemple 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

Remplacez

<SERVEUR_APP_WEB>

par le nom du serveur d'applications Web tel qu'indiqué dans le tableau suivant.

Le tableau ci-dessous contient des exemples de paramètres pour le déploiement de l'application Web BOE sur des serveurs d'applications Web spécifiques. Tous les paramètres sont obligatoires, à moins qu'ils soient signalés comme facultatifs dans les fichiers de configuration. Les paramètres indiqués sur la ligne de commande remplacent ceux qui sont stockés dans les fichiers de configuration. Cependant, il est recommandé de configurer les paramètres dans le fichier de configuration config.

<SERVEUR_APP_WEB>

approprié pour votre déploiement.

Serveur

JBoss 7.1. (jboss7)

Paramètres

La commande wdeploy deploy n'est pas compatible avec JBoss 7.1. Vous devez utiliser les commandes wdeploy predeploy ou wdeploy predeployall de l'outil WDeploy pour créer des fichiers WAR et les déployer ma­ nuellement à l'aide de l'interface de ligne de commande JBoss ou du scanner de déploiement de système de fichiers.

56

©

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

Serveur

SAP NetWeaver AS Java

(sapappsvr73)

Tomcat 6.0 (tomcat6)

Paramètres

La commande wdeploy deploy n'est pas compatible avec SAP NetWeaver

AS Java. Vous devez utiliser les commandes wdeploy predeploy ou wdeploy predeployall de l'outil WDeploy pour créer des fichiers SCA et dé­ ployer manuellement à l'aide de SAP Software Update Manager (SUM).

wdeploy.sh tomcat6

-Das_dir=/opt/tomcat6

-Das_instance=localhost

-Das_service_name=Tomcat6

-DAPP=BOE

deploy

Tomcat 7.0 (tomcat7) wdeploy.sh tomcat7

-Das_dir=/opt/tomcat7

-Das_instance=localhost

-Das_service_name=Tomcat7

-DAPP=BOE

deploy

WebLogic 11gR1 (weblogic11) wdeploy.sh weblogic11

-Das_domain_dir=/bea/user_projects/domains/base_domain

-Das_admin_port=7001

-Das_instance=AdminServer

-Das_admin_username=weblogic

-Das_admin_password=weblogic

-DAPP=BOE

deploy

WebSphere 7.0 (websphere7) wdeploy.sh websphere7

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

-DAPP=BOE

deploy

WebSphere 8.5 ou 8.5.5

(websphere8) wdeploy.sh websphere8

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

-DAPP=BOE

deploy

4.6.2.7 wdeploy deployall

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 :

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.

57

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/warfiles/webapps

Exemple

Utilisez par exemple wdeploy deployall pour appliquer la commande wdeploy deploy à toutes les applications Web.

wdeploy.sh

<SERVEUR_APP_WEB>

deployall

Remplacez

<SERVEUR_APP_WEB>

par le nom du serveur d'applications Web tel qu'indiqué dans le tableau suivant.

Le tableau ci-dessous contient des exemples de paramètres pour le déploiement de toutes les applications

Web sur des serveurs d'applications Web spécifiques. Tous les paramètres sont obligatoires, à moins qu'ils soient signalés comme facultatifs dans les fichiers de configuration. Les paramètres indiqués sur la ligne de commande remplacent ceux qui sont stockés dans les fichiers de configuration. Cependant, il est recommandé de configurer les paramètres dans le fichier de configuration config.

<SERVEUR_APP_WEB>

approprié pour votre déploiement.

Serveur

JBoss 7.1. (jboss7)

Paramètres

La commande wdeploy deployall n'est pas compatible avec JBoss 7.1.

Vous devez utiliser les commandes wdeploy predeploy ou wdeploy predeployall de l'outil WDeploy pour créer des fichiers WAR et les déployer ma­ nuellement à l'aide de l'interface de ligne de commande JBoss ou du scanner de déploiement de système de fichiers.

SAP NetWeaver (sapappsvr73)

La commande wdeploy deployall n'est pas compatible avec SAP NetWea­ ver. Vous devez utiliser les commandes wdeploy predeploy ou wdeploy predeployall de l'outil WDeploy pour créer des fichiers SCA et déployer ma­ nuellement à l'aide de SAP Software Update Manager (SUM).

Tomcat 6.0 (tomcat6) wdeploy.sh tomcat6

-Das_dir=/opt/tomcat6

-Das_instance=localhost

-Das_service_name=Tomcat6

deployall

Tomcat 7.0 (tomcat7) wdeploy.sh tomcat7

-Das_dir=/opt/tomcat7

-Das_instance=localhost

-Das_service_name=Tomcat7

deployall

WebLogic 11gR1 (weblogic11) wdeploy.sh weblogic11

-Das_domain_dir=/opt/bea/user_projects/domains/ base_domain

-Das_admin_port=7001

-Das_instance=AdminServer

-Das_admin_username=weblogic

-Das_admin_password=weblogic

deployall

58

©

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

Serveur

WebSphere 7.0 (websphere7)

WebSphere 8.5 ou 8.5.5

(websphere8)

Paramètres wdeploy.sh websphere7

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

deployall wdeploy.sh websphere8

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

deployall

4.6.2.8 wdeploy undeploy

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.

Exemple

Utilisez par exemple la commande wdeploy undeploy pour annuler le déploiement de l'application Web BOE sur le serveur d'applications Web cible.

wdeploy.sh

<SERVEUR_APP_WEB>

-DAPP=BOE

undeploy

Remplacez

<SERVEUR_APP_WEB>

par le nom du serveur d'applications Web tel qu'indiqué dans le tableau suivant.

Le tableau ci-dessous contient des exemples de paramètres pour l'annulation du déploiement de l'application

Web BOE sur des serveurs d'applications Web spécifiques. Tous les paramètres sont obligatoires, à moins qu'ils soient signalés comme facultatifs dans les fichiers de configuration. Les paramètres indiqués sur la ligne de commande remplacent ceux qui sont stockés dans les fichiers de configuration. Cependant, il est recommandé de configurer les paramètres dans le fichier de configuration config.

<SERVEUR_APP_WEB>

approprié pour votre déploiement.

Serveur

JBoss 7.1. (jboss7)

Paramètres

La commande wdeploy undeploy n'est pas compatible avec JBoss 7.1.

SAP NetWeaver (sapappsvr73)

La commande wdeploy undeploy n'est pas compatible avec SAP NetWea­ ver.

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.

59

Serveur

Tomcat 6.0 (tomcat6)

Tomcat 7.0 (tomcat7)

WebLogic 11gR1 (weblogic11)

Paramètres wdeploy.sh tomcat6

-Das_dir=/opt/tomcat6

-Das_instance=localhost

-DAPP=BOE

-Das_service_name=Tomcat6

undeploy wdeploy.sh tomcat7

-Das_dir=/opt/tomcat7

-Das_instance=localhost

-DAPP=BOE

-Das_service_name=Tomcat7

undeploy wdeploy.sh weblogic11

-Das_domain_dir=/opt/bea/user_projects/domains/ base_domain

-Das_admin_port=7001

-Das_instance=AdminServer

-Das_admin_username=weblogic

-Das_admin_password=weblogic

-DAPP=BOE

undeploy

WebSphere 7.0 (websphere7)

WebSphere 8.5 ou 8.5.5

(websphere8) wdeploy.sh websphere7

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

-DAPP=BOE

undeploy wdeploy.sh websphere8

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

-DAPP=BOE

undeploy

4.6.2.9 wdeploy undeployall

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.

Exemple wdeploy.sh

<SERVEUR_APP_WEB>

undeployall

60

©

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

Remplacez

<SERVEUR_APP_WEB>

par le nom du serveur d'applications Web tel qu'indiqué dans le tableau suivant.

Le tableau ci-dessous contient des exemples de paramètres pour l'annulation du déploiement de toutes les applications Web sur des serveurs d'applications Web spécifiques. Tous les paramètres sont obligatoires, à moins qu'ils soient signalés comme facultatifs dans les fichiers de configuration. Les paramètres indiqués sur la ligne de commande remplacent ceux qui sont stockés dans les fichiers de configuration. Cependant, il est recommandé de configurer les paramètres dans le fichier de configuration config.

<SERVEUR_APP_WEB>

approprié pour votre déploiement.

Serveur

JBoss 7.1. (jboss7)

Paramètres

La commande wdeploy undeployall n'est pas compatible avec JBoss 7.1.

SAP NetWeaver (sapappsvr73)

La commande wdeploy undeployall n'est pas compatible avec SAP Net­

Weaver.

Tomcat 6.0 (tomcat6) wdeploy.sh tomcat6

-Das_dir=/opt/tomcat6

-Das_instance=localhost

-Das_service_name=Tomcat6

undeployall

Tomcat 7.0 (tomcat7) wdeploy.sh tomcat7

-Das_dir=/opt/tomcat7

-Das_instance=localhost

-Das_service_name=Tomcat7

undeployall

WebLogic 11gR1 (weblogic11) wdeploy.sh weblogic11

-Das_domain_dir=/opt/bea/user_projects/domains/ base_domain

-Das_admin_port=7001

-Das_instance=AdminServer

-Das_admin_username=weblogic

-Das_admin_password=weblogic

undeployall

WebSphere 7.0 (websphere7) wdeploy.sh websphere7

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

undeployall

WebSphere 8.5 ou 8.5.5

(websphere8) wdeploy.sh websphere8

-Das_dir=/opt/ibm/WebSphere/AppServer

-Das_instance=server1

-Das_virtual_host=default_host

-Das_profile_name=AppSrv01

-Das_soap_port=8880

undeployall

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.

61

4.6.3 Remarques particulières

La section suivante contient des informations importantes en rapport avec le déploiement des applications Web sur le serveur d'applications Web.

4.6.3.1 SAP NetWeaver

4.6.3.1.1 Conditions préalables au déploiement sur SAP

NetWeaver

Remarque

Si des applications Web de la plateforme SAP BusinessObjects Business Intelligence sont en cours d'exécution sur le serveur, vous devez annuler leur déploiement avant de poursuivre.

Avant de déployer des applications Web de la plateforme de BI sur SAP NetWeaver Application Server (quelle qu'en soit la version), vous devez veiller à ce que les fichiers .html et .htm ne soient jamais compressés. Par exemple, dans SAP NetWeaver AS 7.3 :

1. Connectez-vous au portail d'administration SAP NetWeaver.

Par exemple : http://<nomserveur>:50200/nwa

2. Accédez à : Configuration Infrastructure Java System Properties (Propriétés système Java) .

3. Dans l'onglet Services, sélectionnez HTTP Provider (Fournisseur HTTP).

4. Sous

Extended Details (Détails étendus)

, modifiez les propriétés AlwaysCompressed et NeverCompressed comme suit :

○ AlwaysCompressed : Supprimez *.htm,*.html,text/html de cette propriété. Ce champ ne peut pas

être vide. Entrez un espace sinon.

○ NeverCompressed : Ajoutez *.htm,*.html,text/html à cette propriété.

Table 11 : Exemple

Nom

AlwaysCompressed

Valeur calculée par défaut

(s'il est vide, définissez-le sur espace vide)

NeverCompressed

*.htm,*.html,text/html

5. Enregistrez vos changements avant de quitter.

62

©

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.3.2 Tomcat

4.6.3.2.1 Déploiement sur des serveurs d'applications Web

Apache et Tomcat distincts

Pour réduire la charge sur un serveur d'applications Web, vous pouvez configurer un serveur Web dédié distinct pour le traitement du contenu statique. Tout le contenu statique sera traité par le serveur Web, tandis que le contenu dynamique sera traité par le serveur d'applications Web. Les instructions suivantes indiquent comment utiliser l'outil WDeploy pour partager des ressources d'applications Web en contenu statique et dynamique et déployer ce contenu de façon appropriée.

1. Configurez le serveur Web Apache et assurez-vous qu'il fonctionne correctement. Chargez une page Web, telle que la page de test par défaut d'Apache, afin de vérifier que le serveur Web traite correctement le contenu.

Ouvrez un navigateur Web et saisissez l'URL du serveur Web. Par exemple : http:// apache.mycompany.com.

2. Assurez-vous que le serveur d'applications Web Tomcat fonctionne correctement.

Ouvrez un navigateur Web et entrez l'adresse IP ou le nom d'hôte du serveur d'applications Web, ainsi qu'un numéro de port. Par exemple : http://tomcat.mycompany.com:8080.

Remarque

Si vous disposez déjà d'applications Web de la plateforme de BI s'exécutant sur le serveur, vous devez annuler leur déploiement avant de poursuivre.

3. Téléchargez le connecteur Apache Tomcat sur le site Web de Tomcat. Le connecteur Apache Tomcat vous permet de connecter un serveur Web Apache à un serveur d'applications Web Tomcat de sorte qu'Apache puisse transférer les requêtes de ressources dynamiques à Tomcat.

4. Suivez les instructions de configuration du plug-in sur le site Web d'Apache pour configurer la liaison entre le serveur Web Apache et le serveur d'applications Web Tomcat.

Les demandes de ressources dynamiques sont désormais transférées à Tomcat lorsqu'elles sont reçues par

Apache.

5. Assurez-vous que la liaison entre le serveur Web et le serveur d'applications Web fonctionne en pointant un navigateur sur le serveur Web et en vérifiant que le contenu dynamique du serveur d'applications Web est traité correctement.

Par exemple, visitez l'URL suivante : http://apache.mycompany.com/jsp-examples/.

Remarque

Cet exemple d'URL ne fonctionne que si vous avez déployé manuellement l'application Web jspexamples.

6. Si le serveur d'applications Web est installé sur le même ordinateur que la plateforme de BI, exécutez

WDeploy localement sur cet ordinateur. Si le serveur d'applications Web est exécuté sur un autre ordinateur, copiez la commande et l'environnement WDeploy sur le serveur d'applications Web. Voir Pour déployer des

applications Web sur un ordinateur distant.

7. Configurez l'environnement WDeploy pour répartir le contenu entre le serveur Web et le serveur d'applications Web. On parle dans ce cas de mode "fractionné".

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.

63

Les fichiers de configuration Wdeploy pour Apache et Tomcat se trouvent à l'emplacement suivant :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/conf.

○ Modifiez le fichier de configuration WDeploy pour Tomcat. Par exemple, pour Tomcat 6.0, le fichier config.tomcat6 ressemblera à ce qui suit : as_dir=/opt/Tomcat as_instance=localhost as_service_name=Tomcat6

○ Modifiez config.apache. Par exemple : ws_dir=/opt/apache224 connector_type=Tomcat6 deployment_dir=/opt/apache224/htdocs

8. Utilisez wdeploy predeploy en mode fractionné pour séparer les applications Web source en fichiers statiques et dynamiques.

Par exemple :

○ Exécutez la commande suivante pour extraire le contenu statique du serveur Web Apache.

wdeploy.sh Tomcat6 -Das_mode=split

-Dws_type=apache predeployall

9. Exécutez la commande wdeploy deployonlyall pour déployer le contenu dynamique sur le serveur d'applications Tomcat et le contenu statique sur Apache.

Si Apache et Tomcat sont installés sur le même ordinateur, le contenu statique et le contenu dynamique seront automatiquement déployés sur les serveurs à l'aide de la commande suivante : wdeploy.sh Tomcat6 -Das_mode=split

-Dws_type=apache deployonlyall

Remarque

Si votre contenu statique et votre contenu dynamique sont situés à un emplacement personnalisé, utilisez le paramètre -Dwork_dir.

Si Apache et Tomcat sont installés sur des ordinateurs différents, le contenu dynamique sera automatiquement déployé sur Tomcat à l'aide de la commande suivante : Le contenu dynamique devra être déployé manuellement sur l'ordinateur Apache distant par la suite.

wdeploy.sh Tomcat6 -Das_mode=split

deployonlyall

Remarque

Si votre contenu statique et votre contenu dynamique sont situés à un emplacement personnalisé, utilisez le paramètre -Dwork_dir.

Copiez le contenu statique dans le répertoire htdocs sur le serveur Web :

○ Décompressez les fichiers zip sur le serveur d'applications Web sous

<REP_INSTALL_PBI>

/sap_bobj/ enterprise_xi40/wdeploy/workdir/Tomcat6/resources.

○ Copiez ces dossiers du serveur d'applications Web Tomcat dans le dossier

<REP_WS>

/htdocs du serveur Apache.

64

©

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

○ Copiez les fichiers bobj.

<application>

.conf du serveur d'applications Web Tomcat dans le dossier

<REP_WS>

/conf du serveur Apache.

○ Servez-vous des fichiers de configuration de l'application pour mettre à jour le fichier httpd.conf du serveur Apache qui se trouve dans le répertoire

<REP_WS>

/conf. Pour chaque application Web, incluez une entrée dans httpd.conf. Par exemple, pour inclure BOE, vous devez saisir :

Include conf/bobj.BOE.conf

Le contenu statique est désormais traité par un serveur Web dédié et le contenu dynamique par un serveur d'applications Web dédié.

4.6.3.2.2 Compression gzip de Tomcat

Si vous procédez à une nouvelle installation de la plateforme de BI et que vous choisissez d'utiliser le serveur d'applications Web Tomcat fourni avec, la compression gzip HTTP de Tomcat est activée automatiquement.

La compression gzip améliore le temps de réponse et le taux de transfert du serveur d'applications Web.

Toutefois, si vous prévoyez de déployer des applications Web sur le serveur d'applications Web Tomcat, gardez à l'esprit que ce type de déploiement, pour lequel une compression gzip est activée, peut différer du processus utilisé pour déployer des applications Web sur une version de Tomcat fournie dans une version précédente de la plateforme de BI.

4.6.3.3 WebLogic

4.6.3.3.1 Pour effectuer un déploiement sur un serveur Web

Apache et un serveur d'applications Web WebLogic distincts

Pour réduire la charge sur un serveur d'applications Web, vous pouvez configurer un serveur Web dédié distinct pour le traitement du contenu statique. Tout le contenu statique sera traité par le serveur Web, tandis que le contenu dynamique sera traité par le serveur d'applications Web. Les instructions suivantes indiquent comment utiliser l'outil WDeploy pour partager des ressources d'applications Web en contenu statique et dynamique et déployer ce contenu de façon appropriée.

1. Configurez le serveur Web Apache et assurez-vous qu'il fonctionne correctement. Chargez une page Web, telle que la page de test par défaut d'Apache, afin de vérifier que le serveur Web traite correctement le contenu.

Ouvrez un navigateur Web et entrez l'adresse IP ou le nom d'hôte du serveur Web, ainsi que le numéro de port si le serveur n'écoute pas sur le port 80. Par exemple : http://apache.mycompany.com.

2. Assurez-vous que le serveur d'applications Web WebLogic fonctionne correctement.

Ouvrez un navigateur Web et entrez l'adresse IP ou le nom d'hôte du serveur d'applications Web, ainsi qu'un numéro de port. Par exemple : http://weblogic.mycompany.com:7001.

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.

65

Remarque

Si vous disposez déjà d'applications Web de la plateforme de BI s'exécutant sur le serveur, vous devez annuler leur déploiement avant de poursuivre.

3. Téléchargez le plug-in Apache HTTP Server WebLogic sur le site Web de BEA. Le plug-in vous permet de connecter un serveur Web Apache à un serveur d'applications Web WebLogic de sorte qu'Apache puisse transférer les requêtes de ressources dynamiques à WebLogic.

4. Suivez les instructions de configuration du plug-in sur le site Web de BEA pour configurer la liaison entre le serveur Web Apache et WebLogic.

Les demandes de ressources dynamiques sont désormais transférées à WebLogic lorsqu'elles sont reçues par Apache.

5. Assurez-vous que la liaison entre le serveur Web et le serveur d'applications Web fonctionne en pointant un navigateur sur le serveur Web et en vérifiant que le contenu dynamique du serveur d'applications Web est traité correctement.

Par exemple, visitez l'URL suivante : http://apache.mycompany.com/jsp-examples/.

Remarque

Cet exemple d'URL ne fonctionne que si vous avez déployé manuellement l'application Web jspexamples.

6. Si le serveur d'applications Web est installé sur le même ordinateur que la plateforme de BI, exécutez

WDeploy localement sur cet ordinateur. Si le serveur d'applications Web est exécuté sur un autre ordinateur, copiez la commande et l'environnement WDeploy sur le serveur d'applications Web. Voir Pour déployer des

applications Web sur un ordinateur distant.

7. Configurez l'environnement WDeploy pour répartir le contenu entre le serveur Web et le serveur d'applications Web. On parle dans ce cas de mode "fractionné".

Les fichiers de configuration Wdeploy pour Apache et WebLogic se trouvent à l'emplacement suivant :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/conf.

○ Modifiez config.weblogic11. Par exemple : as_admin_port=7001 as_admin_username=weblogic as_admin_password=weblogic as_instance=AdminServer as_domain_dir=/usr/bea/user_projects/domains/base_domain

○ Modifiez config.apache. Par exemple : ws_dir=/opt/apweblogic11 ache224/ connector_type=weblogic11 deployment_dir=/opt/apache224/htdocs

8. Utilisez wdeploy predeploy en mode fractionné pour répartir les applications Web source en ressources statiques et ressources dynamiques distinctes.

Par exemple :

66

©

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

○ Exécutez la commande suivante afin d'extraire le contenu statique pour le serveur Web Apache et le contenu dynamique pour le serveur d'applications WebLogic.

wdeploy.sh weblogic11 -Das_mode=split

-Dws_type=apache predeployall

Le contenu dynamique se trouve à l'emplacement suivant :

<REP_INSTALL_BOE>

/sap_bobj/ enterprise_xi40/wdeploy/workdir/weblogic10/application. Le contenu statique se trouve à l'emplacement suivant :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/workdir/ weblogic11/resources.

9. Exécutez la commande wdeploy deployonlyall pour déployer le contenu dynamique sur le serveur d'applications WebLogic et le contenu statique sur Apache.

Si Apache et WebLogic sont installés sur le même ordinateur, le contenu statique et le contenu dynamique seront automatiquement déployés sur les serveurs avec cette commande : wdeploy.sh weblogic11 -Das_mode=split

-Dws_type=apache deployonlyall

Remarque

Si votre contenu statique et votre contenu dynamique sont situés à un emplacement personnalisé, utilisez le paramètre -Dwork_dir.

Si Apache et WebLogic sont installés sur des ordinateurs différents, le contenu dynamique sera automatiquement déployé sur WebLogic à l'aide de la commande suivante : Le contenu dynamique doit alors

être copié et déployé manuellement sur l'ordinateur Apache distant.

./wdeploy.sh weblogic11 -Das_mode=split

deployonlyall

Remarque

Si votre contenu statique et votre contenu dynamique résident dans un emplacement personnalisé, utilisez le paramètre -Dwork_dir.

Copiez le contenu statique dans le répertoire htdocs sur le serveur Web :

○ Décompressez les fichiers zip sur le serveur d'applications Web sous

<REP_INSTALL_PBI>

/sap_bobj/ enterprise_xi40/wdeploy/workdir/WebLogic11/resources.

○ Copiez ces dossiers du serveur d'applications Web WebLogic dans le dossier

<REP_WS>

/htdocs du serveur Apache.

○ Copiez les fichiers bobj.

<application>

.conf du serveur d'applications Web WebLogic dans le dossier

<REP_WS>

/conf du serveur Apache.

○ Servez-vous des fichiers de configuration de l'application pour mettre à jour le fichier httpd.conf du serveur Apache qui se trouve dans le répertoire

<REP_WS>

/conf. Pour chaque application Web, incluez une entrée dans httpd.conf. Par exemple, pour inclure BOE, vous devez saisir :

Include conf/bobj.BOE.conf

Le contenu statique est désormais traité par un serveur Web dédié et le contenu dynamique par un serveur d'applications Web dédié.

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.

67

4.6.3.4 WebSphere

4.6.3.4.1 Pour effectuer un déploiement sur un serveur Web

IHS et un serveur d'applications Web WebSphere distincts

Pour réduire la charge sur un serveur d'applications Web, vous pouvez configurer un serveur Web dédié distinct pour le traitement du contenu statique. Tout le contenu statique sera traité par le serveur Web, tandis que le contenu dynamique sera traité par le serveur d'applications Web. Les instructions suivantes indiquent comment utiliser l'outil WDeploy pour partager des ressources d'applications Web en contenu statique et dynamique et déployer ce contenu de façon appropriée.

1. Configurez un serveur Web IBM HTTP Server (IHS) et assurez-vous qu'il fonctionne correctement. Chargez une page Web, telle que la page de test par défaut d'IHS, afin de vérifier que le serveur Web traite correctement le contenu.

Ouvrez un navigateur Web et entrez l'adresse IP ou le nom d'hôte du serveur Web, ainsi que le numéro de port si le serveur n'écoute pas sur le port 80. Par exemple : http://ihs.mycompany.com.

2. Assurez-vous que le serveur d'applications Web WebSphere fonctionne correctement.

Ouvrez un navigateur Web et entrez l'adresse IP ou le nom d'hôte du serveur d'applications Web, ainsi qu'un numéro de port. Par exemple : http://websphere.mycompany.com:9080.

Remarque

Si vous disposez déjà d'applications Web de la plateforme de BI s'exécutant sur le serveur, vous devez annuler leur déploiement avant de poursuivre.

3. Exécutez l'assistant d'installation du plug-in du serveur Web pour installer le plug-in assurant la liaison entre

WebSphere et IHS, puis suivez les instructions pour saisir les informations relatives au serveur Web IHS.

4. Suivez les instructions de configuration du plug-in sur le site Web de WebSphere pour configurer la liaison entre IHS et WebSphere.

Les requêtes de ressources dynamiques sont désormais transférées à WebSphere dès leur réception par IHS.

5. Assurez-vous que la liaison entre le serveur Web et le serveur d'applications Web fonctionne en pointant un navigateur sur le serveur Web et en vérifiant que le contenu dynamique du serveur d'applications Web est traité correctement.

Par exemple, visitez l'URL suivante : http://ihs.mycompany.com/snoop/.

6. Si le serveur d'applications Web est installé sur le même ordinateur que la plateforme de BI, exécutez

WDeploy localement sur cet ordinateur. Si le serveur d'applications Web est exécuté sur un autre ordinateur, copiez la commande et l'environnement WDeploy sur le serveur d'applications Web. Voir Pour déployer des

applications Web sur un ordinateur distant.

7. Configurez l'environnement WDeploy pour répartir le contenu entre le serveur Web et le serveur d'applications Web. On parle dans ce cas de mode "fractionné".

Les fichiers de configuration Wdeploy pour Apache et WebSphere se trouvent à l'emplacement suivant :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/conf.

○ Modifiez config.apache. Par exemple : ws_dir=/opt/apache connector_type=websphere7 deployment_dir=/opt/apache/htdocs plugin_install_dir=${ws_dir}/Plugins

68

©

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

○ Modifiez config.websphere7. Par exemple : as_soap_port=8880

#as_admin_username=admin

#as_admin_password=password as_dir=/opt/websphere/appserver as_instance=server1 as_plugin_cfg_dir=/opt/ibm/WebSphere/AppSever/profiles/AppSrv01/config/cells/

<NOM_CELLULE>

/nodes/

<NOM_NŒUD>

/servers/${ws_instance} as_profile_name=AppSrv01 as_virtual_host=default_host as_admin_is_secure=false enforce_file_limit=true ws_instance=webserver1

8. Utilisez wdeploy predeploy en mode fractionné pour répartir les applications Web source en ressources statiques et ressources dynamiques distinctes.

Remarque

Avant d'exécuter wdeploy predeploy, assurez-vous que le paramètre as_plugin_cfg_dir dans config.websphere

<X>

a été défini sur le dossier contenant le fichier WebSphere plugin-cfg.xml.

Par exemple :

○ Exécutez la commande suivante pour extraire le contenu statique du serveur Web IHS.

wdeploy.sh websphere7

-Das_mode=split

-Dws_type=apache

predeployall

Le contenu dynamique des applications Web se trouve à l'emplacement suivant :

<REP_INSTALL_PBI>

/ sap_bobj/enterprise_xi40/wdeploy/workdir/websphere7/application. Le contenu statique se trouve à l'emplacement suivant :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/ workdir/websphere7/resources.

9. Exécutez la commande wdeploy deployonlyall pour déployer le contenu dynamique sur le serveur d'applications WebSphere et le contenu statique sur IHS.

Si IHS et WebSphere sont installés sur le même ordinateur, le contenu statique et le contenu dynamique seront automatiquement déployés sur les serveurs à l'aide de la commande suivante : wdeploy.sh websphere7 -Das_mode=split

-Dws_type=apache deployonlyall

Remarque

Si votre contenu statique et votre contenu dynamique sont situés à un emplacement personnalisé, utilisez le paramètre -Dwork_dir.

Si IHS et WebSphere sont installés sur des ordinateurs différents, le contenu dynamique sera automatiquement déployé sur WebLogic à l'aide de la commande suivante : Le contenu dynamique devra être déployé manuellement sur l'ordinateur IHS distant par la suite.

./wdeploy.sh websphere7 -Das_mode=split

deployonlyall

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.

69

Remarque

Si votre contenu statique et votre contenu dynamique sont situés à un emplacement personnalisé, utilisez le paramètre -Dwork_dir.

Copiez le contenu statique dans le répertoire htdocs sur le serveur Web :

○ Décompressez les fichiers zip sur le serveur d'applications Web sous

<REP_INSTALL_PBI>

/sap_bobj/ enterprise_xi40/wdeploy/workdir/websphere7/resources.

○ Copiez ces dossiers du serveur d'applications Web WebSphere dans le dossier

<REP_WS>

/htdocs du serveur IHS.

○ Copiez les fichiers bobj.

<application>

.conf du serveur d'applications Web WebSphere dans le dossier

<REP_WS>

/conf du serveur IHS.

○ Servez-vous des fichiers de configuration de l'application pour mettre à jour le fichier httpd.conf du serveur IHS qui se trouve dans le répertoire

<REP_WS>

/conf. Pour chaque application Web, incluez une entrée dans httpd.conf. Par exemple, pour inclure BOE, vous devez saisir :

Include conf/bobj.BOE.conf

10. Copiez le fichier plugin-cfg.xml dans les dossiers de travail d'IHS et de WebSphere. Si vous utilisez la console d'administration WebSphere pour effectuer le déploiement alors qu'IHS et WebSphere sont installés sur le même système hôte, passez à l'étape suivante. La commande WDeploy va automatiquement copier plugin-cfg.xml si IHS et WebSphere sont installés sur le même système hôte.

Par exemple, copiez le fichier suivant :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/work_dir/websphere7/application/

PluginSplit/plugin-cfg.xml

Dans le dossier de travail de WebSphere :

<WS_HOME>

/AppServer/profiles/AppSrv01/config/cells/

<NOM_CELLULE>

/nodes/

<NOM_NŒUD>

/ servers/

<NOM_SERVEUR>

Et dans le dossier de travail IHS :

<REP_WS>

/Plugins/config/

<NOM_SERVEUR_WEB>

11. Assurez-vous que le contenu statique et le contenu dynamique sont correctement configurés en tentant d'accéder à une application Web via le serveur Web. Par exemple, créez une URL comprenant l'adresse du serveur Web avec le contexte racine d'une application Web déployée sur le serveur d'applications Web : http://ihs.mycompany.com/BOE/CMC/ Dans cet exemple, ihs.monentreprise.com est le serveur Web et /BOE/CMC/ une application Web déployée.

Le contenu statique est désormais traité par un serveur Web dédié et le contenu dynamique par un serveur d'applications Web dédié.

4.6.3.4.2 Pour charger des classes d'abord avec chargeur de classe d'application

Définissez le comportement de chargement de classes de vos applications Web sur Classes d'abord chargées avec chargeur de classe d'application (parent ensuite) à l'aide de la

Console d'administration

WebSphere. Cela

70

©

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

garantit que les classes communes accompagnant les applications Web de la plateforme de BI, telles que la bibliothèque JavaServer Faces (JSF), sont utilisées plutôt que toute autre implémentation issue de WebSphere.

Connectez-vous à la

Integrated Solutions Console

(Console de solutions intégrées) WebSphere avec le compte administrateur. Vous pouvez exécuter le programme de la

console d'administration

WebSphere ou utiliser un navigateur Web pour ouvrir http://

<NOM_HOTE_WAS>

:

<PORT>

/ibm/console où

<NOM_HOTE_WAS>

est le nom du serveur WebSphere et

<PORT>

est le numéro de port sur lequel le serveur d'administration est à l'écoute. Le numéro de port par défaut est 9060.

1. Sélectionnez Applications Application Type (Type d'application) WebSphere enterprise applications (Applications d'entreprise WebSphere) dans le menu.

L'écran

Enterprise Applications

(Applications d'entreprise) apparaît.

2. Dans la liste des ressources gérées, sélectionnez l'application Web déployée par WDeploy.

L'écran de configuration

Enterprise Applications

(Applications d'entreprise) apparaît.

3. Cliquez sur Manage Modules (Gérer les modules).

L'écran

Manage Modules

(Gérer les modules) apparaît.

4. Sélectionnez le module de l'application Web (dans la colonne

Module

).

L'écran

Manage Modules General Properties

(Gérer les modules - Propriétés générales) apparaît.

5. Sélectionnez Classes loaded with application class loader first (parent last) (Classes d'abord chargées avec chargeur de classe d'application (parent ensuite)) dans la propriété

Class loader order

(Ordre du chargeur de classes).

Un message de confirmation s'affiche.

6. Cliquez sur Save directly to the master configuration (Enregistrer directement dans la configuration maître).

La configuration de l'application Web est enregistrée. Vous retournez à l'écran

Manage Modules

(Gérer les modules).

7. Cliquez sur OK.

Un message apparaît pour confirmer la modification de la configuration maître.

8. Cliquez sur Save directly to the master configuration (Enregistrer directement dans la configuration maître).

La configuration de l'application Web est enregistrée. Vous retournez à l'écran

Enterprise Applications

(Applications d'entreprise).

9. Cochez la case de l'application Web et cliquez sur Start (Démarrer).

Un message apparaît pour confirmer le lancement de l'application Web.

Si vous déployez plusieurs applications Web, répétez les étapes 2 à 9 pour chacune d'entre elles.

4.6.4 Pré-déploiement de niveau Web divisé sans accès à un serveur d'applications Web

La commande WDeploy peut séparer le contenu statique du contenu dynamique pour un déploiement sur un serveur Web et un serveur d'applications Web. Il n'est pas nécessaire d'accéder au dossier de déploiement d'un serveur d'applications Web : le contenu distinct peut être copié manuellement du serveur hébergeant WDeploy vers le serveur Web et serveur d'applications Web.

Lorsque WDeploy est installé sur un serveur Web dédié, les commandes wdeploy predeploy ou wdeploy predeployall sont utilisées pour créer le contenu statique d'applications Web directement dans le répertoire du

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.

71

contenu du serveur Web. Certains paramètres sont obligatoires pour des serveurs Web ou des serveurs d'applications Web spécifiques :

Paramètres requis pour le prédéploiement Serveur Web ou serveur d'applications Web

WebSphere Application Ser­ ver

Apache et IBM IHS as_virtual_host ws_dir, deployment_dir, connector_type

4.6.5 Désactivation des applications Web CMC ou Zone de lancement BI

Les applications Web de la CMC (Central Management Console) et de la zone de lancement BI (anciennement

InfoView) sont désormais incluses dans l'archive BOE (BOE.war ou BOE.ear). Pour désactiver l'application Web de la zone de lancement BI ou de la CMC de manière à ce que l'une ou les deux ne soient pas accessibles lors du déploiement de l'archive BOE sur un serveur d'applications Web, utilisez l'outil WDeploy.

Pour désactiver l'application Web CMC, servez-vous du commutateur -Ddisable_CmcApp=true lors du déploiement de BOE.war sur le serveur d'applications Web. La commande suivante, par exemple, déploiera

BOE.war sur un serveur d'applications Web Tomcat 6 et désactivera la CMC : wdeploy.sh tomcat6 -DAPP=BOE -Ddisable_CmcApp=true deploy

Pour désactiver l'application Web Zone de lancement BI, ajoutez le commutateur -Ddisable_InfoView=true lors du déploiement de BOE.war sur le serveur d'applications Web. La commande suivante, par exemple, déploiera BOE.war sur un serveur d'applications Web Tomcat 6 et désactivera la zone de lancement BI : wdeploy.sh tomcat6 -DAPP=BOE -Ddisable_InfoView=true deploy

4.6.6 Modifications apportées aux langues installées

Pour ajouter une prise en charge linguistique aux applications Web, vous devez réinstaller la plateforme de BI et sélectionner la ou les langues requises au cours du processus d'installation. Une fois l'installation terminée, toute application Web déployée requérant la ou les nouvelles langues doit être redéployée sur le serveur d'applications

Web.

Cela est dû au fait que le programme d'installation ne redéploie pas automatiquement les applications Web. Les applications Web doivent être fournies à nouveau et redéployées sur le serveur d'applications Web.

4.7 Utilisation de l'outil WDeploy GUI

L'outil WDeploy GUI est installé dans le cadre de l'installation de la plateforme de BI. Il permet d'exécuter les commandes wdeploy deployall ou wdeploy undeployall selon une autre méthode de type graphique.

72

©

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

Remarque

● Il est recommandé d'utiliser l'outil de ligne de commande WDeploy plutôt que l'outil d'interface graphique utilisateur de WDeploy. L'outil de ligne de commande possède des fonctionnalités plus robustes.

● L'outil WDeploy GUI ne peut pas être utilisé pour prédéployer des applications Web. Utilisez l'outil de ligne de commande pour exécuter la commande wdeploy predeployall.

Pour en savoir plus sur les exigences WDeploy, voir :

●

Conditions préalables à l'utilisation de l'outil WDeploy

[page 19]

●

Prérequis concernant l'utilisation de l'outil WDeploy GUI

[page 73]

Pour effectuer d'autres opérations de déploiement, utilisez la version de ligne de commande de WDploy.

Par défaut, l'outil d'interface graphique utilisateur WDeploy est en anglais. Toutefois, une invite permet à l'utilisateur de choisir une autre langue lorsque l'outil est exécuté pour la première fois si des packs linguistiques sont installés. Les packs linguistiques ci-après sont pris en charge par la plateforme de BI :

● Tchèque

● Chinois simplifié

● Chinois traditionnel

● Danois

● Néerlandais

● Anglais

● Finnois

● Français

● Allemand

● Hongrois

● Italien

● Japonais

● Coréen

● Norvégien (Bokmål)

● Polonais

● Portugais

● roumain

● Russe

● Slovaque

● Espagnol

● Suédois

● Thaï

● Turc

4.7.1 Prérequis concernant l'utilisation de l'outil WDeploy

GUI

Pour utiliser l'outil WDeploy GUI, assurez-vous que les conditions suivantes sont remplies :

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.

73

● Définissez la variable d'environnement PERL_HOME.

Si Perl 5.8.9 n'a pas encore été installé, définissez PERL_HOME à

<REP_INSTALL_PBI>

/InstallData/ setup.engine/perl.

Il est recommandé de se servir de la version de Perl installée en même temps que la plateforme de BI. Pour utiliser votre propre version de Perl 5.8.9, assurez-vous que les modules suivants sont également installés :

○ Text::CharWidth

Obtient le nombre de colonnes occupées d'une chaîne sur terminal. Pour en savoir plus, voir l'article

CharWidth.pm à l'emplacement suivant :

http://search.cpan.org

.

○ Text::WrapI18N

Module de retour automatique à la ligne avec prise en charge des langues et des caractères multioctets, à pleine chasse et combinatoires sans espaces blancs entre les mots. Pour en savoir plus, voir l'article

WrapI18N.pm à l'emplacement suivant :

http://search.cpan.org

.

4.7.2 Démarrage de l'outil WDeploy GUI

L'outil WDeploy GUI se trouve dans le dossier

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy.

La syntaxe de la commande WDeploy (à partir du répertoire wdeploy) est la suivante :

./wdeployGUI.sh

Lorsque l'outil d'interface graphique utilisateur de WDeploy est exécuté pour la première fois, il demande quelle langue utiliser pour afficher les informations dans l'interface utilisateur. Sélectionnez une langue puis continuez.

4.7.3 Fenêtre de l'outil WDeploy GUI

L'outil WDeploy GUI permet aux utilisateurs de déployer et d'annuler le déploiement d'applications Web sur un serveur d'applications Web. Les applications Web non déployées par le programme d'installation de la plateforme de BI ou par l'outil WDeploy ne sont pas affectées.

Sélectionnez un serveur d'applications Web pris en charge dans la liste déroulante Sélectionner le type de serveur d'applications Web. Lorsque un serveur d'applications Web est sélectionné, vérifiez les informations des sections

Informations sur le serveur d'applications Web

et

Répertoire racine du domaine du serveur d'applications

pour vous assurez qu'elles sont correctes pour votre serveur d'applications.

Pour plus d'options avancées, sélectionnez Options.

Remarque

Les applications Web ne sont pas toutes déployées automatiquement. Les applications Web non déployées automatiquement doivent l'être à l'aide de l'outil de ligne de commande WDeploy ou de la console d'administration du serveur d'applications Web.

Archive d'applications Web (WAR ou EAR)

BOE

Déployée automatiquement ?

Oui

74

©

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

Archive d'applications Web (WAR ou EAR)

AdminTools dswsbobje

BusinessProcessBI (obsolète) clientapi

MobileOTA14 jsfplatform

OpenSearch

Déployée automatiquement ?

Oui

Oui

Oui

Non

Non

Non

Non

4.7.4 Mises à jour des applications Web via WDeploy

Table 12 : Modification de la configuration des applications Web via WDeploy

Serveur Modifications effectuées

Serveur Web Apache Pour chaque application, le fichier ${ws_dir}/conf/bobj.${APP}.conf est créé et répertorie toutes les informations de configuration de connecteur, de répertoire et de mappage de servlets. Le fichier ${ws_dir}/conf/ httpd.conf est modifié pour inclure ce fichier.

Tomcat

Les fichiers ajoutés à classpath sont déposés dans ${as_dir}/shared/lib

Le fichier ${as_dir}/bin/bobjeEnv.${APP}.[sh|bat] est créé et réperto­ rie les modifications de chemin d'accès à la bibliothèque ainsi que les modifica­ tions des propriétés Java pour ajouter les propriétés de l'application.

Le fichier ${as_dir}/bin/catalina.[sh|bat] est modifié pour inclure ce fichier.

Sous Windows, les propriétés Java supplémentaires sont ajoutées aux paramè­ tres de démarrage du service Tomcat. Les modifications de chemin d'accès à la bibliothèque doivent être effectuées manuellement au niveau de la variable d'environnement système PATH

Redémarrez Tomcat pour prendre en compte les modifications.

WebLogic

Les fichiers à ajouter à classpath sont fournis dans l'application (ajoutés dans

WEB-INF/lib).

Le fichier ${as_domain_dir}/bin/bobjeEnv.${APP}.[sh|cmd] est créé et contient les modifications des propriétés Java et du chemin de la bibliothè­ que.

Le fichier ${as_domain_dir}/bin/startWebLogic.[sh|cmd] est modifié pour inclure ce fichier.

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.

75

Serveur

WebSphere

Modifications effectuées

Les fichiers à ajouter à classpath sont fournis dans l'application (ajoutés dans

WEB-INF/lib).

Des propriétés sont ajoutées en tant que propriétés JVM personnalisées. Les modifications de chemin d'accès à la bibliothèque sont effectuées au niveau de l'environnement de la JVM. Le plug-in du serveur Web est regénéré automati­ quement.

4.7.5 Options de l'outil WDeploy GUI

L'écran

Options

de l'outil WDeploy GUI permet de sélectionner des dossiers personnalisés à utiliser pour le déploiement des applications Web. Cela équivaut à la configurer les propriétés lors de l'utilisation de la ligne de

commande WDeploy. Pour en savoir plus sur les paramètres WDeploy, voir

Paramètres des propriétés WDeploy

[page 41].

●

Répertoire de travail Wdeploy

(équivalent au paramètre work_dir).

●

Emplacement de l'arborescence source des applications Web

(équivalent au paramètre app_source_tree) ou

Emplacement des fichiers WAR génériques

(équivalent au paramètre war_dir).

●

Contexte racine des applications Web

(équivalent au paramètre root_context_path).

Remarque

Les caractères autres qu'anglais ne sont actuellement pas reconnus comme valides par l'outil d'interface graphique utilisateur de WDeploy.

4.7.6 Ajout du mot de passe au fichier WDeploy GUI

L'outil d'interface graphique utilisateur de WDeploy enregistre votre entrée dans un fichier et utilise cette information pour déployer les applications Web. Vous devez ajouter manuellement votre mot de passe à ce fichier même si vous l'avez saisi lors de l'exécution de l'interface graphique utilisateur car les mots de passe ne sont pas enregistrés automatiquement pour des raisons de sécurité.

Pour ajouter votre mot de passe du serveur d'applications Web au fichier WDeploy GUI :

1. Ouvrez le fichier contenant les informations WDeploy :

<REP_INSTALL_BOE>

/sap_bobj/enterprise_xi40/wdeploy/conf/config.

<SERVEUR_APP_WEB>

2. Recherchez la ligne contenant les informations relatives au mot de passe : as_admin_password=

3. Remplacez la valeur du mot de passe, le cas échéant, par votre mot de passe d'application Web.

4. Enregistrez le fichier et exécutez à nouveau l'outil d'interface graphique utilisateur de WDeploy.

76

©

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.8 Après le déploiement des applications Web

Après le déploiement ou l'annulation du déploiement d'applications Web, redémarrez le serveur d'applications

Web.

Pour vérifier la configuration du serveur d'applications Web, assurez-vous que la zone de lancement BI et la CMC

(Central Management Console) peuvent être lancées dans un navigateur Web. Par exemple :

● http[s]://

<SERVEUR_APP_WEB>

:

<PORT>

/

<CONTEXTE_ZONE_LANCEMENT_BI>

● http[s]://

<SERVEUR_APP_WEB>

:

<PORT>

/

<CONTEXTE_CMC>

Remplacez

<SERVEUR_APP_WEB>

par le nom d'hôte ou l'adresse IP du serveur Web ou serveur d'applications Web et

<PORT>

par le numéro de port utilisé pour la communication HTTP ou HTTPS. Le contexte racine par défaut utilisé pour la zone de lancement BI est /BOE/BI ; le contexte par défaut utilisé pour la CMC est /BOE/CMC.

4.9 Fichiers journaux

L'outil WDeploy crée deux fichiers journaux contenant des informations détaillées, utiles pour diagnostiquer des problèmes ou surveiller l'activité.

1.

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/logs/WDeploy_summary.log : enregistrement de haut niveau de l'activité WDeploy comprenant des informations sur la version de WDeploy, sur le kit de développement Java (JDK) utilisé, sur la commande fournie, sur la configuration, sur l'emplacement du fichier WAR, sur les actions ou événements et leurs résultats, ainsi que tous les messages d'erreur ou d'avertissement affichés à l'intention de l'utilisateur lors de l'exécution.

2.

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/logs/WDeploy.log : comprend tout ce qui est inclus dans WDeploy_summary.log, mais également les horodatages ainsi que les messages d'erreur ou d'avertissement.

Lorsqu'une commande WDeploy est exécutée, WDeploy_summary.log.01 est remplacé par la commande en cours et WDeploy.log est annexé.

Lorsque la taille du fichier WDeploy.log dépasse 512 Ko, le fichier est renommé avec un suffixe à un seul chiffre.

Par exemple, WDeploy.log sera renommé WDeploy.log.01. Si un fichier nommé WDeploy.log.01 existe déjà, un fichier WDeploy.log.02 sera créé.

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.

77

5 Déploiement d'applications Web à l'aide de la console d'administration

5.1 Pour déployer manuellement les applications Web

Vous devez utiliser l'outil WDeploy pour générer des fichiers WAR ou EAR déployables avant de les déployer sur votre serveur d'applications Web.

Les étapes suivantes permettent de déployer une application Web à l'aide de la console d'administration du serveur d'applications.

1. Exécutez la commande wdeploy predeploy pour préparer une seule application Web ou wdeploy predeployall pour préparer toutes les applications Web.

Exemple 1 : utilisation de wdeploy predeploy pour préparer le fichier WAR de l'application Web BOE.war pour un déploiement sur Tomcat.

wdeploy.sh tomcat6

-Das_dir=/opt/usr/tomcat

-Das_instance=localhost

-Das_service_name=Tomcat6

-DAPP=BOE

predeploy

Exemple 2 : utilisation de wdeploy predeployall pour préparer toutes les applications Web en vue d'un déploiement sur Tomcat.

wdeploy.sh tomcat6

-Das_dir=/opt/usr/tomcat

-Das_instance=localhost

-Das_service_name=Tomcat6

predeployall

Remarque

Les commandes predeploy et predeployall peuvent être utilisées sur des ordinateurs qui n'hébergent aucun serveur d'applications Web à condition que les paramètres requis par les commandes predeploy ou predeployall soient indiqués.

La commande WDeploy prépare les applications Web pour leur déploiement sur un serveur d'applications

Web et crée des fichiers WAR ou EAR dans REP_INSTALL_PBI/sap_bobj/enterprise_xi40/wdeploy/ workdir/

<SERVEUR_APP>

/application sauf si vous spécifiez le paramètre -Dwork_dir.

2. Suivez la procédure de déploiement manuel spécifique à votre serveur d'applications Web.

Vous pouvez désormais déployer votre application Web manuellement sur le serveur d'applications Web.

Répétez ces étapes pour toute autre application Web devant être installée.

78

©

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 la console d'administration

5.1.1 Déploiement manuel de la console d'administration

JBoss 7.1

Assurez-vous que vous avez installé le serveur d'applications Web, que vous l'avez configuré et qu'il est en cours d'exécution (en mode autonome ou de domaine, selon votre environnement). Utilisez la commande wdeploy predeploy pour créer des fichiers WAR comme BOE.war ou AdminTools.war qui peuvent être déployés manuellement sur JBoss : wdeploy.sh jboss7 -DAPP=BOE predeploy

La commande wdeploy predeploy crée une structure de fichiers WAR explosée pour les applications Web de services Web (dossiers nommés dswsbobje.war et BusinessProcessBI.war). Par exemple : jboss7

application

dswsbobje.war

axis2-web

images

META-INF

WEB-INF

Une fois les fichiers WAR créés, copiez-les à un nouvel emplacement avant le déploiement sur JBoss à l'aide de l'interface de ligne de commande JBoss.

1. Depuis le répertoire bin de JBoss, exécutez la commande jboss-cli --connect pour démarrer l'interface de ligne de commande JBoss et vous connecter au serveur d'applications.

2. Exécutez la commande /deployment sur le fichier WAR compressé ou le dossier WAR explosé. Si vous réalisez un déploiement sur un domaine géré, exécutez également la commande /server-group.

Dans les exemples suivants, considérez que le WAR est stocké dans /BIPwebapps/ et que le groupe de serveurs est nommé main-server-group.

○ Pour les fichiers compressés .war tels que BOE.war, définissez la valeur archive sur true :

Serveur autonome :

/deployment=BOE.war:add(enabled="true",runtimename="BOE.war",content=[{"path"=>"/BIPwebapps/BOE.war","archive"=>true}])

Domaine géré :

/deployment=BOE.war:add(runtime-name="BOE.war",content=[{"path"=>"/BIPwebapps/

BOE.war","archive"=>true}])

/server-group=main-server-group /deployment=BOE.war:add(enabled=true)

○ Pour les structures de fichiers explosées .war telles que dswsbobje.war, définissez la valeur archive sur false :

Serveur autonome :

/deployment=dswsbobje.war:add(enabled="true",runtimename="dswsbobje.war",content=[{"path"=>"/BIPwebapps/ dswsbobje.war","archive"=>false}])

Domaine géré :

/deployment=dswsbobje.war:add(runtimename="dswsbobje.war",content=[{"path"=>"/BIPwebapps/

Guide de déploiement d'applications Web

Déploiement d'applications Web à l'aide de la console d'administration

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

79

dswsbobje.war","archive"=>false}])

/server-group=main-server-group /deployment=dswsbobje.war:add(enabled=true)

Un message indiquant la réussite du déploiement s'affiche à l'issue de celui-ci : {"résultat" =>

"réussite"}

Connectez-vous à l'interface Web

Administration Console

JBoss avec le compte Administrateur à l'adresse http://

<NOMHOTE_SAW>

:9990/console pour confirmer que votre application est en cours d'exécution.

5.1.2 SAP NetWeaver

5.1.2.1 Conditions préalables au déploiement sur SAP

NetWeaver

Remarque

Si des applications Web de la plateforme SAP BusinessObjects Business Intelligence sont en cours d'exécution sur le serveur, vous devez annuler leur déploiement avant de poursuivre.

Avant de déployer des applications Web de la plateforme de BI sur SAP NetWeaver Application Server (quelle qu'en soit la version), vous devez veiller à ce que les fichiers .html et .htm ne soient jamais compressés. Par exemple, dans SAP NetWeaver AS 7.3 :

1. Connectez-vous au portail d'administration SAP NetWeaver.

Par exemple : http://<nomserveur>:50200/nwa

2. Accédez à : Configuration Infrastructure Java System Properties (Propriétés système Java) .

3. Dans l'onglet Services, sélectionnez HTTP Provider (Fournisseur HTTP).

4. Sous

Extended Details (Détails étendus)

, modifiez les propriétés AlwaysCompressed et NeverCompressed comme suit :

○ AlwaysCompressed : Supprimez *.htm,*.html,text/html de cette propriété. Ce champ ne peut pas

être vide. Entrez un espace sinon.

○ NeverCompressed : Ajoutez *.htm,*.html,text/html à cette propriété.

Table 13 : Exemple

Nom

AlwaysCompressed

Valeur calculée par défaut

(s'il est vide, définissez-le sur espace vide)

NeverCompressed

*.htm,*.html,text/html

5. Enregistrez vos changements avant de quitter.

80

©

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 la console d'administration

5.1.2.2 Déploiement de SAP NetWeaver avec SAP Software

Update Manager (SUM)

Assurez-vous que vous avez installé le serveur d'applications Web, que vous l'avez configuré et qu'il est exécuté.

Utilisez la commande wdeploy predeploy pour créer des packages SCA comme BOE.sca et AdminTools.sca qui peuvent être déployés manuellement sur SAP NetWeaver.

wdeploy.sh weblogic11 -DAPP=BOE predeploy

Vous avez besoin de SAP Software Update Manager (SUM) pour déployer les applications Web sur SAP

NetWeaver. Téléchargez SUM depuis l'emplacement

http://service.sap.com/swdc

>Support Packages and Patches (Support Packages et correctifs) >A – Z

Index (Index A à Z)>S>SL Toolset <release> (SL Toolset <version>)>Entry by Component (Entrée par composant)>Software Update Manager (SUM).

Installez SUM sur le système qui héberge NetWeaver, avec un accès réseau aux packages SCA à déployer.

1. Décomprimez le package Software Update Manager à l'aide de la commande suivante :

SAPCAR - xvf <répertoire des téléchargements>\<chemin>\<Archive>.SAR -R

<LECTEUR_INSTALL_SAPNW>:\usr\sap\<sidsap>

2. Exécutez la commande predeploy ou predeployall pour générer les fichiers SCA.

Les applications Web de la plateforme de BI qui en sont issues se trouvent sous :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/workdir/sapappsvr73/application

3. Copiez tous les fichiers SCA dans le dossier suivant :

<LECTEUR_INSTALL_SAPNW>/usr/sap/Trans/EPS/in

4. Démarrez le serveur d'applications SAP NetWeaver.

5. Démarrez le processus de serveur de Software Update Manager avec la commande suivante à l'aide de l'utilisateur <SID> ADM :

<LECTEUR_INSTALL_SAPNW>:\<répertoire de mises à jour>\STARTUP

6. Démarrez l'interface utilisateur graphique de SUM depuis un navigateur, à l'adresse http://<nomhôte>:

4239 ou en local avec la commande :

<LECTEUR_INSTALL_SAPNW>:\usr\sap\<sidsap>\SUM\sdt\exe\DSUGui

7. Lorsque vous y êtes invité, créez un utilisateur Administrateur temporaire pour la procédure de maintenance.

Consultez la section Mise à jour de systèmes SAP à l'aide de Software Update Manager 1.0 SP08 du guide

SUM sur SAP Service Marketplace.

8. Lorsque vous y êtes invité à l'étape de la feuille de route

Select Target

(Sélectionner une cible), utilisez l'option de SUM

Manually Prepared Download Directory

(Répertoire des téléchargements préparés manuellement).

9. Naviguez jusqu'à

<LECTEUR_INSTALL_SAPNW>

\usr\sap\Trans\EPS\in, sélectionnez-le et cliquez sur

Next.

10. Suivez la procédure de mise à jour jusqu'à ce que le déploiement soit terminé et qu'un onglet de confirmation s'affiche. Pour en savoir plus, voir le dernier rapport ProcessOverview.html situé sous

<LECTEUR_INSTALL_SAPNW>

:\usr\sap\

<sapsid>

\SUM\sdt\htdoc.

Pour en savoir plus sur Software Update Manager, consultez les guides de l'utilisateur et les autres documents sur

http://help.sap.com

.

Guide de déploiement d'applications Web

Déploiement d'applications Web à l'aide de la console d'administration

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

81

Remarque

Si une erreur HTTP ou une erreur de session se produit lorsque vous accédez à une application correctement déployée (comme la CMC), patientez quelques minutes, puis essayez d'actualisez la page.

5.1.3 Déploiement manuel de la console d'administration

Tomcat 6 et 7

Assurez-vous que vous avez installé le serveur d'applications Web, que vous l'avez configuré et qu'il est exécuté.

Utilisez la commande wdeploy predeploy pour créer des fichiers WAR comme BOE.war et AdminTools.war qui peuvent être déployés manuellement sur Tomcat : wdeploy.sh tomcat7 -DAPP=BOE predeploy

1. Connectez-vous à l'application de console d'administration

Tomcat Manager

à l'adresse http://

<NOMHOTE_SAW>

:

<PORT>

/manager/html.

Le numéro de port par défaut est 8080.

2. Définissez le chemin de contexte de l'application Web à déployer.

Le chemin de contexte doit porter le même nom que le fichier WAR, mais sans extension et précédé d'une barre oblique. Par exemple, pour déployer une application Web prête à l'emploi sous la forme

<VOTRE_APPLICATION_WEB>

.war, le chemin de contexte doit être /

<VOTRE_APPLICATION_WEB>

.

3. Définissez le paramètre XML Configuration File (Fichier de configuration XML) déterminant l'emplacement d'un fichier XML qui contient le chemin de contexte et la base de documents.

La base de documents est le fichier WAT prédéployé que vous avez créé à l'aide de la commande wdeploy predeploy. Par exemple :

<Context

docBase="<BOE_INSTALL_DIR>/sap_bobj/enterprise_xi40/wdeploy/workdir/tomcat7/ application/

<YOUR_WEB_APPLICATION>

.war"

path="<context_path>"

crossContext="false" debug="0" reloadable="false" trusted="false"

/>

4. Saisissez le chemin complet du fichier WAR et cliquez sur Déployer.

Le fichier WAR est déployé.

5.1.3.1 Pour effectuer un déploiement sur un cluster Tomcat

Pour déployer manuellement des applications Web sur un cluster d'applications Web Tomcat réparti entre plusieurs ordinateurs, déployez les applications Web sur chaque serveur d'applications Web Tomcat. Utilisez la console d'administration pour déployer les applications Web dans le sous-dossier webapps du répertoire d'accueil Tomcat de chaque instance de serveur.

82

©

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 la console d'administration

Remarque

Si vous utilisez Tomcat, arrêtez le serveur d'applications Web avant de lancer la commande d'action wdeploy undeployall.

Conseil

Il est recommandé d'installer et de configurer un équilibreur de charge matériel ou logiciel si vous exécutez des applications Web de la plateforme de BI sur un cluster d'applications Web Tomcat. Consultez la documentation

Tomcat pour en savoir plus sur la configuration de l'équilibrage de charge sur un cluster Tomcat.

5.1.4 Déploiement manuel de la console d'administration

WebLogic 11gR1

Avant le déploiement, assurez-vous que vous avez installé le serveur d'applications Web, que vous l'avez configuré et qu'il est exécuté. Créez un domaine WebLogic dans lequel exécuter les applications Web de la plateforme de BI.

Utilisez la commande wdeploy predeploy pour créer des fichiers WAR comme BOE.war et AdminTools.war qui peuvent être déployés manuellement sur WebLogic : wdeploy.sh weblogic11 -DAPP=BOE predeploy

Remarque

La commande wdeploy predeploy crée une structure de dossiers décompressée pour les applications Web

Web Services (dswsbobje et BusinessProcessBI) plutôt qu'un fichier WAR. Par exemple : weblogic11

application

dswsbobje

dswsbobje

axis2-web

images

META-INF

WEB-INF

lib

META-INF

Resources

Vous devez sélectionner le deuxième dossier intérieur dswsbobje ou BusinessProcessBI lorsque vous déployez sur WebLogic.

1. Connectez-vous à la console d'administration

WebLogic Server Administrative Console

à l'adresse http://

<NOMHOTE_SAW>

:

<PORT>

/console.

Le numéro de port par défaut est 7001.

La page Web

WebLogic Server Administration Console

(Console d'administration du serveur WebLogic) s'affiche.

2. (Facultatif) Dans le panneau

Change Center

(Centre des modifications), cliquez sur Lock & Edit (Verrouiller et modifier).

Guide de déploiement d'applications Web

Déploiement d'applications Web à l'aide de la console d'administration

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

83

Cette étape est uniquement requise si la configuration du domaine est verrouillée, comme dans un environnement de production.

3. Dans le panneau

Domain Structure

(Structure du domaine), cliquez sur Deployments (Déploiements).

4. Dans la page

Summary of Deployments

(Résumé des déploiements), cliquez sur Install (Installer), puis dans la page

Install Application Assistant

(Installer l'assistant d'application), accédez au fichier WAR ou au chemin d'accès au dossier :

Option Description

Fichier WAR (comme

BOE.war

)

Sélectionnez le chemin d'accès au fichier WAR. Par exemple :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/workdir/ weblogic11/application/BOE.war

Structure des dossiers

(comme

dswsbobje

)

Sélectionnez le chemin d'accès à la structure des dossiers. Par exemple :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/workdir/ weblogic11/application/dswsbobje/dswsbobje

Remarque

Vous devez sélectionner le deuxième dossier intérieur dswsbobje ou

BusinessProcessBI lorsque vous déployez sur WebLogic.

Cliquez sur Suivant.

5. Sélectionnez Install this deployment as an application (Installer ce déploiement en tant qu'application) et cliquez sur Next (Suivant). Après avoir passé en revue et fourni les paramètres supplémentaires dans l'assistant, cliquez sur Finish (Terminer).

6. (Facultatif) Dans le panneau

Change Center

(Centre des modifications), cliquez sur Activate Changes

(Activer les modifications) pour appliquer les modifications au serveur d'applications Web.

Cette étape est uniquement requise si la configuration du domaine est verrouillée, comme dans un environnement de production.

Ouvrez l'application Web dans un navigateur Web pour confirmer son exécution.

5.1.5 Déploiement manuel de la console d'administration

WebSphere 7.0. et 8.5

5.1.5.1 Déploiement manuel de la console d 'administration

WebSphere 7.0

Assurez-vous que vous avez installé le serveur d'applications Web, que vous l'avez configuré et qu'il est exécuté.

Utilisez la commande wdeploy predeploy pour créer des fichiers EAR comme BOE.ear et AdminTools.ear qui peuvent être déployés manuellement sur WebSphere : wdeploy.sh websphere7 -DAPP=BOE predeploy

84

©

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 la console d'administration

Si vous déployez l'application BOE ou toutes les applications Web, augmentez le paramètre d'expiration pour

éviter un message d'expiration et un échec du déploiement (voir

Pour modifier le paramètre d'expiration du déploiement de WebSphere 7.0 ou 8.5

[page 88]).

1. Connectez-vous à la console

Integrated Solutions Console

WebSphere à l'aide du compte Administrateur à l'adresse http://

<NOMHOTE_SAW>

:

<PORT>

/ibm/console.

Le numéro de port par défaut est 9060.

2. Sélectionnez Applications Types d'application Applications d'entreprise WebSphere dans le menu.

L'écran

Enterprise Applications

(Applications d'entreprise) apparaît.

3. Cliquez sur Installer.

Dans l'écran

Preparing for the application installation

(Préparation à l'installation de l'application),

Path to the new application

(Chemin vers la nouvelle application) apparaît.

4. Cliquez sur Parcourir et sélectionnez le fichier EAR de l'application Web.

Le chemin entièrement qualifié vers le fichier EAR de l'application Web apparaît dans le champ

Chemin complet

.

5. Passez à l'écran suivant.

L'écran

How do you want to install the application?

(Comment souhaitez-vous installer l'application ?) apparaît.

6. Acceptez l'option par défaut

Fast Path

(Chemin rapide) et passez à l'écran suivant.

L'écran

Install New Application

(Installer la nouvelle application),

Step 1: Select installation options

(Etape 1 :

Sélectionner les options d'installation) apparaît.

7. Acceptez les options par défaut et passez à l'écran suivant.

L'écran

Step 2: Map modules to servers

(Etape 2 : Mapper les modules sur les serveurs) apparaît.

8. Acceptez les options par défaut et passez à l'écran suivant.

L'écran

Step 3: Summary

(Etape 3 : Résumé) apparaît.

9. Examinez le résumé et cliquez sur Finish (Terminer).

L'application Web est installée et un message apparaît pour confirmer la modification de la configuration maître.

10. Cliquez sur Save directly to the master configuration (Enregistrer directement dans la configuration maître).

La configuration de l'application Web est enregistrée. Vous retournez à l'écran

Enterprise Applications

(Applications d'entreprise). Notez qu'à ce stade, l'application Web n'est pas encore exécutée.

11. Sélectionnez l'application Web dans la liste des applications déployées (ressources gérées).

L'écran

Configuration

s'affiche.

12. Cliquez sur Manage Modules (Gérer les modules).

L'écran

Manage Modules

(Gérer les modules) apparaît.

13. Sélectionnez le module de l'application Web (dans la colonne

Module

).

L'écran

Manage Modules General Properties

(Gérer les modules - Propriétés générales) apparaît.

14. Sélectionnez Classes loaded with local class loader first (parent last) (Classes d'abord chargées avec chargeur de classe locale (parent ensuite)) dans la propriété

Class loader order

(Ordre du chargeur de classes).

Un message de confirmation s'affiche.

15. Cliquez sur Save directly to the master configuration (Enregistrer directement dans la configuration maître).

La configuration de l'application Web est enregistrée. Vous retournez à l'écran

Manage Modules

(Gérer les modules).

Guide de déploiement d'applications Web

Déploiement d'applications Web à l'aide de la console d'administration

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

85

16. Cliquez sur OK.

Un message apparaît pour confirmer la modification de la configuration maître.

17. Cliquez sur Class loading and update detection (Chargement de classes et détection de mises à jour).

L'écran de configuration

Class loader

(Chargeur de classes) apparaît.

18. Saisissez l'intervalle d'interrogation de votre choix dans le champ Polling interval for updated files (Intervalle d'interrogation pour fichiers mis à jour) et cliquez sur OK.

Un message apparaît pour confirmer la modification de la configuration maître.

19. Cliquez sur Save directly to the master configuration (Enregistrer directement dans la configuration maître).

La configuration de l'application Web est enregistrée. Vous retournez à l'écran

Enterprise Applications

(Applications d'entreprise).

20. Cochez la case de l'application Web et cliquez sur Start (Démarrer).

Un message apparaît pour confirmer le lancement de l'application Web.

L'application Web est déployée, configurée et exécutée. Testez-la en utilisant le contexte racine fourni plus haut.

Répétez ces étapes pour chaque application Web.

5.1.5.2 Déploiement manuel de la console d'administration

WebSphere 8.5

Assurez-vous que vous avez installé le serveur d'applications Web, que vous l'avez configuré et qu'il est exécuté.

Utilisez la commande wdeploy predeploy pour créer des fichiers EAR comme BOE.ear et AdminTools.ear qui peuvent être déployés manuellement sur WebSphere : wdeploy.sh websphere8 -DAPP=BOE predeploy

Si vous déployez l'application BOE ou toutes les applications Web, augmentez le paramètre d'expiration pour

éviter un message d'expiration et un échec du déploiement (voir

Pour modifier le paramètre d'expiration du déploiement de WebSphere 7.0 ou 8.5

[page 88]).

1. Connectez-vous à la console

Integrated Solutions Console

WebSphere à l'aide du compte Administrateur à l'adresse http://

<NOMHOTE_SAW>

:

<PORT>

/ibm/console.

Le numéro de port par défaut est 9060.

2. Sélectionnez Applications Types d'application Applications d'entreprise WebSphere dans le menu.

L'écran

Enterprise Applications

(Applications d'entreprise) apparaît.

3. Cliquez sur Installer.

Dans l'écran

Preparing for the application installation

(Préparation à l'installation de l'application),

Path to the new application

(Chemin vers la nouvelle application) apparaît.

4. Cliquez sur Parcourir et sélectionnez le fichier EAR de l'application Web.

Le chemin entièrement qualifié vers le fichier EAR de l'application Web apparaît dans le champ

Chemin complet

.

5. Passez à l'écran suivant.

L'écran

How do you want to install the application?

(Comment souhaitez-vous installer l'application ?) apparaît.

6. Acceptez l'option par défaut

Fast Path

(Chemin rapide) et passez à l'écran suivant.

86

©

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 la console d'administration

L'écran

Install New Application

(Installer la nouvelle application),

Step 1: Select installation options

(Etape 1 :

Sélectionner les options d'installation) apparaît.

7. Acceptez les options par défaut et passez à l'écran suivant.

L'écran

Step 2: Map modules to servers

(Etape 2 : Mapper les modules sur les serveurs) apparaît.

8. Sélectionnez les modules à déployer, puis passez à l'écran suivant.

L'écran

Step 3: Summary

(Etape 3 : Résumé) apparaît.

9. Examinez le résumé et cliquez sur Finish (Terminer).

L'application Web est installée et un message apparaît pour confirmer la modification de la configuration maître.

10. Cliquez sur Save directly to the master configuration (Enregistrer directement dans la configuration maître).

La configuration de l'application Web est enregistrée. Vous retournez à l'écran

Enterprise Applications

(Applications d'entreprise). Notez qu'à ce stade, l'application Web n'est pas encore exécutée.

11. Sélectionnez l'application Web dans la liste des applications déployées (ressources gérées).

L'écran

Configuration

s'affiche.

12. Cliquez sur Manage Modules (Gérer les modules).

L'écran

Manage Modules

(Gérer les modules) apparaît.

13. Sélectionnez le module de l'application Web (dans la colonne

Module

).

L'écran

Manage Modules General Properties

(Gérer les modules - Propriétés générales) apparaît.

14. Sélectionnez Classes loaded with local class loader first (parent last) (Classes d'abord chargées avec chargeur de classe locale (parent ensuite)) dans la propriété

Class loader order

(Ordre du chargeur de classes).

Un message de confirmation s'affiche.

15. Cliquez sur Save directly to the master configuration (Enregistrer directement dans la configuration maître).

La configuration de l'application Web est enregistrée. Vous retournez à l'écran

Manage Modules

(Gérer les modules).

16. Cliquez sur OK.

Un message apparaît pour confirmer la modification de la configuration maître.

17. Cliquez sur Class loading and update detection (Chargement de classes et détection de mises à jour).

L'écran de configuration

Class loader

(Chargeur de classes) apparaît.

18. Saisissez l'intervalle d'interrogation de votre choix dans le champ Polling interval for updated files (Intervalle d'interrogation pour fichiers mis à jour) et cliquez sur OK.

Un message apparaît pour confirmer la modification de la configuration maître.

19. Cliquez sur Save directly to the master configuration (Enregistrer directement dans la configuration maître).

La configuration de l'application Web est enregistrée. Vous retournez à l'écran

Enterprise Applications

(Applications d'entreprise).

20. Cochez la case de l'application Web et cliquez sur Start (Démarrer).

Un message apparaît pour confirmer le lancement de l'application Web.

L'application Web est déployée, configurée et exécutée. Testez-la en utilisant le contexte racine fourni plus haut.

Répétez ces étapes pour chaque application Web.

Guide de déploiement d'applications Web

Déploiement d'applications Web à l'aide de la console d'administration

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

87

5.1.5.3 Pour modifier le paramètre d'expiration du déploiement de WebSphere 7.0 ou 8.5

Le déploiement des applications Web de la plateforme de sur un serveur d'applications Web WebSphere 7, 8.5 ou

8.5.5 peut prendre un certain temps.

Si vous recevez un message d'expiration au cours du déploiement d'applications Web sur WebSphere 7, 8.5 ou

8.5.5, augmentez le paramètre d'expiration du déploiement.

1. Utilisez un éditeur de texte pour modifier le fichier de configuration deployment.xml. L'emplacement de deployment.xml varie en fonction de l'installation et de la configuration du serveur.

Le fichier de configuration deployment.xml se trouve généralement dans

<CELLULE_DEPLOIEMENT>

/ applications/isclite.ear/deployments/isclite/deployment.xml.

Remplacez

<CELLULE_DEPLOIEMENT>

par le nom de la cellule du serveur de déploiement.

Par exemple, si le nom de la cellule est NetworkDeploymentCell01, le chemin complet vers deployment.xml peut être /opt/ibm/WebSphere/AppServer/profiles/Dmgr01/config/cells/

NetworkDeploymentCell01/applications/isclite.ear/deployments/isclite/deployment.xml.

2. Indiquez pour l'attribut invalidationTimeout la valeur souhaitée, en minutes, la valeur maximale étant -1

(pas d'expiration).

3. Enregistrez deployment.xml.

4. Redémarrez le service WebSphere.

Le paramètre d'expiration de WebSphere a été modifié.

5.1.5.4 Pour effectuer un déploiement sur un cluster

WebSphere

Pour déployer manuellement des applications Web de la plateforme de BI sur un cluster d'applications Web

WebSphere réparti entre plusieurs ordinateurs, vous devez déployer les applications Web sur l'ordinateur qui héberge WebSphere Deployment Manager. Une fois que toutes les applications Web requises ont été installées, vous pouvez utiliser WebSphere Integrated Solutions Console pour déployer séparément ces applications sur le cluster.

Conseil

Il est recommandé d'installer et de configurer un équilibreur de charge matériel ou logiciel si vous exécutez des applications Web de la plateforme de BI sur un cluster d'applications Web WebSphere. Pour configurer l'équilibreur de charge et le cluster, consultez la documentation WebSphere.

Pour déployer vos applications Web sur un cluster WebSphere, utilisez le workflow général suivant :

1. Si la plateforme de BI est installée sur un ordinateur qui héberge également WebSphere Deployment

Manager, passez à l'étape 3. Si la plateforme de BI et WebSphere Deployment Manager sont exécutés sur des ordinateurs distincts, commencez par copier l'outil et l'environnement WDeploy sur l'ordinateur qui héberge le serveur d'administration WebSphere.

88

©

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 la console d'administration

2. Modifiez le fichier config.websphere

<X>

situé sous

<REP_INSTALL_PBI>

\SAP BusinessObjects

Enterprise XI 4.0\wdeploy\conf.

Vous devez fournir certaines informations pour le serveur d'administration. Par exemple : as_dir=C:\Program Files\IBM\WebSphere\AppServer as_soap_port=8779 as_virtual_host=default_host as_admin_is_secure=false enforce_file_limit=true

3. Ouvrez une console de ligne de commande et exécutez la commande suivante : wdeploy.sh websphere7 predeployall

Remarque

Utilisez websphere8 pour WebSphere 8.5 ou 8.5.5.

4. Ouvrez WebSphere Integrated Solutions Console.

5. Accédez à Applications Applications d'entreprise pour installer séparément chacune des applications

Web à déployer à partir du répertoire suivant :

<REP_INSTALL_PBI>

\SAP BusinessObjects

Enterprise XI 4.0\wdeploy\workdir\websphere

<X>

\application\

Remarque

Toutes les applications Web sont stockées comme des modules EAR.

6. Suivez les étapes d'installation d'une nouvelle application dans la console pour installer l'application Web.

Remarque

Dans

Map modules to servers

(Mapper les modules sur les serveurs), veillez à mettre en surbrillance le cluster cible et à sélectionner le module à installer avant de cliquer sur Apply (Appliquer).

7. Une fois l'application installée, cliquez sur Enregistrer.

8. Répétez les étapes 5 à 7 pour chaque fichier EAR à installer.

9. Accédez à Administration système Noeuds et sélectionnez les nœuds du cluster non signalés comme

étant synchronisés.

10. Cliquez sur Synchroniser.

11. Pour chaque serveur d'applications du cluster, accédez à Servers (Serveurs) Application servers

(Serveurs d'applications) <nom_serveur_d'applications> Session management (Gestion des sessions) Distributed environment settings (Paramètres d'environnement partagé) Tuning parameters (Paramètres d'ajustement) Custom tuning parameters (Paramètres d'ajustement personnalisés) et sélectionnez All session attributes (Tous les attributs de session) de la propriété

Write contents (Ecrire des contenus)

.

La propriété

Write contents (Ecrire des contenus)

doit être définie sur All session attributes (Tous les attributs de session) pour garantir un réel basculement de votre application Web. Si vous n'utilisez pas de paramètres personnalisés, assurez-vous que vous utilisez un niveau d'ajustement approprié pour votre déploiement, tel que

High

(Elevé) ou

Low

(Bas), définissant cette propriété sur All session attributes (Tous les attributs de session).

Guide de déploiement d'applications Web

Déploiement d'applications Web à l'aide de la console d'administration

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

89

12. Accédez à Applications Enterprise Applications (Application d'entreprise) pour lancer l'application que vous venez d'installer.

90

©

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 la console d'administration

6 Problèmes identifiés et résolutions

6.1 Fins de lignes Windows dans un script wdeploy.sh

Le script wdeploy.sh peut contenir des fins de ligne Windows DOS lorsqu'il est copié d'un ordinateur Windows vers un système Unix ou Linux.

Pour résoudre ce problème, utilisez un éditeur de texte ou un utilitaire tel que dos2unix pour convertir dans wdeploy.sh les fins de ligne Windows DOS (retours chariot, sauts de ligne) en fins de ligne Unix (retours chariot).

6.2 Attribution d'un nouveau nom à l'application Web BOE ou

à l'arborescence source de l'application Web

Lorsque l'arborescence source de l'application Web de la plateforme de BI est renommée dans le dossier, il est possible qu'elle ne soit pas correctement déployée par l'outil WDeploy. Cela affecte toutes les plateformes prises en charge. Le dossier d'arborescence source se trouve à l'emplacement suivant :

<REP_INSTALL_PBI>

/enterprise_xi40/warfiles/webapps

Pour résoudre ce problème, procédez comme suit :

1. Cherchez le fichier de configuration d'applications Web BOE BOE.properties dans

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/conf/apps

2. Renommez BOE.properties de manière à ce qu'il reflète le nouveau nom du fichier WAR d'application Web.

Par exemple, si vous souhaitez renommer l'application Web BOE en MYBOE et que vous avez déjà renommé

BOE.war en MYBOE.war, renommez BOE.properties en MYBOE.properties.

3. Utilisez un éditeur de texte pour mettre à jour les contenus du fichier .properties renommé. Mettez à jour les informations sur les applications Web dans le fichier de configuration.

#Business Objects Configuration Utility

#BOE specific properties warfile=

<NOM_APP_WEB>

.war

appvdir=

<NOM_APP_WEB>

buildfile=

<NOM_APP_WEB>

.xml

osgisupported=true

Par exemple, si vous souhaitez renommer l'application Web BOE en MYBOE, remplacez

<NOM_APP_WEB>

audessus par MYBOE.

4. Renommez BOE.xml de manière à ce qu'il reflète le nouveau nom du fichier WAR d'application Web.

Par exemple, si vous souhaitez renommer l'application Web BOE en MYBOE et que vous avez déjà renommé

BOE.war ou BOE.ear en MYBOE.war ou en MYBOE.ear , renommez BOE.xml en MYBOE.xml.

L'outil WDeploy peut à présent déployer l'application Web renommée sur le serveur d'applications Web.

Guide de déploiement d'applications Web

Problèmes identifiés et résolutions

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

91

6.3 Utilisation de WDeploy dans un environnement purement

IPv6

Si vous utilisez la commande wdeploy dans un environnement purement IPv6 avec le JDK Oracle (Java

Development Kit), celui-ci peut ne pas permettre la liaison du serveur d'applications Web à une adresse IPv6, ce qui peut faire échouer les commandes wdeploy.

Cela est dû au fait que le JDK Oracle utilise par défaut des adresses IPv4. Modifiez les paramètres du JDK Oracle de façon à ce que Java utilise des adresses IPv6 en définissant la variable JAVA_OPTIONS dans votre environnement ou script de démarrage :

JAVA_OPTIONS="-Djava.net.preferIPv6Addresses=true"

Par exemple, sur un serveur d'applications Web WebLogic, ajoutez JAVA_OPTIONS="-

Djava.net.preferIPv6Addresses=true" aux scripts setDomainEnv.sh ou setDomainEnv.cmd.

Relancez votre serveur d'applications Web et vérifiez la connectivité avec l'alias ::1 ou hôtelocal dans le fichier hosts.

6.4 Services Web sur des serveurs de niveau Web divisé

L'application Web des services Web (dswsbobje.war) n'est pas prise en charge dans les déploiements de niveau

Web divisé. Les déploiements de niveau Web divisé possèdent des serveurs Web et des serveurs d'applications

Web distincts.

6.6 WDeploy avec d'autres langues que l'anglais

Si vous utilisez l'outil WDeploy dans une autre langue que l'anglais :

● L'outil d'interface graphique utilisateur WDeploy ne prend pas en charge les caractères autres qu'anglais dans les paramètres de nom d'utilisateur et de mot de passe d'administrateur serveur dans le fichier de configuration config.

<SERVEUR_APP_WEB>

.

● Sous Windows, les outils d'interface graphique utilisateur et de ligne de commande WDeploy peuvent échouer et renvoyer une exception lors de la transmission de chemins de fichier autres qu'anglais avec des caractères

UTF-8. Le fichier journal indique que le chemin consiste en des caractères non valides et ne peut être trouvé.

92

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

Guide de déploiement d'applications Web

Problèmes identifiés et résolutions

6.8 Application Web non supprimée du serveur

Si les commandes undeploy ou undeployall de WDeploy n'ont pas permis de supprimer une application Web, utilisez la console d'administration pour arrêter toutes les applications Web et redémarrer le serveur, puis réexécutez la commande undeploy ou undeployall.

6.9 Lancement de l'interface graphique utilisateur de

WDeploy sur des serveurs Red Hat Linux Enterprise

Le démarrage de l'interface graphique utilisateur de WDeploy sur des serveurs Red Hat Linux Enterprise 5.1. ou

Red Hat Linux Advanced Server 5.x lorsque que SE Linux est activé peut entraîner le message d'erreur suivant :

Can't load 'perl/lib/site_perl/auto/XML/LibXML/Common/Common.so' for module

XML::LibXML::Common:

[...]/perl/extlibs/libz.so.1: cannot restore segment prot after reloc

Pour résoudre ce problème, désactivez SE Linux :

1. Exécutez /usr/sbin/setenforce 0 avec les privilèges racine.

Par exemple : sudo /usr/bin/setenforce 0

2. Mettez à jour le fichier de configuration /etc/sysconfig/selinux afin que le paramètre SELINUX soit défini sur désactivé.

Par exemple :

SELINUX=disabled

3. Redémarrez le système.

L'interface graphique utilisateur de WDeploy peut à présent démarrer normalement.

6.10 Copier MobileOTA14.properties après une installation de niveau Web

Si vous avez l'intention d'utiliser la prise en charge Mobile de la plateforme de BI et que vous avez effectué une installation de niveau Web, vous devez copier le fichier MobileOTA14.properties sur l'hôte qui a reçu l'installation de niveau Web (le serveur d'applications Web, très probablement).

Pour copier MobileOTA14.properties sur l'hôte qui a reçu l'installation de niveau Web, suivez la procédure cidessous.

1. Cherchez MobileOTA14.properties sur un hôte ayant reçu une installation

Complète

ou

Personnalisée/

Etendue

de la plateforme de BI.

Guide de déploiement d'applications Web

Problèmes identifiés et résolutions

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

93

Le fichier MobileOTA14.propertiesse trouve à l'emplacement suivant :

<REP_INSTALL_PBI>

/enterprise_xi40/wdeploy/conf/apps

2. Copiez MobileOTA14.properties sur le chemin correspondant sur l'hôte qui a reçu l'installation de niveau

Web.

6.11 Bouton Annuler de l'outil d'interface graphique utilisateur de WDeploy

Il se peut que le fait d'appuyer sur le bouton Annuler de WDeploy au cours du développement d'applications Web sur un serveur d'applications Web ne supprime pas les applications Web ou les fichiers de prise en charge qui ont déjà été copiés sur le serveur d'applications Web.

Pour résoudre ce problème, annulez manuellement le déploiement ou supprimez les fichiers sur le serveur d'applications Web. Avec certains serveurs d'applications Web, le bouton Annuler peut être désactivé. Il s'agit d'une limitation connue du JDK utilisé pour le déploiement.

6.12 JBoss

6.12.1 Exception de sécurité lors du déploiement d'AdminTools, dswsbobje ou BusinessProcessBI sur JBoss 7.1

Lors du déploiement des applications Web AdminTools, dswsbobje ou BusinessProcessBI sur JBoss 7.1, il se peut que vous rencontriez les erreurs suivantes : java.lang.SecurityException: Toolkit not encapsulated by a jar.

Cette erreur est renvoyée par une bibliothèque RSA. Pour résoudre ce problème, vous devez modifier les fichiers source de l'application Web et votre serveur d'applications JBoss avant le prédéploiement et le déploiement de l'application Web. L'exemple suivant utilise l'application AdminTools. Suivez la même procédure pour les applications dswsbobje et BusinessProcessBI :

1. Copiez tous les fichiers du répertoire de module RSA WDeploy :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/rsa_module

2. Sur votre serveur d'applications JBoss, créez un répertoire rsa\main sous modules\com et collez tous les fichiers copiés à l'étape 1 :

<REP_INSTALL_JBOSS>

/modules/com/rsa/main

3. Déplacez le fichier jboss-deployment-structure.xml depuis :

<REP_INSTALL_JBOSS>

/modules/com/rsa/main et placez-le dans le répertoire de fichiers source AdminTools suivant :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/warfiles/webapps/AdminTools/WEB-INF

4. Supprimez les fichiers JAR RSA certjFIPS.jar, cryptojFIPS.jar et ssljFIPS.jar des fichiers source

AdminTools :

94

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

Guide de déploiement d'applications Web

Problèmes identifiés et résolutions

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/warfiles/webapps/AdminTools/WEB-INF/lib

5. Prédéployez l'application Web AdminTools modifiée à l'aide de l'outil WDeploy. Par exemple : wdeploy jboss7 predeploy -DAPP=AdminTools

6. Déployez le fichier WAR AdminTools modifié à l'aide de l'interface de ligne de commande JBoss. Pour des exemples d'utilisation de l'interface de ligne de commande, voir

Déploiement manuel de la console d'administration JBoss 7.1

[page 79].

6.13 SAP NetWeaver

6.13.1 Niveau de service, niveau de correctif et paramètres de noms affichés incorrects lors du déploiement de SAP

NetWeaver à l'aide de SUM

Lors du déploiement des applications Web de la plateforme de BI 4.0 Support Package 1 ou ultérieure sur votre serveur d'applications SAP NetWeaver à l'aide de SAP Software Update Manager (SUM), les paramètres servicelevel, patchlevel et scn peuvent afficher des valeurs erronées et doivent être corrigés. Pour résoudre ce problème, vérifiez que les paramètres du fichier SAP_metadata.Properties de chaque groupe d'applications Web sont définis sur les valeurs suivantes :

● Les paramètres servicelevel et patchlevel doivent correspondre à la version du Support Pack et du correctif que vous appliquez. Par exemple :

○ Pour le Support Package 1, définissez servicelevel sur 1 et patchlevel sur 0.

○ Pour le Support Package 2, correctif 1, définissez servicelevel sur 2 et patchlevel sur 1.

● Les paramètres scn et name doivent comporter des valeurs identiques. Par exemple, si la propriété name est définie sur la valeur BOEWEBAPPJAVA, la propriété scn doit aussi être définie sur BOEWEBAPPJAVA.

Les fichiers SAP_metadata.Properties des différents groupes d'applications Web se trouvent aux emplacements suivants :

● BOE.sca :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/SLDSupport/NWSLD/BOE

● dswsbobje.sca :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/SLDSupport/NWSLD/ dswsbobje

● BusinessProcessBI.sca (obsolète) :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/

SLDSupport/NWSLD/BusinessProcessBI

● MobileOTA14.sca :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/SLDSupport/

NWSLD/MobileOTA14

● OpenSearch.sca :

<REP_INSTALL_PBI>

/sap_bobj/enterprise_xi40/wdeploy/SLDSupport/NWSLD/

OpenSearch

Guide de déploiement d'applications Web

Problèmes identifiés et résolutions

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

95

6.13.2 L'outil WDeploy ne prend pas en charge le déploiement ou l'annulation du déploiement sur SAP NetWeaver

L'outil WDeploy ne prend pas en charge le déploiement ou l'annulation du déploiement sur SAP NetWeaver. Vous devez utiliser les commandes predeploy ou predeployall de l'outil WDeploy pour créer des fichiers SCA et déployer manuellement à l'aide de SAP Software Update Manager (SUM). Pour en savoir plus sur le déploiement manuel sur SAP NetWeaver, voir

Déploiement de SAP NetWeaver avec SAP Software Update Manager (SUM)

[page 81].

6.13.3 Configuration requise pour le déploiement de SAP

BusinessObjects Explorer sur SAP NetWeaver

Avant de déployer l'application Web de la plateforme de BI (explorer) sur SAP NetWeaver, vous devez attribuer

à la propriété disable.compression.filter la valeur true dans le fichier /WEB-INF/classes/ default.settings.properties. Par défaut, cette valeur est définie sur false. Modifiez default.settings.properties à partir de l'emplacement suivant :

●

<REP_INSTALL_BOE>

/sap_bobj/enterprise_xi40/warfiles/webapps/explorer/WEB-INF/ classes/

●

Remarque

L'outil WDeploy ne prend pas en charge le déploiement ou l'annulation du déploiement sur SAP NetWeaver.

Vous devez utiliser les commandes predeploy ou predeployall de l'outil WDeploy pour créer des fichiers

SCA et déployer manuellement à l'aide de SAP Software Update Manager (SUM). Pour des instructions détaillées sur la manière de réaliser un déploiement manuel sur SAP NetWeaver, voir

Déploiement de SAP

NetWeaver avec SAP Software Update Manager (SUM)

[page 81].

6.14 Tomcat

6.14.2 Annulation du déploiement d'applications Web Tomcat

à l'aide de WDeploy

La commande d'annulation de déploiement wdeploy d'un serveur d'applications Web peut générer une erreur si le serveur d'applications Web n'est pas fermé et toujours en cours d'utilisation. Pour contourner ce problème, fermez le serveur d'applications Tomcat avant d'exécuter la commande wdeploy.

96

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

Guide de déploiement d'applications Web

Problèmes identifiés et résolutions

6.14.3 Il se peut que Tomcat ne charge pas d'applications Web au démarrage après l'exécution de WDeploy

Il se peut que les applications Web récemment déployées sur Tomcat à l'aide de l'outil WDeploy ne se chargent pas au démarrage si un chemin de contexte autre que celui par défaut est utilisé. Redémarrez Tomcat pour que les modifications s'appliquent.

6.15 WebLogic

6.15.1 Suppression du déploiement de services Web dans

WebLogic

Il se peut que l'utilisation des commandes wdeploy undeploy ou wdeploy undeployall ne supprime pas les applications Web de services Web BusinessProcessBI et dswsbobje d'un serveur d'applications Web

WebLogic 10.3.x.

Pour résoudre ce problème, arrêtez les applications Web BusinessProcessBI et dswsbobje à l'aide de la console d'administration, puis redémarrez le serveur d'applications Web. Une fois le serveur d'applications Web redémarré, utilisez les commandes wdeploy undeploy ou wdeploy undeployall pour supprimer les fichiers

BusinessProcessBI et dswsbobje.

6.16 WebSphere

6.16.1 Déploiement sur WebSphere en mode sécurisé

Une erreur de validation peut se produire lors de l'utilisation de WDeploy avec une installation WebSphere utilisant le cryptage Secure Sockets Layer (SSL). Pour résoudre ce problème, utilisez la commande wsadmin pour accepter manuellement le certificat SSL avant de tenter le déploiement à l'aide de WDeploy.

Par exemple, accédez au répertoire

<REP_INSTALL_WEBSPHERE>

/AppServer/bin et exécutez la commande suivante :

./wsadmin -conntype SOAP -port

<SOAP_admin_port>

-user

<as_admin_username>

password

<as_admin_password>

Remplacez

<SOAP_admin_port>

par le numéro de port utilisé par WebSphere (ex. 8880),

<as_admin_username>

par le nom d'utilisateur de votre compte administrateur (ex. admin) et

<as_admin_password>

par le mot de passe que vous avez spécifié pour

<as_admin_username>

.

Appuyez sur

Y

pour accepter le certificat, puis effectuez le déploiement de l'application Web en utilisant WDeploy.

Guide de déploiement d'applications Web

Problèmes identifiés et résolutions

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

97

6.16.2 Erreur de serveur interne survenue à la suite du déploiement des services Web sur WebSphere 7.0

Vous pouvez rencontrer une erreur de serveur interne après avoir déployé le fournisseur de services Web

(dswsbobje.war) sur WebSphere 7.0 avec le module de traitement de WS d'Axis2 activé. L'application de fournisseur de services Web (dswsbobje.war) est formée sur la structure de services Web d'Apache Axis2 qui contient ce module.

Pour résoudre ce problème, le module de traitement est désactivé dans l'installation par défaut de la plateforme de BI.

Si vous effectuez le déploiement sur un serveur d'applications Web autre que WebSphere 7.0 et souhaitez activer le module de traitement de WS d'Axis2, modifiez le fichier axis2.xml et retirez les commentaires de la ligne

<!--<module ref="addressing"/>-->. Le fichier axis2.xml se trouve sous /WEB-INF/conf dans le fichier

WAR de votre fournisseur de services Web. Redémarrez votre serveur d'applications Web pour que les modifications s'appliquent.

6.16.3 WASX7017E : exception lors du déploiement dans

WebSphere

Il se peut que vous receviez l'exception suivante lors de l'utilisation de WebSphere : com.ibm.websphere.management.exception.ConfigServiceException

com.ibm.websphere.management.exception.ConnectorException

org.apache.soap.SOAPException: [SOAPException: faultCode=SOAP-ENV:Client; msg=Read timed out; targetException=java.net.SocketTimeoutException: Read timed out]

Pour résoudre ce problème, essayez de modifier les valeurs de délai d'expiration aux emplacements suivants :

● Ouvrez le fichier soap.client.props et augmentez ou supprimez le délai d'expiration de la connexion

SOAP défini par la propriété : com.ibm.SOAP.requestTimeout=0 soap.client.props se trouve sous :

<REP_INSTALL_SAW>

/profiles/

<PROFIL>

/properties/soap.client.props

● Dans la console

Integrated Solutions Console

WebSphere, augmentez la valeur de la propriété requestTimeout sur le connecteur SOAP JMX pour le serveur d'applications :

98

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

Guide de déploiement d'applications Web

Problèmes identifiés et résolutions

Figure 1 : (Exemple en anglais)

Remarque

Accédez à la console WebSphere à l'adresse suivante : http://

<NOM_HOTE_WAS>

:

<PORT>

/ibm/ console. Le numéro de port par défaut est 9060.

Guide de déploiement d'applications Web

Problèmes identifiés et résolutions

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

99

www.sap.com/contactsap

©

2014 SAP AG ou société affiliée SAP. Tous droits réservés.

Toute reproduction ou communication de la présente publication, même partielle, par quelque procédé et à quelque fin que ce soit, est interdite sans l'autorisation expresse et préalable de SAP AG. Les informations contenues dans ce document peuvent être modifiées par SAP AG sans préavis.

Certains logiciels commercialisés par SAP AG et ses distributeurs contiennent des composants logiciels qui sont la propriété d'éditeurs tiers. Les spécifications des produits peuvent varier d’un pays à l’autre.

Elles sont fournies par SAP AG et ses filiales (« Groupe SAP ») uniquement à titre informatif, sans engagement ni garantie d'aucune sorte. Le Groupe SAP ne pourra en aucun cas être tenu responsable des erreurs ou omissions relatives à ces informations.

Les seules garanties fournies pour les produits et les services du

Groupe SAP sont celles énoncées expressément à titre de garantie accompagnant, le cas échéant, lesdits produits et services. Aucune des informations contenues dans ce document ne saurait constituer une garantie supplémentaire.

SAP et tous les autres produits et services SAP mentionnés dans ce document, ainsi que leurs logos respectifs, sont des marques commerciales ou des marques déposées de SAP AG en Allemagne ainsi que dans d'autres pays.

Pour plus d'informations sur les marques déposées, voir http:// www.sap.com/corporate-en/legal/copyright/index.epx

.