Test Server Setup

Setup

• you need administrator access
• install dotnet framework or better used by Daysim. Current is 4.6.1
• install Microsoft Build Tools: https://www.microsoft.com/en-us/download/details.aspx?id=48159
• install Anaconda Python 3.5+. The Jenkins configuration needs to reference the install location (i.e. C:\Anaconda3)
• install Jenkins 2.x.x
• install git
• install git-lfs (large file storage): https://git-lfs.github.com

Required plugins for Jenkins:

• git
• github
• msbuild
• ShiningPanda (for Python)
• SCM Sync Configuration Plugin (so that changes to the Jenkins job configuration can be checked into Git)

Plugins configuration

Each of the above items need some fairly obvious configuration such as location of Git, location of MSBuild.exe, location of Python.

Note the configuration of MSBuild has a weird quirk/bug: Under 'Manage Jenkins'->'Global Tool Configuration'->MSBuild->'Add MSBuild' there is an input for the 'Path to MSBuild'. It is ambiguous whether it means the path to the directory containing MSBuild.exe or the full path to the executable. If you put the full path to the excecutable it shows an error: 'C:\Program Files (x86)\MSBuild\14.0\Bin\MSBuild.exe is not a directory on the Jenkins master (but perhaps it exists on some agents)' HOWEVER this is actually what is needed to make it work!

Setup a Daysim job for Jenkins to run

The Daysim test job is stored in Git along with the Daysim code. It is a Python program. Jenkins keeps jobs as subfolders.

python Daysim.Tests\Daysim.Tests.external\compare_output_directories\regress_subfolders.py --regional_data_directory "e:\rd\psrc_days_test-git"

Starting, Stopping, and Restarting Jenkins

Go to the Jenkins install directory - E:\Projects\DaySim\Jenkins_for_DaySim - and run the appropriate command:

• jenkins.exe stop
• jenkins.exe start
• jenkins.exe restart

Or Start + Administrative Tools + Services and start Jenkins.exe

Check that the server is running at http://wrjmdlppw01.rsginc.com:8080/job/DaySim_all_regions