FAQ
*******

一般的なトラブルシューティング
================================

サービスの起動ができない
---------------------------

`systemctl start osstech-unicornidm` を実行したあとに
`systemctl status osstech-unicornidm` でサービス起動が失敗している場合、
以下のログファイルを参照することで原因が特定できる可能性があります。

* /opt/osstech/var/log/unicornidm/unicornidm.log

* /opt/osstech/var/log/unicornidm/mongod.log

* /opt/osstech/var/log/unicornidm/uwsgi.log

Bad Request (400) が表示される
-------------------------------

Unicorn ID Manager はデフォルトで *localhost* 、
*127.0.0.1* および *サーバーの FQDN ホスト名* でのアクセスしか許可しません。
これらのアクセスに加えて別のホスト名でのアクセスを許可するためには、
allowed_hosts パラメーターを指定して Unicorn ID Manager を起動する必要があります。

設定は以下のファイルのメインセクション ( [__main__] という名前のセクション) で
行います。

::

    unicornidm.conf

以下のように allowed_hosts パラメーターに **allowed_hosts = host1, host2, ..**
のように記述します。 allowed_hosts の値はカンマ区切りで記述します。

.. code-block:: cfg

    allowed_hosts = host1, host2

OpenLDAP をバックエンドにしている場合にユーザーの認証のたびにログが出力される
-------------------------------------------------------------------------------

OpenLDAP バックエンドで ppolicy オーバーレイを利用していない場合、
以下のメッセージが出力されます。

::

    slap_global_control: unrecognized control: 1.3.6.1.4.1.42.2.27.8.5.1

このメッセージを抑制するためには enable_ppolicy パラメーター を no にしてください。

設定は以下のファイルの *type* が *ldap* となっているバックエンドセクション
( [backend:<name>] という名前のセクション) で行います。

::

    unicornidm.conf

メッセージを抑制したいバックエンドのセクションで以下のように enable_ppolicy パラメーターに
*no* を記述します。

.. code-block:: cfg

    enable_ppolicy=no
