[ 
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: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to