home *** CD-ROM | disk | FTP | other *** search
- Answers to frequently asked questions re: configuring Synchronet Version 3
- by Rob Swindell (digital man), May 2000, last updated June 2003
-
- $Id: v3cfgfaq.txt,v 1.4 2003/06/12 02:16:26 rswindell Exp $
-
- Q: I want to create custom menus. Is there any detailed documentation or
- samples regarding custom menus on Synchronet?
- A: Yes, see http://synchro.net/docs/customization.html,
- http://synchro.net/docs/baja.html and http://synchro.net/docs/js.html
- for details.
-
- Q: I seem to missing the menu files for non-default (Synchronet Classic)
- command shells on v3.10L-win32.
- A: These files were accidentally excluded from the v3.10L-win32 install.
- Download ftp://vert.synchro.net/Synchronet/menu.zip and extract (with
- directories) into your Synchronet text/menu directory.
-
- Q: How do I get on the Synchronet BBS List, http://synchro.net/sbbslist.html?
- A: The best way is to first join DOVE-Net, then run the Synchronet BBS List
- (SBL) door on *your* BBS and add an entry for your BBS. This entry should
- be automatically exported to the DOVE-Net SYNCDATA echo which will then be
- propogated to Vertrauen and every other BBS on DOVE-Net. The sbbslist.html
- page is automatically generated on Vertrauen every night at midnight
- (Pacific time), so wait a day or so for your entry to appear on the list.
- If it doesn't appear, verify that that your BBS entry was properly
- exported (as a message) to the SYNCDATA message area. The events that run
- SMB2SBL and SBL2SMB to import and export BBS entries should be configured
- by default. If they are not, see xtrn/sbl/sbl.doc for more details.
-
- Q: How do I get my BBS listed in the Instant-Message capable BBS list
- (ftp://ftp.synchro.net/sbbsimsg.lst)?
- A: First get your BBS on the Synchronet BBS List (sbbslist.html), and if your
- BBS is running the Synchronet SMTP server on port 25 (like it should) and
- the Synchronet Finger Service on TCP and UDP port 79, your BBS should
- automatically appear on the instant message list. If it is not, then
- verify that your SMTP and Finger services can be reached remotely (the
- ports aren't being blocked by a firewall or your ISP). This list
- is generated nightly on Vertrauen at the same time as the Synchronet BBS
- List, http://synchro.net/sbbslist.html.
- See docs/imsgdocs.txt for more details.
-
- Q: How do I join DOVE-Net?
- A: If you've installed v3.10, Telnet to vert.synchro.net and create a new
- account for your QWKnet transfers (using your system's QWK-ID for the user
- name), then edit your "Call-out Command Line" in SCFG->Networks->QWK->Hubs
- ->VERT: replace "YOURPASS" with the password you used when creating your
- QWKnet user account. Do NOT change anything else in the command-line!
- That's it! For more details, see docs/dove-net.txt.
-
- Q: What is my system's QWK-ID?
- A: This is normally an abbreviation of your BBS's name that YOU determine
- and configure in SBBSCTRL:BBS->Configure->Message Options. You may want to
- look at NODES.DAT in DOVE-NET.ZIP for any conflicts with other DOVE-Net
- systems' QWK-IDs.
-
- Q: How do I get my FTP server to work behind my firewall/NAT/router?
- A: See http://www.ncftpd.com/ncftpd/doc/misc/ftp_and_firewalls.html for
- details.
-
- Q: How do I disable the New User Feedback requirement?
- A: In sbbs v3.10-win32, run the Configuration Wizard and un-check the
- "Require new user feedback" checkbox. Otherwise, set SCFG->Nodes->Node 1
- ->Advanced Options->Validation User to "0".
-
- Q: What is the "!QWKTOMSG failed" or "Duplicate message" warnings in my
- Telnet/Event log while importing DOVE-Net QWK packets into my message
- areas?
- A: This warning indicates a duplicate message in your QWK packet was detected.
- Duplicate messages in the SYNCDATA echo are normal and you can disable the
- duplicate message checking for that echo in SBBSCTRL:Configure->Message
- Areas->DOVE-Net->SYNCDATA and the warnings should go away.
-
- Q: How do I join/setup a FidoNet Technology Network (FTN)?
- A: Use SBBSecho (included with Synchronet) to toss (export) and scan (import)
- your FidoNet bundles, packets, and NetMail (see
- http://synchro.net/docs/sbbsecho.html for details).
-
- You will also need a TCP/IP FTN transport program like Binkd, Internet Rex,
- Argus, Beemail, etc. Traditional Front-End Mailers (FrontDoor, InterMail,
- D'bridge, BinkleyTerm, etc) are NOT normally used for TCP/IP-based FTN
- transfers.
- See http://www.net229.ca/fidosetup/ for instructions on setting up
- Synchronet with the Argus 32-bit FidoNet mailer.
- I, personally, use Binkd for Win32, which you can find available for
- download on my BBS and the docs (what little there are) online.
-
- Q: Does anyone know of a good, stable newsgroup door I can download or buy?
- I would LOVE to have newsgroups on my board.
- A: I don't know of any doors, but I do know of several newsgroup<->fido
- gateway packages: newsgate, gigo, internet rex, and many others.
- A: You can also try MerlinSystem's NetXpress Usenet Gateway for Synchronet
- (nx-sync, it's free): http://www.binaryh.com/merlinsys/
- A: Synchronet v3.10 comes with NewsLink, an external JavaScript module for
- importing and exporting messages via NNTP (Network News Transfer Protocol).
- Just edit your ctrl/newslink.cfg file to get started.
-
- Q: How do I keep external programs (doors) from popping up windows and
- stealing the keyboard/mouse focus?
- A: Check SBBSCTRL:Telnet->Configure->Minimize Externals.
-
- Q: How do I set additional nodes for telnet access?
- A: Create the additional nodes in SBBSCTRL:BBS->Configure->Nodes if you
- haven't already done so (Version 3 uses the same configuration information
- from the first telnet node for all telnet nodes and the COM port/modem
- configuration information is ignored). Set SBBSCTRL:Telnet->Config->Last
- Node to highest node number you want available for telnet logins.
-
- Q: How do I add files to the file database?
- A: The easiest way is to use the ADDFILES utility which can automatically
- detect and import embedded descriptions (e.g. FILE_ID.DIZ). See the
- chapter in the sysop manual on "Adding files" and the ADDFILES utility
- chapter for details. No, a files.bbs list is not necessary for adding
- files. Use "ADDFILES * /DIZ" to search all directories for a new files.bbs,
- import any embedded descriptions (e.g. FILE_ID.DIZ), and delete the file.bbs
- after importing it. If you don't have a file list (e.g. files.bbs) to import
- just use "ADDFILES * /SZN" to search all directories for new files and use
- embedded (FILE_ID.DIZ) description files, if they exist.
-
- Q: Long filename support doesn't seem to fully functional.
- A: Support for files with long filenames (greater than the MS-DOS 8.3 format)
- is a work in the progress. There are two main issues:
- A: The current file database format only supports 8.3 filenames.
- B: The only X/Y/Zmodem file transfer program that currently works with
- Synchronet-Win32 is FDSZ, which is a 16-bit DOS programs (which therefore
- only supports 8.3 format filenames).
- Synchronet v3.10 will display long filenames, but the files must be added to
- the database using a means other than X/Y/Zmodem (at this time).
- The file database format is being replaced in v3.20 and will store long
- filenames as well as many other improvements.
- There is work being done to create a good 32-bit Winsock alternative to FDSZ
- that will support long filenames as well as consume less resources.
-
- Q: How do I enable forced upload/download ratios.
- A: By default, Synchronet utilizes a "credit" system, where a user typically
- earns credits by uploading files, posting messages, playing online games,
- etc. And downloading files requires a number of credits based on the size
- of the file.
-
- If you prefer to use a less flexible upload/download "ratio" system, you
- can do so by using the UDR (upload/download byte ratio) or UDFR
- (upload/download file ratio) ARS keywords in the Download Requirements of
- your file areas. These ARS keywords, like the PCR (post/call ratio) keyword
- use a specified minimum "percentage". So if you wish to enforce a 1:3
- upload/download ratio, then use "UDFR 33" for 33%, 3:4 ratio would be
- "UDFR 75" for 75%, 1:2 would be "UDFR 50" for 50%, etc.
- See http://synchro.net/docs/security.html for details on using ARS.
-
- Q: How do I allow users to send Internet e-mail from the BBS?
- A: See http://synchro.net/docs/message_section.html for details.
-
- Q: How do I disallow connections from specific host names or IP addresses
- (or ranges).
- A: Add the disallowed host names to your text/host.can file or IP addresses
- to your text/ip.can file. To disallow a range of IP addresses, use the ^
- wildcard character (e.g. "192.168.10.^"). To disallow a partial string in a
- host name, use the ~ wildcard character (e.g. "mofoisp.com~").
- As for v3.10, you can use the familiar '*' wildcard character
- (e.g. "*.aol.com" and "192.168.*").
-
- Q: When I run SBBSCTRL it asks me for the path to MAIN.CNF, but I don't have
- this file.
- A: You've installed the v3 upgrade without installing v2.3 first. Install
- Synchronet v2.3 (SBBS230?.ZIP) first, then apply the upgrade.
-
- Q: My CPU/kernel-utilization meter reports 100% when a user is online and
- entering a string/line of text.
- A: Set SBBSCTRL:BBS->Configure->Nodes->Node X->Toggle Options->Low Priority
- string input to "Yes" (where X is your first telnet node).
-
- Q: How do I allow anonymous logins to the Synchronet FTP Server?
- A: You need to create a Guest account on your BBS. Create a new user (login
- as "New" or use the User Editor included with v3.00b) with a user name of
- "Guest". Give this user the 'G' exemption and the 'G' restriction and
- delete the password for the account. You may also want to give the Guest
- account additional exemptions (e.g. L, P, T, etc).
-
- Q: How can I get door X to work?
- A: If the door wasn't specifically written to run on Synchronet (XSDK) or
- WWIV BBS Software (typically using CHAIN.TXT), then it must support FOSSIL
- communications (most popular doors support FOSSIL) and the door must be
- configured to use a FOSSIL driver (yes, you'll need to read the door's
- documentation files).
- The Synchronet FOSSIL driver is automatically configured and loaded when
- needed and ignores the COM port information used by doors, so configuration
- details such as COM port number and baud rate are irrelevant (you can just
- leave them set to their default values if the door configuration program
- allows them to be changed, or use COM1/38400 if it makes you happy).
-
- Q: How can I get this FOSSIL door to work?
- A: Make sure you have "Intercept I/O Interrupts" set to "No" for all FOSSIL
- doors in SBBSCTRL:BBS->Configure->External Programs->Online Programs
- (this includes Synchronet Match Maker v2.x).
- Make sure you have the appropriate startup directory, command line, and
- drop file options set in SCFG. See SBBSDOOR.TXT for specific instructions
- on setting up some popular door games (i.e. LORD, BRE, GlobalWar, TW2002).
- Make sure you DO NOT have any FOSSIL drivers loaded (including X00, BNU,
- ADF, COM/IP, WinFOSSIL, or NetModem) as they will conflict with
- Synchronet's FOSSIL driver.
- Make sure the door supports FOSSIL communications (read the door's docs)
- and that the door is configured to use a FOSSIL driver. Synchronet's
- FOSSIL driver is automatically configured and loaded when needed - there
- is nothing you need to do to install or load the Synchronet FOSSIL driver.
-
- Q: SyncEdit isn't working correctly.
- A: See the file SYEDTFAQ.TXT for details.
-
- Q: When I read messages on my v2.3c (or earlier) nodes, I sometimes get a
- garbled Message Attributes line.
- A: Synchronet v3 introduced a new message attribute (REPLIED) and this
- attribute is not currently supported in v2.3c. To work around this problem,
- remove one of the %s's from the MsgAttr line of your CTRL\TEXT.DAT file.
- I plan on releasing a v2.3d with this fix (and others) in the future).
-
- Q: I have Scroll-Lock on, but I'm still not available for chat page.
- A: Synchronet version 3 no longer uses Scroll-Lock to indicate sysop
- availability. Instead, there is a button on the SBBSCTRL tool bar and on
- the BBS menu to toggle the sysop availability for chat (added in v3.00b).
-
- Q: Is there any updated documentation for Synchronet v3?
- Q: The documentation I have (sysop.doc) appears to be for v2.3 for DOS/OS2?
- Q: Do you have documentation that is easier for me to view/print/etc?
- A: Yes, the documentation included in Synchronet v3.00b was the same old
- SYSOP.DOC (ASCII text file) created for Synchronet for DOS and OS/2 v2.30.
- It was reformatted in HTML and updated for version 3.00c (as of
- December 2000). You can view the progress of the Synchronet Documentation
- project at: http://synchro.net/docs. Contributors are welcome!
- The Synchronet HTML docs have been converted to PDF for your
- viewing/printing pleasure and can be downloaded @ vert.synchro.net.
-
- *** OLD (ver 3.0) ANSWERS TO FREQUENTLY ASKED QUESTIONS ***
-
- Q: The SBBSCTRL:BBS->Login menu option isn't working for me.
- A: The default local login command in v3.00 ("start telnet://localhost") does
- not work on NT-based OSes (including Win2K and WinXP). If you're running
- v3.00, run REGEDIT and go into
- HKEY_CURRENT_USER\Software\Swindell\Synchronet Control Panel
- and change "LoginCommand" to "telnet localhost" or "mtel localhost" or
- whatever your favorite telnet client is.
-
- If you're running v3.10e or later, then the "start telnet://localhost"
- command line should work (start up your registered telnet client).
-
- Q: The SBBSCTRL:BBS->Configure menu option isn't working for me.
- A: SCFG and SCFG32 are console-mode programs that only work in an 80x25
- console window. If you're seeing the message "USCRN failed!" that means
- you probably have your default console window set to a dimensions larger
- than 80x25.
-
- You can fix this on Windows NT/2K/XP by adjusting the properties of your
- System32\command.pif file. Make sure "restore settings at startup"
- (under the "Screen" tab) is not checked. Also, make sure the screen buffer
- size is no larger than the screen window size (80x25).
-
- Q: How come some of the times diplayed are off by exactly one hour?
- A: In v3.10, try setting SCFG->System->Toggle Options->Use Local/System Time
- Zone to "Yes". That *should* fix the problem.
- A: There is a time-zone bug in the Microsoft Visual C++ run-time library I'm
- using in Synchronet v3 related to day-light savings time. Those of you
- using v3 in a timezone which has daylight savings, may see a different time
- in the BBS (ctrl-T for example) than you do in SBBSCTRL or your system tray.
-
- You can fix the problem by removing Windows' knowledge of daylight savings
- altogether (which I think is a dumb idea to begin with). You need to run
- TZEDIT which is included on the Win98 CD in the tools\reskit\config
- directory. It's included with Win95 OSR2 in the Admin\Apptools\Tzedit
- directory. Anyway, run tzedit, select your time-zone from the list (it
- should already be selected), click the "Edit" button, and UN-CHECK the
- "Automatically set Daylight Savings Time" check box. Then clck OK, then
- click CLOSE.
-
- Now, you need to RE-SELECT the time-zone by double-clicking the time in your
- system-tray (lower right corner) or by re-selecting the time zone in the
- control panel. Now when you run Synchronet and user logs on (for example),
- the times should all be correct.
-
- Q: I get an error message that contains "file: c:\src\sbbs3\etc" or something
- similar but I do not have Synchronet installed on drive C or that path does
- not exist?
- A: The "Source" or "File" portion of the error message is for the author's
- reference only and has nothing to do with your Synchronet configuration. The
- file path in question was the original source code file where the error
- occured, which you do not need to concern yourself with (unless you are
- modifying the source code). Send the ENTIRE error message (as shown in your
- data/error.log file) to the author if you still have any questions or
- concerns that aren't answered here or in the sysop documentation.
-
- Q: My long filenames aren't appearing correctly on the BBS?
- A: The Synchronet file database currently only supports the DOS 8.3 naming
- format. Longer filenames will be shown in their Micros~1 mangled form.
- The Synchronet FTP server does automatically detect and display long
- filenames, however. Long filenames will be supported in the BBS/Telnet
- server in a future release (v3.10).
-
- Q: File transfers (DSZ) aren't working.
- A: You need to use FDSZ (FOSSIL version of DSZ) in place of DSZ:
- 1. Verify you have FDSZ.EXE in your Synchronet EXEC directory.
- 2. Change the command lines in SBBSCTRL:BBS->Configure->File Options->
- Transfer Protocols from "%!dsz ..." to "%!fdsz ...".
- A: If you're using an NT-based OS (including Win2K and WinXP), you'll need
- to upgrade to v3.10e or later to get the fix for Zmodem transfers.
-
- Q: Why do I get an SBBS.DLL error about missing GetDiskFreeSpaceEx?
- A: You're attempting to run Synchronet v3.0 on pre-OSR2 Windows 95 or Windows
- NT 3.x. Support for pre-OSR2 Windows 95 was added in Synchronet v3.00c.
- See http://www.synchro.net/platforms.html for a matrix of supported
- platforms.
-
- Q: Can I run version 3 under Windows NT4/2000?
- A: The first beta release (v3.00a) did not include a FOSSIL/DOS interrupt
- driver for NT/2000, so only Windows 95/98 was fully supported. Version
- 3.00b includes a FOSSIL/DOS interrupt driver for NT4/2000. If running under
- NT4/2000, see NTREADME.TXT for configuration details.
-
- Q: How do I get Synchronet to create a DOOR32.SYS drop file?
- A: In v3.10, you just select "Door32.sys" from the drop file list.
-
- Q: How do I tell Synchronet that a program is 32-bit?
- A: Add the program's base filename to SBBSCTRL:BBS->Configure->External
- Programs->OS/2 Program List (this is actually the native 32-bit program
- list). If you specified the executable file extension (e.g. ".exe") on
- the program's command-line, then you'll also need to include the
- filename with the extension in the 32-bit Program List.
- In v3.10, you just set "Native Executable" to "Yes".
-
- Q: What is SCFG?
- A: The Synchronet Configuration Utility (exec/scfg.exe). This 16-bit
- console/text-mode program is left-over from Synchronet v2 and is still used
- (as of v3.0) to configure many of the aspects of Synchronet v3
- (SBBSCTRL:BBS->Configure). See http://synchro.net/docs/system_config.html
- for details.
-
- There is also a 32-bit version of SCFG, SCFG32.EXE, that should be used in
- place of SCFG.EXE when more than a few hundred kilobytes of memory are
- required for configuration information (typically, for large numbers
- of message areas).
-
- You can change the program and command-line used with the
- SBBSCTRL:BBS->Configure menu option: in v3.00, run REGEDIT, and change
- HKEY_CURRENT_USER\Software\Swindell\Synchronet Control Panel\ConfigCommand
- or in v3.10, go to SBBSCTRL:File->Properties. Change the string to
- "%sSCFG32 %s" (removing the "/t2") to utilize the 32-bit version of SCFG.
-
- You can run SCFG/SCFG32 from the command-line by specifying the path to your
- Synchronet CTRL directory as the first parameter
- (e.g. "c:\sbbs\exec\scfg32 c:\sbbs\ctrl"). When running the 16-bit version of
- SCFG under Windows, it is highly recommended to use the "/t2" command-line
- switch to yield Windows time-slices.
-
- SCFG and SCFG32 only work in 80x25 text windows (on Win32-based OSes).
- SCFG will fail with a "USCRN failed!" error message when run in a non-80x25
- window.
-
- ** UPDATE **
- SCFG.EXE v3.10 (included with Synchronet v3.10g and later) is 32-bit;
- there is no more SCFG32.EXE (you can safely delete this file). Also, SCFG.EXE
- is no longer limited to 80x25 text windows.
-
- If you find SCFG is running in a Window where not all of the application is
- visible, add "-l25" to your SCFG command-line to force it to 25-line mode.
-
- As always, see the documentation if you have any questions that aren't
- answered here: http://synchro.net/docs
-
- /* End of V3CFGFAQ.TXT */
-