Upgrading to Jenkins LTS 2.580.x

Each section covers the upgrade from the previous LTS release, the section on 2.580.1 covers the upgrade from 2.568.3.

Upgrading to Jenkins 2.580.1

Detached plugins removed from WAR file

The bouncycastle API, Command Agent Launcher, Oracle Java SE Development Kit Installer, JAXB, Trilead API, SSH server, JavaBeans Activation Framework (JAF) API, JavaMail API, and Instance Identity plugins are no longer bundled inside jenkins.war, reducing its download size by more than 20 MB. This functionality was split out of Jenkins core into these plugins between 2016 and 2022 (Jenkins 2.16 through 2.356). Copies were bundled in the war since then so that instances upgrading from such old versions, or plugins built against them, would keep working.

Most instances are not affected. If the update center is reachable, Jenkins resolves and installs these plugins automatically over the network whenever something needs them, the same way it would for any other missing dependency, regardless of which Jenkins version you’re running.

You are only affected if your instance has no access to the update center. In that case, upgrading core past one of the versions above, or installing a plugin built against an old baseline, can no longer pull these plugins in automatically. Download the plugin files from the update center and place them in the plugins directory of the Jenkins home directory before starting the new version or before installing the plugin that needs them.

Upgrading directly from 1.577 or earlier

The JUnit, Mailer, Matrix Authorization Strategy, Matrix Project, and OWASP Markup Formatter plugins are no longer bundled inside jenkins.war, reducing its download size by more than 20 MB. This functionality was split out of Jenkins core into these plugins in 2014 (Jenkins 1.577) or earlier. Copies were bundled in the war since then so that instances upgrading from such old versions would keep working.

Most instances are not affected. If these plugins are already installed (they are among the plugins suggested by the setup wizard), or your instance was installed or last upgraded at any point in the last decade, nothing changes.

You are only affected if you upgrade an instance directly from Jenkins 1.577 or earlier, or if you install plugins built against Jenkins (then Hudson) 1.577 or earlier without using the Jenkins plugin manager. In those cases Jenkins can no longer install these plugins automatically from the war. If the update center is reachable, install the plugins through the plugin manager as usual. On instances without access to the update center, download the plugin files and place them in the plugins directory of the Jenkins home directory before starting the new version.

When upgrading an instance from Jenkins 1.577 or earlier, install these five plugins before starting the new Jenkins version. Configuration that depends on them, such as matrix-based security, matrix (multi-configuration) jobs, JUnit test result publishing, email notification settings, and markup formatter settings, cannot be loaded without them. Jenkins may fail to start (for example, if matrix-based security is your authorization strategy), and configuration that fails to load may be discarded the next time the affected item is saved. Alternatively, upgrade in two steps: first to an intermediate version that still bundles these plugins (any LTS release before this change), let Jenkins install them automatically, then upgrade to the current version.