baserCMS3系から4系への移行方法baserCMS3系から4系への移行方法ツイート2017.02.23PickupbaserCMS4では、baserCMS3からの簡易アップグレードをサポートしていません。これは、baserCMS4にコンテンツの統合管理機能が搭載され、データベース構造が大幅に変更となっている事に起因しますが、これまで使ってきたbaserCMSが古いままの状態での運用を強いられるのも、今後セキュリティフィックスなどが発生した場合に問題となってきます。ここでは、最近リリースされたマイグレーションプラグインを使ってのアップグレード作業を説明したいと思います。アップグレードを行う際の注意baserCMSを利用する際、プラグインを入れたり、カスタマイズを行っている場合、アップグレードがスムーズにいくとは限りません。その為、本番運用しているサーバーで直接アップグレード作業を行わず、必ず、テスト用の環境を用意し、そこで動作確認を行ってから本番サーバーへ適用するようにしましょう。ここで紹介されているマイグレーションプラグインはあくまでアップグレードをサポートするだけのものです。ご利用は自己責任でお願いします。全てのデータは、既存サイトのデータを復元する前提ですので、インストールの際、ログイン情報は、既存サイトのものに合わせる必要はありません。'ここの文字列を控えます。'ここの文字列を控えます。バックアップデータをダウンロードします。ない場合、プラグインのデータが全てダウンロードできない場合があります。その場合は、以下のパッチをあててください。既存サイトの以下のフォルダ内に入っている、テーマ、プラグイン、アップロードファイルを取得して、テスト環境の同階層に配置します。取得してインストールしておきます。DBマイグレーターは、3系用のバックアップファイルを、4系用のバックアップファイルに変換するプラグインです。アドオンマイグレーターは、3系用のテーマやプラグインを4系用に変換するプラグインです。どちらも、既存サイトのbaserCMSがノーマル状態であれば問題ありませんが、カスタマイズされている場合、完全に変換する事を保障するものではありません。テーマやプラグインの種類によっては、手作業でのコード調整が必要となります。バックアップファイルの変換DBマイグレーターを利用して、3系用のバックアップファイルを4系用のバックアップファイルに変換します。3系用のバックアップファイルをアップロードすると、数十秒後に、ダウンロードボタンが表示されますので、ダウンロードしておきます。テーマの変換アドオンマイグレーターを利用して、3系用のテーマを4系用のテーマに変換します。ボタンをクリックします。その後、「手動で作業が必要な事項」を参考に、手作業でテーマの修正を行ないます。プラグインの変換アドオンマイグレーターを利用して、3系用のプラグインを4系用のプラグインに変換します。プラグインについて、配布されているものを利用している場合は、既に、baserマーケットで、4系に対応しているバージョンがリリースされている可能性があります。baserマーケットを確認しましょう。配布されていなければ、次の手順で、4系用への変換作業を行ないます。ボタンをクリックします。その後、「手動で作業が必要な事項」を参考に、手作業でプラグインの修正を行ないます。文字列を、テスト環境のインストール設定ファイルの同じ箇所に、埋め込みます。この作業を行っていない場合、管理システムにログインできなくなりますのでご注意ください。'ここの文字列を置き換えます。'ここの文字列を置き換えます。');バックアップのインポートそれではいよいよバックアップファイルのインポートを実行しますので、先ほど4系用に変換してダウンロードしたバックアップファイルを準備します。バックアップファイルを選択し、アップロードを実行します。数十秒後、インポートが完了しますので、コンテンツ管理等にデータが取り込まれているか確認します。プラグインの有効化バックアップをインポートした直後は全てのプラグインが無効状態となっているので、利用するものを有効化します。プラグインによっては正常動作しない場合がありますので動作も確認しておきます。コンテンツ名を見直し3系でタイトルが空になっていたコンテンツ(固定ページのトップページ等)について、移行後のタイトルが「タイトルを入力してください。」となっていますので、正式なタイトルに変更しておきます。最後に、フロントエンド側も含めて表示や動作を確認します。問題がなければ、これでテスト環境でのアップグレード作業は完了です。本番サーバーへの反映作業は、テスト環境で準備した、以下のものを利用します。編集してメンテナンスモードに切り替えます。準備したファイルをサーバーに配置するFTPソフト等を利用して、準備した以下のフォルダを本番サーバーの同階層にアップロードします。theme/、もしくは、app/theme/baserCMSを本番サーバーで再インストールする以下のファイルを削除してトップページにアクセスすると、baserCMSのインストールが始まります。手順に従ってインストールを完了します。本番サーバー上のデータベースはこのタイミングで初期化されますのでご注意ください。不安な場合はデータベースのバックアップを直接取得しておくか、インストール時にDBプレフィックスを、これまで利用していたものとは別のものに変更してください。書き換えを行ないます。バックアップのインポートテスト環境と時と同様の手順で、バックアップファイルのインポートを行ないます。プラグインの有効化テスト環境と時と同様の手順で利用するプラグインの有効化を行ないます。最後に、フロントエンド側も含めて表示や動作を確認します。問題がなければ、これで本番サーバーへの移設作業は完了です。お疲れ様でした!!!アップグレードがうまくいかない場合ダッシュボードの表示がおかしい場合baserCMS4系よりダッシュボードの仕組みが変更されています。正常に表示できていないボックスが存在する場合は、以下のファイルが残っている可能性がありますので削除してみてください。lib/Baser/View/Elements/admin/dashboard/index_dblog_list.phpその他の不具合その他に、問題が発生している場合、まずは、デバッグモードに切り替えてどのような問題が発生しているか、エラーメッセージ等を確認しましょう。相談してみるのも一つの手段です。代表取締役1973年佐賀県生まれ、佐賀育ち。27歳で他業種よりIT関連会社へ転職。その後、2007年に独立。5年間のフリーランスを経験後、2012年1月、株式会社キャッチアップを立ち上げ、Webシステム(CMS系)を中心とした提案、開発に携る。ユーザビリティ・運営を意識した開発を心がけている。フリーランス中に参加したコミュニティ活動を通じて、2010年に自身が開発していたCMS「baserCMS」をオープンソースとして公開。ベーサー・ファウンデーションを設立。