# Installer Syncope avec un Tomcat externe Disponible dans... * Data Fabric * Data Services Platform * ESB * Qlik Talend Cloud Enterprise Edition * Qlik Talend Cloud Premium Edition * Real-Time Big Data Platform 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 | Version | Version de Syncope | Version de Java | Version de Tomcat | | --- | --- | --- | --- | | Talend 8.0 R2026-05 et versions antérieures | Syncope 2 | Java 8 | Tomcat 9 | | Talend 8.0 R2026-06 et versions ultérieures | Syncope 4.1 | Java 21 | Tomcat 10 | ## Installation de Syncope 4 Disponible dans... * Data Fabric * Data Services Platform * ESB * Qlik Talend Cloud Enterprise Edition * Qlik Talend Cloud Premium Edition * Real-Time Big Data Platform ### 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](http://tomcat.apache.org/download-70.cgi) (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](https://syncope.apache.org/docs/getting-started.html#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 appelé 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](https://jdbc.postgresql.org/download/) (uniquement en anglais) et placez-le dans apache-tomcat-xxx/lib/. 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](https://syncope.apache.org/docs/getting-started.html#maven-project) (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 ``` La valeur keymaster.password doit correspondre au mot de passe que vous avez défini à l'étape 6. 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.rice 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-note[Déprécié·e](https://help.talend.com/r/en-US/Cloud/labels-on-talend-help-center/availability-deprecated) Ce contenu est obsolète. Disponible dans... * Data Fabric * Data Services Platform * ESB * Qlik Talend Cloud Enterprise Edition * Qlik Talend Cloud Premium Edition * Real-Time Big Data Platform 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](http://tomcat.apache.org/download-70.cgi) (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 appelé 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. La variable d'environnement JAVA\_HOME ou JRE\_HOME (selon la distribution de Java utilisée) n'est pas strictement nécessaire, mais il est recommandé de la 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/ figurant parmi les fichiers d'installation ESB et collez-les dans le dossier apache-tomcat-xxx/webapps 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 de Tomcat : dans le dossier apache-tomcat-xxx/conf, ouvrez le fichier server.xml et remplacez la valeur du port du connecteur par 9080. 8. Facultatif : Pour améliorer la sécurité, modifiez les identifiants par défaut du compte d'utilisateur.rice 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](https://syncope.apache.org/docs/reference-guide.html#set-admin-credentials) (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/.