1. サーバ構築のデージーネットTOP
2. OSS情報
3. デージーネットのOSS
4. DHCPadmin

• 4.1 postLDAPadminのインストール
• 4.2 postLDAPadminの設定
  • 4.2.1 web.confの作成
    • 4.2.1.1 tab.confの作成
    • 4.2.1.2 admin.keyの作成
    • 4.2.1.3 msg_fileの作成
  
  
• 4.3 DHCPサーバの基本設定
• 4.4 DHCPadminのインストール
  • 4.4.1 DHCPadminの入手と展開
  • 4.4.2 dhcpd.confとdhcpd6.confの移動
  • 4.4.3 ディレクトリの作成
  • 4.4.4 ディレクトリとファイルの権限変更
    • 4.4.4.1 ディレクトリの権限変更
    • 4.4.4.2 ファイルの権限変更
    • 4.4.4.3 SELinuxのポリシー作成
  • 4.4.5 web.confの設定
  • 4.4.6 タブファイル(tab.conf)の設定
  • 4.4.7 メッセージファイル(msg_file)の設定
  • 4.4.8 CSVファイル自動読み込み設定
  
  
• 4.5 Webサーバの設定
• 4.6 管理者の設定
• 4.7 DHCPサーバ(IPv4)の起動確認
  • 4.7.1 ログイン
  • 4.7.2 サブネットの登録
  • 4.7.3 DHCPサーバの起動
  
  
• 4.8 DHCPサーバ(IPv6)の起動確認
  • 4.8.1 ログイン
  • 4.8.2 IPv6サブネットの登録
  • 4.8.3 DHCPv6サーバの起動

4. 設定

4.1 postLDAPadminのインストール

https://github.com/designet-inc-oss/DHCPadmin

以下のファイルをダウンロードしてください。

postLDAPadmin_frame-VERSION.tar.gz
postLDAPadmin_admin-VERSION.tar.gz
postLDAPadmin_lib-VERSION.tar.gz

postLDAPadminのインストール実行例

# tar xzf postLDAPadmin_frame-VERSION.tar.gz -C /usr/local
# tar xzf postLDAPadmin_admin-VERSION.tar.gz -C /usr/local/postldapadmin/htdocs/admin
# tar xzf postLDAPadmin_lib-VERSION.tar.gz -C /usr/local/postldapadmin/lib

4.2 postLDAPadminの設定

4.2.1 web.confの作成

web.confの作成例

# cd /usr/local/postldapadmin/etc
# mkdir [管理する仮想ドメイン]
# chown apache:apache [管理する仮想ドメイン]
# cp web.conf.sample [管理する仮想ドメイン]/web.conf
# chown apache:apache [管理する仮想ドメイン]/web.conf

※ web.confの設定内容は4.3.5節に記述されています。

4.2.1.1 tab.confの作成

[展開ディレクトリ]/postldapadmin/etc/tab.conf.sample

以下のようにコピーしてください。

# cp tab.conf.sample [管理する仮想ドメイン]/tab.conf

※ tab.confの設定内容は4.3.6節に記述されています。

4.2.1.2 admin.keyの作成

admin.keyの作成例

# cat /dev/urandom | base64 | head -n1 | cut -c1-8 > [管理する仮想ドメイン]/admin.key

4.2.1.3 msg_fileの作成

[展開ディレクトリ]/postldapadmin/etc/msg_file.sample

以下のようにコピーしてください。

# cp msg_file.sample [管理する仮想ドメイン]/msg_file

※ msg_fileの設定内容は4.3.7節に記述されています。

4.3 DHCPサーバの基本設定

DHCPサーバの設定のために、dhcpd.conf及びdhcpd6.confを/etc/dhcp/ディレクトリ配下に作成し、DHCPサーバ全体に影響するパラメータの設定を行います。
この時点で、それ以外のパラメータを設定する必要はありません。
IPv4、IPv6の一方だけを利用する場合でも、両方の設定ファイルが必要になります。
IPv4のDHCPクライアントがDHCPサーバを判別するために、dhcpd.confに少なくとも以下の2つの設定が必要です。

• DHCPサーバのIPアドレス
• DDNSの更新方式の設定

※注意

subnetオプションの設定を手動で行うと、DHCPadminは正常に動作しません。

server-identifier 192.168.0.1;
ddns-update-style interim;

IPv6のDHCPサーバのために、dhcpd6.confに以下を設定します。

• DDNSの更新方式の設定

※注意

subnetオプションの設定を手動で行うと、DHCPadminは正常に動作しません。

ddns-update-style interim;

4.4 DHCPadminのインストール

• DHCPadminの入手と展開
• dhcpd.confとdhcpd6.confの移動とシンボリックリンクの作成
• ディレクトリ権限の変更
• ファイルの権限変更
• web.confの編集
• tab.confの編集
• msg_fileの編集

4.4.1 DHCPadminの入手と展開

DHCPadminのインストールを行います。
まずDHCPadminアーカイブを、下記のDHCPadminプロジェクトのダウンロードページから入手します。
https://github.com/designet-inc-oss/DHCPadmin

次に、ダウンロードしたDHCPadminアーカイブを、postLDAPadminが展開されているディレクトリへ展開します。
展開されるディレクトリはWEBサーバから参照可能である必要があります。 次はpostLDAPadminが/usr/local/配下へ展開されている場合の例です。

# tar xzvf DHCPadmin-[バージョン].tar.gz -C /usr/local/postldapadmin

上記のように展開した場合、展開後のディレクトリ構成は、以下の表のようになります。

4.4.2 dhcpd.confとdhcpd6.confの移動

# mkdir /usr/local/postldapadmin/etc/dhcp/
# mv /etc/dhcp/dhcpd.conf /usr/local/postldapadmin/etc/dhcp/
# mv /etc/dhcp/dhcpd6.conf /usr/local/postldapadmin/etc/dhcp/

DHCPサーバ設定ファイルを移動した場合、DHCPサーバがDHCPサーバ設定ファイルを参照できなくなります。 そのため、DHCPサーバがDHCPサーバ設定ファイルを参照できるように、シンボリックリンクを作成する必要があります。
次は/etc/配下にシンボリックリンクを作成する例です。

# ln -s /usr/local/postldapadmin/etc/dhcp/dhcpd.conf /etc/dhcp/dhcpd.conf
# ln -s /usr/local/postldapadmin/etc/dhcp/dhcpd6.conf /etc/dhcp/dhcpd6.conf

4.4.3 ディレクトリの作成

# mkdir -p /usr/local/postldapadmin/var/[管理する仮想ドメイン]

また、Webサーバからロックファイルを作成するために、ディレクトリの権限を変更する必要があります。
次はWebサーバの実行ユーザが「apache」である場合の例です。

# chown apache:apache /usr/local/postldapadmin/var/[管理する仮想ドメイン]/

4.4.4 ディレクトリとファイルの権限変更

4.4.4.1 ディレクトリの権限変更

# chown apache:apache /usr/local/postldapadmin/etc/dhcp/

4.4.4.2 ファイルの権限変更

# chown apache:apache /usr/local/postldapadmin/etc/dhcp/dhcpd*.conf

4.4.4.3 SELinuxのポリシー作成

・httpd_tドメインからDHCPサーバを起動できないため
・httpd_tドメインからDHCPadmin関連ファイルの参照ができないため
・httpd_tドメインからDHCPサーバの設定ファイルの参照ができないため

上記理由のため、SELinuxが有効(Enforce)な環境では、SELinuxポリシーを作成してインストールする必要があります。
なおSELinuxポリシーの作成前に、以下のソフトウェアをインストールしてください。

・selinux-policy
・selinux-policy-devel (RHEL7以前の場合不要)
・policycoreutils
・policycoreutils-python
・makeコマンド

SELinuxのポリシー作成は以下のように行います。
DHCPadminを展開したディレクトリ配下にSELinuxポリシーが配置してあります。
RHEL7の場合は、systemctlを使うためSELinuxポリシーが異なります。
自身の環境に合わせて該当箇所に移動します。

[RHEL7以前の場合]

$ cd /usr/local/postldapadmin/tmpl/selinux/dhcpadmin

[RHEL7の場合]

$ cd /usr/local/postldapadmin/tmpl/selinux/dhcpadmin-rhel7

以下のファイルに記載されたパスをインストールディレクトリに合わせて変更してください。

$ vi dhcpadmin.fc
/usr/local/postldapadmin(/.*)?                        system_u:object_r:httpd_sys_content_t:s0
/usr/local/postldapadmin/etc/dhcp(/.*)?               system_u:object_r:dhcp_etc_t:s0
/usr/local/postldapadmin/var(/.*)?                    system_u:object_r:httpd_tmp_t:s0

次にSELinuxポリシーをmakeします。

$ make -f /usr/share/selinux/devel/Makefile 
Compiling targeted dhcpadmin module
/usr/bin/checkmodule:  loading policy configuration from tmp/dhcpadmin.tmp
/usr/bin/checkmodule:  policy configuration loaded
/usr/bin/checkmodule:  writing binary representation (version 10) to tmp/dhcpadmin.mod
Creating targeted dhcpadmin.pp policy package
rm tmp/dhcpadmin.mod tmp/dhcpadmin.mod.fc

rootユーザで、作成されたポリシーのインストールを行います。

# semodule -i dhcpadmin.pp

次にファイルコンテキストの再設定を行います。

# restorecon -R /usr/local/postldapadmin

以上でSELinuxポリシーの設定は完了です。

4.4.5 web.confの設定

[RHEL7以前の場合]
［展開ディレクトリ］/postldapadmin/etc/web.conf.dhcpadmin

 :
[dhcpadmin]
DhcpdConfPath=/usr/local/postldapadmin/etc/dhcp/dhcpd.conf
Dhcpd6ConfPath=/usr/local/postldapadmin/etc/dhcp/dhcpd6.conf
DhcpdLeasesPath=/var/lib/dhcpd/dhcpd.leases
Dhcpd6LeasesPath=/var/lib/dhcpd/dhcpd6.leases
LockTime=600
LeasesListNum=20
DefLeaseTime=21600
DefMaxLeaseTime=43200
DhcpdRestartCom=/usr/bin/sudo /etc/init.d/dhcpd restart
Dhcpd6RestartCom=/usr/bin/sudo /etc/init.d/dhcpd6 restart
DhcpdCheckCom=/usr/bin/sudo /etc/init.d/dhcpd status
Dhcpd6CheckCom=/usr/bin/sudo /etc/init.d/dhcpd6 status
DhcpdConfTestCom=/usr/bin/sudo /etc/init.d/dhcpd configtest
Dhcpd6ConfTestCom=/usr/bin/sudo /etc/init.d/dhcpd6 configtest
ImportCsvMode=1
PathToCsvInput=/data/csv/input
PathToCsvBackup=/data/csv/output
MailToAddr=test1@example.com
MailFromAddr=test2@example.com

[RHEL7の場合]
［展開ディレクトリ］/postldapadmin/etc/web.conf.dhcpadmin-rhel7

 :
[dhcpadmin]
DhcpdConfPath=/usr/local/postldapadmin/etc/dhcp/dhcpd.conf
Dhcpd6ConfPath=/usr/local/postldapadmin/etc/dhcp/dhcpd6.conf
DhcpdLeasesPath=/var/lib/dhcpd/dhcpd.leases
Dhcpd6LeasesPath=/var/lib/dhcpd/dhcpd6.leases
LockTime=600
LeasesListNum=20
DefDomain=domainname
DefLeaseTime=21600
DefMaxLeaseTime=43200
DhcpdRestartCom=/usr/bin/sudo /usr/bin/systemctl restart dhcpd
Dhcpd6RestartCom=/usr/bin/sudo /usr/bin/systemctl restart dhcpd6
DhcpdCheckCom=/usr/bin/sudo /usr/bin/systemctl status dhcpd
Dhcpd6CheckCom=/usr/bin/sudo /usr/bin/systemctl status dhcpd6
DhcpdConfTestCom=/usr/bin/sudo /usr/sbin/dhcpd -cf /etc/dhcp/dhcpd.conf -t
Dhcpd6ConfTestCom=/usr/bin/sudo /usr/sbin/dhcpd -6 -cf /etc/dhcp/dhcpd6.conf -t
ImportCsvMode=1
PathToCsvInput=/data/csv/input
PathToCsvBackup=/data/csv/output
MailToAddr=test1@example.com
MailFromAddr=test2@example.com

• IPv4、IPv6の設定項目
  DHCPadminを利用するには、web.confへのIPv4、IPv6の設定項目が両方とも必須になります。どちらかを使用しない場合でも、両方の項目の設定を行ってください。

• 再起動コマンドの設定（DhcpdRestartCom, Dhcpd6RestartCom）
  DHCPadminは、DHCPサーバの設定の適用を行う際に、DHCPサーバの再起動コマンドを実行します。 そのため、DHCPサービスの再起動コマンドを設定する必要があります。
  再起動コマンドは絶対パスで設定してください。

  ※注意

  DHCPサーバとWebサーバの実行ユーザが異なる場合、sudoの設定が必要になります。
  DHCPadminでは、Webサーバの実行ユーザがDHCPサーバの再起動を行います。そのため、sudoの設定が必要となります。
  次は、Webサーバの実行ユーザが「apache」の場合の設定例です。
  RHEL7の場合、systemctlを使用するためsudoの設定が異なります。
  

  
  
  sudoの設定例 (RHEL7以前の場合)

  apache ALL=(ALL) NOPASSWD: /etc/init.d/dhcpd apache ALL=(ALL) NOPASSWD: /etc/init.d/dhcpd6

  
  
  
  
  sudoの設定例 (RHEL7の場合)

  apache ALL=(ALL) NOPASSWD: /usr/bin/systemctl apache ALL=(ALL) NOPASSWD: /usr/sbin/dhcpd

  
  

• チェックコマンド、ステータスコマンドの設定（DhcpdCheckCom, Dhcpd6CheckCom, DhcpdConfTestCom, Dhcpd6ConfTestCom）
  DHCPadminは、DHCPサーバの動作状況を確認したり、dhcpd.confの書式チェックを行うために、DHCPサーバのチェックコマンドを実行します。 そのため、DHCPサービスのチェックコマンドを設定する必要があります。
  チェックコマンドは絶対パスで設定してください。

• リースファイルの設定（DhcpLeasesPath, Dhcp6LeasesPath）
  DHCPadminは、DHCPサーバがリースしているIPアドレスの検索を行う場合、リースファイルを参照します。
  リースファイルの場所は、Linuxのディストリビューションによって変化するため、DHCPサーバのリースファイルの場所を明示的に設定する必要があります。
  リースファイルの場所は、絶対パスで設定してください。
  設定例は、リースファイルが/var/lib/dhcpd/dhcpd.leases(dhcpd6.leases)の場合の例です。

その他の設定については、詳細設定(web.conf)を参考に設定を行ってください。

4.4.6 タブファイル(tab.conf)の設定

管理する仮想ドメインのtab.confに設定項目を追加してください。
もしくは、postLDAPadminの機能を使用せず、DHCPadminの機能のみを利用するのであれば、設定ファイルをサンプルで上書きしてしまっても構いません。

次は設定例です。

dhcpadmin/network:ネットワーク設定
dhcpadmin/network/sn:Shared-network管理
dhcpadmin/network/subnet:サブネット管理
dhcpadmin/client:クライアント設定
dhcpadmin/search:貸出情報検索
dhcpadmin/reload:設定適用
dhcpadmin/v6network:IPv6 ネットワーク設定
dhcpadmin/v6network/sn:IPv6 Shared-network管理
dhcpadmin/v6network/subnet:IPv6 サブネット管理
dhcpadmin/v6client:IPv6 クライアント設定
dhcpadmin/v6search:IPv6 貸出情報検索
dhcpadmin/v6reload:IPv6 設定適用

4.4.7 メッセージファイル(msg_file)の設定

次はpostLDAPadminが/usr/local/へ展開されている場合の例です。

# cat /usr/local/postldapadmin/etc/msg_file.dhcpadmin >> /usr/local/postldapadmin/etc/[管理する仮想ドメイン]/msg_file

4.4.8 CSVファイル自動読み込み設定

CSVファイルを設定ファイル(web.conf)で指定されたディレクトリに配置します。
設定ファイルについては、[管理する仮想ドメイン]のディレクトリ配下にあるweb.confの設定を参照しています。
詳細設定(web.conf)を参考に設定を行ってください。

CSVファイルを反映するコマンドが実行されると、設定ファイルで指定されたディレクトリのCSVファイルを読み込み、DHCPサーバを再起動し設定の反映を行います。
CSVファイルを反映するコマンド実行方法は以下の通りです。

# /usr/local/postldapadmin/bin/dhcpadmin_import_csv [管理する仮想ドメイン]

上記コマンドをcronに設定することで、特定のディレクトリに配置したCSVファイルを自動で読み込み、DHCPサーバの設定に反映することができます。

# crontab -e
0 12 * * *  php /usr/local/postldapadmin/bin/dhcpadmin_import_csv [管理する仮想ドメイン]

自動反映時にメールが配信されます。
通知メールの宛先などの設定については、詳細設定(web.conf)を参考に設定を行ってください。

また、通知メールのテンプレートは自由に設定できます。
日本語の文字コードはUTF-8を使用してください。
以下を参考に設定を行って下さい。

通知メールのテンプレート

[ファイル名]
/usr/local/postldapadmin/tmpl/mail_import_csv_success.tmpl

Subject: CSVファイル自動読み込み:OK

CSVファイル自動読み込みに成功しました。

プロセス名:             {$PROCESS_NAME}
実行時間:               {$EXE_TIME}
{$START_LOOP_CSV}
CSVファイル名:          {$CSV_FILENAME}
内容:
{$CSV_CONTENT}

{$END_LOOP_CSV}

[ファイル名]
/usr/local/postldapadmin/tmpl/mail_import_csv_error.tmpl

Subject: CSVファイル自動読み込み:NG

CSVファイル自動読み込みでエラーが発生しました。

プロセス名:             {$PROCESS_NAME}
エラー発生日時:         {$EXE_TIME}
システムエラーメッセージ:       {$ERROR_MSG}
{$START_LOOP_CSV}
CSVファイル名:          {$CSV_FILENAME}
CSVのエラーメッセージ:  {$CSV_ERROR}
内容:
{$CSV_CONTENT}

{$END_LOOP_CSV}

4.5 Webサーバの設定

Alias /postldapadmin/ /usr/local/postldapadmin/htdocs/

SetEnv LOGNAME [管理するドメイン]
SetEnv DOMAIN [管理するドメイン]

<Directory "/usr/local/postldapadmin/htdocs">
    DirectoryIndex index.html index.php
    require all granted
    PHP_value include_path ".:/usr/local/postldapadmin/"
</Directory>

また、DHCPadminだけでなくpostLDAPadminやpostLDAPadminのプラグイン （SyLAS, ILUKA, SaMMAadmin等）の機能も使用する場合は、 URL書き換えの設定が必要になるため、下記のように設定を行います。

Alias /postldapadmin/ /usr/local/postldapadmin/htdocs/

SetEnv LOGNAME [管理するドメイン]
SetEnv DOMAIN [管理するドメイン]

<Directory "/usr/local/postldapadmin/htdocs">
    DirectoryIndex index.html index.php
    require all granted
    PHP_value include_path ".:/usr/local/postldapadmin/"
    RewriteEngine On
    RewriteRule ^admin/logout.php$  /postldapadmin/admin/dhcpadmin_logout.php [L]
</Directory>

4.6 管理者の設定

4.7 DHCPサーバ(IPv4)の起動確認

4.7.1 ログイン

1. 以下のURLにアクセスします。
   • http://［ホスト名］/postldapadmin/
2. アクセスが成功すると、認証画面が表示されるので、以下の項目を入力します。
   • admin
   • パスワード

4.7.2 サブネットの登録

1. [ネットワーク設定] のタブをクリックします。
2. サブネット管理のアイコンをクリックします。
3. サブネット管理画面の入力欄に、サブネットとネットマスクを入力します。
4. ［追加］ボタンをクリックします。サブネットとネットマスクの書式が正しければ、サブネット編集画面が表示されます。
5. サブネット編集画面で以下の情報を入力します。
   • ルータ
   • ドメイン名
   • 標準リース時間
   • 最大リース時間
   • DNSサーバアドレス
6. ［登録］ボタンをクリックします。

※注意

dhcpd.confには、必ずDHCPサーバのIPアドレスを含むサブネットが必要となります。ここで登録するサブネットはその範囲のものにして下さい。

サブネットの登録が成功すると、サブネット管理画面に、追加したサブネットとネットマスクが表示されます。 サブネットの登録についての詳細は、「サブネットを追加するには」の項目を参考にしてください。

4.7.3 DHCPサーバの起動

1. DHCPadminにログインし、［設定適用］タブをクリックします。
2. 設定適用画面が表示されたら、［再起動］ボタンをクリックします。

［再起動］ボタンをクリックすると、DHCPサーバに設定が適用され、DHCPサーバが起動します。 起動が成功すると、設定適用画面に「起動中」のメッセージが表示されます。 設定適用ついての詳細は、「設定を適用するには」の項目を参考にしてください。

4.8 DHCPサーバ(IPv6)の起動確認

4.8.1 ログイン

1. 以下のURLにアクセスします。
   • http://［ホスト名］/postldapadmin/
2. アクセスが成功すると、認証画面が表示されるので、以下の項目を入力します。
   • admin
   • パスワード

4.8.2 IPv6サブネットの登録

1. [IPv6ネットワーク設定]タブをクリックします。
2. IPv6サブネット管理のアイコンをクリックします。
3. IPv6サブネット管理画面の入力欄に、サブネットとプレフィックスを入力します。
4. ［追加］ボタンをクリックします。サブネットとプレフィックスの書式が正しければ、IPv6サブネット編集画面が表示されます。
5. IPv6サブネット編集画面で以下の情報を入力します。
   • ドメイン名
   • 標準リース時間
   • 最大リース時間
   • DNSサーバアドレス
6. ［登録］ボタンをクリックします。

※注意

dhcpd6.confには、必ずDHCPv6サーバのIPv6アドレスを含むサブネットが必要となります。ここで登録するサブネットはその範囲のものにして下さい。

サブネットの登録が成功すると、IPv6サブネット管理画面に、追加したサブネットとプレフィックスが表示されます。 IPv6サブネットの登録についての詳細は、「サブネットを追加するには(v6)」の項目を参考にしてください。

4.8.3 DHCPv6サーバの起動

1. DHCPadminにログインし、［IPv6設定適用］タブをクリックします。
2. IPv6設定適用画面が表示されたら、［再起動］ボタンをクリックします。

［再起動］ボタンをクリックすると、DHCPv6サーバに設定が適用され、DHCPv6サーバが起動します。 起動が成功すると、設定適用画面に「起動中」のメッセージが表示されます。 設定適用ついての詳細は、「設定を適用するには(IPv6)」の項目を参考にしてください。