Pitram Communications Ports Register

Relates to versions - 3.29.0+

This guide serves to outline the port requirements relating to Pitram Control Room and Server infrastructure.

Identifier / Port Requirements

Service Identifier	Default Port	Protocol	Purpose, Configuration Reference	Version
ESS (Event Server Service)	952	gRPC, HTTP	Core endpoint used to request and submit Pitram events	7.1+
	972	gRPC, HTTPS	ESS secured communication for gRPC. Only required where secured communication is configured	7.1+
	809	REMOTING, TCP	Core endpoint used to request and submit Pitram events	up to 7.1
	852	WCF, TCP	ESW, Custom Event Server Queries	4.8.0 - 7.1
GSS (General Server Services)	951	gRPC, HTTP	Core endpoint to log messages, request client id, and other misc uses (including Administration options)	7.1+
	971	gRPC, HTTPS	GSS secured communication for gRPC	7.1+
	810	REMOTING, TCP	Core endpoint to log messages, request client id, and other misc uses	up to 7.1
	851	WCF, TCP	Alternative Custom General services queries e.g. Administration options	up to 7.1
	861	WCF, TCP	General services queries for cross domain with no security e.g. used by Pitram Mobile FileUpload	4.14.1 - 7.1
	867	HTTP(S)	General service #3 to use with DA/EE AuthenticateAndGetClaims call with SSL certs if configured.	6 - 7.1
	815	TCP	RIM	up to 7.0
	820	TCP	General services endpoint for querying message log information	up to 5.0
RDS (Reference Data Service)	953	gRPC, HTTP	Core endpoint to transport of reference data to Pitram client applications	7.1+
	973	gRPC, HTTPS	RDS secured communication for gRPC. Will only work if secured communication is configured	7.1+
	821	gRPC, HTTP	Optional port to publish Reference Data from Pitram Portal side	7.1+
	821	REMOTING, TCP	Port to publish Reference Data from Pitram Portal side	up to 7.1
	811	REMOTING, TCP	Core endpoint to transport of reference data to Pitram client applications	up to 7.1
	817	TCP	RIM	up to 7.0
BMS (Business Model Service)	954	gRPC, HTTP	Core endpoint for current shift real-time information for Pitram Mobile, PRIS and other Pitram applications	7.1+
	974	gRPC, HTTPS	BMS secured communication for gRPC. Will only work if secured communication is configured	7.1+
	812	REMOTING, TCP	Core endpoint for current shift real-time information for Pitram Mobile, PRIS and other Pitram applications	up to 7.1
	825	WCF, TCP	(BMWS) Communications for PRIS to BMS. Also used by other Pitram client applications	4.7 - 7.1
	818	TCP	RIM	up to 7.0
Watchdog RIM	914	gRPC, HTTP	RIM	7.1+
	924	gRPC, HTTPS	RIM secured communication for gRPC, Will only work if secured communication is configured	7.1+
	814	TCP	RIM	up to 7.1
DOME Connector	800	HTTP	Data Access service for Pitram Portal web client	3.29+
	801	TCP	Data Access service for Pitram Portal web client	3.29+
	826	TCP	Communications for PRIS to Dome connector. Also used by other Pitram client applications	4.7+
Pitram Vision	927	gRPC, HTTP	Communication between Pitram vision service and Mobile	7.1+
	827	SIGNAL R, TCP	Communication between Pitram vision service and Mobile	4.7 - 7.1
PRIS (REST Front End)	80	HTTP	REST API gateway for external interaction / Pitram Connect	3.29+
	443	HTTPS	REST API gateway for external interaction / Pitram Connect	3.29+
File Distribution Service	830	TCP	Pitram File Distribution Communications	3.29+
	831	HTTP	Optional HTTP Web interface to file distribution client service.	3.29+
P2P Pitram Mobile	4366	gRPC, HTTP	Communication between Pitram mobile units (Truck to Loader)	7.1+
	4365	WCF, TCP	Communication between Pitram mobile units (Truck to Loader)	up to 7.1
	853	gRPC, HTTP, WCF, TCP	Communication between Pitram mobile units (Loader to Truck)	3.29+
P2P Pitram Server	860	gRPC, HTTP, WCF, TCP	Used by Pitram Server when acting as a hosting server for P2P communication	4.16+
P2P Pitram Host	862	gRPC, HTTP	Used by Mobile Equipment when acting as a hosting server for P2P communication	8.0+
	862	WCF, TCP	Used by Mobile Equipment when acting as a hosting server for P2P communication	4.16 - 7.1
	962	gRPC, HTTP	Temporarily used in version 7.1 only to allow support for WCF on 862 and gRPC on 962	7.1
	863	gRPC, HTTP	Used by Postman Host when acting as hosting server for P2P communication	8.0+
	863	WCF. TCP	Used by Postman Host when acting as hosting server for P2P communication	4.16 - 7.1
	963	gRPC, HTTP	Temporarily used in version 7.1 only to allow support for WCF on 863 and gRPC on 963	7.1
P2P Carrier Mode	865	gRPC, HTTP	Used by Pitram Mobile in P2P Carrier Mode receiving notifications from Postman	7.1+
	865	WCF, TCP	Used by Pitram Mobile in P2P Carrier Mode receiving notifications from Postman	4.16 - 7.1
Mobile Update Services	850	TCP	Used to update Pitram Mobile application	up to 7.1
	866	TCP	Default port for Pitram Update Service	6.0+
	819	TCP	Default port for WCF service between Mobile units	up to 7.1
Equipment Health Services	957	gRPC, HTTP	Default gRPC port between EHS Server and Clients	9.0+
	977	gRPC, HTTPS	EHS secureed port for gRPC, only required if secured communication is configured	9.0+
	9001	UDP	SKZ Emulator for CAN integration (Receive)	8.0+
	9002	UDP	SKZ Emulator for CAN integration (Send)	8.0+
Bluetooth Tagging Communications	10556	gRPC	Used by Mobile when communicating to Bluetooth Beacon Tags (BLE)	8.0+
	9003	UDP	Bluetooth beacon emulator port (Receive)	9.0+
	9004	UDP	Bluetooth beacon emulator port (Send)	9.0+
Pitram Portal Diagnostics Port	9000	UDP	Used to send KeepAlive messaging when login screen is displayed. Used to avoid long term Dashboard / Stockpile Viewer logout	8.0+
PLS (Pitram License Service)	819	TCP	Default port number setting for WCF service used between PLS (host) and Dome (client).	5.0+

Acronyms / Abbreviations

Term	Meaning	Explanation
ESS	Event Server Service	Service for Pitram Events
ESW	Event Server Web Services	Newer endpoint for queries to Event Server
GSS	General Services Service	Misc Pitram system information (messaging, Client Id)
RDS	Reference Data Service	Service to provide access for Pitram client application to reference data. Reference data is supplied to RDS via Dome reference data management
BMS	Business Model Service	"Client as a service". Runs the Pitram client layer as a service, and provides an endpoint for Mobile to do real time current shift data synchronisation. Also used by PRIS for current shift data
RIM	Runtime Information Manager	Remoting object endpoints that exist in ESS, GSS, RDS, BMS, and can be used to monitor the runtime state of the servers remotely (as used by out server monitor application). Not currently being used
Watchdog service	Watchdog service	Service that monitors the 4 core Pitram services (ESS, RDS, GSS, BMS) and Dome connector, that can auto start them, and also attempt to restart them if any shutdown
PRIS Dome/BMS Connections	Backend PRIS connection to existing Pitram/Dome system	BMS and Dome connector have WCF endpoints initially use by PRIS, but now also being consumed by other parts of the system
PLS	Pitram Licence Service	Service used for licencing in Pitram. Service acts as the in-between for Dome and NLS (Network Licence Server) from Micromine.
PUS	Pitram Update Service	Service for updating Pitram.
EHS	Equipment Health Service	Service for receiving and storing Equipment Health Data.