Document Index

  1. SambaPOS Server Setup and Configuration

1.1. Operating System, Hardware and Network
1.2. MSSQL Setup
1.3. Windows Printer Setup
1.4. SambaPOS Setup

2.Terminal Computer Setup and Configuration

2.1. Operating System, Hardware and Network
2.2. SambaPOS Setup

1. SambaPOS Server Setup and Configuration

This document was prepared for the technicians who to follow as workflow summary sorting while they setting up Basic SambaPOS which will be used on multiple computers.

At first chapter it’s explained which processes should be configured on main device (server) and at second chapter same explained for terminal computers. More detailed documents can be reached through kb.sambapos.com

1.1. Operating System, Hardware and Network

1.1.1. It’s required minimum Celeron j1900 processor 4 GB of Ram
1.1.2. Windows 10 or above Operating System
1.1.3. Hardware drivers should be installed, especially graphics card.
1.1.4. Windows Network, IP, Firewall and Port settings should be configured.

+Network that SambaPOS will be working has to be configured on the exact same IP group.

– Control Panel > Network and Share Center > Change Adapter Settings > Ethernet Local Network        Connection> Internet Protocol Version 4 (TCP/IPv4) > Features > Static IP address is selected.

+ Advanced settings of terminal computers for accessing server 

Control Panel > Network and Share Center > Change advanced sharing settings
– Finding Network : Activate Network Finding
– File and Printer Sharing: Activate File and Printer Sharing
– Password Protected Sharing: Deactivate Password Protected Sharing

+ Firewall Settings 
In order to not to block inbound connections by SQL Server, on Windows Firewall 1433 Port inbound and outbound TCP/IP and UDP settings should be configured.
– Control Panel > Firewall Settings > Advanced Settings > Inbound Rules > Add New Rule > TCP/IP 1433 Port
– Control Panel > Firewall Settings > Advanced Settings > Inbound Rules > Add New Rule > UDP 1433 Port
– Control Panel > Firewall Settings > Advanced Settings > Outbond Rules > Add New Rule > TCP/IP 1433       Port
– Control Panel > Firewall Settings > Advanced Settings > Outbond Rules > Add New Rule > UDP 1433 Port

On this settings it’s not explained how to add user account to the SQL Server. It’s assumed that you have a user account which is ready for connection. For the other products except Windows Firewall, you have to make configuration in order to allow oncoming access requests which coming from TCP 1433 port. If still there is no connection on the other terminals some physical network components might be blocking this port. Giving connection permission to your server through internet may cause serious security problems. Be very careful about sharings, especially on the firewall settings.

1.2. MSSQL Setup

1.2.1. The latest version of Microsoft MSSQL Server.
1.2.2. After Setup configure MSSQL Network TCPIP Port Sharings.
– In order to access of Terminal Computers to database on the Server TCP/IP Sharing should be ”Enabled” on SQL Server Configuration Manager.
– Computer > Management > Services > SQL Server Configuration Manager > SQL Server Network Configuration > Protocol For MSSQLSERVER > TCPIP > Enabled

1.3. Windows Printer Setup

1.3.1. Creating Windows Printer For Network (Ethernet) Printer
– Configure Printer IP Settings.
– Configure the Setup of Windows Printer Driver.
– Check Windows Testing Page by printing.
– Configure Settings for Windows Network (Ethernet) Printer Sharing.

1.3.2. Creating Windows Printer for Local (USB-Rs232) Printer
– Configure settings for Printer.
– Check Windows Testing page by printing.
– Configure Windows Network Settings and Printer Sharing Settings.

1.4. SambaPOS Setup

1.4.1. Setup by Downloading SambaPOS V5 Setup Program

https://sambapos.com 
During the setting up process Framework 4.6.2 will be setup together by downloading from internet.

1.4.2. Make the Connection SambaPOS Database
After setup make SambaPOS MSSQL database connection.
– Management > Settings > Local Settings > Database
– Example Data Path : Data Source=Server; User Id=sa; Password=Samba123; Database=SambaPOS5;

1.4.3. It’s Enough Activating SambaPOS License on Main Computer.
After making database connection perform the SambaPOS License Activation.
– cp.sambapos.com manage the license information from control panel.
– Navigation > Samba Market >
– Login > User name: License E-Mail> Password> Activate

1.4.4. Run by Setting up Message Server Settings
When SambaPOS is used on more than one terminal, process communication is provided via Message server. Setup by running message server application and then perform the Message server settings on the all terminals.
+ Running Message server on the Server and settings 
– Message server runs only on the server.
– All terminals can run by connecting to MessagingServerServiceTool.exe
– Run C:\Program Files (x86)\SambaPOS5\Samba.MessagingServerServiceTool.exe
– Port:9000+ >install ( Communicating Port has to be 9000+ )

+ Message server settings on All Terminal SambaPOS Program
– Management > Settings > Local Settings > Message Server
– Message Server Name: http://Server
– Message Server Port: 9000

1.4.5. Printer Setup
Install local setup printer driver and by configuring port settings (USB or TCPIP) check testing page by printing. If the printer was intalled as a local printer to a different computer and need to be used as a shared printer, sharing settings must be configured on terminal computer and be defined as  \\Computer Name\Printer

Note: Ethernet printers can be installed as a local printer by using same name for every terminal.

Define printer on SambaPOS after getting successfull result by printing testing pages. Below there are two examples. According to the need New printers can be defined.

+ Bill Printer Setup
Management > Printing > Printers > Bill Printer (Edit)
Sharing Port Name: Bill Printer (Local Printer Name)
Sharing Port Name: \\Server\Bill Printer (Sharing Network Printer Name)
Printer Type: ESC/POS Compatible Printer

+ Kitchen Printer Setup
Management > Printing > Printers > Kitchen Printer (Edit)
Sharing Port Name: Kitchen Printer (Choose Local Printer Name)
Sharing Port Name: \\Server\Kitchen Printer (Sharing Network Printer Name)
Printer Type: ESC/POS Compatible Printer

2.  Terminal Computers

2.1. Operating System and Hardware

2.1.1. Minimum Celeron j1900 processor, 4 GB of Ram is necessary.
2.1.2. Windows 10 or above operating system
2.1.3. Hardware drivers should be identified especially Graphics Card.
2.1.4. Windows Network, IP and Port settings configured.
2.1.5. Check Server Network Sharings.

2.2. SambaPOS Setup

2.2.1. Perform SambaPOS V5 Setup.

-Framework 4.6.2 will be installed together through internet during the setup.

2.2.2. Make SambaPOS Database Connection.

After SambaPOS installed on Terminal Computers, by writing database path from Management after restarting SambaPOS, connect to database on the Server.
– Management > Settings > Local Settings > Database
– Example: Data Source=Server; User Id=sa; Password=Samba123; Database=SambaPOS5;

2.2.3. Run by Setting up SambaPOS Message Server Settings.
Note: Terminals should be connected to the computer which Message Server runs on. On SambaPOS, it’s enough to enter IP address or name of computer that message server runs on.
– Management > Settings > Local Settings > Message Server
– Message Server Name: http://Server (Server Name or IP address)
– Message Server Port:9000

2.2.4. Setup for Terminal Printers

If it’s a locally setup printer; install driver, configure Port setting (USB or TCPIP) check by printing testing page.
If the printer was installed as a local printer to a different computer, sharing settings must be configured in terminal computer and be defined as  \\Computer Name\Printer

Note: Ethernet printers can be installed as a local printer by using same name for every terminal.

Create printer on SambaPOS after getting successfull result by printing testing pages. Below there are two examples. According to the need you can add New printers.

+ Bill Printer Setup
Management > Printing > Printers > Bill Printer (Edit)
Sharing Port Name: Bill Printer (Local Printer Name)
Sharing Port Name: \\Server\Bill Printer (Sharing Network Printer Name)
Printer Type: ESC/POS Compatible Printer

+ Kitchen Printer Setup
Management > Printing > Printers > Kitchen Printer (Edit)
Sharing Port Name: Kitchen Printer (Choose Local Printer Name)
Sharing Port Name: \\Server\Kitchen Printer (Sharing Network Printer Name)
Printer Type: ESC/POS Compatible Printer