NorthStar Order Entry System Requirements

Hardware Requirements

  • Order Entry Server

    • Intel i5 processor or greater

    • 8 GB memory if Windows 10 (16 GB recommended)*

    • 8 GB memory if Windows Server 2012 (16 GB recommended)*

    • 256 GB minimum hard drive space (SSD preferred)

  • Order Entry Windows Terminal

    • Intel i5 processor or greater

    • Windows 10 Pro 64-bit or Windows 11 - Minimum Windows 10, version 1809, (Build 17763)

    • 8GB memory

    • 256GB minimum hard disk drive

  • If running NSOE Server and Terminal on the same machine:

    • Intel i5 processor or greater, i7 is preferred

    • Windows 10 Pro 64-bit or Windows 11 - Minimum Windows 10, version 1809, (Build 17763)

    • 16GB memory

    • 256GB minimum hard disk drive

  • Business-class Internet connection

  • Business-class Wi-Fi hardware

To add memory on a Lenovo mini-PC: https://www.youtube.com/watch?v=7OedS-FNJ_I&t=49s

Software Requirements

  • Apple iOS 10(minimum) on iPads (iOS 12 or higher recommended)

  • One of the following operating systems, or any later version, on the Order Entry server:

    • Windows Server 2012

    • Windows 10 Pro (64-bit)

  • Bomgar Support Client (used for secure remote access, this will be installed by CBS)

  • Filebeat Log Shipper Agent - System Requirements

  • Elevated SQL Express Security Logins - SQL Security Login Elevation

Automatically Downloaded Software

The following software will be downloaded and installed automatically if it is not already installed. You can install this software ahead of time, if desired.

IMPORTANT - PLEASE READ BEFORE INSTALLATION

PC Servers not imaged by Custom Business Solutions requires the installation of SQL Server Compact before installation of NorthStar Order Entry server build.

 

Name

Link

Name

Link

Microsoft .NET Framework 3.5 (Includes .NET2.0 and 3.0)

Windows Feature in Control Panel

Microsoft .NET Framework 4.5.1

Download Link

Microsoft Visual C++ 2012 Redistributable (x64)

Download Link

Microsoft SQL Server Compact 4.0

Download Link

Microsoft SQL Server 2012 Express with Tools (SP1)

Download Link

Microsoft SQL Server 2019 Express with Tools (SP1)

Download Link

Microsoft Sync Framework

Download Link

Download Link (install this first)
Download Link (install this second)
Download Link (install this third)

Elasticsearch Filebeat Installer (4.9.2 Server Installers)

Download Link

Manually Applied Software

Name

Link

Name

Link

Microsoft .NET Framework 3.5 (Required for 4.9.3+)

Windows feature applied through Control Panel

 

Network Requirements

Wireless Network

A Wi-Fi network must be available for iPads to connect to. This network must be secured so no devices may connect except for approved iPads running NorthStar Order Entry.

Multiple access points will be required, depending on the store's floor plan. The number and placement is difficult to predict in advance, so we recommend consulting with a company who specializes in wireless infrastructure planning, such as Tekmark Global Solutions or Netsurion

Inbound Connections

These ports must be forwarded through the restaurant's Internet-facing firewall to the Order Entry server.

 

TCP Ports

Source

 

TCP Ports

Source

POS Communication and Support

8081, 4444

67.113.166.130 (CBS Irvine office)

Online Ordering (if required)

8081

ordering.cbsnorthstar.com

Web Ordering API (if required)

8081

azurewebsites.net

Outbound Connections

The Order Entry server must be able to make connections outbound from the restaurant to these destinations.

Procedure

Domain Name

TCP Ports

Procedure

Domain Name

TCP Ports

Menu deployment, reporting data, etc.

  • ecm-nsoewebservices-(ECM INSTANCE NAME).cbsnorthstar.com

443, 80

Network Time

We use NTP to verify the system clock is accurate. If you cannot allow access to the following NTP server, you must provide your own NTP server we can query. We do not change the system clock, this is for monitoring only.

  • time.nist.gov

123 (UDP)

Menu deployment, reporting data, etc.

(Azure US West datacenter)

We use Microsoft Azure's US West datacenter for various functions.
You can download a complete, updated list of potential IP addresses from Microsoft.
At the time of writing, the following domains are used:

  • azure-ecm.cbsnorthstar.net

443, 80

Web API URLs

We use various urls for our web ordering api connection. Outbound traffic from the server needs to be allowed to these endpoints.

 

Web Order API microservice link

https://services.cbsnorthstar.com/auth (4.9.4)

 

Northstar 3rd Party Delivery

NSOE reaches up to N3PD API to "GetOrder" by UUID in order to submit the order to the POS. 

  • Whitelist: *.chowly.com

    • Each API URL for N3PD (Aka Chowly) is unique and can be found in the site's SDF file in the "System Settings" table, tied to value "Chowly.APIUrl"

    • Example: Highlighted value is what needs to be whitelisted for the site using this integration.

443, 80

 

Kafka Cluster (4.9.2 Server)

The Kafka cluster is used for Web Order API (WOAPI) orders and sales data routing from in-store to our cloud services.

blue-ketch-01.srvs.cloudkafka.com:9094
blue-ketch-02.srvs.cloudkafka.com:9094
blue-ketch-03.srvs.cloudkafka.com:9094

9094

NorthStar Order Entry Dependencies (4.9.2+ Server Installer)

These are software dependencies that we serve on our end instead of downloading from a separate vendor.

These links need to be allowed:

Main Link(s)

 

All Dependencies (4.9.3 Server Build)

(Old 4.9.2 and below Server Build - The Azure link is defunct at 4.9.3)

 

Dependency Link Information

**IMPORTANT** 
PLEASE READ BELOW ABOUT OUR DEPENDENCY URLS ABOVE AND FIREWALLS


The following URLs & ports must be opened on the firewall  to reach our installer dependences .

https: 443

http: 80

Here is the general process that the installer goes through as it comes to the dependencies. We will use the dot.net as an example.

Blocked Firewall with & without  Dot.net installed.

Run Installer --> Installer Attempts to hit the CBS Dependencies URL --> If Not found --> Installer Fails

Opened Firewall with Dot.net installed.

Run Installer --> Installer attempts to connect to the CBS Dependencies URL --> If Found ---> Checks for Version --> IF version matches --> Move On

Opened Firewall with Dot.net installed, but is an outdated version

Run Installer --> Installer attempt to connect to the CBS Dependencies URL --> If Found --> Checks for Version --> IF version does not match current release --> Installs the new version to match current NorthStar Requirements. 

Please confirm that the above URLs are allowed through the firewall and try to run in the installer. 

 

443, 80

Remote Support

  • cbsassist.com

  • bomgar.cbsassist.com

443, 80

Email Receipts

  • smtp.socketlabs.com

2525

PayPros credit/gift cards (if required)

  • etrans.paygateway.com

443

Mercury credit/gift cards (if required)

  • w1.mercurypay.com

  • w2.backuppay.com

If using Verifone terminals:

  • x1.mercurypay.com

  • x2.mercurypay.com

443

If using Verifone terminals:
9000, 9100

iJukebox Media Service (if required)

  • api.myijukebox.com

  • images.musicnet.com

  • fp-limelight.musicnet.com

443, 80

 

N-able RMM Agent

  • rmm.cbsnorthstar.com - 3.142.71.16

443,80

Filebeat log shipper

5043

 

Filebeat access

logs.cbsnorthstar.com

5044

Datacap/NetEPay Hosted

prod1.netepayhosted.dcap.com
prod2.netepayhosted.dcap.com

9000

PAX Connections

 

 

PAX Firmware/Reset

216.238.144.195

8582

PAX Store Configuration URL

t.paxstore.us

9080

BroadPOS Configuration URL

t.broadpos.com

9120

PAX FDMS
Primary Authorization URL


prod.dw.us.fdcnet.biz/sd/srsxml.rc


443

PAX FDMS
BroadPOS Configuration URL


t.broadpos.com


9120

PAX TSYS (TC-Sierra)
Primary Authorization URL
Secondary Authorization URL 


ssl2.vitalps.net
ssl3.vitalps.net 


5003
5003 

PAX TSYS - TransIT (HC)

Primary Authorization URL

 

gateway.transit-pass.com

 

443

PAX TSYS
BroadPOS Configuration IP


40.128.76.76


9020

PAX Heartland
Primary Authorization URL
Primary Authorization IP 


api2.heartlandportico.com
65.118.49.55 


443

PAX Heartland
BroadPOS Configuration IP 

184.73.218.146 

 

PAX Shift4

Primary Authorization URL

 

utg.shift4api.net

 

443

PAX WorldPay Vantiv 

Primary Authorization URL


PROD.SSL53.COM

 

443

Internal Connections

These connections are made WITHIN the local area network where Order Entry is running. The installation will create rules in the Windows Firewall to accommodate. If you are using a firewall that restricts access within the LAN, these ports must be unblocked.

 

Ports

 

Ports

TCP

4444, 5357, 5358, 8071, 8080, 8081, 8082

UDP

3702

 

 

Port

 

Port

NetEPay - NorthStar Payment Datacap

12000 (TCP)

Logic Controls KitchenGo Premium - Network Ports

 

Ports

 

Ports

Kitchen Router

(External communication) 

4000

Authentication address: 52.39.64.161

KDS Stations

(Internal communication)

3001 - KDS-to-KDS traffic communication

3000 - Receive orders 

Order Entry Client Network Usage Statistics

We recommend a 10/10 connection for download and upload speeds. This covers data and media seamlessly.

 

Run #

1

2

3

4

5

 

 

Run #

1

2

3

4

5

 

 

Data In (kb)

76.14

91.31

146.4

208.02

94.5

 

 

Data Out (kb)

33.23

33.73

51.93

118.28

34.9

 

 

Total Data (kb)

109.37

125.04

198.33

326.3

129.4

 

 

 

 

 

 

 

 

Avg In (kb)

123.274

 

 

 

 

 

 

Avg Out (kb)

54.414

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Total Avg Data (kb)

177.688

 

 

 

 

 

 

Total Avg Data (mb)

0.11768

 

 

 

 

 

 

 

 

These figures are on a per transaction basis, with one transaction being an order from start to finish