Virtual Journal Installation/Configuration

Configuration File

• /etc/topaz/ambra.xml

Defaults

• ambra.xml is currently pre-configured for:
  • PLoSONE
    • installed as the default webapp, ROOT
  • PLoSClinicalTrials
    • installed as /journals/clinicalTrials
    • virtual journal is active when http host matches the regex clinicaltrials\..*
  • PLoSNTD
    • installed as /journals/ntd
    • virtual journal is active when http host matches the regex plosntds\..*
  • PLoSCompBiol, PLoSGenetics, PLoSPathogens

Modifying the Configuration

Creating a Virtual Journal Configuration

• create a folder in ambra/journals. use the existing journals as a guide.

• add a pub.virtualJournals entry for the new journal in the journal-specific defaults.xml
  • <pub><virtualJournals>

          <${myJournal}>
            <description>${display for Admin, etc.}</description>
            <mappingPrefix>${URI path prefix for virtual journal resources}</mappingPrefix>
            <rules>
              <${httpHeader}>${regex to match against HTTP Header value}</${httpHeader}>
              <${httpHeader}>${regex to match against HTTP Header value}</${httpHeader}>
            </rules>
          </${myJournal}>
    

  • note that the mappingPrefix should correspond to the webapp installation directory

• in ambra.xml, add the journal name to pub.virtualJournals.journals (a comma separated list of journal names)
  • <journals>PLoSClinicalTrials,${myJournal}</journals>

• build rpms

---

Creating A Virtual Journal In the Database

Journals are now created automatically on ambra startup.

Virtual Journal Administration

Once a Journal has been created, it can be administered:

/admin/manageVirtualJournals.action

from the admin console.

Membership in a Journal can also be selected while ingesting Articles from the admin console.

Ambra will need to be re-started to refresh the Journal cache.

---

Testing

A simple way to test virtual journals is to setup a rule that matches on a subdomain:

          <host>clinicaltrials\..*</host>

and then modify /etc/hosts to resolve this subdomain:

# PLoS testing
207.7.131.29    clinicaltrials.george.topazproject.org

This allows easy side-by-side comparision in a browser:

  http://george.topazproject.org:8080    http://clinicaltrials.george.topazproject.org:8080