[
https://issues.apache.org/jira/browse/SOLR-17469?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Christos Malliaridis updated SOLR-17469:
----------------------------------------
Description:
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. Proposed Conflict Resolution
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 (9x and 9.7) and remove (10.0) -f from the "format" option in
PostTool.
Deprecate (9x and 9.7) and remove (10.0) -f from the "config file" option (-f,
--config-file, -config-file) in SolrExporter.
Deprecate (9x and 9.7) 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.
was:
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.
> 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, 9.7, 9.6.1
> Reporter: Christos Malliaridis
> Priority: Major
> Labels: cli, migration
>
> 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. Proposed Conflict Resolution
> 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 (9x and 9.7) and remove (10.0) -f from the "format" option in
> PostTool.
> Deprecate (9x and 9.7) and remove (10.0) -f from the "config file" option
> (-f, --config-file, -config-file) in SolrExporter.
> Deprecate (9x and 9.7) 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]
