文書番号 NDWS-0006-07

WEB SPIRAL
FAQ・問題解決ガイド（文書番号 NDWS-0006-07）

1
Copyright（C）Net Dreamers Co.,Ltd.

All rights reserved.

【CONFIDENTIAL】

文書番号 NDWS-0006-07

導入準備編 .................................................................................................................. 3
配信は FTP 以外は利用できないのでしょうか？ .......................................................................3
ステージ環境とは何ですか？....................................................................................................3
何ファイルまで管理できますか？ ..............................................................................................4
複数のサーバに配信することは可能ですか？ ...........................................................................4プログラム（CGI や PHP など）も管理できるのでしょうか？ .....................................................4
管理できないファイルなどはありますか？..................................................................................4
ステージ環境への接続（FTP）アカウント管理はどうなっていますか？ ........................................4

初期導入編 .................................................................................................................. 6
サイト取込とは何ですか？ ........................................................................................................6
SFTP のオプションパッケージはインストールが必ず必要なのでしょうか？ .................................6
ステージ設定で Apache の設定などは変更しても問題ないでしょうか？ .....................................6
使用しているプロトコルを教えてください ....................................................................................7
サイト取込で取込まれたくないディレクトリを除くには ..................................................................7
配信時のファイルのパーミッションを設定するには .....................................................................7

問題解決編 .................................................................................................................. 8

問題解決の概要 ............................................................................................................8

どのような現象が起きているのか？............................................................................8

問題が発生しているのはどの場所（処理）か？ ..........................................................9

その問題はいつ発生するのか？ ...................................................................................9

どのような条件の時に問題が発生するのか？ ...........................................................10



その問題は再現可能か？ ...........................................................................................10

ブラウザで画面が表示されません ........................................................................................... 11
ログインができません .............................................................................................................12
サイト取込でディレクトリが表示できません ..............................................................................12
サイト取込で取込まれていないファイルがあります ...................................................................13
サイト取込が始まりません ......................................................................................................13
配信が始まりません ...............................................................................................................142
Copyright（C）Net Dreamers Co.,Ltd.

All rights reserved.

【CONFIDENTIAL】

文書番号 NDWS-0006-07

導入準備編
配信は FTP 以外は利用できないのでしょうか？
FTP 以外に SSH2/SFTP を利用することも可能です。
SSH2/SFTP にて配信する場合には、事前に弊社までご相談ください。

ステージ環境とは何ですか？
本番環境に配信する HTML ファイルなどを編集し確認などを行う環境です。
また、このステージ環境は WEB SPIRAL と連携しており WEB SPIRAL FTP SERVER を通して「更新・削除」などの操作ログが取得されます。
このログにより WEB SPIRAL 管理画面で更新したファイルを簡単に、そして間違いなく把握できるために配信間違いなどのヒューマンエラーを軽減することが可能です。
また、FTP にて更新可能なために、今までの HTML エディターなどが利用でき、より自由なサイトの作成が行えます。

ブラウザ
管理・監視
FTP CLIENT

編集

ステージ環境
ブラウザ

確認

W E B

管理リポジトリS P I R A L

3Copyright（C）Net Dreamers Co.,Ltd.

All rights reserved.

【CONFIDENTIAL】

配信

本番
環境

文書番号 NDWS-0006-07

何ファイルまで管理できますか？
ファイル数の上限はアプリケーション上設けておりませんので、理論上は無限です。
ただし、データベースや実ディスク容量などに依存します。

複数のサーバに配信することは可能ですか？
複数のサーバに同じファイルを配信することができます。
ただし、配信するサーバを選択し配信を行うことはできませんのでご注意ください。

プログラム（CGI や PHP など）も管理できるのでしょうか？
プログラム（CGI や PHP など）はステージ環境では動作させることが可能です。
このとき、動作に必要な環境設定などはお客様にて行うことが必要となります。ただし、WEBSPIRAL 自体が PHP で構築されているために、お客様のプログラムと環境が競合する場合などには動作しない場合がありますのでご了承ください。
また、タイムプレビューではプログラムを動作させることはできません。この場合、テキストデータとしてファイルの内容が表示されます。
また、配信時に CGI などに必要なファイルのパーミッションも設定することが可能です。
（SFTP配信方式を使用した場合に限ります。）

管理できないファイルなどはありますか？
WEB SPIRAL は WEB サイトを構築・管理することを目的としており、以下のようなファイルは管理できません。
「ファイル名に日本語を含むファイル」「ファイル名にスペースを含むファイル」「ファイル名に全角文字を含むファイル」
また、管理は行えますが以下のようなファイルの管理についても注意が必要です。
「大きなファイル」：動画ファイルなどのファイルステージ環境への接続（FTP）アカウント管理はどうなっていますか？
4
Copyright（C）Net Dreamers Co.,Ltd.

All rights reserved.

【CONFIDENTIAL】

文書番号 NDWS-0006-07

ステージ環境へ接続する FTP アカウントは、WEB SPIRAL で管理しているスタッフと同じアカウント、パスワードが利用できます。ただし、そのアカウントに対し「FTP 接続権限」を与える必要があります。このように共有したアカウント管理をしないために、よりセキュリティが高く保つことができます。しかし実際のファイルの所有者は一人に設定できるために、今までの煩雑な運用が必要となることもありません。
また、チーム管理により更新を許可しないディレクトリを WEB 管理画面から設定することも可能です。

5
Copyright（C）Net Dreamers Co.,Ltd.

All rights reserved.

【CONFIDENTIAL】

文書番号 NDWS-0006-07

初期導入編
サイト取込とは何ですか？
サイト取込機能は、現在のサイトから FTP(もしくは SFTP)で接続し WEB SPIRAL に環境をインポートする機能です。
これにより既存のサイトからすばやくサイトを移行し、運用することが可能です。

SFTP のオプションパッケージはインストールが必ず必要なのでしょうか？
配信を SSH2/SFTP にて行わない場合には必要がございません。
ただし CGI などのファイルを配信し、そのときにファイルのパーミッションを設定したい場合には配信方法として FTP は選択できませんので、SSH2/SFTP オプションのインストールが必須となります。
SSH2/SFTP にて配信する場合には、事前に弊社までご相談ください。

ステージ設定で Apache の設定などは変更しても問題ないでしょうか？
ステージ設定で Apache の設定はご自由に変更していただいて問題ございません。
このとき CGI などを利用している場合には、本番環境を参考に環境を設定してください。
ステージ環境は WEB SPIRAL FTP SERVER を通した操作ログにより管理しており、プレビュー機能は WEB SPIRAL では保持しておりません。
このため、Apache の設定により動作が変わることはありませんのでご安心ください。

6
Copyright（C）Net Dreamers Co.,Ltd.

All rights reserved.

【CONFIDENTIAL】

文書番号 NDWS-0006-07

使用しているプロトコルを教えてください
以下のプロトコル・ポート番号を使用しています。
用途

プロトコル

備考

配信・サイト取込

FTP もしくは SSH2/SFTP

ステージ配信FTP

管理 WEB 画面

HTTP(S)

デフォルト 80 番

ステージ WEB 画面

HTTP(S)

デフォルト 8888 番

タイムプレビュー

HTTP(S)

デフォルト 8080 番

内部配信管理独自

デフォルト 3100 番（local 通信のみ）

DB 通信

DB に依存します----サイト取込で取込まれたくないディレクトリを除くには本番サイトからサイト取込をする場合にサイト取込に含ませたくないディレクトリがある場合や、同様に取込ませたくないファイルがある場合にはそれらを含まない状態でサイトを取込む必要があります。
このとき、必ずしもサイト取込は本番サイトから行わなくてもかまいません。また、同様にネットワークの負荷などの都合により本番サイトから取込ができない場合にもサイト取込は FTP も
しくは SSH2/SFTP によりファイルを取得する処理ですので、任意のサーバに取込むファイルを整理していただき、そこから取込むことが可能です。

配信時のファイルのパーミッションを設定するには配信時にファイルのパーミッションを設定するにはまず配信設定を FTP から SFTP に変更する必要があります。
また、ファイルのパーミッションはファイルの拡張子によりルールベースに設定が行われます。
この設定を確認、変更したい場合には以下のファイルを参照してください。
ファイル名）/var/www/html/webspiral/admin/lib/filemg/sftp.ini

7
Copyright（C）Net Dreamers Co.,Ltd.

All rights reserved.

【CONFIDENTIAL】

文書番号 NDWS-0006-07

問題解決編
 問題解決の概要
問題を解決するために必要なことは、問題を正確に把握することです。
主に以下のような事項について把握する必要があります。
どのような現象が起きているのか？



問題が発生しているのはどの場所（処理）か？



その問題はいつ発生するのか？



どのような条件の時に問題が発生するのか？

その問題は再現可能か？

 どのような現象が起きているのか？
問題が発生した時には何が問題として発生しているのかを明確にする必要があります。これを明確にするには以下のような視点で現象を確認します。
１）誰が問題を報告しているのか？（ブラウザ、運用者など）
２）エラーメッセージはどのようなものか？
３）どのような障害が起きているのか？
表示されない、処理が始まらない、処理が終わらない、処理が遅い、結果が異なる等
４）どのような影響があるのか？
現象によって誰にどのような影響を与えているのか？

8
Copyright（C）Net Dreamers Co.,Ltd.

All rights reserved.

【CONFIDENTIAL】

文書番号 NDWS-0006-07 問題が発生しているのはどの場所（処理）か？
問題が発生している場所を特定するのは容易ではありません。この場所を正確に把握することが問題解決には大変重要なステップとなります。しかし、問題が発生し現象が見える場所から問題が発生している原因の場所までにはいくつものテクノロジーが存在しております。
たとえば、・ ネットワーク（ファイアーウォール・DNS・プロキシ・・・）・ ディスク・ ミドルウェア（設定・仕様）
・ プログラム・ ブラウザ・クライアント（設定・その他ソフト）などがあります。これらの層を切り分けることが問題の場所を把握するためには重要なことです。
ただし、１つの層において問題が発生しているからといってその層に原因があるとは限らないため十分に注意が必要です。
問題の層を切り分けるよい方法は、代替手段がある場合にはその手段においても問題が発生するかを確認することです。
たとえばネットワークなどで問題が発生しているかを把握するためには、インストールされたサーバに直接ログインし確認をしてみます。このようにすることでサーバからクライアントまでのネットワークを介さずに問題が把握できるために問題の切り分けができます。
また、インターネット・イントラネットなどで運用する場合には、様々な制約・制限のもとで運用されるケースがあります。たとえば、ファイアーウォールなどです。
これらは機能上、問題が起きても問題を隠す性格を持つものです。一度、制約・制限をはずしてから問題の把握をするようにしてください。制約・制限で問題が発生している場合には一つずつ制約・制限を設定し、どの場所で発生しているかを把握します。また、制約、制限を正しく把握することは安全なシステム運用には大変重要なことです。

 その問題はいつ発生するのか？
9
Copyright（C）Net Dreamers Co.,Ltd.

All rights reserved.

【CONFIDENTIAL】

文書番号 NDWS-0006-07

問題がいつ発生したのかを把握することは場所を把握することと同様、大変重要なステップとなります。一度限りしか発生しない場合には特に重要な情報となります。
たとえば、１）午前中、夜間など特定の時刻など
２）ログインした直後など特定の処理をした後など
３）既存のソフトウェアをインストールした後など
４）既存のネットワークやサーバなどの構成を変更した後などをはじめとした調査を行ってください。
時刻に依存する場合などには、運用上アクセスが集中する場合や、その他のアプリケーションが起動しており影響を及ぼす場合などが考えられます。このようにいつ問題が発生したかを把握することはシステム以外の外的要因がシステムに対してどのように影響を及ぼすのかを解決するヒントを与えてくれる場合があります。

 どのような条件の時に問題が発生するのか？
問題が発生したときにそのときの条件がわかれば、問題を解決するために重要な手がかりとなります。この条件には前述した「何が」「いつ」「どこで」までを含むこともあります。
また、特定の環境下や条件下で問題が発生する場合には、その情報が問題解決のための標識になります。

 その問題は再現可能か？
再現可能な問題というのは、同時に解決しやすい問題でもあります。
再現可能な問題の場合、その手順、条件を整理してください。そしてどの条件、手順が問題を発生させる根本の原因となるのかが把握できれば解決するための大きな手がかりとなります。ただし、問題の原因は一つとは限りませんので注意が必要です。
また、結果の出力などで問題が発生している場合には、手順だけでなく、入力のときのデータなどが大きく影響を及ぼしますので注意が必要です。

10
Copyright（C）Net Dreamers Co.,Ltd.

All rights reserved.

【CONFIDENTIAL】

文書番号 NDWS-0006-07

ブラウザで画面が表示されません
ブラウザで画面が表示されない場合には、まず、サーバへリクエストが届いているのか、リクエストが届かないのかを整理する必要があります。
サーバへリクエストが届いているのかを確認するには、Apache のアクセスログを参照することがもっとも簡単に確認する方法です。
Apache のアクセスログ）/var/log/httpd/access_log

また、アクセスログにアクセスがある場合には、サーバ内で何らかの問題が発生しております。
この場合にはどの層で問題が発生しているか調査が必要になります。それぞれのログを参照し、問題報告のメッセージが出力されているか確認を行ってください。
１）Apache のエラーログ
２）PHP のエラーログ
３）WEB SPIRAL のログの順番で問題報告のメッセージが出力されているかを確認してください。
また、Apache のアクセスログ、エラーログに何も情報が記述されない場合には、ブラウザからのリクエストがサーバへ届いておりません。この場合に以下の項目を確認してください。
１）サーバ自体は起動されているのか
２）Apache は起動されているのか
３）ネットワークの制約・制限
４）入力した URL に間違いがないか
ネットワークの制約・制限には、ブラウザのプロキシ設定などもあります。この場合、設定自体に誤りがないかを再度確認してください。

11
Copyright（C）Net Dreamers Co.,Ltd.

All rights reserved.

【CONFIDENTIAL】

文書番号 NDWS-0006-07

ログインができません
ログインができない場合には、ブラウザのクッキーが有効になっているかを確認してください。
クッキーが有効になっていない場合にはログインができませんので注意が必要です。
また、同様に JavaScript も有効にしてください。
また、WEB SPIRAL 設定が誤っている場合や、DB サーバが起動されていない場合には以下のような画面が表示されます。

この場合には DB サーバが起動されていることを確認してください。
次に DB サーバが起動されている場合には、WEB SPIRAL 設定の DB 設定が正しくされているか確認してください。

サイト取込でディレクトリが表示できません
WEB SPIRAL の配信設定において、FTP で配信を行うのか、または SSH2/SFTP で配信を行うのかを確認してください。FTP で配信を行う場合には FTP でサイト取込を行い、SSH2/SFTPで配信を行う場合には SSH2/SFTP でサイト取込を行います。
FTP でサイト取込を行う場合には取込先のサーバに FTP サーバが起動している必要があります。
次に入力している項目を再度確認してください。このとき、ホスト名はクライアントからのホスト名ではなく、サーバからのホスト名です。
クライアントからは名前解決できてもサーバからは名前解決できない場合などには注意が必要です。
12
Copyright（C）Net Dreamers Co.,Ltd.

All rights reserved.

【CONFIDENTIAL】

文書番号 NDWS-0006-07

次に確認することは、サーバから実際に手動にて接続を行うことです。サーバから手動にて接続できない場合は、ネットワークの問題等のアプリケーション以外の制限により動作することができませんので、サーバ管理者などに問い合わせいただき問題の解決を行ってください。

サイト取込で取込まれていないファイルがあります
サイト取込を行いますと、取込まれたファイルの一覧は管理画面上のログに表示されます。
また、取込まれないファイルは、サーバ上のログに出力されますのでそちらを参照してください。
ログファイル）/tmp/file_apply_[取込日時].log
skip

使用していないショートカット

invalid filenameのように「原因」-「ファイル名」-「メッセージ」の形式で出力されます。
ファイル名は日本語が含まれたもの、スペースを含むもの、全角文字を含むものは許可されません。この場合、ファイル名の表示が正しく表示されないことがあります。また、ディレクトリに日本語が含まれたものはサイト取込の対象から除かれます。

サイト取込が始まりません
サイト取込は、xinetd サービス（サービス名 ndtask）を用いて処理を行っております。このため、OS のサービス制約により許可されていない場合にはサイト取込が開始できません。
この場合、127.0.0.1 の 3100 番ポートへ telnet を実行し通信できるか確認してください。
telnet 127.0.0.1 3100

通信が正常に行われると以下の様な出力結果が得られます。
Trying 127.0.0.1...
Connected to localhost (127.0.0.1).
Escape character is '^]'.
400 Unknown Status
Task-Id: c9efa6bf659da886b4d198a6150a6776
Date: Mon, 1 Jan 2007 00:00:00 +0900
13
Copyright（C）Net Dreamers Co.,Ltd.

All rights reserved.

【CONFIDENTIAL】

文書番号 NDWS-0006-07
Connection closed by foreign host.

この場合は 127.0.0.1 に通信が許可されていない可能性がございます。
Trying 127.0.0.1...
Connected to localhost (127.0.0.1).
Escape character is '^]'.
Connection closed by foreign host.

127.0.0.1
このときには TCP Wrapper を利用したアクセス制御（/etc/hosts.allow、/etc/hosts.deny）で、の 3100 番ポートからのアクセスが許可されているかを確認してください。
この場合は xinet のサービスで ndtask が起動していない可能性がございます。
Trying 127.0.0.1...
telnet: Unable to connect to remote host: Connection refused

このときには xinetd のサービス ndtask を有効にしてください。

配信が始まりません
配信のスケジューリング処理は atd を用いて行っております。
したがって、atd が正しく起動されていることを確認してください。

14
Copyright（C）Net Dreamers Co.,Ltd.

All rights reserved.

【CONFIDENTIAL】