Configuring system settings in Jenkins - Visual Walkthrough

Process Flow - Configuring system settings

Open Jenkins Dashboard

↓

Click Manage Jenkins

↓

Select Configure System

↓

Modify Settings

↓

Save Changes

↓

Settings Applied to Jenkins

This flow shows how to open Jenkins, navigate to system settings, change them, and save to apply.

Execution Sample

Jenkins

1. Open Jenkins Dashboard
2. Click 'Manage Jenkins'
3. Click 'Configure System'
4. Change system settings (e.g., JDK path)
5. Click 'Save'

Steps to change Jenkins system settings through the web interface.

Process Table

Step	Action	UI Element	Result	Notes
1	Open Jenkins Dashboard	Browser URL bar	Jenkins homepage loads	Ready to manage Jenkins
2	Click Manage Jenkins	Manage Jenkins link	Management page opens	Access to system settings
3	Select Configure System	Configure System link	System configuration page loads	Settings form visible
4	Modify settings	Form fields (e.g., JDK path)	Settings updated in form	Changes staged but not saved
5	Click Save	Save button	Settings saved and applied	Jenkins uses new settings

💡 Settings saved and applied, configuration complete

Status Tracker

Variable	Start	After Step 4	After Step 5
JDK Path	/usr/lib/jvm/default	/usr/lib/jvm/java-17-openjdk	/usr/lib/jvm/java-17-openjdk
System Message	None	Settings changed but not saved	Settings saved and active

Key Moments - 2 Insights

Why do changes not take effect immediately after modifying settings?

Because changes are only staged in the form until you click 'Save' (see execution_table step 4 vs step 5).

What happens if you navigate away without saving?

Changes are lost because they are not saved yet (refer to execution_table step 4 where settings are modified but not saved).

Visual Quiz - 3 Questions

Look at the execution table, what is the UI element clicked in step 3?

A Configure System link

B Manage Jenkins link

C Save button

D Browser URL bar

💡 Hint

Check the 'UI Element' column in row for step 3 in execution_table

At which step are the settings actually saved and applied?

A Step 3

B Step 5

C Step 4

D Step 2

💡 Hint

Look at the 'Result' column in execution_table for when settings become active

If you change the JDK path but do not click Save, what is the system message state?

A Settings saved and active

B No changes made

C Settings changed but not saved

D Error: invalid path

💡 Hint

Refer to variable_tracker for 'System Message' after step 4

Concept Snapshot

Configuring system settings in Jenkins:
1. Open Jenkins Dashboard
2. Click 'Manage Jenkins'
3. Select 'Configure System'
4. Modify settings in form
5. Click 'Save' to apply changes
Changes only apply after saving.

Full Transcript

To configure system settings in Jenkins, first open the Jenkins Dashboard in your browser. Then click on 'Manage Jenkins' to access management options. Next, select 'Configure System' to open the system settings page. Here, you can modify settings such as the JDK path. Remember, changes are only saved and applied after you click the 'Save' button. If you navigate away before saving, your changes will be lost. After saving, Jenkins uses the new settings immediately.

Practice

1. What is the main purpose of the Configure System page in Jenkins?

easy

A. To view build logs of completed jobs

B. To create new Jenkins jobs

C. To install Jenkins plugins

D. To set global settings that affect all Jenkins jobs and nodes

Solution

1. Step 1: Understand Jenkins system configuration

   The Configure System page is used to set global settings that apply to the entire Jenkins instance.

2. Step 2: Differentiate from other Jenkins pages

   Creating jobs, viewing logs, and installing plugins are done in other sections, not in Configure System.

3. Final Answer:

   To set global settings that affect all Jenkins jobs and nodes -> Option D

4. Quick Check:

   Configure System = Global settings [OK]

Hint: Configure System sets global Jenkins settings [OK]

Common Mistakes:

• Confusing Configure System with job creation
• Thinking Configure System manages plugins
• Mixing build logs with system settings

2. Which of the following is the correct way to access the Jenkins system configuration page?

easy

A. Go to Manage Jenkins > Configure System

B. Go to Dashboard > New Item

C. Go to Manage Jenkins > Plugin Manager

D. Go to Build History > Configure

Solution

1. Step 1: Identify the navigation path for system settings

   The system configuration page is accessed via Manage Jenkins then Configure System.

2. Step 2: Eliminate incorrect navigation options

   New Item is for creating jobs, Plugin Manager is for plugins, and Build History does not have configuration options.

3. Final Answer:

   Go to Manage Jenkins > Configure System -> Option A

4. Quick Check:

   Manage Jenkins > Configure System = Correct path [OK]

Hint: System config is under Manage Jenkins > Configure System [OK]

Common Mistakes:

• Selecting Plugin Manager instead of Configure System
• Confusing New Item with system settings
• Looking for configuration in Build History

3. After setting an environment variable in Jenkins' Configure System page, what will happen when a job runs?

medium

A. The job will have access to the environment variable during its execution

B. The environment variable will only apply to the Jenkins master node

C. The environment variable will be ignored unless set in the job itself

D. The environment variable will cause the job to fail if not declared in the job config

Solution

1. Step 1: Understand environment variables in Configure System

   Setting environment variables globally makes them available to all jobs during execution.

2. Step 2: Clarify scope and effect

   These variables are injected into the job's environment, so the job can use them without declaring them again.

3. Final Answer:

   The job will have access to the environment variable during its execution -> Option A

4. Quick Check:

   Global env vars = Available in jobs [OK]

Hint: Global env vars set in Configure System apply to all jobs [OK]

Common Mistakes:

• Thinking env vars only apply to master node
• Assuming jobs must declare env vars again
• Believing env vars cause job failure if undeclared

4. You configured a tool path in Jenkins' Configure System, but jobs fail saying the tool is not found. What is the most likely cause?

medium

A. The job configuration overrides the global tool path

B. The tool must be installed via Jenkins Plugin Manager

C. The tool path is incorrect or not accessible by Jenkins

D. Jenkins requires a restart after setting tool paths

Solution

1. Step 1: Check tool path correctness

   If Jenkins cannot find the tool, the path set in Configure System is likely wrong or Jenkins lacks permission to access it.

2. Step 2: Understand plugin and restart roles

   Tools usually do not require plugins to be installed, and Jenkins does not always need a restart for path changes.

3. Final Answer:

   The tool path is incorrect or not accessible by Jenkins -> Option C

4. Quick Check:

   Incorrect tool path = Job failure [OK]

Hint: Verify tool path and permissions if jobs fail to find tools [OK]

Common Mistakes:

• Assuming plugin installation fixes tool path issues
• Forgetting to check file system permissions
• Restarting Jenkins unnecessarily

5. You want to configure Jenkins to send email notifications on build failures globally. Which steps should you take in the Configure System page?

hard

A. Configure email notifications in Manage Plugins section

B. Set SMTP server details and default email suffix under Configure System

C. Install email plugin and restart Jenkins without configuring SMTP

D. Add email addresses in each job's post-build actions only

Solution

1. Step 1: Configure SMTP server in Configure System

   To send emails globally, SMTP server details must be set in the Configure System page under Jenkins settings.

2. Step 2: Set default email suffix and other notification settings

   These settings ensure Jenkins can send emails without configuring each job separately.

3. Final Answer:

   Set SMTP server details and default email suffix under Configure System -> Option B

4. Quick Check:

   SMTP config in Configure System = Global email notifications [OK]

Hint: Set SMTP server in Configure System for global email alerts [OK]

Common Mistakes:

• Only adding emails in job post-build actions
• Skipping SMTP setup after installing plugins
• Looking for email config in Manage Plugins