1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80
|
INSTALL
This file contains an outline for installing bnetd-0.4.19.
STEPS
1) All the source code is in the src directory. First change to that
directory with the "cd" command.
2) Run the configure script. If you get an error like "configure:
command not found" try typing "./configure". The command should
complete successfully and create a Makefile and config.h customized
for your system. You may pass it options to modify the way the
program is configured. Run configure with the "--help" options to
display a list of avaliable options. The most common need is to
modify the location that the server should be installed. The
defaults for these values are:
--prefix=/usr/local
--bindir=/usr/local/bin
--sbindir=/usr/local/sbin
--localstatedir=/usr/local/var
--sysconfdir=/usr/local/etc
--mandir=/usr/local/man
The directories "users", "reports", and "files" will be created
underneath the localstatedir directory during installation.
3) Now type "make".
4) Hopefully there will be no errors during the compile.
the server executable is "sbin/bnetd"
the proxy executable is "sbin/bnproxy"
the password encrypter is "bin/bnpass"
the chat client executable is "bin/bnchat"
the bot client executable is "bin/bnbot"
the file download client executable is "bin/bnftp"
the player stat client executable is "bin/bnstat"
5) You may now optionally type "make install". This will copy the
binaries, man pages, and configuration files to the directories you
specified in step 2. The configuration file will be automatically
updated before it is copied to reflect the locations of the other
files. Be warned: if you already have configuration files in the
destination directories they will be overwritten.
6) Before running the server, check the "bnetd.conf" file to verify
it suits your preference. Pay special attention to the files,
tracking, and policy sections. Note the filenames in this file are
relative to top (root) directory of the system, so it is best to
use absolute paths. If you do not want your server information to
be sent to tracker.bnetd.org, leave the track time variable set 0
(zero) and/or specify a different tracking server, otherwise set
the time interval to something like 150 seconds. You may also wish
to edit channel.list, bnmotd.txt, and bnetd_default_user. Some
files in the "files/" directory might also be of interest for those
people who like to customize things.
7) There is little or no reason to run this server under the root
user, so consider creating a special account for it or run it as
another unprivileged user. Just make sure the bnetd files and
directories are writable by that user.
8) If you wish to run the server "in-place" (from the directory you
compiled it in), make sure you are in the top level bnetd directory
(the one with this file) and type "./sbin/bnetd -f". This should
start your server in the foreground.
9) If you ran "make install", you may start your server by simply
typing "bnetd". If you get an error like "bnetd: command not found"
that means the server is not in your search path and you will need
to type the full path of the binary (for example, type
"/usr/local/sbin/bnetd"). The server will automatically background
itself.
10) If there are problems, you may wish to look in the "bnetd.log" file
for error messages. If the server was unable to initialize the
network, there may already be a bnetd server running on that
computer.
|