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

最終更新日時: 2026/10/15

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のインストール

始める前に

Apache Tomcat (英語のみ)のサイトから最新の10.x Tomcatリリースバージョンをダウンロードしてインストール済みであること。

このタスクについて

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

ヒント: 本番環境以外のセットアップ向けに、Docker Composeを使用したインストール方法も用意されています。Apache Syncope Dockerのドキュメンテーション (英語のみ)を参照してください。

手順

Tomcatが実行中であれば停止します。
Java 21を有効にします。
apache-tomcat-xxx/binで、setenv.shというファイルを開くか作成し、JAVA_OPTSの値を次のように追加または変更します。
```
JAVA_OPTS="-DCATALINA_HOME=$CATALINA_HOME -DCATALINA_BASE=$CATALINA_BASE"
```
PostgreSQL JDBC Driver (英語のみ)からPostgreSQL JDBCドライバー(postgresql-xx.jar)をダウンロードし、apache-tomcat-xxx/lib/に配置します。
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サーバーを使用し、専用のデータベースとユーザーを作成します。
Apache Syncopeのドキュメント (英語のみ)に記載されている手順に従い、MavenアーキタイプからSyncope 4.1のWARファイルをビルドします。必要なWARファイルは、syncope.war、syncope-console.war、syncope-enduser.warです。
syncope.warを展開し、WEB-INF/classes/core.propertiesに次を追記します。
```
keymaster.username=anonymous
keymaster.password=anonymousKey
keymaster.address=http://localhost:8080/syncope/rest/keymaster
```
keymaster.passwordの値は、ステップ6で設定したパスワードと一致している必要があります。

syncope-console.warを展開し、WEB-INF/classes/console.propertiesに次を追記します。

keymaster.username=anonymous
keymaster.password=anonymousKey
keymaster.address=http://localhost:8080/syncope/rest/keymaster

展開したsyncopeおよびsyncope-console ディレクトリーと、syncope-enduser.warを、apache-tomcat-xxx/webapps/にコピーします。
オプション:デフォルトのポートを変更するには、apache-tomcat-xxx/conf/server.xml内のコネクタポートの値を更新してください。
オプション:セキュリティを強化するには、syncope/WEB-INF/classes/security.properties内のadminPasswordパラメーターを編集して、デフォルトの管理者パスワードを変更してください。
Tomcatを起動します。

タスクの結果

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

Syncope 2のインストール

非推奨

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

始める前に

Apache Tomcat (英語のみ)のサイトから最新の9.0.x Tomcatリリースバージョンをダウンロードしてインストール済みであること。

このタスクについて

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

手順

Tomcatが実行中であれば停止します。
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ディストリビューションによる)は、厳密には必須ではありませんが、設定することをお勧めします。
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フォルダーに貼り付けます。
ESBインストールファイルにあるadd-ons/syncope/ファイルをコピーし、Tomcatのapache-tomcat-xxx/webappsフォルダーに貼り付けます。
次のファイルを解凍します:
- syncope-console.war
- syncope-enduser.war
syncope.warおよびsts.warを解凍する必要はありません。
次のファイルを開き、ポート値を9080にアップデートします:
- syncope-enduser/WEB-INF/classes/enduser.properties
- syncope-console/WEB-INF/classes/console.properties
Tomcatのポート値を一致させます。apache-tomcat-xxx/confフォルダーでserver.xmlを開き、コネクターポート値を9080に変更します。
オプション: セキュリティを向上させるためには、syncope/WEB-INF/classes/security.propertiesファイルにあるadminPasswordパラメーターを編集し、デフォルトのApache Syncopeユーザーアカウントの認証情報を変更します。
詳細は、Apache Syncopeのドキュメンテーション (英語のみ)をご覧ください。
Tomcatを起動します。

タスクの結果

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

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。

こちらにフィードバックをお寄せください