Network Settings - Revision history

Steevithak: minor formatting cleanup

2020-09-19T14:58:09Z

minor formatting cleanup

Kcozens: Added some clarification about port 8003 to the Services section.

2014-10-21T19:17:18Z

Added some clarification about port 8003 to the Services section.

Justincc: /* UDP */

2014-06-16T18:14:33Z

‎UDP

Justincc: /* UDP */

2014-06-16T18:13:32Z

‎UDP

Justincc: /* TCP */

2014-05-22T17:32:42Z

‎TCP

Justincc: /* Standalone */

2014-05-22T17:32:29Z

‎Standalone

Justincc: Simplify grid access instructions, since all the simulator rules apply + the service considerations.

2014-05-22T17:32:03Z

Simplify grid access instructions, since all the simulator rules apply + the service considerations.

Justincc: /* UDP */

2014-05-22T17:10:12Z

‎UDP

Justincc: /* Introduction */

2014-05-22T17:09:48Z

‎Introduction

Justincc: Update standalone instructions

2014-05-22T17:08:41Z

Update standalone instructions

@@ Line 8: / Line 8: @@
 For help on general connection issues, see [[Troubleshooting#Networking and config issues]].
-= Standalone =
+= Standalone Mode =
 == TCP ==
-'''TCP/9000'''
+* '''TCP/9000'''
 The http_listener_port configured in the [Network] section of OpenSim.ini needs to be accessible externally.  By default this is 9000.
@@ Line 26: / Line 26: @@
 == UDP ==
-'''UDP/9000-9xxx'''
+* '''UDP/9000-9xxx'''
 The configured InternalPort of each region needs to be accessible for UDP traffic from the viewer (to exchange movement data, object information, etc.).  These configuration files are found in the bin/Regions/ directory.  The usual port for the first region is 9000, but each region needs its own port (usually then 9001, 9002, etc.).  However, any other set of ports can also be configured.
@@ Line 46: / Line 46: @@
 If you're running a simulator at home, it's much more likely that access to your LAN runs through a router which does not make your computer accessible via the Internet.  For more information on this, check out the ''NAT and Port Forwarding'' section below.
-= Grid =
+= Grid Mode =
 == Simulator ==
 For each simulator on your grid, the same ports as described for the standalone situation above need to be accessible to external viewers.  Although public services are not handled by OpenSim.exe in this configuration, the simulator HTTP port still needs to be available for other viewer <-> simulator communication mechanisms (e.g. capabilities).
@@ Line 54: / Line 57: @@
 == Services ==
-'''TCP/8002'''
+* '''TCP/8002'''
 In the standalone configuration, both simulator and services are contained within a single process (OpenSim.exe).
@@ Line 70: / Line 74: @@
 == FreeSWITCH Voice ==
-  TCP+UDP 5060 - SIP Ports (5060 for default call profile)
+* '''TCP+UDP 5060''' - SIP Ports (5060 for default call profile)
-  TCP+UDP 1720 - H.323 ports for call setup
+* '''TCP+UDP 1720''' - H.323 ports for call setup
 More details on the Freeswitch ports used and firewall configuration details are at:
@@ Line 80: / Line 84: @@
 == Mumble Voice ==
-  SIP Ports
+* SIP Ports
-  ICE Ports
+* ICE Ports
 = NAT and Port Forwarding =

@@ Line 64: / Line 64: @@
 In the default Robust.exe configuration, these are all served on the public port 8002.  These needs to be accessible by external viewers.
-However, in the grid configuration there are also a set of private services (asset, inventory, etc.).  By default, these run on port 8003 and should not be made accessible to viewers (i.e. they should be blocked by the firewall from external access).
+However, in the grid configuration there are also a set of private services (asset, inventory, etc.). By default, these run on port 8003 (TCP only) and it should not be made accessible to viewers. In a closed grid port 8003 should only be accessible to the machines which are being used to run the grid. If Robust and all OpenSim instances running regions are on a single machine no external access to port 8003 should be allowed.
 = Optional and Add-on Module Specific Ports =

@@ Line 28: / Line 28: @@
 '''UDP/9000-9xxx'''
-The configured InternalPort of each region needs to be accessible for UDP traffic from the viewer (to exchange movement data, object information, etc.).  These configuration files are found in the bin/Regions/ directory.  The usual port for the first region is 9000, but each region needs its own port (usually then 9001, 9002, etc.).  However, any other set of ports can also be configured if required.
+The configured InternalPort of each region needs to be accessible for UDP traffic from the viewer (to exchange movement data, object information, etc.).  These configuration files are found in the bin/Regions/ directory.  The usual port for the first region is 9000, but each region needs its own port (usually then 9001, 9002, etc.).  However, any other set of ports can also be configured.
 == IP Address ==

@@ Line 28: / Line 28: @@
 '''UDP/9000-9xxx'''
-The configured InternalPort of each region needs to be accessible for UDP traffic from the viewer (to exchange movement data, object information, etc.).  These configuration files are found in the bin/Regions/ directory.  The default port for the first region is 9000, but each region needs its own port (usually then 9001, 9002, etc.).
+The configured InternalPort of each region needs to be accessible for UDP traffic from the viewer (to exchange movement data, object information, etc.).  These configuration files are found in the bin/Regions/ directory.  The usual port for the first region is 9000, but each region needs its own port (usually then 9001, 9002, etc.).  However, any other set of ports can also be configured if required.
 == IP Address ==

@@ Line 22: / Line 22: @@
 In standalone mode, no private service port is exposed since all simulator to service communication occurs internally within the OpenSim.exe process.
-If you have XMLRPC active for in-world scripts (http://wiki.secondlife.com/wiki/Category:LSL_XML-RPC) (this is not active by default), then you will also need to make the XmlRpcPort configured in the [XMLRPC] section of OpenSim.ini accessible by external systems.  By default, this is '''20800'''.
+If you have XMLRPC active for in-world scripts (http://wiki.secondlife.com/wiki/Category:LSL_XML-RPC) (this is not active by default), then you will also need to make the XmlRpcPort configured in the [XMLRPC] section of OpenSim.ini accessible by external systems.  By default, this is '''TCP/20800'''.
 == UDP ==

@@ Line 48: / Line 48: @@
 = Grid =
-Ports used for Grid services (such as login, user control, grid management, asset services and inventory services, etc) are run within a ''Robust'' shell started by Robust.exe. They can be configured to state which port they run on, and the services can be run across multiple machines as desired to balance load.
+== Simulator ==
-But in a simple grid with all the Robust services running in a single Robust.exe shell it is normal to just use two ports for all services:
+For each simulator on your grid, the same ports as described for the standalone situation above need to be accessible to external viewers.  Although public services are not handled by OpenSim.exe in this configuration, the simulator HTTP port still needs to be available for other viewer <-> simulator communication mechanisms (e.g. capabilities).
-  TCP/8002 - All externally and user accessible OpenSimulator services
+== Services ==
-  TCP/8003 - All internal OpenSimulator services
-Hence, 8002 should be accessible through your firewall, but in this simple setup 8003 must be only accessible by simulators.
+'''TCP/8002'''
-== OpenSimulator Grid - Ports for Region Simulators ==
+In the standalone configuration, both simulator and services are contained within a single process (OpenSim.exe).
-One port must be open on any computer running an OpenSim.exe simulator that attaches to a grid. OpenSim.exe can be run on same computer (or one of computers) on which the Grid Services run, or on a separate computer. One OpenSim.exe can be used to run a number of regions, but each region must have its own unique port on that computer.
-  TCP+UDP/9000 - Default Port for First Simulator - grid, regions, and clients talk to these
+However, in the grid configuration, services run separately in one or more Robust.exe shells.
-  TCP+UDP/9001 - Default Prot for Second Simulator - grid, regions, and clients talk to these
-  TCP+UDP/900x - Default Port for further Simulators...
-In fact you can choose which port you prefer to use for each region on grid using the '''InternalPort''' parameter in the relevant Region description .ini file
+Some of these services, such as login, need to be accessible to viewers.
-XML-RPC communications, if enabled, are on the port specified in the [XMLRPC] section '''XmlRpcPort''' parameter (default port 20800).
+In the default Robust.exe configuration, these are all served on the public port 8002.  These needs to be accessible by external viewers.
-  TCP+UDP/20800 - Default Port for XML-RPC communications to a specific OpenSim.ini simulator (and all regions on it)
+However, in the grid configuration there are also a set of private services (asset, inventory, etc.).  By default, these run on port 8003 and should not be made accessible to viewers (i.e. they should be blocked by the firewall from external access).
 = Optional and Add-on Module Specific Ports =

@@ Line 4: / Line 4: @@
 = Introduction =
-These instructions are for enabling access to an OpenSimulator installation from behind a firewall. Please note that if you are using consumer network hardware, you will need a router that supports NAT loopback. See [[NAT Loopback Routers]].
+These are instructions for making an OpenSimulator installation accessible externally through a firewall or router. Please note that if you are using consumer network hardware, you will need a router that supports NAT loopback. See [[NAT Loopback Routers]] if you want give both LAN and external users access.
 For help on general connection issues, see [[Troubleshooting#Networking and config issues]].
 = Standalone =

@@ Line 11: / Line 11: @@
 = Standalone =
-* UDP+TCP/9000 - Services and the single region simulator are used via this single port
+== TCP ==
-* Check your /bin/Regions/ directory which contain one or more Region description files. Three of the fields will specify the internal IP address or domain name, the external IP address or domain name, and the port to be used for the region (which must be unique for each region) - something like this:
+'''9000'''
-  InternalAddress = "0.0.0.0"
-  InternalPort = 9000
-  ExternalHostName = 82.73.39.77
-* Retrieve your [http://www.ip-adress.com/ external_host_name]
+The http_listener_port configured in the [Network] section of OpenSim.ini needs to be accessible externally.  By default this is 9000.
-* Get your internal_ip_address (using ipconfig for windows, or ifconfig for linux)
-* Make sure the settings match
-Note: In majority of cases, it is best to leave the InternalAddress= "0.0.0.0"
+In standalone mode this provides
-Note: If you need to change the default InternalPort due to a conflict with another device etc, the change will also need to be reflected for http_listener_server in opensim.ini as well as the services ports in standalonecommon.ini in the Config-Include folder.
+* HTTP access to the simulator (needed for the capabilities protocol, amongst other things.
-If you have a router behind your internet-modem, check out ''NAT and Port Forwarding''.
+In standalone mode, no private service port is exposed since all simulator to service communication occurs internally within the OpenSim.exe process.
-Else you're good to go.
 = Grid =