Christos Malliaridis created SOLR-17469:
-------------------------------------------
Summary: CLI: Resolve -f flag conflicts
Key: SOLR-17469
URL: https://issues.apache.org/jira/browse/SOLR-17469
Project: Solr
Issue Type: Sub-task
Components: cli
Affects Versions: 9.6.1, 9.6, 9.7
Reporter: Christos Malliaridis
h4. Description
The -f flag is used in multiple options, including:
* foreground in bin/solr and bin/solr.cmd, which runs Solr in the foreground
* format in PostTool to send application/json content as Solr commands to
/update instead of /update/json/docs
* format in ExportTool to set the output format for exported docs
* force in bin/solr and RunExampleTool to allow starting Solr as root user
* config file in SolrExporter to specify the configuration file
* force delete in DeleteTool to skip safety checks when deleting the
configuration directory used by a collection
* upgrade solr in install_solr_service.sh to overwrite symlink and init script
of previous installation
To avoid confusion, we should deprecate (9.8) and remove (10.0) the -f flag
from options that do not explicitly need it.
h4. Solution Proposal
Keep -f for forcing actions since it is often used in other tools for "force"
as well. This means keep -f for force in bin/solr and RunExampleTool to allow
starting Solr as root user and also for force deleting configuration
directories in DeleteTool.
Deprecate (9.8) and remove (10.0) by replacing the "force-delete-config"
(--force-delete-config, -forceDeleteConfig, --forceDeleteConfig, -f) in
DeleteTool with the "force" option (--force, -f).
Deprecate (9.8) and remove (10.0) -f from the "format" option in PostTool.
Deprecate (9.8) and remove (10.0) -f from the "config file" option (-f,
--config-file, -config-file) in SolrExporter.
Deprecate (9.8) and remove (10.0) -f from "upgrade solr" in
install_solr_service.sh by replacing it with "–upgrade".
h4. More Information
Please look into [Solr Arguments - Migration
Overview|[https://docs.google.com/spreadsheets/d/1ws44kN51WnGwQzOXc8KKRQ93TMgHSqIGb02MRWFel_U]]
for a better overview and additional information.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
