さんごよみのセットアップ方法は、ダウンロードしたZIPファイル（※ダウンロードはさんごよみ公式TOPページから）を展開して、出てきたファイルをWebサーバの任意の場所にアップロードして、下表に記したパーミッション(アクセス権/属性)に設定するだけです。

CGIの簡単セットアップ手順

セットアップ手順は下記の3ステップだけです。

1. 必要に応じて sangoyomi.cgi 内の1行目を書き換える。（※書き換える必要がない場合も多くあります。）
2. 全ファイルを同一のディレクトリ下にアップロードする。
3. パーミッション(属性値)を指定通りに設定する。

これだけで動作します。

設置手順1：CGIファイル1行目を(必要に応じて)書き換える

最近のウェブサーバなら、おそらく特に何も書き換えずにそのままアップロードするだけで動くことが多いです。

なので、まずは何も書き換えずに「設置手順2」へ進んで下さい。

もし、最終的に（設置手順3の後で）「500 Internal Server Error」が出るようなら、 CGIソースの1行目にある #! /usr/bin/env perl の記述を、例えば #! /usr/bin/perl や #! /usr/local/bin/perl などに書き換える必要があります。 その場合は、sangoyomi.cgi をテキストエディタで開いて、1行目をサーバ会社が指定する通りに書き換えて下さい。

設置方法2：ウェブサーバへのファイルのアップロード方法

説明用の「README.TXT」ファイルを除くすべてのファイルを任意のディレクトリ^※1にアップロードして下さい。
サブフォルダ（サブディレクトリ）の存在は必須ではありませんが、UPする場合はフォルダ構造(階層構造)を維持したままアップロードして下さい。

アップロードする際、お使いのFTPソフトに転送モードの設定がある場合は、

• CGIソースを書き換えずにUPするなら「バイナリモード」にする方が無難です。
• CGIソースを編集してからUPするなら「アスキーモード(テキストモード)」にする方が無難^※2です。

設置方法3：パーミッションの設定

アップロードしたファイルのパーミッション(アクセス権/属性)を下表のように設定して下さい。

お使いのウェブサーバで「suEXEC」という安全な仕組みが有効になっている場合は「suEXEC」側の値を設定しないと動かない可能性があります。
お使いのサーバの仕様が分からない場合は、下記の3ステップの考え方で試してみて下さい。

1. まず、「suEXEC」の方の値に設定してみて下さい。それで動けばそのままお使い頂けます。
2. もし動かなかったり不都合がある場合は、次に「一般の場合」の 705 や 604 のように真ん中がゼロの値を設定してみて下さい。それで動けばそのままお使い頂けます。
3. それでも動かない場合は、「一般の場合」の 755 や 644 の方の値を設定してみて下さい。

※備考：さくらインターネット、ロリポップ、リトルサーバーでは、suEXECの方に設定すれば良いです。

ファイル名	パーミッション		補足
	suEXEC※A	一般の場合※B
▼プログラムファイル
sangoyomi.cgi	700	705 (755)	メインCGI （これを実行します） ※0
fumycts.pl	600	604 (644)	補助プログラム （メインCGIから呼び出されます）
▼データファイル（CGIによって書き換えられるファイル）
data-schedule.xml	600	606 (666)	スケジュール記録用ファイル（CGIによって編集されます） ※1,2
data-weekly.dat			週間予定表の記録用ファイル（CGIによって編集されます） ※1,3
data-longterm.xml			長期予定表の記録用ファイル（CGIによって編集されます） ※1,2
sangoyomi.ini			設定記録用ファイル（CGIによって編集されます） ※1,4
psif.cgi			パスワード・セッションID格納ファイル（CGIによって編集されます） ※1,5
▼表示HTML関連ファイル
skin-cover.html	604 644 ※たぶんデフォルトのままで可		表示用スキンファイル（テンプレートHTMLファイル：全体用） ※1
skin-oneday.html			表示用スキンファイル（テンプレートHTMLファイル：一日用） ※1
sangoyomi.css			表示用スタイルシートファイル ※1,6
▼サブディレクトリ（※設置は任意）
backup	705	707 (777)	自動バックアップファイルが蓄積されるディレクトリ ※7
images	705	707 (777)	投稿画像ファイルが蓄積されるディレクトリ ※7

※A：suEXECという安全な仕組みが採用されているサーバでは、こちらの値を設定しないと正しく動かない場合があります。（特にディレクトリの値を「一般の場合」にはしないようご注意下さい。）
※B：ウェブサーバのヘルプをご参照頂き、サーバ側が要求する（推奨する）値があればそれに設定して下さい。そのような情報がないか分からない場合は、まずは「705」や「604」のように真ん中がゼロの値にしてみて下さい。それで支障がある場合には、「755」や「644」などの（真ん中がゼロではない）値の方をお試し下さい。

※0：ファイル名を「index.cgi」に変更しても動作可能ですが、それよりは .htaccessファイルを使って「sangoyomi.cgi」を省略してアクセス可能にする方法の採用がお勧めです。
※1：ファイル名は自由に変更可能です。（ファイル名の変更内容は sangoyomi.cgi 内に反映させる必要があります。よく分からない場合はデフォルトのままご使用下さい。）
※2：ファイル拡張子は.xml以外に変更しても構いません。（記録形式はXMLです。）
※3：ファイル拡張子は.dat以外に変更しても構いません。（記録形式は独自の形式です。）
※4：ファイル拡張子は.ini以外に変更しても構いません。（記録形式はINIベースの独自仕様です。）
※5：ファイル拡張子は.cgi以外でも構いませんが、外部から閲覧されるのを防ぐために「.cgi」にしてあります。他の拡張子に変更する場合は、.htaccessファイルなどを使って中身が閲覧されないように設定しておく方が無難です。ログイン用のパスワードを忘れてしまった場合は、このファイルの中身を空っぽにして再度アップロードすると、無条件ログインが可能になります。
※6：ファイル拡張子は.cssでなければなりません。
※7：このディレクトリには「書き込み権限」の付与が必須です。（※サーバでsuEXECが使われている場合は、705等の一般的な値のままで正しく動作します。逆に、777などに設定すると動かなくなります。）

➡ ここまで完了したら、もう動作するハズです。

CGIをバージョンアップする方法

以前のバージョンをお使いの場合は、sangoyomi.cgi と fumycts.pl の2つのファイルのみを上書きアップロードして下さい。
それ以外のファイルをアップロードする必要はありません。

特に、データファイルを上書きしてしまうと、過去のデータが消えてしまいますので、くれぐれもご注意下さい。

※データの互換性について

データファイルはそのままの状態で、CGIを最新版に更新するだけで使い続けられます。

※Ver 1.x系から Ver.2系 へのアップグレード時でも、データファイルや設定ファイルはそのまま引き継げます。

※スキンの更新について

もし、配布されているスキンをそのまま利用している場合は、スキンファイル群も同時に上書きアップロードすれば、新しく加わった表示機能を簡単に活用できます。 スキンをカスタマイズして使っている場合は、上書きアップロードはしないようご注意下さい。その際は、新パッケージに含まれるスキンHTMLやCSSの中身を別途ご覧になりつつ既存スキンを編集すると、カスタマイズしやすいでしょう。

※データが失われてしまった場合は自動バックアップから復元

もし自動バックアップ機能を有効にしている場合は、バックアップ蓄積ディレクトリの中に、直前までのデータファイル（月間カレンダー用データのみ）が存在します。 データが失われてしまった際には、バックアップ蓄積ディレクトリの中にある最新日付のファイルをダウンロードして、ファイル名を変更し、CGIと同じディレクトリにアップロードすれば（バックアップされた時点のデータが）回復します。

さんごよみCGIは、同一サーバ内にでも必要なだけ複数個設置して使えます。 ただし、それぞれのCGIで別個にログイン状態を維持するためには、管理画面からの設定が必要な場合があります。

CGIを複数併用する場合の設置場所

1つ1つを異なるディレクトリにアップロードして下さい。例えば以下のような感じです。

• さんごよみ1つ目： https://www.example.com/sangoyomi/
• さんごよみ2つ目： https://www.example.com/sangoyomi2/
• さんごよみ3つ目： https://www.example.com/sangoyomi-extra/

ディレクトリ名は何でも構いません。要は、「1つのさんごよみ＝1ディレクトリ」で構成されていれば問題ありません。

CGIを複数併用する場合の設定

さんごよみCGIを複数個設置する場合で、それぞれのCGIを新規にセットアップしたなら、以下の設定は（ほとんどの場合で）不要です。

しかし、「既に稼働しているさんごよみCGI」の全構成ファイルをコピーする方法で2つ目のCGIを設置した場合(※1)には、以下の設定を手動で行う必要があります。

▼共存のために必要な設定

管理画面の「設定」→「システム設定」→「ログイン維持設定」区画内にある『このCGI固有の識別文字列』項目に入力されている数文字の英数字を、他のCGIと重複しない文字列に変更して下さい。 文字数に制限はありませんが、Cookieの接尾辞に使われますので、5文字前後くらいにしておくのが無難だと思います。

《▼なぜこの設定が必要か？》

さんごよみCGIのログイン状態は、ブラウザのCookieを利用して維持されます。 同一サーバ内に設置するCGIで、もし同じCookie名を流用してしまうと、1つのドメインにつき1つのログイン状態しか維持できません。 そのため、どれか1つにログインすると、他のすべてのログイン状態は解除されてしまいます。

それを防ぎ、すべてのCGIで個別にログイン状態を維持できるように、別々のCookieを発行してログイン状態を維持できる仕様になっています。 それぞれのCGIを別個に識別する目的で異なるCookie名を利用するために、1つ1つのCGIで異なる識別文字列が必要です。 （入力した識別文字列がそのままCookie名になるわけではなく、ベースのCookie名に付加される接尾辞として使われます。）

その識別文字列を設定するのが、『このCGI固有の識別文字列』項目です。

▼設定値を変更した際の注意

設定で「このCGI固有の識別文字列」項目を書き換えるたびに、認証状態を保持するCookie名が変わるため、全ユーザが自動ログアウトされてしまいますのでご注意下さい。 （それぞれのユーザが再度ログインすれば、それ以後はまたログイン状態を維持できます。）

▼識別文字列を共有するメリットはありません

同じ識別文字列を指定しても、IDやパスワードを共用できるわけではありません。 同じ識別文字列を指定しても、不便になるだけでメリットは何もありません。

複数のCGIを識別しやすくする支援機能

さんごよみCGIを複数個設置しているときに、それぞれを区別しやすくする方法を2つ用意しています。

▼カラーテーマを変更する機能

管理画面の配色(カラーテーマ)を切り替える機能があり、下記の7テーマから選択できます。 複数のさんごよみCGIを併用する際に、どれを使っているのか迷わないよう色分けする用途にもご活用頂けます。 あくまでも管理画面のUI配色を選択するだけであって、ページの表示（スキン）には一切影響しません。

設定箇所は、管理画面の[設定]→システム設定→【管理画面内の表示】→『カラーテーマ』項目です。

さんごよみCGIを使うのをやめる場合には、特別な操作は必要ありません。単に削除すれば良いだけです。始めるのもやめるのも簡単です！
使用を中止する場合と、他サーバへ引っ越す場合との話を以下に簡単に解説しておきます。

さんごよみCGIを使うのをやめるために削除したい場合

さんごよみCGIでは、すべての設定データは同一ディレクトリ内に存在します。他のデータベース等は利用していません。 したがって、ディレクトリを丸ごと消すだけで削除（アンインストール）が完了します。 さんごよみCGIが不要になった場合は、単にディレクトリごと全部消して下さい。

他のサーバへ引っ越したい場合の操作

さんごよみCGIでは、すべての設定データは同一ディレクトリ内に存在します。他のデータベース等は利用していません。 したがって、ディレクトリを丸ごとコピーするだけで移転は完了します。 具体的には以下のような手順で操作すると良いでしょう。

1. 旧サーバにある「さんごよみ構成ファイル一式」(＝ディレクトリ内の中身全部)を、一旦ローカルにダウンロードする。
2. ダウンロードした「さんごよみ構成ファイル一式」を、新サーバにアップロードする。
3. パーミッションを適切に設定して、正しく動作（表示）できるかどうかを確認する(※注)。
4. 問題がなければ、旧サーバにある「さんごよみ構成ファイル一式」はディレクトリごと削除する。

以上で、引っ越しは完了します。

CGIの高度な設定