[Swift-devel] Re: Swift configuration interface

[David Kelly]

Hello,

The newest version of swiftconfig is available through svn at
https://svn.ci.uchicago.edu/svn/vdl2/usertools/swift/swiftconfig.

New features are the automatic replacement of $HOME within site templates,
the ability to add/modify site profiles, and the removal of commands from
the translation catalog.  Details of how it works is also now documented as
POD. "perldoc swiftconfig" will give you all the details (also included as
attachment).

David
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.mcs.anl.gov/pipermail/swift-devel/attachments/20100706/7878f354/attachment.html>
-------------- next part --------------
NAME
    swiftconfig - Utility for managing Swift configuration

SYNOPSIS
    swiftconfig [-option value]

OVERVIEW
    The swiftconfig program allows users to configure Swift. It allows for
    the adding, removing, and modification of remote sites by utilizing a
    set of standard templates. It also provides a way to quickly add, remove
    and modify translation catalog entries without having to manually edit
    files.

DESCRIPTION
    General operations: 
	-add sitename 		add a site from template 
	-remove site		removes a site from sites.xml 
	-remove command 	removes a command from the catalog 
	-templates 		display all available sites in template 
	-modify site		Specifies the name of a site to modify

    Translation catalog settings: 
	-host hostname		hostname of the translation catalog entry 
	-name name 	 	translation name 
	-path path 	 	full pathname to location of program 
	-status status 	 	installation status (deprecated)
    	-profile setting 	define the profile value for an entry 
	-tcfile filename	explicitly specify a translation file

    Sites settings: 
       -templatefile file 	explicitly set the template file to use 
       -sitesfile file		explicitly set the sites file to use 
       -gridftp GridFTPURL	GridFTP URL 
       -jobuniverse universe 	job manager universe
       -joburl URL 		job manager URL 
       -jobmajor major 		job mager number 
       -jobminor minor		job minor number 
       -directory dir 		work directory 
       -exprovider name         execution provider 
       -exmanager name		execution job manager 
       -exurl URL		execution URL 
       -key key 		profile key 
       -value value 		profile value 
       -namespace name 		profile namespace

EXAMPLES
    List all templates available for adding:
	swiftconfig -templates

    Add a site from template into working sites.xml:
	 swiftconfig -add teraport

    Modify the work directory of a site:
	 swiftconfig -modify teraport -directory /var/tmp

    Remove a site:
	swiftconfig -remove teraport

    Add a new command to translation catalog:
	swiftconfig -name convert -path /usr/local/bin/convert

    Modify an existing command in the translation catalog:
	swiftconfig -name convert -path /usr/bin/convert

    Remove a command from the translation catalog:
	swiftconfig -remove convert

CAVEATS
    Swiftconfig will attempt to automatically determine the location of
    swift configuration files. It first checks for an environment variable
    called $SWIFT_HOME. If that is not found, it will look for the location
    of "swift" in the path, and try to find the configuration files from
    there. This default behavior can be overwridden by manually specifying
    the location of files with -templatefile, -sitesfile, and -tcfile.

    The XML library that swiftconfig uses ignores comments in XML. All
    comments will be stripped from sites.xml as it gets modified.