Migrate Magento 1 to Hypernode
Congratulations with your brand new Hypernode! In case you already have a Magento 1 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.
Please refer to this article if you would like to import a Magento 2 shop.
Table of contents
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.
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. For more features, use the
hypernode-importer --help flag to list all available options.
** 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.**
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
- 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.
Migrate your shop via Shell using
- Log in on your Hypernode with SSH
- Use the
hypernode-importerto 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_HOSTNAMEshould be changed to the hostname of your SSH server.
--set-default-urloption 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 🙂
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 bugreport 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
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? Now it’s time to check if everything works as it should!
Tips and tricks
- You could also use
tmuxto migrate your shop in a terminal session. Use
man tmuxto learn more about these commands.
- The Shop importer first uses
rsyncto 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.