ショップ移行ツールを使ってCS-Cart V2・V3系をV4系にアップグレードする方法

2014年02月16日 (日)

CS-Cart v4.0.3-jp-1以降に搭載されている「ショップ移行ツール」アドオンを使うとCS-Cart V2・V3系からV4系にデータを移行できます。


この記事の前提条件

この記事では、
-----------------------------------------------
URL:
 http://sample.com/shop

CS-Cartがインストールされたサーバーのフルパス:
 /home/sample/public_html/shop/
-----------------------------------------------
という環境で運用している
 CS-Cartプロ版 v3.0.6-jp-1

 CS-Cart V4(v4.0.3-jp-1以降)
にアップグレードする手順を説明します。

※ v3.0.6-jp-1よりも古いバージョンを利用している場合は、事前にv3.0.6-jp-1へアップデートしてください。
※ CS-Cartプロ版のV2系を利用中の場合は、事前にv2.2.4-jp-2へアップデートしてください。

作業の流れ

今回のアップグレード作業の大まかな流れは以下の通りです。

-----------------------------------------------

 http://sample.com/shop
で運用中の
 CS-Cartプロ版 v3.0.6-jp-1
のデータを
 http://sample.com/shop_v4
にインストールした
 CS-Cart V4(v4.0.3-jp-1以降)
に移行し、移行作業および各種調整が完了したら
 http://sample.com/shop
に載せ替える

-----------------------------------------------

STEP01. 移行用URLの申請

データ移行を行うには移行作業に用いるCS-CartのURLがライセンス認証サーバーに登録されている必要があります。
こちら より

  • 有効なライセンス番号
  • 移行作業に用いるCS-CartのURL(ここでは http://sample.com/shop_v4 )

を申請してください。

ライセンス認証サーバーへの登録が完了するとCS-Cart日本語版サポートセンターより登録完了通知メールが届きます。

STEP02. 移行作業用ディレクトリの作成

移行用URLの申請が完了し、CS-Cart日本語版サポートセンターより登録完了通知メールが届いたら、WinSCPやFFFTPなどのFTP転送ソフトを使って
サーバーの
 /home/sample/public_html/
の直下に
 shop_v4/
というディレクトリを作成します。

STEP03. CS-Cart V4のインストール

CS-Cart日本語版公式ページ からダウンロードしたCS-Cart 最新バージョンをアップロードし、
 http://sample.com/shop_v4
にCS-Cart V4をインストールします。

STEP04. ライセンス番号の登録

STEP03でインストールしたCS-Cartの管理画面にログインし、
 管理画面 -> 基本設定 -> アップグレード

 ライセンス番号
に「移行用URLの申請」で申請したライセンス番号を入力して「保存」ボタンをクリックします。

STEP05. データ移行アドオンのインストール

 アドオン -> アドオンの管理
にアクセスし、
 ショップ移行ツール
をインストールします。

STEP06. インポート元ショップのフルパスを指定

 アドオン -> ショップデータのインポート
にアクセスし、
 ショップのパス
フィールドに
 インポート元ショップがインストールされたディレクトリのフルパス
 ※ ここでは /home/sample/public_html/shop
を入力し、
 検証する
ボタンをクリックしてください。

STEP07. データの検証とインポート

インポート可能なパスが指定されていると
 データの検証とインポート
ページに進みます。

表示されているインポート元とインポート先の情報を確認し、問題がなければ「インポート」ボタンをクリックしてください。

STEP08. 画面が切り替わるのを待つ

インポート作業の進捗を伝えるプログレスバーが表示されます。
プログレスバーの表示が消えた後も、以下のようなデータインポート完了を伝えるページが表示されるまでは絶対に他のページに移動しないでください

STEP09. インポートされたデータの確認

上記データインポート完了ページが表示されたら、一旦作業を中断して以下の作業を実施してください。

  • 管理者用パスワードの期限切れ警告が表示される場合は、パスワードの再設定
  • 一般設定 -> ショップ に移動して正しいショップフロントのURLが設定されているか確認
  • 一般設定 -> 言語 -> 言語の管理 に移動して各言語に正しい 国名 が設定されているか確認
  • ショップのデザインを確認し、必要に応じて デザイン -> レイアウト などから調整を実施
  • 商品や注文、顧客データなどが正しくインポートされているか確認
  • 本番環境で利用中のCS-Cartに標準搭載されていないアドオンのインストールおよび設定

 など

すべての調整作業が完了し、本番環境
 http://sample.com/shop
で運用中のCS-Cartの内容を移行用CS-Cart
 http://sample.com/shop_v4
の内容に置き換える準備ができた場合は次のステップに移動してください。

STEP10. 本番環境のCS-Cartを一時クローズ

本番環境( http://sample.com/shop ) の管理画面にログインし、画面右下の
 ショップを一時クローズ
をクリックしてショップを一時クローズ状態にします。

STEP11. 更新データの反映

移行用環境
 http://sample.com/shop_v4
の管理画面にログインのうえ、
 アドオン -> ショップデータのインポート
にアクセスし、
 「更新データの反映」に進む
ボタンをクリックしてください。


「更新データの反映」とは
ショップデータのインポート後にインポート元ショップのDBに対して加えられた変更(注文・商品の追加など)を、インポート先ショップに後から反映する機能です。
インポート先ショップの設定やレイアウト、デザインを保持したままインポート元ショップのDBに対して加えられた変更を反映することができます。


更新データの反映」ページが表示されたら、
 「更新データの反映
ボタンをクリックしてください。

STEP12. ショップデータのインポート完了

更新データの反映が完了したら、
ショップデータのインポートを完了する
ボタンをクリックしてください。

ショップデータのインポート完了ページが表示されます。

STEP13. 移行用環境のCS-Cartを一時クローズ

 基本設定 -> 全般

 ショップを一時クローズ
をチェックして、「保存」ボタンをクリックします。

STEP14. ショップのURLを本番環境のものに書き換え

 一般設定 -> ショップ -> ショップ名のリンク
にアクセスし、

  • ショップフロントのURL
  • SSLで保護されたURL

を本番環境のURL(ここでは sample.com/shop) に変更の上「保存」ボタンをクリックします。

STEP15. 移行環境の config.local.php を書き換え

WinSCPやFFFTPなどのFTP転送ソフトを使って、サーバーの
 /home/sample/public_html/shop_v4
にある
 config.local.php
というファイルをPCにダウンロードします。

テキストエディタなどでファイルを開き、以下の項目を本番環境の config.local.php と同じ値に変更します。

  • $config['http_host']
  • $config['http_path']
  • $config['https_host']
  • $config['https_path']

今回の例では、
-----------------------------------------
【変更前】
$config['http_host'] = 'sample.com';
$config['http_path'] = '/shop_v4';

$config['https_host'] = 'sample.com';
$config['https_path'] = '/shop_v4';

-----------------------------------------
【変更後】
$config['http_host'] = 'sample.com';
$config['http_path'] = '/shop';

$config['https_host'] = 'sample.com';
$config['https_path'] = '/shop';

-----------------------------------------
のように変更します。

変更が完了したらダウンロードした場所と同じ
/home/sample/public_html/shop_v4
に変更した
 config.local.php
をアップロードします。

STEP16. 本番環境のディレクトリ名を変更

WinSCPやFFFTPなどのFTP転送ソフトを使って、サーバーのディレクトリ
 /home/sample/public_html/shop

 /home/sample/public_html/shop_backup
などに変更します。

STEP17. 移行用環境のディレクトリ名を本番環境のものに変更

WinSCPやFFFTPなどのFTP転送ソフトを使って、サーバーのディレクトリ
 /home/sample/public_html/shop_v4/

 /home/sample/public_html/shop/
に変更します。

これで移行用環境にインストールしたCS-Cart V4が本番環境に移動します。

STEP18. キャッシュファイルの手動削除

WinSCPやFFFTPなどのFTP転送ソフトを使って、サーバーの
 /home/sample/public_html/shop/var/cache/
ディレクトリ内にあるすべてのサブディレクトリおよびファイルを削除します。

STEP19. ショップの再オープン

CS-Cart V4に入れ替えた本番環境
 http://sample.com/shop
の管理画面にログインし、
 基本設定 -> 全般

 ショップを一時クローズ
をチェックして、「保存」ボタンをクリックします。


以上でCS-Cartプロ版 v3.0.6-jp-1からCS-Cart V4系へのアップグレードは完了です。

なお、
 /home/sample/public_html/shop_backup
に移動した旧バージョンの環境は、ローカルPCなどにバックアップした上でサーバーから削除してください。