Virtual Advanced | Features | Download | Documentation | Support
How to configure Synchronet as the telnet front-end

Written By:
Lee Wilson
Moon Base Alpha BBS
Monarch423@msn.com

Note: This is merely the documentation. The complete help file can be downloaded here.

Introduction

This document provides information on how I setup Synchronet as my Telnet server for my BBS, Moon Base Alpha. This was based from the RENEGADE BBS version of this setup.

Advantages:
Far more stable setup and than using NetModem/32 and COM/IP. It will not crash on a daily basis. I have gone a couple of weeks without rebooting.

VADV nodes are only started up as needed, freeing system resources.

Disadvantages:
See Known issues.

Requirements

Synchronet v3.00c (later versions usually don't work right with VADV)
Virtual Advanced BBS Software v2.10
VADVSync package
A 300bps or greater modem on Channel 1

This document assumes you have working knowledge on the setup and operation of Virtual Advanced BBS Software (VADV)

Known Issues With This Setup - VADV

VADV is called as a door program under Synchronet in a DOS box per node. Synchronet will close the DOS session if the connection times out or the DOS session closes for any reason.

When a user is inside a door program (i.e. LORD) and in the event the door crashes or the user disconnects, and if the door program doesn’t close and return to VADV before Synchronet closes the DOS box, it prevents the return to VADV. VADV doesn’t get a chance to clear out the user in the CONTROL.DAT file. When another user connects to that node, they resume the previous users session in progress. This is Very Bad.

You can delete the CONTROL.DAT file when this happens, however if this is done while a user is in a door program and they exit it, they will find themselves at a login prompt. So I’ve attempted to minimize all of this by using flag files, additional setup in Synchronet, batch files, startup.v modification and a logoff.v script.

The logoff option in the QWK menu won’t log off the user, it takes them back to the main menu. Remove option from the VQWK.MNU file.

Since all VADV nodes are running only when a User connects to a node and node one handles all networking and event scheduling, it needs to be run separately outside of Synchronet and node one in Synchronet needs to be disabled. Otherwise networking tasks and events won’t run correctly.

Known Issues With This Setup - Synchronet v3.00c

Synchronet V3.00c aborts the shutdown process for Win95/98. Shutdown Synchronet before shutting down or rebooting your PC. If you have an automatic reboot event going, you may wish to try the next release of Synchronet, currently in BETA at the time of this writing.

There is a performance issue with multiple users. Synchronet loads its DOS box in windows foreground mode. If a second DOS box is created, the first is placed in background mode and the new DOS box gets placed in the foreground. So for example, if a user is on node 1 and another user connects to node 2, the new users DOS box gets placed in the foreground and the other user’s DOS box is placed in the background. The original user notices a very noticeable slowdown in performance and typing. The only way I’ve found is to lessen the impact is to go to Win98, which does multitasking better and throw faster hardware at it. The next version of Synchronet is supposed to be an improvement in this area.

Installation and Setup - Synchronet

Install Synchronet as a Typical Installation. Don’t install it into the same directory as VADV. The default directory is C:\SBBS. I will use this default reference in the rest of this doc. Substitute for your own if different.

Copy the enclosed BBS.BAT, BBSLO.BAT, LOGIN.SRC and LOGIN.BIN into your C:\SBBS\EXEC directory (over-writing the ones currently there)

Copy the enclosed BBS.BAT & BBSLO.BAT to the VADV BBS directory.

Startup Synchronet, if it asks where to find your MAIN.CNF file, tell its located in the C:\SBBS\CTRL

Synchronet should automatically open the Configuration Utility, if not it can be open from the menu, BBS, Configure.

By default Synchronet is configured for four telnet nodes, if you want more than that simply select NODES and then press the INSERT key. You will NOT need to mess with any of the node settings. I suggest adding at least one more as node one will not be used by Synchronet.

You may wish to change a few settings in SYSTEM as well. The BBS Name, BBS Location and Sysop (operator) can be set here. This is displayed in the connect messages. Leave the rest of the settings as is.

Moving on, go ahead and jump into the NETWORKS | QWK PACKET NETWORKS | NETWORK HUBS and press DELETE.

Move on down to MESSAGE AREAS and delete the DOVE-NET stuff sitting in there.

Now that you have that out of the way move on down to EXTERNAL PROGRAMS | ONLINE PROGRAMS go ahead and delete everything but MAIN.

Move on into MAIN and then cursor down to AVAILABLE ONLINE PROGRAMS, delete everything here as well and then Press your INSERT Key to add a new one. Synchronet will now prompt you for an "Online Program Name". Enter VADV and press enter. Synchronet will now prompt you for an "Internal Code" to which, you must use the value of VADV and press enter.

A new entry called VADV should now be in the list of Main Online Programs. Select it and press enter. Set it up as follows.

+[¦][?]---------------------------------------------------+
¦ VADV ¦
¦---------------------------------------------------------¦
¦ ¦Name VADV ¦
¦ ¦Internal Code VADV ¦
¦ ¦Start-up Directory V:\VADV ¦
¦ ¦Command Line bbs.bat %# /ac /b115200 ¦
¦ ¦Clean-up Command Line bbslo.bat %# ¦
¦ ¦Execution Cost None ¦
¦ ¦Access Requirements ¦
¦ ¦Execution Requirements ¦
¦ ¦Multiple Concurrent Users Yes ¦
¦ ¦Intercept I/O Interrupts No ¦
¦ ¦Swap BBS out of Memory No ¦
¦ ¦Modify User Data No ¦
¦ ¦Execute on Event No ¦
¦ ¦BBS Drop File Type None ¦
¦ ¦Place Drop File In Node Directory ¦
¦ ¦Time Options... ¦
+---------------------------------------------------------+

If your copy of VADV is not installed in V:\VADV you will need to adjust this to match your system.

Now, select TIME OPTIONS and change 'Suspended (Free) Time' to Yes.

Press Escape several times (Answering Yes) to "Do you wish to save your changes?" and finally Exit the Synchronet Configuration Utility (SCFG).

To Change the Telnet Server settings, Under the Synchronet Control Panel, click on the Telnet Tab, then configure button, the toothed wheel.

On the General Tab, Change the First Node to 2 and the Last Node to the highest number of nodes you have, like 5. Turn On Auto Startup. Hostname Lookup is optional. Do NOT click Minimized Externals. This causes a performance plenty for a single user. The rest of the tabs can be left as is. RLOGIN is not used for this setup.

On the Nodes Pane, right click on node 1 and select down node. This will take if offline and prevent channel one of VADV from being used.

Close the Synchronet BBS Control Panel, and then Start it up again (this is done so that your changes in SCFG will take effect). If you want, REBOOT.

Installation and Setup - VADV

Logoff Modifications

Modify logoff.v to suit your needs and drop it into the V directory.

Change all menus that have 1 logoffyn to 2 logoff.

Modify all your menu’s FB files and change the logoff option to this: G 001 2 logoff

This will call the logoff.v script instead of using the internal logoff mechanism.

Channels

Under the channels setup in Vconfig, I’ve left my settings intact from when I was on COM/IP. I am not sure if these are used when VADV is loaded as a door. But its probably good idea to set channels 2 and up to use a fossil driver. Use Fossil Device 4 for channel two, Fossil Device 5 for channel 3 and so on.

Setup your modem on channel one. The modem doesn’t need to be hooked up to a phone line. It just needs to be there for sending and responses. Otherwise the channel will hang and no net processing or events will occur. Do not use Netmodem/32 or Com/IP in place of a modem. It will conflict with Synchronet. A separate Fossil driver can be used on this port if needed.

START.V

Added the following lines to your start.v file. This creates a flag file for user crash detection.

LET A0 = "V:\VBBS\temp\n" % !12 % "\node." % !12
OPEN A0, "O"
WRITE A0
CLOSE

Files Used - BBS.BAT

This is called by Synchronet which starts a node of VADV. It also checks for the node flag file and if found replaces the control.dat with a fresh one. In this case its copying my empty one out of my BBS directory and putting in my RAM Drive, my working area. This is check is a redundancy for BBSLO.BAT should it fail.

if not exist v:\vbbs\temp\n%1\node.%1 goto bypass
copy v:\vbbs\data\control.dat w:\data
:bypass
CD \VBBS
bbs %1 %2 %3

Files Used - BBSLO.BAT

Synchronet calls this after the user session is closed. If it detects a user has bombed out, it basically starts VADV for that node and gives VADV a chance to clear the entry in CONTROL.DAT. VADV will close right away due to no user. This also resets the flags. Attempts to head off having to reset the control.dat file when a user logs in. This also prevents a user from getting a login prompt exiting a door after the control.dat file has been reset.

if not exist v:\vbbs\temp\n%1\node.%1 goto bypass
CD \VBBS
copy v:\vbbs\temp\n%1\node.%1 v:\vbbs\temp\n%1\node.A
delete v:\vbbs\temp\n%1\node.%
bbs.exe %1 /ac /b115200
:bypass

Files Used - LOGOFF.V

This script prompts the user the logoff question and deletes the flag file. You can add other things like messages or broadcast logoff notices.

GETYN R1, "You wish to Log Off?"
IF R1 = "n" GOTO hopback
LET K1 = "V:\vbbs\temp\n" % !12 % "\node." % !12
kill K1
logoff
hopback:

Some Other Items to Note

Synchronet comes with its own FTP and email server. The FTP server is tied into Synchronet’s file section. It’s useless in this setup. The email server is not a multi-user drop system. It’s tied into Synchronet’s user file. It cannot be used with the VISK program, except for sending out to the Internet. It can be used on its own.

The LOGIN.SRC is Synchronet source code file written in its own BAJA script language. Documentation is provided with Synchronet to work with the language. A compiler is provided which creates the .BIN files that Synchronet executes. The login.src that I provided was modified from the original RENEGADE version I obtained.

Synchronet’s Connection Messages can be change to suit your needs. Some Sysops like to remove it entirely to hide Synchronet’s visibility to the user. This is setup in a file. To access it, from Synchronet Control Panel Menu, BBS | Edit | Answer Screen. See the help on what all this means and how to change the content, colors, etc.

If all the Synchronet nodes are in use a message will display to the user saying all nodes are busy. You can down all nodes to work on the BBS if desired by right clicking on each node in the nodes tab in the Control Panel and selecting Down Node. Right click down node again to restart them.

You Can Help!
If you find these programs useful, you can show your support by donating - even a small amount. To help out, click the PayPal button below.

Home : News : Products : Downloads : Community : VirtualNET : Development : Support : About : Contact : Bug Reporting