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 を起動する必要があります。

環境変数の設定は以下のコマンドを実行し、

.. code-block:: shell-session

    # systemctl edit osstech-unicornidm


以下のように *Environment* パラメーターに **ALLOWED_HOSTS=host1:host2:..**
のように記述します。 ALLOWED_HOSTS の値は **:** 区切りで記述します。

.. code-block:: cfg

    [Service]
    Environment="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 を FALSE にしてください。

環境変数の設定は以下のコマンドを実行し、

.. code-block:: shell-session

    # systemctl edit osstech-unicornidm

以下のように *Environment* パラメーターに **ENABLE_PPOLICY=FALSE** を記述します。


.. code-block:: cfg

    [Service]
    Environment="ENABLE_PPOLICY=FALSE"
