目的

The Open Files Limit Health Check queries the maximum and current open file descriptors on the operating system, for the Confluence running process. After doing so it calculates a % of the total, and based on what that % is, it either sends a warning or a major alert.

File descriptors are used by *nix operating systems to handle access to files. There are limits put in place by the operating system, and if processes try to exceed those limits they will be refused access to additional descriptors. This will impact Confluence's operation.

影響

If the currently running Confluence process attempts to exceed the maximum allowable file descriptors, it will critically fail, and major operations will be unable to continue. The only fix for this is to restart the Confluence instance.

結果の確認

最大の <オープンなファイルの最大数> について <オープンなファイルの数> があります。これは許容される制限内です。

The Confluence process is using less than 70% of the maximum open file descriptors.

最大の <オープンなファイルの最大数> について <オープンなファイルの数> があります。これは制限に近づいており、制限を超過するとクリティカルな失敗が発生します。

The Confluence process is using 70% or higher of the maximum open file descriptors.

There are '<num open files>' open files out of the maximum, '<max open files>'. This is critically close to the limit, and should be fixed immediately.

The Confluence instance is using 90% or higher of the maximum open file descriptors.

ソリューション

これを解決するには、オープンできるファイルの上限を増やす必要があります。

1. Confluence をシャットダウンします。

2. ターミナルで次のコマンドを実行し、ご利用のシステムでのファイル ハンドラの上限数を確認します。

   ulimit -aS | grep open

3. To set the limit of the file handler, add the following line into the <confluence-install>/bin/setenv.sh file. You can modify the number based on your application's needs

   ulimit -n 4096

   
   

   This will set that value each time Confluence is started, however, will need to be manually migrated when upgrading Confluence. Please see below for a permanent resolution.

4. その後、変更を反映するために Confluence を再起動する必要があります。

To permanently apply the resolution, this needs to be configured on a per OS basis, and can be done by consulting the operating system documentation on how to do so - if using Ubuntu we have instructions in Too many open files error in Jira server (this is a JIRA KB however the change is the same).