## Requirements

[perl](/openhttpd/perl) needs to be configured for httpd.

## Installation

    $ ftp http://www.dgate.org/webnews/tars/webnews-1.3.1.tar.gz
    $ doas mv webnews /var/www/htdocs/
    $ doas chown -R www:daemon /var/www/htdocs/webnews


As normal user:

    $ cpan
    ...
    What approach do you want?  (Choose 'local::lib', 'sudo' or 'manual')
     [local::lib] 
    ...
    cpan[1]> install News::NNTPClient
    cpan[2]> install News::Newsrc
    cpan[3]> install Set::IntSpan
    cpan[4]> install Text::Wrap
    cpan[5]> install HTTP::Date
    cpan[6]> install MIME::QuotedPrint
    cpan[7]> install MIME::Base64


Then we need to copy the perl libraries:

    $ doas mkdir -p /var/www/usr/local/libdata/
    $ doas cp -R /usr/local/libdata/perl5 /var/www/usr/local/libdata/


We need to change two lines in /var/www/htdocs/webnews/webnews.cgi:

    BEGIN { $CONFFILE = '/htdocs/webnews/webnews.conf'; }
    BEGIN { $INSTALLDIR = '/htdocs/webnews'; }


Next we set up the conf file:

    $ doas cp /var/www/htdocs/webnews/webnews.conf.example /var/www/htdocs/webnews/webnews.conf


Then make a few changes to /var/www/htdocs/webnews/webnews.conf:

    $SERVER = 'example.org';
    $WNDIR = '/htdocs/webnews';
    $BASEURL = '/';


## Troubleshooting

    News::NNTPClient: Bad hostname: news.oddprotocol.cf at  /htdocs/news/webnews.cgi line 119. News::NNTPClient:News::NNTPClient::SOCK1 has been closed at /htdocs/news/webnews.cgi line 147. News::NNTPClient: News::NNTPClient::SOCK1 has been closed at /htdocs/news/webnews.cgi line 169. Bad arg length for Socket::pack_sockaddr_in, length is 0, should be 4 at /usr/local/libdata/perl5/site_perl/News/NNTPClient.pm line 102. News::NNTPClient unexpected EOF on News::NNTPClient::SOCK1 at /htdocs/news/webnews.cgi line 0.


solution is to create `/var/www/etc/resolv.conf`