-
Notifications
You must be signed in to change notification settings - Fork 487
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #1 from IQSS/develop
merge iqss develop into mdm develop
- Loading branch information
Showing
42 changed files
with
1,227 additions
and
432 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
We should note that duplicate files are now allowed, and installations may want to contact people now that this is available. Point to rules in the Guides. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,6 @@ | ||
The setting :PIDAsynchRegFileCount is deprecated as of v5.0. | ||
|
||
It used to specify the number of datafiles in the dataset to warrant | ||
adding a lock during publishing. As of v5.0 all datasets get | ||
locked for the duration of the publishing process. The setting will be | ||
ignored if present. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,82 @@ | ||
Upgrade Dataverse from Glassfish 4.1 to Payara 5 | ||
================================================ | ||
|
||
The instruction below describes the upgrade procedure based on moving an existing glassfish4 domain directory under Payara. We recommend this method, instead of setting up a brand-new Payara domain using the installer because it appears to be the easiest way to recreate your current configuration and preserve all your data. | ||
|
||
Download Payara, v5.2020.2 as of this writing: | ||
|
||
# curl -L -O https://github.com/payara/Payara/releases/download/payara-server-5.2020.2/payara-5.2020.2.zip | ||
# sha256sum payara-5.2020.2.zip | ||
1f5f7ea30901b1b4c7bcdfa5591881a700c9b7e2022ae3894192ba97eb83cc3e | ||
|
||
Unzip it somewhere (/usr/local is a safe bet) | ||
|
||
# sudo unzip payara-5.2020.2.zip -d /usr/local/ | ||
|
||
Copy the Postgres driver to /usr/local/payara5/glassfish/lib | ||
|
||
# sudo cp /usr/local/glassfish4/glassfish/lib/postgresql-42.2.9.jar /usr/local/payara5/glassfish/lib/ | ||
|
||
Move payara5/glassfish/domains/domain1 out of the way | ||
|
||
# sudo mv /usr/local/payara5/glassfish/domains/domain1 /usr/local/payara5/glassfish/domains/domain1.orig | ||
|
||
Undeploy the Dataverse web application (if deployed; version 4.20 is assumed in the example below) | ||
|
||
# sudo /usr/local/glassfish4/bin/asadmin list-applications | ||
# sudo /usr/local/glassfish4/bin/asadmin undeploy dataverse-4.20 | ||
|
||
Stop Glassfish; copy domain1 to Payara | ||
|
||
# sudo /usr/local/glassfish4/bin/asadmin stop-domain | ||
# sudo cp -ar /usr/local/glassfish4/glassfish/domains/domain1 /usr/local/payara5/glassfish/domains/ | ||
|
||
Remove the Glassfish cache directories | ||
|
||
# sudo rm -rf /usr/local/payara5/glassfish/domains/domain1/generated/ | ||
# sudo rm -rf /usr/local/payara5/glassfish/domains/domain1/osgi-cache/ | ||
|
||
In domain.xml: | ||
============= | ||
|
||
Replace the -XX:PermSize and -XX:MaxPermSize JVM options with -XX:MetaspaceSize and -XX:MaxMetaspaceSize. | ||
|
||
<jvm-options>-XX:MetaspaceSize=256m</jvm-options> | ||
<jvm-options>-XX:MaxMetaspaceSize=512m</jvm-options> | ||
|
||
Set both Xmx and Xms at startup to avoid runtime re-allocation. Your Xmx value should likely be higher: | ||
|
||
<jvm-options>-Xmx2048m</jvm-options> | ||
<jvm-options>-Xms2048m</jvm-options> | ||
|
||
Add the below JVM options beneath the -Ddataverse settings: | ||
|
||
<jvm-options>-Dfish.payara.classloading.delegate=false</jvm-options> | ||
<jvm-options>-XX:+UseG1GC</jvm-options> | ||
<jvm-options>-XX:+UseStringDeduplication</jvm-options> | ||
<jvm-options>-XX:+DisableExplicitGC</jvm-options> | ||
|
||
Change any full pathnames /usr/local/glassfish4/... to /usr/local/payara5/... or whatever it is in your case. (Specifically check the -Ddataverse.files.directory and -Ddataverse.files.file.directory JVM options) | ||
|
||
In domain1/config/jhove.conf, change the hard-coded /usr/local/glassfish4 path, as above. | ||
|
||
(Optional): If you renamed your service account from glassfish to payara or appserver, update the ownership permissions. The Installation Guide recommends a service account of `dataverse`: | ||
|
||
# sudo chown -R dataverse /usr/local/payara5/glassfish/domains/domain1 | ||
# sudo chown -R dataverse /usr/local/payara5/glassfish/lib | ||
|
||
You will also need to check that the service account has write permission on the files directory, if they are located outside the old Glassfish domain. And/or make sure the service account has the correct AWS credentials, if you are using S3 for storage. | ||
|
||
Finally, start Payara: | ||
|
||
# sudo -u dataverse /usr/local/payara5/bin/asadmin start-domain | ||
|
||
Deploy the Dataverse 5 warfile: | ||
|
||
# sudo -u dataverse /usr/local/payara5/bin/asadmin deploy /path/to/dataverse-5.0.war | ||
|
||
Then restart Payara: | ||
|
||
# sudo -u dataverse /usr/local/payara5/bin/asadmin stop-domain | ||
# sudo -u dataverse /usr/local/payara5/bin/asadmin start-domain | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.