{"type":"doc","content":[{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"For notes on Installation see ","type":"text"},{"text":"this topic","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2065335545"}}]}]}]},{"type":"paragraph","content":[{"text":"Building the SP consists of downloading and (usually) building the dependencies and then building the Shibboleth components.","type":"text"}]},{"type":"paragraph","content":[{"text":"This process is entirely performed from the command line using the ","type":"text"},{"text":"nmake","type":"text","marks":[{"type":"code"}]},{"text":" utility.","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"maxLevel":{"value":"3"}},"macroMetadata":{"macroId":{"value":"1b1ca5e8-59db-4e68-b46a-fbce1703be46"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"491b5028-7e9f-4ee9-b5a9-cc5e940e4deb"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Environment","type":"text"}]},{"type":"paragraph","content":[{"text":"All building is done from within a Visual C command line. The 64 bit builds for the dependencies should be done from a 64 bit environment and likewise the 32 bit. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Both architectures (32/64) for the Shibboleth components are built at the same time and this can be done from either a 32 bit or 64 bit command line..","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Directory layout","type":"text"}]},{"type":"paragraph","content":[{"text":"Everything is built under a common directory referred to as the root directory. The shibboleth products (xmltooling, OpenSAML and the SP) have fixed names (cpp-xmtooling, cpp-opensaml, cpp-sp), and the build is managed from the cpp-msbuild subdirectory. The names of the dependency directories can be controlled by the environmental variables.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Environmental variables","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"7b2f2834-4a7a-4613-ab73-de8d739bf4f7"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":4,"rowspan":1,"colwidth":[191.61,176.69,202.61,644.73]},"content":[{"type":"paragraph","content":[{"text":"General Environment","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"Default","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"Used to build...","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"ROOT_DIR","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"everything","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The location of the build","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"SED","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"sed","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"ZLIB","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The location of the sed command","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"PERL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"perl","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"OpenSSL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The location of the perl command","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"Zlib ENVIRONMENT","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"Default","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"Used to build...","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"ZLIB_DIR","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"zlib-1.2.11","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"ZLIB, Shib DLLs, Installer","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The name of the directory with the xlib sources","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"ZLIB_IMPLIB","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"ZLIB","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The name of the zlin library (hence ","type":"text"},{"text":"zlib1.lib","type":"text","marks":[{"type":"code"}]},{"text":")","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"ZLIB_MM_VERSION","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"1.2.11","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"Installers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The version given to the zlib MergeModule","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"ZLIB_FILE_VERSION","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"1_2_11","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"Installlers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The garnish added to the DLL(hence ","type":"text"},{"text":"zlib1_2_11.dll","type":"text","marks":[{"type":"code"}]},{"text":"). Changing this requires changes to ","type":"text"},{"text":"versions.props","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"Log4Shib ENVIRONMENT","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"Default","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"Used to build...","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"LOG4SHIB_DIR","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"cpp-log4shib","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"Log4Shib, Shib DLLs, Installers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The name of the directory with the log4shib sources.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"LOG4SHIB_FILE_VERSION","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"1_0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"Installers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The garnish added to the DLL (hence ","type":"text"},{"text":"log4shib1_0D.dll","type":"text","marks":[{"type":"code"}]},{"text":"). Changing this requires changes to ","type":"text"},{"text":"versions.props","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"LOG4SHIB_MM_VERSION","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"Installers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The version given to the Log4Shib MergeModule","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":4,"rowspan":1,"colwidth":[191.61,176.69,202.61,644.73]},"content":[{"type":"paragraph","content":[{"text":"OpenSLL ENVIRONMENT","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"Default","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"Used to build...","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"OPENSSL_DIR","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"openssl-1.1.0g","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"OpenSSL","type":"text"},{"type":"hardBreak"},{"text":"All Shib DLLs","type":"text"},{"type":"hardBreak"},{"text":"Installers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The name of the directory with the OpenSSL sources.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"OPENSSL_FILE_VERSION","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"1_1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"Installers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The garnish added to the OpenSSL DLLs (hence ","type":"text"},{"text":"libcrypto-1_1.dll","type":"text","marks":[{"type":"code"}]},{"text":"). Changing this requires changes to ","type":"text"},{"text":"versions.props","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"NOTE","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"If this is changed then a different version of Santuario should be built (if it is not being independently revised).","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"The version can be changed in ","type":"text"},{"text":"xsec\\framework\\version.rc","type":"text","marks":[{"type":"code"}]},{"text":" usually changing the fourth digit suffices.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"OPENSSL_MM_VERSION","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"Installers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The version given to the OpenSSL MergeModule","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":4,"rowspan":1,"colwidth":[191.61,176.69,202.61,644.73]},"content":[{"type":"paragraph","content":[{"text":"Curl ENVIRONMENT","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"LIBCURL_DIR","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"libcurl-7.57.0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"Curl, Shib DLLs","type":"text"},{"type":"hardBreak"},{"text":"Installers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The name of the directory with the Curl sources","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"LIBCURL_VERSION","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"7.57.0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"Installers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The Version of Libcurl (used for paths and Merge Module Version)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":4,"rowspan":1,"colwidth":[191.61,176.69,202.61,644.73]},"content":[{"type":"paragraph","content":[{"text":"Xerces ENVIRONMENT","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"XERCES_DIR","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"xerces-c-3.2.0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"Xerces, Shib DLLs","type":"text"},{"type":"hardBreak"},{"text":"Installers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The name of the directory with the Santuario sources","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"XERCES_MM_VERSION","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"3.2.0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"Installers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The version of Xerces (used for Merge module version)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"XERCES_FILE_VERSION","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"3_2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"Installers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The garnish on the DLL name. Hence ","type":"text"},{"text":"xerces-3_2.dll","type":"text","marks":[{"type":"code"}]},{"text":". Changing this requires changes to ","type":"text"},{"text":"versions.props","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":4,"rowspan":1,"colwidth":[191.61,176.69,202.61,644.73]},"content":[{"type":"paragraph","content":[{"text":"XmlSecurity (Santuario) ENVIRONMENT","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"XSEC_DIR","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"xml-security-cpp","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"XmlSecurity","type":"text"},{"type":"hardBreak"},{"text":"all Shib DLLs","type":"text"},{"type":"hardBreak"},{"text":"Installers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The name of the directory with the Santuario sources","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"XSEC_MM_VERSION","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"2.0.0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"Installers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The version of XML Security (used for Merge module version)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"XSEC_FILE_VERSION","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"2_0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"Installers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"The garnish on the DLL name. Hence ","type":"text"},{"text":"xsec_2_0d.dll. ","type":"text","marks":[{"type":"code"}]},{"text":"Changing this requires changes to","type":"text"},{"text":" versions.props","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":4,"rowspan":1,"colwidth":[191.61,176.69,202.61,644.73]},"content":[{"type":"paragraph","content":[{"text":"Apache ENVIRONMENT","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"text":"Default","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"Used to build...","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"APACHE_13_ROOT","type":"text","marks":[{"type":"strike"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"not used","type":"text","marks":[{"type":"strike"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"Location of Apache 1.3 build tree as downloaded from ApacheLounge","type":"text","marks":[{"type":"strike"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"APACHE_20_ROOT","type":"text","marks":[{"type":"strike"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"mod_shib20.so","type":"text","marks":[{"type":"strike"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"Location of 32 bit Apache 2.0 build tree as downloaded from ApacheLounge","type":"text","marks":[{"type":"strike"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"APACHE_22_ROOT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"mod_shib22.so","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"Location of 32 bit Apache 2.2 build tree as downloaded from ApacheLounge","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"APACHE_22_ROOT64","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"mod_shib22.so","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"Location of 64 bit Apache 2.2 build tree as downloaded from ApacheLounge","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"APACHE_24_ROOT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"mod_shib24.so","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"Location of 32 bit Apache 2.4 build tree as downloaded from ApacheLounge","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.61]},"content":[{"type":"paragraph","content":[{"text":"APACHE_24_ROOT64","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[176.69]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[202.61]},"content":[{"type":"paragraph","content":[{"text":"mod_shib24.so","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[644.73]},"content":[{"type":"paragraph","content":[{"text":"Location of 64 bit Apache 2.4 build tree as downloaded from ApacheLounge","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"The build takes configuration from environmental variable set up in the file ","type":"text"},{"text":"cpp-msbuild/dependencies/config.bat. ","type":"text","marks":[{"type":"code"}]},{"text":"The complete list of settings can be found from either build system with the target 'environment',","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Obeying the Component rules","type":"text"}]},{"type":"paragraph","content":[{"text":"The","type":"text"},{"text":" component rules ","type":"text","marks":[{"type":"link","attrs":{"href":"https://blogs.msdn.microsoft.com/windows_installer_team/2005/09/18/recommended-background-on-versioning-and-component-rules/"}}]},{"text":"require that if the name of a DLL is changed then the component GUID is changed. In terms of the Shibboleth build this means that if any of the environmental variables ending in ","type":"text"},{"text":"_FILE_VERSION","type":"text","marks":[{"type":"code"}]},{"text":" change then you need to edit the Versions.cpp file. This is because this environmental variable is used to control the name of the DLL during the build of the dependencies and during the build of the installer.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"versions.props","type":"text","marks":[{"type":"code"}]},{"text":" file has code to ensure that the installers will not build if a file version is changed without a change to the GUID for instance. The code contains comments to explain what to do","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n BAD_LIBCURL_FILE_VERSION\n \n ","type":"text"}]},{"type":"paragraph","content":[{"text":"In this case, if LIBCURL was updated to version 7.59 then it would be relevant to change ","type":"text"},{"text":"LIBCURL_FILE_VERSION","type":"text","marks":[{"type":"code"}]},{"text":" to ","type":"text"},{"text":"7_59","type":"text","marks":[{"type":"code"}]},{"text":". This in turn qould require changing the code section above ","type":"text"},{"text":"and ","type":"text","marks":[{"type":"strong"}]},{"text":"the 4 GUIDs associate with libcurl (","type":"text"},{"text":", , , ","type":"text","marks":[{"type":"code"}]},{"text":"). If you don't understand why read up on the ","type":"text"},{"text":"file version ","type":"text","marks":[{"type":"link","attrs":{"href":"https://msdn.microsoft.com/en-us/library/windows/desktop/aa368599(v=vs.85).aspx"}}]},{"text":"and ","type":"text"},{"text":"component ","type":"text","marks":[{"type":"link","attrs":{"href":"https://blogs.msdn.microsoft.com/windows_installer_team/2005/09/18/recommended-background-on-versioning-and-component-rules/"}}]},{"text":"rules. Or just do it.","type":"text"}]},{"type":"paragraph","content":[{"text":"A GUID generator is shipped as part of Visual Studio. The ones you use need to be in 'registry format'","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Downloaded External Dependencies","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Apache","type":"text"}]},{"type":"paragraph","content":[{"text":"Apache should be downloaded (and verified) from ","type":"text"},{"text":"Apache Lounge","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.apachelounge.com"}}]},{"text":". ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"32 ","type":"text"},{"text":"and ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"64bit Apache 2.2","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"32 ","type":"text"},{"text":"and ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"64bit Apache 2.4","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The location of each download should be set up as properties as per the above.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"FastCgi","type":"text"}]},{"type":"paragraph","content":[{"text":"FastCGI is not packaged as part of the V3 SP.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Built External Dependencies","type":"text"}]},{"type":"paragraph","content":[{"text":"The following external dependencies ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"zlib","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"log4shib","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"xerces","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"libcUrl","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OpenSSL","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"XMLSecurity","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"are rebuilt under the control of the makefile ","type":"text"},{"text":"dependency.make","type":"text","marks":[{"type":"code"}]},{"text":" in the subdirectory ","type":"text"},{"text":"dependencies","type":"text","marks":[{"type":"code"}]},{"text":" of the ","type":"text"},{"text":"cpp-msbuild","type":"text","marks":[{"type":"code"}]},{"text":" project. This make file will build the dependencies specified for the architecture associated with the Visual studio build environment from which it is invoked. For example","type":"text"}]},{"type":"codeBlock","content":[{"text":"d:\\Program Files (x86)\\Microsoft Visual Studio\\2017\\Professional\\VC\\Auxiliary\\Build\\vcvars32.bat","type":"text"}]},{"type":"paragraph","content":[{"text":"or","type":"text"}]},{"type":"codeBlock","content":[{"text":"d:\\Program Files (x86)\\Microsoft Visual Studio\\2017\\Professional\\VC\\Auxiliary\\Build\\vcvars64.bat","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"One architecture at a time!","type":"text"}]},{"type":"paragraph","content":[{"text":"Several of the dependencies are built into common area and then installed into architecture specific directories. It is therefore ","type":"text"},{"text":"not safe","type":"text","marks":[{"type":"strong"}]},{"text":" to build both architectures in parallel.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Preconditions","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download sources as appropriate.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit and execute the ","type":"text"},{"text":"dependencies\\config.bat","type":"text","marks":[{"type":"code"}]},{"text":" file. This established the environment as detailed ","type":"text"},{"text":"above","type":"text","marks":[{"type":"link","attrs":{"href":"#WindowsBuild-Environment"}}]},{"text":". It is parameterized to allow for different directory layouts on different machines, while keeping the rest of the configuration common.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The OpenSSL build configure script requires changes to control the names of the output DLLS. ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To add the standard 'D' postfix to the Debug DLLs","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To uniquify the DLL names by subversion number (to protect again feature creep in subversions and thus \"DLL hell\" with multiple OpenSL distributions)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"We do this by defining new targets in the ","type":"text"},{"text":"Configurations/10-main.conf","type":"text","marks":[{"type":"code"}]},{"text":" file","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go into the subdirectory ","type":"text"},{"text":"Configurations","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit the file ","type":"text"},{"text":"10-main.conf","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Change the setting VC-WIN64A rmaking ","type":"text"},{"text":"multilib ","type":"text","marks":[{"type":"code"}]},{"text":"be \"","type":"text"},{"text":"_-x64","type":"text","marks":[{"type":"code"}]},{"text":"\"","type":"text"}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Example for Version 1.1.1d","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":" \"VC-WIN64A\" => {\n inherit_from => [ \"VC-WIN64-common\", asm(\"x86_64_asm\"),\n sub { $disabled{shared} ? () : \"x86_64_uplink\" } ],\n AS => sub { vc_win64a_info()->{AS} },\n ASFLAGS => sub { vc_win64a_info()->{ASFLAGS} },\n asoutflag => sub { vc_win64a_info()->{asoutflag} },\n asflags => sub { vc_win64a_info()->{asflags} },\n sys_id => \"WIN64A\",\n bn_asm_src => sub { return undef unless @_;\n my $r=join(\" \",@_); $r=~s|asm/x86_64-gcc|bn_asm|; $r; },\n perlasm_scheme => \"auto\",\n multilib => \"_1_4-x64\",\n },","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Duplicate the whole setting to a new target \"","type":"text"},{"text":"VC-WIN64AD","type":"text","marks":[{"type":"code"}]},{"text":"\" , this time add D to the ","type":"text"},{"text":"multilib","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"codeBlock","content":[{"text":" \"VC-WIN64AD\" => {\n inherit_from => [ \"VC-WIN64-common\", asm(\"x86_64_asm\"),\n sub { $disabled{shared} ? () : \"x86_64_uplink\" } ],\n AS => sub { vc_win64a_info()->{AS} },\n ASFLAGS => sub { vc_win64a_info()->{ASFLAGS} },\n asoutflag => sub { vc_win64a_info()->{asoutflag} },\n asflags => sub { vc_win64a_info()->{asflags} },\n sys_id => \"WIN64A\",\n bn_asm_src => sub { return undef unless @_;\n my $r=join(\" \",@_); $r=~s|asm/x86_64-gcc|bn_asm|; $r; },\n perlasm_scheme => \"auto\",\n multilib => \"_1_4D-x64\",\n },","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For the 32 bit build you will need to ","type":"text"},{"text":"add","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"multilib","type":"text","marks":[{"type":"code"}]},{"text":" This time the name only gets the sub (3rd digit) version (and the ","type":"text"},{"text":"D","type":"text","marks":[{"type":"code"}]},{"text":" for debug - for a new target ","type":"text"},{"text":"VC-WIN32D","type":"text","marks":[{"type":"code"}]},{"text":".)","type":"text"}]},{"type":"codeBlock","content":[{"text":" \"VC-WIN32\" => {\n inherit_from => [ \"VC-noCE-common\", asm(\"x86_asm\"),\n sub { $disabled{shared} ? () : \"uplink_common\" } ],\n CFLAGS => add(\"/WX\"),\n AS => sub { vc_win32_info()->{AS} },\n ASFLAGS => sub { vc_win32_info()->{ASFLAGS} },\n asoutflag => sub { vc_win32_info()->{asoutflag} },\n asflags => sub { vc_win32_info()->{asflags} },\n sys_id => \"WIN32\",\n bn_ops => add(\"BN_LLONG\"),\n perlasm_scheme => sub { vc_win32_info()->{perlasm_scheme} },\n # \"WOW\" stands for \"Windows on Windows\", and \"VC-WOW\" engages\n # some installation path heuristics in windows-makefile.tmpl...\n build_scheme => add(\"VC-WOW\", { separator => undef }),\n multilib => \"_1_4\",\n },\n \"VC-WIN32D\" => {\n inherit_from => [ \"VC-noCE-common\", asm(\"x86_asm\"),\n sub { $disabled{shared} ? () : \"uplink_common\" } ],\n CFLAGS => add(\"/WX\"),\n AS => sub { vc_win32_info()->{AS} },\n ASFLAGS => sub { vc_win32_info()->{ASFLAGS} },\n asoutflag => sub { vc_win32_info()->{asoutflag} },\n asflags => sub { vc_win32_info()->{asflags} },\n sys_id => \"WIN32\",\n bn_ops => add(\"BN_LLONG\"),\n perlasm_scheme => sub { vc_win32_info()->{perlasm_scheme} },\n # \"WOW\" stands for \"Windows on Windows\", and \"VC-WOW\" engages\n # some installation path heuristics in windows-makefile.tmpl...\n build_scheme => add(\"VC-WOW\", { separator => undef }),\n multilib => \"_1_4D\",\n },","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If building OpenSSL3, check that the following patch has been applied (it is not present in 3.0.0) ","type":"text"}]},{"type":"codeBlock","content":[{"text":"diff --git a/Configurations/windows-makefile.tmpl b/Configurations/windows-makefile.tmpl\nindex 78d39ffb4b..81a94ee19f 100644\n--- a/Configurations/windows-makefile.tmpl\n+++ b/Configurations/windows-makefile.tmpl\n@@ -983,6 +983,7 @@ EOF\n @{$args{objs}};\n my @deps = compute_lib_depends(@{$args{deps}});\n my $objs = join($target{ld_resp_delim}, @objs);\n+ my $ress = join($target{ld_resp_delim}, @ress);\n my $linklibs = join(\"\", map { \"$_$target{ld_resp_delim}\" } @deps);\n my $deps = join(\" \", @objs, @ress, @deps);\n return <<\"EOF\";","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"NMAKE targets","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"clean","type":"text"}]},{"type":"paragraph","content":[{"text":"Cleans all build environments","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"all","type":"text"}]},{"type":"paragraph","content":[{"text":"Builds all targets","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"per-dependency targets","type":"text"}]},{"type":"paragraph","content":[{"text":"Each of the 6 dependencies (","type":"text"},{"text":"openssl","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"log4shib","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"zlib","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"xerces","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"curl","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"xmlsec","type":"text","marks":[{"type":"strong"}]},{"text":") has four targets associated","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"nmake /f dependency.make ","type":"text","marks":[{"type":"strong"}]},{"text":" builds both the release and debug installation of the appropriate architecture for ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"}]},{"text":" and any of its dependencies. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"nmake /f dependency.make -clean","type":"text","marks":[{"type":"strong"}]},{"text":" cleans the build environment (both architectures) for ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"nmake /f dependency.make -debug ","type":"text","marks":[{"type":"strong"}]},{"text":"performs the debug build and installation of the appropriate architecture ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"}]},{"text":" and any of its dependencies.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"nmake /f dependency.make -release ","type":"text","marks":[{"type":"strong"}]},{"text":"(if not there) performs the release build and installation of the appropriate architecture for ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"}]},{"text":" and any of its dependencies.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"In addition ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"openssl-build ","type":"text","marks":[{"type":"strong"}]},{"text":"builds the debug installation of the appropriate architecture, but does ","type":"text"},{"text":"NOT","type":"text","marks":[{"type":"strong"}]},{"text":" rebuild the configuration or do a distclean. Appropriate when working on OpenSSL development (as if)","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Building Shibboleth","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"A centralized makefile ","type":"text"},{"text":"cpp-msbuild/build.make","type":"text","marks":[{"type":"code"}]},{"text":" allows all the Shibboleth components to be build (cpp-xmltooling, cpp-saml, cpp-sp)","type":"text"}]},{"type":"paragraph","content":[{"text":"In contrast to the dependency build this nmake files makes both architectures (X64 and ia386)","type":"text"}]},{"type":"paragraph","content":[{"text":"The final outcome of a build is usually the two installers.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Preconditions","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download or build the depenencies as per above","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the Environmental variables described ","type":"text"},{"text":"above","type":"text","marks":[{"type":"link","attrs":{"href":"#WindowsBuild-Environment"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The Shibboleth only \"external\" environment is defined in the ","type":"text"},{"text":"$(BuildRoot)cpp-msbuild/versions.props","type":"text","marks":[{"type":"code"}]},{"text":" file. Create this and edit it appropriately based on this template","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n h:\\perforce\\VS2017\\\n $(BuildRoot)apache\\VC10\\Apache2\n $(BuildRoot)apache\\VC10\\Apache22-64\n $(BuildRoot)apache\\VC15\\Apache24-32\\Apache24\n $(BuildRoot)apache\\VC15\\Apache24-64\\Apache24\n \n","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check the ","type":"text"},{"text":"Versions.props","type":"text","marks":[{"type":"code"}]},{"text":" files for any required changes. These will include ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"changes to GUIDs as ","type":"text"},{"text":"FILE_VERSIONS","type":"text","marks":[{"type":"code"}]},{"text":" changes","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Boost versions ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"and so forth. ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"As noted above, the installers will fail to build if the FILE_VERSION has been changed and appropriate changes have not been made in this file.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"NMAKE targets","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"clean","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"exe32","type":"text","marks":[{"type":"strong"}]},{"text":" - build 32 bit executables (all DLLs and exe files)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"exe64","type":"text","marks":[{"type":"strong"}]},{"text":" - build 64 bit executables (all DLLs and exe files)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"all","type":"text","marks":[{"type":"strong"}]},{"text":" - build both installers ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Rebuilding individual projects is usually better achieved from within Visual Studio (which also takes configuration from ","type":"text"},{"text":"$(BuildRoot)buildpath.props","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"$(BuildRoot)cpp-msbuild//versions.props. ","type":"text","marks":[{"type":"code"}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Ensure that the environment is setup before starting Visual Studio","type":"text"}]},{"type":"paragraph","content":[{"text":"h:\\Perforce\\VS2017>cpp-sp\\Projects\\vc15\\Shibboleth.sln","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"h:\\Perforce\\VS2017>cpp-msbuild\\dependencies\\config.bat","type":"text","marks":[{"type":"code"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Windows Subsystem for Linux (WSL)","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"The SP has been built using WSL (largely to test the Linux build environment without a Linux machine), but this is not supported. The ","type":"text"},{"text":"Linux build instructions","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2067398689"}}]},{"text":" should be followed","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"If for whatever reason you need to use WSL the following helps in the run up to the ","type":"text"},{"text":"configure","type":"text","marks":[{"type":"code"}]},{"text":" stage.","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"autoreconf -fvi ","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"autoconf","type":"text","marks":[{"type":"code"}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}