X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Fadministration.xml;h=fbb02e2346c8baca186e58951e7d19d893355d77;hb=8dbcb21f153124c2479e966b0ca0aff28f5b4760;hp=e8e9840074b298c9359a6378628ca05e9b124879;hpb=bd964f3a7291ef3171b917348142472384b636cf;p=idzebra-moved-to-github.git
diff --git a/doc/administration.xml b/doc/administration.xml
index e8e9840..fbb02e2 100644
--- a/doc/administration.xml
+++ b/doc/administration.xml
@@ -1538,9 +1538,18 @@ where g = rset_count(terms[i]->rset) is the count of all documents in this speci
is able to parse &acro.xml; records, you may use any of the two
declarations (but not both simultaneously!)
- recordType: grs.xml
- # recordType: alvis.filter_alvis_config.xml
+ recordType: dom.filter_dom_conf.xml
+ # recordType: grs.xml
+ Notice the difference to the specific instructions
+
+ recordType.xml: dom.filter_dom_conf.xml
+ # recordType.xml: grs.xml
+
+ which only work when indexing XML files from the filesystem using
+ the *.xml naming convention.
+
+
To enable transaction safe shadow indexing,
which is extra important for this kind of operation, set
@@ -1821,6 +1830,76 @@ where g = rset_count(terms[i]->rset) is the count of all documents in this speci
+
+
+ Extended services debugging guide
+
+ When debugging ES over PHP we recomment the following order of tests:
+
+
+
+
+
+ Make sure you have a nice record on your filesystem, which you can
+ index from the filesystem by use of the zebraidx command.
+ Do it exactly as you planned, using one of the GRS-1 filters,
+ or the DOMXML filter.
+ When this works, proceed.
+
+
+
+
+ Check that your server setup is OK before you even coded one single
+ line PHP using ES.
+ Take the same record form the file system, and send as ES via
+ yaz-client like described in
+ ,
+ and
+ remeber the -a option which tells you what
+ goes over the wire! Notice also the section on permissions:
+ try
+
+ perm.anonymous: rw
+
+ in zebra.cfg to make sure you do not run into
+ permission problems (but never expose such an unsecure setup on the
+ internet!!!). Then, make sure to set the general
+ recordType instruction, pointing correctly
+ to the GRS-1 filters,
+ or the DOMXML filters.
+
+
+
+
+ If you insist on using the sysno in the
+ recordIdNumber setting,
+ please make sure you do only updates and deletes. Zebra's internal
+ system number is not allowed for
+ recordInsert or
+ specialUpdate actions
+ which result in fresh record inserts.
+
+
+
+
+ If shadow register is enabled in your
+ zebra.cfg, you must remember running the
+
+ Z> adm-commit
+
+ command as well.
+
+
+
+
+ If this works, then proceed to do the same thing in your PHP script.
+
+
+
+
+
+
+