OSSTechドキュメント

Transcription

1 OSSTech 製 OpenLDAP 2.4 パッケージ インストールガイド オープンソース ソリューション テクノロジ ( 株 ) 作成日 : 2012 年 3 月 30 日 更新日 : 2017 年 9 月 8 日 リビジョン : 5.0

2 目次 1. はじめに 1 2. Linux 版 OpenLDAP 2.4 パッケージ システム要件 ソフトウェア要件 ハードウェア要件 パッケージ構成 RedHat Enterprise Linux 6 版パッケージのインストール 準備 依存パッケージ OS 標準の OpenLDAP パッケージとの競合によるサービス障害の防止策 パッケージのインストール RedHat Enterprise Linux 7 版パッケージのインストール 準備 依存パッケージ OS 標準の OpenLDAP パッケージとの競合によるサービス障害の防止策 パッケージのインストール OpenLDAP 2.4 パッケージのアップデート シングル構成時アップデート手順 マルチマスターアップデート手順 OpenLDAP 2.4 パッケージの各種設定情報 OpenLDAP サーバーの起動 停止 起動オプションの設定 syslog のファシリティを設定したい場合 LDAP サービスの URL を設定したい場合 ログ設定 syslog 設定 ログローテート設定 ログメッセージの Rate Limit 設定について LDAP データのバックアップとリストア LDAP データのバックアップ LDAP データベースファイルのリカバリー LDAP データのリストア データ複製による LDAP データのリストア バックアップファイルによる LDAP データのリストア OpenLDAP 以前のバージョンからのアップデートについて ( 全 OS 共通 ) 改版履歴 17 目次

3 1. はじめに 本ドキュメントは 弊社提供の OpenLDAP パッケージを導入するための手順書です OpenLDAP パッケージのインストールの際に 必ず本ドキュメントの内容を確認してから 作業を実施してください 本ドキュメントに関する記載内容について 疑問点等がある場合には 弊社サポート窓口までお問い合わせください 1. はじめに 1

4 2. Linux 版 OpenLDAP 2.4 パッケージ 2.1 システム要件 ソフトウェア要件 以下のいずれかの OS 環境が必要です RedHat Enterprise Linux 7 / CentOS 7 (x86-64) RedHat Enterprise Linux 6 / CentOS 6 (x86-64) ハードウェア要件 ソフトウェア要件に記載の OS が動作する以下のハードウェア環境が必要です CPU: Intel Pentium III 1GHz 以上あるいは互換 CPU メモリ : 512MB 以上 (1GB 以上推奨 LDAP エントリー数等に依存 ) ディスク ソフトウェア : /opt/osstech 1GB 以上 データ ログ : /var/opt/osstech 1GB 以上 ( 推奨 ) 2.2 パッケージ構成 弊社が提供する Linux 版ソフトウェアは以下のパッケージにより構成されています OSSTech ソフトウェア製品基本パッケージ osstech-base osstech-support osstech-daemontools OpenLDAP 2.4 パッケージ osstech-openldap osstech-openldap-clients osstech-openldap-servers osstech-openldap2.4-libs osstech-db4.8(rhel6) 2.Linux 版 OpenLDAP 2.4 パッケージ 2

5 osstech-db4.8-utils(rhel6) osstech-db5.3(rhel7) osstech-db5.3-utils(rhel7) 2.3 RedHat Enterprise Linux 6 版パッケージのインストール 準備 パッケージのインストールは root ユーザーのみに許可されていますので su コマンドで root ユーザーになります $ su - Password: root のパスワードを入力 ( 画面には表示されません ) 次に弊社から提供されたパッケージ一式をインストール先ホストの任意のディレクトリに展開します 下記の例では /srv/osstech/software/rpms に展開したことを前提として記述します 依存パッケージ 弊社提供の OpenLDAP2.4 で必要とされる OS 同梱パッケージは 以下となります ksh libtool-ltdl perl openssl ( バージョン 以上 ) OS 標準の OpenLDAP パッケージとの競合によるサービス障害の防止策 RedHat Enterprise Linux 6 で弊社提供の OpenLDAP 2.4 を利用する場合 OS 同梱の OpenLDAP 関連パッケージである openldap-servers がインストールされていると 利用ポートが重複し 弊社提供の OpenLDAP 2.4 が正常に動作しない可能性があります 既に OS 同梱の openldap-servers がインストールされている場合は openldap-servers をアンインストールしてください OS 同梱の openldap-servers パッケージがインストールされているか確認するためには 次のコマンドを実行します # rpm -q openldap-servers openldap-servers el6_7.x86_64 上記の実行例の結果では 問題の原因となる openldap-servers パッケージがインストールされている状態です ( バージョンは例となります バージョンが一致していなくても上記コマンドでパッケージ名が出力される場合 削除してください ) OS 同梱の openldap-servers パッケージがインストールされていた場合は 次のコマンドを実行してパッケージをアンインストールしてください # rpm -e openldap-servers OS 同梱の openldap-servers パッケージの削除を行った後に portreserve サービスを再起動する必要があります 以下のコマンドを実行してサービスを再起動してください # /sbin/service portreserve restart 2.Linux 版 OpenLDAP 2.4 パッケージ 3

6 OS 同梱の openldap-servers パッケージがインストールされていない環境では 引き続き openldap-servers パッケージをインストールしないようにしてください 弊社提供の OpenLDAP2.4 パッケージをご利用中の環境では OS 同梱の openldap-servers パッケージをインストールする必要はありません yum コマンドの実行時に openldap-servers パッケージがインストールされないようにするため 次の設定を追加してください /etc/yum.conf の [main] セクション内に以下の設定を追加します exclude=openldap-servers* パッケージのインストール 弊社提供の OpenLDAP 2.4 パッケージは /opt/osstech ディレクトリに新規インストールされます /srv/osstech/software/rpms/ に弊社提供のパッケージ一式がコピーされていることを確認します # cd /srv/osstech/software/rpms # ls install.sh x86_64 install.sh にて 必要な依存パッケージ 弊社パッケージがインストールされます ( 依存パッケージは yum リポジトリから取得します ) ただし アップデート対象のサーバーが yum コマンドでパッケージ取得ができない環境の場合 事前に OS メディア等で依存パッケージを入手し インストールしておいてください ) #./install.sh コマンドを実行すると Is this ok [y/n]: という出力があります ここで y<enter> を入力すると 依存パッケージも含めてパッケージ一式がインストールされます この install コマンドは yum に依存しています したがって これまで yum コマンドを実行したことがない場合はもう一度 Is this ok [y/n]: という出力があります 問いかけの意味については yum のマニュアルをご覧ください 以下の出力が得られれば完了です 完了しました!( もしくは Complete!) 以上で OpenLDAP 2.4 パッケージのインストールは完了です 2.4 RedHat Enterprise Linux 7 版パッケージのインストール 準備 パッケージのインストールは root ユーザーのみに許可されていますので su コマンドで root ユーザーになります $ su - Password: root のパスワードを入力 ( 画面には表示されません ) 次に弊社から提供されたパッケージ一式をインストール先ホストの任意のディレクトリに展開します 下記の例では /srv/osstech/software/rpms に展開したことを前提ととして記述します 依存パッケージ 弊社提供の OpenLDAP2.4 で必要とされる OS 同梱パッケージは 以下となります 2.Linux 版 OpenLDAP 2.4 パッケージ 4

7 ksh libtool-ltdl perl OS 標準の OpenLDAP パッケージとの競合によるサービス障害の防止策 RedHat Enterprise Linux 7 で弊社提供の OpenLDAP 2.4 を利用する場合 OS 同梱の OpenLDAP 関連パッケージである openldap-servers がインストールされていると 利用ポートが重複し 弊社提供の OpenLDAP 2.4 が正常に動作しない可能性があります 既に OS 同梱の openldap-servers がインストールされている場合は openldap-servers をアンインストールしてください OS 同梱の openldap-servers パッケージがインストールされているか確認するためには 次のコマンドを実行します # rpm -q openldap-servers openldap-servers el7_2.x86_64 上記の実行例の結果では 問題の原因となる openldap-servers パッケージがインストールされている状態です ( バージョンは例となります バージョンが一致していなくても上記コマンドでパッケージ名が出力される場合 削除してください ) OS 同梱の openldap-servers パッケージがインストールされていた場合は 次のコマンドを実行してパッケージをアンインストールしてください # rpm -e openldap-servers OS 同梱の openldap-servers パッケージがインストールされていない環境では 引き続き openldap-servers パッケージをインストールしないようにしてください 弊社提供の OpenLDAP2.4 パッケージをご利用中の環境では OS 同梱の openldap-servers パッケージをインストールする必要はありません yum コマンドの実行時に openldap-servers パッケージがインストールされないようにするため 次の設定を追加してください /etc/yum.conf の [main] セクション内に以下の設定を追加します exclude=openldap-servers* パッケージのインストール 弊社提供の OpenLDAP 2.4 パッケージは /opt/osstech ディレクトリに新規インストールされます /srv/osstech/software/rpms/ に弊社提供のパッケージ一式がコピーされていることを確認します # cd /srv/osstech/software/rpms # ls install.sh x86_64 install.sh にて 必要な依存パッケージ 弊社パッケージがインストールされます ( 依存パッケージは yum リポジトリから取得します ) ただし アップデート対象のサーバーが yum コマンドでパッケージ取得ができない環境の場合 事前に OS メディア等で依存パッケージを入手し インストールしておいてください ) #./install.sh コマンドを実行すると Is this ok [y/n]: という出力があります ここで y<enter> を入力すると 依存パッケージも含めてパッケージ一式がインストールされます この install コマンドは yum に依存しています したがって これまで yum コマンドを実行したことがない場合 2.Linux 版 OpenLDAP 2.4 パッケージ 5

8 はもう一度 Is this ok [y/n]: という出力があります 問いかけの意味については yum のマニュアルをご覧ください 以下の出力が得られれば完了です 完了しました!( もしくは Complete!) 以上で OpenLDAP 2.4 パッケージのインストールは完了です 2.5 OpenLDAP 2.4 パッケージのアップデート パッケージのアップデートは RedHat Enterprise Linux 5 RedHat Enterprise Linux 6 のみ確認事項があります それ以外は RedHat Enterprise Linux 5 RedHat Enterprise Linux 6 RedHat Enterprise Linux 7 全て同じ手順です アップデート作業は root ユーザーで行います $ su - Password: root のパスワードを入力 ( 画面には表示されません ) パッケージのアップデート前に OpenLDAP の各種設定ファイルをバックアップします cp コマンドなどを利用してファイルのバックアップを取得してください バックアップ対象ディレクトリ /opt/osstech/etc/openldap シングル構成時アップデート手順 ディレクトリに含まれるデーター OpenLDAP の設定ファイル スキーマファイルなど 設定ファイルのバックアップ取得後 シングル構成時の OpenLDAP 2.4 パッケージのアップデートは次の手順で行ってください OpenLDAP のサービスを停止します # /sbin/service osstech-ldap stop slapcat コマンドを利用して 登録されている LDAP エントリーの LDIF 形式のバックアップを取得します # /opt/osstech/sbin/slapcat -l ldap-backup.ldif 続いて osstech-openldap-servers-perl パッケージ ならびに osstech-openldap-devel パッケージがインストールされている環境か確認します (RedHat Enterprise Linux 5 もしくは 6 のみ該当 ) # rpm -q osstech-openldap-servers-perl osstech-openldap-servers-perl-2.4.xx-xx.el6.x86_64 # rpm -q osstech-openldap-devel osstech-openldap-devel-2.4.xx-xx.el6.x86_64 上記の実行例の結果では 両パッケージともインストールされている状態となります こちらは 次のコマンドを実行してパッケージをアンインストールしてください ( どちらか 1 パッケージのみの場合には インストールされているパッケージのみ指定して下記を実施します ) # rpm -e osstech-openldap-servers-perl osstech-openldap-devel 次に弊社提供のパッケージ一式をインストール先ホストの任意のディレクトリに展開します 下記の例では /srv/osstech/software/rpms に展開したことを前提とて記述します /srv/osstech/software/rpms に弊社提供の OpenLDAP 2.4 パッケージ一式があることを確認します # cd /srv/osstech/software/rpms # ls 2.Linux 版 OpenLDAP 2.4 パッケージ 6

9 install.sh x86_64 install.sh にて 弊社パッケージがアップデートされます また必要に応じて依存パッケージのインストールも実施します ( 依存パッケージは yum リポジトリから取得します ) ただし アップデート対象のサーバーが yum コマンドでパッケージ取得ができない環境の場合 事前に OS メディア等で依存パッケージを入手し インストールしておいてください ( 特に RedHat Enterprise Linux 6 がアップデート対象のサーバーの場合には OS にインストールされている OpenSSL パッケージのバージョンが 以上が必要ですので yum コマンドでのパッケージ入手ができない場合には事前にアップデートしておいてください ) #./install.sh コマンドを実行すると Is this ok [y/n]: という出力があります ここで y<enter> を入力すると 依存パッケージも含めてパッケージ一式がインストールされます この install コマンドは yum に依存しています したがって これまで yum コマンドを実行したことがない場合はもう一度 Is this ok [y/n]: という出力があります 問いかけの意味については yum のマニュアルをご覧ください 以下の出力が得られれば完了です 完了しました!( もしくは Complete!) 以上でアップデートは終了です マルチマスターアップデート手順 マルチマスター構成時の OpenLDAP 2.4 パッケージのアップデートは次の手順で行ってください 下記の例では LDAP1 号機を ldap1 LDAP2 号機を ldap2 という構成を前提として記述します ldap1 の OpenLDAP のサービスを停止します [ldap1]# /sbin/service osstech-ldap stop 続いて osstech-openldap-servers-perl パッケージ ならびに osstech-openldap-devel パッケージがインストールされている環境か確認します (RedHat Enterprise Linux 5 もしくは 6 のみ該当 ) # rpm -q osstech-openldap-servers-perl osstech-openldap-servers-perl-2.4.xx-xx.el6.x86_64 # rpm -q osstech-openldap-devel osstech-openldap-devel-2.4.xx-xx.el6.x86_64 上記の実行例の結果では 両パッケージともインストールされている状態となります こちらは 次のコマンドを実行してパッケージをアンインストールしてください ( どちらか 1 パッケージのみの場合には インストールされているパッケージのみ指定して下記を実施します ) # rpm -e osstech-openldap-servers-perl osstech-openldap-devel 次に弊社提供のパッケージ一式をインストール先ホストの任意のディレクトリに展開します 下記の例では /srv/osstech/software/rpms に展開したことを前提とて記述します /srv/osstech/software/rpms に弊社提供の OpenLDAP 2.4 パッケージ一式があることを確認します [ldap1]# cd /srv/osstech/software/rpms [ldap1]# ls install.sh x86_64 install.sh にて 弊社パッケージがアップデートされます また必要に応じて依存パッケージのインストールも実施します ( 依存パッケージは yum リポジトリから取得します ) ただし アップデート対象のサーバーが yum コマンドでパッケージ取得ができない環境の場合 事前に OS メ 2.Linux 版 OpenLDAP 2.4 パッケージ 7

10 ディア等で依存パッケージを入手し インストールしておいてください ( 特に RedHat Enterprise Linux 6 がアップデート対象のサーバーの場合には OS にインストールされている OpenSSL パッケージのバージョンが 以上が必要ですので yum コマンドでのパッケージ入手ができない場合には事前にアップデートしておいてください ) [ldap1]#./install.sh コマンドを実行すると Is this ok [y/n]: という出力があります ここで y<enter> を入力すると 依存パッケージも含めてパッケージ一式がインストールされます この install コマンドは yum に依存しています したがって これまで yum コマンドを実行したことがない場合はもう一度 Is this ok [y/n]: という出力があります 問いかけの意味については yum のマニュアルをご覧ください 以下の出力が得られれば完了です 完了しました!( もしくは Complete!) 片側 (ldap1) のアップデートの完了後 LDAP の同期確認を行います 両方のサーバーで contextcsn が同じ値になっている事を確認します [ldap1]# /opt/osstech/bin/ldapsearch -x -D < 管理者 DN> -W -b < ルートサフィックス > -s base contextcsn ContextCSN: Z#000000#001# [ldap2]# /opt/osstech/bin/ldapsearch -x -D < 管理者 DN> -W -b < ルートサフィックス > -s base contextcsn ContextCSN: Z#000000#001# 同期確認に問題なければ ldap2 の OpenLDAP のサービスを停止します [ldap2]# /sbin/service osstech-ldap stop 続いて osstech-openldap-servers-perl パッケージ ならびに osstech-openldap-devel パッケージがインストールされている環境か確認します (RedHat Enterprise Linux 5 もしくは 6 のみ該当 ) # rpm -q osstech-openldap-servers-perl osstech-openldap-servers-perl-2.4.xx-xx.el6.x86_64 # rpm -q osstech-openldap-devel osstech-openldap-devel-2.4.xx-xx.el6.x86_64 上記の実行例の結果では 両パッケージともインストールされている状態となります こちらは 次のコマンドを実行してパッケージをアンインストールしてください ( どちらか 1 パッケージのみの場合には インストールされているパッケージのみ指定して下記を実施します ) # rpm -e osstech-openldap-servers-perl osstech-openldap-devel 次に弊社提供のパッケージ一式をインストール先ホストの任意のディレクトリに展開します 下記の例では /srv/osstech/software/rpms に展開したことを前提とて記述します /srv/osstech/software/rpms に弊社提供の OpenLDAP 2.4 パッケージ一式があることを確認します [ldap2]# cd /srv/osstech/software/rpms [ldap2]# ls install.sh x86_64 install.sh にて 弊社パッケージがアップデートされます また必要に応じて依存パッケージのインストールも実施します ( 依存パッケージは yum リポジトリから取得します ) ただし アップデート対象のサーバーが yum コマンドでパッケージ取得ができない環境の場合 事前に OS メディア等で依存パッケージを入手し インストールしておいてください ( 特に RedHat Enterprise Linux 6 がアップデート対象のサーバーの場合には OS にインストールされている OpenSSL パッケージのバージョンが 以上が必要ですので yum コマンドでのパッケージ入手ができない場合には事前にアップデートしておいてください ) 2.Linux 版 OpenLDAP 2.4 パッケージ 8

11 [ldap2]#./install.sh コマンドを実行すると Is this ok [y/n]: という出力があります ここで y<enter> を入力すると 依存パッケージも含めてパッケージ一式がインストールされます この install コマンドは yum に依存しています したがって これまで yum コマンドを実行したことがない場合はもう一度 Is this ok [y/n]: という出力があります 問いかけの意味については yum のマニュアルをご覧ください 以下の出力が得られれば完了です 完了しました!( もしくは Complete!) アップデートの完了後 LDAP の同期確認を行います 再度両方のサーバーで contextcsn が同じ値になっている事を確認します [ldap1]# /opt/osstech/bin/ldapsearch -x -D < 管理者 DN> -W -b < ルートサフィックス > -s base contextcsn ContextCSN: Z#000000#001# [ldap2]# /opt/osstech/bin/ldapsearch -x -D < 管理者 DN> -W -b < ルートサフィックス > -s base contextcsn ContextCSN: Z#000000#001# 以上でアップデートは終了です 2.Linux 版 OpenLDAP 2.4 パッケージ 9

12 3. OpenLDAP 2.4 パッケージの各種設定情報 弊社製 OpenLDAP2.4 パッケージは /opt/osstech ディレクトリ以下にインストールされます LDAP デーモン 起動スクリプト 分類 LDAP クライアントユーティリティ 管理者用 LDAP ユーティリティ OpenLDAP 設定ファイル スキーマファイル LDAP データ格納ディレクトリ BDB ユーティリティ LDAP バックアップ設定 ログ設定 ログローテート設定 3.1 OpenLDAP サーバーの起動 停止 /opt/osstech/sbin/slapd /etc/init.d/osstech-ldap ファイル /opt/osstech/bin/ldapsearch /opt/osstech/bin/ldapadd など /opt/osstech/sbin/slapadd /opt/osstech/sbin/slapcat など /opt/osstech/etc/openldap/slapd.conf /opt/osstech/etc/openldap/ldap.conf など /opt/osstech/etc/openldap/schema 以下 /opt/osstech/var/lib/ldap /opt/osstech/sbin/slapd_db_recover など /opt/osstech/etc/openldap/slapdbbackup.conf /opt/osstech/etc/rsyslog.d/slapd.conf /opt/osstech/etc/logrotate.d/syslog 弊社提供の OpenLDAP 2.4 サーバーを起動する場合は 次のコマンドを実行します # /sbin/service osstech-ldap start もしくは # /opt/osstech/sbin/service osstech-ldap start 弊社提供の OpenLDAP 2.4 サーバーを停止する場合は 次のコマンドを実行します # /sbin/service osstech-ldap stop もしくは # /opt/osstech/sbin/service osstech-ldap stop 弊社提供の OpenLDAP 2.4 サーバーを再起動する場合は 次のコマンドを実行します # /sbin/service osstech-ldap restart もしくは # /opt/osstech/sbin/service osstech-ldap restart 3.2 起動オプションの設定 slapd を起動する際にオプションを指定したい場合は 次の各設定を行った後に osstech-ldap を再起動してください syslog のファシリティを設定したい場合 syslog のファシリティを設定したい場合は /opt/osstech/var/lib/sv/slapd/env/ SYSLOGFACILITY ファイルに syslog の -l オプションに渡したい文字列を設定します # echo LOCAL5 > /opt/osstech/var/lib/sv/slapd/env/syslogfacility 3.OpenLDAP 2.4 パッケージの各種設定情報 10

13 3.2.2 LDAP サービスの URL を設定したい場合 LDAP サービスの URL を設定したい場合は /opt/osstech/var/lib/sv/slapd/env/services ファイルに slapd コマンドの -h オプションに渡したい文字列を設定します # echo ldap:// / ldaps:// / > /opt/osstech/var/lib/sv/slapd/env/services SERVICES ファイルに何も設定されていないデフォルト状態の場合 LDAP サーバーのサービス URL として次の URL が設定されます ldapi:/// ldap:/// ldaps:/// 3.3 ログ設定 syslog 設定 OpenLDAP 2.4 は slapd.conf の loglevel パラメーターに基づき ログメッセージを syslog 経由で出力します ログファイルの出力先は /opt/osstech/etc/rsyslog.d/slapd.conf に設定されています if $programname == 'slapd' then \ -/opt/osstech/var/log/syslog/ldap.log & stop ログファイルの保存先を変更した場合は rsyslogd を再起動してください ログローテート設定 LDAP のログファイルのログローテート設定は osstech-base パッケージが提供する /opt/osstech/etc/logrotate.d/syslog ファイルにより行われています デフォルト設定は 次の通りです 項目ログの保存数ローテートのタイミング デフォルト値 100 世代 毎日 ログメッセージの Rate Limit 設定について rsyslogd および journald(rhel7 以降 ) では 一定時間内に大量のログメッセージが記録された場合 ログ出力を省略する Rate Limit 設定が行われています LDAP サーバーでは 多数のクライアントからのアクセスによって 認証や検索時に大量のログが記録される場合がありますので ログメッセージの欠落を防ぐため Rate Limit 設定を無効化しておくことをおすすめします rsyslog の Rate Limit 設定について 弊社提供の OpenLDAP パッケージを導入した場合 osstech-base パッケージに含まれる /etc/rsyslog.d/osstech.conf ファイルに rsyslogd の Rate Limit を無効化する設定が含まれています 3.OpenLDAP 2.4 パッケージの各種設定情報 11

14 /etc/rsyslog.d/osstech.conf ファイル (RHEL7 以降 ) $SystemLogRateLimitInterval 0 $imjournalratelimitinterval 0 osstech-base 以降で有効です /etc/rsyslog.d/osstech.conf ファイル (RHEL6) $SystemLogRateLimitInterval 0 journald の Rate Limit 設定について (RHEL7 以降 ) 弊社提供の OpenLDAP パッケージを導入した場合 osstech-base パッケージに含まれる /etc/systemd/journald.conf.d/osstech.conf ファイルに journald の Rate Limit を無効化する設定が含まれています /etc/systemd/journald.conf.d/osstech.conf ファイル [Journal] RateLimitInterval=0 3.OpenLDAP 2.4 パッケージの各種設定情報 12

15 4. LDAP データのバックアップとリストア 4.1 LDAP データのバックアップ LDAP データのバックアップは製品パッケージに含まれるバックアップスクリプトで自動的に取得されます 項目 バックアップ対象 バックアップファイルの保存先 バックアップファイル名 保存ファイル数 バックアップ取得タイミング cron の設定ファイル 設定内容 LDAP サーバーの DIT に登録されている全データ /opt/osstech/var/backup/ldap dc=example,dc=jp.ldif.gz (slapd.conf で設定されている suffix に基づきます ) 30 世代 cron により 毎朝 5 時 30 分に取得 /opt/osstech/etc/cron.d/slapdbbackup バックアップの頻度や保存先を変更したい場合は 設定ファイル (/opt/osstech/etc/openldap/slapdbbackup.conf) を変更してください backup_dir="/opt/osstech/var/backup/ldap" backup_maxage="30" バックアップ取得時間を変更したい場合は cron の設定ファイル (/opt/osstech/etc/cron.d/slapdbbackup) を変更して下さい SHELL=/bin/sh 30 5 * * * ldap test -x /opt/osstech/sbin/slapdbbackup && /opt/osstech/sbin/slapdbbackup LDAP の設定ファイル (/opt/osstech/etc/openldap 配下 ) などはバックアップ対象に含まれてませんので 必要に応じてバックアップを行って下さい 4.2 LDAP データベースファイルのリカバリー OpenLDAP で以下のような症状が発生した場合 LDAP データベース (Berkley DB) に不整合が発生している可能性があります slapd が起動しない LDAP 検索が実行できない このような状況になった場合は 以下の手順でデータベースのリカバリーを試みます なお マルチマスター構成の場合 両サーバーとも手順は同じです まず データベースファイルの整合性を確認します # /opt/osstech/sbin/slapd_db_verify /opt/osstech/var/lib/ldap/*.bdb 4.LDAP データのバックアップとリストア 13

16 エラーメッセージが表示された場合は 以下の手順でデータベースリカバリーを行います # /opt/osstech/sbin/slapd_db_recover -v -h /opt/osstech/var/lib/ldap インデックスを再構築します # /opt/osstech/sbin/slapindex -v LDAP データベースファイルの所有者とグループを ldap に変更します # chown -hr ldap:ldap /opt/osstech/var/lib/ldap OpenLDAP を起動します # /sbin/service osstech-ldap start OpenLDAP が起動し 各種 LDAP 操作コマンドが正常に実行できる場合はリカバリーに成功しています この手順を実施しても復旧不可能な場合は 次節の 4.3 LDAP データのリストア を実施してください 4.3 LDAP データのリストア OpenLDAP のデータは /opt/osstech/var/lib/ldap に db ファイルとして保存されています しかし 障害などによりデータファイルが破損することがあります データファイルが破損してしまった場合は以下の方法で復旧してください データ複製による LDAP データのリストア 2 台のマスターサーバーどちらかに障害が発生し 再度全ての LDAP データを複製させるには以下の手順を実施してください # /sbin/service osstech-ldap stop # cp -rp /opt/osstech/var/lib/ldap /opt/osstech/var/lib/ldap-`date +%Y%m%d` # rm -rf /opt/osstech/var/lib/ldap/* # /sbin/service osstech-ldap start 手順としては以上となります データが正常に複製されているかどうかは以下のコマンドでそれぞれの情報を取得しデータの比較をしてください # /opt/osstech/bin/ldapsearch -x -W -D "cn=master,dc=example,dc=jp" -h ldap01 > ldap01.ldif # /opt/osstech/bin/ldapsearch -x -W -D "cn=master,dc=example,dc=jp" -h ldap02 > ldap02.ldif # diff -u ldap01.ldif ldap02.ldif ldapsearch コマンドの -D オプション には LDAP 管理処理用エントリの DN を指定します パスワードを入力を求められるので -D オプションに指定した管理者アカウントのパスワードを 2 度入力します LDAP データが全て反映されるのには少々時間がかかる場合があります ( データ量によります ) バックアップファイルによる LDAP データのリストア マルチマスター構成の両方のサーバーに障害が発生しデータが復旧できない場合やシングル構成の場合には バックアップファイルによる復旧を行ないます まず最初に 両サーバーの LDAP サービスを停止します # /sbin/service osstech-ldap stop マスターサーバー 1 にて次の手順で LDAP データの復旧を行います 4.LDAP データのバックアップとリストア 14

17 念の為 現在の LDAP データを別ディレクトリに移動します # cp -rp /opt/osstech/var/lib/ldap /opt/osstech/var/lib/ldap-`date +%Y%m%d` # rm -rf /opt/osstech/var/lib/ldap/* 復旧に利用する LDIF ファイルは バックアップとして取得している LDIF ファイル (/opt/osstech/var/backup/ldap/dc=example,dc=jp.ldif.gz) を利用します なお バックアップされている LDIF は gzip 形式で圧縮されていますので 解凍後下記コマンドを実施してください # /opt/osstech/sbin/slapadd -vwl /opt/osstech/var/backup/ldap/dc=example,dc=jp.ldif # chown -hr ldap:ldap /opt/osstech/var/lib/ldap # /sbin/service osstech-ldap start 再構築し終わりましたら シングル構成のは場合は終了です マルチマスター構成の場合には マスターサーバー 2 を データ複製による LDAP データのリストア の手順に従い再構築を実施してください 4.LDAP データのバックアップとリストア 15

18 5. OpenLDAP 以前のバージョンからのアップデートについて ( 全 OS 共通 ) OpenLDAP より slapd.conf の serverid ディレクティブにて URL を指定した場合 OpenLDAP は serverid の URL と接続を待ち受ける URL とを比較し 不一致の場合は起動に失敗します ログには 以下のようなメッセージが出力されます Mar 28 11:45:23 host1 $OpenLDAP: slapd (Feb :48:58) $#012#011@build-sl6.lan.osstech.co.jp:/home/kamei/svn/product/openldap/rpm/openldap-2.4- head/build/build-sl6/openldap /build-servers/servers/slapd Mar 28 11:45:23 host1 slapd[8466]: read_config: no serverid / URL match found. Check slapd -h arguments. Mar 28 11:45:23 host1 slapd[8466]: slapd stopped. この場合 次のいずれかの対策を実施すると起動させることが可能です serverid の URL をサーバーの FQDN ホスト名に設定する 起動時のオプションで待ち受ける URL を指定する serverid 1 ldap://host1 と記載されている場合 //opt/osstech/etc/svscan/slapd/env/services に以下を記載 (ldaps で待ち受ける場合は括弧内も記載 ) ldap://ldap1/ ldap: / (ldaps://ldap1/ ldaps:// /) 5.OpenLDAP 以前のバージョンからのアップデートについて ( 全 OS 共通 ) 16

19 6. 改版履歴 リビジョン 2.0 slapd 起動時のオプションの設定方法について記載 リビジョン 3.0 Solaris 版パッケージのインストール手順について記載 パッケージのアップデート方法について記載 リビジョン 4.0 構成パッケージの更新 依存パッケージについて記載 リビジョン 4.1 OpenLDAP へのアップデートに関する注意点を記載 リビジョン 4.2 RedHat Enterprise Linux 6 版パッケージの依存パッケージ欄を更新 サービス操作時の表記ゆれを修正 リビジョン 4.3 RedHat Enterprise Linux 6 版における競合パッケージに関する説明を追記 リビジョン 4.4 起動コマンドを Solaris, AIX にも対応するよう変更 リビジョン 4.5 RedHat Enterprise Linux 7 版パッケージの追記 リビジョン 4.6 openssl パッケージが必要な旨を追記 リビジョン 4.7 パッケージ構成の変更による修正 リビジョン 4.8 LDAP データのバックアップ リストアについて追記 6. 改版履歴 17

20 ログファイルの扱いについて追記 リビジョン 4.9 誤字修正 リカバリ時の手順変更 リビジョン 5.0 リカバリ時の手順変更もれ 6. 改版履歴 18