Project

General

Profile

Preparing a Windows machine for Bilder » History » Version 181

David Alexander, 03/10/2025 10:15 AM

1 1 Redmine Admin
# Preparing a Windows machine for Bilder (64-bit only)
2
3 39 Ted Sume
For building on Windows 10 in Ubuntu, follow the Linux Bilder setup instructions. 
4
5 112 David Alexander
_Warning:_ In following the directions below, pre-defined env variables like CL, PETSC_DIR, PETSC_ARCH, and others will cause problems.  For example, one user had CL=/nologo which prevented the version and other info from being printed and caused bilder to fail.
6 1 Redmine Admin
7
# Basic Windows Configuration
8
9 112 David Alexander
## UAC
10 1 Redmine Admin
11 168 Ted Sume
User Account Control Settings can be fine-tuned (see Control-Panel -> System and Security -> Change User Account Control settings). Set Control Setting to the lowest setting (never notify) to avoid unwanted dialog boxes. This requires a reboot to take effect! The UAC Settings must be adjusted to "never notify" (this action is needed to make symbolic links during bilder runs and building Atlas). 
12 1 Redmine Admin
13 152 John Cary
## File Name too long
14
15
This can be a problem when cloning Trilinos.  To fix, see https://www.techinpost.com/the-file-name-too-long/.  In essence, use regedit to go to
16
```
17
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem
18
```
19
where you can set LongPathsEnabled to 1, then reboot.
20
21 112 David Alexander
## Editing your system path on Windows
22 1 Redmine Admin
23 168 Ted Sume
Open Run (Windows Key + R), then type *SystemPropertiesAdvanced* and press Enter. 
24
On the bottom third of the resulting dialog, click the Environment Variables button. 
25
In System Variables, highlight Path and click Edit. This is where you make changes to your system path.
26 1 Redmine Admin
27 112 David Alexander
## If your machine is on a Windows Domain (as compared to a WORKGROUP), then ensure that Windows knows its domainname
28 1 Redmine Admin
29 96 David Alexander
If your machine is on a Windows Domain, then Bilder can set a common variable that makes sense in that Domain. If you are not on a Windows Domain, then Bilder will still work fine (except for maybe emailing). To ensure Windows knows its domainname to the following.
30 89 David Alexander
31 1 Redmine Admin
* From a command prompt, type the command: 
32
33
~~~~~~
34
ipconfig /all
35
~~~~~~
36
37 96 David Alexander
Look for the value of the "Primary Dns Suffix" field, which should be your domain name (i.e. txcorp.com).
38 1 Redmine Admin
39
* If cygwin is already installed,
40
41
~~~~~~
42
ipconfig /all | grep -i "Primary Dns Suffix" | sed -e 's/^.*: //'
43
~~~~~~
44
45 89 David Alexander
should return the domainname. 
46 1 Redmine Admin
47 168 Ted Sume
* For Windows 10 machines that are not a member of the Windows Domain, Active Directory, do the following:
48 1 Redmine Admin
    1. Right click on My Computer, select properties
49
    2. Click on Advanced system settings
50
    3. Select the computer name tab
51
    4. Click the change button
52
    5. Click the more button
53
    6. Enter the Primary DNS suffix. i.e. txcorp.com 
54
55 112 David Alexander
## Create initial directories
56 1 Redmine Admin
57
* Create the folder C:\\bin (if not already present).
58
* Add or move C:\\bin to the front of your system path.
59
60 113 David Alexander
# Software "Required" for Bilder
61 1 Redmine Admin
62 74 David Alexander
What is absolutely required for Bilder depends on what you are trying to build. For example, if you are **only building user documentation**, then you only need
63 37 John Cary
64 74 David Alexander
* Blat (for emailing yourself)
65 36 John Cary
* Cygwin (for bash shell)
66 1 Redmine Admin
* CMake from an installer
67 157 John Cary
* NASM from an installer
68 38 John Cary
* Python from an installer
69 1 Redmine Admin
* Latex (MikTek below)
70
* Visual Studio Express (for nmake)
71
72 162 Tech-X Corporation
If you have installed a package, you will need to open a new Cygwin window to update PATH in order for your Cygwin bash shell to find the package.  To check whether a package is in PATH, from a Cygwin shell, enter
73
74 168 Ted Sume
~~~~~~~~~~~
75 162 Tech-X Corporation
echo $PATH
76 168 Ted Sume
~~~~~~~~~~~
77 162 Tech-X Corporation
78
After installing the requirements, you can add the arguments,  -W python,cmake, and your installed Python and CMake will be used if your path is correct.
79 1 Redmine Admin
80 144 David Alexander
Since bilder uses the C++17 conformance flags, we require:
81 82 John Cary
82 144 David Alexander
* Visual Studio 2017 version 15.7 or higher (As of Oct 2019 the latest upgrade version is 15.9.17, which is fine)
83 83 John Cary
* Windows 10 or Windows 10 SDK
84
85 74 David Alexander
Below is a list of the Tools and Libraries that are most often needed.
86
87
# Tools (Required for most common builds within Bilder)
88
89 1 Redmine Admin
## Blat
90
91 167 John Cary
* Blat is a sendmail client for Windows needed to send emails.*
92 149 David Alexander
93 1 Redmine Admin
* Download Blat from [The Blat SourceForge](http://sourceforge.net/projects/blat) Site and extract all files. The latest version should be fine.
94 150 David Alexander
* Extract the zip file (e.g. blat3222_32.full.zip) into C:\\bin.
95
* Copy the contents of the "full" directory up two diretories into "C:\bin" (i.e. C:\bin\blat3222\full\blat.{exe,dll} to C:\bin\blat.{exe,dll}).
96
* Execute the following command in a cygwin terminal to check that it works
97 1 Redmine Admin
98
~~~~~~
99 168 Ted Sume
    blat -install <mail server hostname> <username>@txcorp.com
100 1 Redmine Admin
~~~~~~
101
102
## CMake
103
104 167 John Cary
* CMake is a cross-platform build system needed to configure many of necessary packages.*
105 1 Redmine Admin
106 168 Ted Sume
* Install [CMake](http://www.cmake.org/files/).
107
  * Version 3.27 is what we use as of Feb 2024. However, picking a later version is better because it will allow bilder to build future versions of cmake.
108 26 John Cary
  * Add the CMake path to the front of the system path! (Needed to build newer 64 bit versions through Bilder)
109 1 Redmine Admin
  * When this step is complete, make sure the newest CMake is the only one in your system path.
110
111 181 David Alexander
## Git
112
113
*Git used to be ok as part of Cygwin, but we need to install git-lfs separately anyway, so just install Git which comes with the git-lfs will also work, so doing that*
114
115
* Download installer from https://git-scm.com/downloads (2.48.1 as of Mar 10, 2025 works for latest bilder git commands.)
116
* Edit the C:\Program Files\Git\etc\gitconfig file and add "longpaths = true" in the Core section
117
118
The installer should add C:\Program Files\Git\cmd\ to the path so that git and git-lfs are in path. Git LFS is a git extension for repos with large files - needed to use git for VisIt repos.
119
120 10 Redmine Admin
## CYGWIN
121 1 Redmine Admin
122 74 David Alexander
*Cygwin is a Unix shell program for Windows and is needed to run the bash code of Bilder.*
123
124 169 Ted Sume
### Installing Cygwin
125 1 Redmine Admin
126 169 Ted Sume
* Download the cygwin installer from [here](http://cygwin.com/install.html)
127
* From a Windows Elevated Command Prompt, change into the directory that has the recently downloaded setup-x86_64.exe from cygwin, then execute the script below to install cygwin
128 1 Redmine Admin
129 169 Ted Sume
~~~~~~~
130
setup-x86_64.exe  ^
131
--only-site ^
132
--site https://mirrors.kernel.org/sourceware/cygwin ^
133
--local-package-dir C:\cygwin64pkgs ^
134
--root C:\cygwin64 ^
135
--verbose ^
136
--prune-install ^
137
--quiet-mode ^
138
--packages ^
139 1 Redmine Admin
_autorebase,base-cygwin,base-files,bc,bison,curl,diffutils,dos2unix,emacs,emacs-w32,emacs-X11,flex,gcc-fortran,gcc-g++,gdb,^
140 181 David Alexander
hostname,make,mercurial,mintty,ncurses,openssh,patch,perl,procps-ng,rebase,subversion,^
141 169 Ted Sume
tar,time,util-linux,vim,vim-common,vim-doc,vim-minimal,wget,xinit
142
~~~~~~~~
143 1 Redmine Admin
144 169 Ted Sume
## Cygwin Post Installation (To be done from a cygwin terminal)
145 1 Redmine Admin
* Create the directory winsame at the top level of both the Cygwin and Windows file systems. You must always work in this directory.  This is critical for getting the ATLAS linear algebra libraries to build. Do this via:
146
147
~~~~~~
148
mkdir /cygdrive/c/winsame
149
mkdir /winsame
150
mount C:/winsame /winsame
151
~~~~~~
152
153 169 Ted Sume
To make this permanent, put the following in /etc/fstab. This second entry allows one to construct a valid path with no parentheses as needed for ATLAS.
154 1 Redmine Admin
155
~~~~~~
156
C:/winsame /winsame ntfs binary 0 0
157
C:/Program\040Files\040(x86) /ProgramFilesX86 ntfs binary 0 0
158
~~~~~~
159
160 169 Ted Sume
* Edit /etc/nsswitch.conf by adding the following entry to tell cygwin where to put home directories. e.g
161 1 Redmine Admin
162
~~~~~~
163 169 Ted Sume
db_home:  /winsame/%U
164 1 Redmine Admin
~~~~~~
165
166 169 Ted Sume
* If 'which link' returns /usr/bin/link, then move this aside (mv /usr/bin/link.exe /usr/bin/linkoff.exe) so that it is not picked up to replace the Visual Studio link.  (This is where we could define BILDER_LINK.)
167
* Make sure that 'which find' returns the cygwin version (/usr/bin/find), not the Windows version.
168
* Close the cygwin terminal and open a new one
169 146 David Alexander
170 52 John Cary
## Dependencies Tool
171 146 David Alexander
172 5 Redmine Admin
*Dependencies* is a tool that shows the DLL's that an executable depends on and is needed to find and copy-in DLLs to a final distribution.
173 151 John Cary
174
Download [Dependencies](https://lucasg.github.io/Dependencies/) and copy Dependencies*, ClrPhlib.{dll,pdb} into C:\\bin.
175 1 Redmine Admin
(NDesk.Option.dll not needed.)
176
177
## JOM
178 167 John Cary
179 1 Redmine Admin
* JOM is an nmake wrapper needed to give  the -j flag capability of Unix make for faster compilation.*
180
181
* Create the folder C:\bin (if not already present).
182
* Add C:\bin to your system path (if not already there).
183
* Download jom.zip from [the Qt Project](https://wiki.qt.io/Jom).
184
* Extract the contents of jom.zip
185
* Move/copy jom.exe to C:\bin (you then can delete the remainder of the contents or keep for historical reasons).
186
187 174 Ted Sume
## Ninja Build System (https://ninja-build.org)
188
189 175 David Alexander
* Download  ninja-win.zip from [ninja-win.zip](https://github.com/ninja-build/ninja/releases/tag/v1.12.1)
190 174 Ted Sume
* Extract ninja from ninja-win.zip and copy into C:\bin
191
192 1 Redmine Admin
## LaTeX
193 74 David Alexander
194 1 Redmine Admin
*LaTeX is a typesetting tool needed for building PDF files for user documentation.*
195 123 Benjamin Cowan
196 92 John Cary
* Install [Doxygen](http://www.doxygen.nl/).  Choose "Letter" for paper size and "Yes" for "Install missing packages on-the-fly".
197
* Install Basic MikTeX from [MikTeX](http://miktex.org/). Use the MikTeX Package Manager to install the packages noted at
198 124 Benjamin Cowan
[[LaTeX packages needed by Bilder]]
199 1 Redmine Admin
* Install [ghostscript](https://www.ghostscript.com/download/gsdnld.html).
200 166 John Cary
201 1 Redmine Admin
## LLVM (Clang)
202 166 John Cary
203
### Installing LLVM-Clang from a binary installer (easiest way)
204
205
Download the Windows (64-bit) installer from http://releases.llvm.org/download.html, and proceed with the installation.
206
207 170 Ted Sume
When installing, namespace the installation directory with the major version.  Eg, change LLVM to LLVM17 when asked.
208 1 Redmine Admin
209
## MPI
210 74 David Alexander
211
*MPI is a message passing interface for parallel code that is needed for some computation engines.*
212 98 Ted Sume
213 171 Ted Sume
Download Microsoft MPI v9.0.1 from:
214 98 Ted Sume
215 171 Ted Sume
https://www.microsoft.com/en-us/download/details.aspx?id=56727
216 93 John Cary
217 1 Redmine Admin
The binaries (e.g., mpiexec) are obtained by installing msmpisetup.exe.
218 94 John Cary
219 1 Redmine Admin
The libraries (msmpi.lib) are obtained by installing msmpisdk.msi.
220 93 John Cary
221
The installers will put mpiexec in your path and define the environment variables,
222
223
MSMPI_INC
224
MSMPI_BIN
225
MSMPI_LIB32
226
MSMPI_LIB64
227
228 157 John Cary
which are used by CMake, e.g., to find the needed components of MSMPI.
229
230
## NASM (required to build OpenSSL, therefore CMake)
231
232 158 John Cary
* Download and install from https://nasm.us/
233 1 Redmine Admin
* Make sure this appropriate modifications to your path are made
234 85 John Cary
235 74 David Alexander
## Perl (required to build OpenSSL, therefore CMake)
236 1 Redmine Admin
237
*Perl is a programming language needed by some packages such as Qt*
238
239 74 David Alexander
* Download and install [ActiveState Perl](http://www.activestate.com/activeperl/downloads).
240
241 1 Redmine Admin
## Python
242 166 John Cary
243 1 Redmine Admin
* Python is built or installed by Bilder.
244 107 John Cary
245
## RCEDIT
246
247
* RCEDIT is a program that allows one to change the icon of an executable after its creation.  It can be obtained from https://github.com/electron/rcedit/releases, and it should be installed in C:\bin.
248 85 John Cary
249
## Ruby (required to build Qt5)
250
251
* Ruby, http://rubyinstaller.org/, must be installed first.
252 1 Redmine Admin
253
## Subversion
254 74 David Alexander
255 1 Redmine Admin
* Subversion is a revision control tool needed by bilder, for example, to know when packages are out of date.*
256 108 Benjamin Cowan
257 1 Redmine Admin
* Install [TortoiseSVN](https://tortoisesvn.net/downloads.html) with its command line tools.
258 89 David Alexander
259 33 Tech-X Corporation
* With this, you will have two versions of svn on your machine. One is in `/usr/bin` under cygwin, and it is used for direct invocation at the bash command-line. The other is in `\Program Files`, and it is needed for getting repo versions when Bilder is invoked through Jenkins.  As of this writing, 1.9 is recommended (1.8 will also work, but lower versions will not).
260 1 Redmine Admin
261
~~~~~~
262 84 John Cary
$ where svn
263
C:\cygwin64\bin\svn.exe
264
C:\PROGRAM FILES\TORTOISESVN\bin\svn.exe
265
$ /usr/bin/svn --version | head -1
266 1 Redmine Admin
svn, version 1.9.7 (r1800392)
267 15 Redmine Admin
$ /cygdrive/c/Program\ Files/TortoiseSVN/bin/svn --version | head -n 1
268 1 Redmine Admin
svn, version 1.9.7 (r1800392)
269
~~~~~~
270
271
## Visual Studio
272 166 John Cary
273 1 Redmine Admin
* Visual Studio contains the Microsoft command-line compiler (cl) used by packages with C/C++ code.* 
274 166 John Cary
275 176 David Alexander
* Bilder uses VS2022 (MACHINE_FILE=${MACHINE_FILE:-"cygwin.llvm17_vs2022"}) by default.
276 166 John Cary
277 78 Ted Sume
* Visual Studio should not be in the system path. (Bilder adds this as needed.)
278 165 John Cary
279 166 John Cary
280 145 John Cary
### CUDA
281 166 John Cary
282 165 John Cary
* Bilder currently uses CUDA-11.8 by default, if is can find it.
283 1 Redmine Admin
284
~~~~~~
285 166 John Cary
BILDER_CUDA_FIND_VERSIONS=${BILDER_CUDA_FIND_VERSIONS:-"11.8 11.7 11.6 11.5 11.2 11.1 11.0 10.2 10.1"}
286 167 John Cary
~~~~~~
287
288 153 Ted Sume
# WSL on Windows 10 1909 or newer 
289
290
* From within an Administrator enable Powershell window, run the following
291
292
```
293
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
294
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
295
```
296
* Reboot the computer after running the above two commands from within Powershell
297
* Update Kernel for WSL2 by downloading and installing https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi
298
* Run the following command from within an Administrator enabled Powershell window to set the default WSL version to 2.
299
300
```
301
wsl --set-default-version 2
302
```
303
* Go to Microsoft store, search for preferred Linux distro, download and install per on screen instructions.
304 1 Redmine Admin
305
306
# Libraries (Required for most builds with Bilder)
307
308 85 John Cary
## OpenSSL
309
310 1 Redmine Admin
*OpenSSL is a security library needed by Python to build the SSL module, by cmake, libssh, and by Qt.*
311 85 John Cary
*We no longer install OpenSSL on Windows, as Bilder builds it to be consistent with the compiler in use."
312
313 1 Redmine Admin
### Legacy instructions.
314 75 John Cary
315 76 John Cary
* Download from http://slproweb.com/products/Win32OpenSSL.html
316 1 Redmine Admin
* Choose the Win64 OpenSSL v1.0.2n  (not Light) on 64bit or the Win32 OpenSSL v1.0.2n on 32bit windows.
317
* **The 1.1 series DOES NOT WORK with either libssh or Qt.**
318
* You may have to install Visual C++ Redistributables if the installer complains.
319
* During the installation, select "Copy OpenSSL DLLs to: The OpenSSL binaries (/bin) directory"
320
* After the installation on 64bit windows, goto C:\Windows\System32 and prepend libssl32.dll, libeay32.dll, and ssleay32.dll with an "OFF", if these files exist.  This and the next step are required so that dependency walker finds the SSL libs from the OpenSSL distro instead of the ones in C:\Windows\System32.
321 30 John Cary
* Add C:\OpenSSL-Win64 (in some cases, we have seen that C:\OpenSSL-Win64\bin should be added instead) or the directory where you installed OpenSSL to the beginning of the system path. In particular, it needs to be in front of the CollabNet path and the Intel client path, because both contain libeay32.dll. A which for the libeay32.dll should give this installed version. For example:
322
323 73 Tech-X Corporation
~~~~~~
324 127 Nathan Neri
which libeay32.dll
325
/cygdrive/c/OpenSSL-Win64/bin/libeay32.dll
326
~~~~~~
327
328
* If built software has unexplained crashes, recheck the above command results.
329
330
331
# Composer-related Libraries (only needed for building ComposerToolkit, can be skipped for documentation builds)
332
333 74 David Alexander
334 1 Redmine Admin
335 74 David Alexander
## Qt
336
337 142 David Alexander
*Qt is a cross-platform GUI library needed to build packages that have Qt-based user interfaces.*
338 1 Redmine Admin
339 142 David Alexander
Qt5 is the recommended version (the previous version, Qt4, instructions are also here too until Qt5 is solid).
340
341 159 David Alexander
### Installing Qt5
342 142 David Alexander
343 159 David Alexander
These instructions are how to install the pre-built version of Qt 5 (version 5.14.2).  You can skip creating the Qt account.
344
345 160 David Alexander
* Get Qt-5.14.2 from https://download.qt.io/archive/qt/5.14/5.14.2/qt-opensource-windows-x86-5.14.2.exe
346 1 Redmine Admin
* Run this program, selecting `<DRIVE>\winsame\winqt\5.14.2` as your installation directory, where DRIVE is the drive you have winsame on (e.g. D: or C:). (Bilder will find Qt5 if it is here)
347 160 David Alexander
* Expand the Qt 5.14.2 section and select the following components:
348 1 Redmine Admin
  * MSVC 2017 64-bit
349 142 David Alexander
  * UWP x64 (MSVC 2017)
350 160 David Alexander
  * Sources
351
  * Qt WebEngine
352
* Optionally, under Developer and Designer Tools, select:
353 142 David Alexander
  * Qt Creator 4.11.1 CDB Debugger Support
354
  * Qt Creator 4.11.1 is selected by default
355 143 David Alexander
* Accept all remaining defaults unless otherwise preferred
356 74 David Alexander
357 179 Ted Sume
Below are instructions for building and installing Qt 5.15.16  
358 178 Ted Sume
359
* Get Qt-5.15.16 from https://download.qt.io/official_releases/qt/5.15/5.15.16/single/qt-everywhere-opensource-src-5.15.16.zip
360
* Right Click on zip file downloaded above and select Extract All to extract source files and folders to e.g C:\Users\<username>\qt-5.15.16-source
361
* Assuming files were extracted to C:\Users\<username>\qt-5.15.16-source
362
  * Verify that python is available in your path as it is required to build qt
363
  * Verify that Visual Studio 2022 is installed. 
364
  * Launch a cmd prompt
365
  * Execute the following in command prompt
366
367
~~~~~~
368 180 Ted Sume
"C:\Program Files\Microsoft Visual Studio\2022\Professional\VC\Auxiliary\Build\vcvarsall.bat" amd64
369 178 Ted Sume
SET _ROOT=C:\Users\<username>\qt-5.15.16-source
370 1 Redmine Admin
SET PATH=%_ROOT%\qtbase\bin;%PATH%
371 179 Ted Sume
SET PREFIX=D:\winsame\winqt\5.15.16\5.15.16\msvc2022_64
372
cd C:\Users\<username>\qt-5.15.16-source
373 180 Ted Sume
configure -prefix %PREFIX%   -release -nomake examples -nomake tests -skip qtwebengine -opensource -confirm-license
374 178 Ted Sume
jom
375
jom install 
376
~~~~~~
377
378 41 John Cary
### Building and Installing Qt4
379 114 Nathan Neri
380 118 Nathan Neri
* Make sure no other Qt is in your system path.
381 41 John Cary
* Get the Qt Libraries from http://download.qt.io/archive/qt/4.8/4.8.7/. Download qt-opensource-windows-x86-vs2010-4.8.7.exe. (The vs2010 in the name is irrelevant as we will build Qt using the source code in this download.)
382 1 Redmine Admin
* Run this program, selecting C:\winsame\builds-XX\winqt\4.8.7 as your installation directory, where XX is the machines file suffix you use (e.g. vs2017).
383
* If 4.8.7, patch Qt by opening a Cygwin window:
384
385 100 John Cary
~~~~~~
386
cd /winsame/builds-vs12/winqt/4.8.7
387 106 John Cary
~~~~~~
388 100 John Cary
389
To build with VS2017, you may need to patch.  For this you will need python with the patch module installed, which you can obtain by running composerall, e.g., with target, python.  Then do
390 119 Nathan Neri
391 1 Redmine Admin
~~~~~~
392
/path/to/bilder/installed/python -m patch /path/to/bilder/patches/02-fix_build_with_msvc2015-45e8f4ee.diff
393 74 David Alexander
~~~~~~
394 1 Redmine Admin
395
#### Compiling Qt4
396
397
* The copy/paste-able commands below assume VS12.
398
399
In a Visual Studio x64 DOS window:
400 116 Nathan Neri
401
~~~~~~
402 120 Nathan Neri
set VER=2017
403
REM could be 12
404 1 Redmine Admin
set DRIVE=C:
405
REM or D:, if you're building there
406
set SFX=vs%VER%
407 120 Nathan Neri
REM or whatever machine suffix you will be building for, if using a combined compiler build
408 1 Redmine Admin
set QTVER=4.8.7
409
set INSTALL_DIR=%DRIVE%\winsame\builds-%SFX%\winqt\%QTVER%\%QTVER%\msvc%VER%_64
410 103 John Cary
~~~~~~
411 1 Redmine Admin
412 106 John Cary
Modify the last line as needed, e.g., different drive or subdir.
413 1 Redmine Admin
414 106 John Cary
Set the platform args according to your compiler.
415
416 101 John Cary
For VS2013 (VS12).
417 106 John Cary
418 101 John Cary
~~~~~~
419
set PLATFORM_ARGS=-platform win32-msvc2013
420 106 John Cary
~~~~~~
421 101 John Cary
422
For VS2015 or VS2017:
423 106 John Cary
424 101 John Cary
~~~~~~
425 1 Redmine Admin
set PLATFORM_ARGS=-platform win32-msvc2015
426
~~~~~~
427
428
Then
429 120 Nathan Neri
430
~~~~~~
431 116 Nathan Neri
%DRIVE%
432 1 Redmine Admin
cd %DRIVE%\winsame\builds-%SFX%\winqt\%QTVER%
433
configure.exe -prefix %INSTALL_DIR% -debug-and-release -opensource -confirm-license -fast -no-sql-db2 -no-sql-ibase -no-sql-mysql -no-sql-oci -no-sql-odbc -no-sql-psql -no-sql-sqlite -no-sql-sqlite2 -no-sql-tds -no-libtiff -webkit -declarative %PLATFORM_ARGS%
434
~~~~~~
435
436 106 John Cary
In a bash window launched from the previous DOS window (try `C:\cygwin64\bin\mintty -`, note that the dash is important!), execute the following (changing vsver to your version)
437 99 John Cary
438
~~~~~~
439 44 John Cary
export VER=12 # or 2017
440 115 John Cary
export SFX=vs${VER}
441
cd /winsame/builds-${SFX}/winqt/4.8.7
442 139 David Alexander
export INSTALL_DIR=/winsame/builds-${SFX}/winqt/4.8.7/4.8.7/msvc${VER}_64
443 128 Nathan Neri
mkdir -p ${INSTALL_DIR}
444
cp -R mkspecs ${INSTALL_DIR}
445 137 David Alexander
~~~~~~
446 128 Nathan Neri
447
Back in the Visual Studio x64 DOS window
448
449
~~~~~~
450 1 Redmine Admin
%DRIVE%
451
cd %DRIVE%\winsame\builds-%SFX%\winqt\4.8.7 
452 128 Nathan Neri
set PATH=%PATH%;%DRIVE%\winsame\builds-%SFX%\winqt\4.8.7\bin
453
nmake
454
REM Took 3.5 hours on a 2.3 GHz Core2 Duo with Solid State Drive
455
nmake install
456
REM Took 10 minutes on a 2.3 GHZ Core2 Duo with Solid State Drive
457 1 Redmine Admin
~~~~~~
458
459 142 David Alexander
* For CMake to find Qt, add INSTALL_DIR to your supra search path when configuring.
460
461 140 David Alexander
* If you want to use this qt outside of Bilder, add ${INSTALL_DIR}/bin to the system path variable.  This may not work if you have more than one Bilder run.
462
463
464
# Additional Useful Tools
465
466
## Notepad++
467
468
* (Optional) Notepad++ is a free source code editor that is a great tool for Windows.
469 1 Redmine Admin
* Download from http://notepad-plus-plus.org/
470 110 David Alexander
* Install and pin to your taskbar.
471
472
## Java
473
474
Java is needed for setting up the machine to be a Jenkins Slave.
475
476 111 David Alexander
* Download from https://www.java.com/en/download/  (Version 8 Update 181 has a Release date of July 17, 2018) 
477
* May get a message about the Java Plugin and Chrome. This does not affect the Jenkins slave service.
478 110 David Alexander
* Download the JNLP page from the Jenkins server site (link button with label "Launch agent from browser").
479
* Start a command prompt running as Administrator, then change to the Download directory and type "javaws slave-agent.jnlp" 
480 1 Redmine Admin
* Choose File -> "Install as a service" and follow the dialog messages.
481
482
# Experimental Tools and Libraries
483
484
These tools have not been fully vetted or built, so you need not do these.
485
486
## MinGW
487
488
See [[Installing MinGW]].
489
490
## ATLAS
491 8 Redmine Admin
492 131 John Cary
See [[Installing ATLAS on Windows]].
493
494
## OpenBLAS
495
496 1 Redmine Admin
See [[Installing OpenBlas on Windows]]
497 8 Redmine Admin
498 1 Redmine Admin
# Cygwin and Paths
499
500
(This section assumes the user is familiar with the relations between Cygwin and Windows paths.)
501
502
The path is critical for when there are conflicting executables.  This is the case for Subversion and OpenSSL.
503
504
The cygwin and Windows versions of svn are incompatible due to line endings, so care must be taken as to which is used at what time.
505
506
The path to cygwin's version of svn will be ahead of the Windows Subversion so as to allow users to checkout a project using /usr/bin/svn and never worry about the Windows version of svn.
507
508
The path to the installed OpenSSL needs to be in front of the path to Subversion because during the copying in of OpenSSL libraries depends needs to find the ones in the OpenSSL installation not the Subversion installation.
509
510
## Usage under Jenkins
511
512
Jenkins uses `svnkit`, which is compatible with the Windows version of Subversion of the same version number.  So for jenkins usage, one must have the same version of `svn` installed across all slaves, and when `Bilder` runs under Jenkins, it must be sure to use the Windows version of `svn`.  There are two methods for doing this.  First, `bilder/jenkins/jenkinsbild` defines the environment variables, `BILDER_SVN`, `BILDER_SVNDIR`, and `BLDR_SVNVERSION`, which hold the correct executables to be used by `Bilder`.  However, in the configuration of some packages, notably VisIT in `visit.sh`, the path is used to find `svn`, and this gives the wrong executable.  For these cases, the path is modified just before configuration.
513
514
515
## Summary
516
517
* Bilder moves `/usr/bin` to just after the Python path and therefore to before
518
  `/cygdrive/c/Windows/system32`.
519
* Put the Windows Subversion path behind the Python path (and so behind `/usr/bin`).
520
    - `/usr/bin` must be removed from the path when configuring some packages in order to get the correct subversion when building under Jenkins.
521
522
# Bilder machine files for cygwin
523
524
The Bilder machine file for cygwin and Visual Studio 2013 (VS12) is bilder/machines/cygwin.vs12. It is sourced by bilder using the -m option. It augments PATH and sets the values of the INCLUDE, LIB, and LIBPATH variables.
525
526
In case of problems, one should check that the values of these were set correctly. This is done by starting up the **Visual Studio Command Prompt**, then starting rxvt as noted above. The values for or additions to these variables should agree with how they are being set or modified by the cygwin machine files.
527
528
# Setup for making Installers
529
530
## Visual Studios Redistributables
531
532
Download vcredist_x64.exe (Visual C++ Redistributable Packages for Visual Studio 2013)
533
534 161 David Alexander
http://www.microsoft.com/en-gb/download/details.aspx?id=40784
535 1 Redmine Admin
536
Choose only vcredist_x64.exe executable from list. This should put vcomp120.dll in C:\Windows\System32\
537
538
## Sign Tools
539
540
* The Microsoft Signtool comes with Visual Studio, however, one must install a code-signing certificate. This process is site-specific so please see your system administrator.
541
* Contrary to what signtool says, the capicom dll must be copied from C:\Program Files\Microsoft SDKs\Windows\v6.0A\bin to C:\Windows\System32 and must be registered by typing the following at a Command Prompt run as Administrator: 
542 74 David Alexander
543
~~~~~~
544
cd C:\Windows\System32
545
REGSVR32 capicom.dll
546
~~~~~~
547
548
## NSIS
549 1 Redmine Admin
550
NSIS is a scriptable installer maker.
551 131 John Cary
552
* Install NSIS from [NSIS Download Site](http://nsis.sourceforge.net/Download).
553 88 John Cary
  * For building CMake 64bit and if you are building the composers, you will need a generator for installer executables, which is NSIS (Nullsoft Scriptable Install System) a professional open source system to create Windows installers.
554 74 David Alexander
  * Version 2.46 is available as of Aug 21, 2011.
555
* Add `C:\Program Files (x86)\NSIS\Bin` to your system path.
556
557
* Install NSIS Access Control Plugin from [Access Control Plugin Site](http://nsis.sourceforge.net/AccessControl_plug-in).
558
559
Copies directories and files into the NSIS installation as follows:
560
561
~~~~~~
562 1 Redmine Admin
AccessControl.zip\Contrib\AccessControl --> NSIS\Contrib\AccessControl
563
AccessControl.zip\Docs\AccessControl --> NSIS\Docs\AccessControl
564
AccessControl.zip\Plugins\AccessControl.dll --> NSIS\Plugins\x86-ansi\AccessControl.dll
565
AccessControl.zip\Unicode\Plugins\AccessControl.dll --> NSIS\Plugins\x86-unicode\AccessControl.dll
566 155 David Alexander
~~~~~~
567
568
569
# Path
570
571 156 David Alexander
The resulting Windows PATH should look like this...
572 155 David Alexander
573 1 Redmine Admin
![](windowsPath.png)
574
575
# Notes For Development
576
577 154 Ted Sume
[[Notes on debugging Windows executables]]
578 1 Redmine Admin
[[Notes on deleting directories and files owned by other users]]
579
[[Notes on enabling and disabling the Windows Firewall from the command line]]