Accéder au contenu principal Passer au contenu complémentaire
Ressources Qlik
Chargement de la recherche avec SearchUnify Si vous avez besoin d'aide avec votre produit, contactez le Support Qlik.
Qlik Customer Portal
Chargement de la recherche avec SearchUnify Si vous avez besoin d'aide avec votre produit, contactez le Support Qlik.
Qlik Customer Portal

Installer Syncope avec un Tomcat externe

Déployez Apache Syncope sur Apache Tomcat pour gérer les utilisateur.trices et les groupes dans Talend ESB.

Pourquoi et quand exécuter cette tâche

Installation de Syncope 4

Avant de commencer

Téléchargez et installez la version la plus récente de Tomcat, la version 10.x, à partir du site Web d'Apache Tomcat (uniquement en anglais) (en anglais).

Pourquoi et quand exécuter cette tâche

Suivez cette procédure lorsque vous utilisez Talend 8.0 R2026-06 ou des versions ultérieures.

Note InformationsConseil : Une installation basée sur Docker Compose est également disponible pour les configurations hors production. Consultez la documentation sur Apache Syncope Docker (uniquement en anglais) (en anglais).

Procédure

  1. Si Tomcat est en cours d'exécution, arrêtez-le.
  2. Activez Java 21.
  3. Dans apache-tomcat-xxx/bin, ouvrez ou créez un fichier setenv.sh et ajoutez ou modifiez la valeur de JAVA_OPTS comme suit : 
    JAVA_OPTS="-DCATALINA_HOME=$CATALINA_HOME -DCATALINA_BASE=$CATALINA_BASE"
  4. Téléchargez le pilote JDBC PostgreSQL (postgresql-xx.jar) auprès de PostgreSQL JDBC Driver (uniquement en anglais) et placez-le dans apache-tomcat-xxx/lib/ (en anglais).
  5. Démarrez une instance de PostgreSQL (exemple avec Docker) : 
    docker run --name syncope-db \
  -e POSTGRES_PASSWORD=syncope \
  -e POSTGRES_USER=syncope \
  -e POSTGRES_DB=syncope \
  -p 5432:5432 -d postgres
    Sinon, utilisez un serveur PostgreSQL existant et créez une base de données et un.e utilisateur.trice dédié.e.
  6. Construisez les fichiers WAR Syncope 4.1 à partir de l'archétype Maven, comme décrit dans la documentation sur Apache Syncope (uniquement en anglais) (en anglais). Les fichiers WAR requis sont les suivants : syncope.war, syncope-console.war, syncope-enduser.war.
  7. Décompressez syncope.war et ajoutez ce qui suit à WEB-INF/classes/core.properties : 
    keymaster.username=anonymous
keymaster.password=anonymousKey
keymaster.address=http://localhost:8080/syncope/rest/keymaster
  8. Décompressez syncope-console.war et ajoutez ce qui suit à WEB-INF/classes/console.properties : 
    keymaster.username=anonymous
keymaster.password=anonymousKey
keymaster.address=http://localhost:8080/syncope/rest/keymaster
  9. Copiez les répertoires syncope et syncope-console décompressés et syncope-enduser.war dans apache-tomcat-xxx/webapps/.
  10. Facultatif : Pour modifier le port par défaut, mettez la valeur du port du connecteur à jour dans apache-tomcat-xxx/conf/server.xml.
  11. Facultatif : Pour améliorer la sécurité, modifiez le mot de passe d'administrateur.trice par défaut en modifiant le paramètre adminPassword dans syncope/WEB-INF/classes/security.properties.
  12. Démarrez Tomcat.

Résultats

Vous pouvez à présent accéder à la console Apache Syncope.

Installation de Syncope 2

Availability-noteDéprécié·e
La procédure suivante explique comment installer Syncope 2 avec une instance Tomcat externe. Syncope 2 n'est plus packagé avec Talend ESB et est déprécié. Utilisez cette procédure uniquement si vous maintenez une installation Syncope 2 existante.

Avant de commencer

Téléchargez et installez la version la plus récente de Tomcat, la version 9.0.x, à partir du site Web d'Apache Tomcat (uniquement en anglais) (en anglais).

Pourquoi et quand exécuter cette tâche

Note InformationsRemarque : Suivez cette procédure lorsque vous utilisez Talend 8.0 R2026-05 ou des versions antérieures.

Procédure

  1. Si Tomcat est en cours d'exécution, arrêtez-le.
  2. Dans apache-tomcat-xxx/bin, ouvrez ou créez un fichier setenv.sh et ajoutez ou modifiez la valeur de JAVA_OPTS comme suit : 
    JAVA_OPTS="-DCATALINA_HOME=$CATALINA_HOME -DCATALINA_BASE=$CATALINA_BASE"
    Note InformationsRemarque : Apache Syncope supporte Java 21.

    Les variables d'environnement JAVA_HOME et JRE_HOME (selon la distribution de Java utilisée) ne sont pas strictement nécessaires, mais il est recommandé de les configurer.

  3. Allez dans Talend-ESB-V8.0.1.RXXXX-XX-RT/container/system/com/h2database/h2/2.2.220, copiez le fichier h2-2.2.220.jar et collez-le dans le dossier apache-tomcat-xxx/lib.
  4. Copiez les fichiers add-ons/syncope/ parmi les fichiers d'installation ESB et collez-les dans le dossier apache-tomcat-xxx/webapps des fichiers d'installation de votre Tomcat.
  5. Dézippez les fichiers suivants :
    • syncope-console.war
    • syncope-enduser.war

    Vous n'avez pas besoin de dézipper syncope.war et sts.war.

  6. Ouvrez les fichiers suivants et mettez à jour la valeur du port pour utiliser le port 9080 :
    • syncope-enduser/WEB-INF/classes/enduser.properties
    • syncope-console/WEB-INF/classes/console.properties
  7. Alignez la valeur du port pour Tomcat : dans le dossier apache-tomcat-xxx/conf, ouvrez le fichier server.xml et modifiez la valeur du port du connecteur à 9080.
  8. Facultatif : Pour améliorer la sécurité, modifiez les identifiants par défaut du compte d'utilisateur·trice Apache Syncope par défaut, en modifiant le paramètre adminPassword dans le fichier syncope/WEB-INF/classes/security.properties.
    Pour plus d'informations, consultez la documentation Apache Syncope (uniquement en anglais) (en anglais).
  9. Démarrez Tomcat.

Résultats

Vous pouvez accéder à la console Apache Syncope à l'aide de l'URL suivante : http://localhost:9080/syncope-console/.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.

Laissez vos commentaires ici