Skip to main content

Advanced Options

Configure Timing for Building Search Indexes and Browse Views

The tasks to rebuild search indexes and browse nodes run after an upgrade is completed. In some cases, these tasks may take hours to run while the migration remains in a pending state. This behavior may be modified when you consider it critical for the migration to complete as soon as possible. The search index may be rebuilt asynchronously at a later time.

Add the following file to the Nexus Repository 3 work directory:

<data-dir>/etc/nexus.properties

Update the file with the following settings:

nexus.migration.search.buildDuringMigration=false
nexus.migration.browse.buildDuringMigration=false

Not running these tasks leaves the browse and search data empty in Nexus Repository 3. Remember to schedule the following tasks:

Repair - Rebuild repository browse
Repair - Rebuild repository search

Enable the Continue for an Incomplete Migration

In some cases, the migration utility may fail to enable the Continue option to gracefully finish the migration. Under the direction of Sonatype Support, you may force the migration to continue even when some content may not have been migrated.

  1. Do not select Abort as all migrated content will be lost.

  2. Contact Sonatype Support and inform them of the issue.

  3. When directed by support, add the following file to the Nexus Repository 3 work directory:

    $data-dir/sonatype-work/nexus3/etc/nexus.properties
  4. Add the following property to this file:

    nexus.migration.sync.forceContinueEnabled=true
  5. Restart the Nexus Repository 3.

  6. The upgrade wizard will now proceed past the sync phase (step 8 of 9) to finish the upgrade process.