Update usenet.md
This commit is contained in:
deepend-tildeclub
GitHub
parent
3dbc2a18da
commit
553b2cb8b6
141
docs/usenet.md
141
docs/usenet.md
|
|
@ -2,73 +2,54 @@
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
Create Linux machine
|
Create Linux machine (This is based on Fedora 32)
|
||||||
|
|
||||||
$ sudo -i
|
$ sudo -i
|
||||||
root # yum update
|
root $ dnf update
|
||||||
|
|
||||||
|
|
||||||
root # yum install gcc
|
root $ dnf install innd
|
||||||
root # yum install cpan
|
|
||||||
root # yum install python-devel
|
|
||||||
|
|
||||||
root # Get the Mime parser (for controlchan [idk wtf that is])
|
root $ vim /etc/hostname # set your hostname to something like `news`
|
||||||
root # cpan -f install Mime::Parser
|
root $ vim /etc/hosts # change local.localdomain to the new hostname
|
||||||
|
|
||||||
root # wget ftp://ftp.isc.org/isc/inn/inn-2.5.4.tar.gz
|
|
||||||
root # tar xvf inn-2.5.4.tar.gz
|
|
||||||
root # cd inn-2.5.4
|
|
||||||
|
|
||||||
root # groupadd news
|
|
||||||
root # useradd -g news -d /usr/local/news news
|
|
||||||
|
|
||||||
root # ./configure \
|
|
||||||
--with-python \
|
|
||||||
--enable-libtool \
|
|
||||||
--with-gnu-ld \
|
|
||||||
--with-sendmail=/usr/sbin/sendmail \
|
|
||||||
--enable-tagged-hash \
|
|
||||||
--enable-shared \
|
|
||||||
LIBS="-lpthread"
|
|
||||||
|
|
||||||
root # vim /etc/hostname # set your hostname to something like `news`
|
|
||||||
root # vim /etc/hosts # change local.localdomain to the new hostname
|
|
||||||
|
|
||||||
# should probably restart the machine to get the new hostname
|
# should probably restart the machine to get the new hostname
|
||||||
|
|
||||||
root # su - news
|
root $ sudo -u news bash
|
||||||
news $ vim etc/inn.conf
|
news $ vim etc/inn.conf
|
||||||
|
|
||||||
The top of my `inn.conf` looks like:
|
The top of my `inn.conf` looks like:
|
||||||
|
|
||||||
|
mta: "/usr/sbin/sendmail -oi -oem %s"
|
||||||
|
organization: "tilde.club"
|
||||||
|
ovmethod: tradindexed
|
||||||
|
hismethod: hisv6
|
||||||
|
pathhost: news.tilde.club
|
||||||
|
pathnews: /usr/local/news
|
||||||
|
|
||||||
mta: "/usr/sbin/sendmail -oi -oem %s"
|
#runasuser:
|
||||||
organization: "tilde.club"
|
#runasgroup:
|
||||||
ovmethod: tradindexed
|
|
||||||
hismethod: hisv6
|
|
||||||
pathhost: news
|
|
||||||
pathnews: /usr/local/news
|
|
||||||
|
|
||||||
#runasuser: # default: news
|
# General Settings
|
||||||
#runasgroup: # default: news
|
|
||||||
|
|
||||||
# General Settings
|
domain: news.tilde.club
|
||||||
|
#innflags:
|
||||||
domain: news.tilde.club
|
mailcmd: /usr/libexec/news/innmail
|
||||||
#innflags:
|
server: news.tilde.club
|
||||||
mailcmd: /usr/local/news/bin/innmail
|
#syntaxchecks: [ no-laxmid ]
|
||||||
#server:
|
|
||||||
|
|
||||||
|
|
||||||
Then you need to configure `readers.conf` to say who can connect, how, and what
|
Then you need to configure `readers.conf` to say who can connect, how, and what
|
||||||
kind of things they get when they log in.
|
kind of things they get when they log in.
|
||||||
|
|
||||||
news $ mv etc/readers.conf etc/readers.conf.old
|
news $ mv /etc/news/readers.conf /etc/news/readers.conf.old
|
||||||
news $ vim etc/readers.conf
|
news $ vim /etc/readers.conf
|
||||||
|
|
||||||
A rudimentary `readers.conf` looks like:
|
A rudimentary `readers.conf` looks like:
|
||||||
|
|
||||||
# as this machine will only listen to connections from the tilde.club server, I don't mind having
|
# Since tilde.club is very open and inviting, I don't mind having
|
||||||
# such a wild rule.
|
# such a wild rule.
|
||||||
|
|
||||||
auth tilde.club {
|
auth tilde.club {
|
||||||
hosts: *
|
hosts: *
|
||||||
default: <PUBLIC>
|
default: <PUBLIC>
|
||||||
|
|
@ -86,27 +67,73 @@ A rudimentary `readers.conf` looks like:
|
||||||
perlfilter: false
|
perlfilter: false
|
||||||
}
|
}
|
||||||
|
|
||||||
Ensure that all the history files have the right permissions:
|
And finally set up the cron job to expire messages. Make sure you add this as
|
||||||
|
the `news` user cron:
|
||||||
|
|
||||||
news $ chmod 644 ~/db/*
|
SHELL=/bin/sh
|
||||||
|
MAILTO=root
|
||||||
|
#=========================================================================
|
||||||
|
# INN crontab:
|
||||||
|
#=========================================================================
|
||||||
|
#
|
||||||
|
# Run news.daily every morning at 6am
|
||||||
|
#
|
||||||
|
0 6 * * * /usr/libexec/news/news.daily > dev/null
|
||||||
|
|
||||||
And finally set up the cron job to expire messages. Make sure you run this as
|
|
||||||
the `news` user:
|
|
||||||
|
|
||||||
0 3 * * * ~/bin/news.daily expireover lowmark
|
|
||||||
|
|
||||||
## Running the server
|
## Running the server
|
||||||
|
|
||||||
There are some scripts in the `contrib` which will help you get started, namely
|
This can be accomplished via systemd.
|
||||||
`sample.init.script`. I think it goes into `/etc/init.d`, though I might be
|
|
||||||
mistaken. Another option is a long-running tmux session. Either way, the
|
|
||||||
following runs the server:
|
|
||||||
|
|
||||||
news $ bin/rc.news start
|
Here is how to enable it to start automatically:
|
||||||
|
|
||||||
|
root $ systemctl enable innd
|
||||||
|
|
||||||
|
The following runs the server:
|
||||||
|
|
||||||
|
root $ systemctl start innd
|
||||||
|
|
||||||
And the following stops it:
|
And the following stops it:
|
||||||
|
|
||||||
news $ bin/rc.news stop
|
root $ systemctl stop innd
|
||||||
|
|
||||||
All errors are logged to `~/log/`. `~/log/errlog` is a good resource for finding
|
All errors are logged to `/var/log/news`. `/var/log/errlog` is a good resource for finding
|
||||||
out why your news server isn't running.
|
out why your news server isn't running.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## Troubleshooting the server
|
||||||
|
|
||||||
|
If you know there are articles on the server and for some reason they do not show when you connect with a client, you can rebuild your history and index's.
|
||||||
|
|
||||||
|
root $ systemctl stop innd
|
||||||
|
|
||||||
|
root $ sudo -u news bash
|
||||||
|
|
||||||
|
news $ cd /var/lib/news/
|
||||||
|
|
||||||
|
news $ time /usr/libexec/news/makehistory -b -O -f history.n
|
||||||
|
|
||||||
|
news $ awk 'NF == 2 { print }' < history >> history.n
|
||||||
|
|
||||||
|
news $ /usr/libexec/news/makedbz -s `wc -l < history` -f history.n
|
||||||
|
|
||||||
|
news $ mv history.n history
|
||||||
|
|
||||||
|
news $ mv history.n.dir history.dir
|
||||||
|
|
||||||
|
news $ mv history.n.hash history.hash
|
||||||
|
|
||||||
|
news $ mv history.n.index history.index
|
||||||
|
|
||||||
|
news $ exit
|
||||||
|
|
||||||
|
root $ systemctl innd start
|
||||||
|
|
||||||
|
root $ sudo -u news /usr/libexec/news/ctlinnd renumber ''
|
||||||
|
|
||||||
|
Above guide was copied/modified from: https://lists.isc.org/pipermail/inn-workers/2003-September/012007.html
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue