# Message Server Tutorial

**URL:** <https://forum.sambapos.com/t/message-server-tutorial/1042>\
**Category:** V4 Tutorial\
**Created:** [April 15, 2014, 10:48am UTC](https://forum.sambapos.com/t/message-server-tutorial/1042 "2014-04-15T10:48:14Z")\
**Posts on this page:** 8\
**Page:** 1

<div class="post-metadata">

**Author:** ![emre](https://forum.sambapos.com/user_avatar/forum.sambapos.com/emre/32/39073_2.png) [@emre](https://forum.sambapos.com/u/emre)\
**Post date:** [April 15, 2014, 10:48am UTC](https://forum.sambapos.com/t/message-server-tutorial/1042/1 "2014-04-15T10:48:18Z")

</div>

## What is Message Server?

> Some users thinks they need to run **Message Server** to be able to connect to SQL Server. Message Server has no relation with database and if you have problems configuring database please read [SambaPOS Database Configuration](http://forum.sambapos.com/t/sambapos-database-configuration/356) topic. After configuring database connection come back to this tutorial to complete your network connection.

Message server is a special server application that enables communication between terminals. On a network environment waiters uses different terminals to enter orders. However other terminals waiting on `Table Screen` does not update table color changes automatically. When a terminal connected to message server it can understand when it needs to refresh screens so when you create a ticket from a terminal all other terminal screens will update automatically.

> **Message Server Not Connected** error message does not mean **Database Not Connected**. It means your terminals does not refresh automatically when tickets created.

_On this video you can see how an order received from Ipad changes table colors on other computers._

[![](https://i.ytimg.com/vi/VbXaKyMmhvM/hqdefault.jpg "SambaPOS iPad, Yazıcı ve Kiosk Entegrasyonu") ](https://www.youtube.com/watch?v=VbXaKyMmhvM)

## How to configure it?

**You need to run message server application only on SERVER computer. In the other words run it on the computer SQL Server runs.**

You can run Message Server as a windows service or standalone application. Configuring Standalone App is easier however you need to keep it running. Once you install it as a windows service it will always run in the background and there will be no risk to close it.

###Running Standalone App

Navigate to `SambaPOS Installation Folder` with Windows explorer and start `Samba.MessagingServer.exe` program.

 ![](https://forum.sambapos.com/uploads/default/original/3X/9/2/9254cc93885721d4a3837a7c4dbe34fa3bde9d45.jpeg) 

When you start running it you’ll see Server configuration window. Click `Start` button to start running server.

 ![](https://forum.sambapos.com/uploads/default/original/3X/f/5/f524caeb6ce9f182e03984baed7c907f93c52054.jpeg) 

Server will be running on `8080` port. On first start `Windows Firewall` will ask if you want to allow `Message Server`.

You can enable `Start Server Automatically` setting to make it run automatically when windows restarts.

 ![](https://forum.sambapos.com/uploads/default/original/3X/9/3/93d3c85eaa78e010643b150d99de64e597e33039.jpeg) 

Click `Allow Access` button. If you don’t allow access SambaPOS won’t be able to access `Message Server`.

When message server started it hides itself to `System Tray` area.

 ![](https://forum.sambapos.com/uploads/default/original/3X/6/a/6ace1e1362c0f91d40ac8998547d5d1861b0270d.jpeg) 

If you don’t see it in tray please expand tray and look for the apple icon.

 ![](https://forum.sambapos.com/uploads/default/original/3X/a/a/aafba9b50a610483896ea5a7fe21bb66d0bccd83.jpeg) 

You can click on `Apple` icon to display message server window. Please just minimize it to hide it to tray. Closing this window will close message server.

> Running message server multiple times may generate errors. When you receive error while starting message server please be sure it is not already running as a standalone app or windows service.

 ![](https://forum.sambapos.com/uploads/default/original/3X/1/1/113e10844fb69735ebe09982fc17a9eeeb7ca456.jpeg) 

If message server running properly you’ll see `Working...` label under window. You can click `Stop` button to stop message server.

###Running Windows Service

You can prefer installing `Message Server` as a windows service. **Please run it only on server computer and be sure standalone app not already running.**

To run service installer app open SambaPOS installation folder with file explorer and start `Samba.MessagingServerServiceTool.exe`

 ![](https://forum.sambapos.com/uploads/default/original/3X/b/2/b240c9c3c5dec41c16b286c36dfd09eb6d149b5d.jpeg) 

You need to have `Administrator` privileges to be able to install services.

 ![](https://forum.sambapos.com/uploads/default/original/3X/2/0/203ff5d1f44dfcc7e61185030370142ecc6079c2.jpeg) 

> Default Port for windows service is **8383.** We’ll need port number while configuring terminals so note the port number somewhere.

Click `Install Service` button to start.

 ![](https://forum.sambapos.com/uploads/default/original/3X/8/5/85b6b7748bdcfacd9e693838be94f03d52a525c5.jpeg) 

It will install windows service and start running `Message Server`. To check if it is running fine or not you can check Task Manager’s `Services` tab. It should be `Running`.

 ![](https://forum.sambapos.com/uploads/default/original/3X/7/4/741cbbbe28127e346e023dce0c96cdef6481fa93.jpeg) 

You can close `Service Tool` window. Messaging server will always run even you restart windows and you don’t need to care about it anymore…

###Configuring SambaPOS

On client computers you need to configure SambaPOS to connect to message server. You need to do it on each client computer.

Run SambaPOS and open `Management > Local Settings`

 ![](https://forum.sambapos.com/uploads/default/original/3X/a/d/adf9bdf484921bc4a440360bffa4a1a6a7b0467c.jpeg) 

- **Message Server Name:** Type here the name of the `Server` computer. For example if your server name is `SERVER-PC` type `SERVER-PC` here.
- **Message Server Port:** Type port number here. If you’re using standalone app default port number is `8080`. For windows service it is `8383`.
- **Auto Start Message Client:** Enable this setting to reconnect to Message Server when you restart SambaPOS.

Click `Save` and **Restart SambaPOS**

Windows will again ask if you want to allow SambaPOS to access to Server.

 ![](https://forum.sambapos.com/uploads/default/original/3X/8/f/8f117e81ac779e6396b7d945addca7ba1aa046cc.jpeg) 

Allow it by clicking `Allow Access` button. If you don’t allow SambaPOS won’t connect to message server.

When SambaPOS connected to a message server you’ll see Green `Connected` label here.

 ![](https://forum.sambapos.com/uploads/default/original/3X/6/d/6d60dafc8adf4c624b2f573c48877358fab685e5.jpeg)

---

<div class="post-metadata">

**Author:** ![aaronlee29](https://forum.sambapos.com/letter_avatar_proxy/v4/letter/a/74df32/32.png) [@aaronlee29](https://forum.sambapos.com/u/aaronlee29)\
**Post date:** [July 9, 2014, 9:27am UTC](https://forum.sambapos.com/t/message-server-tutorial/1042/2 "2014-07-09T09:27:19Z")

</div>

Are there additional required steps that might be missing?  
I followed the instructions above and got the “Connected” status on both my server and client, but auto-refresh is not yet working (manual refresh, such as re-clicking the entity screen, works).

Example:  
On the server: I add an order to a ticket. The entity color goes from the default gray to a red.  
On the client: The entity color remains gray until I click something to trigger refresh. Then the entity turns red.

I have tried various combinations:

1. Client order entered. Server does not auto-update.
2. Server order entered. Client does not auto-update.
3. Tried using same accounts (both admin) on both client and server. Tried using different accounts (one admin, one user) on each machine.
4. Tried messaging service standalone and messaging service windows service
5. Firewall disabled on both machines

My config:

1. Server: Windows 7 VM. Wired to a router.
2. Client: Windows 8 physical host. Wired to same router.

Any ideas what I can try?  
Thank you,  
Aaron

---

<div class="post-metadata">

**Author:** ![emre](https://forum.sambapos.com/user_avatar/forum.sambapos.com/emre/32/39073_2.png) [@emre](https://forum.sambapos.com/u/emre)\
**Post date:** [July 9, 2014, 10:30am UTC](https://forum.sambapos.com/t/message-server-tutorial/1042/3 "2014-07-09T10:30:00Z")

</div>

Be sure you’re running message server only on server and all clients connects to that server. Check Management \> Local Settings on all clients. `Message Server Name` should be the `Server's Name`

---

<div class="post-metadata">

**Author:** ![pizzaeilat4](https://forum.sambapos.com/user_avatar/forum.sambapos.com/pizzaeilat4/32/461_2.png) [@pizzaeilat4](https://forum.sambapos.com/u/pizzaeilat4)\
**Post date:** [July 9, 2014, 11:57am UTC](https://forum.sambapos.com/t/message-server-tutorial/1042/4 "2014-07-09T11:57:36Z")

</div>

@emre,  
I am also experiencing problems with messaging server since the update to 4.1.40  
Terminal is not updated with the changes from the server, after restarting SambaPos it works fine but after a few minutes the same problem occurs.

---

<div class="post-metadata">

**Author:** ![emre](https://forum.sambapos.com/user_avatar/forum.sambapos.com/emre/32/39073_2.png) [@emre](https://forum.sambapos.com/u/emre)\
**Post date:** [July 9, 2014, 3:40pm UTC](https://forum.sambapos.com/t/message-server-tutorial/1042/5 "2014-07-09T15:40:48Z")

</div>

@pizzaeilat4 nothing changed on that part for years so I don’t know if a recent change is the reason of it. Let’s wait for other user’s responses if anyone recently started experiencing such issue.

---

<div class="post-metadata">

**Author:** ![pizzaeilat4](https://forum.sambapos.com/user_avatar/forum.sambapos.com/pizzaeilat4/32/461_2.png) [@pizzaeilat4](https://forum.sambapos.com/u/pizzaeilat4)\
**Post date:** [July 9, 2014, 3:53pm UTC](https://forum.sambapos.com/t/message-server-tutorial/1042/6 "2014-07-09T15:53:37Z")

</div>

@emre,  
I installed the 1.4.39 version back and it works fine only version 1.4.40 has a problem

---

<div class="post-metadata">

**Author:** ![emre](https://forum.sambapos.com/user_avatar/forum.sambapos.com/emre/32/39073_2.png) [@emre](https://forum.sambapos.com/u/emre)\
**Post date:** [July 9, 2014, 8:04pm UTC](https://forum.sambapos.com/t/message-server-tutorial/1042/7 "2014-07-09T20:04:10Z")

</div>

@pizzaeilat4 this is probably something different. I’ve checked differences line by line and I found nothing between 39 and 40 that can cause such issue. I believe it will reveal soon if it relates with a bug.

---

<div class="post-metadata">

**Author:** ![pizzaeilat4](https://forum.sambapos.com/user_avatar/forum.sambapos.com/pizzaeilat4/32/461_2.png) [@pizzaeilat4](https://forum.sambapos.com/u/pizzaeilat4)\
**Post date:** [July 9, 2014, 8:26pm UTC](https://forum.sambapos.com/t/message-server-tutorial/1042/8 "2014-07-09T20:26:05Z")

</div>

@emre,  
You are right it is not related to the version I’ve restore my operating system  
And I reinstalled 4.1.40 version and everything works fine. It likely was related to my operating system settings.  
Sorry about that 😊
