Download OXID eShop on a VMware appliance
From OXIDwiki
Contents |
General
This VMware appliance was made to show you the OXID eShop Community Edition web application in a working Linux web server environment. It is an ideal environment for locally building up your shopping cart system and is easy to copy to a real web server later (as described beneath). You will not find a GUI or a desktop. Nevertheless, you don't have to worry: It's pretty easy and described well ;)
For a newer version of the OXID eShop Community Edition, check http://www.oxid-esales.com/download
Another purpose of this VM is the use for developing own OXID eShop modules and check your modules for certification. In case you want to make your modules OXID certified please contact us.
TAKE CARE: For security reasons, do not use this VMware image as a productive web server!
The root password for this image is oxid.
There is also a second account, notroot with the password oxid.
The VMware appliance contains a Debian net installation as a basis, the following Debian packages where installed in addition from the official repositories:
- apache2
- mysql-server5
- php5
- php5-mysql
- gdlib
- openssl
- phpmyadmin
- openssh
- postfix
- subversion
Installation
- Download, install and configure the free VMWare Player:
http://www.vmware.com/download/player/ (registration might be required). - Start the VMware Player and open the file oxid_on_debian_etch.vmx of the downloaded package.
You will be asked if you moved or copied your appliance. Choose I moved it and hit enter. - Wait until the system is started up and login then with the user root and the password oxid.
Hint: Entering the password, there is neither a character nor a star shown! - Find out the IP address of your VMware by typing ifconfig inside your VM and pressing enter
- Note the IP address(eth0) somewhere. You may log off your VMware machine by typing exit now.
Hint: Working with the shop, you don’t have to login every time. Just start the VMware machine and go ahead. - Fire up your preferred browser and enter your gathered IP address followed by /oxid/, e.g.
http://192.168.13.131/oxid/ - Go ahead with the installation of your OXID eShop Community Edition. You might find this link helpful:
http://www.oxid-esales.com/en/resources/help-faq/eshop-manual/opening-setup, alternatively, visit our forums at http://www.oxid-esales.com/forum.
The database in your VMware machine is already prepared. Please enter the following in step 4.
Database hostname or IP : localhost
Database name : oxid
Database username : root
Database password : oxid - You are done. Have fun with your OXID eShop Community Edition!
How to access the files on my VMware machine
For file operations, you need to have an application like WinSCP (http://winscp.net/) installed. Connect to your VMware machine by entering its IP address on Port 22, using root as the user and oxid as the password.
The place where the websites are stored that you can point with your browser is /var/www/. You will find
the OXID eShop in the folder /var/www/oxid. Feel free to define your own design by adopting the
template files in /var/www/oxid/out/basic/. You may find this one helpful:
http://www.oxid-esales.com/en/resources/help-faq/eshop-manual/template-documentation-eshop-40
If you are an experienced user, you might want to work with the terminal. Just use your VMware machine.
How to access the database
We installed phpMyAdmin on the server. To access it, point your browser to http://youripaddress/phpmyadmin. The user/password is the same we used for the database itself: root and oxid.
SSL Support
The VMware appliance was designed including a working SSL key for testing purposes. To activate it, adopt your /var/www/oxid/config.inc.php this way:
$this->sSSLShopURL = "https://youripaddress/oxid";
$this->sAdminSSLURL = "https://youripaddress/oxid/admin";
Be aware to get a warning message of your browser like “there is a problem with your security certificate”. This is because of the self made SSL key on your server for testing purposes. Just go ahead loading the page.
E-mail Support
We installed postfix on the server. Basically, it is possible that you get e-mails from the shop but be aware you do not get it because your e-mail provider or your ISP filters it out due to any spam related reason.
Hint
Just a last hint: When you want to use your VMware appliance for another application or for another shop instance, you will probably generate a new folder and copy the files to it using e.g. WinSCP. As you are root (or notroot) with WinSCP, you need to give the web server the ownership to the files. Login to your VMware machine and enter the following line:
chown –R www-data /var/www/newfolder
