Skip to main content

Migrating from the Legacy OrientDB Helm Chart

As of October 2023, we no longer support the legacy OSS/OrientDB Helm chart that installed a single Sonatype Nexus Repository instance within a Kubernetes cluster with a single configured node (server). We sunsetted this Helm chart because deploying Sonatype Nexus Repository in containers with an embedded database like OrientDB can corrupt the database under some circumstances.

We currently support and offer Helm charts for Sonatype Nexus Repository Pro deployments using an external PostgreSQL database. However, there is no direct path to migrate from the OrientDB Helm chart to the High Availability (HA) PostgreSQL Helm chart.

If you were using the legacy OSS/OrientDB Helm chart, you will need to migrate to a non-Kubernetes deployment with the most recent Sonatype Nexus Repository version before you can migrate to PostgreSQL and use the HA Helm chart.

Migrating from the Legacy OrientDB Helm Chart to a non-Kubernetes Deployment (Required)

  1. Create a support zip from your old installation as described in Support Features.

  2. Back up your database using the methods described in Backup and Restore.

    1. If you are storing blobs in your data directory (i.e., $data-dir), also complete the blob store backup instructions in Backup and Restore.

    2. If your blobs are in a network location (e.g., S3, NFS, etc.) and not in the Nexus work directory, then you do not need to back up the blob store.

  3. Uninstall the legacy OrientDB Helm chart. Note that this will delete the database and blob stores under /nexus-data, so it is important to back up your database before doing this step.

  4. Obtain the latest Nexus Repository version from our Downloads page.

  5. Install Sonatype Nexus Repository using your preferred Installation Method.

  6. Restore your exported database (and blobs if applicable) using the instructions in Restore Exported Databases.

Migrating to the High Availability Helm Chart (Optional)

  1. Complete the steps above to migrate to a non-Kubernetes deployment using the latest Sonatype Nexus Repository version and OrientDB.

  2. Ensure you meet the System Requirements for High Availability Deployments, including obtaining shared blob storage and a Sonatype Nexus Repository Pro license.

  3. Follow our steps to migrate to PostgreSQL.

  4. Follow our documentation for high availablity deployments. A single HA helm chart is available for Azure, AWS, or on-premises deployments (Helm Chart in GitHub, Helm Chart in ArtifactHub).