Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Original Magestore POS Package is the package that only contains Magestore POS product originally (the package is built for widely usage base on Magento fresh installation, not on any customer environment-specific, so it does not contain any specific features/integration/bug fixing for your environment, some unexpected conflict with other extensions may occur when installing or after the POS installed).

Note

Notice

This guide applies to the brand new installation of Original Magestore POS on your website (you don’t have any Magestore POS installed on your website yet). In case that you want to migrate from the old Magestore POS system or upgrade across lines of POS, please contact with Magestore Support Team to get a suitable guideline.

If you are looking for the guide to install the updated Original Magestore POS, it’s here.

Compatibility Check

Please check the link below to make sure that the POS version you are having is compatible with your current Magento version.

Prerequisite

Magestore POS Line 4 (POS Pro 4, POS Pro Commerce 4, POS Enterprise 4, POS Enterprise Commerce 4) requires MSI to be installed and enabled before installing the POS. You can follow the guide Install Inventory Management from Magento to install and enable MSI.

POS Installation

1. Take a backup of your website

The backup will help you recover faster in case that you are failed to install Magestore POS due to some conflict with other extensions or unexpected incidents while installing the POS.

2. Turn on Maintenance

Code Block
php bin/magento maintenance:enable

3. Turn off Magento Cron

Code Block
php bin/magento cron:remove

4. Turn on Developer mode

Code Block
php bin/magento deploy:mode:set developer

5. Upload the package to Magento Root Directory

6. Extract the package and copy it to Magento Root Directory

Code Block
cd <magento_root_directory>
tar -xf <package_name>
cp -R server/* ./

7. Run upgrade (Install POS)

Code Block
php bin/magento setup:upgrade

8. Deploy POS client

Code Block
php bin/magento webpos:deploy

9. Run code compilation

Code Block
php bin/magento setup:di:compile

10. Install Laminas Barcode

Code Block
composer require laminas/laminas-barcode ^2.8 
php bin/magento setup:upgrade

11. Adjust Redis session configuration

Note: This is an optional configuration if you are using Redis for Magento Session.

...

  • Edit the value max_concurrency to a suitable number. Magento recommend we set that number by 10% of the number of PHP processes. If you don’t know that then try in the range from 6 to 24 is fine. For example 20.

12. Configure Message Queue

Note: Magestore POS default supported to work with Magento Message Queue with no special configuration needed (only need Magento Cron installed and running) if the POS you are having meets the below conditions

...

In case that you want to change the Message Broker to RabbitMQ so please follow the guide Configure Magestore POS to use RabbitMQ on Magento.

13. Install Magento Cron

Code Block
php bin/magento cron:install

14. Reindex All

Code Block
php bin/magento indexer:reindex

15. Turn on Production mode

Code Block
php bin/magento deploy:mode:set production

16. Turn off Maintenance

Code Block
php bin/magento maintenance:disable

Related topic