Vous pouvez déployer les applications Web Rational Publishing Engine
(rpeng.war et dgaas.war) sur
un serveur Apache Tomcat avec Derby.
Avant de commencer
Vous devez installer Apache Tomcat version 7.0.x ou version 8.0.x et
Rational Publishing Engine à l'aide de la fonction Services distants RPE avant de déployer l'application Web.
Vous devez avoir accès aux applications Web suivantes qui sont disponibles dans le répertoire
RPE_HOME\remote-services :
Procédure
- Préparez votre serveur d'applications Apache Tomcat :
- Sur le serveur d'applications Tomcat, définissez la variable système TELELOGIC_LICENSE_FILE
à numéro_port@nom_hôte. Par
exemple, 19353@serveurlic1. Pour plus d'informations, voir la rubrique
Vérification de la variable d'environnement TELELOGIC_LICENSE_FILE.
- Augmentez la taille de fichier et la taille de demande maximales :
Pour Tomcat 7 :
- Ouvrez le fichier web.xml de l'application du gestionnaire Tomcat,
par exemple, RépInstallTomcat/webapps/manager/WEB-INF/web.xml.
- Recherchez la section suivante :
<multipart-config>
<!-- 50 MB max -->
<max-file-size>52428800</max-file-size>
<max-request-size>52428800</max-request-size>
<file-size-threshold>0</file-size-threshold>
</multipart-config>
- Modifiez cette section pour augmenter la capacité :
<multipart-config>
<!-- 70 MB max -->
<max-file-size>73400320</max-file-size>
<max-request-size>73400320</max-request-size>
<file-size-threshold>0</file-size-threshold>
</multipart-config>
- Sauvegardez et fermez le fichier web.xml.
Pour Tomcat 8 :
- Arrêtez votre serveur d'applications Apache Tomcat.
- Supprimez le répertoire dgaas et le fichier dgaas.war dans le répertoire
TOMCAT_HOME\webapps, s'ils existent déjà.
- Copiez le fichier dgaas.war dans le répertoire
TOMCAT_HOME\webapps.
- Démarrez le serveur d'applications Apache Tomcat :

- Si vous exécutez Apache Tomcat en tant que service Windows,
pour démarrer le serveur, à partir du répertoire rép_install_Tomcat/bin,
exécutez la commande suivante (pour Apache Tomcat version 7.0.x, utilisez à la place
Tomcat7.exe) :
Tomcat8.exe start
Pour arrêter le serveur, à partir du répertoire
rép_install_Tomcat/bin,
exécutez la commande suivante (pour Apache Tomcat version 7.0.x, utilisez à la place
Tomcat7.exe) :
Tomcat8.exe stop
- Si vous n'exécutez pas Apache Tomcat en tant que service Windows,
pour démarrer le serveur, à partir du répertoire rép_install_Tomcat/bin,
exécutez la commande suivante :
startup.bat
Conseil : Une fenêtre console Apache Tomcat distincte s'ouvre. Ne la fermez pas ou le serveur cessera de fonctionner. Vous devez patienter pendant le démarrage du serveur Tomcat. Une fois le serveur démarré, le temps de démarrage s'affiche en millisecondes dans la fenêtre Tomcat. Par exemple, Server startup in 25731
ms.
Pour arrêter le serveur, à partir du répertoire
rép_install_Tomcat/bin,
exécutez la commande suivante :
shutdown.bat

- Pour démarrer le serveur, à partir du répertoire rép_install_Tomcat/bin,
exécutez la commande suivante :
startup.sh
Pour arrêter le serveur, à partir du répertoire
rép_install_Tomcat/bin,
exécutez la commande suivante :
shutdown.sh
- Sélectionnez l'une des options suivantes pour déployer l'application Web :
- Si vous souhaitez déployer l'application Web à l'aide d'une interface utilisateur graphique, passez à
l'étape suivante pour en savoir plus sur le déploiement à l'aide de l'interface Apache Tomcat Manager.
- Si vous souhaitez déployer l'application Web à l'aide du système de fichiers, copiez les fichiers rpeng.war
et dgaas.war du répertoire RPE_HOME\remote-services dans le répertoire Tomcat
webapps. Par exemple, rép_install_Tomcat\webapps. Passez ensuite à la section
Résultats et Que faire ensuite de cette rubrique.
- Ouvrez Apache Tomcat Manager dans un navigateur à l'adresse
http://server:port/manager/html
Exemple :
http://hôte_local:8080/manager/htmlConseil : Une fenêtre s'ouvre, vous demandant de saisir un nom d'utilisateur et un mot de passe d'authentification de l'application Tomcat Manager. Vous devez ajouter un rôle
manager-gui dans le fichier
rép_install_Tomcat/conf/tomcat-user.xml, où
rép_install_Tomcat désignele répertoire d'installation du serveur Apache Tomcat. L'exemple suivant ajoute un rôle
manager-gui avec
mon_nom_utilisateur pour le nom d'utilisateur et
mon_motdepasse pour le mot de passe :
<user username="mon_nom_utilisateur" password="mon_motdepasse" roles="manager-gui"/>
- Déployez à la fois les applications rpeng.war et dgaas.war
sur Apache Tomcat.
- Dans la section Deploy, entrez les détails relatifs au fichier rpeng.war, puis cliquez sur
Deploy :
- Si le fichier WAR se trouve sur un
serveur autre qu'Apache Tomcat, entrez les informations suivantes dans la section
Deploy directory or WAR file located on server :
- Context Path : Entrez /rpeng comme nom de l'application
Web Rational Publishing Engine. Cette entrée fait partie de l'URL utilisée pour configurer le client.
- XML Configuration file URL : Non requis.
- WAR or Directory URL : Chemin d'accès au fichier rpeng.war. Exemple : RPE_HOME\remote-services\rpeng.war
- Si le fichier .war se trouve sur le
même serveur qu'Apache Tomcat, entrez les informations suivantes dans la section
WAR file to deploy :
- Select WAR to upload : Chemin d'accès au fichier rpeng.war. Exemple : RPE_HOME\remote-services\rpeng.war
- Dans la section Deploy, entrez les détails du fichier dgaas.war, puis cliquez sur Deploy :
- Si le fichier .war se trouve sur un
serveur autre qu'Apache Tomcat, entrez les informations suivantes dans la section
Deploy directory or WAR file located on server :
- Context Path : Entrez /dgaas comme nom de l'application
Web Rational Publishing Engine. Cette entrée fait partie de l'URL utilisée pour configurer le client.
- XML Configuration file URL : Non requis.
- WAR or Directory URL : Chemin d'accès au fichier dgaas.war. Exemple : RPE_HOME\remote-services\dgaas.war
- Si le fichier .war se trouve sur le
même serveur qu'Apache Tomcat, entrez les informations suivantes dans la section
WAR file to deploy :
- Select WAR to upload : Chemin d'accès au fichier dgaas.war.
Exemple : RPE_HOME\remote-services\dgaas.war
Résultats
Vous pouvez vérifier que l'application Web est déployée en ouvrant la page d'introduction de l'application Web
Rational Publishing Engine dans un navigateur à l'adresse : http://serveur:port/rpeng/.
Important : Par défaut, l'application rpeng.war recherche l'application dgaas.war sur le même serveur, sous le chemin de contexte /dgaas. Si vous déployez l'application
dgaas.war sur un autre serveur ou sous un autre chemin de contexte,
vous devez configurer la variable d'environnement d'exécution DGAAS_URL
dans l'application rpeng.war.
Pour configurer la variable d'environnement
d'exécution
DGAAS_URL :
- Vous devez vous connecter à l'application Web, http://serveur:port/rpeng/,
sous un nom utilisateur qui dispose de droits d'accès administrateur (rpe_admin). Pour plus d'informations sur la manière de configurer un utilisateur avec le rôle utilisateur rpe_admin, voir la rubrique Configuration d'utilisateurs pour l'application Web sur Apache Tomcat.
- Dans la barre d'outils utilisateur de l'application Web, sélectionnez Administrer. L'option de menu Administrer est disponible pour les utilisateurs qui disposent du rôle
rpe_admin.
- Sélectionnez Variables d'exécution.
- Affectez à la variable d'environnement d'exécution DGAAS_URL une valeur
d'URL, par exemple, http://serveur:port/dgaas.
Que faire ensuite
Au besoin, vous pouvez déployer et exécuter le modèle d'application Newskeeper qui
utilise la technologie du service de génération de document
pour générer des documents et qui fournit une interface de stockage pour les actifs et les documents de ce service. Pour plus de détails, voir
Exécution du modèle Newskeeper.
Configurez l'application Web
Rational Publishing Engine indiquée dans la page
http://serveur:port/rpeng/. Pour une explication sur la manière dont chaque URL est utilisée et sur les tâches de
configuration de chacune des fonctions, voir
Adresses URL de l'application Web.