home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / ircd4652.zip / ircd-df-4.6.5-os2 / INSTALL < prev    next >
Text File  |  1998-02-21  |  6KB  |  164 lines
  1. $Id: INSTALL,v 1.3 1998/02/22 03:44:41 duffj Exp $
  2.  
  3. Installation Procedures for the DALnet IRC Server:
  4. =======================================================================
  5. by Alexei Kosut (Lefler) <lefler@dal.net>
  6. with changes for dal4.3.6 by Mikko HΣnninen (Wizzu) <wizzu@dal.net>
  7. for dal4.3.6
  8. with changes for dal4.4.11 by Cabal95 (cabal95@dal.net)
  9. =======================================================================
  10.  
  11. This document describes how to install ircd, the unix daemon that acts as 
  12. an IRC server. Specifically, for the DALnet IRC Network, though some 
  13. information may be applicable to other networks as well.
  14.  
  15. For more information on DALnet or this server, please see our WWW page at 
  16. <http://www.dal.net/>, or contact us at info@dal.net.
  17.  
  18. The DALnet server is available from ftp://ftp.dal.net/, along with the 
  19. latest copy of this document.
  20.  
  21.  
  22. =======================================================================
  23. This version of the DALnet IRC Server is known to compile on the following
  24. platforms, and with the following compilers.  If you wish to add to this
  25. list, send the relevant information to us.
  26.  
  27. OS and Version      Compiler and Version     Comments
  28. ------------------- ------------------------ -------------------------------
  29. NetBSD 1.2B         gcc 2.7.2
  30.  
  31. FreeBSD 2.1.0       gcc 2.6.3                Do NOT use crypt at all...
  32.  
  33. SunOS 4.1.4         gcc 2.7-96q1 (Cygnus)
  34.  
  35. Solaris 2.4         gcc 2.7-96q1 (Cygnus)    (SunOS 5.4)
  36.  
  37. Solaris 2.5         SunWorks Pro C           (SunOS 5.5.1)
  38.                     cc: SC4.0 18 Oct 1995 C 4.0
  39.  
  40. Digital Unix 3.2    gcc 2.7-96q3 (Cygnus)
  41.  
  42. Linux 2.0.24        gcc 2.7.2.1               should now also compile
  43.                                               under Red Hat 5.0
  44.  
  45. HPUX 9.01           gcc 2.6.3
  46.  
  47. HPUX 10.01          gcc 2.7-96q3 (Cygnus)
  48.  
  49. Windows NT/95       MSVC++ 4.0                for dal4.4.15+, some code
  50.                                               hacking will be necessary
  51.  
  52. =======================================================================
  53. Unpacking the Distribution
  54.  
  55. If you are reading this, you have most likely already done this, but to 
  56. recap:
  57.  
  58. The DALnet server <ftp://ftp.dal.net/pub/dalnet/server/df465.tgz>
  59. comes tarred and gzipped. To uncompress it and expand it, use the
  60. following command at the Unix prompt:
  61.  
  62. tar -xzf df465.tgz
  63.  
  64. This will create a new directory called df465, and unpack the source
  65. into it.
  66.  
  67. If you use Windows NT/95, you may need to find a program to extract
  68. this package.  Take a few minutes to find one, there are plenty about.
  69.  
  70. =======================================================================
  71. Editing the Configuration Files
  72.  
  73. In previous versions of the source code many files had to be edited to
  74. make things right for any given server.
  75.  
  76. In this version you DO NOT NEED TO EDIT THE Makefile OR ANY FILES
  77. IN include!  That is, unless you set some strange options.  If you
  78. find the need to edit include/config.h, for example, mail us and
  79. tell us why ; Config can be made smarter, and that will make it so 
  80. you won't have to edit anything for the next version.
  81.  
  82. NOTE: If you run Windows NT/95, you may need to edit include/config.h
  83. to set some minor options, but for the most part using the ./Config.exe
  84. program will work.
  85.  
  86. =======================================================================
  87. Compiling Your Server
  88.  
  89. Windows users: You must compile the Config program first. To do this
  90. run the following command:  $CC src\Config.c
  91. where $CC is the name of your compiler.  for MSVC users that is 'cl'
  92.  
  93. To build the server, simply run
  94.     % ./Config
  95. to start the configuraton program.  This program looks at your system
  96. and generate the include/setup.h, include/options.h, and Options files.
  97. You will be asked some questions.  Usually the default answers are the best
  98. ones and most correct.  To accept the default, just hit RETURN.
  99.  
  100. Next, type 'make'. This will compile your server. Depending on your system,
  101. this may be a good time for a caffeine break. (MSVC users run 'nmake')
  102.  
  103. Hopefully, the server will compile without incident. If it does not, and 
  104. you are not able to determine the error, please email dalnet-src@dal.net
  105. and hopefully someone will be able to help you with the problem.  If you
  106. do need to fix something, mail there with a patch.
  107.  
  108. BE CERTAIN TO INCLUDE OPERATING SYSTEM INFORMATION (uname -a) AND COMPILER
  109. VERSION (gcc -v, for instance) IN ALL BUG REPORTS.
  110.  
  111.  
  112. =======================================================================
  113. Installing the Files
  114.  
  115. 'make install' does not work in this release -- it doesn't do anything
  116. except a compile if that is needed.
  117.  
  118. The only files you need are the binary from src/ircd and and an ircd.conf
  119. (see below for copying doc/example.conf as your initial ircd.conf). You
  120. probably will want to create a MOTD file too, as well as place the man
  121. pages from the doc directory to appropriate place in your system.
  122.  
  123.  
  124. =======================================================================
  125. Configuring Your Server
  126.  
  127. The previous step places a file named 'example.conf' into your irc 
  128. directory you specified to Config.
  129.  
  130. To create an IRC configuration file, type:
  131.     cp example.conf ircd.conf
  132.  
  133. Now edit this file to reflect your server. The file is mainly 
  134. self-explanatory. Note that if you plan to use your server on DALnet, 
  135. make sure that you have the following line:
  136.  
  137. U:services.dal.net:*:*
  138.  
  139. If you need help configuring your file, please join DALnet, go to channel 
  140. #dragonrealm, and ask.
  141.  
  142.  
  143. =======================================================================
  144. Starting Your Server
  145.  
  146. Simply enter the complete path to the executable into the Unix command 
  147. line, then hit return. Your server is now operational, assuming that you 
  148. have completed all the steps described above.
  149.  
  150. NOTE: If you get something like the following when running ircd:
  151.  
  152. ircd fd table too big
  153. Hard Limit: 256 IRC max: 1024
  154. Fix MAXCONNECTIONS
  155.  
  156. You need to change config.h and recompile. Find the line that says 
  157. "#define MAXCONNECTIONS 1024", and change it to the number given after 
  158. "Hard Limit" (most likely 256), then make the server again, following the 
  159. above instructions.
  160.  
  161. Enjoy!
  162.  
  163. Lefler
  164.