Uploaded image for project: 'Dev - Nexus Repo'
  1. Dev - Nexus Repo
  2. NEXUS-11639

legacy url mapping instructions are too confusing and not near enough to upgrade documentation

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Major
    • Resolution: Done
    • Affects Version/s: 3.1.0
    • Fix Version/s: 3.2.0
    • Component/s: Documentation
    • Labels:
      None
    • Story Points:
      1
    • Sprint:
      Sprint 84

      Description

      The Nexus Book chapter on legacy URLs is a little confusing, I'm not sure I could understand it if I didn't already know what it meant.

      I think we just need to say:

      1. Nexus 3 URLs are different than Nexus 2 URLs, here's an example of each
      2. If you want Nexus 3 URL to match what you were using in Nexus 2, then you need to do a few things:
        • Ensure the hostname, port, and context root are the same (how to do each of those is documented elsewhere)
        • Set this system property so that the repository URLs match Nexus 2.
      3. Please note, there's no repository directory browsing in Nexus 3.


      From NEXUS-11542 (merged into 1 effort):

      Based on this ticket:

      User could not locate how to enable legacy URL mapping.

      While it is documented in the book - it is not in the context of the upgrade docs. The whole legacy URL enablement section here:

      https://books.sonatype.com/nexus-book/reference3/install.html#config-legacy-url

      Should directly be in the After Upgrade section of the book here:

      https://books.sonatype.com/nexus-book/reference3/upgrading.html#_after_the_upgrade

      Configuring the legacy url is only relevant for 2.x to 3.x upgrades - putting it in the generic section of the book does not make sense.

      I realize there is a link out to it, but again, it is only relevant to upgrades, and should not be in the "Configuring the Runtime Environment" section of the book.

        Attachments

          Activity

            People

            Assignee:
            jtom Joe Tom
            Reporter:
            mprescott Michael Prescott
            Last Updated By:
            Peter Lynch
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Dates

              Created:
              Updated:
              Resolved:
              Date of First Response:

                tigCommentSecurity.panel-title