Migrate Magento to Hypernode

in Getting startedMigration Tags: importerMagentoMigration

Step 2 - Copy your shop to Hypernode

Congratulations with your brand new Hypernode! In case you already have a Magento shop, the first step is to migrate your shop to Hypernode in order to test it. There are several ways to achieve this, which are described below.

Do you have a Magento 2 shop? Please make sure that you have ordered a Magento 2 booted Hypernode before importing your Magento 2 shop onto the Hypernode. Or, if you manually installed Magento 2, please make sure you have enabled the Magento 2 Nginx config and used the right path infrastructure, you can read more about it here.

Option 1: Use the Shop importer on service.byte.nl

This is an easy way of getting started with Hypernode. If you use the Shop importer on our Service Panel, all you have to do is to fill in the correct information on the form, click “Importeer shop” and in the background your shop will be automatically imported on your Hypernode.

If you use the Shop importer on our Service Panel, locally on the node the hypernode-importer utility is ran. This is a fully scripted migration tool that executes all the tasks that need to be done when migrating a Magento shop. This includes:

  • Copying the database
  • Copying all the content
  • Replacing caching through memcached with Redis
  • Adjusting symlinks and paths
  • Repairing the modman directory if existent
  • Set old/current shop in Maintenance mode
  • And several other options.

Selecting the maintenance mode in the Shop importer tool

Please only select this option if you run the Importer tool for the second time, to do a last sync before going live on Hypernode.

When you select the maintenance box in the importer tool in the Service Panel, the importer wil create a maintenance flag (file: maintenance.flag) in the root of your current/old Magento shop. Please be aware that your current website won’t be available for your visitors. When the migration has been finished you need to modify your DNS settings:

*If your domain is being hosted at Byte, there is a quick and easy way to switch your DNS to the Hypernode. Login into the Service Panel. Make sure your Hypernode is selected in the dropdown menu -> Instellingen -> SSL & DNS instellingen -> Find your domain in the list -> change the ‘Beschikbaar’ value into ‘Koppel domeinnaam aan deze Hypernode’. Repeat these steps for all your domains which should be running on your Hypernode.

*If your domain is being hosted externally, you need to change the DNS settings manually. Read this article to see which records you need to modify.

Although the Shop importer is a very easy way to import a shop, please keep in mind that using the command line is a requirement. So if needed, find yourself an experienced developer that can assist you with these tasks.

Option 2: Migrate your shop via Shell using hypernode-importerMagento 1 & 2

The hypernode-importertool is suitable for both Magento 1 and 2 shops

This tool executes the following tasks:

  • Copying the database
  • Copying all the content
  • Replacing caching through memcached with Redis
  • Adjusting symlinks and paths
  • Repairing the modman directory if existent
  • And several other options.

The hypernode-importer is a very comprehensive tool as it has several alternative options and scenario’s. You can import from a local database dump, use a local compressed file, copying additional databases, setting maintenance mode on the source server and skipping files that should not be copied. Please use the hypernode-importer --help flag to list all available options.

Please follow these steps:

  • Log in on your Hypernode with SSH
  • Use the hypernode-importer to automatically migrate your site to your Hypernode. All data currently on your Hypernode will be overwritten. Its usage is simple:
  • hypernode-importer --host SSH_HOSTNAME --user domain.com --path domain.com --set-default-url
  • You need to change domain.com to the domain from which you want to import your Magento shop. The SSH_HOSTNAME should be changed to the hostname of your SSH server.
  • The --set-default-url option will change the base-url of your Magento shop to name.hypernode.io, so don’t forget to restore your original URL after testing.
  • Sit back while we do the work 🙂

Option 3: Manually migrate you shop to Hypernode

If anything goes wrong (authentication, error during copy), you can just rerun the importer after fixing cause of the error, or manually migrate Magento to Hypernode if the importer went south (please file a bug report too).

Developing a new Magento shop?

No problem! New Hypernodes are delivered with Magento preinstalled, so you’re good to go!
The default Magento installation is located in the /data/web/public directory. It is configured to use a database named YOURAPPNAME_preinstalled_magento and database credentials from the ~/.my.cnf file.

The Magento admin and database credentials will be emailed to you when your Hypernode is ready.

Starting over and need a fresh Magento install? Take a look at Installing Magento on Hypernode.

Done migrating?

Done? Now it’s time to check if everything works as it should!

Tips and tricks

  • You could also use screen or tmux to migrate your shop in a terminal session. Use man screen or man tmux to learn more about these commands.
  • The Shop importer first uses rsync to copy the file content and retrieves the database credentials required to dump the database from the copied configuration files. This implies that if you already imported another shop before, you should first remove the old content of the other shop before migrating a new one.

0