pd.if.org Git - newsd/blob - INSTALL

   1 Install Instructions
   2
   3 The server depends on the following non-core Perl modules:
   4
   5 Net::Server
   6 Date::Calc
   7
   8 It also depends on the provided Net::Server::NNTP module,
   9 and a storage module which subclasses Net::Server::NNTP.
  10 A postgres storage module, Net::Server::NNTP::Postgres
  11 is provided, and requires postgres to be installed and working,
  12 though it doesn't need to be a local install.  Only Postgres 9.1
  13 has been tested but it should currently work with at least 8.4.  I won't
  14 make any effort to maintain compatibility with versions
  15 of postgres earlier than 9.1.
  16
  17 The basic server configuration is done in the manner of Net::Server.
  18
  19 Provided example newsd program for how to call the module
  20 and get a running server.
  21
  22 For the Postgres storage to work, there must be a database
  23 named 'news', create it user news and load the schema.sql
  24 file into that database.  See or execute the make schema target.
  25
  26 You will probably want the regular set of newsgroups maintained
  27 by ISC.  A 'make activesync' will download and install them
  28 into the database.
  29
  30 You can fire up a test server with 'make testserver', and
  31 the 'make test' target will start and use a test server.
  32 These all use the existing database, so if you post against
  33 the testing server, the articles will persist.
  34
  35 The test server runs on the default Net::Server port of 20203,
  36 so your newsreader needs to hit that port.  I use slrn,
  37
  38 NNTPSERVER=localhost:20203 slrn -C -f ~/.jnewsrc --create
  39
  40 Will create the newsrc for slrn and you can post a message.