INSTALL

ZWarehouse is standard Zope product. To install it, just put it to your Zope Product directory. As every product, it has some other products in dependencies list, please check ZwarehouseDependencies.

In short, to install Zwarehouse you will need to do the following:

  1. Download and install Zope (ZwarehouseSubversionCheckout or ZwarehouseDownloadLocations)
  2. Have MySQL database connection (username, password, database name, host)
  3. Install ZwarehouseDependencies
  4. Add ZWarehouse as Product to Zope
  5. Configure ZWarehouse (See "Step by step installation guide")

Step by step installation guide

ZWarehouse Folder

OK, we assume that you have downloaded and installed Zope, ZWarehouse, ZwarehouseDependencies and now its time to configure it.

As first step come to your Zope Administration Interface (ZMI) and add folder where ZWarehouse will be located. Usually I call the folder the same name as store domain name:

http://dev.zwarehouse.org/attachment/wiki/INSTALL/add_folder.png?format=raw

Adding connection to SQL

We will use MySQL (and in fact PostgreSQL will not be ready until ZWarehouse 0.9.5). Please note that ZMySQLDA database apapter product must be installed.

Screenshots of adding MySQL connection:

http://dev.zwarehouse.org/attachment/wiki/INSTALL/add_mysql_connection_1.gif?format=raw http://dev.zwarehouse.org/attachment/wiki/INSTALL/add_mysql_connection_2.gif?format=raw

Don't know how to add MySQL database and user? No problem, here is tip for 'mysql' command line: 

alex@dom ~ $ mysql -u root -p<your mysql database root password>
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 5 to server version: 4.1.14-log

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql> create database zwarehousedb;
Query OK, 1 row affected (0.08 sec)

mysql> grant all privileges on zwarehousedb.* to zwarehouse@localhost identified by 'weeV7eeP';
Query OK, 0 rows affected (0.11 sec)

mysql> flush privileges;
Query OK, 0 rows affected (0.02 sec)

mysql>

Add MailHost?

Zwarehouse sends email to its users. Emails include email on registration, email on order change, email for "forget password" function. So, without MailHost user will not be able to register. Here are screenshots showing how to add MailHost. Substitute 'mail' to your mail server address.

http://dev.zwarehouse.org/attachment/wiki/INSTALL/add_mailhost_1.gif?format=raw http://dev.zwarehouse.org/attachment/wiki/INSTALL/add_mailhost_2.gif?format=raw

Adding ZWarehouse Product

Now, when all the required objects were added, we are adding ZWarehouse by itself:

http://dev.zwarehouse.org/attachment/wiki/INSTALL/add_ZWarehouse.gif?format=raw

Here is how your Zope folder should look when all products were added:

http://dev.zwarehouse.org/attachment/wiki/INSTALL/zwarehouse_added.gif?format=raw

Create tables structure

Now, we have to manually run the script to create database structure. To do this, browse by the following sequence: /www.webshop4.us/ZWarehouseDB/skins_tool/presets/US_CLEAN_09 , then press "Test" and "Submit Query".

http://dev.zwarehouse.org/attachment/wiki/INSTALL/US_CLEAN_09_test.gif?format=raw

In normal circumstances you should see result as: 'This statement returned no results.':

http://dev.zwarehouse.org/attachment/wiki/INSTALL/db_created.gif?format=raw

Congratulations

Now your installation is finished. You should see your Zwarehouse cart when you press 'view' inside of 'ZWarehouse' folder. Later you can point Virtual Host to this folder. Some people (as I do) prefer to relocate ZWarehouseAdmin instance to inside of ZWarehouse folder, so admin will be accessible from main domain - this is a matter of user preferences, but do not forget to change zw_admin_location in ZWarehouse folder properties.

Please fill a bug if you find this documentation not clear. Please also note that we come from non-English speaking country, so if you see any syntax, grammar or other errors, we will be happy to fix them as soon as you report.

Common errors

Happy ZWarehousing! Alex & Halogen-D.G. Team

Attachments