Installation and set-up

Generate a pair of public/private keys

In order to connect Bluestore to your Magento store securely we need to generate SSH encryption keys. This can be done using Open SSL.

The commands are as follows:

openssl genrsa –out privatekey.pem 1024

openssl req –newkey rsa:1024 –x509 –key privatekey.pem –out publickey.cer –days 365.

Register a new application in Bluestore

Login to your Bluestore enterprise console. Go to Settings/Bluestore API and create a new application. Paste the full public certificate.

addapplication.jpg

You'll then have an Access Token and API Key.

api.jpg

Install the Bluestore extension on Magento

You can find the Bluestore extension in the Magento Connect store here http://www.magentocommerce.com/magento-connect/bluestore-live-connector-1138.html

Select the key ready to paste.

magentoconnect.jpg

 

Login to your Magento admin and then to System/Magento Connect Manager area

Paste the extension key and press Install

bluestoreinstall.jpg

After successful installation, clear all the cache, logout and login to Magento admin area again. You'll see Bluestore present in the top menu. (Don't try to use import/export at this stage).

bluestoreinmenu.jpg

 

Create a new web service user and role

In Magento admin go to System/Web Services/SOAP/XML RPC Users. Add a new user, filling in all fields. API Key can be manually generated or you can use a tool such as http://randomkeygen.com/

Save the user then create a new role System/Web Services/SOAP/XML RPC Roles. Add new role and select "All" for Resource Access. Assign your new user to this role.

 Set up the Bluestore extension in Magento

Go to System/Configuration/Services/Bluestore Live

Fill in the authentication tab first.

Magento API Username - the username of the new SOAP user you've just created.

Magento API Password - The API key of the new SOAP user you've just created

Bluestore API Key - You'll see the API key in the list of application in Bluestore console Settings/Bluestore API

Bluestore API Token - You'll see the Access Token in the list of application in Bluestore console Settings/Bluestore API

Authentication Certificate - Private Key - Paste the whole private key here.

authentication.jpg

 Direct Mapping and Mapping Table

Both Bluestore and Magento generate their own ids and codes for categories and products, these need to match or otherwise be mapped to one another in a database intermediary table.

If you already have a Bluestore enterprise filled with live data but a brand new Magento installation with no data, then use option direct mapping.

If you already have a Bluestore enterprise filled with live data and an already functioning Magento store filled with live data that you want to link together, use option mapping table.

If you have a new Bluestore installation with only sample data and an already functioning Magento store filled with live data, you would need to:

1) delete Bluestore sample data

2) export your category data from Magento using Bluestore/Export/Download categories in csv format. In Bluestore admin console, import csv and see categories have been populated.

3) Export your product data from Magento using System/Export entity type - products.

4) Convert your data fro the csv to our product import template for Bluestore https://www.bluefishretail.com/file-downloads/category/2-import-templates. Import to Bluestore and see products have been populated successfully.

 

It's important to remember that in any of these instances, Bluestore is the master and Magento the slave. Any changes to products or additions to your inventory should be made in Bluestore, Magento will then be automatically updated.

 

 Setting the Cron

Each section of the Bluestore extension settings allows you to set a timetable for the two services to sync. You can change these at any time, but for this to happen automatically at every given interval, you first have to enable to cron through your hosting.

 In most hosting Cpanel there is a cron option where you add the path to the file cron.php that lives in the root of your magento installation.

In UNIX/BSD/linux systems you will need to add this line (or a similar line) to your crontab:  

 

# for debugging purposes only:
    MAILTO=your.user@your.server.com
    
    */5 * * * *  /bin/sh /absolute/path/to/magento/cron.sh
    
    # /absolute/path/to/bin/php - replace with path to your PHP5 CLI executable
    # example: /usr/local/php5/bin/php-cli
    
    # in order to find what is the PHP CLI executable you can try to the following command in shell:
    # which php
    
    # /absolute/path/to/magento/cron.php - replace with path to Magento installation
    # example: /home/user/public_html/magento/cron.php

If you can’t get the above to work your version of crontab might not be supporting the */5 syntax. Try this instead:

    0,5,10,15,20,25,30,35,40,45,50,55 * * * * /bin/sh /absolute/path/to/magento/cron.sh

 

Enable error logging

Should any errors occur on each import/export of data, it's helpful to be able to pinpoint the problem. Enable System/Configuration/Developer/Log Settings - Enabled - Yes.

The path is /var/log/

Import/Export

You are now set up to use the import/export options in Magento Bluestore extension for the first time.

 

Have more questions? Submit a request

0 Comments

Article is closed for comments.
Powered by Zendesk