Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ This file lists Solr's raw release notes with details of every change to Solr. M
- Added new ConcurrentUpdateJdkSolrClient that works with HttpJdkSolrClient [SOLR-18065](https://issues.apache.org/jira/browse/SOLR-18065) (James Dyer)
- Support including stored fields in Export Writer output. [SOLR-18071](https://issues.apache.org/jira/browse/SOLR-18071) (Luke Kot-Zaniewski)
- Introducing support for multi valued dense vector representation in documents through nested vectors [SOLR-18074](https://issues.apache.org/jira/browse/SOLR-18074) (Alessandro Benedetti)
- CoreAdmin API (/admin/cores?action=UPGRADECOREINDEX) to upgrade an index in-place [SOLR-18096](https://issues.apache.org/jira/browse/SOLR-18096) (Rahul Goswami)
- CoreAdmin API (/admin/cores?action=UPGRADEINDEX) to upgrade an index in-place [SOLR-18096](https://issues.apache.org/jira/browse/SOLR-18096) (Rahul Goswami)
- CrossDC Consumer - add Prometheus metrics [SOLR-18060](https://issues.apache.org/jira/browse/SOLR-18060) (Andrzej Bialecki @ab)
- CrossDC - support arbitrary Kafka properties [SOLR-18062](https://issues.apache.org/jira/browse/SOLR-18062) (Andrzej Bialecki @ab)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@
import static org.apache.solr.common.params.CoreAdminParams.CoreAdminAction.STATUS;
import static org.apache.solr.common.params.CoreAdminParams.CoreAdminAction.SWAP;
import static org.apache.solr.common.params.CoreAdminParams.CoreAdminAction.UNLOAD;
import static org.apache.solr.common.params.CoreAdminParams.CoreAdminAction.UPGRADECOREINDEX;
import static org.apache.solr.common.params.CoreAdminParams.CoreAdminAction.UPGRADEINDEX;
import static org.apache.solr.handler.admin.CoreAdminHandler.CallInfo;

import java.lang.invoke.MethodHandles;
Expand Down Expand Up @@ -258,7 +258,7 @@ public enum CoreAdminOperation implements CoreAdminOp {

V2ApiUtils.squashIntoSolrResponseWithoutHeader(it.rsp, response);
}),
UPGRADECOREINDEX_OP(UPGRADECOREINDEX, new UpgradeCoreIndexOp());
UPGRADEINDEX_OP(UPGRADEINDEX, new UpgradeCoreIndexOp());

final CoreAdminParams.CoreAdminAction action;
final CoreAdminOp fun;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ public void execute(CoreAdminHandler.CallInfo it) throws Exception {
if (it.handler.coreContainer.isZooKeeperAware()) {
throw new SolrException(
SolrException.ErrorCode.BAD_REQUEST,
"action=UPGRADECOREINDEX is not supported in SolrCloud mode. As an alternative, in order to upgrade index, configure LatestVersionMergePolicyFactory in solrconfig.xml and reindex the data in your collection.");
"action=UPGRADEINDEX is not supported in SolrCloud mode. As an alternative, in order to upgrade index, configure LatestVersionMergePolicyFactory in solrconfig.xml and reindex the data in your collection.");
}

SolrParams params = it.req.getParams();
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -68,9 +68,9 @@
import org.slf4j.LoggerFactory;

/**
* Implements the UPGRADECOREINDEX CoreAdmin action, which upgrades an existing core's index
* in-place by reindexing documents from segments belonging to older Lucene versions, so that they
* get written into latest version segments.
* Implements the UPGRADEINDEX CoreAdmin action, which upgrades an existing core's index in-place by
* reindexing documents from segments belonging to older Lucene versions, so that they get written
* into latest version segments.
*
* <p>The upgrade process:
*
Expand Down Expand Up @@ -153,7 +153,7 @@ private UpgradeCoreIndexResponse performUpgradeImpl(
if (indexContainsChildDocs(searcherRef.get())) {
throw new SolrException(
BAD_REQUEST,
"UPGRADECOREINDEX does not support indexes containing child/nested documents. "
"UPGRADEINDEX does not support indexes containing child/nested documents. "
+ " Consider reindexing your data "
+ "from the original source.");
}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,7 @@ public void testUpgradeCoreIndexSelectiveReindexDeletesOldSegments() throws Exce
admin.handleRequestBody(
req(
CoreAdminParams.ACTION,
CoreAdminParams.CoreAdminAction.UPGRADECOREINDEX.toString(),
CoreAdminParams.CoreAdminAction.UPGRADEINDEX.toString(),
CoreAdminParams.CORE,
coreName),
resp);
Expand Down Expand Up @@ -132,14 +132,14 @@ public void testUpgradeCoreIndexAsyncRequestStatusContainsOperationResponse() th

final Set<String> segmentsBeforeUpgrade = listSegmentNames(core);

final String requestId = "upgradecoreindex_async_1";
final String requestId = "upgradeindex_async_1";
CoreAdminHandler admin = new CoreAdminHandler(h.getCoreContainer());
try {
SolrQueryResponse submitResp = new SolrQueryResponse();
admin.handleRequestBody(
req(
CoreAdminParams.ACTION,
CoreAdminParams.CoreAdminAction.UPGRADECOREINDEX.toString(),
CoreAdminParams.CoreAdminAction.UPGRADEINDEX.toString(),
CoreAdminParams.CORE,
coreName,
CommonAdminParams.ASYNC,
Expand Down Expand Up @@ -213,7 +213,7 @@ public void testNoUpgradeNeededWhenAllSegmentsCurrent() throws Exception {
admin.handleRequestBody(
req(
CoreAdminParams.ACTION,
CoreAdminParams.CoreAdminAction.UPGRADECOREINDEX.toString(),
CoreAdminParams.CoreAdminAction.UPGRADEINDEX.toString(),
CoreAdminParams.CORE,
coreName),
resp);
Expand Down Expand Up @@ -360,7 +360,7 @@ public void testUpgradeCoreIndexFailsWithChildDocuments() throws Exception {
admin.handleRequestBody(
req(
CoreAdminParams.ACTION,
CoreAdminParams.CoreAdminAction.UPGRADECOREINDEX.toString(),
CoreAdminParams.CoreAdminAction.UPGRADEINDEX.toString(),
CoreAdminParams.CORE,
coreName),
resp));
Expand All @@ -386,7 +386,7 @@ public void testChildDocsDetection_noChildDocs() throws Exception {
admin.handleRequestBody(
req(
CoreAdminParams.ACTION,
CoreAdminParams.CoreAdminAction.UPGRADECOREINDEX.toString(),
CoreAdminParams.CoreAdminAction.UPGRADEINDEX.toString(),
CoreAdminParams.CORE,
coreName),
resp);
Expand All @@ -413,7 +413,7 @@ public void testChildDocsDetection_withChildDocs() throws Exception {
admin.handleRequestBody(
req(
CoreAdminParams.ACTION,
CoreAdminParams.CoreAdminAction.UPGRADECOREINDEX.toString(),
CoreAdminParams.CoreAdminAction.UPGRADEINDEX.toString(),
CoreAdminParams.CORE,
coreName),
resp));
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -780,10 +780,10 @@ This command is used as part of SolrCloud's xref:deployment-guide:shard-manageme
When used against a core in a user-managed cluster without `split.key` parameter, this action will split the source index and distribute its documents alternately so that each split piece contains an equal number of documents.
If the `split.key` parameter is specified then only documents having the same route key will be split from the source index.

[[coreadmin-upgradecoreindex]]
== UPGRADECOREINDEX
[[coreadmin-upgradeindex]]
== UPGRADEINDEX

The `UPGRADECOREINDEX` action upgrades an existing core's index in-place after a Solr major-version upgrade by reindexing documents from older-format segments.
The `UPGRADEINDEX` action upgrades an existing core's index in-place after a Solr major-version upgrade by reindexing documents from older-format segments.
If a core is upgraded by this action, it ensures index compatibility with the next Solr major version (upon a future Solr upgrade) without having to re-create the index from source.

This action is expensive and can take a while to complete on large indexes. Consider running with `async` option in such cases.
Expand All @@ -797,7 +797,7 @@ Fields that are neither stored nor docValues-backed will lose their data, unless

It is recommended to test on a copy and have a backup before running on production data.

=== UPGRADECOREINDEX Parameters
=== UPGRADEINDEX Parameters

`core`::
+
Expand Down Expand Up @@ -828,7 +828,7 @@ Use <<coreadmin-requeststatus,REQUESTSTATUS>> with the provided `requestid` to p
The update processor chain to use for reindexing.
If omitted, Solr uses the chain configured for the `/update` handler, or the default update chain for the core (in that order).

=== UPGRADECOREINDEX Response
=== UPGRADEINDEX Response

On success, the response includes:

Expand All @@ -845,20 +845,20 @@ The number of segments successfully processed.
One of `UPGRADE_SUCCESSFUL` or `NO_UPGRADE_NEEDED`.
On failure, an exception is thrown with error details.

=== UPGRADECOREINDEX Examples
=== UPGRADEINDEX Examples

*Synchronous:*

[source,bash]
----
http://localhost:8983/solr/admin/cores?action=UPGRADECOREINDEX&core=techproducts
http://localhost:8983/solr/admin/cores?action=UPGRADEINDEX&core=techproducts
----

*Asynchronous (recommended for large cores):*

[source,bash]
----
http://localhost:8983/solr/admin/cores?action=UPGRADECOREINDEX&core=techproducts&async=upgrade_1
http://localhost:8983/solr/admin/cores?action=UPGRADEINDEX&core=techproducts&async=upgrade_1
----

Then poll status:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -179,7 +179,7 @@ public enum CoreAdminAction {
CREATESNAPSHOT,
DELETESNAPSHOT,
LISTSNAPSHOTS,
UPGRADECOREINDEX;
UPGRADEINDEX;

public final boolean isRead;

Expand Down
Loading