国産フリーCMS「Magic3」を CORE SERVER へインストールする手順の記録

国産フリー CMS の「Magic3」を コアサーバ（CORE SERVER）へインストールした際の手順と注意点を紹介します。未確認ですが XREA へのインストールも同様になると予想しています。
ご利用環境により状況が変わりますので、インストール成功事例のひとつとしてご覧ください。

なお、わかりやすく読めるように手順は成功事例を中心に記載します。
注意事項や補足は末尾にまとめて記載します。

１．事前準備

あらかじめ、コアサーバでサーバ領域を確保してください。

２．コアサーバでデータベースを作成する

(1)コアサーバの管理画面でサイドメニューから「データベース」をクリックします。
(2)「MySQL の追加・編集」を操作します。
(3)「DB/ユーザ名」「パスワード」を入力します。忘れないようにメモを残しておきましょう。
(4)「文字コード」は「UNICODE」を指定します。
(5)「メモ」欄はデータベースの説明を入力しておきます。（入力しなくても問題ありません）
(6)入力した行の選択欄にチェックを入れます。
(7)「作成」ボタンをクリックします。実際にデータベースへ接続できるまでに２～３分かかります。（補足１）

３．Magic3 の圧縮ファイルをダウンロードする

(1)Magic3 の公式サイト（http://www.magic3.org/doc/）にアクセスします。
(2)左サイドメニューの「最新リリース情報」内のリンクをクリックします。
(3)ページ中ほどのファイル名「magic3_1.7.18_src.tar.gz」をクリックします。
※ファイル名はバージョンにより変わります。
(4)ページが切り替わり、しばらくするとダウンロードを確認するダイアログボックスが表示されるのでディスクに保存します。（補足２）

４．圧縮されているファイルを解凍する

ダウンロードしたファイルは圧縮されていますので、「tar.gz」の形式をウィンドウズ上で解凍できるソフトを使います。
参考書籍にも説明されていますが、筆者の環境でも Lhaplus では正常に解凍できませんでした。
今回は解凍ソフト「Lhaca」を利用しました。

□Lhaca ダウンロード先：窓の杜
http://www.forest.impress.co.jp/lib/arc/archive/archiver/pluslhaca.html

５．解凍したファイルを zip 形式に圧縮する

圧縮には筆者が普段利用している Lhaplus を使いました。
未確認ですが、他のソフトでも大丈夫だと思います。
解凍して生成される「magic3」フォルダを Lhaplus へドロップして圧縮すると良いでしょう。
ファイル数が多いので、２～３分かかりました。

□Lhaplus ダウンロード先：窓の杜
http://www.forest.impress.co.jp/lib/arc/archive/archiver/lhaplus.html

６．コアサーバのファイルマネージャでアップロードする
圧縮したファイルをコアサーバの public_html ディレクトリへアップロードします。
(1)コアサーバの管理画面でサイドメニューから「ファイルマネージャー」をクリックします。
(2)「ファイルマネージャ」欄の「ファイルマネージャにログイン」をクリックします。
(3)「public_html」ディレクトリをクリックして開きます。
(4)「アップロード」ボタンをクリックします。
(5)左側の「ファイル」の下の「参照」ボタンをクリックします。
(6)「ファイルのアップロード」ダイアログボックスで先ほど圧縮した「magic3.zip」を指定します。
(7)画面左上のチェックマークをクリックするとアップロードが始まります。
(8)途中表示されるダイアログボックスは「Close window now」をクリックして閉じます。
(9) １～２分してアップロード結果が表示されたら画面左上のチェックマークをクリックします。
(10)ファイルマネージャ画面で「public_html」ディレクトリの下に「magic3.zip」がアップロードされています。

７．コアサーバへ SSH 接続する
(1)コアサーバの管理画面でサイドメニューから「ホスト情報登録」をクリックします。
(2)「FTP/SSH接続許可ホスト入力」の「SSH 登録」ボタンをクリックします。その後 SSH で接続できるまで５分程度かかります。
(3)PuTTY などを使って SSH でログインします。
(4)public_html ディレクトリへ移動し「unzip magic3.zip」を実行して圧縮ファイルを解凍します。
(5) /virtual/xxxxx/public_html/magic3 ディレクトリが作成されます。

□PuTTY ダウンロード先：PuTTY ごった煮版
http://yebisuya.dip.jp/Software/PuTTY/

８．インストーラを実行してインストール環境をチェックする

(1)インストール先のアドレス（例 http://xxx.xxx.xxx/magic3/）にアクセスします。
(2)「Ｍａｇｉｃ３ インストール」ページで「次へ」をクリックします。
(3)「インストール環境チェック」で問題のある箇所を確認します。今回は次の問題がありました。

・インストール時に使用する一時ディレクトリ /tmp を書き込み可にする
・Magic3 設定ファイル magic3/include/siteDef.php のディレクトリを書き込み可にする
・リソース（画像等）格納ディレクトリ magic3/resource を書き込み可にする

９．インストール時の一時ディレクトリ指定を変更する

コアサーバでは /tmp への書き込みできないので一時ディレクトリを変更します。
ファイルマネージャで magic3/include/global.php を次のように編集しました。

define('M3_SYSTEM_WORK_DIR_PATH', '/tmp'); // 作業用ディレクトリ
　　↓
define('M3_SYSTEM_WORK_DIR_PATH', '/virtual/xxxxx/public_html/magic3/tmp'); // 作業用ディレクトリ

※作業用ディレクトリ中の xxxxx はコアサーバで領域を取得した際の ID です。

続いて、ファイルマネージャ画面で public_html/magic3/tmp を作成し、属性を 0777 に設定します。

「インストール環境チェック」画面を再読み込みして、一時ディレクトリが書き込み可能になったことを確認します。

１０．Magic3設定ファイルのディレクトリに書き込み権限をつける

Magic3 設定ファイルは /virtual/xxxxx/public_html/magic3/include/siteDef.php です。
ファイルマネージャで、このファイルがある /virtual/xxxxx/public_html/magic3/include ディレクトリの属性を 0777 にします。

※「ディレクトリ内のサブディレクトリの属性も変更する」「ディレクトリ内のファイルの属性も変更する」のチェックを外して実行しました。

「インストール環境チェック」画面を再読み込みして、Magic3 設定ファイルのアクセス権が書き込み可能になったことを確認します。

１１．リソース(画像等)格納ディレクトリに書き込み権限をつける

ファイルマネージャで /virtual/xxxxx/public_html/magic3/resource ディレクトリの属性を 0777 にします。

※「ディレクトリ内のサブディレクトリの属性も変更する」にチェックを入れ、「ディレクトリ内のファイルの属性も変更する」のチェックを外して実行しました。

「インストール環境チェック」画面を再読み込みして、リソース(画像等)格納ディレクトリのアクセス権が書き込み可能になったことを確認します。

１２．インストールを進める

「インストール環境チェック」で赤字の項目がなくなったら「次へ」をクリックしてインストールを進めます。

１３．サイト情報を入力する

(1)「サイト情報入力」で次のように入力します。

・DB種別　　：MySQL
・ホスト名　：localhost
・DB名　　　：xxxxx_magic3
・DBユーザ　：xxxxx_magic3
・パスワード：magic3

※今回、DB 種別は MySQL にしました。xxxxx はコアサーバの IDで、magic3 の部分は変更可能です。

(2)「接続テスト」をクリックします。

正しい情報が入力されていると「接続正常 => テーブル作成正常」と表示されます。
「接続エラー」が表示されるときはページ上部のエラーメッセージを参考に入力内容を見直して修正します。

(3)「次へ」をクリックします。
(4)「ＤＢ構築」ページで「実行」をクリックします。
(5)「ＤＢ構築完了」ページが表示されます。

１４．デモ用データをインストールする

デモ用データをインストールしてみます。
(1)参考書籍で推奨されている「simple_demo1.sql」を選択して「インストール」をクリックします。
(2)データをインストールしますか？のダイアログボックスで「OK」をクリックします。
(3)「データインストール完了しました」と表示されたら「次へ」をクリックします。

１５．インストール完了

(1)「インストール完了」ページが表示されます。
(2)以下の情報をメモしておきましょう。

・メインのURL：http://xxx.xxx.xxx/magic3/
・管理機能のURL：http://xxx.xxx.xxx/magic3/admin
・ユーザ: admin
・パスワード: admin

(3)「インストーラを削除して終了」をクリックします。

１６．管理画面へログインする

(1)「管理画面ログイン」ページが表示されます。
(2)ID とパスワードを入力して「ログイン」ボタンをクリックします。
(3)「管理画面メニュー」が表示されます。



※この画面が表示されればインストール成功です。（補足３）

１７．メイン画面を確認する

(1)http://xxx.xxx.xxx/magic3/ にアクセスします。
(2)次の画面が表示されます。



１８．デモサイトを確認する

(1)左サイドメニューのメニューをクリックしてリンク先を確認しましょう。（補足４）
(2)テンプレートチェンジャーでサイトのデザインを変更してみましょう。




１９．参考ページ

・一時ディレクトリ関連
http://sourceforge.jp/forum/message.php?msg_id=38058
・設定ファイル
http://sourceforge.jp/forum/message.php?msg_id=41374

補足１．
「作成」ボタンをクリックしてもデータベースが作成されない場合がありました。
このときは、phpMyAdminからもデータベースへ接続できませんでした。
もう一度「作成」ボタンをクリックして接続可能になりました。

補足２．
参考書にはサーバ上で wget して解凍する方法が説明されていますが、コアサーバ上では tar コマンドでエラーが発生し解凍できませんでした。
コアサーバのファイルマネージャには圧縮ファイルをアップロードして解凍できる機能がありますが、今回、その方法では解凍後のファイルが不足してインストールできませんでした。
また、ダウンロードしたソースをウィンドウズ上で解凍し、それをサーバへアップロードする方法は非推奨のようです。

補足３．
「インストール環境チェック」画面には項目がなく、サイトも動作したのですが、もう一箇所ファイルの修正が必要です。詳細は次のページを参考にしてください。
エラーログの出力先として一時ディレクトリを使うそうです。
http://sourceforge.jp/forum/message.php?msg_id=38058

補足４．
デモサイトで「wiki」をクリックすると、初回のみ警告メッセージが表示されました。
セーフモードに起因するようです。

Warning: set_time_limit() [function.set-time-limit]: Cannot set time limit in safe mode in /virtual/xxxxx/public_html/magic3/widgets/wiki_main/include/container/wiki_mainWidgetContainer.php on line 102

参考書籍

最初のインストールは次の書籍を参考にしました。画面例が多く全体を把握しやすい構成です。開発チームの方が執筆なさったようで、わかりやすくまとまっていると思います。
「Part5 知っておきたい運用テクニック」など、CMS の運用経験をもとにした役立つ情報が多く載っています。お手元に準備なさることをお勧めします。

書籍名：Magic3 でつくる！最強の CMS サイト