git.sur5r.net Git - bacula/bacula/blob - bacula/src/win32/README.win32

   1
   2 This directory <bacula-src>/src/win32 contains the build
   3 environment for building the native Win32 Bacula File daemon,
   4 the native Win32 bconsole program and the wx-console GUI console
   5 program.
   6
   7 The directory structure is:
   8
   9   bacula/src/win32      Makefiles and scripts
  10     baculafd            Visual Studio Files
  11       Release           Release objects, and bacula-fd.exe
  12        Debug            Debug object, and bacula-fd.exe produced
  13                            by VC++
  14     console             Build of console program and bconsole.conf
  15       Release           Release objects  and bconsole.exe
  16       Debug             Debug objects
  17     wx-console          Buld of wx-console program and wx-console-conf
  18       Release           Release objects and wx-console.exe
  19       Debug             Debug objects.
  20     filed               Links to core filed code
  21     findlib             Links to core findlib code
  22     lib                 Links to core lib code
  23
  24   depkgs-win32
  25     pthreads            The POSIX pthreads library (third party)
  26     zlib                The zlib library (third party)
  27     wx                  The wxWidgets library (third party)
  28
  29 depkgs-win32 is released in a separate .tar.gz file that contains the
  30 source for the above mentioned libraries needed to build the
  31 Win32 Bacula.  It can be found in the Source Forge Bacula project
  32 release section.
  33
  34 To build it:
  35 - For this version of Bacula, you must have msvcr71.dll
  36   installed in c:/windows/system32.  The winbacula.nsi.in
  37   and pebuilder Makefile.in files have this hard coded in.
  38 - We are using Microsoft Visual Studio .NET 2003.
  39 - Make sure nmake is on your PATH.
  40 - Make sure your COMSPEC is properly setup (see full dump of
  41   my cygwin environment below).
  42 - The build is done in an rxvt window under the latest version
  43   of cygwin.
  44 - You need the Platform SDK installed.
  45 - You need Visual Studio installed.
  46 - You need to load depkgs-win32, then
  47     (make the two patches described below to in Nicolas' notes to wx)
  48     cd depkgs-win32
  49     make
  50     (after building zlib and pthreads, it fails in wx)
  51     cd wx
  52     ./configure
  53     make
  54     (if it succeeds skip the next item, otherwise do it)
  55 - You may have to build wx with VC++.
  56   After starting VC++, use File->Open Workspace then
  57   open wx/src/wxWindows.dsw then use
  58   Build->Build All or Build->build wxmsw.lib should work too.
  59 - cd bacula
  60   ./configure --enable-client-only
  61   cd src/win32
  62   make
  63
  64 Instructions if you want to build bacula-fd with VSS
  65 (Volume Shadow Copy Service) support:
  66
  67 - VSS support works for both WinXP machines and Win 2003 machines.
  68 - you need to get the VSS SDK:
  69   http://www.microsoft.com/downloads/details.aspx?FamilyID=0B4F56E4-0CCC-4626-826A-ED2C4C95C871&displaylang=en
  70 - copy the 'inc' and 'lib' directories from this SDK to
  71   'bacula/src/win32/compat/vss'. Note, generally these files
  72   are installed in c:/Program\ Files/Microsoft/VSSSDK71
  73 - you should then have 'bacula/src/win32/compat/vss/inc' and
  74   'bacula/src/win32/compat/vss/lib'
  75   both with 'Win2003' and 'WinXP' subdirectories
  76 - add 'WIN32_VSS' as preprocessor directive
  77 - you should get a single bacula-fd.exe that runs on all platforms and has
  78   VSS support for WinXP and 2003 enabled
  79 - Follow the instructions given above for building it.
  80
  81 That should be all there is too it. The winbacula-1.xx.y.exe
  82 should be in the current directory.
  83
  84
  85 See License.txt for the License.
  86
  87 The native Win32 interface code was written by:
  88
  89    Christopher S. Hull, February 2004
  90
  91
  92 For more details of building wx, see depkgs-win32/wx/docs/msw/install.txt
  93
  94 The easiest way to build this is to have a Visual Studio C++ 6.0.
  95 However, you can use the free Microsoft C++ compiler with a bit
  96 of additional work.
  97
  98 Here are additional pointers on building wx-console supplied by Nicolas Boichat:
  99
 100
 101 Tools I used (I think the 3 first one are included in VStudio) :
 102 - VC++ toolkit : http://msdn.microsoft.com/visualc/vctoolkit2003/
 103 - Windows Platform SDK :
 104    http://www.microsoft.com/msdownload/platformsdk/sdkupdate/
 105    (Core SDK and Internet Development SDK)
 106 - nmake (it got it with .Net Framework SDK)
 107 - lib.exe found in the SDK-base/Bin/win64 directory (works fine
 108   on a 32 bit Windows).
 109
 110 Instructions if you want to build wx-console :
 111 - wxWidgets 2.4.2 compilation
 112   + In include/wx/string.h, replace line 195 by
 113       #if defined(__VISUALC__) // && defined(_MT) && !defined(_DLL)
 114   + In src/common/string.cpp, replace line 167 by
 115       #if defined(__VISUALC__) // && defined(_MT) && !defined(_DLL)
 116   + Follow the instructions in docs/msw/install.txt
 117      (Visual C++ 6.0 compilation - Using makefiles)
 118
 119 - Make sure that the environment variables are set as:
 120   - PATH includes the directories bin of both the C++ Toolkit and the SDK
 121   - INCLUDE includes the directories include of both the C++ Toolkit and the SDK
 122   - LIB includes the directories Lib of both the C++ Toolkit and the SDK
 123
 124 - Compile bacula depkg-win32 with Visual Studio or try the
 125   supplied makefiles as described in the doc.
 126
 127 - Compile wx-console with nmake -f wx-console.mak in
 128   src/win32/wx-console
 129
 130 - Additional information on using the free Micrsosoft C++ see
 131   http://sapdb.2scale.net/moin.cgi/MS_20C_2b_2b_20Toolkit
 132
 133 NOTE! I (Kern) cannot build wxWindows with the Makefile until after
 134 I do a ./configure.  I can us VC Studio directly to do so
 135 following their instructions.
 136
 137 Note, the paths given below have changed now that we switched
 138 to Microsoft Visual Studio .NET 2003 (VC++ 7.1).
 139
 140 Getting all the environment variables setup properly is not always so obvious.
 141 Here is what I have when I do a "set" in a rxvt window, in which I build
 142 Bacula. Probably what is important are INCLUDE, LIB, PATH, and WXWIN, but note
 143 there are a zillion other things set:
 144 !::='::\'
 145 !C:='C:\cygwin\home\kern'
 146 ALLUSERSPROFILE='C:\Documents and Settings\All Users'
 147 APPDATA='C:\Documents and Settings\kern\Application Data'
 148 BASEMAKE='C:\Program Files\Microsoft SDK\Include\BKOffice.Mak'
 149 BASH=/usr/bin/bash
 150 BASH_VERSINFO=([0]="2" [1]="05b" [2]="0" [3]="1" [4]="release" [5]="i686-pc-cygwin")
 151 BASH_VERSION='2.05b.0(1)-release'
 152 BKOFFICE='C:\Program Files\Microsoft SDK\.'
 153 CLIENTNAME=Console
 154 COLORFGBG='0;default;15'
 155 COLORTERM=rxvt-xpm
 156 COLUMNS=70
 157 COMMONPROGRAMFILES='C:\Program Files\Common Files'
 158 COMPUTERNAME=TIBS
 159 COMSPEC='C:\WINDOWS\system32\cmd.exe'
 160 CYGWIN=notty
 161 DIRSTACK=()
 162 DISPLAY=:0
 163 EDHELP=/home/kern/bin/ed.hlp
 164 EDTRM=/home/kern/bin/ed.trm
 165 EUID=1007
 166 GROUPS=()
 167 HISTFILE=/cygdrive/c/home/kern/.bash_history
 168 HISTFILESIZE=500
 169 HISTSIZE=500
 170 HOME=/cygdrive/c/home/kern
 171 HOMEDRIVE=C:
 172 HOMEPATH='\Documents and Settings\kern'
 173 HOSTNAME=Tibs
 174 HOSTTYPE=i686
 175 IFS=$' \t\n'
 176 INCLUDE='C:\Program Files\Microsoft SDK\Include\.;C:\Program Files\Microsoft Visual Studio\VC98\atl\include;C:\Program Files\Microsoft Visual Studio\VC98\mfc\include;C:\Program Files\Microsoft Visual Studio\VC98\include'
 177 INETSDK='C:\Program Files\Microsoft SDK\.'
 178 LIB='C:\Program Files\Microsoft SDK\Lib\.;C:\Program Files\Microsoft Visual Studio\VC98\mfc\lib;C:\Program Files\Microsoft Visual Studio\VC98\lib'
 179 LINES=65
 180 LOGONSERVER='\\TIBS'
 181 MACHTYPE=i686-pc-cygwin
 182 MAILCHECK=60
 183 MAKE_MODE=UNIX
 184 MOZILLA_HOME=/home/netscape
 185 MSDEVDIR='C:\Program Files\Microsoft Visual Studio\Common\MSDev98'
 186 MSSDK='C:\Program Files\Microsoft SDK\.'
 187 MSTOOLS='C:\Program Files\Microsoft SDK\.'
 188 NUMBER_OF_PROCESSORS=1
 189 OLDPWD=/home/kern/bacula
 190 OPTERR=1
 191 OPTIND=1
 192 OS=Windows_NT
 193 OSTYPE=cygwin
 194 PATH='/cygdrive/c/Program Files/Microsoft Visual Studio/VC98/Bin:/cygdrive/c/Program Files/Microsoft Visual Studio/VC98:/cygdrive/c/Program Files/Microsoft Visual Studio/Common/MSDev98/Bin:/cygdrive/c/Program Files/Microsoft Visual Studio/Common/Tools/WinNT:/cygdrive/c/Program Files/Microsoft Visual Studio/Common/Tools:c:/cygwin/bin:/usr/bin:/home/kern/bin:/sbin:/usr/sbin:'
 195 PATHEXT='.COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.WSF;.WSH'
 196 PIPESTATUS=([0]="0")
 197 PPID=3864
 198 PROCESSOR_ARCHITECTURE=x86
 199 PROCESSOR_IDENTIFIER='x86 Family 15 Model 2 Stepping 7, GenuineIntel'
 200 PROCESSOR_LEVEL=15
 201 PROCESSOR_REVISION=0207
 202 PROGRAMFILES='C:\Program Files'
 203 PROMPT='$P$G'
 204 PS1='\e[34m\]\w\[\e[0m\]$\040'
 205 PS2='> '
 206 PS4='+ '
 207 PWD=/home/kern
 208 SESSIONNAME=Console
 209 SHELL=/bin/bash
 210 SHELLOPTS=braceexpand:emacs:hashall:histexpand:history:interactive-comments:monitor
 211 SHLVL=1
 212 SYSTEMDRIVE=C:
 213 SYSTEMROOT='C:\WINDOWS'
 214 TEMP=/cygdrive/c/DOCUME~1/kern/LOCALS~1/Temp
 215 TERM=xterm
 216 TMP=/cygdrive/c/DOCUME~1/kern/LOCALS~1/Temp
 217 UID=1007
 218 USERDOMAIN=TIBS
 219 USERNAME=kern
 220 USERPROFILE='C:\Documents and Settings\kern'
 221 WINDIR='C:\WINDOWS'
 222 WINDOWID=168050736
 223 WXWIN='c:\home\kern\bacula\depkgs-win32\wx'
 224 _=set