How to downgrade from Nexus 3 Pro to Nexus 3 OSS

To downgrade a Nexus Repository Manager (NXRM) 3 PRO instance to OSS:

  1. Gracefully stop NXRM.
  2. Open the file <data-dir>/etc/ in a text editor.
  3. Add a new line to the file containing:
  4. Save the file with read permissions and ownership of the user owning the NXRM process.
  5. Required for versions 3.10.0 to 3.14.0 only:
    • This step is not needed for versions 3.9.0 or earlier or 3.15.0 and later.
    • You will need to modify the DB paths in the script before executing it.
    1. Download the attached downgrade.osql script to your <app-dir>.
    2. Open the downgrade.osql script in a text editor and modify the path references inside the script to refer to the correct locations.
    3. In a terminal session, change directories to the <app-dir> and execute the script using a java command:
      java -jar ./lib/support/nexus-orient-console.jar downgrade.osql
  6. Start NXRM

Note: In a container environment you can pass "nexus.loadAsOSS=true" in using the INSTALL4J_ADD_VM_PARAMS environment variable::

$ docker run -d -p 8081:8081 --name nexus -e INSTALL4J_ADD_VM_PARAMS="-Dnexus.loadAsOSS=true -Xms2703m -Xmx2703m -XX:MaxDirectMemorySize=2703m -Djava.util.prefs.userRoot=/some-other-dir" sonatype/nexus3
Have more questions? Submit a request


Article is closed for comments.