-
-
Notifications
You must be signed in to change notification settings - Fork 1.2k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Installing Linux page has no upgrade instructions #5059
Comments
I Want to Work on this Issue |
Thanks @SahityaGupta25 . I'd like a discussion in Docs Office Hours (Asia) about the placement of the upgrade instructions. I'm not sure if it is better to have:
|
I will Definitely join Docs office Hours. |
Notes in Docs Office Hours recommended:
|
See https://community.jenkins.io/t/how-to-upgrade-java-for-jenkins-on-windows-10/2121 for another example of an open question asking for more details on upgrading Jenkins. |
Sorry Mark I was Busy in My Youtube Channel.
https://www.youtube.com/channel/UCTR9St_x13OBvo4WXv2nkdw
…On Sun, 17 Apr 2022 at 00:58, Mark Waite ***@***.***> wrote:
See
https://community.jenkins.io/t/how-to-upgrade-java-for-jenkins-on-windows-10/2121
for another example of an open question asking for more details on
upgrading Jenkins.
—
Reply to this email directly, view it on GitHub
<#5059 (comment)>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/AXT6BNUBWQMCFEZZGUPIWETVFMIEZANCNFSM5S5IBTNQ>
.
You are receiving this because you were mentioned.Message ID:
***@***.***>
|
I was looking at the resources for upgrading Jenkins package on Linux using package manager,
And we have provided installation instructions for these distributions individually, it would make more sense for the Upgrade section to also have the upgrade instructions for each distribution individually. I am looking forward for a follow up on this so that I can start working on the same. |
I think that the focus of the user during installation is very different from the focus of the user during upgrade. I think that the amount of instruction needed to describe an upgrade is at least as much as the instruction needed to describe an upgrade. I think that the pattern in other documentation sets is to have install and upgrade as separate sections. Some examples include:
I think we should have a separate chapter dedicated to upgrade, with a heading per operating system as we do for the installation guide. I'll need to review the notes of the Docs Office Hours to understand what motivated the recommendation to place the upgrade instructions on the same page as the installation instructions. They are very different tasks at very different points in the administrator's experience. |
That sounds reasonable. |
You can start working on it.
…On Mon, 3 Oct 2022, 2:36 pm tanujdevops, ***@***.***> wrote:
I think that the focus of the user during installation is very different
from the focus of the user during upgrade. I think that the amount of
instruction needed to describe an upgrade is at least as much as the
instruction needed to describe an upgrade. I think that the pattern in
other documentation sets is to have install and upgrade as separate
sections. Some examples include:
- FreeBSD <https://docs.freebsd.org/en/books/handbook/cutting-edge/>
install (chapter 2) and upgrade (chapter 24)
- Ubuntu install guide
<https://help.ubuntu.com/20.04/installation-guide/amd64/index.html>
and upgrade guide <https://ubuntu.com/server/docs/upgrade-introduction>
- Red Hat 8 install guide
<https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/performing_a_standard_rhel_8_installation>
and upgrade guide
<https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/upgrading_from_rhel_7_to_rhel_8>
I think we should have a separate chapter dedicated to upgrade, with a
heading per operating system as we do for the installation guide.
I'll need to review the notes of the Docs Office Hours to understand what
motivated the recommendation to place the upgrade instructions on the same
page as the installation instructions. They are very different tasks at
very different points in the administrator's experience.
That sounds reasonable.
Do let me know what decision is being taken, I will start working
accordingly.
—
Reply to this email directly, view it on GitHub
<#5059 (comment)>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/AXT6BNURCHACDNCZRLLTEKLWBKO2HANCNFSM5S5IBTNQ>
.
You are receiving this because you were mentioned.Message ID:
***@***.***>
|
I would like to work on this issue for Hactoberfest, is anyone else still working on this? |
Hey i'd like to work on this |
Not sure if anyone is working on this |
I would like know if i have to start working on this do i have to create a new chapter for upgrading jenkins Or add a section in "installing jenkins" chapter ? |
Let's use a separate chapter. The "Installing" chapters are already long enough. |
So do i need to create a new folder named 'updating' and add updating steps for all the OS and tools on which jenkins can be used? I only know how to update Jenkins in Linux and in Windows if can be updated from the UI itself ? Can you clarify a bit more |
Think so, that would be the most direct approach |
You can add the instructions for Linux and Windows first, if need be I can add the remaining details for macOS, or provide you with the details here so you could complete the PR. |
Thanks for Clarification |
You are welcome @Vandit1604! I will post the upgrading instructions for macOS here tomorrow Asia time. |
@Vandit1604, here are the instructions for macOS: To upgrade the Jenkins LTS on macOS, do the following at the terminal with brew update && brew install jenkins-lts Similarly, to upgrade the Jenkins Weekly on macOS, do the following at the terminal: brew update && brew install jenkins |
@krisstern thanks for the big help |
hey @krisstern can you please help me with why the checks failing? |
Are we still supporting macOS? As far as I can tell, we do not and the homebrew installation is managed by someone else. |
Agree @dduportal We will follow up on this in #5888 |
I want to work on this issues please assign me this |
@Flamki I'm already working on this |
Yea you can carry on |
Problem with the Installing Linux page, source file
Linux install guide lacks upgrade instructions
The page describes the installation process but does not describe the upgrade process. Multiple Linux users have performed the initial installation with the Linux package manager for their Linux operating system, then made the mistake of upgrading by replacing the
jenkins.war
file with a newer file.Some examples of the mistake include:
Possible Solution
We should state clearly that Jenkins upgrades of Linux packages should be done with the Linux package manager, not by replacing the
jenkins.war
file.The text was updated successfully, but these errors were encountered: