すぐ使えるCGI サイトから製品の圧縮ファイルをダウンロードして下さい。
（ダウンロードと試用は無料です。）
以下のページからダウンロードできます。
http://sugutsukaeru.jp/cgi/j/101/
ダウンロードした製品ファイルは圧縮されています。解凍ソフトで解凍して下さい。
「解凍ソフト」や「解凍」についてよく分からない方は、ダウンロードしたファイルをダブルクリックしてみて下さい。
自動的に解凍できる場合があります。
ダブルクリックしても何も起こらない場合やうまくいかない場合は下記のページを参照して下さい。
「解凍ソフト」や「解凍」の方法について解説しています。
http://sugutsukaeru.jp/cgi/j/31/
解凍がうまく行くと admin/ というディレクトリや README_win.txt というファイルが現れます。
ディレクトリやファイルが現れたら先に進んで下さい。
設置するサーバの情報をいくつか確認します。
これらの情報は、レンタルサーバ会社やサーバ管理者に問い合わせて下さい。
必要な情報は以下の2点です。
もし分らなければ試しながら行うことにして、先に進んで下さい。
一般的には、「Perl のパス」や「プログラムのコマンドパス」などの項目で情報が提供されています。
以下のような情報です。
/usr/bin/perl
/usr/local/bin/perl
C:/Perl/bin/perl.exe
※ インストールするサーバの OS が Windows の場合は、この情報は不要です。「設置場所の決定」に進んで下さい。
CGIファイルに設定するパーミッションを確認して下さい。
通常は「755」、「700」、「705」などです。
実際の作業に入る前に、ウェブサーバ上の設置場所を決めます。
とりあえずはテストしますので、お使いのウェブサーバで、CGIが実行できる場所であればどこでもよいです。
今の段階では、計画するだけで特に行う作業はありません。
この説明書では、「ウェブサイトに既にある cgi-bin/ ディレクトリの下に sugu/ というディレクトリを作り、その中に設置する」と決めたことにします。
以下のような状態です。
/ (ルートディレクトリ)
|-- public_html/
|-- cgi-bin/ ←元からあった cgi-bin/ ディレクトリ
| |-- sugu/ ←新しく作成する予定
|
|-- index.html など（元からあったファイル）
| :
※ インストールするサーバの OS が Windows でWebサーバが IIS（Internet Information Server） の場合は、この手順は不要です。「アップロード」に進んで下さい。
先ほど解凍したファイルの中に admin/admin.cgi というファイルがありますのでこれをテキストエディタで開いて下さい。
※ 「admin/admin.cgi」は「admin」ディレクトリの中にあるファイル「admin.cgi」を指します。
「テキストエディタ」が無い場合は、下記のオンラインツールを使用して下さい。
http://sugutsukaeru.jp/cgi/j/36/
admin/admin.cgi を Dreamweaver などのオーサリングツールで編集してしまうとサーバにアップロードした時にエラーが起きる場合があります。また、ファイルを開いた時に文字化けするエディタや警告が表示されるエディタはうまく編集できない場合があります。
適したテキストエディタが無い場合は下記のオンラインツールを使用して下さい。
http://sugutsukaeru.jp/cgi/j/36/
「テキストエディタ」がよく分からない場合は下記ページを参照して下さい。
http://sugutsukaeru.jp/cgi/j/40/
admin/admin.cgi のファイルの1行目に以下のように記載があります。
#!/usr/bin/perl --
「/usr/bin/perl」の部分を、先ほど調べたサーバの「Perlのパス」に変更して下さい。
頭の「#!」と末尾の「 --」は変更せずに残します。「perl」と「--」の間には半角スペースを入れて下さい。
Perlのパスが分らなかった場合は、（エラーが出てから考えることにして）ひとまずそのまま次に進んで下さい。
このままで上手くいく場合もあります。
変更が終わったら上書き保存して下さい。
保存の際の文字コードは Shift_JIS（または CP932 など） にして下さい。
本来ならもう少し設定を変更する必要がありますが、とりあえずテストですので、このままサーバにアップロードすることにします。
これから先の作業には、「FTPソフト」を使用します。
「FTPソフト」がよく分らない場合は、下記のページを参照して下さい。
http://sugutsukaeru.jp/cgi/j/32/
FTPソフトで、設置先のサーバに接続して下さい。
先ほど決めた設置ディレクトリに移動して下さい。
この例では cgi-bin/ に移動します。
設置するディレクトリを作成して下さい。この例では sugu/ ディレクトリに決めたので、sugu という名前でディレクトリを作成します。
作成した sugu/ ディレクトリに移動して下さい。
移動したディレクトリ sugu/ 内に、解凍したファイルに含まれていた以下のディレクトリを中身のファイルごとアップロードして下さい。
（この中には、先に編集した admin/admin.cgi が含まれていることになります。）
admin/
data/
tempfiles/
templates/
webdir/
上記のディレクトリのいくつかだけが無い場合、解凍ソフトに「空のディレクトリがあったら解凍時に自動的に削除する」という設定がしてある可能性があります。
不足のディレクトリがあった場合は手動で作成して下さい。
CGIを動かす前に、「パーミッションの設定」をします。
「パーミッション」についてよく分らない方は、CGIの設定においては「これはプログラム」「これは書き込みファイル」と印を付けていく事だと思って下さい。
パーミッション設定の操作方法が分らない場合は、下記のページを参照して下さい。（「FTPソフト」を使用します。）
http://sugutsukaeru.jp/cgi/j/32/
インストールするサーバの OS が Windows の場合、設定の方法は異なります。サーバのマニュアルを参照するか、管理者に相談して下さい。
社内イントラネット（Windows ドメイン）内で使用する場合で Web サーバが IIS の場合は、権限設定に注意が必要です。
下記ページをご参照の上、管理者ともご相談の上設定を決定して下さい。
http://sugutsukaeru.jp/cgi/j/49/
FTPソフトで admin/ ディレクトリに移動し、admin/admin.cgi に「実行権限」を付けます。（「プログラムである事」の印です。）
先ほど調べたCGIのパーミッションを設定して下さい。
| CGIの パーミッション |
755 | 705 | 700 | 不明 | ||||
|---|---|---|---|---|---|---|---|---|
| admin/admin.cgi の設定 |
755 | rwxr-xr-x | 705 | rwx---r-x | 700 | rwx------ | 700 | rwx------ |
※ CGIのパーミッションを 700 にした場合、以降の設定は不要です。「実行テスト」に進んで下さい。
一つ上のディレクトリ（ sugu/ ）に戻って下さい。data/ ディレクトリに「書き込み権限」を付けます。
CGIに設定したパーミッションによって、以下のように設定して下さい。
| CGIの パーミッション |
755/705 | 700 | 不明 | |||
|---|---|---|---|---|---|---|
| data/ の設定 |
757 | rwxr-xrwx | （設定不要） | （設定不要） | ||
data/ ディレクトリの中に移動して下さい。data/license.dat に「書き込み権限」を付けます。
CGIに設定したパーミッションによって、以下のように設定して下さい。
| CGIの パーミッション |
755/705 | 700 | 不明 | |||
|---|---|---|---|---|---|---|
| data/license.dat の設定 |
646 | rw-r--rw- | （設定不要） | （設定不要） | ||
一つ上のディレクトリ（ sugu/ ）に戻って下さい。webdir/ ディレクトリに「書き込み権限」を付けます。
CGIに設定したパーミッションによって、以下のように設定して下さい。
| CGIの パーミッション |
755/705 | 700 | 不明 | |||
|---|---|---|---|---|---|---|
| webdir/ の設定 |
757 | rwxr-xrwx | （設定不要） | （設定不要） | ||
tempfiles/ ディレクトリに「書き込み権限」を付けます。
CGIに設定したパーミッションによって、以下のように設定して下さい。
| CGIの パーミッション |
755/705 | 700 | 不明 | |||
|---|---|---|---|---|---|---|
| tempfiles/ の設定 |
757 | rwxr-xrwx | （設定不要） | （設定不要） | ||
ここまで設定したら、いよいよ実行テストをします。
サーバにアップロードした admin/admin.cgi のURLをブラウザからリクエストして下さい。
この例の場合、設置したウェブサイトのトップページが http://www.example.co.jp/ だとすると、cgi-bin/ の下に sugu/ を作成してその中に admin/ をアップロードしたのですから、その分のパスを足して http://www.example.co.jp/cgi-bin/sugu/admin/admin.cgi にアクセスします。
「新規登録」のボタンがある管理画面が表示されれば設置成功です。
URLのタイプミスなどが考えられます。もう一度URLを確認して下さい。
admin/admin.cgi のパーミッションがサーバと適合していない可能性があります。
サーバの環境が分らずにパーミッションを 700 に設定した方は、755 に変更してみて下さい。
それ以外の場合と変更してもエラーが解消しない場合は admin/ ディレクトリのパーミッションを 755 にして下さい。
それでもなお「403 Forbidden / 許可されていません」のエラーが出る場合、サーバのマニュアル等を確認して、以下の事をもう一度確かめて下さい。
◆Perlによる CGI が実行可能ですか？ 申し込みや追加の設定は必要ありませんか？
◆CGIを稼動させるディレクトリに制限はありませんか？cgi-bin/ など、CGI用のディレクトリが決まっていたらその場所にアップロードし直して下さい。
◆CGIが実行できるユーザに制限はありませんか？
FTPでアップロードするときのユーザによってCGIの実行可否が決まるレンタルサーバもあります。
もし制限があるようでしたら許可されたユーザでアップロードし直して下さい。
◆拡張子の制限はありませんか？
「.cgi」では稼動できない場合、admin/admin.cgi の拡張子を指定されているものに変更して下さい。
Perl のパスが分らずにそのままアップロードした方は、他の Perl のパスを試してみて下さい。
一般的な Perl のパスは以下の通りです。
◆UNIX 系のOS の場合:
/usr/bin/perl
または
/usr/local/bin/perl
◆Windows の場合：
C:/Perl/bin/perl.exe
それ以外の場合と変更してもエラーが解消しない場合は admin/admin.cgi のパーミッションがサーバと適合していない可能性があります。
サーバの環境が分らずにパーミッションを 700 に設定した方は、755 に変更してみて下さい。
それでもエラーが解消しない場合は admin/ ディレクトリのパーミッションを 755 にして下さい。
それ以外の方や、設定を直したのにまだエラーが出る方は、下記のページをご参照の上設定を再チェックして下さい。
http://sugutsukaeru.jp/cgi/j/33/
CGIファイルの中身がそのまま表示されてしまう場合、サーバの設定上 CGI 実行が有効になっていない可能性があります。
サーバのマニュアル等を確認して、以下の事をもう一度確かめて下さい。
◆Perlによる CGI が実行可能ですか？ 申し込みや追加の設定は必要ありませんか？
◆CGIを稼動させるディレクトリに制限はありませんか？cgi-bin/ など、CGI用のディレクトリが決まっていたらその場所にアップロードし直して下さい。
◆拡張子の制限はありませんか？
CGI ファイルの拡張子を「.pl」などにする必要があるサーバもあります。
これに該当する場合は admin/admin.cgi の拡張子を指定されているものに変更して下さい。
その環境変数 *** の指定がサーバと適合していない可能性があります。
Windows 環境の場合はドライブ名（「C:」など）からの絶対パスでの指定を試して下さい。
絶対パスでの指定の例は「ディレクトリ配置と環境変数の設定例」に記載されています。
Windows 環境以外と変更を行ってもエラーが出る場合は「ディレクトリ配置と環境変数の設定例」を参考に、もう一度設定を見直して下さい。
そのディレクトリ（ *** ）のパーミッション設定がサーバと適合していない可能性があります。
推奨設定が表示されますのでそちらに変更して下さい。
管理画面にアクセスしようとしただけで「エラー 処理の途中でエラーが起きました。」「ロックが取得できませんでした。」という表示が出てしまう場合、data/ ディレクトリのパーミッション設定がサーバと適合していない可能性があります。
data/ ディレクトリには書き込み権限が必要です。
◆UNIX 系のOS の場合:
CGIのパーミッションが 700 の場合 -> data/ は「755」
CGIのパーミッションが 755/705 の場合 -> data/ は「757」
に設定して下さい。
（マニュアルなどで指示がある場合、そちらに沿って下さい。）
◆Windows の場合：data/ ディレクトリに対して、「フルコントロール」や「ネットワークユーザによるファイルの変更を許可する」等の設定を試して下さい。
（サーバ管理者の指示がある場合、そちらに沿って下さい。）
管理画面にアクセスしようとしただけで「エラー 処理の途中でエラーが起きました。」「ライセンス情報の更新に失敗しました。」という表示が出てしまう場合、data/ ディレクトリか data/license.dat のパーミッション設定がサーバと適合していない可能性があります。
どちらにも書き込み権限が必要です。
◆UNIX 系のOS の場合:
CGIのパーミッションが 700 の場合 ->data/ は「755」、data/license.dat は 「644」
CGIのパーミッションが 755/705 の場合 ->data/ は「757」、data/license.dat は 「646」
に設定して下さい。
（マニュアルなどで指示がある場合、そちらに沿って下さい。）
◆Windows の場合：data/ ディレクトリに対して、「フルコントロール」や「ネットワークユーザによるファイルの変更を許可する」等の設定を試して下さい。
（サーバ管理者の指示がある場合、そちらに沿って下さい。）
管理画面にアクセスしようとしただけで「エラー 処理の途中でエラーが起きました。」「ライセンス情報が取得できませんでした。」という表示が出てしまう場合、data/license.dat が壊れてしまっている可能性があります。
data/license.dat ファイルをアップロードし直して下さい。
バイナリモードでアップロードして問題が解消しない場合、テキストモードでのアップロードを試して下さい。
「バイナリモード」や「テキストモード」がよく分からない場合は、下記のページを参照して下さい。
http://sugutsukaeru.jp/cgi/j/32/
上記以外のエラーや上記の対応を行ってもエラーが解消されない場合、サポート情報から該当するエラーを探して修正して下さい。
http://sugutsukaeru.jp/cgi/j/4/
（サポート情報ページでは、エラーメッセージによる検索が可能です。）
管理画面が期待通り表示されたら、登録テストをします。
まず、1件テスト登録をしてみましょう。「新規登録」ボタンを押すと、入力画面が表示されます。
とりあえず、ファイルの添付は後回しにして、テキストのみの登録をしてみます。
表示された入力画面に「タイトル」と「記事内容」だけを入力して登録を進めて下さい。
操作方法の詳細は、「操作マニュアル」を参照して下さい。
入力=>確認画面を経て確定が終わったら、元のページに戻ります。今登録した内容が一覧に表示されるはずです。
新規登録作業中に「エラー 処理の途中でエラーが起きました。」という表示が出てしまう場合、webdir/ または data/ ディレクトリのパーミッション設定がサーバと適合していない可能性があります。
どちらのディレクトリにも書き込み権限が必要です。
◆UNIX 系のOS の場合:
CGIのパーミッションが 700 の場合 -> data/ は「755」、webdir/ も「755」
CGIのパーミッションが 755/705 の場合 -> data/ は「757」、webdir/ も「757」
に設定して下さい。
（マニュアルなどで指示がある場合、そちらに沿って下さい。）
◆Windows の場合：
「フルコントロール」や「ネットワークユーザによるファイルの変更を許可する」等の設定を試して下さい。
（サーバ管理者の指示がある場合、そちらに沿って下さい。）
無事に登録内容の一覧が表示されたら、ファイルが書き出されているかを確認して下さい。
ファイルの書き出しを確認するには、FTPソフトでアップロードした webdir/ に移動します。
以下の名前の 5 つのファイルができていますか？
1.html
index.html
index_short.html
top.html
new.xml
できていれば書き出しも成功です。
（ファイルが見えない場合、表示の再読み込みをしてみて下さい。）
では、書き出されたファイルをブラウザで見てみます。
管理画面の表の一番右の列の「チェック」のリンクを選択して下さい。
入力した内容が表示されましたか？
書き出しページを表示しようとすると「403 Forbidden / 許可されていません」のエラーが出る場合は、 webdir/ のパーミッションを「755」にして下さい。
上記の設定を直してもなお「403 Forbidden / 許可されていません」のエラーが出る場合、ディレクトリの構成を変更する必要があります。下記ページの方法で修正して下さい。
http://sugutsukaeru.jp/cgi/j/35/
書き出しページを表示しようとして「500 Internal Server Error / サーバエラー」のエラーが出る場合は、ディレクトリの構成を変更する必要があります。下記ページの方法で修正して下さい。
http://sugutsukaeru.jp/cgi/j/35/
環境変数 $conf{relative_web_dir} の設定がサーバと適合していない可能性があります。
以下のいずれかに該当する場合は、「ディレクトリ配置と環境変数の設定例」を参照して $conf{relative_web_dir} の設定を修正して下さい。
◇$conf{relative_web_dir} の設定を変更している
◇$conf{web_dir} を絶対パスで指定している
◇CGI用のディレクトリとHTML用のディレクトリが分かれている
内容が表示された方は、一旦表示されたページを閉じて、記事一覧の上部の「編集結果をチェック： [一覧]」のリンクを選択して下さい。
目次となる「全一覧」が表示されます。（今はまだ1件しか登録されていません。）
「全一覧」に表示されているタイトルのリンクを選択すると、先ほどの記事ページにリンクします。
「全一覧」からのリンクも確認できたら、管理画面の「編集結果をチェック： [短い一覧]」から短い一覧の表示も確認して下さい。
「編集結果をチェック： [最新]」のリンクは top.html にリンクしています。内容は、今は先ほど確認した記事ページと同じです。
「編集結果をチェック： [RSS]」のリンクは RSS ファイルにリンクしています。RSSに対応しているブラウザ かRSSリーダーがあれば内容を確認して下さい。
テキストのみの登録が無事できたら、今度は添付ファイルも登録してみます。
管理画面の一覧から「新規登録」ボタンを押し、入力画面を表示して下さい。
「タイトル」と「記事内容」の入力の他、「添付ファイル」欄のボタンから、アップロードするファイルを選択して下さい。
操作方法の詳細は、「操作マニュアル」を参照して下さい。
ファイル選択フィールドは3つありますが、とりあえず1つのみ添付して下さい。
「リンクテキスト」欄には何も入力しなくて構いません。
ファイルの選択が終わったら「確認画面へ」ボタンを押して下さい。
確認画面が表示され、入力したテキストの内容の他、アップロードしたファイルの情報が表示されていますか？
うまくいく場合、以下の3要素が「添付ファイル」欄に表示されます。
◇ファイルのアイコン
◇ファイルへのリンク
◇カッコ内にファイル名
ファイルへのリンクから今アップロードしたファイルがダウンロードできる事も確認して下さい。
「確認画面へ」ボタンを押すと「エラー 処理の途中でエラーが起きました。」という表示が出る場合、tempfiles/ のパーミッションがサーバと適合していない可能性があります。
tempfiles/ ディレクトリには書き込み権限が必要です。
◆UNIX 系のOS の場合:
CGIのパーミッションが 700 の場合 ->「755」
CGIのパーミッションが 755/705 の場合 ->「757」
に設定して下さい。
（マニュアルなどで指示がある場合、そちらに沿って下さい。）
◆Windows の場合：
「フルコントロール」や「ネットワークユーザによるファイルの変更を許可する」等の設定を試して下さい。
（サーバ管理者の指示がある場合、そちらに沿って下さい。）
設定を変更したら、一旦一覧画面に戻りもう一度入力から行って下さい。
「確認画面へ」ボタンを押すと「エラー リクエスト取得時にエラーが起きました。」という表示が出る場合、添付ファイルの保存がうまくいっていない可能性があります。
◆全ての環境で:
添付ファイルの容量が大きすぎるとこのエラーが起きる場合があります。
大きな添付ファイルを添付している場合、まず小さな容量の添付ファイルをアップロードしてみて下さい。
（製品の docs/img/ ディレクトリにアイコン画像があるのでそれで試して下さい。）
◆Windows でエラーメッセージに「( CGI open of tmpfile: Permission denied )」と表示されている場合：admin/ ディレクトリに「書き込み権限」を付けて下さい。
「書き込み権限」だけではうまくいかない場合、「フルコントロール」や「ネットワークユーザによるファイルの変更を許可する」等の設定を試して下さい。
（サーバ管理者の指示がある場合、そちらに沿って下さい。）
いずれの場合も一旦一覧画面に戻り、もう一度入力から行って下さい。
設定を直してもうまくいかない場合、サーバ管理者に以下の点を相談して下さい。
「Perl の CGI.pm を利用してアップロードしたファイルを保存しようとしたところ、テンポラリディレクトリの書き込み権限が無いためエラーになっている模様。何か解決策は無いか。」
添付ファイルを選択して「確認画面へ」ボタンを押すと「500 Internal Server Error」や「サーバエラー」という表示が出る場合まず、添付ファイルを選択しなければ正常に登録が進められるかを試して下さい。
添付ファイルの選択なしで登録がうまく進む場合、エラーが出た場合とは別の拡張子の添付ファイルを選択して登録を進めて下さい。その際、なるべく容量の小さな添付ファイルをいくつか試して下さい。
◆うまくいく添付ファイルがある場合
もしうまく登録が進む拡張子の添付ファイルがある場合、以下の変更を行って下さい。
（Ver. 3.1 以上では予めこの変更がされている場合もあります。）
１．admin/admin.cgi の1行目末尾の「-w」を「--」に変更
変更前例） #!/usr/bin/perl -w
↓
変更後例） #!/usr/bin/perl --
２．変更したファイルを上書きアップロード
設定を変更したら、一旦一覧画面に戻り、もう一度入力から行って下さい。
ファイル名等は表示されるがファイルのアイコンが表示されない場合、webdir/ 内に icons/ ディレクトリがあるか確認して下さい。
無ければ webdir/ 内に icons/ ディレクトリをディレクトリごとアップロードして下さい。
webdir/ 内に icons/ ディレクトリがあるのに表示ができない場合は、以下の通りパーミッションを設定して下さい。
◆webdir/ -> 「755」
◆webdir/icons/ -> 「755」
◆webdir/icons/ の中の画像ファイル -> 「644」
設定を変更したら、「中止（一覧に戻る）」ボタンを押して一覧画面に戻りもう一度入力から行って下さい。
上記の設定を直してもなおアイコンが表示できない場合、admin/admin.cgi 内の環境変数 $conf{relative_web_dir} の設定がサーバと適合していない可能性があります。
以下のいずれかに該当する場合は、「ディレクトリ配置と環境変数の設定例」を参照して $conf{relative_web_dir} の設定を修正して下さい。
◆$conf{relative_web_dir} の設定を変更している
◆$conf{web_dir} を絶対パスで指定している
◆CGI用のディレクトリとHTML用のディレクトリが分かれている
上記に該当しない場合や設定を直してもなおアイコンの表示ができない場合、ディレクトリの構成を変更する必要があります。下記ページの方法で修正して下さい。
http://sugutsukaeru.jp/cgi/j/35/
エラーメッセージが出て入力画面に戻ってしまう場合、指示が出ている場合はそれに沿って修正して下さい。
「*** の保存に失敗しました。(xxx: ooo) 処理を中断しました。」と表示されている場合、ファイル名と環境の組み合わせ（相性）の問題で添付ファイル保存に失敗しています。
日本語（全角文字）が含まれるファイルは環境と製品の文字コードの組み合わせによって利用できない場合があります。
通常はファイル名を半角英数字にすることによって問題が解消しますので、ファイル名は半角英数字に変更し、日本語でのリンクが必要な場合はリンクテキストで日本語を指定して下さい。
なお、お使いの「すぐ使えるCGI」製品が Ver. 3.1 以下の場合の場合は Ver. 4.2 以上へのバージョンアップで問題が解消する事があります。
Ver. 4.2 では以下の環境での問題に一部対応済みですので、該当の場合はバージョンアップして下さい。
◆サーバ OS が Windows ＋ 「すぐ使えるCGI」Ver. 3.1 以下の EUC-JP 版
◆サーバ OS が Windows ＋ 「すぐ使えるCGI」Ver. 3.1 以下の UTF-8 版
◆サーバ OS が Mac OS X ＋ 「すぐ使えるCGI」Ver. 3.1 以下の Shift_JIS 版
◆サーバ OS が Mac OS X ＋ 「すぐ使えるCGI」Ver. 3.1 以下の EUC-JP 版
確認画面にファイル名等は表示されるがリンクをクリックしてもファイルがダウンロードできない場合、問題が起きている添付ファイルが日本語ファイル名のものであれば、ファイル名が半角英数字のファイルを添付してみて同じ問題が起きるかをまず試して下さい。
半角英数字のファイルは問題なくダウンロードできる場合、次の「日本語ファイル名のファイルがダウンロードができない場合」を参照して下さい。
半角英数字のファイルでもダウンロードできない場合は、以下の対応を試して下さい。
tempfiles/ のパーミッションの設定を 755 にして下さい。
設定を変更したら、「中止（一覧に戻る）」ボタンを押して一覧画面に戻り、もう一度入力から行って下さい。
上記の設定を直してもなおファイルのダウンロードができない場合、admin/admin.cgi 内の環境変数 $conf{relative_file_dir} の設定がサーバと適合していない可能性があります。
以下のいずれかに該当する場合は、「ディレクトリ配置と環境変数の設定例」を参照して $conf{relative_file_dir} の設定を修正して下さい。
◆$conf{relative_file_dir} の設定を変更している
◆$conf{file_dir} を絶対パスで指定している
◆CGI用のディレクトリとHTML用のディレクトリが分かれている
上記の設定を直してもなおファイルのダウンロードができない場合、ディレクトリの構成を変更する必要があります。下記ページの方法で修正して下さい。
http://sugutsukaeru.jp/cgi/j/35/
確認画面にファイル名等は表示されるがリンクをクリックしてもファイルがダウンロードできない場合、以下の条件に当てはまる場合は、ファイル名は半角英数字にしてリンクテキストで日本語を指定して下さい。
◆以下の条件に全て当てはまる場合
- サーバの OS が Windows
- ウェブサーバが Apache
- 日本語名のファイルを添付している
これ以外の場合でファイルがダウンロードできない場合、ご利用の「すぐ使えるCGI」のバージョンが Ver. 3.1以下 であれば Ver. 4.2 以上へのバージョンアップで問題が解消する場合があります。この場合はバージョンアップをお試し下さい。
一部の日本語ファイル名だけが文字化けする場合、環境によって原因が異なります。
以下に該当するものがあれば対応を行って下さい。該当すると思われる環境が無い場合や、対応を行っても問題が解消しない場合、ファイル名は半角英数字にしてリンクテキストで日本語を指定して下さい。
◆サーバの OS が Windows で Perl のバージョンが 5.6.x の場合
Perl のバージョンアップ（5.8.x または 5.10.x）をお試し下さい。
◆ブラウザが Opera、Safari、Netscape の場合
別のブラウザをご利用下さい。
◆サーバの OS が Mac OS X で「すぐ使えるCGI」のバージョンが Ver. 3.1 以下の場合
「すぐ使えるCGI」を Ver 4.2 以上にバージョンアップして下さい。
Office 2007 のファイル（.docx, .xlsx, .pptx）が ZIP ファイルとしてダウンロードされてしまい対応するアプリケーションで開けない場合、Webサーバの設定を変更する必要があります。
サーバ管理者に以下の点をご相談下さい。
◆拡張子 .docx 、.xlsx 、.pptx の MIME タイプを「application/vnd.openxmlformats」に設定してほしい。
設定例など詳しい情報は下記ページをご参照下さい。
http://sugutsukaeru.jp/cgi/j/48/
確認画面が無事表示されたら、今度は確定を行います。「確定」ボタンを押して下さい。
登録が確定すると、一覧画面に戻ります。今登録した内容が一覧に表示されるはずです。
ファイルを添付しての確定時に「エラー 処理の途中でエラーが起きました。」という表示が出てしまう場合、tempfiles/ のパーミッションがサーバと適合していない可能性があります。
tempfiles/ には書き込み権限が必要です。
◆UNIX 系のOS の場合:
CGIのパーミッションが 700 の場合 ->「755」
CGIのパーミッションが 755/705 の場合 ->「757」
に設定して下さい。
（マニュアルなどで指示がある場合、そちらに沿って下さい。）
◆Windows の場合：
「フルコントロール」や「ネットワークユーザによるファイルの変更を許可する」等の設定を試して下さい。
（サーバ管理者の指示がある場合、そちらに沿って下さい。）
無事に一覧が表示されたら、ファイルが書き出されているかを確認して下さい。
FTPソフトでアップロードした webdir/ に移動します。
先ほど作成されたファイルの他に、「2.html」というファイルと「2」という名前のディレクトリができているはずです。
（ファイルが見えない場合、表示の再読み込みをしてみて下さい。）
2/ ディレクトリの中には、アップロードしたファイルが保存されていますので、これも確認して下さい。
先ほどと同じように、書き出されたファイルをブラウザで見てみます。
一覧から、ファイルを添付した記事の一番右の列の「チェック」のリンクを選択して下さい。
入力した内容とファイルへのリンクが表示されましたか？
リンクからファイルがダウンロードできることを確認して下さい。
表示が確認できたら、「編集結果をチェック： [一覧] [短い一覧]」から、一覧にも2件目の記事が登録された事を確認して下さい。
表示が変わらない場合、再読み込みをして下さい。
「編集結果をチェック： [最新]」のリンクから表示される記事は、ファイル名は「top.html」と先ほどと変わりませんが、内容は後から登録した記事に書き換わります。
表示が変わらない場合、再読み込みをして下さい。
添付ファイルのリンクテキスト設定機能を試します。
管理画面の一覧から、先ほど添付ファイルを登録した、2番目の登録記事の「編集」ボタンを押して下さい。
入力画面が開きます。
「添付ファイル」欄には先ほど登録したファイルが表示されています。
先ほど登録したファイルの下の「リンクテキスト」欄には、ファイル名がそのまま表示されています。
この欄を変更すると、ファイルにリンクするテキストを変更することができます。
「参考資料」等に変更して、「確認画面へ」ボタンを押して下さい。
確認画面の「添付ファイル」欄では、今設定したテキスト「参考資料」からファイルにリンクしています。
確認画面での表示を確認したら、「確定」ボタンを押して下さい。
一覧画面に戻ります。
先ほどと同じように、書き出されたファイルをブラウザで見てみます。
一覧から、ファイルを添付した記事の一番右の列の「チェック」のリンクを選択して下さい。
今度はファイル名の代わりに「参考資料」というリンクでファイルが表示されましたか？
表示が変わっていなかったら、ページを再読み込みして下さい。
添付ファイル追加と順番の設定機能を試します。
管理画面の一覧から、再度先ほど添付ファイルを登録した2番目の登録記事の「編集」ボタンを押して下さい。
入力画面が開きます。
「添付ファイル」欄には先ほど編集したファイルに加えて、新しい添付ファイル用のフィールドが3つ表示されています。
新しい添付ファイル用のフィールドから、もう一つ添付ファイルを選択して下さい。
選択したファイルのフィールドの右にある「上へ」ボタンを押すと、ファイル選択フィールドと既存のファイルの表示順が入れ替わります。
JavaScript が機能していない場合や、Netscape Navigator 4.x などの旧いブラウザではファイルの順番のコントロールができません。
JavaScript 有効にしたり、新しいブラウザを使用して下さい。
新しく添付したファイルにもリンクテキストが指定できます。
ファイル選択フィールドの下にある「リンクテキスト」欄に入力して下さい。
既存ファイルのリンクテキストも同時に変更できますので、「参考資料１」「参考資料２」等で区別して下さい。
「確認画面へ」ボタンを押して確認画面を表示させて下さい。
設定した順番でファイルが表示されます。
「確定」ボタンを押した後、「チェック」のリンクから書き出しファイルにもファイル順の設定が反映されている事を確認して下さい。
（変更されていなかった場合、ページを再読み込みして下さい。）
今度はページ間リンク機能の確認をします。
記事が1件しか登録されていない場合、テスト用に2件目の登録をして下さい。
2件目の記事を「チェック」のリンクから見てみます。
「次へ→」というリンクが表示されているはずです。このリンクを選択すると、一つ旧い記事、つまり1件目の記事が表示されます。
1件目の記事には最初にチェックした時には無かった「←前へ」というリンクが追加されています。これは、一つ新しい記事、つまり2件目の記事にリンクしています。
（1件目の記事にリンクが追加されていなければ、ページを再読み込みして下さい。）
3番目の記事を登録してみてください。
登録後、一覧には以下の順番で表示されているはずです。
・3件目の記事
・2件目の記事
・1件目の記事
ここで、2件目の記事の「チェック」のリンクから、記事のページを表示して下さい。
表示が変わっていなければ、ページの再読み込みをして下さい。
先ほどは無かった「←前へ」のリンクが追加され、3件目の記事に移動できるようになっています。
「次へ→」のリンクは、前と同じように1件目の記事にリンクしています。
このように、ページ間リンクは自動更新されます。
管理するサイトのデザインに合わせてテンプレートファイルを修正します。
HTML または XHTML コードであれば、どのようなカスタマイズも可能です。
詳しくは「デザイン変更チュートリアル」を参照して下さい。
テストが終わって継続利用を決めた場合、設定を少し本番運用らしく変更する必要があります。
以下の設定を行って下さい。
webdir/ は、通常のHTMLファイルが配置される位置に変更して下さい。
例えば、ウェブサイトのトップディレクトリの下に ir/ というディレクトリを新設してそこに書き出す、などです。
テスト中のディレクトリ配置
/ (ルートディレクトリ)
|-- public_html/
|-- cgi-bin/
|-- sugu/
|-- admin/
|-- data/
|-- tempfiles/
|-- templates/
|-- webdir/ ←このディレクトリを移動する
|-- icons/
本番用のディレクトリ配置（例）
/ (ルートディレクトリ)
|-- public_html/
|-- cgi-bin/
| |-- sugu/
| |-- admin/
| |-- data/
| |-- tempfiles/
| |-- templates/
|
|-- ir/ ←代わりに作成したディレクトリ
|-- icons/
以下の手順でディレクトリの変更を行って下さい。
ディレクトリ移動の作業の前に、管理画面からテストで登録したデータを全て削除して下さい。
FTPソフトでサーバに接続し、新しい書き出しディレクトリを作成して下さい。お好きな場所、名前で構いません。
（上の例の配置だと public_html/ の下に ir/ を作成します。）
作成したディレクトリ（上記例だと ir/ ）に webdir/ と同じパーミッションを設定して下さい。（FTPソフトで行います。）
作成したディレクトリ（上記例だと ir/ ）に、webdir/ 内にあった icons/ ディレクトリをディレクトリごとアップロードして下さい。
テキストエディタで admin/admin.cgi を開き、125 行目付近の $conf{web_dir} と 140 行目付近の $conf{relative_web_dir} の部分を、新しく作成したディレクトリに合わせて変更して下さい。
変更前
#--------------------------------------------------------[line 125]--
# ファイル書き出しウェブディレクトリ
#--------------------------------------------------------------------
# このディレクトリは、通常 Web コンテンツが格納されているディレクトリ
# のどこかになります。
# 相対パスでも絶対パスでも指定できます。
# Windowsで稼動させる場合、絶対パスでないとアクセスできない場合があり
# ます。
# 変更した時は $conf{relative_web_dir} の設定も必ず見直して下さい。
$conf{web_dir} = '../webdir/';
#--------------------------------------------------------[line 140]--
# （$conf{web_dir} を変更したら同時に変更）
#--------------------------------------------------------------------
# admin/admin.cgi からファイル書き出しウェブディレクトリ
# （ $conf{web_dir} ）へのURL 上のパスを指定します。
# 相対パスか、ウェブサーバのトップ階層からの絶対パスで指定します。
$conf{relative_web_dir} = '../webdir/';
変更後（上記例のディレクトリ配置の場合）
#--------------------------------------------------------[line 125]--
# ファイル書き出しウェブディレクトリ
#--------------------------------------------------------------------
# このディレクトリは、通常 Web コンテンツが格納されているディレクトリ
# のどこかになります。
# 相対パスでも絶対パスでも指定できます。
# Windowsで稼動させる場合、絶対パスでないとアクセスできない場合があり
# ます。
# 変更した時は $conf{relative_web_dir} の設定も必ず見直して下さい。
$conf{web_dir} = '../../../ir/';
#--------------------------------------------------------[line 140]--
# （$conf{web_dir} を変更したら同時に変更）
#--------------------------------------------------------------------
# admin/admin.cgi からファイル書き出しウェブディレクトリ
# （ $conf{web_dir} ）へのURL 上のパスを指定します。
# 相対パスか、ウェブサーバのトップ階層からの絶対パスで指定します。
$conf{relative_web_dir} = '/ir/';
編集済の admin/admin.cgi をFTPソフトでサーバの今までと同じ位置にアップロードして下さい。
再び新規登録作業を行い、今度は、新しく設定したディレクトリ内にファイルが作成され、ブラウザでも表示できる事を確認して下さい。
もとの webdir/ と中のファイルは不要になりますので、FTPソフトで削除して下さい。
最初にテスト用ディレクトリに決めた sugu/ はこのままでも運用できますが、admintool/ や manage/ 等に名前を変更すると、運用の時に誤解を生じにくくなります。
必要に応じて、ディレクトリ名をFTPソフトで変更して下さい。
テスト中のディレクトリ名
/ (ルートディレクトリ)
|-- public_html/
|-- cgi-bin/
| |-- sugu/ ←テスト中のディレクトリ名
| |-- admin/
| |-- data/
| |-- tempfiles/
| |-- templates/
|
|-- ir/
|-- icons/
本番用のディレクトリ名（例）
/ (ルートディレクトリ)
|-- public_html/
|-- cgi-bin/
| |-- admintool/ ←本番運用らしいディレクトリ名
| |-- admin/
| |-- data/
| |-- tempfiles/
| |-- templates/
|
|-- ir/
|-- icons/
管理画面はむやみと一般の方にアクセスされないようにアクセス制限の設定をします。
サーバの Basic認証機能を利用してアクセス制限（パスワード認証）を掛けて下さい。
お使いのサーバで Basic 認証機能が利用できない場合、環境変数でパスワードの設定をして下さい。
詳しい設定方法は「変更できる環境変数」の「管理画面パスワードの設定」を参照して下さい。
設定を行ったら、必ずログイン機能が有効になった事を確認して下さい。
Basic認証の設定方法はご利用中のサーバによって違いますので、詳細はレンタルサーバ会社やサーバ管理者に問い合わせて下さい。
「基本認証」「アクセス制限」や「会員制ウェブ管理」等の名称で、管理メニューがある場合もあります。
製品をアップロードしたディレクトリ（最初の sugu/ 、名前を変更した場合 admintool/ など）には必ずアクセス制限をかけて下さい。
もちろん、ファイル書き出しディレクトリ（元の webdir/ ）はもうこのディレクトリ内には無いことが前提です。
（せっかく書き出したファイルにアクセス制限が掛かってしまいます。）
Basic認証の設定例
/ (ルートディレクトリ)
|-- public_html/
|-- cgi-bin/
| |-- admintool/ ←このディレクトリにアクセス制限を掛ける
| |-- admin/
| |-- data/
| |-- tempfiles/
| |-- templates/
|
|-- ir/
|-- icons/
ディレクトリの配置や書き出しのファイル名は変更できます。
設定方法は「変更できる環境変数」を参照して下さい。
本番運用を行う場合、ライセンスをご購入の上発行されるライセンスキーを製品に登録して下さい。
※ 複数の場所に設置する場合、それぞれにライセンスが必要です。
管理画面のフッタの「ライセンス情報・ライセンスキー登録」のリンクを選択し「ライセンス情報」ページを表示して下さい。
ページの上方にある「支払情報の確認・ライセンスの購入」ボタンを押して下さい。（インターネットに接続できる環境で作業して下さい。）
「すぐ使えるCGI」サイトにアクセスし、価格と製品名、選択できるお支払方法が表示されます。
管理画面を表示している環境から直接インターネットに接続できない場合は、接続できる環境から下記URLにアクセスして下さい。
http://sugutsukaeru.jp/cgi/j/12/
表示される製品に間違いがないかをご確認下さい。
購入するライセンス数を指定し、価格を確認して下さい。
表示される画面の指示に添って、お支払情報を送信して下さい。
選択するお支払方法によって、フォームの操作が異なります。
選択できるお支払方法の最新情報、詳しい操作方法は下記のURLをご参照下さい。
http://sugutsukaeru.jp/cgi/j/11/
銀行振込を選択された場合、合計金額を記載した確認メールが自動送信されます。
金融機関でお振込手続きを行って下さい。
銀行振込の場合、お支払確認後、メールでライセンスキーをお送りします。
それ以外のお支払方法（クレジットカード、月次請求書決済、バルク継続契約）の場合、購入フォームからのお手続きが完了すると即時ライセンスキーをメールでお送りします。
管理画面から、メールで送信されたライセンスキーの登録を行って下さい。
管理画面のフッタのリンクから「ライセンス情報」のページを表示して下さい。
「ライセンスキー」欄にメールで送信されたライセンスキーを入力して下さい。
コピー＆ペーストすると簡単です。
「登録」ボタンを押すと、ライセンスキー登録が完了します。
ライセンスキー登録後は、書き出しページに追記されていた製品情報が書き出されなくなります。
既に登録されている記事がある場合は、管理画面の一覧の下にある「再構築（テンプレート変更反映）」ボタンを押して下さい。
最新の情報を反映して全ページが書き出されます。
書き出しページの製品情報が消えない場合、管理画面一覧の下にある「再構築（テンプレート変更反映）」ボタンを押して記事を書き出してからページの再読み込みをして下さい。
管理画面のフッタの製品情報は、ライセンスキー登録を行っても表示されます。
この表示を隠すには、管理画面テンプレートのスタイルシート（CSS）を編集して下さい。
詳しい解説は、下記URLのサポート情報をご参照下さい。
http://sugutsukaeru.jp/cgi/j/37/
ライセンスキー登録後に設置場所を移動する場合はファイルの移動作業の他に「ライセンス移動」のお手続きをお願い致します。
なお、「設置場所の移動」は以下のようにディレクトリ名の変更等も含みます。
・テストサイトで稼働確認とライセンスキー登録を行った後に本番サーバに移行する
・1箇所での使用を止めて別の場所に設置する
・ライセンスキー登録後にURLを変更する（ディレクトリの変更など）
・ライセンスキー登録後に http から https に変更する（逆も）
詳しい方法は「設置場所の移動方法」をご参照下さい。