Elive is a set of Perl modules for management and integration of Elluminate
Live! virtual classroom servers.

You can, for example, use it to query or add users, create sessions, assign
users as class participants and change server settings.

This package has been tested against Elluminate Live! versions 9.0 thru 9.1.

You will need to be able to login in to your SOAP service using an Elluminate
system administrator level account.

Note that Elluminate installs with 'serversupport' and 'legacyadapter' as
preset system adminstrator accounts. Don't forget to change password for
both these accounts before use!

INSTALLATION

To install this module, run the following commands:

	perl Makefile.PL
	make
	make test
	make install

POST INSTALLATION

    elive_lint_config

        This script will check for missing adapters.

        It is recommended that you run this script on your Elluminate
        Live site configuration files.

        For a Unix server the configration for path http://myserver/mysite/
        should be found under:

             /opt/ElluminateLive/manager/tomcat/webapps

	or under Windows:

	     C:/Program Files/ElluminateLive/manager/tomcat/webapps

        The actual configuration is then in the sub-path:

	     ROOT/WEB-INF/resources/configuration.xml

         or for any additional sites built with the instance manager:

	     mysite/WEB-INF/resources/configuration.xml

        If any adapters are missing, the corresponding Elive calls will
        return the error message 'Unable to determine a command for the key
        Xxxxx'.

	If you get this error, please check that your Elluminate Live
	software is up-to-date. I.e. you've installed all upgrades and
	the SDK. This version Elive has only been tested against 9.0
	and 9.1.

	You may be able to get away with manually adding the adapter
	to the list of adapters in your configuration file.

	For example, if elive_lint_config returned the error:

	    "missing adapter command: getUser"

	You'll need to first stop Elluminate services.

	Save a backup copy of configuration.xml Then you can add an adapter
        entry can be added to the list of adapters.

        E.g., to add the getUser adapter:

	    <elm>
		...
		<adapters>
		   <adapter>
                      <commands>
		        ...
                        <command name="getUser" class="com.elluminate.adapter.command.GetUserCommand" />


    elive_query

        This is a simple shell that can be used to test basic access
        to your Elluminate Live server

        Usage is: elive_query --user SomeAdmin http://myserver/mysite

	Where SomeAdmin is an Elluminate system administrator account.

        You will need to enter a password. You should then get:

	    connecting to http://myserver/mysite...done
            Elive query 0.nn (Elluminate Live 9.x.y) - type 'help' for help
            elive>

        You can then try a simple query:

            elive> select * from users


SUPPORT AND DOCUMENTATION

See the Elluminate Live documentation. In particular, this package
follows the entities and relationships described in DatabaseSchema.pdf.

You will find a copy on the installation disk. Or if you have access to the
server, you will will typically find this in /opt/Elluminate/documentation. 

After installing, you can find documentation for this module with the
perldoc command.

    perldoc Elive

You can also look for information at:

    RT, CPAN's request tracker
        http://rt.cpan.org/NoAuth/Bugs.html?Dist=Elive

    AnnoCPAN, Annotated CPAN documentation
        http://annocpan.org/dist/Elive

    CPAN Ratings
        http://cpanratings.perl.org/d/Elive

    Search CPAN
        http://search.cpan.org/dist/Elive/


COPYRIGHT AND LICENCE

Copyright (C) 2009 David Warring

This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.

