Академический Документы
Профессиональный Документы
Культура Документы
Migration Tools
User
Guide
Copyright
2014
LitExtension.com.
All
Rights
Reserved.
Page 1
Content
1.
Preparation
..................................................................................
3
2.
Setup
...........................................................................................
5
3.
Plugins
Setup
...............................................................................
7
4.
Migration
Speed
Optimization
......................................................
8
5.
Enter
License
Key
.........................................................................
9
6.
Migration
...................................................................................
10
7.
Migration
Resuming
...................................................................
14
8.
Advanced
Configuration
.............................................................
16
9.
Use
Cases
...................................................................................
17
10.
Data
Verification
......................................................................
18
11.
Frequently
Asked
Questions
.....................................................
19
Page 2
1.
Preparation
For
Source
Store:
-
Please ensure you have the right permission to upload files into your Source Store.
Source
Store
can
operate
normally
during
migration
as
it
requires
a
very
limited
resource
for
the
process.
PHP
Compatibility:
PHP
5.3
or
later.
For
Target
Store:
It
is
strongly
recommended
to
backup
Magento
Target
Store
first.
-
Webserver (mostly apache) should have full permission to write on /media folder.
pdo_mysql
simplexml
mcrypt
hash
GD
DOM
curl
mb_strings
Page 3
On
the
left
hand
menu
under
the
Advanced
tab
(at
the
bottom)
select
the
System
menu
item.
Select Mail Sending Settings from the selection on the right hand side.
Set Disable email communications to Yes, then no email will send through Magento.
Page 4
2.
Setup
After
downloading
the
product
zip
file
from
our
Store,
please
extract
it
into
a
folder.
The
module
consists
of
two
main
parts:
Magento
Data
Migration
Module
(app
and
skin
folder)
and
Source
Cart
Connector
(Magento_connector
folder)
Page 5
If
you
have
any
problem
reaching
the
link
please
ensure
you
have
htaccess
configured
correctly
and
the
file
has
execution
permission.
For
security,
please
open
connector.php,
find
this
very
first
line:
define('LECM_TOKEN',
'123456');
And
change
"123456"
to
another
string,
this
will
be
used
to
enter
to
the
Migration
Form
(Cart
Token)
and
acts
like
"password"
to
prevent
unauthorized
data
access
to
your
source
store.
Page 6
3.
Plugins
Setup
Plugins
are
purchased
and
setup
separately
into
Magento
Data
Migration
Module.
They
will
provide
additional
functionalities
to
the
tool.
Normally
plugins
need
to
be
customized
and
tweaked
by
LitExtension
Team
to
fit
customers
requirements
and
will
be
sent
to
customers
later
on.
There
are
a
few
types
of
plugin:
-
Products
and
Categories
SEO
Urls
Plugin:
helps
migrate
Products
and
Categories
urls.
Old
urls
will
be
saved
in
Target
Magento
Store
and
will
be
maintained
to
keep
all
current
SEO
ranking
you
have
built
up
for
years.
-
Custom
Fields
Plugin:
help
migrate
custom
fields
from
Source
Store
to
Target
Magento
Store.
This
is
useful
in
case
customers
have
customized
their
store,
for
example:
adding
fields
to
database
tables,
and
also
want
to
migrate
these
fields
into
Magento
Store.
-
Customer
Password
Plugin:
special
plugin
which
adds
the
ability
to
read
passwords
encrypted
by
Source
Stores
to
Magento.
All
passwords
are
migrated
over
and
remains
encrypted,
customers
can
login
to
the
new
shop
right
away
without
the
need
of
resetting
passwords.
"Zencart
to
Magento"
and
"Magento
to
Magento"
tools
natively
support
migrating
passwords
and
do
not
need
this
plugin.
To
install
plugins,
just
copy
plugin
files
into
the
instructed
folder
inside
Cart
Migration
Magento
Module,
new
functionalities
will
be
enabled.
Page 7
The faster Source store can be accessed, the faster migration speed will be.
As
migration
process
is
processed
mostly
on
Target
store,
it
is
critical
to
have
a
fast
magento
server.
Recommended
server
configuration:
4
cores
or
higher,
4G
memory
or
higher.
Compilation
should
be
enabled
to
improve
speed
(
System
>
Tools
>
Compilation
)
.
Cache
should
be
enabled
to
improve
speed
(
System
>
Cache
Management
).
Page 8
2.
Login
your
Magento
Target
Store
backend,
select
Cart
Migration
>
Configuration,
and
copy
and
paste
your
license
key
here:
Page 9
6.
Migration
Please
login
your
Magento
Target
Store
backend,
select
Cart
Migration
>
Migration
The
migration
will
go
through
3
simple
steps.
Just
hit
Next
when
you
finish
one
step
to
advance.
Step
1:
Source
Cart
Configuration
Cart
Type:
select
corresponding
source
cart
type
(osCommerce,
ZenCart,
VirtueMart,
WooCommerce,..)
Cart Token: the token string which has been configured in connector.php
Page 10
Root
Category:
the
category
of
current
Magento
store
to
import
all
source
cart
categories
into.
Product
Attribute
Set:
select
an
Attribute
Set
which
is
used
to
import
products,
all
necessary
attributes
in
migration
process
will
be
created
in
to
this
set.
Currencies
Mapping:
Assign
Source
Cart
currencies
to
proper
Target
Magento
Store
currencies.
Creating
currencies
in
Target
Magento
Store
may
be
needed.
Orders
Status
Mapping:
Assign
Source
Cart
order
statuses
to
proper
Target
Magento
Store
order
statuses.
Creating
additional
order
statues
in
Target
Magento
Store
may
be
needed.
Page 11
Additional
Options:
Migrate
recent
data:
if
you
choose
this
option,
it
will
migrate
new
data
only.
Supposed
you
have
just
finished
a
full
migration
from
your
current
Source
store
to
Target
store,
after
that
Source
store
is
still
live
and
continue
getting
new
data,
and
you
want
to
get
your
Target
store
updated
with
the
new
data,
select
this
feature
to
avoid
starting
over
again.
Clear
current
data
on
Target
Store
before
Migration:
if
you
choose
this
option,
all
current
products,
categories,
manufacturers,
customers,
orders,
product
reviews,
taxes
will
be
cleared.
Migrate
categories
and
products
SEO
URLs:
if
you
choose
this
option,
old
SEF
urls
of
source
will
be
preserved
in
Target
Magento
Store,
allowing
you
to
maintain
your
Pagerank.
Transfer
images
in
product
descriptions
to
Target
Store:
download
all
images
in
product
description
into
your
store
so
that
it
wont
have
to
refer
back
to
your
source
store
or
anywhere
else
for
images.
Preserve
Customer
IDs
on
Target
Store:
this
will
help
you
preserve
your
old
Customer
IDs
for
easier
reference.
Page 12
Preserve
Order
IDs
on
Target
Store:
this
will
help
you
preserve
your
old
Order
IDs
for
easier
reference
Step 3: Migration
The
migration
will
take
place
automatically
in
this
final
step.
In
order
for
it
to
progress,
you
should
not
close
your
browser
of
remove
Source
Cart
Connector.
After
the
migration
is
completed,
click
on
Clear
Cache
and
ReIndex
Data
to
finish.
If
you
dont
want
to
run
it
right
here
or
it
returns
false
for
any
reason,
you
can
do
that
manually
in
System
>
Cache
Management
and
System
>
Index
Management.
Page 13
7.
Migration
Resuming
When
a
problem
occurring
on
the
migration
process,
Magento
Migration
Tool
provides
the
ability
to
resume
the
process:
1.
Automatically
resume
on
the
spot:
the
tool
will
automatically
resume
after
a
failure
until
all
data
is
imported.
2.
Manually
resume:
you
can
refresh
the
page
to
go
back
to
Step
1
and
click
on
Resume,
this
is
helpful
when
you
want
to
temporarily
stop
migration
and
resume
when
you
want
to.
Page 14
Page 15
8.
Advanced
Configuration
Access
Advanced
Configuration
by
going
to
Cart
Migration
>
Configuration
from
Magento
backend
menu.
All
default
values
are
configured
to
work
with
most
cases,
thus
it
is
recommended
to
change
these
values
only
when
it
is
necessary
to.
XXX
Per
Batch:
Cart
Migration
splits
each
entity
data
into
small
batches
(or
chunks)
and
import
them
in
turn.
This
option
defines
batch
size
to
process
in
each
turn.
Depending
on
your
Magento
hosting
resource
you
can
change
the
values
accordingly.
The
lower
the
value
is,
the
less
time
and
resource
Magento
spends
to
process
a
batch,
also
the
longer
overall
time
to
import
full
data.
Delay
Time:
the
sleeping
time
between
each
batch.
This
option
defines
the
break
time
for
both
Source
Store
and
Target
Store.
It
is
also
helpful
to
prevent
Timeout
issue
if
Source
Store
has
been
setup
to
limit
the
number
of
requests
in
a
period
of
time.
Auto
Retry
After:
if
by
some
reason,
the
batch
process
fails,
the
tool
will
automatically
retry
after
a
period
of
time
defined
by
this
option.
Page 16
9.
Use
Cases
1.
Clear
current
data
and
fresh
migrate
all
data
Proceed
normaly
to
Step
2,
here
please
choose
All
entities
and
Clear
current
data
of
target
store.
Hit
next
to
proceed
to
Step
3.
2.
Clear
current
data
and
fresh
migrate
some
specific
entities
Proceed
normaly
to
Step
2,
here
please
choose
only
entities
you
want
to
migrate
and
Clear
current
data
of
target
store.
Hit
next
to
proceed
to
Step
3.
Note:
Clear
current
data
of
target
store
will
only
clear
data
of
selected
entities.
3.
Incremental
migration
Lets
say
you
have
successfully
performed
first
migration
from
Source
store
to
Target
store
for
a
few/all
entities.
Data
has
been
imported
properly.
A
few
days
later,
your
Source
store
has
some
more
data
and
you
want
to
import
this
new
data
only
(
incremental
migration
).
Here
is
how
to
do
it:
-
Incremental
migration
can
only
be
done
for
most
recent
migrated
entities.
Example:
if
you
have
migrated
all
entities
for
the
first
time,
in
the
second
time
you
can
incrementally
migrate
new
data
of
all
entities.
If
you
only
migrated
for
example
Customers
+
Orders
only,
the
next
time
you
can
only
perform
incremental
migration
for
Customers
+
Orders.
Proceed
normally
to
Step
2.
Here
please
choose
entities
you
want
to
migrate
(
must
be
the
same
entites
you
migrated
last
time
)
and
Migrate
recent
data.
Proceed
to
Step
3.
Page 17
Page 18
Cause:
php
execution
time
too
low
Solution:
Go to Cart Migration Configuration, change value Products per Batch to a lower number
2. At
step
2,
the
tool
can
not
read
my
mapping
data?
Page 19
Cause:
migration
tool
can
not
read
your
source
store
database
Solution:
check
Cart
Migration
Configuration
and
ensure
you
enter
correct
table
prefix
for
your
source
database
3. Magento
database
isn't
working
when
hitting
Next
on
Step
1?
Cause:
there
was
an
issue
with
the
installation,
the
module
could
not
create
its
additional
tables
into
Magento
database.
Solution:
login
mysql
admin,
run
this
script:
Page 20
Page 21