Project

General

Profile

Preparing a Windows machine for Bilder » History » Version 78

Ted Sume, 01/17/2018 03:06 PM

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 22 Matt Copper
Windows 7/2008: For 64-bit systems, 64-bit applications are stored in C:\Program Files and 32-bit applications are stored in C:\Program Files (x86). UserAccountControlSettings can be fine-tuned (see Control-Panel, System and Security, Action Center). Set Control Setting to the lowest setting (never notify) to avoid unwanted dialog boxes. This requires a reboot to take effect! At least for ATLAS, the UAC Settings must be adjusted to "never notify" (this action is generally recommended while taking all the steps below). 
6 1 Redmine Admin
7
# Basic Windows Configuration
8
9
_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.
10
11
# Editing your system path on Windows
12
13
From the Start menu, right click on My Computer and choose Properties. Choose the Advanced Tab, and click the Environment Variables button towards the bottom of the dialog. In System Variables, highlight Path and click Edit. This is where you make changes to your system path.
14
15
# Ensure that Windows knows its domainname
16
17
* From a command prompt, type the command: 
18
19
~~~~~~
20
ipconfig /all
21
~~~~~~
22
23
Look for value of the "Primary Dns Suffix" field, which should be your domain name (i.e. txcorp.com).
24
25
* If cygwin is already installed,
26
27
~~~~~~
28
ipconfig /all | grep -i "Primary Dns Suffix" | sed -e 's/^.*: //'
29
~~~~~~
30
31
should return the domainname. This only applies if it is part of a Windows Domain.
32
33
* For Windows 7/Windows 2008 machines that are not a member of the Windows Domain, Active Directory, do the following:
34
    1. Right click on My Computer, select properties
35
    2. Click on Advanced system settings
36
    3. Select the computer name tab
37
    4. Click the change button
38
    5. Click the more button
39
    6. Enter the Primary DNS suffix. i.e. txcorp.com 
40
41
# Create initial directories
42
43
* Create the folder C:\\bin (if not already present).
44
* Add or move C:\\bin to the front of your system path.
45
46 74 David Alexander
# What is "Required" for Bilder
47 1 Redmine Admin
48 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
49 37 John Cary
50 74 David Alexander
* Blat (for emailing yourself)
51 36 John Cary
* Cygwin (for bash shell)
52 1 Redmine Admin
* CMake from an installer
53 38 John Cary
* Python from an installer
54
* Latex (MikTek below)
55 1 Redmine Admin
* Visual Studio Express (for nmake)
56 36 John Cary
57 1 Redmine Admin
and then you can add the arguments,  -W python,cmake, and your installed Python and CMake will be used if your path is correct.
58
59 74 David Alexander
Below is a list of the Tools and Libraries that are most often needed.
60
61
# Tools (Required for most common builds within Bilder)
62
63 1 Redmine Admin
## Blat
64
65 74 David Alexander
*Blat is a sendmail client for Windows needed to send emails.*
66 1 Redmine Admin
67
* Download Blat from [The Blat SourceForge](http://sourceforge.net/projects/blat) Site and extract all files. As of 07/18/2013, this is version 311.
68
* Extract the blat311 folder into C:\\bin.
69
* Copy the C:\bin\blat311\full\blat.{exe,dll} to C:\bin\blat.{exe,dll}
70
* Execute the following command in a cygwin terminal
71
72
~~~~~~
73
    blat -install mail.txcorp.com <username>@txcorp.com
74
~~~~~~
75
76
## CMake
77
78 74 David Alexander
*CMake is a cross-platform build system needed to configure many of necessary packages.*
79 1 Redmine Admin
80
* Install [CMake (a 32-bit application)](http://www.cmake.org/files/).
81 10 Redmine Admin
  * Version 2.8.6 is required.  Later versions work also.
82 26 John Cary
  * Add the CMake path to the front of the system path! (Needed to build newer 64 bit versions through Bilder)
83 1 Redmine Admin
  * When this step is complete, make sure the newest CMake is the only one in your system path.
84
85 10 Redmine Admin
## CYGWIN
86 1 Redmine Admin
87 74 David Alexander
*Cygwin is a Unix shell program for Windows and is needed to run the bash code of Bilder.*
88
89 1 Redmine Admin
### Gotchas (in advance)
90
91
* Do not install Cygwin's MinGW. Those are installed in a separate area to reduce conflicts.
92
* Do not install Cygwin's rc, or you may get a weird error (/focmTryCompileExec.exe.embed.manifest.res: No such file or directory) about cl being invalid.  This can be seen by the output of 'which rc'.
93
* Do not install Cygwin's mt.  If 'which mt' returns /bin/mt or /usr/bin/mt, then move this aside too.
94 11 Redmine Admin
* 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.)
95 1 Redmine Admin
* Make sure that 'which find' returns the cygwin version (/usr/bin/find), not the Windows version.
96
* Make sure 'which cmd' returns the Windows version. If not, check that your bash_profile has not made an error in setting your path.
97
* If you get an error like "ValueError: Symbol table not found" when building numpy, you are somehow using a 32-bit version of objdump.  Disable the 32-bit version.
98
99
### Updating Cygwin
100
101
* Be sure to select the version of subversion that is compatible with any other sister machines being run through jenkins.  They must all use the same version of svn, which must be the same version chosen in Jenkins.
102
* If you have moved aside any of the interfering commands (e.g. link, mt, rc) in the past and have recently updated cygwin or Windows, then do the 'which' checks again.
103
* Recreate the /etc/passwd and /etc/group file again using the mkpasswd and mkgroup commands described in the Configuring Cygwin section.
104
* Install Cygwin from [here](http://cygwin.com/install.html). There are now separate installers for 64 bit (setup-x86_64.exe ) and 32 bit (setup-x86.exe).
105
* Upon running setup-*.exe, select the packages:
106 3 Redmine Admin
  * Base -> util-linux
107
  * Devel -> bison
108
  * Devel -> flex
109 4 Redmine Admin
  * Devel -> gcc-g++ and gcc-fortran (4.9.3 does not compile sqlite, so choose 4.9.2)
110 3 Redmine Admin
  * Devel -> git
111
  * Devel -> make
112
  * Devel -> mercurial
113 1 Redmine Admin
  * Devel -> patch
114 27 John Cary
  * Devel -> subversion (If this machine will be a Jenkins slave, the version of subversion that is consistent with the Jenkins master's svnkit should be chosen. The latest version supported by svnkit is 1.8.14 at the time, Dec. 31, 2016, of this writing.)
115 3 Redmine Admin
  * Editors -> vim and emacs (and alternate editors of choice)
116
  * Math -> bc
117
  * Net -> openssh
118 25 Matt Copper
  * Net -> curl
119 3 Redmine Admin
  * Python -> python (see note below)
120
  * Shells -> mintty
121
  * Utils -> diffutils
122
  * Utils -> dos2unix
123
  * Web -> wget
124 1 Redmine Admin
125
* Do NOT install any of the mingw packages.  If used, they must be installed separately to overcome path issues.  (NumPy will not accept the different, distinguishing name for mingw's gcc).
126
127
* Note: PATH should be set such that the Windows python is found before the cygwin python. We need the cygwin python to build PETSc. Once PETSc is cmaked, this requirement will go away.
128
* Note: mkshortcut.exe in cygutils 1.4.10-2 is broken, but as of (July 18, 2013 with cygutils version 1.4.12 this is fixed).  If the version of mkshortcut.exe that is installed when you run setup.exe doesn't work (i.e. mkshortcut -h segfaults), then go bach to cygwin setup and update your cygutils.
129
130
### Setting Cygwin Disk Mounts
131
132
* 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:
133
134
~~~~~~
135
mkdir /cygdrive/c/winsame
136
mkdir /winsame
137
mount C:/winsame /winsame
138
~~~~~~
139
140
To make this permanent, put
141
142
~~~~~~
143
C:/winsame /winsame ntfs binary 0 0
144
~~~~~~
145
146
as one line in /etc/fstab.
147
148
On Windows-64, additionally put
149
150
~~~~~~
151
C:/Program\040Files\040(x86) /ProgramFilesX86 ntfs binary 0 0
152
~~~~~~
153
154
as one line in /etc/fstab.  This allows one to construct a valid path with no parentheses as needed for ATLAS.
155
156
### Configuring Cygwin
157
158 6 Redmine Admin
* Use a "Cygwin64 Terminal" from basic cygwin installation above to perform all subsequent bash tasks
159 1 Redmine Admin
160
* If bilderizing a domain machine, create an /etc/passwd file with the following command
161
162
~~~~~~
163
mkpasswd -l -d -p /winsame > /etc/passwd
164
~~~~~~
165
166 71 Tech-X Corporation
* Add a single domain user to an already created /etc/password:
167
168
~~~~~~
169
mkpasswd -l -d -u {username} -p /winsame >> /etc/passwd
170
~~~~~~
171
172 1 Redmine Admin
* If bilderizing a non-domain machine, create an /etc/passwd file with the following command
173
174
~~~~~~
175
mkpasswd -l -p /winsame > /etc/passwd
176
~~~~~~
177
178
* If bilderizing a domain machine, create an /etc/group file with the following command
179
180
~~~~~~
181
mkgroup -l -d > /etc/group
182
~~~~~~
183
184
* If bilderizing a non-domain machine, create an /etc/group file with the following command
185
186
~~~~~~
187
mkgroup -l > /etc/group
188
~~~~~~
189
190
* Close the terminal and open a new one. You should see that the 'pwd' command shows that you are in a new home area directory: /winsame/<username>. Copy bash profile files from /home to /winsame and delete the previous home area for each user with the commands:
191
192
~~~~~~
193
cp /home/<username>/.* /winsame/<username>/
194
rm -rf /home/<username>
195
~~~~~~
196 52 John Cary
197 1 Redmine Admin
## Dependency Walker
198 52 John Cary
199 74 David Alexander
*Dependency Walker shows the DLL's that an executable depends on and is needed to find and copy-in DLLs to a final distribution.*
200 52 John Cary
201 1 Redmine Admin
__Make sure you download and install the correct version of dependencywalker for your machine (x86 for x86 machines, x64 for 64bit machines, etc).__
202 5 Redmine Admin
203 52 John Cary
Install [Dependency Walker](http://www.dependencywalker.com/) into C:\\bin.
204 1 Redmine Admin
205
## JOM
206
207 74 David Alexander
*JOM is an nmake wrapper needed to give  the -j flag capability of Unix make for faster compilation.*
208 1 Redmine Admin
209
* Create the folder C:\bin (if not already present).
210
* Add C:\bin to your system path (if not already there).
211
* Download jom.zip from [the Qt Project](https://wiki.qt.io/Jom).
212
* Extract the contents of jom.zip
213
* Move/copy jom.exe to C:\bin (you then can delete the remainder of the contents or keep for historical reasons).
214
215
## LaTeX
216
217 74 David Alexander
*LaTeX is a typesetting tool needed for building PDF files for user documentation.*
218 1 Redmine Admin
219
* Install [Doxygen](http://www.stack.nl/~dimitri/doxygen/download.html).
220 77 John Cary
* Install Basic MikTeX from [MikTeX](http://miktex.org/). Use the MikTeX Package Manager to install breakurl capt-of cmap comment courier ec eepic environ epstopdf eqparbox fancybox fancyvrb framed footnote framed fricychap gensymb helvetic latexmk lineno mdwtools mmap mptopdf multirow newfloat overpic palatino parskip pdftex pifont revtex4 siunitx subfiles symbol tabulary threeparttable titlesec trimspaces txfonts units upquote url wrapfig xcite xcolor xypic zapfding
221 1 Redmine Admin
* In MikTex Settings application (start from StartMenu), under the General tab, choose "Yes" for "Install missing packages on-the-fly". This ensures that builds won't hang waiting for user to dismiss install package dialogs.
222
* Install [ghostscript](http://sourceforge.net/projects/ghostscript/files/GPL%20Ghostscript/9.04/).
223
224
225
## MPI
226
227 74 David Alexander
*MPI is a message passing interface for parallel code that is needed for some computation engines.*
228
229 1 Redmine Admin
Download the HPC Pack 2008 R2 (Service Pack 4 as of March 2016) from:
230
231
https://www.microsoft.com/en-us/download/details.aspx?id=29992
232
233
The 64bit installer is named HPC2008R2-SP4-Update-x64.zip (the monitor pack & integration pack are separate and optional).
234
235
The installers will put mpiexec in your path, but you will need to restart any cygwin shells and the Jenkins slave to make this active.
236
237
238
## Perl
239
240 74 David Alexander
*Perl is a programming language needed by some packages such as Qt*
241 1 Redmine Admin
242
* Download and install [ActiveState Perl](http://www.activestate.com/activeperl/downloads).
243
244
## Python
245
246 74 David Alexander
*Python is a programming language needed by many packages. Namely, any Python module needs Python to be installed.*
247
248 14 Redmine Admin
* As of VS12, bilder builds Python from a checkout of a git repo and no longer needs to be installed by hand. No PATH changes are needed either.
249 1 Redmine Admin
250
## Subversion
251
252 74 David Alexander
*Subversion is a revision control tool needed by bilder, for example, to know when packages are out of date.*
253
254 1 Redmine Admin
* Install the CollabNet Subversion Command-Line Client from [The CollabNet Download Site](http://www.open.collab.net/downloads/subversion/).
255
256
Tech-X users may use the Tech-X login available at the [Tech-X internal accounts page](https://internal.txcorp.com/it/wiki/techxAccounts).
257
258 34 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. You can verify this with:
259 33 Tech-X Corporation
260 1 Redmine Admin
~~~~~~
261
$ where svn
262
  C:\cygwin64\bin\svn.exe
263
  C:\Program Files\CollabNet\Subversion Client\svn.exe
264
$ /bin/svn --version | head -n 1
265
  svn, version 1.7.14 (r1542130)
266
$ /cygdrive/c/Program\ Files/CollabNet/Subversion\ Client/svn --version | head -n 1
267
  svn, version 1.7.18 (r1615261)
268 15 Redmine Admin
~~~~~~
269 1 Redmine Admin
270
## Visual Studio
271 15 Redmine Admin
272 74 David Alexander
*Visual Studio contains the Microsoft command-line compiler (cl) used by packages with C/C++ code.* 
273
274 1 Redmine Admin
* Bilder works with VS12 (Visual Studio 2013). Since code is moving to C++11 standards, VS12 is required. We recommend you remove older versions of VS such as VS10 and VS9.
275
276
    * VS12: Visual Studio 2013 Community Edition from Microsoft [VS12 Download Site](https://www.visualstudio.com/en-US/products/visual-studio-community-vs)
277
278
* Install the latest update for Visual Studio. Open Visual Studio application. Going to Help -> About Microsoft Visual Studio, should show you the update version installed. As of July 2015 it is as Update 5. To update go to [Visual Studio Update Download](http://www.microsoft.com/en-us/download/details.aspx?id=48129).
279
280
* Ensure that Visual Studio is not in the system path. (Bilder adds this as needed.)
281 7 Redmine Admin
282 26 John Cary
### Compatibility with Python
283 7 Redmine Admin
284 1 Redmine Admin
* Python is built by Bilder.
285
286 78 Ted Sume
### Compatibility with CUDA 9.1 
287
* CUDA version 9.1 requires the use of Microsoft Visual Studio 2017 v15.4.5. See [VS2017 Prior Release Download Site](https://www.visualstudio.com/en-us/productinfo/installing-an-earlier-release-of-vs2017) for instructions on downloading a specific Release.
288
289 74 David Alexander
# Libraries (Required for most builds with Bilder)
290 1 Redmine Admin
291
## OpenSSL
292
293 75 John Cary
*OpenSSL is a security library needed by Python to build the SSL module, by libssh, and by Qt.*
294 1 Redmine Admin
295
* Download from http://slproweb.com/products/Win32OpenSSL.html
296 75 John Cary
* Choose the Win64 OpenSSL v1.0.2n  (not Light) on 64bit or the Win32 OpenSSL v1.0.2n on 32bit windows.
297 76 John Cary
* **The 1.1 series DOES NOT WORK with either libssh or Qt.**
298 1 Redmine Admin
* You may have to install Visual C++ Redistributables if the installer complains.
299
* During the installation, select "Copy OpenSSL DLLs to: The OpenSSL binaries (/bin) directory"
300
* 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.
301
* 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:
302
303 30 John Cary
~~~~~~
304
which libeay32.dll
305 1 Redmine Admin
/cygdrive/c/OpenSSL-Win64/bin/libeay32.dll
306 73 Tech-X Corporation
~~~~~~
307 30 John Cary
308 1 Redmine Admin
* If built software has unexplained crashes, recheck the above command results.
309
310 74 David Alexander
## Qt
311 1 Redmine Admin
312 74 David Alexander
*Qt is a cross-platform GUI library needed to build packages that have Qt-based user interfaces.*
313
314
Either Qt4 or Qt5 (or both) can be added. Typically only one will be needed.
315
316
###  [Building and Installing Qt4](#qt4)
317
318 41 John Cary
* Make sure no other Qt is in your system path.
319 42 John Cary
* Get the Qt Libraries from http://download.qt.io/official_releases/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.)
320 41 John Cary
** Version 5.6.1: from http://download.qt.io/official_releases/qt/5.6/5.6.1/qt-opensource-windows-x86-msvc2013_64-5.6.1.exe
321
* Run this program, selecting C:\winsame\builds-vsXX\winqt\<version> as your installation directory, where XX is the version of your Visual Studio.
322
* If 4.8.7, patch Qt by opening a Cygwin window:
323 1 Redmine Admin
324
~~~~~~
325
cd /winsame/builds-vs12/winqt/4.8.7
326 26 John Cary
patch -p1 --binary < /path/to/bilder/patches/qt-4.8.7.patch
327 1 Redmine Admin
~~~~~~
328
329 74 David Alexander
#### Compiling Qt4
330 1 Redmine Admin
331
* The copy/paste-able commands below assume VS12.
332
333
In a Visual Studio x64 DOS window:
334
335
~~~~~~
336
set VER=12
337
set SFX=vs%VER%
338 42 John Cary
set QTVER=4.8.7
339 64 John Cary
set CONTRIB_DIR=C:\winsame\contrib-%SFX%
340
~~~~~~
341
342
Modify the last line as needed, e.g., different drive or subdir.  Then
343
344
~~~~~~
345 1 Redmine Admin
cd C:\winsame\builds-%SFX%\winqt\%QTVER%
346
configure.exe -prefix %CONTRIB_DIR%\qt-%QTVER%-sersh -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
347 64 John Cary
~~~~~~
348 1 Redmine Admin
349
(NOTE: If you are building with Visual Studio 2008, then you'll need to add the following arguments to the above command: -platform win32-msvc2008)
350
351 2 Redmine Admin
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)
352 1 Redmine Admin
353
~~~~~~
354
export VER=12
355
export SFX=vs${VER}
356
cd /winsame/builds-${SFX}/winqt/4.8.7
357 26 John Cary
mkdir -p /winsame/contrib-${SFX}/qt-4.8.7-sersh
358
cp -R mkspecs /winsame/contrib-${SFX}/qt-4.8.7-sersh
359 1 Redmine Admin
cd /winsame/contrib-${SFX}
360 26 John Cary
ln -s qt-4.8.7-sersh qt-sersh
361
mkshortcut.exe -n qt-sersh.lnk qt-4.8.7-sersh
362 1 Redmine Admin
~~~~~~
363
364
In the Visual Studio x64 DOS window
365
366
~~~~~~
367
set VER=12
368
set SFX=vs%VER%
369 26 John Cary
cd C:\winsame\builds-%SFX%\winqt\4.8.7 
370
set PATH=%PATH%;C:\winsame\builds-%SFX%\winqt\4.8.7\bin
371 1 Redmine Admin
nmake         # Took 3.5 hours on a 2.3 GHz Core2 Duo with Solid State Drive
372
nmake install # Took 10 minutes on a 2.3 GHZ Core2 Duo with Solid State Drive
373
~~~~~~
374
375
* If you want to use this qt outside of Bilder, add C:\winsame\contrib-%SFX%\qt-4.8.7-sersh\bin to the system path variable.  This may not work if you have more than one Bilder run.
376
377
In the bash window, then execute
378
379
~~~~~~
380
/path/to//bilder/setinstald.sh -i /winsame/contrib-$SFX qt,sersh
381 43 John Cary
~~~~~~
382 42 John Cary
383 74 David Alexander
### [Building and Installing Qt5](#qt5)
384 42 John Cary
385 44 John Cary
* Ruby, http://rubyinstaller.org/, must be installed first.
386 42 John Cary
* Make sure no other Qt is in your system path.
387 70 John Cary
* Get the Qt Libraries from http://download.qt.io/official_releases/qt/5.9/5.9.3/qt-opensource-windows-x86-5.9.3.exe
388
* Run this program, selecting `C:\winsame\builds-vsXX\winqt\5.9.3` as your installation directory, where XX is the version of your Visual Studio.
389 66 John Cary
* Be sure to install Sources and WebEngine.
390 42 John Cary
391 74 David Alexander
#### Compiling Qt5
392 42 John Cary
393 68 John Cary
* The copy/paste-able commands below assume VS2017.
394 42 John Cary
395
In a Visual Studio x64 DOS window:
396
397 1 Redmine Admin
~~~~~~
398 68 John Cary
set VER=2017
399 42 John Cary
set SFX=vs%VER%
400 1 Redmine Admin
set QTVER=5.9.3
401 68 John Cary
set CONTRIB_DIR=C:\winsame\contrib-%SFX%
402 70 John Cary
set CONTRIB_DIR
403 55 John Cary
~~~~~~
404 56 John Cary
405 70 John Cary
Examine the output of the last command to make sure you have the supra-installation directory correct.
406 56 John Cary
407 55 John Cary
~~~~~~
408 68 John Cary
cd C:\winsame\builds-%SFX%\winqt\%QTVER%\%QTVER%\Src
409 69 John Cary
configure.bat -prefix %CONTRIB_DIR%\qt-%QTVER%-sersh -opensource -confirm-license -release -shared -opengl desktop -no-separate-debug-info -developer-build -make-tool jom -make libs -make tools -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-libjpeg -no-qml-debug -no-dbus -no-incredibuild-xge -no-directwrite -nomake examples -nomake tests -skip qtandroidextras -skip qtdoc -skip qtlocation -skip qtscript -skip qtserialbus -skip qtserialport -skip qtsensors -skip qtwayland -skip qtspeech
410 1 Redmine Admin
jom         # Took 45 minutes on a 4-core i7
411 47 John Cary
jom install # Took 8 minutes on a 4-core i7
412 1 Redmine Admin
~~~~~~
413
414 70 John Cary
Check that your installation contains Qt5WebEngine.
415 1 Redmine Admin
416 70 John Cary
We had to further make the following changes.
417
418 1 Redmine Admin
~~~~~~
419 60 John Cary
$ diff QtGui QtGui.orig
420 1 Redmine Admin
55c55
421
< // #include "qopenglextrafunctions.h"
422
---
423
> #include "qopenglextrafunctions.h"
424
$ diff qopengl.h qopengl.h.orig
425
108c108
426 60 John Cary
< // #  include <QtGui/qopengles2ext.h>
427
---
428
> #  include <QtGui/qopengles2ext.h>
429
~~~~~~
430
431
The VisIt team also uses the following.
432
433
~~~~~~
434
-mp -ltcg
435
~~~~~~
436 58 David Howdle
437 62 John Cary
### Completing installation
438 61 John Cary
439
In a bash window:
440
441
~~~~~~
442 58 David Howdle
export VER=2017
443 1 Redmine Admin
export SFX=vs${VER}
444
export QTVER=5.9.3
445
export CONTRIB_DIR=/winsame/contrib-%SFX%
446
echo $CONTRIB_DIR
447
~~~~~~
448
449 70 John Cary
Check that `CONTRIB_DIR` has the same value as before in the cmd shell, up to OS differences.  Then
450 1 Redmine Admin
451 70 John Cary
~~~~~~
452
/path/to//bilder/setinstald.sh -i $CONTRIB_DIR qt,sersh
453
cd $CONTRIB_DIR
454
ln -s qt-$QTVER-sersh qt-sersh
455
mkshortcut -n qt-sersh.lnk qt-$QTVER-sersh
456
~~~~~~
457
458 74 David Alexander
# Addition Useful Tools
459 70 John Cary
460 74 David Alexander
## Notepad++
461
462
* (Optional) Notepad++ is a free source code editor that is a great tool for Windows.
463
* Download from http://notepad-plus-plus.org/
464
* Install and pin to your taskbar.
465
466 1 Redmine Admin
# Experimental Tools and Libraries
467
468
These tools have not been fully vetted or built, so you need not do these.
469
470
## MinGW
471
472
See [[Installing MinGW]].
473
474
## ATLAS
475
476
See [[Installing ATLAS on Windows]].
477
478
# Cygwin and Paths
479 8 Redmine Admin
480 1 Redmine Admin
(This section assumes the user is familiar with the relations between Cygwin and Windows paths.)
481 8 Redmine Admin
482 1 Redmine Admin
The path is critical for when there are conflicting executables.  This is the case for Subversion and OpenSSL.
483
484
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.
485
486
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.
487
488
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.
489
490
## Usage under Jenkins
491
492
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.
493
494
495
## Summary
496
497
* Bilder moves `/usr/bin` to just after the Python path and therefore to before
498
  `/cygdrive/c/Windows/system32`.
499
* Put the Windows Subversion path behind the Python path (and so behind `/usr/bin`).
500
    - `/usr/bin` must be removed from the path when configuring some packages in order to get the correct subversion when building under Jenkins.
501
502
# Bilder machine files for cygwin
503
504
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.
505
506
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.
507
508
# Setup for making Installers
509
510
## Visual Studios Redistributables
511
512
Download vcredist_x64.exe (Visual C++ Redistributable Packages for Visual Studio 2013)
513
514
http://www.microsoft.com/en-gb/download/details.aspx?id=40784
515
516
Choose only vcredist_x64.exe executable from list. Put executable in C:\bin.
517
518
## Sign Tools
519
520
* 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.
521
* 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: 
522
523
~~~~~~
524
cd C:\Windows\System32
525
REGSVR32 capicom.dll
526 74 David Alexander
~~~~~~
527
528
## NSIS
529
530
NSIS is a scriptable installer maker.
531
532
* Install NSIS from [NSIS Download Site](http://nsis.sourceforge.net/Download).
533
    * 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.
534
    * Version 2.46 is available as of Aug 21, 2011. 
535
536
* Install NSIS Access Control Plugin from [Access Control Plugin Site](http://nsis.sourceforge.net/AccessControl_plug-in).
537
538
Copies directories and files into the NSIS installation as follows:
539
540
~~~~~~
541
AccessControl.zip\Contrib\AccessControl --> NSIS\Contrib\AccessControl
542
AccessControl.zip\Docs\AccessControl --> NSIS\Docs\AccessControl
543
AccessControl.zip\Plugins\AccessControl.dll --> NSIS\Plugins\x86-ansi\AccessControl.dll
544
AccessControl.zip\Unicode\Plugins\AccessControl.dll --> NSIS\Plugins\x86-unicode\AccessControl.dll
545 1 Redmine Admin
~~~~~~
546
547
# Notes For Development
548
549
[[Notes on debugging Windows executables]]
550
[[Notes on deleting directories and files owned by other users]]