Toggle navigation
Dataverse Project
About
About the Project
Add Data
Blog
Presentations
Publications
Community
Best Practices
Academic Credit
Harvard Dataverse Policies
Data Management
Replication Dataset Guidelines
Software
Features
Source Code
User Guide
Installation Guide
API Guide
Developer Guide
Contact
User Guide
Installation Guide
Introduction
Preparation
Prerequisites
Installation
Configuration
Administration
Upgrading
TwoRavens Tabular Data Exploration Tool
Shibboleth
OAuth Login: ORCID, GitHub, Google
API Guide
Developer Guide
Admin Guide
Installation Guide
ΒΆ
Contents:
Introduction
Quick Links
Intended Audience
Related Guides
Getting Help
Improving this Guide
Preparation
Choose Your Own Installation Adventure
Vagrant (for Testing Only)
Pilot Installation
Advanced Installation
Architecture and Components
System Requirements
Hardware Requirements
Software Requirements
Decisions to Make
Next Steps
Prerequisites
Java
Installing Java
Glassfish
Installing Glassfish
Glassfish Init Script
PostgreSQL
Installing PostgreSQL
Configuring Database Access for the Dataverse Application (and the Dataverse Installer)
Solr
Installing Solr
Solr Init Script
Securing Solr
jq
Installing jq
ImageMagick
Installing and configuring ImageMagick
Installation
Running the Dataverse Installer
Logging In
Superuser Account
Troubleshooting
Dataset Cannot Be Published
Problems Sending Email
UnknownHostException While Deploying
Fresh Reinstall
Drop database
Clear Solr
Deleting uploaded files
Rerun Installer
Configuration
Securing Your Installation
Changing the Superuser Password
Blocking API Endpoints
Forcing HTTPS
Additional Recommendations
Solr
schema.xml
jetty.xml
Network Ports
Root Dataverse Configuration
Root Dataverse Permissions
Publishing the Root Dataverse
Persistent Identifiers and Publishing Datasets
Customizing the Root Dataverse
Auth Modes: Local vs. Remote vs. Both
JVM Options
dataverse.fqdn
dataverse.siteUrl
dataverse.files.directory
dataverse.auth.password-reset-timeout-in-minutes
dataverse.rserve.host
dataverse.rserve.port
dataverse.rserve.user
dataverse.rserve.tempdir
dataverse.rserve.password
dataverse.dropbox.key
dataverse.path.imagemagick.convert
dataverse.dataAccess.thumbnail.image.limit
dataverse.dataAccess.thumbnail.pdf.limit
doi.baseurlstring
doi.username
doi.password
dataverse.handlenet.admcredfile
dataverse.handlenet.admprivphrase
Database Settings
:BlockedApiPolicy
:BlockedApiEndpoints
:BlockedApiKey
BuiltinUsers.KEY
:SystemEmail
:FooterCopyright
:DoiProvider
:Protocol
:Authority
:DoiSeparator
:ApplicationTermsOfUse
:ApplicationPrivacyPolicyUrl
:ApiTermsOfUse
:GuidesBaseUrl
:GuidesVersion
:MetricsUrl
:StatusMessageHeader
:MaxFileUploadSizeInBytes
:TabularIngestSizeLimit
:ZipUploadFilesLimit
:GoogleAnalyticsCode
:SolrHostColonPort
:SignUpUrl
:TwoRavensUrl
:TwoRavensTabularView
:GeoconnectCreateEditMaps
:GeoconnectViewMaps
:GeoconnectDebug
:DatasetPublishPopupCustomText
:DatasetPublishPopupCustomTextOnAllVersions
:SearchHighlightFragmentSize
:ScrubMigrationData
:MinutesUntilConfirmEmailTokenExpires
:DefaultAuthProvider
:AllowSignUp
:PiwikAnalyticsId
:PiwikAnalyticsHost
:FileFixityChecksumAlgorithm
Administration
Solr Search Index
Full Reindex
Clear and Reindex
Clearing Data from Solr
Start Async Reindex
Reindex in Place
Clear Index Timestamps
Start or Continue Async Reindex
Glassfish
Monitoring
Maintenance
User Administration
Confirm Email
Deleting an API Token
Upgrading
TwoRavens Tabular Data Exploration Tool
0. PREREQUISITES
a. httpd (Apache):
b. R:
c. rApache:
d. Install system depencies:
1. Set Up R
2. Install the TwoRavens Application
a. download the app
b. unzip
c. run the installer
d. Ports configuration
Appendix
r-setup.sh script:
install.pl script:
I. Configure the TwoRavens web (Javascript) application
II. Configure the R applications to run under rApache
a. Edit the following files:
b. Edit dataexplore/rook/rooksource.R
c. Edit the following lines in dataexplore/rook/rookutils.R:
d. Add the following lines to /etc/httpd/conf/httpd.conf:
e. Create the following directories and chown them user apache:
f. chown the dataexplore directory
g. restart httpd
III. Enable TwoRavens’ Explore Button in Dataverse
Shibboleth
Introduction
Installation
System Requirements
Install Apache
Install Shibboleth
Enable Shibboleth Yum Repo
Install Shibboleth Via Yum
Configure Glassfish
Apply GRIZZLY-1787 Patch
Glassfish HTTP and HTTPS ports
AJP
SSLEngine Warning Workaround
Configure Apache
Enforce HTTPS
Edit Apache ssl.conf File
Configure Shibboleth
shibboleth2.xml
Specific Identity Provider(s)
Identity Federation
Shibboleth Attributes
attribute-map.xml
Disable or Reconfigure SELinux
Disable SELinux
Reconfigure SELinux to Accommodate Shibboleth
Put Type Enforcement (TE) File in misc directory
Navigate to misc directory
Run checkmodule
Run semodule_package
Run semodule
Restart Apache and Shibboleth
Configure Apache and shibd to Start at Boot
Verify DiscoFeed and Metadata URLs
Add the Shibboleth Authentication Provider to Dataverse
Exchange Metadata with Your Identity Provider
Backup sp-cert.pem and sp-key.pem Files
Debugging
Converting Accounts
Converting Local Users to Shibboleth
Converting Shibboleth Users to Local
Institution-Wide Shibboleth Groups
OAuth Login: ORCID, GitHub, Google
Introduction
Setup
Identity Provider Side
Obtain Client ID and Client Secret
Dataverse Side
Converting Local Users to OAuth
Converting OAuth Users to Local