The Ganymede server and client suites include a text-mode xmlclient, which can be used to load data and schema information into the Ganymede server, and which may be used to dump data from the server to an XML file.

There are four ways to run the xmlclient:

1. xmlclient [username=<username>] [password=<password>] <xmlfile>
2. xmlclient [username=<username>] [password=<password>] -dump
3. xmlclient [username=<username>] [password=<password>] -dumpschema
4. xmlclient [username=<username>] [password=<password>] -dumpdata

Running xmlclient with a file name for a parameter will cause that file to be loaded and transmitted to the server for action. The -dump option will cause the xmlclient to emit to STDOUT a complete dump of the server's contents in XML format. The -dumpschema option dumps out just the schema definition information, and the -dumpdata option dumps out just the data objects.

The xmlclient assumes that it is being run by the supergash account by default. Only supergash-level admins are allowed to use the three dump options. XML files may have the username and password encoded in the <ganymede> document element, or these may be specified with the optional username= and password= command line arguments. If you don't want to expose your password on the command line, The xmlclient will prompt you for your password as needed.

Examples:

xmlclient -dumpschema

This example will prompt for the supergash password and dump the server's schema to the screen.

xmlclient username=jonhart:supergash -dump > database.xml

This example will prompt for user jonhart's personal supergash password and dump the server's complete contents to the database.xml file.

xmlclient username=broccol password=notReal changes.xml

This example will load the changes.xml file and send its contents to the server.

xmlclient schema.xml

This example will load the schema.xml file and send its contents to the server, prompting for the supergash password if the schema.xml file does not specify username and password.

See the Ganymede XML Guide for complete details on the XML file format used by xmlclient.