Table of contents
- 1. How to start/stop the servers?
- 2. How to change the default URL?
- 2.1. Automatic approach
- 2.2. Manual approach
- 3. How to create a full backup of Magento?
- 4. How to upgrade Magento?
- 5. Where is the administration interface of Magento?
- 6. Which is the administrator username and password?
- 7. How to install a plugin on Magento?
- 8. What is my Magento encryption key?
- 9. How do I set up Magento to send emails through my Gmail/Google Apps account?
- 10. How to enable SSL?
- 11. How to debug Magento errors?
- 12. How to increase the allowed size of the uploaded files?
- 13. How do I set up Beetailer?
- 14. How do I protect my application with a password?
- 1. How to start/stop the servers?
- 2. How to change the default URL?
- 2.1. Automatic approach
- 2.2. Manual approach
- 3. How to create a full backup of Magento?
- 4. How to upgrade Magento?
- 5. Where is the administration interface of Magento?
- 6. Which is the administrator username and password?
- 7. How to install a plugin on Magento?
- 8. What is my Magento encryption key?
- 9. How do I set up Magento to send emails through my Gmail/Google Apps account?
- 10. How to enable SSL?
- 11. How to debug Magento errors?
- 12. How to increase the allowed size of the uploaded files?
- 13. How do I set up Beetailer?
- 14. How do I protect my application with a password?
Magento is a feature-rich, professional open-source e-commerce solution that offers merchants complete flexibility and control over the look, content, and functionality of their online store.
Please, take a look to the Quick Start Guide to know the basic use of this Stack.
How to start/stop the servers?
The Stacks include a graphical tool to manage the servers easily. You can find the "manager-windows.exe", "manager-osx" or "manager-linux" tool in your installation directory. Using this tool, you can Start, Stop or Restart the servers and check the log files. You can click on the icon to start it.
On Windows: You can also start the Manager tool from shortcuts: Start -> Program Files -> BitNami Stack -> Manager tool
If you prefer, you can use the "ctlscript.sh" utility from the command line. This script is in the installation directory.
On OS X: You can start the Manager tool from the installation directory or you can use the "ctlscript.sh" utility from a Terminal.
host:~ user$ cd /Applications/application-version host:~ user$ ./ctlscript.sh start
On Linux:
$ cd ~/applicaton-version $ ./ctlscript.sh start
How to change the default URL?
Automatic approach
The Virtual Appliances, BitNami Cloud Hosting and AMI images ship a tool called "updateip". Using this tool you be able to configure the URL automatically. It includes a new option to remove the "/magento" prefix from the URL. If you want to modify that you can run the following command:
$ sudo /opt/bitnami/apps/magento/updateip --appurl /
Now you will be able to access to the Magento application at http://YOUR_DOMAIN instead of http://YOUR_DOMAIN/magento. In case you have already configured your domain name, it is also required to specify the domain name:
$ sudo /opt/bitnami/apps/magento/updateip --appurl / --machine_hostname your_domain
On Windows:
This tool is also included for Windows. You can open the "Use BitNami Magento Stack" command prompt from the Windows shortcuts and run the following comand:
> cd apps\magento > updateip.exe --base_directory "C:\Program Files\BitNami Magento Stack" --appurl /
Manual approach
1) An easy approach to have your application in the root URL is to uncomment the following lines in your application configuration file /installdir/apps/magento/conf/magento.conf. This approach only changes the initial page of your application, not the internal urls, all the links point to "http://yourdomain/magento". If you do not see these lines you can add them at the end of the file. Note that "magento" could be wordpress, joomla, drupal, etc.
# Uncomment the following lines to see your application in the root # of your URL. This is not compatible with more than one application. RewriteEngine On RewriteRule ^/$ /magento/ [PT]
Using this configuration and restarting the Apache server you can see your initial page of your application in the root URL.
2) Another option is to configure your application to run in the root URL directly. The details are described below (if you have already configured the application using the first method, note that you have to revert the change before continuing with this approach).
If you want to change the default URL from http://your_domain/magento to http://your_domain, you should add a "DocumentRoot" entry in your application conf file. Edit the /installdir/apps/magento/conf/magento.conf file to add this line and commenting the "Alias" entries.
magento.conf file content:
DocumentRoot "/installdir/apps/magento/htdocs" # Alias /magento/ "/installdir/apps/magento/htdocs/" # Alias /magento "/installdir/apps/magento/htdocs" (..)
Some applications also require changes in their configuration files or in the database.
If you want to change the default URL from http://your_domain/magento to http://your_domain, you should add a "DocumentRoot" entry in your application conf file. Edit the /opt/bitnami/apps/magento/conf/magento.conf file to add this line and commenting the "Alias" entries. You can use the "nano" editor:
$ sudo nano /opt/bitnami/apps/magento/conf/magento.conf
magento.conf file content:
DocumentRoot "/opt/bitnami/apps/magento/htdocs" # Alias /magento/ "/installdir/apps/magento/htdocs/" # Alias /magento "/installdir/apps/magento/htdocs" (...)
Some applications also require changes in their configuration files or in the database.
If you want to change the default URL from http://your_domain/magento to http://your_domain, you should add a "DocumentRoot" entry in your application conf file. Edit the /opt/bitnami/apps/magento/conf/magento.conf file to add this line and commenting the "Alias" entries. You can use the "nano" command line editor or you can also edit this file from your favorite FTP program.
$ sudo nano /opt/bitnami/apps/magento/conf/magento.conf
magento.conf file content:
DocumentRoot "/opt/bitnami/apps/magento/htdocs" # Alias /magento/ "/installdir/apps/magento/htdocs/" # Alias /magento "/installdir/apps/magento/htdocs" (...)
Some applications also require changes in their configuration files or in the database.
Magento also saves the URL in the database. If you have changed the URL or you are trying to access from a different machine and Magento does not work, you have to modify the domain name or the URL you should run the following command to modify the database:
$ mysql -u root -p -e "USE bitnami_magento; UPDATE core_config_data SET value ='http://NEW_DOMAIN/' WHERE core_config_data.path = 'web/unsecure/base_url'; UPDATE core_config_data SET value ='https://NEW_DOMAIN/' WHERE core_config_data.path = 'web/secure/base_url';"
And remove the cache:
$ rm -r /installdir/apps/magento/htdocs/var/cache/* $ rm -r /installdir/apps/magento/htdocs/var/session/*
Virtual Appliances, BitNami Cloud Hosting and AMI images include a tool called "updateip" which updates the IP automatically during boot. Note that this tool changes the URL to http://NEW_DOMAIN/magento. If you have your application in the root URL you should use the previous "mysql" command.
$ /opt/bitnami/updateip --machine_hostname NEW_DOMAIN
If you have configured Magento to use an static domain name or IP, you should rename or remove the "/opt/bitnami/apps/magento/updateip" file in recent versions (or /opt/bitnami/updateip in previous versions).
How to create a full backup of Magento?
Because BitNami stacks are self-contained, the simplest option for performing your backups is to copy or compress the BitNami Stack installation directory. To do so in a safe manner, you will need to stop all servers, so this method may not be appropriate if you have people accessing the application continously.
On Linux and OS X:
$ cd installdir $ ./ctlscript.sh stop $ cp -r installdir application-backup
Or you can create a tarball:
$ tar -czvf application-backup.tar.gz installdir
Or a zip file:
$ zip -r application-backup.zip installdir/*
To restore this backup you only need to uncompress the backup in the same location. It is important to use the same path that was used when the stack was originally installed.
For example if you have a backup in a Red Hat machine, you can copy it to an Ubuntu Linux machine (a different distro!) in the same location. Then start the servers and that’s all.
$ cd installdir $ ./ctlscript.sh start
You just need to be carefull to keep the same permissions for the files and folders. If you installed as root make sure that in the new machine you copy the files also as root. And this case, if you are also moving MySQL or PostgreSQL, you will need to create those users in the new machine (if they don't exist yet).
On Windows:
On Windows, you should follow the same process. Stop the servers using the shortcuts and copy the whole installation directory. To restore the system, copy the directory to a different Windows machine in the same location and follow these steps from a command prompt:
$ cd installdir $ serviceinstall.bat INSTALL
You can access your BitNami Application at the usual URL.
If you want to create only a database backup, check the following link for MySQL /Components/MySQL#How_to_create_a_database_backup or for PostgreSQL
/Components/PostgreSQL#How_to_create_a_database_backup.3fHow to upgrade Magento?
It is strongly recommended that you create a backup before starting the update process. If you have important data, it is advisable that you create and try to restore a backup to ensure that everything works properly.
There are two different ways to upgrade your application.
- If you want to upgrade the application and all Stack components PHP, Ruby, MySQL, Apache… You can follow the steps described at How to upgrade the full Stack migrating the data?
- In case you only want to upgrade the application code without modifying any other Stack components, you should follow the guide which is in the application page itself.
One of the options for the method 2 is to use Magento Connect interface for upgrading your plugins including the Magento Core. Open Magento's administration panel and go to System > Magento Connect > Magento Connect Manager. Select "Check for updates" and select which components you want to upgrade.
Where is the administration interface of Magento?
The admin panel is located at http://your_domain/magento/index.php/admin
Which is the administrator username and password?
If you used the native installer you should have been prompted for the username and password during the installations.
If you are using a BitNami Virtual Appliance or a BitNami AMI then the default username is user and the default password is bitnami1.
For BitNami Cloud Hosting check this.
How to install a plugin on Magento?
Open Magento's administration panel (http://your_domain/magento/index.php/admin) and go to System > Magento Connect > Magento Connect Manager.
Paste the extensions' key (available on Magento Connect) and click install.
What is my Magento encryption key?
Your encryption key is located at /installdir/apps/magento/conf/magento_info.txt and is randomly generated during the install process. You will need it to restore backups.
How do I set up Magento to send emails through my Gmail/Google Apps account?
Manual approach
If your Magento installation does not support the ASchroder SMTP Pro extension bellow, SMTP settings can be set manually by editing the following file: installdir/apps/magento/htdocs/app/code/core/Mage/Core/Model/Email/Template.php and filling the following configuration parameters in the getMail() function:
$config = array(
'ssl' => 'tls',
'port' => '587',
'auth' => 'login',
'username' => '<your_username>@gmail.com',
'password' => '<your_gmail_password>'
);
$transport = new Zend_Mail_Transport_Smtp('smtp.gmail.com', $config);
Using ASchroder SMTP Pro extension
You will need to configure your Magento installation to be able to send emails from it. When you finish this tutorial you will be able to send and receive emails from your customers (receipts, customer support...), you will also be able to send these emails from a number of customized departments ("Sales" and "Customer Support", for example) and your customers will not know that the mail comes from a Gmail account.
The first step is to install a free extension called ASchroder SMTP Pro. Open your Magento admin panel (http://your_server/index.php/admin/) and go to System > Magento Connect > Magento Connect Manager:
Supply your username and password and log in:
Copy and paste the extension key into the text field ("http://connect20.magentocommerce.com/community/ASchroder_SMTPPro", without quotes) and click install.
Magento Connect will now fetch the extension information. Click Proceed to continue.
At the bottom of the screen you will see a log of the install process. When the process is over, check the output for error messages and click Refresh to continue.
The extension will now appear in the extension list.
Open the Administration panel again (http://your_server/index.php/admin/) and go to System > Configuration.
To configure your store email adresses, look in the left side of the page for a navigation frame like the one below. Click the section named "Store email addresses".
Enter the names of the departments that you have and the emails addresses associated with them. These need to be real email accounts, as these addresses will be the ones your customers will see. Click on "Save Config" when you are done.
Next step is to configure Magento to send all store email through your Gmail/Google Apps account. Look in the navigation section again and find the section called "System".
Inside "SMTP Pro Email General Settings", choose "Google Apps/Gmail" as your extension option and change "Use Store Email Addresses for Reply-to" to yes. You can also set "Log all messages" to yes if you would like to save all sent emails to the Magento email log. This setting does not affect the emails on your inbox.
Also, inside "SMTP Pro Email Google Apps/Gmail Settings" you have to enter your Gmail account information email and password. Click on "Save Config" when you are done.
To test that everything is working properly, locate a button labeled "Run Self Test" in the above screen. If you click it, a test email will be sent to your account. You can check the email log at any time at System > Tools > Email log.
How to enable SSL?
You can see how to configure Apache to enable SSL connections at How to set up SSL to access through https?
How to debug Magento errors?
Once Apache starts, it will create two log files, the access_log and the error_log /installdir/apache2/logs directory. You can change these files to see the exact error in the application.
The main MySQL log file is created at /installdir/mysql/data/mysqld.log file.
How to increase the allowed size of the uploaded files?
You can modify the following option in the php.ini file to increase the allowed size for uploads:
; Maximum size of POST data that PHP will accept. post_max_size = 16M ... ; Maximum allowed size for uploaded files. upload_max_filesize = 16M
How do I set up Beetailer?
Beetailer is a service that allows you to integrate your existing online store with Facebook, allowing you to display your products so Facebook users can discover, comment, share, and purchase them. http://beetailer.com
First of all, you will need to have a Magento installation with a publicly accessible IP. Then go to the admin panel (http://your_domain/magento/index.php/admin) and click on the "Facebook Store" tab. Follow the onscreen instructions.
How do I protect my application with a password?
To request a username and a password when accessing your application, follow these steps:
1. Run the htpasswd utility
$ sudo /installdir/apache2/bin/htpasswd -c /installdir/apache2/yourapplicationname_users username
AuthType Basic AuthName yourapplication AuthUserFile "/installdir/apache2/yourapplicationname_users" Require valid-user
3. Restart the Apache server:
$ sudo /installdir/ctlscript.sh restart apache
$ sudo /installdir/apache2/bin/htpasswd /installdir/apache2/yourapplicationname_users username
Comments