Configuration des services distants sur Apache Tomcat

Pour configurer les utilisateurs et les options Java™ pour les services distants sur un serveur Apache Tomcat, utilisez la procédure ci-après.

Avant de commencer

Vous devez installer Apache Tomcat, Rational Publishing Engine et l'application Web Services, puis déployer cette dernière pour pouvoir configurer les utilisateurs et les options Java.

Configuration des utilisateurs et des rôles utilisateur

Pourquoi et quand exécuter cette tâche

Tableau 1. Rôles utilisateur des services distants
Rôle Fonctionnalités
Utilisateur de la génération de documents (rpe_docgen_user)
  • Peut générer des documents à distance ou en local à partir des applications client
  • Peut afficher les fichiers de sortie et les journaux sur leur travaux de génération de documents
Administrateur de la génération de documents (rpe_docgen_admin)
  • Peut générer des documents à distance ou en local à partir des applications client
  • Si utilisé avec le rôle rpe_monitor_admin, peut afficher les fichiers de sortie et les journaux à partir des travaux de génération de documents lancés par un utilisateur.
Utilisateur du composant Gestion centralisée (rpe_library_user)
  • Peut afficher les actifs dans l'application Document Studio
  • Peut utiliser les actifs publics pour concevoir des canevas
Contributeur du composant Gestion centralisée (rpe_library_contributor)
  • Peut afficher les actifs dans l'application Document Studio
  • Peut utiliser les actifs pour concevoir des canevas
  • Peut soumettre des actifs dans l'application Document Studio
  • Peut modifier ses actifs existants à partir de l'application Document Studio
Administrateur du composant Gestion centralisée (rpe_library_admin)
  • Peut afficher les actifs créés par tout utilisateur de l'application Document Studio
  • Peut utiliser les actifs créés par tout utilisateur pour concevoir des canevas
  • Peut soumettre des actifs dans l'application Document Studio
  • Peut modifier les actifs existants créés par tout utilisateur de l'application Document Studio
  • Peut créer des actifs dans l'interface d'administration du composant Gestion centralisée
  • Peut modifier les actifs existants créés par tout utilisateur à partir de l'interface d'administration du composant Gestion centralisée
  • Peut supprimer des actifs créés par tout utilisateur à partir de l'interface d'administration du composant Gestion centralisée
Utilisateur du composant Surveillance et contrôle (rpe_monitor_user)
  • Peut modifier l'état de ses travaux de génération de documents
  • Permet à ses travaux de génération de documents d'être surveillés par les utilisateurs possédant le rôle rpe_monitor_admin
Administrateur du composant Surveillance et contrôle (rpe_monitor_admin)
  • Si utilisé avec le rôle rpe_docgen_admin, peut afficher les fichiers de sortie et les journaux à partir des travaux de génération de documents lancés par un utilisateur.
  • Peut modifier le statut des travaux de génération de documents lancés par un utilisateur

Procédure

  1. Ouvrez Apache Tomcat Manager dans un navigateur : http://serveur:port/manager/html. Exemple : http://localhost:8080/manager/html.
  2. Arrêtez l'application Web Services déployée. Dans la section Applications, recherchez la ligne application rpews.war et cliquez sur Arrêter.
  3. Créez des utilisateurs et des rôles Apache Tomcat pour le composant Surveillance et contrôle.
    1. Ouvrez le fichier tomcat-users.xml, qui se trouve par défaut dans $CATALINA_HOME\conf\tomcat-users.xml.
    2. Ajoutez les rôles utilisateur, contributeur et administrateur pour les services que vous utilisez.
      Conseil :
      • Reportez-vous au tableau de la section A propos de cette tâche ci-dessous pour des descriptions de chaque rôle.
      • Pour une sécurité accrue, créez plusieurs utilisateurs client et n'octroyez qu'à un seul d'entre eux le rôle rpe_docgen_user. Les générations de documents créées par les utilisateurs peuvent contenir des données confidentielles. En créant deux types d'utilisateur, vous pouvez vous assurer que seuls les utilisateurs autorisés à consulter les sorties des résultats puissent les afficher.
      <role rolename="rpe_docgen_admin" />
      <role rolename="rpe_docgen_user" /> 
      <role rolename="rpe_library_user"/>
      <role rolename="rpe_library_contributor"/>
      <role rolename="rpe_library_admin"/>
      <role rolename="rpe_monitor_user"/>
      <role rolename="rpe_monitor_admin"/>
    3. Ajoutez au moins un administrateur et affectez-lui les rôles administrateur et utilisateur pour les services que vous utilisez. Exemple :
      <user username="admin_rpe" password="mot_de_passe" roles="rpe_docgen_admin,rpe_library_admin,rpe_monitor_admin"/>
    4. Ajoutez au moins un utilisateur client. Affectez-lui les rôles utilisateur des services que vous utilisez. Exemple :
      <user username="client_rpe" password="mot_de_passe" roles="rpe_docgen_user,rpe_library_user,rpe_monitor_user"/>
      <user username="contributeur_rpe" password="mot_de_passe" roles="rpe_docgen_user,rpe_library_contributor,rpe_monitor_user"/>
    5. Facultatif : Ajoutez d'autres utilisateurs client et contributeur. Exemple :
      <user username="utilisateur1" password="mot_de_passe" roles="rpe_docgen_user,rpe_library_contributor,rpe_monitor_user"/>
  4. Démarrez application Web Services. Dans la section Applications d'Apache Tomcat Manager, recherchez la ligne application rpews.war et cliquez sur Démarrer.

Facultatif : Configuration du composant Surveillance et contrôle sur un serveur différent de celui de la génération de documents à distance.

Le service de génération de documents utilise le composant Surveillance et contrôle déployé automatiquement avec lui. Pour utiliser le composant Surveillance et contrôle par défaut, aucune configuration supplémentaire n'est requise et vous pouvez passer à l'étape suivante. Pour utiliser un autre composant Surveillance et contrôle sur un autre serveur ou port que celui de la génération de documents, configurez ces indicateurs d'option Java pour configurer les données d'identification de connexion.

Procédure

  1. Arrêtez l'application Web Services déployée. Dans la section Applications, recherchez la ligne application rpews.war et cliquez sur Arrêter.
  2. Définissez les options Java :
    1. Dans les fichiers d'applications Apache Tomcat, cliquez à l'aide du bouton droit de la souris sur le fichier startup que vous utilisez pour démarrer le serveur.
    2. Cliquez sur Propriétés.
    3. Sélectionnez l'onglet Java.
    4. Dans la zone des options Java, entrez les options suivantes :
      -Dcom.ibm.rational.rpe.mc.url=http://serveur:port/rpews/monitor
      -Dcom.ibm.rational.rpe.mc.user=client_rpe
      -Dcom.ibm.rational.rpe.mc.password=mot_de_passe
    5. Cliquez sur OK.
  3. Démarrez application Web Services. Dans la section Applications d'Apache Tomcat Manager, recherchez la ligne application rpews.war et cliquez sur Démarrer.

Résultats

Une fois que vous avez terminé le déploiement, la console d'administration du composant Surveillance et contrôle est disponible à l'adresse suivante : http://serveur:port/rpews/ui/monitor. Pour plus d'informations sur l'utilisation de la console d'administration, voir Gestion des travaux de génération de documents dans le composant Surveillance et contrôle.

Que faire ensuite

Sur les ordinateurs des utilisateurs finaux, spécifiez l'URL du composant Surveillance et contrôle d'un serveur distant. Voir Définition des préférences des services distants.


Commentaires