INSTALL

   1
   2 ircu - INSTALL
   3   Original by Run <carlo@runaway.xs4all.nl>,
   4   Isomer <isomer@coders.net>, and Kev <klmitch@mit.edu>
   5   Rewritten by Sengaia <sengaia@undernet.org>
   6
   7 Compiling and installing ircu should be a fairly straightforward process,
   8 if you have obtained this software as a (.tar.gz) package, please consider
   9 using CVS (described below). Using CVS will make updating your installation
  10 much easier.
  11
  12 After obtaining the latest version of the ircu source code, change into the
  13 source directory (ircu2.10), and run "./configure". To see the various ways
  14 in which you can customize your installation, run "./configure --help".
  15
  16 The configure process will check your environment and prepare itself for
  17 compiling the source code. If one or more of the prerequisites cannot be
  18 found, configure will terminate with an error. You will need to resolve
  19 this and run configure again.
  20
  21 If configure runs without error(s), you are ready to compile. To compile ircu,
  22 run "make". Please use GNU make and gcc. If the source code does not compile,
  23 make sure your environment is setup correctly. If you are convinced the source
  24 of the failure is ircu, gather all relevant information about your system such
  25 as the Architecture, OS version, the configure statement you used, etc. and
  26 contact coder-com@undernet.org.
  27
  28 Once ircu is compiled, install it by running "make install".
  29
  30 Next, you will have to configure your IRC server by setting up your ircd.conf
  31 file. Use the included doc/example.conf as a starting point; it is installed
  32 in $HOME/lib/example.conf by default.
  33 Setting up ircd.conf can be a bit tricky, so if this is your first time doing
  34 it, begin with a bare-bones configuration and extend it as you go.
  35
  36 If you are upgrading from ircu2.10.10, use the tools/transition script to
  37 convert your existing configuration file(s).
  38
  39 Good Luck!
  40
  41 RETRIEVING IRCU VIA CVS
  42
  43 The recommended way to get the ircu package now is to use CVS.  CVS makes
  44 upgrades a lot less painful and lets you get the latest package.
  45
  46 The first thing you need to do is login to the cvs server:
  47 # cvs -d :pserver:anonymous@cvs.undernet.org:/cvsroot/undernet-ircu login
  48
  49 (we recommend that you cut and paste the above line to use it :)
  50 When it prompts you for a password hit enter since there isn't one.
  51
  52 To check out the the last stable version of ircu, use:
  53 # cvs -d :pserver:anonymous@cvs.undernet.org:/cvsroot/undernet-ircu co -P ircu2.10
  54
  55 To update your source tree to the latest version, run "cvs update -dP" from within the
  56 ircu2.10 directory. For more information, see http://coder-com.undernet.org.
  57