]>
Commit | Line | Data |
---|---|---|
1 | srvx Installation Instructions | |
2 | ||
3 | Introduction: | |
4 | ---------- | |
5 | If you encounter any problems compiling/running srvx, please make sure | |
6 | you have followed the directions in this file correctly and that all | |
7 | of the requirements listed below are met. | |
8 | ||
9 | If the problem persists, report it to one (or all) of the coders | |
10 | listed in the AUTHORS file. Please try to include ALL relevant | |
11 | information about the error/bug, including anything out of the | |
12 | ordinary reported from make and the appropriate entries from the log | |
13 | files. | |
14 | ||
15 | Requirements: | |
16 | ---------- | |
17 | This release of srvx (1.3) only supports the Undernet P10 and Bahamut | |
18 | protocols and is known to link with ircu/Universal (u2.10.09), | |
19 | ircu/Undernet (u2.10.10, u2.10.11), ircu-lain, and Bahamut 1.4.32. It | |
20 | does not support hybrid, Unreal, or any other ircd not listed. Should | |
21 | you find other compatible ircds, please let us know. Most of the | |
22 | testing has been done on ircu2.10.11.06. | |
23 | ||
24 | srvx is known to compile on the following systems as long as you | |
25 | are using GNU make (make on Linux, gmake on many other systems): | |
26 | ||
27 | * Linux (libc5 or glibc2); glibc2.1 recommended+ (SPARC, ALPHA, x86, PPC) | |
28 | * FreeBSD 4.x; tested on 4.2-RELEASE and 4.2-STABLE (SPARC, x86) | |
29 | * FreeBSD 3.x; tested on 3.3-RELEASE and 3.4-STABLE (SPARC, x86) | |
30 | * FreeBSD 2.x; tested on 2.2.8-RELEASE (SPARC, x86) | |
31 | * NetBSD 1.6+; (ALPHA, MIPS, x86) | |
32 | * SunOS 5.x; tested on 5.8 (SPARC, x86) | |
33 | * OpenBSD 2.x; tested on 2.8 (x86) | |
34 | * BSDi 4.x; tested on 4.0.1 (x86) | |
35 | * CYGWIN 1.1.x and 1.3.x; tested on 1.1.8 (x86) | |
36 | ||
37 | For the Linux kernel, srvx has been tested on Debian 2.x - 3.x, and | |
38 | Redhat 5.x - 8.x. | |
39 | ||
40 | srvx should compile on other system types also. If you have success | |
41 | on other platforms/archs or problems on any platforms/archs, please | |
42 | contact the authors to let us know. | |
43 | ||
44 | gcc 2.96 tends to emit spurious warnings; before reporting any | |
45 | compiler warnings from it, make sure you are using the most recent | |
46 | version of it or try using an official release of gcc. | |
47 | ||
48 | You may also have trouble unless your compiler's C preprocessor | |
49 | supports ISO C99 varadic macros. gcc is the compiler we use for | |
50 | almost all our testing, and we recommend it for use with srvx. | |
51 | ||
52 | Quick Install: | |
53 | ---------- | |
54 | $ ./autogen.sh | |
55 | $ ./configure --prefix='/path/to/install/to' | |
56 | NOTE: The protocol the resulting srvx binary will support is | |
57 | determined by the configure script. The P10 protocol is the | |
58 | default; if you would like to link to Bahamut, you must pass | |
59 | the --with-protocol=bahamut flag to the configure script: | |
60 | $ ./configure --with-protocol=bahamut --prefix='/path/to/install/to' | |
61 | $ make | |
62 | $ ${EDITOR} srvx.conf | |
63 | NOTE: You may want to copy srvx.conf.example to srvx.conf and | |
64 | edit that. | |
65 | $ ./srvx | |
66 | ||
67 | Compiling: | |
68 | ---------- | |
69 | 1) Enter the root directory of the srvx tree. If installation is done | |
70 | from outside of it, it may cause problems during compile, or during | |
71 | runtime. | |
72 | ||
73 | 2) Run the configure script (sh configure), it will verify that your | |
74 | system will have the resources needed for srvx to compile. If you | |
75 | would like to change the path where srvx will be installed to, | |
76 | execute configure with the --prefix=/path option. The default path | |
77 | is ~/srvx-X.X.X/, with the X's representing the version. See the | |
78 | note in "Quick Install" if you are linking to Bahamut. | |
79 | ||
80 | 3) On some systems you may need to edit the Makefile in order for | |
81 | it to compile correctly. Includes, and other such things may | |
82 | reside in other directories. Most likely the Makefile won't require | |
83 | any modifications. | |
84 | ||
85 | 4) You may optionally edit config.h in case the configure script made a | |
86 | mistake. | |
87 | ||
88 | 5) Execute the "make" command to begin compiling. If you encounter any | |
89 | uncorrectable errors/warnings, please scroll up to the introduction | |
90 | section and follow the instructions. | |
91 | ||
92 | 6) You may now either type "make install" to install it to your | |
93 | installation path, or work from your build directory, either is fine. | |
94 | ||
95 | 7) Copy sockcheck.conf.example to sockcheck.conf (and edit to add | |
96 | new proxy types, if you wish). | |
97 | ||
98 | 8) Copy srvx.conf.example to srvx.conf and edit to suit your | |
99 | needs. Errors in the configuration file will be logged to | |
100 | main.log (and if srvx is running in the foreground, printed to | |
101 | stdout) when you start the daemon. | |
102 | ||
103 | 9) You can now begin using your service bots. You can debug by | |
104 | running it with '-fd', it will not background itself, and it | |
105 | will be fairly verbose if you gave the configure script the | |
106 | --enable-debug flag. If you would like to run in the foreground | |
107 | with no verbosity, use the '-f' flag. If you just want to run it, | |
108 | execute srvx without any flags. | |
109 | ||
110 | 10) Once you have srvx started, you'll need to register a NickServ | |
111 | account: | |
112 | /msg NickServ@services.irc.com register <account> <password> | |
113 | Make sure that you register the first account -- it is | |
114 | automatically granted certain privileges and gives you root-level | |
115 | access to OpServ once you are opered up. | |
116 | ||
117 | 11) New operators can be given access to OpServ through NickServ's | |
118 | (or whatever you've named the nick/authentication service) oset | |
119 | command: | |
120 | /msg NickServ oset <nick>|*<account> level <level> | |
121 | Levels are generally beween 0 and 1000 by convention; higher | |
122 | numbers correspond to more access. You can also add helpers | |
123 | (users with extra privileges such as security override in | |
124 | traditional configurations) through NickServ: | |
125 | /msg NickServ oset <nick>|*<account> flags +H | |
126 | ||
127 | End of file, INSTALL. | |
128 | ||
129 | -Jedi (jedi@turboflux.net) |