You are browsing the docs for the snapshot version of Nexus, the latest release is available here
v1.8 To v1.9 Migration
self, incoming and outgoing links
Reindexing can consume a lot of CPU/memory if many views are indexing in parallel, please proceed by restarting only a subset of them at a time so as to not overload the system.
As those links are not shortened anymore (see here), we encourage Nexus deployments moving to 1.9 to reindex your different views containing metadata.
This operation can be performing by deleting the offset for the different views by using the different endpoints:
Nexus Fusion also allows to restart the indexing for the different views.
Composite views
The introduction of partial reindexing for composite views required a model change of composite views.
If your Nexus deployment relies on composite views or search, the following environment variable need to be set when launching Delta v1.9 for the first time:
MIGRATE_COMPOSITE_VIEWS
: true
The following logs should appear in Delta:
2023-08-24 07:38:24 INFO c.e.b.n.d.p.c.m.MigrateCompositeViews - Starting composite views migration
2023-08-24 07:38:28 INFO c.e.b.n.d.p.c.m.MigrateCompositeViews - '500' composite views events have been migrated
2023-08-24 07:38:28 INFO c.e.b.n.d.p.c.m.MigrateCompositeViews - '31' composite views states have been migrated
2023-08-24 07:38:28 INFO c.e.b.n.d.p.c.m.MigrateCompositeViews - '62' composite views states have been migrated
2023-08-24 07:38:34 INFO c.e.b.n.d.p.c.m.MigrateCompositeViews - Composite views migration is now complete with (500,62) events/states updated
After this completes, the environment variable can be removed and Delta restarted.
Default Elasticsearch views
As the mapping and setting of default Elasticsearch views have changed, it is necessary to update the views. For this purpose, set the following environment variable when launching Nexus Delta 1.9.0 for the first time
RESET_DEFAULT_ES_VIEWS
: true
The following logs should appear in Delta for each of your project:
2023-11-28 16:30:14 INFO c.e.b.n.d.p.e.i.ElasticSearchDefaultViewsResetter - Created a new defaultElasticSearchView in project 'myorg/myproject'.
Remote authentication
Currently, both remote storages and composite views with remote sources can hold auth tokens for communications with these remote endpoints. In v1.9, we now expect authentication to be dealt with in the Delta configuration
A remote storage might currently have a token stored in the storage definition. In 1.9, this should be moved to plugins.storage.storages.remote-disk.credentials
.
A composite view might currently have a token stored in the view definition. In 1.9, this should be moved to plugins.composite-views.remote-source-credentials
, as shown here