SOLR-16883: Use postlogs tool from windows and unix via solr cli infrastructure.

[epugh]

https://issues.apache.org/jira/browse/SOLR-16883

Description

experimenting with making the postlogs tool part of SolrCLI so it runs on windows and unix and elminate custom shell scripting.

Let's see if we can't get more usage/awareness of Solr consuming Solr logs!

Solution

Similar to the SimplePostTool Approach...

Tests

ran bats, but need one for bin/solr postlogs

Checklist

Please review the following and check all that apply:

• I have reviewed the guidelines for How to Contribute and my code conforms to the standards described there to the best of my ability.
• I have created a Jira issue and added the issue ID to my pull request title.
• I have given Solr maintainers access to contribute to my PR branch. (optional but recommended)
• I have developed this patch against the main branch.
• I have run ./gradlew check.
• I have added tests for my changes.
• I have added documentation for the Reference Guide

[sonatype-lift]

Sonatype Lift is retiring

Sonatype Lift will be retiring on Sep 12, 2023, with its analysis stopping on Aug 12, 2023. We understand that this news may come as a disappointment, and Sonatype is committed to helping you transition off it seamlessly. If you’d like to retain your data, please export your issues from the web console.
We are extremely grateful and thank you for your support over the years.

📖 Read about the impacts and timeline

[epugh]

@Willdotwhite @mkhludnev here is another one iwht changes to windows bin.cmd that owuld be nice to get independent test!

[Willdotwhite]

Tested @epugh 👍🏻 - I've no idea what I just did, but it certainly did it:

PS C:\Users\Will\Projects\solr\solr\packaging\build\dev\bin> .\solr.cmd postlogs -url http://localhost:8983/solr/gettingstarted -rootdir C:\Users\Will\Projects\solr\solr\packaging\build\dev\server\logs
Sending batch of 300 log records...
Batch sent
Sending batch of 300 log records...
...
Sending last batch ...
Batch sent
Committed

[Willdotwhite]

The -help command prints the following, but doesn't actually explain what the command does - should that live in the help output, or do we expect people to check the online docs?

PS C:\Users\Will\Projects\solr\solr\packaging\build\dev\bin> .\solr.cmd postlogs -help                                                                                                                   
usage: postlogs
 -help            Print this message
 -rootdir <arg>    All files found at or below the root will be indexed.
 -url <arg>       Address of the collection, example
                  http://localhost:8983/solr/collection1/.
 -verbose         Enable more verbose command output.

[joel-bernstein]

Sounds like a good idea to me.

[epugh]

Sounds like a good idea to me.

Terrific! Thanks for chiming in ;-).

[epugh]

@Willdotwhite so yeah, I have been moving the detailed help over to the Ref Guide. Commons-cli doesn't make it easy to have a pretty/detailed "this is what the tool does", as far as I know. So that IS something we lose...

[epugh]

@joel-bernstein I ran with it a bit and deprecated the SolrLogPostTool in favour of PostLogsTool and updated the ref guide as well in this PR.