mirror of
https://github.com/anope/anope.git
synced 2026-07-02 14:33:13 +02:00
trystan trystan@31f1291d-b8d6-0310-a050-a5561fc1590b
9b3a357193
git-svn-id: svn://svn.anope.org/anope/trunk@567 31f1291d-b8d6-0310-a050-a5561fc1590b git-svn-id: http://anope.svn.sourceforge.net/svnroot/anope/trunk@417 5417fbe8-f217-4b02-8779-1006273d7864
149 lines
6.4 KiB
Plaintext
149 lines
6.4 KiB
Plaintext
Anope for Windows
|
|
|
|
1. Building the source
|
|
2. Installation
|
|
3. Compiling modules
|
|
4. Credits
|
|
|
|
=========================================================================
|
|
= 1. Building from the ground up =
|
|
=========================================================================
|
|
|
|
If you want to build Anope on the Win32 system you will need to obtain
|
|
the following items.
|
|
|
|
1. Download the files required
|
|
|
|
- Current Anope source:
|
|
http://zero.org:7467/viewcvs/trunk.tar.gz
|
|
|
|
If you have Visual C++ 6, 7 or .NET skip ahead to step 2, else download
|
|
the following free components from Microsoft. Once downloaded install these packages
|
|
|
|
- VCToolKit:
|
|
http://download.microsoft.com/download/3/9/b/39bac755-0a1e-4d0b-b72c-3a158b7444c4/VCToolkitSetup.exe
|
|
|
|
- .NET Framework 1.1 Redistributable:
|
|
http://download.microsoft.com/download/a/a/c/aac39226-8825-44ce-90e3-bf8203e74006/dotnetfx.exe
|
|
|
|
- .NET Framework SDK 1.1:
|
|
http://download.microsoft.com/download/5/2/0/5202f918-306e-426d-9637-d7ee26fbe507/setup.exe
|
|
|
|
- Core SDK for the needed libraries:
|
|
http://www.microsoft.com/msdownload/platformsdk/sdkupdate/
|
|
|
|
- MySQL for Windows - needed if building for mysql
|
|
http://www.mysql.com
|
|
|
|
|
|
2. Unpack the Anope tarball with your favorite uncompression program (winzip or winrar)
|
|
|
|
3. Open Makefile.inc.win32 in the main directory with a text editor (notepad or notepad clones)
|
|
|
|
A. change the line "IRCD=" to match the ircd that you want to build, and place that number
|
|
after the = so if your building Unreal 3.2 (#10), you would change the line to read
|
|
"IRCD=10"
|
|
|
|
B. If you are building for MySQL change USE_MYSQL to equal 1 (ie.. USE_MYSQL=1), the next
|
|
two lines you must enter the path to the MySQL installation. MYSQL_INC, and MYSQL_LIB,
|
|
You can define the path one of two ways, either with \ or / if you use \ you must add
|
|
a secondary \ so c:\mysql would be c:\\mysql
|
|
|
|
C. To use Anope build in Proxy scan you can change PROXY_SCANNER to be equal to 1
|
|
(ie.. PROXY_SCANNER=1), note the proxy scan is not the best and its recommended to use
|
|
another thrid party scanner.
|
|
|
|
D. If you are using Visual Studio 6, this next line can be very important. If you are an
|
|
error during compile about "unresolved external symbol __ftol2", remove the # in front
|
|
of VC6=/QIfist and attempt to compile again.
|
|
|
|
E. When compiling if you get an error about 'Cannot find wsock32.lib' or 'Cannot find
|
|
msvcrt.lib' You need to define the libpath, in the LIBPATH directive. You can define
|
|
the path one of two ways, either with \ or / if you use \ you must add a secondary \
|
|
so c:\mysql would be c:\\sdk\lib be sure to remove the # in front of LFLAGS
|
|
|
|
F. Most import is to set the DATDEST to be the folder name where data will be stored.
|
|
This does not need to be the full path just the folder under the main executable
|
|
in which data will exist. In our example we will use "data"
|
|
|
|
4. You are now ready to compile, bring up the Visual C++ toolkit command prompt, this
|
|
will launch a dos command prompt like window, which will set the enviroment properties
|
|
need to make Anope. Change directories to where you unpacked the source code in step 2.
|
|
At the prompt type
|
|
|
|
nmake -f Makefile.win32
|
|
|
|
Once you are back at the command prompt again, if there have been no
|
|
errors, you are ready to go, should you encounter errors check how to adjust
|
|
the makefile.inc.win32 to help resolve the issue.
|
|
|
|
5. Anope will install the files where the belong. The only thing you need to do
|
|
is rename "data/example.conf" to be "services.conf"
|
|
|
|
You have now complete the building phase of Anope for Windows. Move to the
|
|
section related to setting up Anope.
|
|
|
|
=========================================================================
|
|
= 2. Installation =
|
|
=========================================================================
|
|
|
|
Since Anope for Windows does not use a visual interface, you must do
|
|
the configuration before getting to far into this.
|
|
|
|
Open services.conf, and make the following edits
|
|
|
|
A. RemoteServer : this is the address to your ircd, along with the port
|
|
and password. You should consult your ircd documentation
|
|
on how to link ircds.
|
|
B. ServicesRoot : Remove the # and change the names to your nick so you
|
|
can take control of services once they are online.
|
|
|
|
If you are unsure of the settings, You can go to the dos command prompt
|
|
and run "anope.exe -nofork -debug" and watch the information as it
|
|
attempts to connect.
|
|
|
|
To launch services you can do it one of two ways, if you are sure that the
|
|
configuration information is correct, simply double clicking on it will
|
|
cause it to start, no window will come up. You can start at the dos prompt
|
|
and type in "anope.exe" if services are successful in starting up
|
|
the dos prompt will seem to hang, at this point you can close the dos
|
|
window
|
|
|
|
=========================================================================
|
|
= 3. Compiling Modules =
|
|
=========================================================================
|
|
|
|
If you want to build other modules. You will need to modify the
|
|
Makefile.inc.win32
|
|
|
|
A. When compiling if you get an error about 'Cannot find wsock32.lib'
|
|
or 'Cannot find msvcrt.lib' You need to define the libpath, in the
|
|
LIBPATH directive. You can define the path one of two ways, either
|
|
with \ or / if you use \ you must add a secondary \ so c:\mysql
|
|
would be c:\\sdk\lib be sure to remove the # in front of LFLAGS
|
|
|
|
B. Add modules fine the line of "SRCS=" add the name of the file to
|
|
the end of the line. So if you have two files
|
|
|
|
"SRCS=file.c file2.c"
|
|
|
|
When that is done, use the same command prompt you set up in Part 1,
|
|
change directores to the src/modules folder and type
|
|
|
|
nmake -f Makefile.win32
|
|
|
|
Copy the *.dll files that get created to the "data/modules/runtime"
|
|
folder.
|
|
|
|
=========================================================================
|
|
= 4. Credits =
|
|
=========================================================================
|
|
|
|
Anope is based on the code of Epona and IRCServices see README for
|
|
full list of developers.
|
|
|
|
Anope Winodws code is provided by
|
|
|
|
Dominick Meglio <codemastr@unrealircd.com>
|
|
Trystan Scott Lee <trystan@nomadirc.net>
|
|
Chris Hogben <heinz@anope.org> |