# Synchronet Version 3 and TCP/IP
Answers to Frequently Asked Questions

## Table of Contents:

- What inbound ports do I need to open in my firewall?
- How come my friends can't connect to my BBS at my IP address?
- What is my public IP address?
- Why can't I relay Internet e-mail through my BBS?
- Why can't I send Internet e-mail from my BBS?
- Why can't my BBS receive Internet e-mail or inter-BBS instant messages?
- Why can't users connect to my FTP server?
- Why do FTP clients lock-up or time-out when listing directories or downloading files from my FTP server?
- Why do external programs that use socket I/O not work on my Windows BBS?
- Why do some or all of my servers get bind errors when starting or recycling?
- How many nodes/clients/users can I support with my Internet connection?

Question:
What inbound ports do I need to open in my firewall?

Answer:
Depends on which Synchronet servers and services you wish to make available to Internet clients and which ports you have configured those servers and services to listen on.

The default Synchronet installation enables servers and services on the following ports:

Protocol | TCP | UDP | Comments
--- | --- | --- | ---
Telnet | 23 | - | For Telnet logins (highly recommended)
SSH | 22 | - | For SecureShell logins (recommended)
RLogin | 513 | - | Optional for quick-login from RLogin clients (e.g. SyncTerm)
SMTP | 25 | - | Necessary for receiving Internet e-mail and inter-BBS instant messages
POP3 | 110 | - | Allows BBS users to check their e-mail using standard Internet mail clients (e.g. Outlook Express)
FTP | 21 | - | Allows access to the BBS file/download areas using a standard FTP client or web browser
HTTP | 80 | - | Required for access to the BBS's web server
NNTP | 119 | - | Allows BBS users to read and post messages using standard news readers/clients
Gopher | 70 | - | Archaic protocol allows reading of messages and other BBS info
IRC | 6667 | - | Allows Internet Relay Chat (IRC) clients to connect to your BBS
Finger | 79 | 79 | Allows remote querying of BBS user info, who's online, and other BBS info
SYSTAT | 11 | 11 | Allows remote querying of who's online (aka Active Users)
QOTD | 17 | 17 | Allows remote querying of the current auto-message (aka Quote Of The Day)
MSP | 18 | 18 | Allows incoming inter-BBS instant messages without SMTP connectivity

Enabling connectivity to Synchronet through your firewall is no different than enabling connectivity to any other TCP/IP server. Follow your firewall documentation for forwarding or opening ports for TCP/IP servers located "behind" the firewall. Your firewall may have the option of placing the entire BBS computer in a "DMZ" (opening all its ports to the public Internet), but doing so is not normally recommended.

Question:
How come my friends can't connect to my BBS at my 192.168.x.x, 172.[16-31].x.x, or 10.x.x.x IP address?

Answer:
The IP address ranges listed above are reserved for use in private networks and are not publicly addressible from the Internet. See this document for technical details.

You do not want to advertise this IP address to the public since it is useless to anyone outside of your own private/local area network (LAN). IP addresses in these ranges are typically assigned to your computer by your router/firewall device (using DHCP) to allow multiple computers on your private network to share the same public IP address using a mechanism known as Network Address Translation (NAT). Clients on the Internet must use the IP address of your router/firewall device's public/WAN port to connect to your BBS. This IP address will not begin with 192.168, 172.[16-31], or 10.

Question:
What is my public IP address?

Answer:
If you need to know your public IP address, you can usually query your router/firewall device using it's configuration interface (typically via Telnet or HTTP to its private/LAN port) or access any one of many public web-sites that can tell you what your public IP address is. However, it is usually much better to advertise a hostname (e.g. vert.synchro.net) rather than a cryptic hard-to-remember IP address (e.g. 69.104.209.211).

If you use a Dynamic DNS service to get a hostname for your BBS, they can usually correctly determine your public IP address automatically, even if your IP address changes. So you don't need to necessarily know what it is.

Question:
Why can't I relay Internet e-mail through my BBS?

Answer:
Indications of this problem include error messages in your e-mail client similar to the following:
`553 Relaying through this server requires authentication. Please authenticate before sending.`
`550 Relay not allowed.`
Or error messages similar to the following in your Synchronet Mail Server window/log output:
`0504 !SMTP ILLEGAL RELAY ATTEMPT from <yourname@yourhost.org> [192.168.0.2] to someuser@somehost.com`
Where the from address is that of your mail sending host and the to address is that of an external mail recipient that you are attempting to send e-mail to.

It is common and normal to see "illegal relay attempts" from remote systems that have happened on your mail server and are probing it to determine if it is an "Open Relay". So called "Open Relays" (mail servers that allow any and every host to relay mail through them) are a major source of SPAM on the Internet and are highly discouraged.

By default, the Synchronet Mail Server disallows the relaying of SMTP e-mail messages received for an external recipient (not destined for a local BBS user account).

You can allow specific hosts or users to relay e-mail through your mail server by either:

1. Entering the sending host's IP address or hostname in your `ctrl/relay.cfg` file.
   This file may be edited with the SBBSCTRL:Mail->Edit->Allowed Relay List menu option.

   or:

2. Use SMTP authentication:
   1. Enable the mail server configuration option to allow authenticated users to relay mail.
      This can be done by adding `ALLOW_RELAY` to the `Options` key of the `[mail]` section of your `ctrl/sbbs.ini` file.
      Or, if using SBBSCTRL, checking the "Allow Authenticated Users to Relay Mail" checkbox on the SMTP tab of the Mail Server Configuration dialog.

   2. Configure your e-mail client to use SMTP authentication to login to your mail server using your BBS user name (i.e. alias) and password.
   The Synchronet Mail Server supports the following SMTP authentication schemes:
   - PLAIN
   - LOGIN
   - CRAM-MD5
     (Note: password case sensitivity can be an issue when using CRAM-MD5 authentication)

Question:
Why can't I send Internet e-mail from my BBS?

Answer:
You must have the Synchronet SendMail thread enabled in your Synchronet Mail Server configuration.
If you do not see the following message in your Synchronet Mail Server window/log output when the server is started or recycled:

`0000 SendMail thread started`

then you do not have the SendMail thread enabled and your system cannot deliver any Internet e-mail messages until it is enabled and recycled (delivery of any previously queued outbound messages will be attempted at that time).

If your Synchronet SendMail thread cannot deliver e-mail messages, it could be for any of the following reasons:

1. You have your mail server configured for "Direct Delivery", but have an improperly configured DNS server IP address.
   Example errors indicating this condition include:
   `0000 !SEND INVALID DNS server address`
   `0000 !SEND ERROR -1 obtaining MX records for someserver.com from 192.168.1.1`

   The configured DNS server IP address should usually be set to that of your ISP's primary DNS server.

   Note: Synchronet v3.13b can automatically detect and use your DNS server's correct IP address during run-time. This feature is enabled by configuring the DNS server IP address in the mail server configuration to blank or `<auto>`.
   You'll know this feature is active when you see log lines similar to the following:
   `0000 SEND using auto-detected DNS server address: 206.13.29.12`

2. Your firewall, Internet Service Provider, or Anti-Virus software is blocking, intercepting, or filtering outbound connections to TCP port 25 (many consumer-class ISPs do this).
   Example errors indicating this condition include:
   `0700 !SEND ERROR 60 connecting to SMTP server: smtp.somedomain.com`
   `0023 !SEND ERROR 110 connecting to SMTP server: mx.somesite.org`

   You can verify if this is the case by attempting to Telnet to a known public SMTP server (e.g. vert.synchro.net) on TCP port 25.
   You should see a mail server version banner similar to the following:
   `220 bbs.synchro.net Synchronet SMTP Server 1.362-Win32 Ready`

   If you cannot connect or do not see a mail server version banner, then something is filtering or blocking your outbound connections to TCP port 25.

   If your ISP is blocking port 25, they will normally make an exception for their own mail servers (e.g. `mail.yourisp.com` or `smtp.yourisp.com`). If this is the case (and your ISP's mail server allows the from address of your e-mail message to contain any hostname or IP address of your choosing), then you need to configure your mail server to use your ISP's mail server as its relay server. Do not use your own mail server's hostname or IP address as the relay server (this will cause an undesireable message "loop").

   If your ISP's mail server only allows e-mail to be sent from `somename@yourisp.com` then you need to contact your ISP about how you can send e-mail from a different domain using their mail server. Perhaps they only allow this feature when using SMTP authentication?

3. You have your mail server configured to use an external "Relay Server", but have an improperly configured relay server hostname or IP address.
   Example errors indicating this condition include:
   `0000 !ERROR resolving hostname: badhostname.com`
   `0680 !SEND ERROR 60 connecting to SMTP server: 192.168.1.1`

4. You have your mail server configured to use an external "Relay Server", but the specified relay server requires SMTP authentication in order to allow relaying of mail.
   Example errors indicating this condition include:
   `0000 !Delivery attempt #1 FAILED (somehost.org replied with: "550 Relay not allowed." instead of the expected reply: "250 ...")`
   `0000 !Delivery attempt #1 FAILED (somehost.org replied with: "553 Authentication required." instead of the expected reply: "250 ...")`

   Synchronet v3.12+ supports the Plain, Login, and CRAM-MD5 methods of SMTP authentication when relaying mail through an external relay server. To enable SMTP authentication when relaying, add one of the `RELAY_AUTH` flags to the `Options` value in the `[Mail]` section of your `ctrl/sbbs.ini` file. Or, if running SBBSCTRL-Win32, enable one of the authentication radio buttons on the "Relay" tab of the Mail Server Configuration dialog.

5. You have a message in your outbound e-mail queue that is flagged as 'in transit'. If you're running only one instance of the Synchronet Mail Server, this is not a normal condition and the affected message will not be sent until the 'in transit' flag is cleared.
   Example log message indicating this condition:
   `0000 SEND Message #999 from Some User to someone@somesite.com - in transit`

   This condition can occur if the Synchronet SendMail thread is terminated unexpectedly while in the process of attempting the delivery an outbound e-mail message. The 'in transit' flag is used to protect multiple instances of the SendMail thread from attempting to deliver the same e-mail message simultaneously.

   If you only have one instance of the Synchronet SendMail thread active (the usual scenario), you can eliminate this problem by adding `SEND_INTRANSIT` to the `Options` value in the `[Mail]` section of your `ctrl/sbbs.ini` file. Or you can remove the 'in transit' flags from all existing e-mail messages by running the `fixsmb` utility on your `data/mail` database or by running the `exec/notransit.js` script.

In general, you need to check your Synchronet Mail Server window/log output for details about why Internet e-mail delivery attempts may be failing.

Question:
Why can't my BBS receive Internet e-mail or inter-BBS instant messages?

Answer:
You must have the Synchronet SMTP (mail) server running and listening for incoming connections on TCP port 25 (the standard SMTP port). You (or a friend) can test this basic connectivity by attempting to Telnet to port 25 (instead of port 23) at your BBS's hostname or public IP address from a remote location on the Internet. The remote Telnet client should see a successful connection and a text message similar to the following:

`220 bbs.synchro.net Synchronet SMTP Server 1.362-Win32 Ready`

You should also see evidence of the successful SMTP connection to the server in your Synchronet Mail Server window/log output. If you do not, then it's likely that your firewall or Internet Service Provider is blocking incoming connections to TCP port 25. Before concluding this is the case, verify that the remote Telnet client can connect to other SMTP servers first (e.g. vert.synchro.net, TCP port 25). If it cannot, then this remote client probably has restrictions on which (if any) connections he can make to TCP port 25. Try using a different, less restricted, remote Internet connection for your test.

If your firewall or Internet Service Provider is blocking incoming connections to TCP port 25 (many consumer-class ISPs do), then you won't be able to receive Internet e-mail on your BBS. Fixing your firewall configuration is rather simple, but changing ISPs is often not. One possible work-around is having a mail proxy (3rd party server) receive the e-mail for you and forward it to a non-standard, non-filtered/blocked SMTP port. Many Dynamic DNS services offer this service for a fee. Or a fellow sysop may be able and willing to perform this service for you as a favor.

Question:
Why can't users connect to my FTP server?

Answer:
You must have the Synchronet FTP server running and listening for incoming connections on TCP port 21 (the standard FTP port). See the previous answer about methods of testing this basic connectivity using a remote Telnet client.

If your FTP server window/log indicates an accepted FTP connection, then it's not a connectivity problem and probably a login failure.

FTP sessions require a login. If you have not created a Guest account for your BBS, then the FTP server will not allow Annonymous logins (most web browsers, for example, will attempt to login anonymously by default). If this is the problem, then either create a Guest account (preferably using the `exec/makeguest.js` module) or tell your FTP users that they must login with a valid BBS user account in order to use the FTP server.

Question:
Why do FTP clients lock-up or time-out when listing directories or downloading files from my FTP server?

Answer:
Your BBS computer is probably behind a Network Address Translator (NAT). NAT functionality is typically built into router/firewall devices. If your NAT device supports active and passive FTP servers "behind" the NAT, then you should have no problems. Unfortunately, this is not always the case: some cheaper consumer-level firewalls do not handle FTP server connections correctly or they do not support FTP servers listening on non-standard ports. Sometimes passive (PASV) transfers work fine, but active (PORT) transfers do not, or vice versa.

This document contains the technical details about how and why and the recommended solutions.

Note: Most web browsers (e.g. Microsoft Internet Explorer) use passive FTP transfer mode by default.

Note: Some FTP clients (e.g. the Windows command-line FTP client) only support active mode transfers.

Enabling the logging of FTP data channel activity can help diagnose these kinds of problems. This can be done by adding the `DEBUG_DATA` option to the `Options` value in the `[FTP]` section of your `ctrl/sbbs.ini` file or by checking the Data Channel Activity checkbox in the Log tab of the FTP Server Configuration dialog in the Synchronet Control Panel for Win32.

If you're having problems with passive transfers and you're seeing `!UNSUPPORTED COMMAND from username: 'P@SW'` in your FTP server log/window output, you're probably using an SMC Barricade router (see this document for details). Upgrade to Synchronet v3.13a (FTP Server Revision 1.296) or later to work-around this problem with this device.

If you're having problems with passive (PASV) transfers through your NAT/firewall device and you're running Synchronet v3.13a (FTP Server Revision 1.296) or later:

- If the remote client is attempting to connect to your private IP address (your NAT device isn't translating the PASV response from the FTP server) and you have a static public IP address, you can work-around this limitation of your NAT device by using the `PasvIpAddress` value in the `[FTP]` section of your `ctrl/sbbs.ini` file to specify your public IP address.

  This problem can be identified (on the client) by finding a comma-separated private IP address in the PASV response received from the FTP server (in response to a directory or file transfer request from the client).

  Example:

      # ftp yourbbs.synchro.net
      Connected to yourbbs.synchro.net (70.19.142.182).
      220 Please enter your user name.
      Name (yourbbs.synchro.net:root): anonymous
      331 User name okay, give your full e-mail address as password.
      Password:
      230 Guest logged in.
      ftp> passive
      Passive mode on.
      ftp> dir
      227 Entering Passive Mode (192,168,56,2,4,0) <--- IP address reported as 192.168.56.2 instead of 70.19.41.182

  Use an FTP client that supports passive mode and can display all the responses received-from the FTP server to help identify this particular problem. The FTP client must be running on a system outside your private network, so you may need a friend to assist you with this.

  If you have a dynamically-assigned IP address (via DHCP), then your IP address may change at some point, so setting the `PasvIpAddress` to a specific IP address may not be a long term solution for your FTP Server. In Synchronet v3.14a and later, you can enable the new Lookup Passive IP feature by checking the Lookup checkbox on the Passive tab of the FTP Server Configuration Dialog in SBBSCTRL-Win32, or by adding `LOOKUP_PASV_IP` to the `Options` value in the `[FTP]` section of your `ctrl/sbbs.ini` file. This option instructs the Synchronet FTP Server to perform a DNS hostname lookup on your BBS's public hostname and use the resulting IP address (which should be your BBS's public IP address) in passive responses.

- If your firewall cannot dynamically open/forward FTP PASV data ports for incoming passive FTP data connections, you can specifiy a limited range of TCP port numbers to use for passive transfers by modifying the `PasvPortLow` and `PasvPortHigh` values in the `[FTP]` section of your `ctrl/sbbs.ini` file. You will of course need to configure your firewall device to open/forward these ports to your FTP server.

Question:
Why do external programs that use socket I/O (e.g. Synchronet Blackjack, Synchronet BBS List, DoorMUD, SEXYZ) not work on my Windows BBS?

Answer:
Some "security" software (e.g. firewall and anti-virus programs) will interfere with the inheritance of socket descriptors between processes. One such program is the ZoneAlarm Security Suite. Another is NOD32. I don't know if this is an intentional security "feature" or a design flaw. If you have this (or similar) software installed, it may need to be disabled or completely un-installed for socket inheritance to work again.

Question:
Why do some or all of my servers get bind errors when starting or recycling?

Answer:
If you're getting bind errors when first starting up one or more Synchronet servers, similar to the following:

`0420 !ERROR 48 binding FTP Server socket to port 21`

this usually means you have another TCP/IP server on your system that is already bound to (and is presumably already listening for incoming connections on) this port. This could be a pre-existing instance of Synchronet or any other Telnet/Web/Mail/FTP servers that you may have installed on your system. You can use utilities such as netstat (for Windows or Unix) or TCPView (for Windows) to verify what programs (if any) have the TCP or UDP port in question already bound. If these utilities do not report any program is bound to (and listening) on this port, you can try Telnetting to the port in question and see if anything answers. If you're unable to connect to the port with a Telnet client and Synchronet cannot bind the port, your TCP/IP stack probably needs to be reset, so a system reboot may be in order.

If you're running a Unix-like operating system (not Windows) and get bind errors only when recycling servers, this is most likely because a TCP session is stuck in a TCP TIMEWAIT state (you can use netstat to verify this). The session will eventually time-out and close properly on its own, allowing the port to be re-bound at that time. To work-around this problem, you can either increase the `BindRetryCount` and/or `BindRetryDelay` values in your `ctrl/sbbs.ini` file, or you can add the following line to your `ctrl/sockopts.cfg` file:

`REUSEADDR 1`

Or, if running Synchronet v3.13b or later, your `ctrl/sockopts.ini` file:

`REUSEADDR=1`

Question:
How many nodes/clients/users can I support with my Internet connection?

Answer:
Depends on what those clients will be doing while connected. Here are some facts to consider:

1. A BBS node doesn't consume any bandwidth when not in use.

2. An active TCP session doesn't consume any appreciable bandwidth when idle.

3. Most Internet connections are asymmetrical in nature (as in ADSL).

   This means your upstream channel usually has less bandwidth than your downstream channel.
   When TCP/IP clients (users of your BBS's servers) download content from your servers (this includes viewing menus, reading messages, and playing door games on your BBS), they are primarily using your upstream channel.

   So if you have a 1.5Mbps/128Kbps DSL connection, your downstream is 1.5Mbps while your upstream is only 128Kbps. If you have a "56K" dial-up connection, for example, your downstream is probably in the 43-53Kbps range while your upstream bandwidth cannot be any more than 33.6Kbps (or 48Kbps for V.92 modems).

   If you are lucky enough to have an SDSL or other type of symmetrical Internet connection, then both your upstream and downstream channels are of the same bandwidth.

4. Most BBS traffic is bursty.

   With the exception of large file transfers, most BBS traffic is sent and received in small bursts. For example, the BBS user's TCP session is idle while the user is viewing menus, reading messages, pausing between keystrokes, etc. Many clients sending and receiving data in small intermittent bursts can be active simultaneously without any perceptible impact on one another.

5. Not all clients will be capable of saturating your upstream channel.

   If you have a 256Kbps upstream channel, for example, you could support four or five simultaneous "56K" clients all downloading files, and all getting 100% utilization of their respective downstream channels.

$Id: tcpip_faq.html,v 1.19 2007/08/13 07:13:37 rswindell Exp $