Versions Compared

Key

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

...

...

...

...

...

...

...

...

uPortal 4.1/4.2 DB-backed PAGS store

With uPortal 4.1 there is an optional database-backed storage configuration for PAGS.  To use the default XML-based configuration, see the XML-backed PAGS instructions below.  With uPortal 4.2, the DB-backed PAGS (also called Entity-based PAGS or Entity PAGS) is the default configuration.

The advantage of the DB-backed PAGS store is that you can create or modify PAGS groups on the fly by importing the PAGS XML files so it is more dynamic than the XML-backed PAGS .  Also DB-backed PAGS groups are required for certain features such as Multi-Tenancy that require dynamic PAGS groups.

...

Code Block
xml
xml
<?xml version="1.0" encoding="UTF-8"?>
<pags-group script="classpath://org/jasig/portal/io/import-pags-group_v4-1.crn">
    <name>All Staff (PAGS)</name>
    <description>All Staff Users</description>
    <selection-test>
      <test-group>
        <name></name><test>
        <description></description>  <attribute-name>eduPersonAffiliation</attribute-name>
      <test>           <name></name>
          <description></description>
          <attribute-name>eduPersonAffiliation</attribute-name>
          <tester-class>org<tester-class>org.jasig.portal.groups.pags.testers.StringEqualsTester</tester-class>
          <test-value>staff</test-value>
        </test>
      </test-group>
    </selection-test>
</pags-group>

...

Code Block
xml
xml
<?xml version="1.0" encoding="UTF-8"?>

<pags-group script="classpath://org/jasig/portal/io/import-pags-group_v4-1.crn">
    <name>ITS Dept (PAGS)</name>
    <description>All ITS department Users</description>
    <selection-test>
      <test-group>
        <name></name>
        <description></description>
        <test>
          <name></name>
          <description></description>
          <attribute-name>ou</attribute-name>
          <tester-class>org.jasig.portal.groups.pags.testers.StringEqualsTester</tester-class>
          <test-value>ITS</test-value>
        </test>
      </test-group>
    </selection-test>
</pags-group>
 

...

Upgrading from XML-backed PAGS to database-backed PAGS

1. Update code base to 4.1

 2. Incorporate your custom changes from PAGSGroupStoreConfig.xml into separate *.pags-group.xml files in uportal-war/src/main/data/default_entities/pags-group

 3. Alter uportal-war/src/main/resources/properties/groups/compositeGroupServices.xml to switch from XML-based to database-based PAGS groups.

...