# 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:** 1\
**Showing post:** 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)

---

_[View the full topic](https://forum.sambapos.com/t/message-server-tutorial/1042)._
