no rsync in replication but ref'ed in clustering

[ajschumacher]

(as of ac00f61)

clustering.html includes "See more about rsync and replication in Chapter 16, Replication." but replication.html doesn't include anything about rsync.

[janl]

That needs to be "sync".

On 26.11.2014, at 18:51, Aaron Schumacher notifications@github.com wrote:

(as of ac00f61)

clustering.html includes "See more about rsync and replication in Chapter 16, Replication." but replication.html doesn't include anything about rsync.

—
Reply to this email directly or view it on GitHub.

[ajschumacher]

There isn't anything about any file-based syncing in replication though, is there?

[janl]

No, in CouchDB we often use Replication and Sync synonymously.

On 26.11.2014, at 19:12, Aaron Schumacher notifications@github.com wrote:

There isn't anything about any file-based syncing in replication though, is there?

—
Reply to this email directly or view it on GitHub.

[ajschumacher]

Here's the paragraph for context:

Another method for moving partition databases is to rsync the files on disk from the old node to the new one. Depending on how recently the partition was compacted, this should result in efficient, low-CPU initialization of a new node. Replication can then be used to bring the rsynced file up-to-date. See more about rsync and replication in Chapter 16, Replication.

To me it seems like it's talking about an alternative method for getting the same database state to a different node: moving files, rather than using the usual CouchDB replication features. That's why I thought Replication and (r)Sync weren't being used synonymously, and why I thought it was strange that it referred to the replication chapter despite the replication chapter not having anything about replicating by moving files yourself. Does that make sense? Is my reading very strange? What would clarify it here?

[janl]

Ah good point. rsync is a UNIX tool that copies files around. At this point, the text assumes knowledge of that. Might be worth adding a reference to it’s wikipedia page.

The original issue of “[r]sync and replication” still needs to be “sync”.