[
https://issues.apache.org/jira/browse/GEODE-7025?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16912627#comment-16912627
]
Geode Integration commented on GEODE-7025:
------------------------------------------
Here's how I read this ticket:
* The Problem: Mixing two modes of cluster configuration, XML and gfsh, leads
to "weird behaviors" (and just doesn't work a lot of the time).
* Solution 1: In the docs, tell users not to mix XML and gfsh configurations,
or
* Solution 2: Document all the incompatibilities and workarounds so a
mixed-mode config can be made to work reliably.
Subsequent discussion focuses on Solution 2, mixed mode configurations.
The current User Guide write-up stops short of saying "use XML or gfsh, but not
both", and I think the ambiguity is what prompted the reporter to file this
ticket. That, and the fact that the write-up was hard to find in the first
place.
As the ticket was filed expressly against the 'docs' component, I'll address it
as such. I will:
* Make sure this information is more prominent in the User Guide and easier to
find/notice.
* Attempt to clarify the exceptions and interactions so users attempting mixed
mode configs can succeed.
However, when explanations become this complex, I wonder if the software design
needs to be improved. At minimum some exceptions and messaging in the software
might be helpful in guiding users along the happy path.
Anyone see value in filing a ticket aimed at improving the software?
> Document not mixing cache.xml and cluster configuration in gfsh
> ---------------------------------------------------------------
>
> Key: GEODE-7025
> URL: https://issues.apache.org/jira/browse/GEODE-7025
> Project: Geode
> Issue Type: Bug
> Components: docs
> Reporter: Mario Kevo
> Assignee: Dave Barnes
> Priority: Major
> Labels: ClusterConfig
>
> It's generally acknowledged that if you mixed cache.xml with cluster
> configuration in gfsh, there are bound to be some weird behaviors that are
> undocumented.
> Including new changes, more commands failed if you mixed cache.xml and
> cluster configuration.
> For example,
> Changes for _alter region_ are included in 1.9.0. Now if we create region and
> indexes with cache.xml and after creating region want to add gateway sender
> with _alter region_ this will failed. This works for 1.8.0.
> So this should be documented somewhere to avoid this situations.
> There are two proposals:
> 1. Add this note to documentation to not mix cache.xml and cluster
> configuration in gfsh.
> 2. Exclude using cache.xml for all properties which has other way to execute.
> In the second proposal we should remove cache.xml examples for all commands
> that can be executed in the other way.
--
This message was sent by Atlassian Jira
(v8.3.2#803003)
