]> git.sur5r.net Git - bacula/bacula/blob - bacula/src/win32/README.vc8
Rewrite the README to match the new build procedure.
[bacula/bacula] / bacula / src / win32 / README.vc8
1 Instructions to build Bacula with Microsoft Visual C++ 2005 
2 ===========================================================
3
4 Using the Express Edition (free version)
5 ----------------------------------------
6    Download instructions:
7     - Visual C++ 2005 Express Edition (2MB + 66MB)
8       http://msdn.microsoft.com/vstudio/express/visualc/download/  
9       NOTE: You may want to download the whole CD for offline usage 
10       instead of the web installer, as Microsoft will
11       start to charge for VC++ one year after the product launch 
12       (launch was in November 2005, see VC++ FAQ).
13
14     - Windows® Server 2003 SP1 Platform SDK Full Download (385MB)
15       http://www.microsoft.com/downloads/details.aspx?FamilyId=A55B6B43-E24F-4EA3-A93E-40C0EC4F68E5&displaylang=en
16       NOTE: choose "Full Download" version on the bottom of that page.
17
18    Installation instructions:
19     - Visual C++ Express Edition Beta 2:
20       + Run vcsetup.exe.
21       + When asked for Installation Options, only check "Graphical IDE" 
22         (MSDN Library is NOT needed).
23       + Remember where you install it (e.g. E:\Microsoft Visual Studio 8\)
24
25     - Windows® Server 2003 SP1 Platform SDK Full Download
26       + Run psdk-full.exe, type the directory where you downloaded the cab 
27         files.
28       + In a command prompt, run "PSDK-full.bat <temp directory>"
29         (e.g. "PSDK-full.bat E:\temp")
30       + Run <temp directory>\setup.exe
31       + When asked for the installation directory, choose 
32         <vc++ install dir>\VC\PlatformSDK (e.g. 
33         E:\Microsoft Visual Studio 8\VC\PlatformSDK\)
34       + When asked for components, you can safely remove documentation, 
35         samples, and all 64-bit tools and libs if you want to save disk 
36         space.
37
38 Getting the Bacula files
39 ------------------------
40    You will also need to checkout the latest Bacula source files:
41       + latest source from the CVS (into <dev dir>\bacula)
42    
43    You need to download one of the doc tar balls and extract to <dev dir>.
44    The directory name will be docs-version where version is the version number.  
45    The directory must be renamed to docs (ie remove the version portion of the name).
46       + docs 
47
48 Build instructions
49 ------------------
50    The script build-depkgs-msvc.cmd is used to download and build all the 
51    third party dependencies required by Bacula.  In order to build the 
52    dependencies you need the following utilities.  Only the binaries listed 
53    in parenthesis are required.  Perl must be listed in the PATH, the other 
54    utilities can either be on the PATH or copied to 
55    <dev dir>\depkgs-msvc\tools.
56
57       Perl (Normal Install, with binaries in the PATH)
58          http://downloads.activestate.com/ActivePerl/Windows/5.8/ActivePerl-5.8.8.819-MSWin32-x86-267479.msi
59       
60       7-Zip (7z.exe)
61          http://prdownloads.sourceforge.net/sevenzip/7za443.zip?download
62       
63       NASM (nasmw.exe)
64          http://prdownloads.sourceforge.net/nasm/nasm-0.98.39-win32.zip?download
65          
66       patch (patch.exe)
67          http://prdownloads.sourceforge.net/gnuwin32/patch-2.5.9-6-bin.zip?download
68          
69       sed (sed.exe) Depends on libintl, libiconv
70          http://prdownloads.sourceforge.net/gnuwin32/sed-4.1.4-bin.zip?download
71
72       tee (tee.exe) Depends on libintl, libiconv
73          http://prdownloads.sourceforge.net/gnuwin32/coreutils-5.3.0-bin.zip?download
74          
75       wget (wget.exe) Depends on libintl, libiconv, openssl
76          http://prdownloads.sourceforge.net/gnuwin32/wget-1.10.1-bin.zip?download
77
78       libintl (libintl3.dll) Dependency of sed, tee, wget
79          http://prdownloads.sourceforge.net/gnuwin32/libintl-0.14.4-bin.zip?download
80
81       libiconv (libiconv2.dll) Dependency of sed, tee, wget
82          http://prdownloads.sourceforge.net/gnuwin32/libiconv-1.9.2-1-bin.zip?download
83
84       openssl (libeay32.dll, ssleay32.dll) Dependency of wget
85          http://prdownloads.sourceforge.net/gnuwin32/openssl-0.9.7c-bin.zip?download
86
87    Once the utilities are installed continue with the next steps.
88    
89    + Start VC++ 2005 command prompt (in the start menu)
90    
91    + Change to the bacula\src\win32 directory.
92    
93    Only if you are using Microsoft Visual C++ Express 
94    
95       + run "%VCINSTALLDIR%\PlatformSDK\SetEnv"
96
97    The following step should only need to be done the first time and whenever 
98    the dependencies change.
99
100       + run build-depkgs-msvc
101    
102    At this point all of the dependencies should have been downloaded and built.  
103
104    To build the debug version
105   
106    + run build-msvc "Debug|Win32"
107    
108    To build the release version
109
110    + run build-msvc "Release|Win32"
111   
112    To cleanup all the built files
113    
114    + run build-msvc /c
115
116    To cleanup only the debug built files
117    
118    + run build-msvc /c "Debug|Win32"
119    
120    To rebuild the debug version
121    
122    + run build-msvc /r "Debug|Win32"