caTissue Upgrade notes

== p5 -> v1.2 ==

The first deployed version of caTissue at the LCBRU was v1.1.p5 - in April 2011 v1.2 was released.

Notes from initial upgrade testing:

jboss must be stopped before upgrade takes place, or it will fail.

Initial upgrade command is 'ant upgrade_p5'

Once database is correctly migrated, further deployments of the caTissue to account for changes to the caTissueInstall.properties file can be made by 'ant deploy_app'.

== v1.2 -> CaTissuePlus ==

In January 2013 we began a move to CaTissuePlus, formally supported by Krishagni. This co-incided with migration from the legacy hardware to the University LAMP service. Work was conducted and validated on https://lcbru-catissue-dev.rcs.le.ac.uk/ including testing the API client 'sampler' app.

There were a number of issues:

* Initially the API client failed because barcodes were being automatically assigned by CaTissue - this is the default behaviour of the application but LCBRU deployment approach is to disable this feature and assign all barcodes manually.

* There was a backend java / hibernate error reported regarding a missing column 'WUSTLKEY' which related to users being identified at login time. This did not affect the functioning of the API client but was resolved with a database amendment anyway:
> alter table csm_migrate_user change MIGRATED_LOGIN_NAME WUSTLKEY  varchar(100);

* There were issues with the use of the load balancer on the LAMP service and mod_proxy being used to forward requests, which meant that secure addressing was not required in WEB-INF/flex/services-config.xml - the my-secure-amf channel endpoint class needed to be changed to AMFEndpoint not AMFSecureEndpoint.

* The API 'sampler' app did not work with CaTissuePlus v2.0 -  JBOSS returned "ERROR 2013-01-23 11:45:21,814 -catissuecore.client.__CaCoreAppServicesDelegator - Delegate Editnull, java.lang.NullPointerException". A patched version was supplied by Atul Kaushal on 25.1.2013 which was tested and found to work on 28.1.2013. Further testing was conducted oin parallel with live data processing that week.