Alfresco Content Connector for EMC Centera

* Installing on Alfresco that already using the XAM-based implementation of connector.
** Use the Module Management Tool to install new version of module on the system that has old version. This will update all components appropriately.

   java -jar alfresco-mmt.jar install alfresco-centera-connector.amp alfresco.war
   
   Then go to steps below.

* Installation (Windows 64 bit):
** Download sites:
   Centera SDK:                       https://developer-content.emc.com/downloads/centera/download.htm
   Server details and .pea files:     https://community.emc.com/docs/DOC-1038
** Download and extract Centera SDK 3.3 to c:\centera.  The libraries should be in c:\centera\lib64.
** Download and drop the Centera .pea file in c:\centera.
** Ensure Java can find the libraries:
      set PATH=%PATH%;c:\centera\lib64
** Install required msvcr80.dll C runtime library version 8.0.50727.6195. 
   (available for download here http://www.microsoft.com/en-us/download/details.aspx?displaylang=en&id=26347)

* Configure Alfresco
** Install the alfresco-xamconnector.amp (using the Module Management Tool or manually)
** Configure the Centera connection using tomcat/shared/alfresco-global.properties:
      centera.url=168.159.214.24?c:/centera/c2armtesting.pea
      xam.archive.retentionPeriodDays=1
      # See the module's alfresco-global.properties for more values
** Turn on DEBUG logging for the Alfresco XAM components
      log4j.logger.org.alfresco.enterprise.repo.content.centera=DEBUG
      log4j.logger.org.alfresco.enterprise.repo.centera=DEBUG
** Add the 'xam:archive' aspect in 'share-config-custom.xml'

* Running:
** Start Tomcat and note the following in the logs:
      Starting module 'org_alfresco_module_xamconnector' version 1.6.

* Testing (Single File):
** Create a document e.g. abc.txt
** Apply aspect 'xam:archive' to the document
** Look at the metadata for the document.  The new store must be the 'xamArchive', the 'retainedUntil' date
   must have been set as well.
** Use the Node Browser to get the content URL for the node.  It must be a centera ClipID-based URL (example: contentUrl=centera://EQM2GC012MC77e72B24N2MMFU59G418ACSAIE70BAS340TN3E1JJL).
   The debug output should also show the ClipID used.

** Download JCASScript v3.2 from https://community.emc.com/docs/DOC-2393
*** Invoke the JCASScript utility by entering the following command: 
            "java -jar JCASScript.jar"
*** Type "poolOpen 168.159.214.24?c:/centera/c2armtesting.pea" to open required pool

** Check that the content binary is present and is accessible:
*** Type "clipExists ClipID" to check that C-Clip exists in Centera
*** Type "clipOpen ClipID" to open C-Clip
*** Type "clipToFile ClipID test.bin"
    Check that file test.bin is populated

** Check that retention period was set
*** Type "clipAttribs" to see all C-Clip attributes. You should see similar output:
    Name:   retention.period        Value:   86399

** Check that node and application properties have been copied over:
*** Type "tagFirst" to select the first tag of opened C-Clip
*** Type "tagAttribs" to display all attributes
       com.alfresco.xam.archive.node.sys:ref
       com.alfresco.xam.archive.app.name
       com.alfresco.xam.archive.node.cm:created
       com.alfresco.xam.archive.app.version
       com.alfresco.xam.archive.app.db
       com.alfresco.xam.archive.node.sys:path
       com.alfresco.xam.archive.node.cm:creator
       com.alfresco.xam.archive.node.cm:name
       com.alfresco.xam.archive.app.vendor
*** Type "tagClose" to close curent tag
*** Type "clipClose" to close current C-Clip
*** Type "poolClose" to close current connection to Centera pool

* Testing (Folder Hierarchy):
** Create a folder containing several files and folders
** Apply aspect 'xam:archived' to the top-level folder
** Check that the aspect has been applied to the entire hierarchy
** Choose one of the files in the hierarchy and check it according to the "Single File" checks

* Using the CenteraContentStore as the primary store (OPTIONAL)
** You will need to create a bean called 'fileContentStore' that uses the CenteraContentStore
** Copy the 'org_alfresco_module_centera_centeraContentStore' bean to a custom context and rename it to 'fileContentStore'
** This cannot be done retrospectively unless all content is moved from the filesystem to Centera