From 32bc3443556287f7d1bc36b81488fa70c50b7be0 Mon Sep 17 00:00:00 2001 From: GeckoEidechse Date: Fri, 28 Jan 2022 18:32:08 +0100 Subject: Move server troubleshooting to parent category --- docs/SUMMARY.md | 2 +- .../dedicated-server/troubleshoot.md | 76 ---------------------- .../troubleshooting.md | 76 ++++++++++++++++++++++ 3 files changed, 77 insertions(+), 77 deletions(-) delete mode 100644 docs/hosting-a-server-with-northstar/dedicated-server/troubleshoot.md create mode 100644 docs/hosting-a-server-with-northstar/troubleshooting.md (limited to 'docs') diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md index 3241096..c5a40d2 100644 --- a/docs/SUMMARY.md +++ b/docs/SUMMARY.md @@ -27,7 +27,7 @@ * [Hosting a Dedicated Server](hosting-a-server-with-northstar/dedicated-server/README.md) * [Best practices](hosting-a-server-with-northstar/dedicated-server/best-practices.md) * [Hosting on Linux](hosting-a-server-with-northstar/dedicated-server/hosting-on-linux.md) - * [Troubleshoot](hosting-a-server-with-northstar/dedicated-server/troubleshoot.md) +* [Troubleshooting](hosting-a-server-with-northstar/troubleshooting.md) * [Guides](hosting-a-server-with-northstar/hosting-guides.md) ## Modding and Development diff --git a/docs/hosting-a-server-with-northstar/dedicated-server/troubleshoot.md b/docs/hosting-a-server-with-northstar/dedicated-server/troubleshoot.md deleted file mode 100644 index c4f7ea0..0000000 --- a/docs/hosting-a-server-with-northstar/dedicated-server/troubleshoot.md +++ /dev/null @@ -1,76 +0,0 @@ -# Document is empty -`[error] Failed reading masterserver authentification response: encountered parse error 'The document is empty.'` - -Masterserver needs to request your gameserver for it to be authentified and registered. -This error means that masterserver can't access your server's tcp port. - -Multiple problems can cause this error, but you can narrow it down by checking if your server is reachable from the outside. - -## Check if server is reachable - -You can check if the server is reachable using your internet browser. - -example : `http://{server_ip}:{server_tcp_port}/verify` should answer you `I am a northstar server!` - -Your server **must** be running while you check if the server is reachable. - -## If server is reachable using external IP - -#### Your GameServer is out of date - -Check that your server is running on the latest Northstar release as it can sometimes include breaking changes. - -#### Mastserver is down - -Check Northstar's Discord for annoucements. - -https://northstar.tf giving you a HTTP 523 error means that the masterserver is offline. - -#### Ports are not the same - -Your gameserver is configured to listen to a given TCP port. - -Masterserver needs to be able to contact your gameserver though that same port. - -#### Another Northstar Server is using the port - -Shutdown every other server to narrow down the problem - -This won't generally help but will allow you to avoid checking for the wrong server. - -## If server is not reachable using external IP - -Check if your server is reachable from your internal network's IP (often starts with `192.168.x.x`) - -#### Firewall is blocking tcp ports - -In some cases your Firewall or antivirus can prevent your ports to be exposed to your local network. -To fix this issue, make a rule to allow your server to listen on your network. -Disabling the firewall and antivirus can also work, even if it's not reccomended. - -## If server is not reachable using external IP but reachable using internal IP - -#### Router configuration is incorrect - -If your port can be accessed from your local IP but not from your public IP, then it's very likely that your NAT rules aren't properly configured. - -#### CGNAT - -See [CGNAT](https://r2northstar.gitbook.io/r2northstar-wiki/hosting-a-server-with-northstar/prerequisites#cgnat) - - -## If server is not reachable using external IP nor using internal IP - -Try checking your loopback network interface `http://127.0.0.1:{server_tcp_port}/verify` - -#### Another program is using the port - -Sometimes another program listens to the same tcp port as Northstar. - -You can check if that's the case by running `netstat -a -b` using CMD as admin - -As two programs cannot listen to the same port and IP at the same time, changing the TCP listen port can sometimes solve the problem. - -#### Server is using the wrong port - -You can use `netstat -a -b` using CMD as admin to check which process listens on which port diff --git a/docs/hosting-a-server-with-northstar/troubleshooting.md b/docs/hosting-a-server-with-northstar/troubleshooting.md new file mode 100644 index 0000000..c4f7ea0 --- /dev/null +++ b/docs/hosting-a-server-with-northstar/troubleshooting.md @@ -0,0 +1,76 @@ +# Document is empty +`[error] Failed reading masterserver authentification response: encountered parse error 'The document is empty.'` + +Masterserver needs to request your gameserver for it to be authentified and registered. +This error means that masterserver can't access your server's tcp port. + +Multiple problems can cause this error, but you can narrow it down by checking if your server is reachable from the outside. + +## Check if server is reachable + +You can check if the server is reachable using your internet browser. + +example : `http://{server_ip}:{server_tcp_port}/verify` should answer you `I am a northstar server!` + +Your server **must** be running while you check if the server is reachable. + +## If server is reachable using external IP + +#### Your GameServer is out of date + +Check that your server is running on the latest Northstar release as it can sometimes include breaking changes. + +#### Mastserver is down + +Check Northstar's Discord for annoucements. + +https://northstar.tf giving you a HTTP 523 error means that the masterserver is offline. + +#### Ports are not the same + +Your gameserver is configured to listen to a given TCP port. + +Masterserver needs to be able to contact your gameserver though that same port. + +#### Another Northstar Server is using the port + +Shutdown every other server to narrow down the problem + +This won't generally help but will allow you to avoid checking for the wrong server. + +## If server is not reachable using external IP + +Check if your server is reachable from your internal network's IP (often starts with `192.168.x.x`) + +#### Firewall is blocking tcp ports + +In some cases your Firewall or antivirus can prevent your ports to be exposed to your local network. +To fix this issue, make a rule to allow your server to listen on your network. +Disabling the firewall and antivirus can also work, even if it's not reccomended. + +## If server is not reachable using external IP but reachable using internal IP + +#### Router configuration is incorrect + +If your port can be accessed from your local IP but not from your public IP, then it's very likely that your NAT rules aren't properly configured. + +#### CGNAT + +See [CGNAT](https://r2northstar.gitbook.io/r2northstar-wiki/hosting-a-server-with-northstar/prerequisites#cgnat) + + +## If server is not reachable using external IP nor using internal IP + +Try checking your loopback network interface `http://127.0.0.1:{server_tcp_port}/verify` + +#### Another program is using the port + +Sometimes another program listens to the same tcp port as Northstar. + +You can check if that's the case by running `netstat -a -b` using CMD as admin + +As two programs cannot listen to the same port and IP at the same time, changing the TCP listen port can sometimes solve the problem. + +#### Server is using the wrong port + +You can use `netstat -a -b` using CMD as admin to check which process listens on which port -- cgit v1.2.3