Description

This article describes the ports and configurations of a GenRocket Multi-User Server (GMUS).


In This Article


GMUS as a Stand-Alone Server

When the GMUS is configured as a stand-alone server and does not communicate with a G-Repository Server, it needs two ports to communicate: an external and an internal port. 

  • External Communication
    • cloudPort - 443 (default) - GenRocket Cloud Components are only reachable via HTTPS.
    • The port number may be changed via a Proxy Server communicating to the cloud via port 443.

  • Internal Communication
  • requestPort - 9010 (default) - Receives client requests.
  • The port number may be changed at DevOps's discretion.
  • The user enters the port number (configured by DevOps) when launching GMUS. 


GMUS Connected to a G-Repository Server

When the GMUS is configured to communicate with a G-Repository Server (GRS), it needs three internal ports.

  • requestPort - 9010 (default) - Receives client requests.
  • mainPort - 8020 (default) - Sends requests to the GRS.
  • downloadPort - 8021 (default) - Downloads Repo Components from the GRS.
  • The port numbers may be changed at DevOps's discretion.



Detailed Port Configuration of a GMUS Using a G-Repository Server (GRS)

The diagram below shows a detailed deployment of a GMUS connected to a G-Repository Server within a Test Environment. In this example, the GMUS and GRS are installed on separate machines. 

Here are key points to observe from the diagram:

  • GRS is installed on a machine whose IP address is 192.168.100.10.
  • GRS has its cloudPort configured to port 443.
  • GRS has its mainPort configured to port 8020. 
  • GRS has its downloadPort configured to port 8021.
  • GRS is communicating directly to GenRocket Cloud over HTTPS via port 443.
  • GMUS is installed on a machine whose IP address is 192.168.100.11.
  • GMUS communicates with the GRS via the G-Repository Client API (GRCA).
  • GRCA accesses the GRS via a URL and Port Number of the where the GRS is installed.
    • mainPort - 192.168.100.10:8020
    • downloadPort - 192.168.100.10:8021
  • GMUS has its requestPort configured to port 9010.
  • The Client makes requests to the GMUS via GMUS requestPort 192.168.100.11:9010.

Notes:

  • The GMUS and GRS can only access ports your DevOps team makes available.
  • Configuring your machines' internal protocols is your DevOps team's responsibility. 
  • Selecting and opening port numbers is left to the discretion of your DevOps team.