#1 JENKINS | JENKINS INSTALLATION
1. Introduction
Jenkins is an open-source automation server used for continuous integration and continuous delivery (CI/CD). This document will guide you through the installation process and the prerequisites needed to run Jenkins on your machine.
________________________________________
2. Prerequisites for Jenkins Installation
Before you install Jenkins, make sure your system meets the following prerequisites:
1. Java Development Kit (JDK): Jenkins requires Java to run. Ensure you have the correct version of JDK installed on your machine.
o Recommended Version: JDK 17 or 21
o Check if Java is Installed:
Open a terminal or command prompt and run:
If Java is not installed, download and install it from the official Oracle website.
2. Operating System: Jenkins can be installed on various operating systems, including:
o Windows
o macOS
o Linux (Ubuntu, CentOS, etc.)
3. Ports: By default, Jenkins runs on port 8080. Ensure that this port is open in your firewall and not being used by another application.
________________________________________
3. Installation Steps
For Windows:
1. Download Jenkins:
o Visit the official Jenkins website: Jenkins Download Page
o Download the Windows .war file or the installer (e.g., .msi).
2. Install Jenkins (Using MSI Installer):
o Run the .msi installer.
o Follow the on-screen instructions, which will include:
Accepting the license agreement.
Selecting the installation folder.
Setting Jenkins as a service.
--------------------------------------------------
3. Start Jenkins:
o Once installed, Jenkins will start automatically as a Windows service.
o Open your browser and go to http://localhost:8080/ to access Jenkins.
________________________________________
5. Complete the Setup
Once you've unlocked Jenkins, you will be asked to:
1. Install Suggested Plugins:
Click on "Install suggested plugins" to get essential plugins for a fresh setup.
2. Create an Admin User:
Set up an administrator account to manage Jenkins.
________________________________________
6. Conclusion
Once the installation and setup are complete, you can start using Jenkins for continuous integration and delivery. You now have Jenkins running on your system, ready to automate your workflows.
________________________________________
7. Troubleshooting Tips
• Issue: Jenkins is not starting after installation.
Solution: Check if the port 8080 is already in use. Change the port by editing the Jenkins configuration file (jenkins.xml for Windows or /etc/default/jenkins for Linux).
• Issue: Java is not found during installation.
Solution: Ensure the correct version of Java is installed, and the JAVA_HOME environment variable is set.