on 2/24/01 5:16 PM, Alexander Bokovoy at [EMAIL PROTECTED] wrote:
> On Sat, Feb 24, 2001 at 09:27:23PM +0100, Jochen Lillich wrote:
>> Hi there,
>>
>> using Midgard for quite some time now (it must be about a year), I'd
>> like to start using the new possibilities repligard offers. But I
>> can't make heads nor tails out of it. :-(
Jochen, you are not the only one that can't make heads or tails out of
repligard!
> First of all, read Repligard chapter in Midgard Manual. It will give you
> a basic overview how replication process touches Midgard Database.
Alexander, I've read the repligard chapter and you are correct in saying
that it is a basic overview of the replication process. That's it! The
documentation seems to assume that the user is an expert programmer. This
would be ok if all of us intending to use repligard were experts, but I have
to tell you that this is not the case for all of the users that will use
repligard.
Repligard seems to be a major player with midgard, and this being said, it
seems that the interface, and especially the how-to documentation needs to
be written so that newbies like myself can get an understanding of how to
make it work. Maybe if there was a couple of SIMPLE examples for
exporting/importing available in the midgard manual, we could then
understand better how to use repligard. Please don't take this as an insult!
I realize that you guys are real busy creating these programs, but I have to
stress that if you desire for others to use them, someone has to provide
documentation on the actual use of the program.
> Second, if you're familiar with XML, look into
> lib/repligard/repligard.conf.in, it contains full description of
> configuration file format. Repligard.xml file in that directory also is
> useful for understanding Repligard. It defines how Repligard accesses
> Midgard Database and treats resources there (and especially
> dependencies).
I am not familiar with XML. But I still looked at all the referenced
documents and can not make heads or tails out of them! Maybe if there were
comments added to these files for those who are not experts, we could get a
better idea of how to use them. Let me show you an example:
Midgard manual page:
http://www.midgard-project.org/req/midgard-1.4/x1240.htm
States in part:
repligard.conf is used to select which part of the database you want
replicated:
* The loginusernameand passwordattributes allow you to restrict
replication to a Sitegroup, or to a specific resource tree.
* The replicateelement enables further granularity in replication.
When I look at repligard.conf I see nothing which points to replicate
element :-( I also am wondering how giving a username/password determines
which information repligard will use. Note that I have created two identical
usernames for myself to administrate accollarts.org and artmetal.com. So
which of these would repligard use? Both?
Anyway, here is the repligard.conf file in its entirety. There are no
comments or anything which would help a user with my experience use
repligard to replicate. Is it possible to add a couple of comments in this
file to help a user like myself? Or maybe add some examples to the midgard
manual? I'm willing to learn! I just don't know where to look...
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE Repligard [
<!ELEMENT Repligard (database?,login?,replicate?)>
<!ELEMENT database EMPTY>
<!ATTLIST database schema CDATA #REQUIRED>
<!ATTLIST database name CDATA #REQUIRED>
<!ATTLIST database username CDATA #REQUIRED>
<!ATTLIST database password CDATA #REQUIRED>
<!ATTLIST database encoding CDATA #REQUIRED>
<!ATTLIST database blobdir CDATA #REQUIRED>
<!ELEMENT login EMPTY>
<!ATTLIST login username CDATA #REQUIRED>
<!ATTLIST login password CDATA #REQUIRED>
<!ELEMENT replicate (resource*)>
<!ATTLIST replicate all (yes|no) 'no'>
<!ELEMENT resource EMPTY>
<!ATTLIST resource type CDATA #IMPLIED>
<!ATTLIST resource id CDATA #IMPLIED>
<!ATTLIST resource guid CDATA #IMPLIED>
]>
<Repligard xmlns="http://www.midgard-project.org/repligard/1.4">
<!-- Database description -->
<!-- Path to optionally compressed Repligard schema file -->
<database
schema="/usr/share/midgard-lib/repligard.xml"
name="midgard"
username="midgard"
password="midgard"
encoding="ISO-8859-1"
blobdir="/var/www/blobs"
/>
<!-- Login account description for Repligard operation -->
<login
username="admin"
password="password"
/>
<!-- Description of the exportable resources -->
<!--
<replicate all="yes"/>
-->
</Repligard>
Thank you for your patience and assistance!
enrique
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
