Jenkins offline installation and configuration procedure

On the Download_Station :

On the Target_Host :

Download the Jenkins MSI installer file from the url: https://get.jenkins.io/windows-stable/<*JENKINS_VERSION*>/jenkins.msi

Copy the downloaded jenkins.msi file on the folder DDL_PATH

Download the needed plugins using the file requiredPlugins_Jenkins_LTS_<*JENKINS_VERSION*>.txt given in the T4C bundle on path <T4C_BUNDLE>\tools\resources\scheduler\.

# Set the path to the file containing the URLs
$url_file = "C:\Path\To\requiredPlugins_Jenkins_LTS_.*.txt"

# Set the directory where the downloaded files will be saved
$output_directory = "C:\Path\To\DDL_PATH\plugins"

# Read the contents of the URL file and store each URL in an array
$url_array = Get-Content $url_file | Where-Object { $_ -notmatch "^\s*#.*" -and $_ -ne "" }

# Iterate through the array and download each file
foreach ($url in $url_array) {
    $output_file = Join-Path $output_directory ([System.IO.Path]::GetFileName($url))
    Invoke-WebRequest $url -OutFile $output_file
}

Package the DDL_PATH folder on a zip archive named t4c_jenkins_assets.zip.

Get the checksum of this archive with the following Windows commands:

Copy the generated zip file on a media available from the Target_Host.

Copy the previously generated zip from the media on the Target_Host on the WORKING_PATH.

Extract the zip archive on the WORKING_PATH to have the folder structure :

WORKING_PATH
* t4c_jenkins_assets
** jenkins.msi
** plugins
*** <plugin name>.hpi
*** <plugin name>.hpi
*** ...

Install Jenkins by running the jenkins.msi file following the official documentation: https://www.jenkins.io/doc/book/installing/windows/

Create a TEAMFORCAPELLA_APP_HOME\tools\resources\scheduler\plugins folder

Populate this folder by copying all WORKING_PATH\t4c_jenkins_assets\plugins\*.hpi files in it.

Generate the plugins file list TEAMFORCAPELLA_APP_HOME\tools\resources\scheduler\requiredPlugins_Jenkins_local.txt with the local relative path from TEAMFORCAPELLA_APP_HOME\tools\resources\scheduler path of each plugin file. The file create must have this look :

C:\...\plugins\<plugin name>.hpi
C:\...\plugins\<plugin name>.hpi
C:\...\plugins\<plugin name>.hpi
...

# Set the path to the folder containing the plugins files
$folder_path = "*TEAMFORCAPELLA_APP_HOME*\tools\resources\scheduler\plugins"

# Set the target file that list the plugins files
$output_file = "*TEAMFORCAPELLA_APP_HOME*\tools\resources\scheduler\requiredPlugins_Jenkins_local.txt"

# List files and generate the list on the file
Get-ChildItem $folder_path -File | foreach { "file:" + $_.FullName } | Set-Content $output_file

Update the plugin installation script to use this newly generated plugin file list :

Replace the download of the jenkins.msi file by the WAR alternative: https://get.jenkins.io/war-stable/<*JENKINS_VERSION*>/jenkins.war

Prepare the Jenkins execution folder :

Copy the jenkins.war file on this folder *TEAMFORCAPELLA_APP_HOME\jenkins

Create the Jenkins temporary folder :

Create a startScheduler.bat script to start the Jenkins product with the following content (prepared using System Administrator Guide > Jenkins Installation)

REM Set env var needed to run Jenkins
SET JENKINS_HOME=*TEAMFORCAPELLA_APP_HOME*\jenkins
SET PATH=%PATH%;*TEAMFORCAPELLA_APP_HOME*\capella\jre\bin

REM Start Jenkins webserver
java -jar *TEAMFORCAPELLA_APP_HOME*\jenkins.war -Djava.io.tmpdir=%JENKINS_HOME%\temp --httpPort=8036 --extractedFilesFolder="%JENKINS_HOME%\temp

To start the Jenkins server, run the script startScheduler.bat from a Windows terminal (cmd.exe or PowerShell)