|
Barebones Guide: 1and1.com Shared Hosting Installation (North America)
[As of Mar. 31th, 2008 - Using Magento Version 1.0]
Hello everybody!
I thought I’d write up a ‘for dummies’ guide for those using the 1and1.com shared hosting based in North America. This is to consolidate everything into one thread and in the simpliest way possible, for those needing a step by step guide.
First, a disclaimer. This is mostly from my own personal experience in setting up Magento in the outlined environment for my client. I may have taken pieces of information from all over the boards and stuff so, my apologies if somebody has already mentioned it first and thank you for doing so. If I have missed something or there is another way to do something, just reply below to say so. Now, let’s begin.
--- FRESH INSTALL GUIDE (NOT UPGRADE) ---
[1. Basic Requirements]
Hosting
- 1and1 Beginner/Home/Business/Developer
Note: 1and1 Dedicated Managed is UNSUPPORTED due to platform MySQL 4.0.97! http://www.magentocommerce.com/boards/viewthread/4970/
PHP 5.2.0 or newer
- To test your version, create a file named .htaccess
- Place the following in it:
AddType x-mapp-php .php4
AddType x-mapp-php5 .php
- Save and upload to your root directory. It should be located at http://www.your_domain.com/.htaccess, however, you will not be able to access it directly via the web browser.
- Next, create a file named info.php
- Place the following in it:
<?php phpinfo();?>
- Save and upload to your root directory as above.
- Go to http://www.your_domain.com/info.php and it will list your PHP Version number at the top left corner (Should be 5.2.0 or greater)
PDO/MySQL, mcrypt, simplexml, DOM
- Accessing http://www.your_domain.com/info.php will show you which extensions are installed and all of those should be listed already.
Final Check
- If all of the above checks out, let’s set up your MySQL Database.
[2. Set Up MySQL Database]
- Go to admin.1and1.com
- Login with your site project credentials
- Go to the Section “Web Space & Access” -> “MySQL Administration”
- Click on the “New Database” Button in Blue.
- Type in a Description and Select “MySQL 5.0” -> “Set Up”, followed by “Go to Overview”
- Set Up will take a while, either sit back and wait or continue on.
- Fair Warning! Status should be “ready” and not “setup started” BEFORE you can use the database!
[3. Download, Upload and Unpack Magento]
Download
- Go to MagentoCommerce.com -> Download -> Download Magento
- Choose latest 1.x.xxxxx.zip and Click the Orange “Download Now” Button
- Save the File on your Computer somewhere you can find it.
Upload
- Now, Upload the Whole Single ZIP file to your root directory. (eg. http://www.your_domain.com/zip_file.zip)
- In the 1and1.com Control Panel, go to “Web Space & Access” -> “WebspaceExplorer” (note: you may prefer to use SSH if you use the business or developer package)
- It should load up a 2 column panel. If it doesn’t, try clicking once on the “/” icon.
- “magento-0.x.xxxxx.zip” should be listed on the right column.
Unpack
- Right Click on “magento-0.x.xxxxx.zip” and Select “Unzip”.
- It will ask you where to place the files, Select the “/” (aka Root) -> “OK”. After a while, it will complete. (You may select a custom path if you’re comfortable with it)
- After it completes, you should see the folder “magento”
[4. CHMOD Magento]
- If you use Windows Hosting, skip this and go to Part 5.
- You need to CHMOD the following files and directories to 777.
[file] magento/var/.htaccess
[dir] magento/app/etc
[dir] magento/var
[dir] magento/media
- To do that, you can use “WebspaceExplorer” -> “Change Permissions” OR use your favorite FTP/CHMOD tool.
[5. Configure Magento .htaccess]
- Download the file located at magento/.htaccess
- Open it up and edit it as follows:
Change (If you plan to use SSL, check post below, then continue from here):
#AddType x-mapp-php5 .php
To:
AddType x-mapp-php .php4
AddType x-mapp-php5 .php
AddHandler x-mapp-php .php4
AddHandler x-mapp-php5 .php
Change:
#RewriteBase /magento/
To (If you placed it somewhere else, update it here):
RewriteBase /magento/
- Save and Upload the file to replace the file located at magento/.htaccess
[6. Installing Magento]
Accessing Install Wizard
- Make sure your MySQL Database in Part 2 (above) is now saying “ready”.
- Go to http://www.your_domain.com/magento/index.php/install OR http://www.your_domain.com/magento/install (Directories may change depending on where you placed your files)
- It should now load up the Magento Installation Wizard.
Setup
- Read and Agree to the License Agreement -> Continue
- Select the “Locale”, “Time Zone” and “Default Currency” -> Continue
- Using the MySQL 5.0 Database you created earlier, just copy and paste in the information.
- Host (Host Name), Database Name (Database Name), User Name (User Name), User Password (Password)
- Tables Prefix can be left as blank.
- Under “Web Access Options” -> Select “Use Web Server (Apache) Rewrites”
- Under “Use Secure URLs (SSL)”, only select IF YOU HAVE SSL CERTIFICATE INSTALLED.
- Click Continue and Wait for it to generate your database tables. (aka grab a drink)
- Create your Admin Account and Type in an Encryption Key if you like (it will be automatically generated if you don’t. I assume this would be the seed value, to prevent rainbow tables or whatnot)
- Write down and keep the Encryption Key as noted.
[7. Running Magento]
- FrontEnd: http://www.your_domain.com/magento
- Backend: http://www.your_domain.com/magento/admin (or without rewrite, http://www.your_domain.com/magento/index.php/admin)
Everything should be working now.
CONGRATULATIONS!
- Mike.
|