Modern, Officially-Endorsed Installation Procedure?

[jamiejackson]

The README, as it stands, advises to install it via adding a provider in the admin and then installing the application once it's listed.

However, a project contributor mentioned that the provider's site is out-of-date and no longer maintained, and that a zip installation is recommended:

@Leigh- commented on May 16, 2013:

Also, the web site is a few versions behind unfortunately. The latest version is here: https://github.com/andyj/RailoExtensionProvider/blob/master/cfspreadsheetInstaller.zip

I'm on Railo 4.2.1.000 final and trying to follow this advice, but when I attempt to install the zip (at the time of this writing, this version) via the "Extension > Applications > Upload new extension", it fails with "There is no config.xml file available in the extension!"

What is the proper way to install this extension today? I'm hoping to hear from a contributor so we all can know what the "endorsed" installation procedure is. Then we can figure out if the procedure works or if it needs some tweaks.

[apendrag0n3]

and the cfspreadsheetinstaller_v32.zip file that I found through a million google searches - also fails

[boughtonp]

it fails with "There is no config.xml file available in the extension!"

The error message is describing the problem - the zip file used doesn't contain a config.xml file.

The zip file with the config.xml in is cfpoi.zip - and that is where the readme should be directing people to. (Most people don't need their own extension provider; this installer zip is just causing confusion.)

Unfortunately, it's still not quite that simple - I checked it on Railo 4.2.1 and using the correct zip results in Railo outputting the following error after upload:

The Config xml file within the extension does not contain the necessary [info] section within the [config] tag.
Please review the documentation for creating Railo Extensions.

Despite what it says there, the documentation doesn't (afaict) provide details of what the required fields for config.xml are - adding an info tag then complains about the lack of an id, then name, label, etc - it seems unnnecessarily fussy for Railo to be asking for all these, but I guess following the lead of a newer extension should work.

However, when I threw together a dummy config.xml I encountered this Railo issue: https://issues.jboss.org/browse/RAILO-2502

So, currently, to install this extension without going via an Extension Provider requires doing so manually (as per install method in the installFolder.cfc file).

[jamiejackson]

Overhauled the README and created a pull request.