[jira] [Commented] (SOLR-12163) Ref Guide: Improve Setting Up an External ZK Ensemble page

["Cassandra Targett (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/SOLR-12163?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16422725#comment-16422725 ] 

Cassandra Targett commented on SOLR-12163:
------------------------------------------

Thanks [~varunthacker].

I can't find any reference to a {{zookeeper-env.sh}} in ZK docs - is there anything you didn't mention that users should do during setup to be sure this file is read?

Quasi-related: everything in the example {{zoo.cfg}} assumes a *nix-based OS (paths in particular), and I note that ZK 3.4.11 docs now say Windows is supported for production deployments (earlier versions said it was not...). Besides providing a Windows-based example of {{zoo.cfg}}, how do we provide a Windows-based {{zookeeper-env}}?

We can probably remove the "all 3 zk on one server" examples - I left/adapted it because I thought maybe it was commonly used in pre-prod scenarios since it was the only one really discussed on the page. But if it's confusing, it should go.

I'll mix in the other suggestions, thank you.

> Ref Guide: Improve Setting Up an External ZK Ensemble page
> ----------------------------------------------------------
>
>                 Key: SOLR-12163
>                 URL: https://issues.apache.org/jira/browse/SOLR-12163
>             Project: Solr
>          Issue Type: Improvement
>      Security Level: Public(Default Security Level. Issues are Public) 
>          Components: documentation
>            Reporter: Cassandra Targett
>            Assignee: Cassandra Targett
>            Priority: Major
>             Fix For: 7.4
>
>         Attachments: setting-up-an-external-zookeeper-ensemble.adoc
>
>
> I had to set up a ZK ensemble the other day for the first time in a while, and thought I'd test our docs on the subject while I was at it. I headed over to https://lucene.apache.org/solr/guide/setting-up-an-external-zookeeper-ensemble.html, and...Well, I still haven't gotten back to what I was trying to do, but I rewrote the entire page.
> The problem to me is that the page today is mostly a stripped down copy of the ZK Getting Started docs: walking through setting up a single ZK instance before introducing the idea of an ensemble and going back through the same configs again to update them for the ensemble.
> IOW, despite the page being titled "setting up an ensemble", it's mostly about not setting up an ensemble. That's at the end of the page, which itself focuses a bit heavily on the use case of running an ensemble on a single server (so, if you're counting...that's 3 use cases we don't want people to use discussed in detail on a page that's supposedly about _not_ doing any of those things).
> So, I took all of it and restructured the whole thing to focus primarily on the use case we want people to use: running 3 ZK nodes on different machines. Running 3 on one machine is still there, but noted in passing with the appropriate caveats. I've also added information about choosing to use a chroot, which AFAICT was only covered in the section on Taking Solr to Production.



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org