1 Preparation steps

The symbIoTe Cloud components are explained in the following table.

Infrastructure components

Component	Supported Version	Exposed ports	Purpose
RabbitMQ	3.6+	15672 - Web based management 5672 - AMQP protocol	For communication between all cloud components
MongoDB	3.6+	27017 - Mongo DB access port	All components use this database when they are running on one machine but it can be split to more then one database.
nginx - Inteworking Interface	1.12.+	443 - HTTPS 8102 - HTTP	This is gateway to cloud microservices. Microservices can be accessed only through this Interworking Interface. In the case of having certificate it uses HTTPS and in case of using ngrok tool it will use HTTP
SpringCloudConfig		8888 - HTTP	This component is used for serving configuration to other components. It uses CloudConfigServer from SpringCloud.
Eureka		8761 - HTTP	This component is used for discovery of other components. All other components are registered in Eureka at startup.
Zipkin		8762 - HTTP	This component is used for distributed tracing. It is used for debugging communication between components.
gradle	4.6+		If there is a need to build the components
java	1.8		Oracle Java 8 version 8u131+ or OpenJDK version 8u101+

Microservices

Component	Supported Version	Exposed ports	Purpose
AuthenticationAuthorizationManager (AAM or PAAM)	3.+	8080 - HTTP	This component is responsible for security. This port is used for communication to Core services.
RegistrationHandler (RH)	1.2+	8001 - HTTP	This component is responsible for registration of resources. It exposes HTTP, port where you can send request to register/update/unregister resources. This must be used only in the local network.
ResourceAccessProxy (RAP)	1.2+	8103 - HTTP	This component is responsible for accessing resources. It need to be connected to your platform through RAP plugin.
Monitoring	2.0+	8201 - HTTP	This component is responsible for monitoring the platform resources and notifying the core about their status.

For the example integration process described below, we assume the following addresses of various Core and Cloud components (NOTE: those are supposed to be changed to real addresses of Core and Cloud services during integration):

Parameter	URL
Admin GUI	https://symbiote-open.man.poznan.pl/administration
AuthenticationAuthorizationManager (AAM, PAAM)	https://myplatform.eu/aam
Cloud Core Interface	https://symbiote-open.man.poznan.pl/cloudCoreInterface
Core Interface	https://symbiote-open.man.poznan.pl/coreInterface
Registration Handler (RH)	https://myplatform.eu/rh
Resource Access Proxy (RAP)	https://myplatform.eu/rap

In this table the platform.eu is your platform DNS entry. In next sections, we use concrete examples with symbiotedoc.tel.fer.hr DNS entry.