This is actually really easy, assuming you are using the base version of PHP (5.3.X) from the AWS package repository. YUM has phpMyAdmin as a package and most of the default settings work just fine. The first time I install on an AWS instance it took maybe 15 minutes to complete.
Installing phpMyAdmin
These instructions assume you have already setup an AWS instance and have an SSH client (like PuTTY) available and a SCP client (like WinSCP) to use when editing the configuration files.
- Log in to your instance via the SSH client. Transfer to the root user ("sudo su").
- Use YUM to install phpMyAdmin
- Press "Y" when it asks if you want to install phpMyAdmin
- Open the SCP client and go to the apache2 configuration files directory (default is "/etc/httpd/conf.d")
- Open the "phpMyAdmin.conf" file.
- Add an access exception to apache2 authentication protocol. There are three safe ways to allow access to phpMyAdmin;
- Allow Exception from a static IP Address Under the Directory tag "/usr/share/phpMyAdmin/", add the following line at the end of the tag, "Require ip XXX.XXX.XXX.XXX" and the following line at the end of the tag, "Allow from XXX.XXX.XXX.XXX". In each situation you should be replace XXX.XXX.XXX.XXX with the actual IP address.
- Allow access from a VPN You will need a Virtual Private Network setup already, which is well beyond these instructions. Under the Directory tag "/usr/share/phpMyAdmin/", add the following line at the end of the tag, "Require ip XXX.XXX.XXX.XXX" and the following line at the end of the tag, "Allow from XXX.XXX.XXX.XXX". In each situation you should be replace XXX.XXX.XXX.XXX with the actual IP address.
- Use SSL Certificate for authentication These instructions are not complete yet.
- Save the edited "phpMyAdmin.conf" file.
- Verify the installation occurred correctly by starting/restarting the httpd service (in SSH "service httpd restart")
Summary of command line inputs
- $ sudo su
- $ yum install phpmyadmin
- .....
- Do you want to install phpMyAdmin 5.x (Y/N): Y
- $ service httpd restart
First few lines of phpMyAdmin.conf file with default installation path, edited for access by a single IP address
- # phpMyAdmin - Web based MySQL browser written in php
- #
- # Allows only localhost by default
- #
- # But allowing phpMyAdmin to anyone other than localhost should be considered
- # dangerous unless properly secured by SSL
- Alias /phpMyAdmin /usr/share/phpMyAdmin
- Alias /phpmyadmin /usr/share/phpMyAdmin
- <Directory /usr/share/phpMyAdmin/>
- <IfModule mod_authz_core.c>
- # Apache 2.4
- <RequireAny>
- Require ip 127.0.0.1
- Require ip ::1
- Require ip XXX.XXX.XXX.XXX
- </RequireAny>
- </IfModule>
- <IfModule !mod_authz_core.c>
- # Apache 2.2
- Order Deny,Allow
- Deny from All
- Allow from 127.0.0.1
- Allow from ::1
- Allow from XXX.XXX.XXX.XXX
- </IfModule>
- </Directory>
- ...
Configuring phpMyAdmin
The default configuration of phpMyAdmin needs only a few changes to get it working correctly.
- Log in to your instance via the SCP client (like WinSCP)
- Open the phpMyAdmin base directory (default AWS installation directory is "/usr/share/phpMyAdmin")
- Open the file "config.sample.inc.php"
- Go down to the line "$cfg['blowfish_secret'] = 'XXXXXXXX';" where XXXXXX is some alphanumeric combination. Add a bunch more letters and numbers within the single quotes.
- Go down to the line "$cfg['Servers'][$i]['controlhost']" and make sure it is uncommented. After it, add "= 'localhost';"
- The next line should be "$cfg['Servers'][$i]['controluser']"and make sure it is uncommented. After it, add "= 'USERNAME';" where USERNAME is the username you want to log into phpMyAdmin using.
- The next line should be "$cfg['Servers'][$i]['controlpass']"and make sure it is uncommented. After it, add "= 'PASSWORD';" where PASSWORD is the password associated with the previously entered username.
- Save the file as "config.inc.php".
- Use YUM to install phpMyAdmin
- Press "Y" when it asks if you want to install phpMyAdmin
- Open the SCP clint and go to the apache2 configuration files directory (default is "/etc/httpd/conf.d")
- Open the "phpMyAdmin.conf" file.
- Direct your browser to "http://XXX.XXX.XXX.XXX/phpMyAdmin" where XXX.XXX.XXX.XXX is the IP address of your server. You should be prompted for a username and login. Enter the pair you just saved in the config file and you should run phpMyAdmin.