NNTPSwitch 0.11
This are last-minute notes on the NNTPSwitch-0.11 release. For the full manual see http://www.nntpswitch.com/manual/
For full pleasure run nntpswitch on linux. FreeBSD is reported to work, but also reported to be buggy in some configurations. Solaris should also work if you leave out some features. Try it and you know it.
Installing NNTPSwitch.
You should have Perl installed in your $PATH.
make
make install
"make" calls "make config" automatically. make config parses the nntpswitch.conf.in file and uses the values as defaults.
Optionally make some authentication modules.
make radius
make mysql
make ldap
Plenty more options available, refer to the manual for details.
Create a directory /etc/nntpswitch or /usr/local/etc/nntpswitch (or whatever else is specified in config.c) and copy nntpswitch.conf, etc/access.conf etc/servers.conf and etc/overview.fmt to your /etc/nntpswitch directory. Optionally copy etc/init.d to /etc/init.d/nntpswitch.
Edit all configs to match your configuration.
You can test your config using the command:
nntpswitchd -t
If it works and it is your first try of running nntpswitch you should generate an nntpswitch compatible active file. You can do so with the command:
updategroups
Finally run nntpswitchd without options to start it.
Upgrade Notes
If you're upgrading 0.10 to 0.11 you have to create a new configuration. Both auth.conf and profiles.conf are now integrated into access.conf. Basically prefix your old configlines with new ones. Prefix "acl" for your acl lines and prefix "auth" for your auth matches.
When combining old configurations make sure things are defined before you use them. I.e. define your wildmat entries before using them in a profile, and define the profile before assiging them to an acl.
Also when upgrading, make sure to remove the profile PathHeader and MessageIdDomain and replace them with just Hostname.
Older versions
If you're upgrading from any pre-0.10 release like 0.09, you should generate a complete new configuration. The old groups.conf and updategroups.pl is not supported anymore. You should use the new style servers.conf and updategroups.
For access, just the access.conf is not enough. You should create a profiles.conf, an auth.conf and an access.conf.
Also notice that all authentication configuration is done using aliases from profiles.conf. Each authentication or accounting module can have different configuration by itself. Check the manual for a brief list of each module's possible arguments.