ec-cube.co

2023年4月版

データ移行マニュアル

1

はじめに（必ずお読みください）

P.3

1.はじめに
2.前提条件3.データ移行スケジュール
4.データ移行と本番サイト公開
5.データ移行可能対象

2

事前準備
1.coのお申し込み
2.EC-CUBE2系のバックアップファイル
3.EC-CUBE3系のバックアップファイル
4.AUTH_MAGICの値
5.商品画像P.10

3

データ移行作業

P.16

1.商品画像の用意
2.データ移行プラグイン
3.移行に必要なデータをフォームで送信
4.サイトの調整

4

サイト公開作業
1.DNSのTTL(有効期間)の確認と更新
2.旧サイトメンテナンス表示
3.再度データ移行実施
4.サイト設定
5.動作確認6.ドメイン切り替えCNAMEを設定と弊社へ連絡

P.23

1 はじめに次の場合は、データ移行についてご相談ください。

標準のEC-CUBEから

EC-CUBE4系以降を項目追加

使用されている方されている方大きくカスタマイズされていたり、EC-CUBE4系以降からのデータ移行は、手順が大きく変わります。

データ移行の知見を持っている制作会社選定の相談をされたい場合は、アドバイザーフォームより、すでにデータ移行について知見や実績があり、早速ec-cube.coへの移行についてご相談されたい場合はec-cube.coお問い合わせフォームよりお問い合わせください。

なお、データ移行の知見を自社でお持ちでない場合は制作会社さまへご依頼することを推奨しています3

1 はじめに1-1.はじめに!

ec-cube.coへのデータ移行は、ec-cube.coデータ移行の購入が必須となります。

最新版のec-cube.coへ独自にデータ移行をすると、データの不整合が発生します。表面上は問題ないように見えることもありますが、coのメンテナンス時にトラブルが発生し、サイトが起動しなくなる可能性がございます。イーシーキューブ社でデータ不整合が起きないように調整し、移行作業を行うので、必ずec-cube.coデータ移行を購入し、データ移行のお申し込みを行ってください。

データ移行は、99,000円で、ご依頼いただけます。

新規受付停止中です。

4

1 はじめに1-2.前提条件
データ移行には、以下の前提条件をご確認ください。
データ移行スケジュールの流れは6ページにございます。

データ移行の前提条件
・移行可能となるバージョンは 2.11以降となります。
・大きくカスタマイズされている場合や、4系からのデータ移行は、アドバイザーフォームにてご相談ください。
・全てのデータが移行できる訳ではございません。
・移行完了までのリードタイムはおおよそ 1～2カ月となります。
・移行当日は半日ほどサイト停止が必要となります。
・httpからhttpsへのリダイレクトには対応しておりません。
・商品やカテゴリの URLのリダイレクトには対応しておりません。
・ショップの会員ポイントに関しては 1pt=1円という形で移行されます。
・移行にはec-cube.coデータ移行の購入が必須となります。

5

1 はじめに
1-3.データ移行スケジュール
2-3営業日
17営業日
2

お問い合わせ概算算出

データ移行

37営業日〜4

スケジュールお打合せ

サイト公開
5

データ移行期間

1 データ移行のお問い合わせ・ご相談
ヒアリングシートに必要な項目を記載いただき、お問い合わせフォーム(co-support@ec-cube.net)までお送りください。

2 スケジュール概算算出
実施スケジュールの可能時期をお知らせいたします。

3 ec-cube.coデータ移行の購入こちらからご購入をお願いいたします。

新規受付停止中です。

4 データ移行
必要情報を弊社にお送りいただき、弊社の方でデータ移行を実施いたします。
完了しましたら、貴社にてデザイン調整や決済方法の追加などの対応を実施いただきます。

5 本番サイト公開
データ移行の調整後、本番サイト公開作業をさせていただきます。
本番サイト公開当日は、半日ほどサイトの停止が必要となります。

6

1 はじめに

1-4.データ移行と本番サイト公開作業には、動作を確認するための「データ移行」と、データ移行からサイト公開日のメンテナンスまでのご登録の差分を埋めるための「公開作業」との二度発生いたします。（差分の登録が不要な場合はお申し付けください）

データ移行について
移行前、移行後のアカウントと、バックアップデータ、商品画像、移行前のサイトに記載のauth_magicをサポートへ連携してください。
詳しくはヒアリングシートのシート「参考）データ移行実施スケジュール」をご参照ください。
※ データ移行実施の1週間前までにはご連絡頂ますようお願いいたします。

サイト公開についてデータ移行後に、追加されたデータの差分保管やドメインの移管など、サイトの切り替えや公開作業を行います。日程については、データ移行完了後に調整させていただきます。
詳しくは19ページ以降をご参照ください。
※カスタマイズや登録内容によっては、データの不整合が発生いたします。その調査と対処に一定お時間を頂く必要がありますので、データ移行実施後にサイト公開日を調整いただくようお願いいたします。

7

1 はじめに
1-5.データ移行対象
データ移行対象は、以下になります。
詳細につきましては、次のページをご参照ください。
○ 会員データ○ 受注データ

dtb_customer

dtb_order

dtb_customer_address

dtb_shipping

mtb_sexdtb_order_item

mtb_ job○ 支払い方法○ 管理者データ

dtb_payment

dtb_member
mtb_authority○ 配送方法dtb_delivery○ 商品データ

dtb_delivery_fee

dtb_productdtb_delivery_time

dtb_product_classdtb_class_category○ 税設定

dtb_class_namedtb_tax_rule

dtb_product_image
mtb_sale_type

× カート
dtb_cart○ カテゴリデータ

dtb_cart_item

dtb_category
dtb_product_category× 決済と配送の紐づけ
dtb_payment_option8

1 はじめに■移行対象詳細
機能名1

商品管理

機能名2

移行可否

備考

商品一覧

◯

商品登録

△

規格管理

◯

カテゴリ管理◯タグ管理-

商品CSV登録-

カテゴリCSV登録

-

受注一覧

◯

受注登録

△

出荷CSV登録-

受注メール履歴

◯

会員一覧

◯会員登録

-

お気に入り商品-・データ移行プラグインでは移行対象外となります。

新着情報管理-・データ移行プラグインでは移行対象外となります。

ファイル管理-レイアウト管理

-

ページ管理

-

CSS管理

-

JavaScript管理-

ブロック管理-キャッシュ管理-

メンテナンス管理-基本設定-

特定商取引法設定-

利用規約設定-支払方法設定△配送方法設定

◯

税率設定

-

メール設定

-

・2系のサブ情報項目は移行対象外となります。
別途、フリーエリアに登録いただく必要がございます。
・詳細-メインコメントが 4,000文字を超えている場合、移行時に4,001文字目以降は切れた状態で登録されます。

・データ移行プラグインでは移行対象外。(NEWなどのタグ情報 )・ダウンロード販売の受注は移行対象外となります。

受注管理

会員管理

コンテンツ管理設定>店舗設定

・4系ではメールアドレスの項目が 1つに統合されておりますので、携帯メールアドレスは移行対象外となります。

・過去の受注を参照するために移行されます。支払い方法は新たに作成して利用してください。

CSV出力項目設定-

メンバー管理◯権限管理-

セキュリティ管理

-

ログ表示

-

マスターデータ管理-

システム情報-メルマガ機能◯・データ移行実施前に、メルマガプラグインを導入いただく必要があります。
また配信履歴は移行対象外となります。

商品レビュー機能-

・データ移行プラグインでは移行対象外となります。

定休日カレンダー機能-・デフォルトでの機能はなくなっているため、移行対象外となります。

ダウンロード販売機能-・デフォルトでの機能はなくなっているため、移行対象外となります。

設定＞システム設定

その他

9

2 事前準備
事前にご準備していただくものは以下の5つです。
1.coのお申し込み
2.弊社での移行実施の際に利用させていただく管理画面ログインアカウント
3.EC-CUBE2系または3系のバックアップファイル(~.tar.gz)
4.AUTH_MAGICの値
5.商品画像2-1 coのお申し込み
https://www.ec-cube.net/product/co/
上記のページからお申し込みをします。

新規受付停止中です。

届いたメールからコンソール画面にログインし、ショップ管理画面にログインできるかご確認ください。

10

2 事前準備
2-1 管理画面ログインアカウントの用意
弊社での移行実施の際に利用させていただくため、移行前後のサイトそれぞれで管理画面ログインアカウントをご用意ください。
●●

ec-cube.coのサイトにて登録されているアカウント
移行前のサイトにて登録されているアカウント※バックアップファイルの取得前に用意頂く必要がございます。

2-2 EC-CUBE2系のバックアップファイル(~.tar.gz)
1

バックアップ管理にアクセスメニューから、システム設定＞バックアップ管理にアクセスします。

11

2 事前準備2

バックアップ作成、ダウンロード❶ バックアップ名を入力します。
❷ バックアップを作成します。
❸ ダウンロードします。

1

2
3

12

2 事前準備
2-3 EC-CUBE3系のバックアップファイル(~.tar.gz)
1

プラグインをインストール

3系からの移行の場合は以下のプラグインを、移行元の3系環境にインストールしますインストールし、バックアップを取得してください
https://www.ec-cube.net/products/detail.php?product_id=2091
インストールした後、有効化します。

2

バックアップ作成、ダウンロード❶ オーナーズストア＞プラグイン＞プラグイン一覧で「設定」を押します。

13

2 事前準備
2-3 EC-CUBE3系のバックアップファイル(~.tar.gz)
2

バックアップ作成、ダウンロード❷ バックアップを実行し、ダウンロードします。

14

2 事前準備
2-4 AUTH_MAGICの値
1

AUTH_MAGICをコピー

以下のファイルからAUTH_MAGICの値をコピーし、メモ帳などに保存します。
EC-CUBE 2.4の場合
data/cache/mtb_constants.php
EC-CUBE 2.11~の場合
data/config/config.php
EC-CUBE 3系の場合
app/config/eccube/config.yml
define('AUTH_MAGIC', 'ここに入力されている文字列をコピーする');

2-5 商品画像
以下の場所の画像データをコピーして、zipファイルで圧縮してください。
html/upload/save_image※zipファイルは、フォルダごとを圧縮せず、画像を選択し圧縮してください。

15

3 データ移行作業
データ移行作業は、3つの手順があります。
1.圧縮した画像ファイルをご用意する
2.作成したバックアップファイルをご用意する
3.イーシーキューブへ、用意したファイル、アカウント、AUTH_MAGICの値を共有する
ご契約されたec-cube.coでの作業になりますので、まずはec-cube.coにログインして次のステップを進めてください。

3-1 商品画像の用意
1

容量確認

2-4で圧縮した画像データの容量を確認します。
容量が100MB以下場合は、このまま進めてください。
容量が100MBを超える場合は、容量を抑えることができないかご確認をお願いします。

16

3 データ移行作業
3-2 データ移行プラグイン

1

データ移行プラグインをインストール

以下のプラグインをご契約されたec-cube.coにインストールします。
https://www.ec-cube.net/products/detail.php?product_id=2480
インストールした後、有効化します。

2

バックアップファイルの確認

バックアップファイルのサイズが10MBを超える場合は以下ご確認ください。
バックアップファイル（~.tar.gz）を展開し、以下のファイルを削除してください。
dtb_order_temp.csv
受注確定する前の購入プロセスにおいて情報を受け渡しするためのデータが保存されています。
削除することで、データ移行への影響はありません。
dtb_session.csv
セッション情報が保存されています。
削除することで、データ移行への影響はありません。

17

3 データ移行作業
3-3 移行に必要なデータをフォームで送信
まずはデータ移行の必要情報の受け渡しについて以下のフォームよりお問い合わせく
ださい。
https://www.ec-cube.net/product/co/support.php
個人情報を含む内容になりますので、安全なデータのやり取りができるよう弊社からデータ連携用のURLを発行いたします。
URLが届きましたら、そちらより以下のデータをお送りください。
1.弊社での移行実施の際に利用させていただく管理画面ログインアカウント
2.EC-CUBE2系または3系のバックアップファイル(~.tar.gz)
3.商品画像ファイル
4.AUTH_MAGICの値

値が届きましたら、弊社にてAUTH_MAGICの切り替え作業と、移行データの整合性チェックをさせていただきます。データ不整合の調整のためお時間をいただきますので予めご了承ください。
切り替え作業が完了しましたら、ご連絡いたします。

切り替え後、EC-CUBE2系で使用していたログインIDとパスワードでログインできるようになります。
※coのコンソールのログイン情報ではログインできなくなりますのでご注意ください。

18

3 データ移行作業
3-4 サイトの調整
データ移行完了のお知らせをメールで受け取りましたらログインをお試しいただ
き、サイトのデータが問題なく移行されているかご確認ください。

会員データ
管理画面＞会員管理＞会員一覧から移行した会員データを確認します。

管理者データ
管理画面＞設定＞システム設定＞メンバー管理から移行した管理者データを確認します。

19

3 データ移行作業

商品データ管理画面＞商品管理＞商品一覧から移行した商品データを確認します。
商品画像が表示されているかもご確認ください。

カテゴリデータ
管理画面＞商品管理＞カテゴリ管理から移行した商品カテゴリを確認します。

20

3 データ移行作業

3-4 サイトの調整

受注データ
管理画面＞受注管理＞受注一覧から移行した受注データを確認します。

支払い方法
管理画面＞設定＞店舗設定＞支払方法設定から移行した支払方法を確認します。

支払い方法は、過去の受注を参照するために移行されています。
「表示」に変更しても購入時に利用することができません。
新規に支払い方法を作成してください。

21

3 データ移行作業
配送方法管理画面＞設定＞店舗設定＞配送方法設定から移行した配送方法を確認します。
移行した配送方法は受注との紐づけのため移行されますが、有効化して利用することはできません。新規に作成してください。

配送方法を「表示する」に設定するまで、移行した商品をカートに入れることはできません。

税率設定
管理画面＞設定＞店舗設定＞税率設定から移行した税率設定を確認します。

22

4 サイト公開作業
旧サイトから新サイトへの切り替えを実施します。
実施にあたって御社・弊社双方で作業が発生するため、事前に実施作業・スケジュールをご相談させていただきます。

サイト公開作業の手順は以下になります。
（※独自ドメインにて、旧サイトから新サイトに切り替える場合）
1.DNSのTTL(有効期間)の確認と更新
2.旧サイトメンテナンス表示
3.再度データ移行実施
4.サイト設定
5.動作確認6.ドメイン切り替えCNAMEの設定と弊社へ連絡

4-1 DNSのTTL(有効期間)の確認と更新
本番移行の前日までにご確認をお願いいたします。
TTLが長時間設定されている場合、ドメインの反映まで時間がかかります。

4-2 サイトメンテナンス表示
EC-CUBE2系の旧サイトをメンテナンス表示にしてください。

23

4 本番移行
4-3 再度データ移行実施
弊社にて再度データ移行を実施いたします。16ページと同様にデータ連携用URLが届きましたら以下の情報を再度お送りください。
1.弊社での移行実施の際に利用させていただく管理画面ログインアカウント
2.EC-CUBE2系または3系のバックアップファイル(~.tar.gz)
3.商品画像ファイル※その際、すべて移行するか、商品を除いて移行するか移行対象を事前に弊社へお知らせください
移行対象は本マニュアルの7ページをご参照ください。

4-4 サイト設定
支払い方法や配送方法は初期化されますので、再度設定をお願いいたします。

4-5 動作確認
購入テストなど動作・設定のご確認をお願いいたします。

※商品をカートに入れて、カート画面で「レジに進む」をクリックするとシステムエラーが発生する場合支払方法の設定が原因かと存じます。以下ご確認いただき、各設定を完了いただいた上で、再度お試しいただけますでしょうか。
①決済プラグインの設定は完了しているか②支払方法設定で新規に登録し、配送方法設定で新規登録した支払方法を選択できているか※移行された支払方法は利用ができない為、coサイトで新しく登録する必要があります。
24

4 本番移行
4-6 ドメイン切り替えCNAMEの設定と弊社へ連絡
CNAMEを設定してください。
設定の流れは以下資料をご参照ください。
https://www.ec-cube.net/user_data/packages/default/img/product/co/original_domain_setting.pdf?argument=2qpV46CP&dmai=a5e3a5e2e2
5cc0※CNAMEの設定方法はご利用のドメインサービスで変わります。
詳しくは上記資料12ページをご確認ください。

貴社でDNSレコードの設定後、弊社で証明書の切り替えを完了させるまでの間、当該サイトはSSLエラーで警告画面が表示され、そのままアクセスするとec-cube.coのサイトが表示される形となりますが、こちらは事前に対応日時を調整させていただくことで、エラーとなる時間を短くすることが可能でございます。

CNAME設定後、弊社までご連絡をお願いいたします。

25