Skip to content

Latest commit

 

History

History
20 lines (18 loc) · 2.38 KB

Building WELM.md

File metadata and controls

20 lines (18 loc) · 2.38 KB
Raw

Building the Windows Event Log Messages tool

Building WELM is fairly straightforward.

  1. Install Visual Studio 2017 or later.
  2. Open the welm.sln file with Visual Studio.
  3. If this is the first time building the project, install the following nuget packages from the Package Manager Console in Visual Studio using these commands:
    1. docopt.net: Get-Project WelmConsole | Install-Package docopt.net (You may need to delete the T4 files and main.usage.txt file or you will get an exception when compiling: An exception was thrown while trying to compile the transformation code)
    2. ilmerge: Get-Project WelmConsole | Install-Package ilmerge
    3. CSVHelper: Get-Project WelmLibrary | Install-Package CsvHelper -Version 2.16.3 (This is the last version that supports .Net 4.0)
    4. Newtonsoft.Json: Get-Project WelmLibrary | Install-Package Newtonsoft.Json
    5. NLog: Get-Project WelmConsole,WelmLibrary | Install-Package NLog
    6. NLog.Schema: Get-Project WelmConsole,WelmLibrary | Install-Package NLog.Schema
  4. If this is not the first time building the project, then update each nuget package, except for CsvHelper, by using the Update-Package command in the Package Manager Console in Visual Studio.
    1. Get-Project WelmConsole UpdatePackage docopt.net
    2. Get-Project WelmConsole UpdatePackage ilmerge
    3. Get-Project WelmLibrary UpdatePackage Newtonsoft.Json
    4. Get-Project WelmConsole,WelmLibrary UpdatePackage NLog
    5. Get-Project WelmConsole,WelmLibrary UpdatePackage NLog.Schema
  5. Build a Release or Debug configuration. A dist folder will be created inside the welm folder. When building a Release configuration and the ILmerge nuget package is installed, then the release folder will contain a single binary (welm.exe) along with welm.bat, NLog.config, and Install-Features.ps1. Copy these files to a system that you want to run WELM on.