# 外部Tomcatを使ってSyncopeをインストール

利用対象...

* Data Fabric
* Data Services Platform
* ESB
* Qlik Talend Cloud Enterprise Edition
* Qlik Talend Cloud Premium Edition
* Real-Time Big Data Platform

Talend ESBでユーザーおよびグループの管理するために、Apache Tomcat上にApache Syncopeをデプロイします。

## このタスクについて

| リリース | Syncopeバージョン | Javaバージョン | Tomcatバージョン |
| --- | --- | --- | --- |
| Talend 8.0 R2026-05以前 | Syncope 2 | Java 8 | Tomcat 9 |
| Talend 8.0 R2026-06以降 | Syncope 4.1 | Java 21 | Tomcat 10 |

## Syncope 4のインストール

利用対象...

* Data Fabric
* Data Services Platform
* ESB
* Qlik Talend Cloud Enterprise Edition
* Qlik Talend Cloud Premium Edition
* Real-Time Big Data Platform

### 始める前に

[Apache Tomcat](http://tomcat.apache.org/download-70.cgi) (英語のみ)のサイトから最新の10.x Tomcatリリースバージョンをダウンロードしてインストール済みであること。

### このタスクについて

Talend 8.0 R2026-06以降のバージョンを使用している場合は、この手順に従ってください。

情報メモヒント: 本番環境以外のセットアップ向けに、Docker Composeを使用したインストール方法も用意されています。[Apache Syncope Dockerのドキュメンテーション](https://syncope.apache.org/docs/getting-started.html#docker) (英語のみ)を参照してください。

### 手順

1. Tomcatが実行中であれば停止します。
2. Java 21を有効にします。
3. apache-tomcat-xxx/binで、setenv.shというファイルを開くか作成し、JAVA\_OPTSの値を次のように追加または変更します。
   ```
   JAVA_OPTS="-DCATALINA_HOME=$CATALINA_HOME -DCATALINA_BASE=$CATALINA_BASE"
   ```
4. [PostgreSQL JDBC Driver](https://jdbc.postgresql.org/download/) (英語のみ)からPostgreSQL JDBCドライバー(postgresql-xx.jar)をダウンロードし、apache-tomcat-xxx/lib/に配置します。
5. PostgreSQLインスタンスの起動(Dockerを使用する例):
   ```
   docker run --name syncope-db 
     -e POSTGRES_PASSWORD=syncope 
     -e POSTGRES_USER=syncope 
     -e POSTGRES_DB=syncope 
     -p 5432:5432 -d postgres
   ```

   あるいは、既存のPostgreSQLサーバーを使用し、専用のデータベースとユーザーを作成します。
6. [Apache Syncopeのドキュメント](https://syncope.apache.org/docs/getting-started.html#maven-project) (英語のみ)に記載されている手順に従い、MavenアーキタイプからSyncope 4.1のWARファイルをビルドします。必要なWARファイルは、syncope.war、syncope-console.war、syncope-enduser.warです。
7. syncope.warを展開し、WEB-INF/classes/core.propertiesに次を追記します。
   ```
   keymaster.username=anonymous
   keymaster.password=anonymousKey
   keymaster.address=http://localhost:8080/syncope/rest/keymaster
   ```

   keymaster.passwordの値は、ステップ6で設定したパスワードと一致している必要があります。
8. syncope-console.warを展開し、WEB-INF/classes/console.propertiesに次を追記します。
   ```
   keymaster.username=anonymous
   keymaster.password=anonymousKey
   keymaster.address=http://localhost:8080/syncope/rest/keymaster
   ```
9. 展開したsyncopeおよびsyncope-console ディレクトリーと、syncope-enduser.warを、apache-tomcat-xxx/webapps/にコピーします。
10. オプション:デフォルトのポートを変更するには、apache-tomcat-xxx/conf/server.xml内のコネクタポートの値を更新してください。
11. オプション:セキュリティを強化するには、syncope/WEB-INF/classes/security.properties内のadminPasswordパラメーターを編集して、デフォルトの管理者パスワードを変更してください。
12. Tomcatを起動します。

### タスクの結果

これで、Apache Syncope Consoleにアクセスできます。

## Syncope 2のインストール

Availability-note[非推奨](https://help.talend.com/r/en-US/Cloud/labels-on-talend-help-center/availability-deprecated)

このコンテンツは非推奨になりました。

利用対象...

* Data Fabric
* Data Services Platform
* ESB
* Qlik Talend Cloud Enterprise Edition
* Qlik Talend Cloud Premium Edition
* Real-Time Big Data Platform

次の手順では、外部のTomcatインスタンスを使用してSyncope 2をインストールする方法について説明します。Syncope 2はTalend ESBに含まれなくなり、非推奨となりました。この手順は、既存のSyncope 2インストールを保守する場合にのみ使用してください。

### 始める前に

[Apache Tomcat](http://tomcat.apache.org/download-70.cgi) (英語のみ)のサイトから最新の9.0.x Tomcatリリースバージョンをダウンロードしてインストール済みであること。

### このタスクについて

情報メモ注: Talend 8.0 R2026-05以前のバージョンを使用している場合は、この手順に従ってください。

### 手順

1. Tomcatが実行中であれば停止します。
2. apache-tomcat-xxx/binで、setenv.shというファイルを開くか作成し、JAVA\_OPTSの値を次のように追加または変更します。
   ```
   JAVA_OPTS="-DCATALINA_HOME=$CATALINA_HOME -DCATALINA_BASE=$CATALINA_BASE"
   ```

   情報メモ注: Apache SyncopeはJava 21をサポートしています。

   JAVA\_HOME環境変数またはJRE\_HOME環境変数(使用されるJavaディストリビューションによる)は、厳密には必須ではありませんが、設定することをお勧めします。
3. Talend-ESB-V8.0.1.RXXXX-XX-RT/container/system/com/h2database/h2/2.2.220に移動し、h2-2.2.220.jarファイルをコピーして、apache-tomcat-xxx/libフォルダーに貼り付けます。
4. ESBインストールファイルにあるadd-ons/syncope/ファイルをコピーし、Tomcatのapache-tomcat-xxx/webappsフォルダーに貼り付けます。
5. 次のファイルを解凍します:
   * syncope-console.war
   * syncope-enduser.war

   syncope.warおよびsts.warを解凍する必要はありません。
6. 次のファイルを開き、ポート値を9080にアップデートします:
   * syncope-enduser/WEB-INF/classes/enduser.properties
   * syncope-console/WEB-INF/classes/console.properties
7. Tomcatのポート値を一致させます。apache-tomcat-xxx/confフォルダーでserver.xmlを開き、コネクターポート値を9080に変更します。
8. オプション: セキュリティを向上させるためには、syncope/WEB-INF/classes/security.propertiesファイルにあるadminPasswordパラメーターを編集し、デフォルトのApache Syncopeユーザーアカウントの認証情報を変更します。

   詳細は、[Apache Syncopeのドキュメンテーション](https://syncope.apache.org/docs/reference-guide.html#set-admin-credentials) (英語のみ)をご覧ください。
9. Tomcatを起動します。

### タスクの結果

Apache Syncope Consoleには、http://localhost:9080/syncope-console/からアクセスできます。