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 |
---|
NoticeThis 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
The steps marked in bold are required
Take a backup of your website
The backup will help you recover faster in case you fail to install Magestore POS due to some conflict with other extensions or unexpected incidents while installing the POS.Turn on Maintenance
Code Block php bin/magento maintenance:enable
Turn off Magento Cron
Code Block php bin/magento cron:remove
Turn on Developer mode
Code Block php bin/magento deploy:mode:set developer
Upload the package to the Magento Root Directory
Extract the package to the Magento Root Directory
Code Block cd <magento_root_directory> tar -xf <package_name> # or use the below command If your received a package in zip type unzip <package_name>
Set indexer mode to real-time
Code Block php bin/magento indexer:set-mode realtime
Run Magento upgrade (Install POS)
Code Block php bin/magento setup:upgrade
Deploy POS client apps
Code Block php bin/magento webpos:deploy
Run code compilation
Code Block php bin/magento setup:di:compile
Install Laminas Barcode
Code Block composer require laminas/laminas-barcode ^2.8 php bin/magento setup:upgrade
Adjust the Redis session configuration
Note: Only set up this configuration if you are using Redis for Magento Session.
12.1. Open fileapp/etc/env.php
in your favorite editor
12.2. Scroll down to thesession
section below12.3. Edit the value
max_concurrency
to a suitable number. Magento recommends 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 20Configure Message Queue
Please make sure the Magento Cron was installed and the POS you are having meets the below conditions to make Magestore POS work with Magento Message Queue.POS Enterprise Commerce >= v4.8.0
POS Enterprise >= v4.13.8
POS Pro Commerce >= v4.5.0
POS Pro >= v4.15.0
Read more: Configure Magento Message QueueIn case you want to change the Message Broker to RabbitMQ so please follow the guide Configure Magestore POS to use RabbitMQ on Magento.
Install Magento Cron
Code Block php bin/magento cron:install
Set indexer mode back to the schedule
Code Block php bin/magento indexer:set-mode schedule
Reindex All
Code Block php bin/magento indexer:reindex
Turn on the Production mode
Code Block php bin/magento deploy:mode:set production
Turn off Maintenance
Code Block php bin/magento maintenance:disable