Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

About

In order to avoid unnecessary duplication of data across institutions, increase standardization, and ease as much of the burden of data entry on users as possible we have introduced a new concept of 'Commonly Used Resources'. This concept has been internally referenced as 'globals' and this is reflected in the choice of property names. These resources will reside in central repository, maintained by the eagle-i team, that all institutions will have read-access to.  As of the 2.0-MS1.0 release, only resources that have a type of Organization are eligible for 'Commonly Used Resources' values.  Specifically, 'Commonly Used Resources' will be generated for the types: Private Company and Funding Organization.

This feature will affect the following applications:

...

When a resource contains a reference to a 'Commonly Used Resources', the search application will treat this as a normal resource, which happens to reside in a repository 'global' as opposed to a specific institution.  In this document, the 'client' will be the repository that is receiving the minimal information about global resources into its own proxy graph.  The 'server' will be the repository where the full resource information resides.

Activation

To activate this feature, the following must take place:

...

  • Create a user for the repository which has the role of 'Automated Agent', i.e. iAmGlobalUser
    • The Automated Agent role has add, remove, read access to the GlobalProxy graph.
  • Add the following properties to the non-credentialed properties file:
    • eaglei.datatools.uses.globals
    • eaglei.datatools.globalRepository
    • Wiki Markup
      \[TODO\] Optional properties
    • Wiki Markup
      \[TODO\] Update properties document
  • Add the following properties to the credentialed properties file:
    • Wiki Markup
      \[TODO\]
  • Add a new / edit whoami.xml file
    • Wiki Markup
      \[TODO: <global></global>\]

Data Migration

...

Wiki Markup
\[TODO\] How to migrate existing data to use the globals&nbsp;

Advanced

...

Topics

Wiki Markup
\[TODO\] Details about the implementation

Wiki Markup
\[TODO\] global annotation on type

Wiki Markup
\[TODO\] Use of the proxy ng

Wiki Markup
\[TODO\] Global instances are not searchable as a resource themselves

Wiki Markup
\[TODO\] NB: Tomcat will appear to take a little bit longer to shut down. &nbsp;This is expected because of the code for the global harvesting.

Troubleshooting

  • I can't see any commonly used resources as options for Private Company and Funding Organization in my SWEET.
    1. Verify that your repository successfully harvested the globals
      1. Wiki Markup
        \[TODO\] expected logs for successful global harvest
    2. Verify that your properties have been configured
      1. Wiki Markup
        \[TODO\] expected logs for correct configuration
      2. Wiki Markup
        \[TODO\] example logs of incorrect configurations