Shibboleth-IdP冗長化環境構築手順書（Terracotta編）

2011年12月26日
金沢大学

• 目次 -
  1. はじめに \
  1.1. 本章の目的 \
  1.2. 前提条件 \
  2. Terracottaの構築 \
  2.1. ファイヤーウォールを解放する。 \
  2.2. Terracotttaの設定ファイルの編集 \
  2.3. Terracottaのインストール \
  2.4. Terracottaクライアントの設定 \
  3. 起動・停止 \
  3.1. Terrracottaサーバ、クライアントの起動順 \
  3.2. Terracottaサーバの起動／停止 \
  3.3. tomcat （Terracottaクライアント）の起動／停止 \

はじめに

本章の目的

本書は、JavaクラスタリングソフトウェアであるTerracottaを使用したShibboleth-IdPの冗長化環境の構築手順書です。
本書にて、TerracottaのインストールとShibboleth-IdPとの連携ができることを目的とします。

前提条件

Terracottaを使ったShibboleth-IdP冗長化環境を構築するにあたり、下記を前提条件とします。
前提条件

• Shibboleth-IdPがインストールされ、認証ができる状態とします。
• OSはCentOS(64bit)を前提とします。
• Terracottaをインストールするサーバは2台とします。
• 本書は下記のソフトウェアを使用して記述します。

Terracottaの構築

Terracottaを構築する全てのサーバで実施します。

ファイヤーウォールを解放する。

Terracottaは3つのポートを使用します。
ClientからServerへのポート　（デフォルトは 9510）
ServerからServerへのポート　（デフォルトは 9530）
JMXを利用する場合のポート　（デフォルトは 9520。本マニュアルでは利用しません。）

Terracotttaの設定ファイルの編集

• 下記URLからtc-config.xml をダウンロードします。

https://wiki.shibboleth.net/confluence/download/attachments/4358352/tc-config.xml

• /opt/shibboleth-idp/conf/tc-config.xmlの設定

赤の太字が追加、又は変更となる箇所となります。

• XXX.XXX.XXX.XXX および YYY.YYY.YYY.YYY はTerracotta を構築したサーバのIPアドレスです。

Terracottaのインストール

• 下記URLからterracotta-3.6.0.tar.gzをダウンロードします。

http://www.terracotta.org/http://terracotta.org/downloads/open-source/destination?name=terracotta-3.6.0.tar.gz&bucket=tcdistributions&file=terracotta-3.6.0.tar.gz

• Terracottaサーバにアップロードします。

  /opt/terracotta-3.6.0.tar.gz

  
  
• 下記手順で terracotta-3.6.0.tar.gz を解凍します。

  cd /opt

1. tar terracotta-3.6.0.tar.gz
   
   
2. sudo rm terracotta-3.6.0.tar.gz　　 ←解凍後、削除します。|
   

• 下記に合わせシンボリックリンクを張ります。

  cd /opt

1. ln -s terracotta-3.6.0 terracotta|
   

• Terracotta Integration Module (TIM)　 をインストールします。

  cd /opt/terracotta/bin

1. ./tim-get.sh install tim-vector 2.7.1
   
2. ./tim-get.sh install tim-tomcat-6.0 2.3.0|
   
   

   Terracottaクライアントの設定

• tomcatの起動ファイルにTerracottaクライアントの起動コマンドを追加します。

Terracotta クライアントは tomcat のサービスとして起動します。

• dso-boot-hotspot_linux_160_23.jarがterracottaクライアント起動時に最新化されるようにします。

  vi /opt/terracotta/platform/bin/make-boot-jar.sh

  
  

  exec "${JAVA_HOME}/bin/java" \ -Dtc.install-root="${TC_INSTALL_DIR}" \ -cp "${TC_INSTALL_DIR}/lib/tc.jar" \ com.tc.object.tools.BootJarTool make "$@" --w

  
  
  

  起動・停止

Terrracottaサーバ、クライアントの起動順

• 下記の順で起動してください。

  Terracotta サーバ

1. Terracotta　クライアント|
   
   

   Terracottaサーバの起動／停止

• 起動

  Terracottaサーバ　：　 idpNode1の場合

1. /opt/terracotta/bin/start-tc-server.sh -n idpNode1 -f /opt/shibboleth-idp/conf/tc-config.xml &
   
   Terracottaサーバ　：　 idpNode2の場合
   
2. /opt/terracotta/bin/start-tc-server.sh -n idpNode2 -f /opt/shibboleth-idp/conf/tc-config.xml &|
   Terracottaサーバがクラスタリングされている場合は先に起動したサーバがActiveとなります。
   

• 停止

  /opt/terracotta/bin/stop-tc-server.sh

  
  

  tomcat （Terracottaクライアント）の起動／停止

• 起動

  /etc/init.d/tomcat6 start

  
  
• 停止

  /etc/init.d/tomcat6 stop

  
  
  
  
  
  
  
  

以上。