Changes between Version 2 and Version 3 of GSAS/iRODSDescriptorProcessing


Ignore:
Timestamp:
07/21/13 23:12:36 (11 years ago)
Author:
Antoine de Torcy
Comment:

First stab at listing full set of instructions

Legend:

Unmodified
Added
Removed
Modified
  • GSAS/iRODSDescriptorProcessing

    v2 v3  
    99
    1010It all happens in /geniRenci/home/public/md_tests/ .
    11 If file is uploaded under that collection with a filename matching one of the GENI Object Descriptor XML files ( http://groups.geni.net/geni/wiki/GSAS#a3GENIObjectDescriptorSchema ), the file's content is parsed and turned into iRODS metadata that gets associated to the file (object) itself.
     11If a file is uploaded under that collection with a filename matching one of the GENI Object Descriptor XML files ( http://groups.geni.net/geni/wiki/GSAS#a3GENIObjectDescriptorSchema ), the file's content is parsed and turned into iRODS metadata that gets associated to the file (object) itself.
    1212
    1313=== Instructions ===
    1414
    15 * First you will need the GSAS descriptor files. Go to: http://groups.geni.net/geni/wiki/GSAS#a3GENIObjectDescriptorSchema , click on one or more of the five v1.1 examples. Click on the filename to see its contents (which will become iRODS metadata) and from there click 'original format' (bottom of page) to download it onto your desktop. You need to have it on your desktop to later upload it into iRODS.
     15 * First you will need the GSAS descriptor files. Go to: http://groups.geni.net/geni/wiki/GSAS#a3GENIObjectDescriptorSchema , click on one or more of the five v1.1 examples. Click on the filename to see its contents (which will become iRODS metadata) and from there click 'original format' (bottom of page) to download it onto your desktop. You need to have it on your desktop to later upload it into iRODS.
    1616
    17 * If you are familiar with using iDrop-web you can speed through the navigation steps below.
     17 * If you are familiar with using iDrop-web you can speed through the navigation steps below.
    1818
    19 * Log in to iRODS (zone geniRenci) with your account: https://geni-gimi.renci.org:8443/idrop-web2/  . Click 'Browse' on the top-level toolbar.
     19 * Log in to iRODS (zone geniRenci) with your account: https://geni-gimi.renci.org:8443/idrop-web2/  . Click 'Browse' on the top-level toolbar.
    2020
    21 * Drill down to /geniRenci/home/public/md_tests/examples/ from the left hand side tree and click on 'examples' to make sure you're in that collection.
     21 * Drill down to /geniRenci/home/public/md_tests/examples/ from the left hand side tree and click on 'examples' to make sure you're in that collection.
    2222
    23 * Click 'New folder' to create your own collection under examples (since multiple users will be uploading the same files). You should now be in that collection.
     23 * Click 'New folder' to create your own collection under examples (since multiple users will be uploading the same files). You should now be in that collection.
    2424
    25 * Click 'Upload' from the collection's toolbar on the right and pick one of the xml descriptor files you downloaded from GSAS (Artifact1.xml, Experiment1.xml, Step1.xml, project1.xml, projectSerialized.xml)
     25 * Click 'Upload' from the collection's toolbar on the right and pick one of the xml descriptor files you downloaded from GSAS (Artifact1.xml, Experiment1.xml, Step1.xml, project1.xml, projectSerialized.xml)
    2626
    27 * If all goes well the object should now show up under your collection in the left hand side tree. Click the on object and then click its 'Metadata' tab.
     27 * If all goes well the object should now show up under your collection in the left hand side tree. Click the on object and then click its 'Metadata' tab.
    2828
    29 * With any other file than those five no metadata is extracted upon upload.
     29 * With any other file than those five no metadata is extracted upon upload.
    3030
    31 == Deploying this rule on your own iRODS server ==
     31== Deploying this on your own iRODS server ==
    3232
     33 * This assumes that you are the administrator of an iRODS server. You might also need unix admin privilege if missing packages have to be installed. This set of tools is a work in progress and should be considered experimental. Having said that you are welcome to try it out on your own iRODS server, and certainly welcome to improve on it.
     34
     35 * You will need to enable the XML iRODS module. First make sure that libxml2 and libxslt (along with their respective *-dev or *-devel packages, for headers) are installed on the host where your iRODS server is running. See comments in iRODS/modules/XML/Makefile, lines 40-52.
     36
     37 * Enable the XML module by setting 'enabled: yes' in iRODS/modules/XML/info.txt. Then run './scripts/configure' and 'make clean; make' from your iRODS top level directory.
     38
     39 * Download geni.re, core.dvm, and geniObject.xsl, attached below, to your desktop.
     40
     41 * Because this demo (in its current form) works in a given collection you need to decide what that collection will be and create it if needed. Upload geniObject.xsl into your iRODS instance and make it public readable (ichmod read public /your_zone/.../geniObject.xsl).
     42
     43 * Now edit geni.re and at line 55 replace '*xsltObjPath="/geniRenci/home/public/md_tests/files/geniObject.xsl"' with the iRODS path of your geniObject.xsl. You also need to edit the conditions of the acPostProcForXXX rules so that they use your own collection instead of /geniRenci/home/public/md_tests/ in ($objPath like "/geniRenci/home/public/md_tests/*"). There should be 3 substitutions to make: line 1, 14 and 30.
     44
     45 * Add geni.re and core.dvm to your iRODS/server/config/reConfigs/ directory. This new version of core.dvm should replace your existing one.
     46
     47 * Edit your iRODS/server/config/server.config as follows (geni listed first, no space after the comma). This will add geni.re to your server's rule set and the geni rules will be tried before those in core.
     48{{{
     49#reRuleSet   core
     50reRuleSet   geni,core
     51}}}
     52
     53 * This should be it. Try uploading a file in your demo collection and check its metadata. Upon success your latest iRODS/server/log/rodsLog.YYYY.MM.DD should mention: [acGeniMetadataExtract] Added metadata to /your_zone/..../blah.xml. Upon failure your current rodsLog would also be the first place to look for additional information.