[jira] Commented: (UIMA-1222) PEAR Installer: environment variables

["Marshall Schor (JIRA)" <ui...@incubator.apache.org>]

    [ https://issues.apache.org/jira/browse/UIMA-1222?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12644123#action_12644123 ] 

Marshall Schor commented on UIMA-1222:
--------------------------------------

Clarification: metadata/setenv.txt is not read by the UIMA framework anywhere - it's a write-only file :-)  It's there for use by non-UIMA application code if that code wants to set environment variables.

One such application could be UIMA Repositories.  But those applications are more likely perhaps to read the PEAR XML descriptor directly and perhaps set environment variables from that specification.  

The metadata/setenv.txt is just a "convenience" file duplicating what's in the xml.

The setenv.txt file has 2 special variables: the CLASSPATH and the PATH.  The CLASSPATH is computed from any supplied CLASSPATH environment variable, plus the jars that are configured in the PEAR structure, including subcomponents.  The PATH is similarly computed, using any supplied PATH environment variable plus it includes the "bin" subdirectory of the PEAR structure, if it exists.  

See the code in uimaj-core, src/main/java/org/apache/uima/pear/tools/InstallationController.java.  Look for "setenv".



> PEAR Installer: environment variables
> -------------------------------------
>
>                 Key: UIMA-1222
>                 URL: https://issues.apache.org/jira/browse/UIMA-1222
>             Project: UIMA
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 2.2.2
>         Environment: all
>            Reporter: Eric Riebling
>            Priority: Minor
>   Original Estimate: 0.17h
>  Remaining Estimate: 0.17h
>
> Some users may believe that if they add variables to those that end up in metadata/setenv.txt, that they become available to Components packaged within a PEAR.  As it turns out, they are available only if the Component explicitly looks in metadata/setenv.txt.  But I understand they ARE available as properties.  Perhaps some text explaining this could be added to the PEAR Packager documentation to help clarify.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.