OpenLiteSpeed をアップデートしたら管理画面が認証不能になった場合の対処法

以前構築した OpenLiteSpeed ウェブサーバーが、dnf-automatic で夜間自動アップデートされたのですが、ウェブサイトにアクセスすると 503 エラー（Service Unavailable）を返して閲覧できない状態になっていました。

この 503 エラーに関しては OLS のサービスを再起動（systemctl restart lsws.service）する事で、すぐに復旧する事ができました。

詳細を確認するため OLS の管理画面にアクセスしようとしたところ、設定した管理者パスワードを正しく入力しても Invalid credentials が表示され、ログインできない状態になっていました。

環境
対処法

環境

OS: AlmaLinux release 9.6 (Sage Margay)
ウェブサーバー： OpenLiteSpeed
- アーキテクチャー: x86_64
- アップデート後のバージョン: 1.8.4-4.el9
- リポジトリ: litespeed-update
ホスティング： ConoHa VPS（メモリ 2GB）

対処法

OLS 管理画面のログ（/usr/local/lsws/admin/logs/error.log）を確認したところ、/usr/local/lsws/admin/conf/htpasswd が見つからないというエラーが記録されていました。

2025-09-26 10:35:54.465006 [NOTICE] [1336] [xxx.xxx.xxx.xxx:XXXXX:HTTP2-X#_AdminVHost] [STDERR] PHP Warning:  fopen(/usr/local/lsws/admin/conf/htpasswd): failed to open stream: No such file or directory in /usr/local/lsws/admin/html.open/lib/CAuthorizer.php on line 237
2025-09-26 10:35:54.466218 [NOTICE] [1336] [xxx.xxx.xxx.xxx:XXXXX:HTTP2-X#_AdminVHost] [STDERR] [WebAdmin Console] Failed Login Attempt - username:admin ip:xxx.xxx.xxx.xxx url:

2025-09-26 10:35:54.465006 [NOTICE] [1336] [xxx.xxx.xxx.xxx:XXXXX:HTTP2-X#_AdminVHost] [STDERR] PHP Warning: fopen(/usr/local/lsws/admin/conf/htpasswd): failed to open stream: No such file or directory in /usr/local/lsws/admin/html.open/lib/CAuthorizer.php on line 237

2025-09-26 10:35:54.466218 [NOTICE] [1336] [xxx.xxx.xxx.xxx:XXXXX:HTTP2-X#_AdminVHost] [STDERR] [WebAdmin Console] Failed Login Attempt - username:admin ip:xxx.xxx.xxx.xxx url:

ディレクトリのファイル一覧を確認しても、htpasswd がありません。

# ls -la /usr/local/lsws/admin/conf/
total 88
drwx------ 2 lsadm lsadm  4096 Sep 26 06:51 .
drwxr-xr-x 9 root  root   4096 Sep 26 06:50 ..
-rw-r--r-- 1 lsadm lsadm   681 Apr 15  2024 admin_config.conf
-rw-r--r-- 1 lsadm lsadm   798 Feb  2  2024 admin_config.conf.bak
-rw-r--r-- 1 lsadm lsadm   495 Sep 26 10:24 admin_config.conf.txt
-rw-r--r-- 1 lsadm lsadm   681 Apr 15  2024 admin_config.conf0
-rw------- 1 lsadm lsadm    41 Aug 22 00:19 htpasswd.rpmnew
-rw------- 1 lsadm lsadm    41 Feb  2  2024 htpasswd.rpmsave
-rw------- 1 lsadm lsadm   529 Sep 25 11:23 jcryption_keypair
-rw------- 1 lsadm lsadm 38186 Sep 25 11:23 php.ini
-rw-r--r-- 1 lsadm lsadm  2077 Sep 11 17:58 quic-cloud-ips
-r-------- 1 lsadm lsadm  1623 Feb  2  2024 webadmin.crt
-r-------- 1 lsadm lsadm  1704 Feb  2  2024 webadmin.key

# ls -la /usr/local/lsws/admin/conf/

total 88

drwx------ 2 lsadm lsadm 4096 Sep 26 06:51 .

drwxr-xr-x 9 root root 4096 Sep 26 06:50 ..

-rw-r--r-- 1 lsadm lsadm 681 Apr 15 2024 admin_config.conf

-rw-r--r-- 1 lsadm lsadm 798 Feb 2 2024 admin_config.conf.bak

-rw-r--r-- 1 lsadm lsadm 495 Sep 26 10:24 admin_config.conf.txt

-rw-r--r-- 1 lsadm lsadm 681 Apr 15 2024 admin_config.conf0

-rw------- 1 lsadm lsadm 41 Aug 22 00:19 htpasswd.rpmnew

-rw------- 1 lsadm lsadm 41 Feb 2 2024 htpasswd.rpmsave

-rw------- 1 lsadm lsadm 529 Sep 25 11:23 jcryption_keypair

-rw------- 1 lsadm lsadm 38186 Sep 25 11:23 php.ini

-rw-r--r-- 1 lsadm lsadm 2077 Sep 11 17:58 quic-cloud-ips

-r-------- 1 lsadm lsadm 1623 Feb 2 2024 webadmin.crt

-r-------- 1 lsadm lsadm 1704 Feb 2 2024 webadmin.key

どうやら、アップデートの際に htpasswd.rpmnew と htpasswd.rpmsave に置き換えられてしまったようです。

# cp -p /usr/local/lsws/admin/conf/htpasswd.rpmsave /usr/local/lsws/admin/conf/htpasswd

1	# cp -p /usr/local/lsws/admin/conf/htpasswd.rpmsave /usr/local/lsws/admin/conf/htpasswd

htpasswd.rpmsave をコピー（-p オプションでパーミッションを維持）して htpasswd を配置する事で、無事 OLS の管理画面にログインできるようになりました。