OpenSimulator - User contributions [en]

NAT Loopback Routers

2015-03-17T01:44:59Z

Breen.whitman: /* Router / Modem Table */

{{Quicklinks}} {{content}}

= INTRODUCTION =

What is NAT Loopback and why is it needed to host a public Opensimulator Region?

Currently (as at August 2010), a hosted region on a home connection with a broadband router needs, what is known as ''NAT Loopback'' functionality.

Many DSL routers/modems prevent loopback connections as a security feature. This means that a machine on your local network (e.g. behind your DSL router/modem) cannot connect to a forward facing IP address (such as 199.149.252.44) of a machine that it also on your local network. Connecting to the local IP address (such as 192.168.2.40) of that same machine works fine.

This is an issue since each region has to specify an IP address for the client to connect. This is the ExternalHostName parameter in a regions config file (e.g. bin/Regions/Regions.ini). In the absence of NAT loopback, if a forward facing IP address is specified (such as 199.149.252.44) then external clients will be able to connect to the region but clients on your local network will not. If the internal address were put in ExternalHostName instead (e.g. 192.168.2.40) then viewers on the local network will be able to connect but viewers from an external network would not.

This page shows a list of routers supporting NAT Loopback. Please add both known working and non-working routers to the list.

= Router/Modem Table =
==== Router / Modem Table ====
(this information gathered from the OpenSimulator WIKI and OSGrid forums information collectively and assembled into this sortable formatted table for ease of use and quick access. Links provided are either to the Manufactures pages or Pages which can further assit in configuration and troubleshooting.)

{| cellspacing="0" cellpadding="5" border="1" align="centre" class="sortable"
|-
| '''Make''' || '''Model''' || '''Status''' || '''Notes'''
|-
| Actiontec || [http://www.actiontec.com/support/product_details.php?pid=71 GT701-WG] || Works || [http://portforward.com/english/routers/port_forwarding/Actiontec/GT701WG/default.htm]
|-
| Actiontec || [http://www.actiontec.com/products/product.php?pid=189 Verizon FiOS Router Model # 424WR] || Works || [http://www.actiontec.com/support/product_details.php?pid=189#q23] Set TCP and UDP separately
|-
| Airlink || Airlink 101 Super G || Works || older model, search for reference
|-
| Airlink || Airlink 101 802.11G wireless || Works || older model, search for reference
|-
| Apple || [http://www.apple.com/airportextreme/ AirPort Extreme] || Works ||
|-
| Arris || TM502b || Works || [http://portforward.com/english/routers/port_forwarding/Arris/TM502b/]
|-
| Astoria Networks || Bright Box Wireless Router || Not Working || |
|-
| Asus || [http://www.asus.com/Networks/Wireless_Routers/WL520gC/ WL-520GC] || Works || [http://portforward.com/english/routers/port_forwarding/Asus/WL-520GC/defaultguide.htm]
|-
| AVM || FRITZ!Box || Works || [http://www.avm.de/en/Produkte/FRITZBox/index.html] Except 3790 VDSL Router (old stock)
|-
| Belgacom BBox-2 || [http://support.en.belgacom.be/app/answers/detail/a_id/14453/~/how-to-install-and-manage-my-wireless-modem%3F BBox-2 Docs] || Works || Also known as [http://www.sagemcom.com/index.php?id=1226&L=0 SAGEM 3464]. BBox-1 work, BBox-2 = Method 1: flash the firmare (in this case we lose the guarantee provider) Method 2: Configure Bbox Bridge mode and put a second router for OpenSim-Sim. [http://logicamp.forumpro.fr/t7-nat-loopback-b-box2-belgacom LOGICAMP tuto (in french)]
|-
| BT || BT Home Hub V2 || Works || [http://portforward.com/english/routers/port_forwarding/BT/BT_Home_Hub_v2/defaultguide.htm]
|-
| BT || BT Home Hub 3 (model B) || Works || [Tested using firmware V100R001C01B031SP12_L_B on standalone ]
|-
| BT || BT2700HGV || Works || [ http://portforward.com/english/routers/port_forwarding/BT/BT2700HGV/defaultguide.htm]
|-
| Cisco || [http://www.cisco.com/en/US/products/ps9925/index.html RV042] || Works ||
|-
| Dlink || [http://www.dlink.com/products/?pid=DGL-4500 DGL-4500] || Works || [http://portforward.com/english/routers/port_forwarding/Dlink/DGL-4500/defaultguide.htm]
|-
| Dlink || [http://www.dlink.com/products/?pid=370 DGL-4300] || Works || [http://portforward.com/english/routers/port_forwarding/Dlink/DGL-4300/defaultguide.htm]
|-
| Dlink || [http://www.dlink.ca/products/?tab=3&pid=DI-524&rev=DI-524 DI-524] || Works || [http://portforward.com/english/routers/port_forwarding/Dlink/DI-524/defaultguide.htm]
|-
| Dlink || [http://www.dlink.com/products/?pid=DIR-600 DIR-600] || Works || [http://portforward.com/english/routers/port_forwarding/Dlink/DIR-600/defaultguide.htm]
|-
| Dlink || [http://www.dlink.com/products/?pid=DIR-601 DIR-601] || Works || [http://portforward.com/english/routers/port_forwarding/Dlink/DIR-601/defaultguide.htm]
|-
| Dlink || [http://www.dlink.com/products/?pid=DIR-635 DIR-635] || Works || [http://portforward.com/english/routers/port_forwarding/Dlink/DIR-635/defaultguide.htm]
|-
| Dlink || [http://www.dlink.com/products/?pid=DIR-655 DIR-655] || Works || [http://portforward.com/english/routers/port_forwarding/Dlink/DIR-655/defaultguide.htm] Current hardware version "B" doesn't work.
|-
| Dlink || [http://www.dlink.com/uk/en/home-solutions/connect/modems-and-gateways/dsl-2680-wireless-n-150-adsl2--home-router DSL-2680] || Not Working ||
|-
| Draytek || [http://www.draytek.com/user/PdInfoDetail.php?Id=71 Vigor120] || Works || Nat Loopback out of the box. Great router.
|-
| Draytek || [http://www.draytek.com/user/PdInfoDetail.php?Id=82 Vigor2710] || Works || [http://portforward.com/english/routers/port_forwarding/DrayTek/Vigor_2710n/defaultguide.htm] firmware 3.2.4.3 (or higher).
|-
| Inventel / Livebox || DV42190WA || Works || Sold as Livebox 3420 by Orange/SFR in Europe. Set port forwarding for UDP and TCP separately
|-
| Linksys/Cisco || [http://homesupport.cisco.com/en-us/wireless/lbc/BEFSR41/ BEFSR41] || Works || [http://portforward.com/english/routers/port_forwarding/Linksys/BEFSR41/defaultguide.htm]
|-
| Linksys/Cisco || RT31P2 || Works || [http://portforward.com/english/routers/port_forwarding/Linksys/RT31P2/defaultguide.htm]
|-
| Linksys/Cisco || [http://www.linksysbycisco.com/APAC/en/support/AG241 AG241] || Works || [http://portforward.com/english/routers/port_forwarding/Linksys/AG241/defaultguide.htm]
|-
| Linksys/Cisco || [http://www.linksysbycisco.com/EU/en/support/WAG200G WAG200G] || Works || [http://portforward.com/english/routers/port_forwarding/Linksys/WAG200G/default.htm] Firmware Version: 1.01.09 or better
|-
| Linksys/Cisco || [http://en.wikipedia.org/wiki/Linksys_WRT54G_series WRT54G] || Works || [http://portforward.com/english/routers/port_forwarding/Linksys/WRT54G/default.htm]
|-
| Linksys/Cisco || [http://www.linksysbycisco.com/ANZ/en/products/WAG160N WAG160N] || Works || [http://portforward.com/english/routers/port_forwarding/Linksys/WAG160N/default.htm]
|-
| Linksys/Cisco || [http://homesupport.cisco.com/en-us/wireless/lbc/WAG54G WAG54G v3] || Works ||
|-
| Linksys/Cisco || [http://www.linksysbycisco.com/ANZ/en/products/E3000 E3000] || Works || [http://portforward.com/english/routers/port_forwarding/Cisco/Linksys-E3000/default.htm]
|-
| Linksys/Cisco || [http://homesupport.cisco.com/en-us/wireless/lbc/WAG54G WAG54G v2 - NZ/AU] || Works || Faster processor, more memory and larger NAT table
|-
| Linksys/Cisco || WAG120N || Works ||
|-
| Linksys/Cisco || Linksys RT31P2 || Works ||
|-
| Netgear || WNR834M || Works ||
|-
| Netgear || WNR2000 || Works || With firmware 1.2.3.7 Loop back now enabled 'out of the box'
|-
| Netgear || WGR614 || Works || confirmed to work out of the box
|-
| Netgear || RP614 || Works || Version 3 or better
|-
| Netgear || DG834G || Works || v1, v2, v3 & v4 are end of line in most markets. The v3 & v4 are proven good performers. v5 unknown to work.
|-
| Netgear || Pro Safe VPN FVS318 || Not Working || [http://www.netgear.com/service-provider/products/security/wired-VPN-firewalls/FVS318.aspx#two]
|-
| Netgear || WGR614 || Not Working || [http://www.netgear.com/home/products/wirelessrouters/simplesharing/WGR614.aspx] does not work with ISP required gateway modems
|-
| Netgear || [http://support.netgear.com/app/products/family/a_id/8213 WNR3500 ] || Works || [http://portforward.com/english/routers/port_forwarding/Netgear/WNR3500/defaultguide.htm] NB restart after configuration
|-
| Netgear || RP614v3 and Newer revisions || Works || [http://portforward.com/english/routers/port_forwarding/Netgear/RP614v3/defaultguide.htm]
|-
| Netgear || [http://www.netgear.com/home/products/wirelessrouters/high-performance/WNDR3700.aspx WNDR3700] || Works || [http://portforward.com/english/routers/port_forwarding/Netgear/WNDR3700/default.htm]
|-
| SMC || [http://www.smc.com/index.cfm?event=viewProduct&cid=1&scid=17&localeCode=EN%5FUSA&pid=924 SMC-7004VBR] || Works || [http://portforward.com/english/routers/port_forwarding/SMC/SMC7004ABR/defaultguide.htm]
|-
| Thomson SpeedTouch || TG585 || Works || [http://portforward.com/english/routers/port_forwarding/Thomson-Alcatel/SpeedTouch585/default.htm] new ver. Only
|-
| Thomson SpeedTouch || ST-585i || Works || [http://portforward.com/english/routers/port_forwarding/Thomson-Alcatel/SpeedTouch585i/default.htm] May need to enable loopback through telnet
|-
| Thomson SpeedTouch || ST-780 || Works || [http://portforward.com/english/routers/port_forwarding/Thomson-Alcatel/ST780/default.htm] May need to enable loopback through telnet
|-
| Thomson SpeedTouch || ST-516 || Works || [http://portforward.com/english/routers/port_forwarding/Thomson-Alcatel/SpeedTouch516/default.htm]May need to enable loopback through telnet
|-
| TP-Link || TL-WR740N || Works || All TP-Link wired routers are said to support loopback, including the wifi ones. This one has been confirmed by support staff.
|-
| TP-Link || [http://www.tp-link.com/en/products/details/?categoryid=227&model=TL-R470T%2b TL-R470T+] || Works || All TP-Link wired routers are said to support loopback, including the wifi ones. This one has been confirmed by support staff.
|-
| Scientific Atlanta || WebSTAR-DPR2320 || Works || [http://portforward.com/english/routers/port_forwarding/Scientific-Atlanta/WebSTAR-DPR2320/default.htm] Google for more info
|-
| Ubee || DDW2600 || Works || [http://www.ubeeinteractive.com/index.php/products/product-overview/wireless_cable_router1/] Cable Router
|-
| 3Com / HP || 3CRWDR100A-72 || Works || [http://portforward.com/english/routers/port_forwarding/3com/3CRWDR100A-72/default.htm]
|-
| 3Com / HP || 3CRWDR101A-75 || Works || [http://portforward.com/english/routers/port_forwarding/3com/3CRWDR101A-75/eMule.htm]
|-
| 2wire || 2701hg-s || Not Working ||
|-
| 2wire || 2701hg-B || Works || [http://portforward.com/english/routers/port_forwarding/2wire/2701HG-B/default.htm]
|-
| 2wire || 2701hg-D || Works || [http://portforward.com/english/routers/port_forwarding/2wire/2701HG-D/default.htm]
|-
|}

= Notes on Some Routers =

== D-Link ==

D-Link DGL-4500 series of routers have the largest available nat table of any router on the market.  These routers range from 70$-180$ USD depending on where you live and purchase from.

When considering a purchase, consider performance against cost. Upper end ADSL 2+ routers can add several Mbs to your modems sync speed.

'''Wireless Routers - Access Point Only'''

These routers are Access Point devices, and contain no ADSL modem and hence need a separate adsl modem operating in Bridge mode.

* [http://www.dlink.com/products/?pid=64 D-Link DGL-4500]
* [http://www.dlink.com/products/?pid=530 D-Link DIR-655]
* [http://www.dlink.com/products/?pid=DIR-635 D-Link DIR-635]
* [http://www.dlink.com/products/?pid=DIR-601 D-Link DIR-601]
* [http://www.dlink.com/products/?pid=DIR-600 D-Link DIR-600]
* D-Link DI-524

'''Routers With ADSL modem'''
No items to list currently

Note: The DGL-4100 & DGL-4300 have been discontinued, and the replacement model is the DIL-825 and DIL-855 - Loopback status unknown on these later models. The DGL-4300 may be available second hand.

== Netgear ==

* NETGEAR WNR834M : ftp://downloads.netgear.com/files/wnr834m_ref_manual.pdf

* Netgear DG834G v3 with latest firmware & v4 upto firmware version v5.01.09 (according to [http://forum1.netgear.com/showthread.php?t=42641 this link], a later firmware update of v4 removed NAT loopback) NAT Loopback returned as menu option with latest v5.01.16 firmware for the v4 model. The latest model versions, marked v5 on the unit's label, has significantly different internals and is not currently Loopback capable(the v5 has the wireless aerial on the right, not the left, as looking from the front. The DG834G v1, v2, v3 & v4 are end of line in most markets. The v3 & v4 are proven good performers.
* Netgear DGN1000 worked out of the box. Note this working item reports its firmware version as V2.1.00.19_VG which seems much newer than the version offered for download on netgear.com.
* NETGEAR FVS338 : loopback issue with firmware v3.0.3-17 (2008). LAN address is incorrectly presented to simulator instead of WAN address. Fixed in latest update v3.0.6-25 (2010).

== Other routers & Hardware ==

* BT home hub V2
* If you are using a ZyXEL DSL router/modem from Embarq, please read [[OpenSim:Network_settings#A_solution_for_local_connections_when_you_are_using_NAT_and_Port_Forwarding|this configuration guide]]. This will show you how to reconfigure your DSL router/modem to fix this problem.

= KNOWN non-functional for OpenSim: =

* Netgear Pro Safe VPN FVS318 : [http://www.netgear.com/Products/VPNandSSL/WiredVPNFirewallRouters/FVS318.aspx http://www.netgear.com/Products/VPNandSSL/WiredVPNFirewallRouters/FVS318.aspx]
* NetGear WGR614 does not work with ISP required gateway modems
* Belkin F5D7230-4 (the router might work if 3rd party firmware is used, such as DD-WRT : http://www.dd-wrt.com/ )

 

= REFERENCE LINKS: =

More Information Related to Routers and Solutions @: [http://osgrid.org/forums/viewtopic.php?f=8&t=2283 osgrid.org/forums/viewtopic.php]

= Linux specific solutions =
== SETTING UP A LINUX COMPUTER TO ACT AS A ROUTER ==

----

For Linux based Netfilter (iptables) routers, you want to set up the NAT table with some extra entries The following script is something to get you started, you'll need to fix up the variables at the top to match your system and network. <source lang="bash">
#!/bin/bash
#
# vvvvv - Fix these! - vvvvv
IPTABLES=/usr/sbin/iptables
LAN_NETWORK=192.168.0.0/24
SERVER_IP=192.168.0.2
INTERNET_IP=100.100.100.100
REMOTING_PORT=8895
REGION_PORT=9000
# ^^^^^ - Fix these! - ^^^^^

# First, the Destination NAT, anything going to the external address on our ports, we redirect to the server
# Note, if you have a double NAT running and this router doesn't actually have the internet IP address, you'll
# need another set of PREROUTING-DNAT lines with the --destination (-d) set to the internet facing private address
$IPTABLES -t nat -I PREROUTING -d $INTERNET_IP -p tcp --dport $REMOTING_PORT --jump DNAT --to-destination $SERVER_IP
$IPTABLES -t nat -I PREROUTING -d $INTERNET_IP -p udp --dport $REGION_PORT --jump DNAT --to-destination $SERVER_IP
$IPTABLES -t nat -I PREROUTING -d $INTERNET_IP -p tcp --dport $REGION_PORT --jump DNAT --to-destination $SERVER_IP

# Second, the Source NAT, we need this so that returning packets to our LAN clients go back through the router first,
# otherwise, the server will try to talk directly to the client and the client will reject them
$IPTABLES -t nat -I POSTROUTING -s $LAN_NETWORK -d $SERVER_IP -p tcp --dport $REMOTING_PORT --jump SNAT --to-source $INTERNET_IP
$IPTABLES -t nat -I POSTROUTING -s $LAN_NETWORK -d $SERVER_IP -p udp --dport $REGION_PORT --jump SNAT --to-source $INTERNET_IP
$IPTABLES -t nat -I POSTROUTING -s $LAN_NETWORK -d $SERVER_IP -p tcp --dport $REGION_PORT --jump SNAT --to-source $INTERNET_IP
</source>

--[[User:Hell Fire|Hell Fire]]

== DNS solution ==
It's possible to host your own DNS-server, so you can prevent some of the dns-naming problems mentioned before. If http://example.org resolves to the external ip, and that loopback connection is prevented by your router, you could point your resolv.conf to a local nameserver like:
nameserver 192.168.2.2
Now you need bind/named installed in order to handle the dns-requests. You can find a bind example configfile here.

= openWRT Routers: =

If you use openWRT firmware on your router, check here: [[Users:Thomax:nat-loopback|OpenWRT NATLoopback]]

= Windows XP, Win7 Loopback Adapter Install: =

Please see this -> Windows XP: http://www.windowsnetworking.com/articles-tutorials/windows-xp/Install-Microsoft-Loopback-adapter-Windows-XP.html

Windows 7: http://www.windowsreference.com/windows-7/how-to-install-a-loopback-adapter-in-windows-7/

[[Category:Hardware]]

See more potential loopback solutions here: http://opensimulator.org/wiki/Network_Settings#DynDNS_loopback

2010-01-11T09:46:36Z

Breen.whitman:

__NOTOC__
{{Template:Quicklinks}}

== Overview ==

*[[ScriptEngines|New Script Engine]] - New Script Engine Transition (By Melanie_T)
*[[Scripting Languages]] - Supported Scripting Languages
*[[OSSL Proposals|OSSL Proposals]] - Suggestions for custom OSL-functions
*[[OSSL Implemented|OSSL Implemented]] - A list of OSL-functions that are available
*[[OSSL TextureDrawing|OSSL Texture Drawing Functions]] - Details of the os texture drawing functions
*[[ OSSL Enabling Functions|OSSL Enabling Functions]] - How to Enable osFunctions in your OpenSim.ini
*[[LSL Status/Functions|LSL Implemented]] - A list of LSL-functions that are available in OpenSim
*[[OS Scripting Tutorial]] - Some useful hints for scripting in OpenSim environments
*[[Non-LSL scripting]] - Information on C# and scripting in OpenSim with other languages

==About OpenSim scripting==
An important ingredient in Second Life is scripting. It is the engine that drives it all. In SL [http://wiki.secondlife.com/wiki/LSL_Portal LSL (Linden Scripting Language)] is the language you have to use. This language has its limitations, and is executed very slowly. But nevertheless it works and it gets the job done. Linden Lab are moving LSL scripting over to Mono in Q3 2008. 

OpenSim today supports LSL,OSL and C# scripts. But with limitations:
* Not all commands and events have been implemented. See [[LSL Status]] for details on what commands work and which don't.
* Scripts that are running cannot cross region borders.
* You cannot use loops inside your scripts. Actually you can use loops, but it will block other scripts from executing.
The OpenSim script engine compiles the LSL code down to .Net code that is JIT'ed to CPU native code. In effect this means that a LSL script in OpenSim should run faster than in Second Life. Stability and security: see [[Script_Sandbox | Script Execution Sandbox]].

==How to use scripts in OpenSim==
Have a look at the [http://wiki.secondlife.com/wiki/LSL_Portal LSL wiki] to learn LSL. The current procedure to get a script working in OpenSim is:
* Create a new script in inventory. (Inventory -> Create -> New Script)
* Write whatever script you want there, or copy the script contents of another script in the pre-existing OpenSim library. Check [[LSL Status]] for what commands that are supported.
* Drag the script over to the contents of an object.
* If there is an error in the script when saving or when dropped into an object an error alert is displayed for a short time. Click on the alert to display the Debug Window and the script error.
* To deactivate a script, edit the script and uncheck 'Running'. This also stops error alerts when saving scripts.
* Deleting the script from the object will not always deactivate a script. If a script is running in a prim and the script is deleted, the script may persist in the prim - which can be useful. Be sure scripts are not running when you wish to delete them.

There are still some defects:
* Line numbers in error messages may miss by 1 or 2 lines.

== How to contribute ==
The ScriptEngine is being developed by many developers. New developers are always welcome. If you want to contribute, even just a tiny little bit, have a look at the [[OpenSim.Region.ScriptEngine]] page. There is a lot of developer activity on IRC ([[Contact us]]), feel free to drop in. A blog with development status can be found at [http://teddmaa.blogspot.com/ http://teddmaa.blogspot.com/].

== Additional Resources for Scripting (LSL)==
There have been many questions regarding scripts and tools for scripting lately. Presented here are a variety of Links to Resources which will help most people with Scripting LSL.

At present there is no WIKI for OSSL Functions of OpenSim Specific stuff like those available for SL, hopefully someday we will have our own but that is a monumental task in itself.

'''OspenSimulator Specific Materials:'''

http://opensimulator.org/wiki/OSSL_Implemented

http://opensimulator.org/wiki/LSL_Status/Functions

'''NOTE:''' Be sure to check the Discussion Pages which is on the tabs at the top.

'''Suggested Links for LSL wikis:'''

http://wiki.secondlife.com/wiki/LSL_Portal

http://www.lslwiki.net/lslwiki/wakka.php?wakka=HomePage

http://rpgstats.com/wiki/index.php?title=Main_Page

http://www.cheesefactory.us/slwm/LSL_Portal.html

Note the Tutorials, Examples & Script Libraries

'''Off-World Local LSL Editing Tools (note they do not support osFunctions)'''

'''LSLeditor''' http://www.lsleditor.org/
Proprietary editor. No updates since 2008, so latest functions will break the syntax checker. Itis, however, still a very good editor, and a valuable tool.

'''LSLplus''' http://lslplus.sourceforge.net/
Open source. Regualar updates. Not quite as quick to get installed as LSLEditor, but very good tool.

Others are listed here: http://wiki.secondlife.com/wiki/LSL_Alternate_Editors

'''Miscelaneous:'''

AutoScript, Simple & Quick Code generator for simple things (ONLINE)
http://www.hilarymason.com/blog/secondlife/autoscript-creates-lsl-scripts-without-code/

lslsnippets
http://code.google.com/p/lslsnippets/

Free offsite storage for LSL scripts up to 250k
http://www.vtoreality.com/2006/free-offsite-storage-for-lsl-scripts-up-to-250k/186/

Free SL Scripts (library)
http://www.freeslscripts.gendersquare.org/index.php

Scratch for SecondLife (Script Code generator with Nice Interface - UPDATED JUL.09.2009)
http://s4sl.blogspot.com/

Second Life Animated Texture Creator v0.4 - brought to you by Peregrine Salon
http://www.peregrinesalon.com/2009/01/05/major-upgrade-to-animated-gif-to-animated-sl-texture-conversion-tool-v04/

[[Category:Development]]
[[Category:Users]]
[[Category:Scripting]]

User:Breen.whitman

2010-01-09T11:36:02Z

Breen.whitman: New page: Breen Whitman is an OpenSim evangelist. He has a tertiary degree in Computer Science and Information Systems. Interests in particular are databases and communications.

Breen Whitman is an OpenSim evangelist. He has a tertiary degree in Computer Science and Information Systems. Interests in particular are databases and communications.