Prerequisites Guide for Installation & Updates

Prerequisites Guide for Installation & Updates

1. Hardware Requirements

To enhance the effectiveness of the POS system, it is crucial to incorporate the following essential hardware components. The hardware configurations below are highly recommended: 

1.1 POS Terminal

  1. Processor: Minimum 2.0 GHz dual-core processor or higher.
  2. RAM: At least 4 GB (8 GB or more recommended for optimal performance).
  3. Storage: 64 GB of free storage space.
  4. Operating System: Windows 10, macOS, or Linux (as supported by the POS software).
  5. Display: Touchscreen monitor with at least a 1024 x 768 resolution.
  6. Connectivity: At least 2 USB ports and 1 Ethernet port.

1.2 Peripheral Devices

  1. Barcode Scanner: USB or wireless barcode scanner for quick item entry.
  2. Receipt Printer: Thermal receipt printer compatible with the POS system.
  3. Cash Drawer: Electronic cash drawer that integrates with the POS software.
  4. Card Reader: EMV-compliant card reader for processing credit and debit card transactions.
  5. Customer Display (Optional): For showing transaction details to customers in real-time.

1.3 Network and Connectivity

  1. Internet Connection: A stable broadband internet connection is required for online features, cloud storage, or payment gateway integrations.
  2. Router/Firewall: Ensure that your network settings allow communication between the POS terminal and external services (e.g., payment gateways, inventory systems).

2. Software Requirements

2.1 Operating System Compatibility

Ensure that the POS software is compatible with your operating system. The system supports:
  1. Windows 10 or later
  2. macOS 10.13 or later
  3. Linux distributions as specified by the POS provider

2.2 POS Software Installation 

  1. Verify that the correct version of the POS software is installed on the POS terminal.
  2. Ensure that all required updates or patches are installed to avoid security vulnerabilities and system bugs.
  3. If the system relies on cloud-based functionality, confirm that you can access the Control Center portal for managing settings, reports, and inventory remotely.

2.3 Supported Payment Processors

  1. Ensure the POS system is configured to work with your selected payment processors (e.g., PayPal, Stripe, or Square).
  2. Check that the POS software integrates with necessary credit, debit, and mobile payment gateways.

2.4 Required Software Frameworks and Technologies

1. Net framework 4.7.2
  1.  .NET Framework 4.7.2 is a mature, Windows-only platform for building, deploying, and running desktop apps, web services, and web applications. Released in April 2018, it includes several improvements in performance, security, and developer experience.
  2. It is widely used for building Windows Forms and Windows Presentation Foundation (WPF) desktop applications, allowing developers to create robust and rich user interfaces.
  3. .NET Framework 4.7.2 is ideal for building and maintaining Windows-based applications with stability, long-term support, and compatibility, particularly for enterprises that rely on older technologies.
2. SQL Server compact runtime
  1. SQL Server Compact (SQL CE) is a lightweight, embedded database engine provided by Microsoft. It is designed for desktop, mobile, and web applications where a full SQL Server installation is unnecessary. It provides a simple, self-contained database solution that is easy to deploy with applications.
  1. It will be deprecated as we move to the Postgres server database.
3. Compact Viewer
  1. Compact Viewer is a lightweight and user-friendly application designed for viewing and managing SQL Server Compact (SQL CE) databases. SQL Server Compact is a free, embedded database engine from Microsoft, ideal for small applications and mobile devices.
4. Visual C++ 2010
  1. Visual C++ 2010 is an integrated development environment (IDE) from Microsoft for developing applications in C++. It is part of Visual Studio 2010 and provides a comprehensive set of tools for building native Windows applications requiring high-performance computing and access to low-level system features.
5. Visual C++ 2012
  1. Visual C++ 2012 is part of Visual Studio 2012, a development environment for creating applications in C++. It is used to build high-performance native Windows and cross-platform applications and integrates with .NET for managed applications. Visual C++ 2012 introduces many modern C++ features and tools to improve the developer experience.
6. Visual C++ 2013
  1. Visual C++ 2013 is part of Visual Studio 2013, a comprehensive IDE for developing C++ applications. It is used to build native Windows applications, high-performance software, and cross-platform applications. Visual C++ 2013 introduced several new C++11 features and tools for improving code quality, performance, and developer productivity.
  2. We are currently using Visual Studio 22, so we might not require all of these, but it is as if we started this development in 2010, 2012, or 2013 at the latest.
7. WebView2
  1. WebView2 is a web control that allows developers to embed web content (HTML, CSS, JavaScript) within native applications. It is powered by the Microsoft Edge (Chromium) rendering engine, providing the latest web standards and compatibility.
8. ODBCDriver13ForSqlServer
  1. ODBC Driver 13 for SQL Server is a Microsoft ODBC (Open Database Connectivity) driver that enables applications to connect to SQL Server databases. It allows users to interact with SQL Server using the standard ODBC API and supports 32-bit and 64-bit architectures.
9. POS For .Net v1.14.1
  1. POS for .NET v1.14.1 is a Microsoft SDK (Software Development Kit) designed to develop Point of Sale (POS) applications in the .NET framework. It provides a managed .NET API for interacting with retail POS hardware devices, such as barcode scanners, receipt printers, and cash drawers.
10. RabbitMQ
  1. RabbitMQ is an open-source message broker that facilitates communication between applications or services by sending messages between them in a reliable and scalable manner. It is designed to handle high-throughput scenarios and can support complex message routing.
11. DBeaver
  1. DBeaver is a free and open-source database management tool with a graphical interface for interacting with various database systems. It is designed for developers, database administrators, and analysts to manage and manipulate data efficiently.
12. Postgres
  1. PostgreSQL (often called Postgres) is an open-source relational database management system (RDBMS) known for its robustness, extensibility, and standards compliance. It is designed to handle many workloads, from small single-machine applications to large internet-facing applications with many concurrent users.

3. Account and License Requirements

Before using the POS system, make sure the following account and licensing prerequisites are fulfilled:

3.1 POS System Account

  1. Create an account with the POS software provider to access the system's full features.
  2. Set up appropriate user permissions for employees, managers, and administrators. This may include assigning roles for sales, inventory management, or reporting.

3.2 Licensing

  1. Verify that the POS software license is active and up to date. Some POS systems may require an active subscription or maintenance agreement.
  2. Ensure that any third-party software (e.g., accounting, CRM, or inventory management tools) is licensed adequately for integration with the POS system.

4. Payment Processing Setup

4.1 Merchant Account

  1. Set up a merchant account with a payment processor supported by the POS system to accept credit/debit cards, mobile payments, and other payment methods.
  2. Ensure your payment gateway account is linked to the POS system for seamless transaction processing.

4.2 Card Reader Configuration

  1. Connect the EMV-compliant card reader to the POS terminal, ensuring it is properly integrated and functioning.
  2. Test the card reader to confirm that it can process chip, swipe, and contactless payments (if applicable).

4.3 Cash Drawer Configuration

  1. Link the cash drawer with the POS system to ensure it opens automatically after cash transactions.
  2. Test the connection by completing a sample cash transaction to confirm the system works properly.

5. Security and Data Protection  

5.1 System Security

  1. Ensure the POS terminal is protected with strong passwords for all users and encourage regular password updates.
  2. Set up two-factor authentication (2FA) if supported by the POS system for added security.

5.2 PCI Compliance

  1. Verify that the POS system complies with PCI DSS (Payment Card Industry Data Security Standard) to ensure secure payment processing and data protection.
  2. Work with your payment processor to comply with legal and regulatory requirements.

5.3 Data Backup

  1. Set up automatic or manual data backup schedules to ensure transaction records, inventory data, and reports are saved securely.
  2. If using a cloud-based POS system, ensure the service provider offers regular data backups and secure storage.

6. Updating POS Software

FTx Cloud POS experiences continuous enhancements for the next level of user experience. You need to install the updates to leverage the benefits.  
  1. As Figure 6.1 shows, the system will show the message to update the POS when the updates are available. Click "Continue."

Figure 6.1
  1. The Install Updates message will appear, As Figure 6.2 shows. 

Figure 6.2
  1. The Found Updates for FTX POS message will show two options: Download Now and Download Later

Figure 6.3
  1. Download Now: Click this button to download the updated exe file.
  2. Download Later: Click this button if you don't want to download the updated exe file now. When you click this button, the system will close the Found Updates for FTX POS message and show it again later. 
  1. When you click "Download Now," the system will run the installer. Please follow the instructions and download the updates. 

7. Possible Technical Issues 

1. Hardware Issues

This could involve peripheral devices like printers, barcode scanners, or cash drawers not functioning as they should. For instance, if the printer fails to generate a receipt, it could be due to a driver problem or a physical hardware defect.

Failure of these components can severely impact daily operations and may necessitate immediate repairs or replacements. Hardware malfunctions sometimes manifest through screen flickers, distorted visuals, or inconsistent audio notifications. Such symptoms might imply that the hardware components of the POS system, such as the display or sound card, are failing. It’s important to recognize these signs early and address them proactively.

Problem: Unresponsive touchscreen or peripherals, printer errors, and connectivity problems are common hardware issues.
 
Solution:
  1. Check power and cable connections to ensure everything is securely connected.
  2. Restart the system and peripherals.
  3. Test the hardware on another device to identify if the issue is with the POS system or the hardware itself.
  4. Update or reinstall device drivers and firmware.
  5. Consult the manufacturer’s support or consider replacing faulty hardware components.

2 Software Glitches

Software errors often manifest as random pop-up messages, sudden application closures, or the infamous “blue screen of death.” Software bugs, compatibility issues, or data corruption often cause these. Such errors should not be ignored, as they may indicate more significant underlying problems that can compromise sales data and customer information. 

Problem: POS software may encounter glitches, freeze, or display errors, affecting transaction processing.

Solution:
  1. Check for software updates and install the latest version.
  2. Reboot the system to clear any temporary issues.
  3. Ensure the software is compatible with the operating system and hardware.
  4. Backup data regularly to safeguard against software-related data loss.
  5. If you encounter any error messages, follow the instructions on the screen or look them up in the user manual or online.

3. Network Connectivity Problems

When your POS system has trouble connecting to the internet or internal servers, this could interrupt various services like real-time inventory updates or credit card processing. This is often indicated by error messages or an inability to access certain network-dependent functionalities. The root causes can range from simple issues like loose cables to more complex ones like router failures or server downtimes.

Problem: Slow or unreliable internet connection can hinder transaction processing and communication with external services.

Solution:
  1. Verify the internet connection and ensure it meets the required bandwidth.
  2. Restart the modem, router, and POS system to refresh the network.
  3. Consider using a wired connection for more stability.
  4. Check the service provider’s status page for ongoing issues using cloud-based services.

4. Security Concerns

Problem: Unauthorized access, data breaches, and malware attacks pose significant security threats to POS systems.
Solution:
  1. Use strong, unique passwords and implement multi-factor authentication.
  2. Regularly update antivirus and anti-malware software.
  3. Enable encryption for sensitive data.
  4. Educate staff about security best practices and potential social engineering threats.

5. Payment Processing Issues

When customers’ credit cards are not processing correctly, or there are frequent transaction errors, your POS system could be at fault. This can be due to a card reader issue, outdated software, improper integrations, or network issues.

Problem: Failed or declined transactions, discrepancies in payment totals, or issues with specific payment methods can disrupt sales.
Solution:
  1. Verify the payment processing account and credentials.
  2. Check for compatibility issues between the payment processor and POS software.
  3. Contact the payment processor’s support for assistance
  4. Have backup payment methods available in case of temporary issues.

6. Check the settings

Finally, you can check your POS system's settings to make sure they match your business needs and preferences, such as your currency, time zone, receipt format, payment methods, or security features. You can also customize your settings to optimize your POS system's performance and functionality, such as enabling automatic updates, disabling unnecessary features, or adjusting the screen brightness or volume.

7. Other possible issues

1. Incorrect inventory levels
  1. If you notice that the inventory levels on your POS system are not syncing correctly with your actual stock, this could indicate a system malfunction. This can occur due to software errors or, less frequently, hardware issues like a faulty scanner that misreads barcodes.

2. System lockups
  1. This is more severe than unresponsiveness; the system completely freezes and becomes inoperable. This usually requires a hard reboot and could be symptomatic of extreme software or hardware issues, including overheating components or low disk space.

3. Data loss or corruption
  1. If transaction histories, customer details, or other vital information suddenly go missing or become corrupted, it’s a serious sign that your POS system is malfunctioning. This can be due to hard drive failure, malware attacks, or severe software bugs and should be addressed immediately to prevent further loss and potential legal issues.


    • Related Articles

    • Mass Updates

      Mass Updates Overview "Mass Updates" allows you to create various data changes quickly and easily. For example, you can update discounts and display screens from any device or make price changes for multiple locations in seconds. The Mass Updates ...
    • FTP Connections

      FTP Connections Overview Configure the FTP Connections to send/receive files for purchase orders/getting invoices, respectively. FTP Connections is a server-side setting to send/receive files by implementing the automated process. You need to ...
    • Purchase Orders

      Purchase Orders Overview A purchase order is used to buy products for the store from a vendor. When creating a purchase order, it's important to note that it can only include parent items and must have an associated vendor part number. The vendor ...
    • ITG Retail Scan Data Report

      ITG Retail Scan Data Report Overview ITG Brands, a prominent tobacco manufacturer, offers a scan data reporting program that allows retailers to share detailed sales data in exchange for financial incentives. FTx Cloud POS lets you automatically ...
    • EDI Import

      EDI Import Overview "EDI Import" enables you to access the invoice's EDI files sent by the vendor and process the invoice using it. FTx Cloud POS offers you the below three options to process the invoice: You can "Apply" the invoice from the ...