- srvx Installation Instructions
+ X3 Installation Instructions
Introduction:
----------
-If you encounter any problems compiling/running srvx, please make sure
+If you encounter any problems compiling/running X3, please make sure
you have followed the directions in this file correctly and that all
of the requirements listed below are met.
Requirements:
----------
-This release of srvx (1.3) only supports the Undernet P10 and Bahamut
-protocols and is known to link with ircu/Universal (u2.10.09),
-ircu/Undernet (u2.10.10, u2.10.11), ircu-lain, and Bahamut 1.4.32. It
-does not support hybrid, Unreal, or any other ircd not listed. Should
+This release of X3 (1.4) only supports the Undernet P10
+protocol and is known to link to ircu/Undernet (u2.10.11, u2.10.12),
+Nefarious IRCu 0.4.0 and Nefarious IRCu 1.0. It does not support
+bahamut, hybrid, Unreal, or any other ircd not listed. Should
you find other compatible ircds, please let us know. Most of the
-testing has been done on ircu2.10.11.06.
+testing has been done on Nefarious IRCu 0.4.0/1.0 (Based on ircu2.10.11.x).
-srvx is known to compile on the following systems as long as you
+X3 is known to compile on the following systems as long as you
are using GNU make (make on Linux, gmake on many other systems):
* Linux (libc5 or glibc2); glibc2.1 recommended+ (SPARC, ALPHA, x86, PPC)
* BSDi 4.x; tested on 4.0.1 (x86)
* CYGWIN 1.1.x and 1.3.x; tested on 1.1.8 (x86)
-For the Linux kernel, srvx has been tested on Debian 2.x - 3.x, and
+For the Linux kernel, X3 has been tested on Debian 2.x - 3.x, and
Redhat 5.x - 8.x.
-srvx should compile on other system types also. If you have success
+X3 should compile on other system types also. If you have success
on other platforms/archs or problems on any platforms/archs, please
contact the authors to let us know.
You may also have trouble unless your compiler's C preprocessor
supports ISO C99 varadic macros. gcc is the compiler we use for
-almost all our testing, and we recommend it for use with srvx.
+almost all our testing, and we recommend it for use with X3.
Quick Install:
----------
-$ ./autogen.sh
-$ ./configure --prefix='/path/to/install/to'
- NOTE: The protocol the resulting srvx binary will support is
+$ ./configure
+ NOTE: The protocol the resulting X3 binary will support is
determined by the configure script. The P10 protocol is the
- default; if you would like to link to Bahamut, you must pass
- the --with-protocol=bahamut flag to the configure script:
- $ ./configure --with-protocol=bahamut --prefix='/path/to/install/to'
+ default.
$ make
-$ ${EDITOR} srvx.conf
- NOTE: You may want to copy srvx.conf.example to srvx.conf and
+$ ${EDITOR} x3.conf
+ NOTE: You may want to copy x3.conf.example to x3.conf and
edit that.
-$ ./srvx
+$ ./x3
Compiling:
----------
- 1) Enter the root directory of the srvx tree. If installation is done
+ 1) Enter the root directory of the X3 tree. If installation is done
from outside of it, it may cause problems during compile, or during
runtime.
2) Run the configure script (sh configure), it will verify that your
- system will have the resources needed for srvx to compile. If you
- would like to change the path where srvx will be installed to,
+ system will have the resources needed for X3 to compile. If you
+ would like to change the path where X3 will be installed to,
execute configure with the --prefix=/path option. The default path
- is ~/srvx-X.X.X/, with the X's representing the version. See the
- note in "Quick Install" if you are linking to Bahamut.
+ is ~/x3/, with the X's representing the version.
3) On some systems you may need to edit the Makefile in order for
it to compile correctly. Includes, and other such things may
7) Copy sockcheck.conf.example to sockcheck.conf (and edit to add
new proxy types, if you wish).
- 8) Copy srvx.conf.example to srvx.conf and edit to suit your
+ 8) Copy x3.conf.example to x3.conf and edit to suit your
needs. Errors in the configuration file will be logged to
- main.log (and if srvx is running in the foreground, printed to
+ main.log (and if X3 is running in the foreground, printed to
stdout) when you start the daemon.
9) You can now begin using your service bots. You can debug by
will be fairly verbose if you gave the configure script the
--enable-debug flag. If you would like to run in the foreground
with no verbosity, use the '-f' flag. If you just want to run it,
- execute srvx without any flags.
+ execute X3 without any flags.
- 10) Once you have srvx started, you'll need to register a NickServ
+ 10) Once you have X3 started, you'll need to register a AuthServ
account:
- /msg NickServ@services.irc.com register <account> <password>
+ /msg AuthServ@services.irc.com register <account> <password>
Make sure that you register the first account -- it is
automatically granted certain privileges and gives you root-level
- access to OpServ once you are opered up.
+ access to O3 once you are opered up.
- 11) New operators can be given access to OpServ through NickServ's
+ 11) New operators can be given access to O3 through AuthServ's
(or whatever you've named the nick/authentication service) oset
command:
- /msg NickServ oset <nick>|*<account> level <level>
+ /msg AuthServ oset <nick>|*<account> level <level>
Levels are generally beween 0 and 1000 by convention; higher
numbers correspond to more access. You can also add helpers
(users with extra privileges such as security override in
- traditional configurations) through NickServ:
- /msg NickServ oset <nick>|*<account> flags +H
+ traditional configurations) through AuthServ:
+ /msg AuthServ oset <nick>|*<account> flags +H
End of file, INSTALL.