To start a Magento 2 upgrade, we need a Magento 1 webshop with some data. In this recipe, we will install the latest Magento version, 1.9, with the sample data for the new responsive theme.
To install a Magento 1 website, we need the following stuff:
A web server (Linux, Apache2, PHP, or MySQL)
The Magento 1.9 codebase
The Magento 1.9 sample data
Note
The Magento 1.9 codebase and sample data can be downloaded from the Magento site at http://www.magentocommerce.com/download.
The following stuff is recommended for the installation:
Command-line access
A virtual host (domain name) that is going to be your web root
Extract the Magento code archive in your webroot (the directory of the virtualhost). An
ls -lacommand should give you the following output:api.php app cron.php cron.sh downloader errors favicon.ico get.php includes index.php index.php.sample install.php js lib LICENSE_AFL.txt LICENSE.html LICENSE.txt mage media php.ini.sample pkginfo RELEASE_NOTES.txt shell skin var
Extract the sample data archive to a different folder from the webroot. Copy the contents of the
mediaandskinfolders to themediaandskinfolders in your webroot. We can do this by using the followingcpcommand:cp –R <path_to_sampledata_folder>/media/* <path_to_magento_folder>/media/ cp –R <path_to_sampledata_folder/skin/* <path_to_magento_folder>/skin/
Create a database for the Magento 1 installation and name it
magento1. We can do this by running the following commands:mysql -u <username> -p create database magento1; exit;
Import the
sqlfile that is in the sample data directory. This file contains a database that we will import into themagento1database. We can do this by running the following command:mysql -u <username> -p magento1< "path_to_sample_data.sql"Tip
To avoid permission problems, ensure that all files and folders have the right permissions. For security reasons, it is recommended that all files have just enough permissions so that only the right users can access the right files. When you give all the rights (777), you don't have permission problems because each user can read, write and, execute each file of your application. More information about file permissions can be found at http://devdocs.magento.com/guides/m1x/install/installer-privileges_after.html.
When the files are in the right place and the database is imported, we can run the Magento installer. Open your browser and go to the domain that is configured for your website. You should see the installer as in the following screenshot:
Continue with the installation process by accepting the terms and conditions.
On the next screen, choose the correct language, locale, and currency for your store.
On the configuration page, fill in the form with the right data:
Database Type: MySQL.
Host: Enter the hostname or IP address of your database server (
localhostif it is on the same machine).Database name: Enter
magento1in this field (or another name if you have a different name for your database).User name: Enter your database username.
User password: Enter your database password.
Tables prefix: Leave this field empty (the string in this field will be used to prefix all tables of your database).
Base URL: Enter the URL of your website in this field.
Admin path: Enter
adminin this field. This will be the path of the backend.Enable charts: For development, it is recommended that this be unchecked.
Skip Base URL Validation Before the Next Step: When checked, the wizard will check for a valid URL when processing this form.
Use Web Server (Apache) rewrites: Check this when the apache module
mod_rewriteis enabled.Use Secure URL's (SSL): This checkbox must be unchecked if you don't use HTTPS.
Submit this form and we will be forwarded to the next step. In this step, you can configure the administrator account. Fill in the right data and remember the username and password because this is required to manage the store. Leave the encryption key field empty.
After submitting this form, the installation is complete. Optionally, you can submit the Magento survey. At the bottom of the page, there are buttons to navigate to the frontend and backend. When going to the frontend, you can see a demo shop with sample data as in the following screenshot:
The layout is responsive. When scaling your browser to a smaller width, the website will switch to the mobile layout like in the following screenshot:
We have just created a fully functional Magento 1 store. The webshop is fully configured and filled with data about products, customers, and orders, just the data we need to migrate to Magento 2 (in the upcoming recipes).
When installing a new shop, you have to follow the installer. This interface creates a configuration file app/etc/local.xml. If the file doesn't exist, Magento will launch the installer wizard. If the file is there, Magento will run the shop.
With a valid local.xml file, it is technically possible to install a new Magento shop, but this is not recommended because some settings such as a backend user, time zone, and currency are not set. These are actions that you have to do manually when choosing for this method.