123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495 |
- <?xml version="1.0" encoding="UTF-8"?>
- <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
- "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
- <book>
- <title>Dali Admin</title>
- <bookinfo>
- <title>Administering Dali</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/redswooshWithLogo3.jpg" />
- </imageobject>
- </mediaobject>
- <author>
- <surname>Boca Raton Documentation Team</surname>
- </author>
- <legalnotice>
- <para>We welcome your comments and feedback about this document via
- email to <email>docfeedback@hpccsystems.com</email></para>
- <para>Please include <emphasis role="bold">Documentation
- Feedback</emphasis> in the subject line and reference the document name,
- page numbers, and current Version Number in the text of the
- message.</para>
- <para>LexisNexis and the Knowledge Burst logo are registered trademarks
- of Reed Elsevier Properties Inc., used under license.</para>
- <para>HPCC Systems<superscript>®</superscript> is a registered trademark
- of LexisNexis Risk Data Management Inc.</para>
- <para>Other products, logos, and services may be trademarks or
- registered trademarks of their respective companies.</para>
- <para>All names and example data used in this manual are fictitious. Any
- similarity to actual persons, living or dead, is purely
- coincidental.</para>
- <para></para>
- </legalnotice>
- <releaseinfo>© 2015 HPCC Systems<superscript>®</superscript>. All rights
- reserved</releaseinfo>
- <date>3.0.0_x</date>
- <corpname>HPCC Systems</corpname>
- <copyright>
- <year>May, 2015</year>
- </copyright>
- <mediaobject role="logo">
- <imageobject>
- <imagedata fileref="images/LN_Rightjustified.jpg" />
- </imageobject>
- </mediaobject>
- </bookinfo>
- <chapter>
- <title><emphasis role="bold">Dali Admin</emphasis></title>
- <para>DaliAdmin is an administrator's command line tool to diagnose and
- fix problems in an HPCC's System Data Store inside the Dali Server.</para>
- <para>Daliadmin can be found at opt/LexisNexis/bin/, along with other
- tools the HPCC installation package installs.</para>
- <sect1>
- <title><emphasis>Dali Admin usage</emphasis></title>
- <para>Daliadmin is a command line tool to with the System Data Store in
- your Dali server.</para>
- <para>Usage:</para>
- <para>daliadmin <command> { <options> }</para>
- <para><programlisting>daliadmin <command> { <options> }
- </programlisting></para>
- <para></para>
- <para>More text and further descriptions of daliadmin to come...</para>
- <para></para>
- <para></para>
- <para>Data Store commands:</para>
- <para><informaltable>
- <?dbfo keep-together="always"?>
- <tgroup cols="2">
- <tbody>
- <row>
- <entry>export <branchxpath> <destfile></entry>
- <entry>exports specified branches to the nominated
- file...</entry>
- </row>
- <row>
- <entry>import <branchxpath> <srcfile></entry>
- <entry>imports branches from the nominated file..</entry>
- </row>
- <row>
- <entry>importadd <branchxpath> <srcfile></entry>
- <entry>Adds to import ***</entry>
- </row>
- <row>
- <entry>delete <branchxpath></entry>
- <entry>deletes the specified branch</entry>
- </row>
- <row>
- <entry>set <xpath> <value></entry>
- <entry>sets single value to a single</entry>
- </row>
- <row>
- <entry>get <xpath></entry>
- <entry>get single value</entry>
- </row>
- <row>
- <entry>bget <xpath> <dest-file></entry>
- <entry>binary property</entry>
- </row>
- <row>
- <entry>xget <xpath></entry>
- <entry>(multi-value tail can have commas)</entry>
- </row>
- <row>
- <entry>wget <xpath></entry>
- <entry>(gets all matching xpath)</entry>
- </row>
- <row>
- <entry>addp <xpath> <value></entry>
- <entry>adds value</entry>
- </row>
- <row>
- <entry>delp <xpath></entry>
- <entry>deletes path</entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable></para>
- <para></para>
- <para>Logical File meta information command:</para>
- <para><informaltable>
- <?dbfo keep-together="always"?>
- <tgroup cols="2">
- <tbody>
- <row>
- <entry>dfsfile <logicalname></entry>
- <entry>get meta information for file</entry>
- </row>
- <row>
- <entry>dfspart <logicalname> <part-num></entry>
- <entry>get meta information for part</entry>
- </row>
- <row>
- <entry>dfscsv <logicalnamemask></entry>
- <entry>get csv description for files matching mask</entry>
- </row>
- <row>
- <entry>dfsgroup <logicalgroupname></entry>
- <entry>get IPs for logical group (aka cluster)</entry>
- </row>
- <row>
- <entry>dfsmap <logicalname></entry>
- <entry>get part files (primary and replicates)</entry>
- </row>
- <row>
- <entry>dfsexists <logicalname></entry>
- <entry>sets return value to 0 if logical file exists</entry>
- </row>
- <row>
- <entry>dfsparents <logicalname></entry>
- <entry>list superfiles containing file</entry>
- </row>
- <row>
- <entry>dfssuperunlink <logicalname></entry>
- <entry>unlinks file from all super parents</entry>
- </row>
- <row>
- <entry>dfsverify <logicalname> crc</entry>
- <entry>verifies parts exist and (optionaly) match crc</entry>
- </row>
- <row>
- <entry>setprotect <logicalname> <id></entry>
- <entry>overwrite protects logical file</entry>
- </row>
- <row>
- <entry>unprotect <logicalname> <id></entry>
- <entry>unprotect file (if id=* then clear all)</entry>
- </row>
- <row>
- <entry>listprotect <logicalnamemask>
- <id-mask></entry>
- <entry>list protected files</entry>
- </row>
- <row>
- <entry>checksuperfile <superfilename></entry>
- <entry>check superfile linkage consistent</entry>
- </row>
- <row>
- <entry>checksubfile <subfilename></entry>
- <entry>check subfile links to parent</entry>
- </row>
- <row>
- <entry>listexpires <logicalnamemask></entry>
- <entry>lists logical files with expiry value</entry>
- </row>
- <row>
- <entry>listrelationships <primary> secondary></entry>
- <entry>lists relations set up</entry>
- </row>
- <row>
- <entry>dfsperm <logicalname></entry>
- <entry>returns LDAP permission for logical file access</entry>
- </row>
- <row>
- <entry>dfscompratio <logicalname></entry>
- <entry>returns size and compression ratio of logical
- file</entry>
- </row>
- <row>
- <entry>dfsscopes <mask></entry>
- <entry>lists logical file scopes</entry>
- </row>
- <row>
- <entry>cleanscopes <mask></entry>
- <entry>remove empty scopes</entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable></para>
- <para></para>
- <para>Workunit commands:</para>
- <para><informaltable>
- <?dbfo keep-together="always"?>
- <tgroup cols="2">
- <tbody>
- <row>
- <entry>listworkunits <workunit-mask>
- [<prop>=<val> <lower> <upper>]
- workunittimings <WUID></entry>
- <entry>csv of graph timings</entry>
- </row>
- <row>
- <entry>saveworkunitarchive <WUID> <file></entry>
- <entry>sets result to 0 if exists</entry>
- </row>
- <row>
- <entry>loadworkunitarchive <WUID> <file></entry>
- <entry>sets result to 0 if exists</entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable></para>
- <para></para>
- <para>Other dali server and misc commands:</para>
- <informaltable>
- <?dbfo keep-together="always"?>
- <tgroup cols="2">
- <tbody>
- <row>
- <entry>serverlist <mask></entry>
- <entry>list server IPs (mask optional)</entry>
- </row>
- <row>
- <entry>clusterlist <mask></entry>
- <entry>list clusters (mask optional)</entry>
- </row>
- <row>
- <entry>queuelist <mask></entry>
- <entry>list active queues (mask optional)</entry>
- </row>
- <row>
- <entry>clientlist <mask></entry>
- <entry>list all current connected clients</entry>
- </row>
- <row>
- <entry>getauditlog <fromdate> <todate>
- <match></entry>
- <entry>get dali audit log text</entry>
- </row>
- <row>
- <entry>storecoalesce</entry>
- <entry>force dali server transaction log coalesce</entry>
- </row>
- <row>
- <entry>mpping <server-ip></entry>
- <entry>time MP connect (sets result no zero if failed)</entry>
- </row>
- <row>
- <entry>daliping</entry>
- <entry>time dali client connect (sets result)</entry>
- </row>
- <row>
- <entry>daliperf</entry>
- <entry>return 'busy' measure for dali server</entry>
- </row>
- <row>
- <entry>getxref <destxmlfile></entry>
- <entry>get all XREF information</entry>
- </row>
- <row>
- <entry>dalilocks</entry>
- <entry>get all locked paths (e.g. files)</entry>
- </row>
- <row>
- <entry>daliunlock</entry>
- <entry>unlocks a path</entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- <para></para>
- <para>Common options:</para>
- <para>(can be placed in daliadmin.ini)</para>
- <para><informaltable>
- <?dbfo keep-together="always"?>
- <tgroup cols="2">
- <tbody>
- <row>
- <entry>server=<dali-server-ip></entry>
- <entry>required</entry>
- </row>
- <row>
- <entry>user=<username></entry>
- <entry>for file operations</entry>
- </row>
- <row>
- <entry>password=<password></entry>
- <entry>for file operations</entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable></para>
- <para></para>
- <para></para>
- <para></para>
- <sect2>
- <title>XPATH Syntax</title>
- <para>The XPATH Syntax can be entered in alternative method on the
- command line making it easier to enter commands without having to
- escape. Take for intsance the expression:</para>
- <para><programlisting> x/y[@id="z"]</programlisting></para>
- <para>This can be alternatively expressed as:</para>
- <para><programlisting> x/y[@id=z] </programlisting></para>
- <para>if z doesn't contain the character ']'</para>
- <para>Alternatively the same statement can be constructed as :</para>
- <para><programlisting>x/y[@id='z']</programlisting> another example in
- the following statement, if z does not contain a '}]' character
- string, you can use:</para>
- <para><programlisting>x/y[@id={z}] </programlisting></para>
- <para></para>
- <para>The above examples make using xpaths easier from the command
- line by removing need to always escape quotes.</para>
- <para></para>
- <para>LFN(<logicalname>) expands to file xpath for the logical
- filename</para>
- </sect2>
- </sect1>
- </chapter>
- </book>
|