Installing Jenkins on Windows for the HCL VersionVault-Jenkins integration

Learn how to install Jenkins on Windows so that it can be integrated with HCL VersionVault.

Before you begin

Install the following items before you install Jenkins on Windows:
  1. You must have a 64-bit Java Runtime Environment (JRE) specifically for Java 11 installed before you install Jenkins. If you do not have a JRE already, you can obtain one from Adoptium at https://adoptium.net/temurin/releases/?version=11.
    • Set the path for the environment variable for your Java. For system environment variables:
      • Set the JAVA_HOME variable to the path for your JDK. Similarly, do this for your JRE.
      • In the PATH variable, set up a bin folder for JDK.
    Tip: Remember the path to your Java because you need to designate the Java home directory during the installation of Jenkins.
  2. You must install the HCL VersionVault Remote Client or HCL VersionVault before you install Jenkins.

Procedure

Use the following procedure to install Jenkins on Windows for the HCL VersionVault-Jenkins integration:
  1. Download the jenkins.msi installation file for Jenkins LTS 2.332.x for Windows from https://get.jenkins.io/windows-stable/2.332.4/.
  2. After the download has completed, run the jenkins.msi file and proceed with the installation. Some information for the following installation steps:
    • On the Service Logon Credentials dialog box, for the Run service as a local or domain user option, enter the domain username and password for the user account that you want to run Jenkins with. Click Test Credentials to verify the credentials data. (The Run service as LocalSystem option is a less secure and therefore not recommended.)
      Note: For the Run service as local or domain user option, the user doing the installation must have the required permission to log on as a service. If this is not the case, an error message displays to state that the account cannot be verified. To resolve this situation, you must update the Local Security Policy to add the user to the User Rights Assignment.
    • On the Port Selection dialog box, enter the port number you want Jenkins to run on and click Test Port to check if the selected port is available.
    • When you have to select the Java home directory (JDK or JRE), remember that this is where you have your Java installed.
  3. When the installation has completed, click Finish to exit the installation wizard.
    Note: If you want to use SSL/TLS for your Jenkins server, consult the Jenkins documentation at https://www.jenkins.io/doc/book/installing/initial-settings for additional configuration steps.

What to do next

You must unlock Jenkins on Windows and customize it before you can start using it.