FAQ

このページでは、KUSANAGIにお寄せ頂いた、よくあるご質問への回答、およびご利用方法に関する補足情報などを掲載しています。

Q1. FTP で接続できませんでした。ファイルのアップロードなどを行いたいのですが、どのような方法がありますか?

A1. KUSANAGI では、セキュリティ対策のため初期設定では外部からの FTP 接続を許可しない設定となります。
WinSCP や FileZilla など SSH(SFTP)接続に対応したクライアントソフトをご使用頂くことを推奨します。接続設定については、「Q2. KUSANAGI サーバに SFTP クライアントで接続する設定を教えてもらえますか?」もあわせてご参照下さい。

Q2. KUSANAGI サーバに SFTP クライアントで接続する設定を教えてもらえますか?

A2. 以下のように設定します。

ホスト名:example.com(SSH接続時のホスト名と共通)
ユーザー名:kusanagi
パスワード:[インストール時に設定したユーザー「kusanagi」のパスワード]

WinSCP、FileZilla の設定例

WinSCPでの設定例

WinSCPでの設定例

filezilla_a-2

FileZillaでの設定例

Q3. WordPress の管理画面からプラグイン・テーマの追加や、WordPress 本体またはプラグインの更新を行おうとしたところ、FTP 接続情報を要求されます。

A3. KUSANAGI では、セキュリティ対策のため各ディレクトリのアクセス権限等に制限をかけているため、プラグイン・テーマ等の追加や各種更新を行う際に FTP の接続情報を要求されます。
以下のように接続情報を入力することで、作業を続行できます。

ホスト名:localhost
ユーザー名:kusanagi
パスワード:[インストール時に設定したユーザー「kusanagi」のパスワード]

Q4. KUSANAGI のセットアップ後、仮想マシンのインスタンスを変更することはできますか?

A4. 可能です。
ただし、変更後のインスタンスにおいて再度設定を最適化させる作業が必要となる場合があります。
仮想マシンを起動した後に SSH でログインし、以下のコマンドを実行してください。

# kusanagi configure

Q5. yum update -y を実行すると、エラーが出力されてアップデートできません。

A5. アップデートのパッケージ依存性の処理において remi パッケージを必要とすることがあります。
以下のように入力することでアップデートできます。

# yum --enablerepo=remi,remi-php56 update -y

Q6. yum のアップデートに失敗する場合は、どのように対応すればよろしいですか?

A6. 仮想サーバやクラウドサービスの状況、リポジトリの状態によって yum のアップデート時に下記のようなエラーが発生することがあります。

エラー表示の例)
[Errno 14] HTTP Error 404 - Not Found

エラーが表示されて yum アップデートに失敗する場合は以下のコマンドを実行し、再度アップデートを実行してください。

# yum clean all
# yum --enablerepo=remi,remi-php56 update -y

上記コマンドを何度か繰り返すことでアップデートできることがあります。

クラウドサービスやリポジトリ側の原因でアップデートができない場合は、復旧するまで時間をおいた後に再度アップデートをお試しください。

Q7. セッションが使用できませんでした。使用できるようにする方法はありますか?

A7. KUSANAGI のバージョンによって PHP のセッション保存ディレクトリの権限が適切でない場合があります。
以下のコマンドを実行し、権限を変更してください。

# chown -R :www /var/lib/php/session/

Q8. KUSANAGI の更新情報では、CentOS や MariaDB の更新情報もアナウンスされますか?

A8. CentOS や MariaDB の更新情報は、該当ページに情報として掲載しておりません。
記載しているのは KUSANAGI の更新情報のみとなります。ただし、該当ページに記載しています yum update コマンドを実行することで CentOS や MariaDB に更新があった場合も自動的に反映されます。
個別の内容を確認したい場合は、CentOS や MariaDB の各サイトをご確認ください。

Q9. KUSANAGI Business Editionにおいて、ShibbolethモジュールをApacheで利用できますか?

A9. 利用できます。
設定方法についてはシボレス認証の設定を参照してください。
なお /usr/lib64/shibboleth/mod_shib_24.so がサーバ上に存在しない場合は、以下のコマンドを実行してください。

# kusanagi addon remove shibboleth
# yum clean all
# kusanagi addon install shibboleth

Q10. Let’s Encrypt 証明書を設定・更新する際に certbot-auto のメッセージが出力されます。

A10. 以下のようなメッセージが出力された場合は、KUSANAGI のアップデートを行うとメッセージが出力されなくなります。

# kusanagi update cert
Your system is not supported by certbot-auto anymore.
certbot-auto and its Certbot installation will no longer receive updates.
You will not receive any bug fixes including those fixing server compatibility
or security problems.

KUSANAGI のアップデートは以下のコマンドで可能です。
certbot-auto のメッセージが表示され Let’s Encrypt 証明書の設定・更新ができなかった場合は、アップデート後に再度お試しください。

# yum update -y kusanagi

Q11. yum update で PHP のアップデートで失敗する場合は、どのように対応すればよろしいですか?

A11. 以下のようなメッセージが出力された場合、

エラー表示の例
Error: Package: kusanagi-php7-7.4.21-1.noarch (kusanagi)
           Requires: libonig.so.105()(64bit)

エラー: パッケージ: kusanagi-php7-7.4.25-1.noarch (kusanagi)
           要求: libicudata.so.69()(64bit)

以下のコマンドのとおり、 yum アップデート時にリポジトリを追加指定してください。

# yum clean all
# yum --enablerepo=remi,remi-php56 update -y kusanagi-php7

Q12. kusanagi httpd で nginx から Apache の切り替えに失敗する場合は、どのように対応すればよろしいですか?

A12. 以下のようなメッセージが表示される場合があります。

エラー表示の例
AH00526: Syntax error on line 5 of /etc/httpd/conf.d/ssl.conf:
Cannot define multiple Listeners on the same IP:port
ERROR: It has not been changed or restarted to httpd.

その場合は /etc/httpd/conf.d/ssl.conf を .conf 以外の拡張子に変更して、再度 kusanagi httpd を実行してください。

# mv /etc/httpd/conf.d/ssl.conf /etc/httpd/conf.d/ssl.conf.bak
# kusanagi httpd

Q13. KUSANAGI for Vagrant の最新イメージが公開されていますが、自動的に更新されません。

A13. Vagrant では最新の Box (イメージ) が公開されても自動的にダウンロードはされません。
KUSANAGI for Vagrant の最新 Box をダウンロードするには、ホスト側で下記のコマンドを実行してください。

# vagrant box update --box primestrategy/kusanagi

すでに構築された KUSANAGI for Vagrant 環境には、ダウンロードした最新の Box は反映されません。
これは、KUSANAGI for Vagrant が環境を構築するとき、そのときに存在する Box からコピーを作成するためです。
最新 Box から KUSANAGI for Vagrant 環境を構築するには、別ディレクトリで作業するか、環境を作り直す必要があります。

Q14. MariaDB 旧バージョンを使用する方法はありますか?

KUSANAGI 8.6 以降では kusanagi initコマンドで初期設定するデフォルトのデータベースが MariaDB 10.5 に変更されています。
MariaDB 10.3 で初期設定したい場合は、kusanagi initコマンドに --dbversion 10.3 を指定してください。
同様に MariaDB 10.1 で初期設定したい場合は、kusanagi initコマンドに --dbversion 10.1 を指定してください。