Setting up OXID eShop on a LAMP system on LinuxMint
This is more or less a notice to myself. I switched to LinuxMint recently and tried to setup a LAMP system including all modules in order to run OXID eShop on it (I basically need it for my daily work). This became fairly different to the Ubuntu installations I ran before, and I found some dodgy tricks that I want to document here.
First off, this is the exact Linux version I run, found with $ cat /etc/*-release
DISTRIB_ID=LinuxMint
DISTRIB_RELEASE=1
DISTRIB_CODENAME=debian
DISTRIB_DESCRIPTION="LMDE Cinnamon Edition"
PRETTY_NAME="Linux Mint LMDE"
NAME="Linux Mint LMDE"
ID=linuxmint
Open your terminal client to install Apache2 (web server), MySQL (data base server + client) and PHP version 5 (interpreter language) on your machine. This is possible in a single step; please note that you’ll be asked for the root password during the installation:
$ sudo aptitude install apache2 mysql-server mysql-client php5
This command will install Apache/2.4.6 (Debian), PHP version 5.5.1-2 and MySQL version 5.5.31 to your machine at the present date.
After that, download OXID eShop, make a new directory oxideshop_ce in /var/www/ and unzip the package to it. Fire up your browser and enter http://localhost. Now the setup routine of OXID eShop shall appear and will complain diverse PHP extensions as not installed: “Your system doesn’t fit the requirement. The OXID eShop will not work without it and cannot be installed.” (sorry I didn’t take a screen shot).
In my case, the following modules had to be installed separately:
- JSON
- MySQL client connector for MySQL 5
- GDlib v2 [v1] incl. JPEG support
- cURL
Please use this command to install all of this extensions just in one piece:
$ sudo aptitude install php5-json php5-mysql php5-gd php5-curl
Now restart your apache service:
$ /etc/init.d/apache2 reload
Reload the web page in your browser at http://localhost and you’ll see that the error messages at least for the PHP extensions will have turned from this little red crosses into green hooks. Two things left over: “Apache mod_rewrite module” and “Files/folders access rights”. Let’s fix it quickly:
$ a2enmod rewrite
for enabling the mod_rewrite module in apache. Additionally, you’d have to alter (caution, this is different to any other location I’ve seen yet!) AllowOverride None to AllowOverride All in /etc/apache2/apache2.conf this block:
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
Restart your apache service once again to see that this issue is resolved. If you run your own local machine, maybe just for testing, it shall be okay to change the rights for the entire folder oxideshop_ce to 0777. If this is your development or staging environment, be careful and go closed to the instructions given at http://wiki.oxidforge.org/Installation#Files_.26_Folder_Permission_Setup. Please don’t forget the -R command for recursive to all folders and files.
You’re done and can now start to install OXID eShop on your own localhost!