From e3da19f3088312d5394dd0541f19dd67b89e2d2d Mon Sep 17 00:00:00 2001 From: Philip Durbin Date: Fri, 11 Aug 2023 16:54:21 -0400 Subject: [PATCH 1/9] add upgrade instructions for Payara 5 to 6 #9340 --- doc/release-notes/9340-payara5to6.md | 95 ++++++++++++++++++++++++++++ 1 file changed, 95 insertions(+) create mode 100644 doc/release-notes/9340-payara5to6.md diff --git a/doc/release-notes/9340-payara5to6.md b/doc/release-notes/9340-payara5to6.md new file mode 100644 index 00000000000..360834217ef --- /dev/null +++ b/doc/release-notes/9340-payara5to6.md @@ -0,0 +1,95 @@ +## Upgrade from Payara 5 to Payara 6 + +1. Download Payara 6.2023.7 as of this writing: + + `curl -L -O https://nexus.payara.fish/repository/payara-community/fish/payara/distributions/payara/6.2023.7/payara-6.2023.7.zip` + +1. Unzip it to /usr/local (or your preferred location) + + `sudo unzip payara-6.2023.7.zip -d /usr/local/` + +1. Change ownership of the unzipped Payara to your "service" user ("dataverse" by default) + + `sudo chown -R dataverse /usr/local/payara6` + +1. Undeploy Dataverse (if deployed; version 5.14 is assumed in the example below) + + `sudo /usr/local/payara5/bin/asadmin list-applications` + + `sudo /usr/local/payara5/bin/asadmin undeploy dataverse-5.14` + +1. Stop Payara 5 + + `sudo /usr/local/payara5/bin/asadmin stop-domain` + +1. Copy Dataverse-related lines from Payara 5 to Payara 6 domain.xml + + `sudo cp /usr/local/payara6/glassfish/domains/domain1/config/domain.xml /usr/local/payara6/glassfish/domains/domain1/config/domain.xml.orig` + + `sudo egrep 'dataverse|doi' /usr/local/payara5/glassfish/domains/domain1/config/domain.xml > lines.txt` + + `sudo vi /usr/local/payara6/glassfish/domains/domain1/config/domain.xml` + + The lines will be part of three sections, shown below, but your content will vary. + + Section 1: mail resource (under ``) + + ``` + + ``` + + Section 2: system properties (under ``) + + ``` + + + + + + ``` + + Section 3: JVM options (under ``) + + ``` + -Ddataverse.files.directory=/usr/local/dvn/data + -Ddataverse.files.file.type=file + -Ddataverse.files.file.label=file + -Ddataverse.files.file.directory=/usr/local/dvn/data + -Ddataverse.rserve.host=localhost + -Ddataverse.rserve.port=6311 + -Ddataverse.rserve.user=rserve + -Ddataverse.rserve.password=rserve + -Ddataverse.auth.password-reset-timeout-in-minutes=60 + -Ddataverse.timerServer=true + -Ddataverse.fqdn=dev1.dataverse.org + -Ddataverse.siteUrl=https://dev1.dataverse.org + -Ddataverse.files.storage-driver-id=file + -Ddoi.username=testaccount + -Ddoi.password=notmypassword + -Ddoi.baseurlstring=https://mds.test.datacite.org/ + -Ddoi.dataciterestapiurlstring=https://api.test.datacite.org + ``` + +1. Copy jhove.conf from Payara 5, edit and change payara5 to payara6 + + `sudo cp /usr/local/payara5/glassfish/domains/domain1/config/jhove.conf /usr/local/payara6/glassfish/domains/domain1/config/jhove.conf` + + `sudo chown dataverse /usr/local/payara6/glassfish/domains/domain1/config/jhove.conf` + + `sudo -u dataverse vi /usr/local/payara6/glassfish/domains/domain1/config/jhove.conf` + +1. Start Payara: + + `sudo -u dataverse /usr/local/payara6/bin/asadmin start-domain` + +1. Deploy the Dataverse 6.0 warfile: + + `sudo -u dataverse /usr/local/payara6/bin/asadmin deploy /path/to/dataverse-6.0.war` + +1. Check that you get a version number from Dataverse: + + `curl http://localhost:8080/api/info/version` + +1. Create the network listener on port 8009 + + `sudo -u dataverse /usr/local/payara6/bin/asadmin create-network-listener --protocol http-listener-1 --listenerport 8009 --jkenabled true jk-connector` \ No newline at end of file From 88efc55c710d5e085ec60e3fbadb6d25a2d65e54 Mon Sep 17 00:00:00 2001 From: Don Sizemore Date: Tue, 15 Aug 2023 14:21:35 -0400 Subject: [PATCH 2/9] #9340 revise upgrade instructions --- doc/release-notes/9340-payara5to6.md | 42 ++++++++++++++++++++-------- 1 file changed, 31 insertions(+), 11 deletions(-) diff --git a/doc/release-notes/9340-payara5to6.md b/doc/release-notes/9340-payara5to6.md index 360834217ef..79947545303 100644 --- a/doc/release-notes/9340-payara5to6.md +++ b/doc/release-notes/9340-payara5to6.md @@ -4,25 +4,25 @@ `curl -L -O https://nexus.payara.fish/repository/payara-community/fish/payara/distributions/payara/6.2023.7/payara-6.2023.7.zip` -1. Unzip it to /usr/local (or your preferred location) +1. Unzip it to /usr/local (or your preferred location): `sudo unzip payara-6.2023.7.zip -d /usr/local/` -1. Change ownership of the unzipped Payara to your "service" user ("dataverse" by default) +1. Change ownership of the unzipped Payara to your "service" user ("dataverse" by default): `sudo chown -R dataverse /usr/local/payara6` -1. Undeploy Dataverse (if deployed; version 5.14 is assumed in the example below) +1. Undeploy Dataverse (if deployed, using the unprivileged service account. Version 5.14 is assumed in the example below): - `sudo /usr/local/payara5/bin/asadmin list-applications` + `sudo -u dataverse /usr/local/payara5/bin/asadmin list-applications` - `sudo /usr/local/payara5/bin/asadmin undeploy dataverse-5.14` + `sudo -u dataverse /usr/local/payara5/bin/asadmin undeploy dataverse-5.14` -1. Stop Payara 5 +1. Stop Payara 5: `sudo /usr/local/payara5/bin/asadmin stop-domain` -1. Copy Dataverse-related lines from Payara 5 to Payara 6 domain.xml +1. Copy Dataverse-related lines from Payara 5 to Payara 6 domain.xml: `sudo cp /usr/local/payara6/glassfish/domains/domain1/config/domain.xml /usr/local/payara6/glassfish/domains/domain1/config/domain.xml.orig` @@ -48,6 +48,8 @@ ``` + Note: if you used the Dataverse installer, you won't have a `dataverse.db.password` property. See "Create Password Aliases" below. + Section 3: JVM options (under ``) ``` @@ -70,18 +72,31 @@ -Ddoi.dataciterestapiurlstring=https://api.test.datacite.org ``` -1. Copy jhove.conf from Payara 5, edit and change payara5 to payara6 +1. Copy jhove.conf and jhoveConfig.xsd from Payara 5, edit and change payara5 to payara6 - `sudo cp /usr/local/payara5/glassfish/domains/domain1/config/jhove.conf /usr/local/payara6/glassfish/domains/domain1/config/jhove.conf` + `sudo cp /usr/local/payara5/glassfish/domains/domain1/config/jhove* /usr/local/payara6/glassfish/domains/domain1/config/` - `sudo chown dataverse /usr/local/payara6/glassfish/domains/domain1/config/jhove.conf` + `sudo chown dataverse /usr/local/payara6/glassfish/domains/domain1/config/jhove*` `sudo -u dataverse vi /usr/local/payara6/glassfish/domains/domain1/config/jhove.conf` +1. Update systemd unit file (or other init system) to from `/usr/local/payara5` to `/usr/local/payara6`, if applicable. + 1. Start Payara: `sudo -u dataverse /usr/local/payara6/bin/asadmin start-domain` +1. If you're using password aliases for your database, rserve and datacite jvm-options, recreate them here: + + ``` + $ echo "AS_ADMIN_ALIASPASSWORD=yourDBpassword" > /tmp/dataverse.db.password.txt + $ sudo -u dataverse /usr/local/payara6/bin/asadmin create-password-alias --passwordfile /tmp/dataverse.db.password.txt + Enter the value for the aliasname operand> dataverse.db.password + Command create-password-alias executed successfully. + ``` + + You'll want to perform simalar commands for `rserve_password_alias` and `doi_password_alias` if you're using Rserve and/or Datacite. + 1. Deploy the Dataverse 6.0 warfile: `sudo -u dataverse /usr/local/payara6/bin/asadmin deploy /path/to/dataverse-6.0.war` @@ -92,4 +107,9 @@ 1. Create the network listener on port 8009 - `sudo -u dataverse /usr/local/payara6/bin/asadmin create-network-listener --protocol http-listener-1 --listenerport 8009 --jkenabled true jk-connector` \ No newline at end of file + `sudo -u dataverse /usr/local/payara6/bin/asadmin create-network-listener --protocol http-listener-1 --listenerport 8009 --jkenabled true jk-connector` + +1. Perform one final Payara restart to ensure that timers are initialized properly. This example stops Payara manually, then starts Payara using systemd: + + `sudo -u dataverse /usr/local/payara6/bin/asadmin stop-domain` + `sudo systemctl start payara` \ No newline at end of file From 196c72023f4c3ad680a53886914a9b0d308856a1 Mon Sep 17 00:00:00 2001 From: Don Sizemore Date: Tue, 15 Aug 2023 15:12:58 -0400 Subject: [PATCH 3/9] #9340 respond to Phil's suggested edits --- doc/release-notes/9340-payara5to6.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/doc/release-notes/9340-payara5to6.md b/doc/release-notes/9340-payara5to6.md index 79947545303..ce41973c874 100644 --- a/doc/release-notes/9340-payara5to6.md +++ b/doc/release-notes/9340-payara5to6.md @@ -48,7 +48,7 @@ ``` - Note: if you used the Dataverse installer, you won't have a `dataverse.db.password` property. See "Create Password Aliases" below. + Note: if you used the Dataverse installer, you won't have a `dataverse.db.password` property. See "Create password aliases" below. Section 3: JVM options (under ``) @@ -72,6 +72,8 @@ -Ddoi.dataciterestapiurlstring=https://api.test.datacite.org ``` +1. Check the `Xmx` setting in `/usr/local/payara6/glassfish/domains/domain1/config/domain.xml`. Note that there are two such settings, and you want to adjust the one in the stanza with Dataverse options. This sets the JVM heap size; a good rule of thumb is half of your system's total RAM. You may specify the value in MB (`4096m`) or GB (`4g`). + 1. Copy jhove.conf and jhoveConfig.xsd from Payara 5, edit and change payara5 to payara6 `sudo cp /usr/local/payara5/glassfish/domains/domain1/config/jhove* /usr/local/payara6/glassfish/domains/domain1/config/` @@ -80,13 +82,13 @@ `sudo -u dataverse vi /usr/local/payara6/glassfish/domains/domain1/config/jhove.conf` -1. Update systemd unit file (or other init system) to from `/usr/local/payara5` to `/usr/local/payara6`, if applicable. +1. Update systemd unit file (or other init system) from `/usr/local/payara5` to `/usr/local/payara6`, if applicable. 1. Start Payara: `sudo -u dataverse /usr/local/payara6/bin/asadmin start-domain` -1. If you're using password aliases for your database, rserve and datacite jvm-options, recreate them here: +1. Create password aliases for your database, rserve and datacite jvm-options, if you're using them: ``` $ echo "AS_ADMIN_ALIASPASSWORD=yourDBpassword" > /tmp/dataverse.db.password.txt @@ -95,7 +97,7 @@ Command create-password-alias executed successfully. ``` - You'll want to perform simalar commands for `rserve_password_alias` and `doi_password_alias` if you're using Rserve and/or Datacite. + You'll want to perform similar commands for `rserve_password_alias` and `doi_password_alias` if you're using Rserve and/or Datacite. 1. Deploy the Dataverse 6.0 warfile: @@ -109,7 +111,7 @@ `sudo -u dataverse /usr/local/payara6/bin/asadmin create-network-listener --protocol http-listener-1 --listenerport 8009 --jkenabled true jk-connector` -1. Perform one final Payara restart to ensure that timers are initialized properly. This example stops Payara manually, then starts Payara using systemd: +1. Perform one final Payara restart to ensure that timers are initialized properly: `sudo -u dataverse /usr/local/payara6/bin/asadmin stop-domain` - `sudo systemctl start payara` \ No newline at end of file + `sudo -u dataverse /usr/local/payara6/bin/asadmin start-domain` \ No newline at end of file From dc3540a42585172bf4905736f161dfc1c646d593 Mon Sep 17 00:00:00 2001 From: Philip Durbin Date: Fri, 18 Aug 2023 09:03:54 -0400 Subject: [PATCH 4/9] update to Payara 6.2023.8 #9340 --- doc/release-notes/9340-payara5to6.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/release-notes/9340-payara5to6.md b/doc/release-notes/9340-payara5to6.md index ce41973c874..1962011ab02 100644 --- a/doc/release-notes/9340-payara5to6.md +++ b/doc/release-notes/9340-payara5to6.md @@ -1,12 +1,12 @@ ## Upgrade from Payara 5 to Payara 6 -1. Download Payara 6.2023.7 as of this writing: +1. Download Payara 6.2023.8 as of this writing: - `curl -L -O https://nexus.payara.fish/repository/payara-community/fish/payara/distributions/payara/6.2023.7/payara-6.2023.7.zip` + `curl -L -O https://nexus.payara.fish/repository/payara-community/fish/payara/distributions/payara/6.2023.8/payara-6.2023.8.zip` 1. Unzip it to /usr/local (or your preferred location): - `sudo unzip payara-6.2023.7.zip -d /usr/local/` + `sudo unzip payara-6.2023.8.zip -d /usr/local/` 1. Change ownership of the unzipped Payara to your "service" user ("dataverse" by default): @@ -114,4 +114,4 @@ 1. Perform one final Payara restart to ensure that timers are initialized properly: `sudo -u dataverse /usr/local/payara6/bin/asadmin stop-domain` - `sudo -u dataverse /usr/local/payara6/bin/asadmin start-domain` \ No newline at end of file + `sudo -u dataverse /usr/local/payara6/bin/asadmin start-domain` From 12c19d41306962a553c28cef28fbf5cd01e99d27 Mon Sep 17 00:00:00 2001 From: Philip Durbin Date: Mon, 21 Aug 2023 17:12:05 -0400 Subject: [PATCH 5/9] address feedback from QA #9340 --- doc/release-notes/9340-payara5to6.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/doc/release-notes/9340-payara5to6.md b/doc/release-notes/9340-payara5to6.md index 1962011ab02..5fe19a94b8d 100644 --- a/doc/release-notes/9340-payara5to6.md +++ b/doc/release-notes/9340-payara5to6.md @@ -20,11 +20,11 @@ 1. Stop Payara 5: - `sudo /usr/local/payara5/bin/asadmin stop-domain` + `sudo -u dataverse /usr/local/payara5/bin/asadmin stop-domain` 1. Copy Dataverse-related lines from Payara 5 to Payara 6 domain.xml: - `sudo cp /usr/local/payara6/glassfish/domains/domain1/config/domain.xml /usr/local/payara6/glassfish/domains/domain1/config/domain.xml.orig` + `sudo -u dataverse cp /usr/local/payara6/glassfish/domains/domain1/config/domain.xml /usr/local/payara6/glassfish/domains/domain1/config/domain.xml.orig` `sudo egrep 'dataverse|doi' /usr/local/payara5/glassfish/domains/domain1/config/domain.xml > lines.txt` @@ -50,7 +50,7 @@ Note: if you used the Dataverse installer, you won't have a `dataverse.db.password` property. See "Create password aliases" below. - Section 3: JVM options (under ``) + Section 3: JVM options (under ``, the one under ``, not under ``) ``` -Ddataverse.files.directory=/usr/local/dvn/data @@ -72,7 +72,7 @@ -Ddoi.dataciterestapiurlstring=https://api.test.datacite.org ``` -1. Check the `Xmx` setting in `/usr/local/payara6/glassfish/domains/domain1/config/domain.xml`. Note that there are two such settings, and you want to adjust the one in the stanza with Dataverse options. This sets the JVM heap size; a good rule of thumb is half of your system's total RAM. You may specify the value in MB (`4096m`) or GB (`4g`). +1. Check the `Xmx` setting in `/usr/local/payara6/glassfish/domains/domain1/config/domain.xml`. (The one under ``, where you put the JVM options, not the one under ``.) Note that there are two such settings, and you want to adjust the one in the stanza with Dataverse options. This sets the JVM heap size; a good rule of thumb is half of your system's total RAM. You may specify the value in MB (`4096m`) or GB (`4g`). 1. Copy jhove.conf and jhoveConfig.xsd from Payara 5, edit and change payara5 to payara6 @@ -99,6 +99,12 @@ You'll want to perform similar commands for `rserve_password_alias` and `doi_password_alias` if you're using Rserve and/or Datacite. +1. Enable workaround for FISH-7722: + + The following workaround is for https://github.com/payara/Payara/issues/6337 + + `sudo -u dataverse /usr/local/payara6/bin/asadmin create-jvm-options --add-opens=java.base/java.io=ALL-UNNAMED` + 1. Deploy the Dataverse 6.0 warfile: `sudo -u dataverse /usr/local/payara6/bin/asadmin deploy /path/to/dataverse-6.0.war` From 413f775a12da1f08c8f1ba8ba9ee7fa1572c361a Mon Sep 17 00:00:00 2001 From: Don Sizemore Date: Tue, 22 Aug 2023 13:21:45 -0400 Subject: [PATCH 6/9] #9340 update upgrade instructions per feedback from Kevin --- doc/release-notes/9340-payara5to6.md | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/doc/release-notes/9340-payara5to6.md b/doc/release-notes/9340-payara5to6.md index 5fe19a94b8d..8ffeed0d449 100644 --- a/doc/release-notes/9340-payara5to6.md +++ b/doc/release-notes/9340-payara5to6.md @@ -30,7 +30,7 @@ `sudo vi /usr/local/payara6/glassfish/domains/domain1/config/domain.xml` - The lines will be part of three sections, shown below, but your content will vary. + The lines will be part of three sections, examples shown below (but your content will vary). Section 1: mail resource (under ``) @@ -72,7 +72,7 @@ -Ddoi.dataciterestapiurlstring=https://api.test.datacite.org ``` -1. Check the `Xmx` setting in `/usr/local/payara6/glassfish/domains/domain1/config/domain.xml`. (The one under ``, where you put the JVM options, not the one under ``.) Note that there are two such settings, and you want to adjust the one in the stanza with Dataverse options. This sets the JVM heap size; a good rule of thumb is half of your system's total RAM. You may specify the value in MB (`4096m`) or GB (`4g`). +1. Check the `Xmx` setting in `/usr/local/payara6/glassfish/domains/domain1/config/domain.xml`. (The one under ``, where you put the JVM options, not the one under ``.) Note that there are two such settings, and you want to adjust the one in the stanza with Dataverse options. This sets the JVM heap size; a good rule of thumb is half of your system's total RAM. You may specify the value in MB (`8192m`) or GB (`8g`). 1. Copy jhove.conf and jhoveConfig.xsd from Payara 5, edit and change payara5 to payara6 @@ -105,6 +105,10 @@ `sudo -u dataverse /usr/local/payara6/bin/asadmin create-jvm-options --add-opens=java.base/java.io=ALL-UNNAMED` +1. Create the network listener on port 8009 + + `sudo -u dataverse /usr/local/payara6/bin/asadmin create-network-listener --protocol http-listener-1 --listenerport 8009 --jkenabled true jk-connector` + 1. Deploy the Dataverse 6.0 warfile: `sudo -u dataverse /usr/local/payara6/bin/asadmin deploy /path/to/dataverse-6.0.war` @@ -113,11 +117,9 @@ `curl http://localhost:8080/api/info/version` -1. Create the network listener on port 8009 - - `sudo -u dataverse /usr/local/payara6/bin/asadmin create-network-listener --protocol http-listener-1 --listenerport 8009 --jkenabled true jk-connector` - 1. Perform one final Payara restart to ensure that timers are initialized properly: - `sudo -u dataverse /usr/local/payara6/bin/asadmin stop-domain` - `sudo -u dataverse /usr/local/payara6/bin/asadmin start-domain` + ``` + sudo -u dataverse /usr/local/payara6/bin/asadmin stop-domain + sudo -u dataverse /usr/local/payara6/bin/asadmin start-domain + ``` From d2fee0d40cb54f3b764cc6e83b80b5a790cd727c Mon Sep 17 00:00:00 2001 From: Philip Durbin Date: Tue, 22 Aug 2023 14:24:54 -0400 Subject: [PATCH 7/9] format last command like the others #9340 --- doc/release-notes/9340-payara5to6.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/doc/release-notes/9340-payara5to6.md b/doc/release-notes/9340-payara5to6.md index 8ffeed0d449..af9856a9937 100644 --- a/doc/release-notes/9340-payara5to6.md +++ b/doc/release-notes/9340-payara5to6.md @@ -119,7 +119,6 @@ 1. Perform one final Payara restart to ensure that timers are initialized properly: - ``` - sudo -u dataverse /usr/local/payara6/bin/asadmin stop-domain - sudo -u dataverse /usr/local/payara6/bin/asadmin start-domain - ``` + `sudo -u dataverse /usr/local/payara6/bin/asadmin stop-domain` + + `sudo -u dataverse /usr/local/payara6/bin/asadmin start-domain` From 3c57858533dc47229f1c457dec57cf8c3a79852a Mon Sep 17 00:00:00 2001 From: Don Sizemore Date: Tue, 22 Aug 2023 15:10:07 -0400 Subject: [PATCH 8/9] #9340 update mail resource creation per conversation with Kevin and Phil --- doc/release-notes/9340-payara5to6.md | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) diff --git a/doc/release-notes/9340-payara5to6.md b/doc/release-notes/9340-payara5to6.md index af9856a9937..aa44f4098d0 100644 --- a/doc/release-notes/9340-payara5to6.md +++ b/doc/release-notes/9340-payara5to6.md @@ -30,15 +30,9 @@ `sudo vi /usr/local/payara6/glassfish/domains/domain1/config/domain.xml` - The lines will be part of three sections, examples shown below (but your content will vary). + The lines will appear in two sections, examples shown below (but your content will vary). - Section 1: mail resource (under ``) - - ``` - - ``` - - Section 2: system properties (under ``) + Section 1: system properties (under ``) ``` @@ -50,7 +44,7 @@ Note: if you used the Dataverse installer, you won't have a `dataverse.db.password` property. See "Create password aliases" below. - Section 3: JVM options (under ``, the one under ``, not under ``) + Section 2: JVM options (under ``, the one under ``, not under ``) ``` -Ddataverse.files.directory=/usr/local/dvn/data @@ -88,6 +82,10 @@ `sudo -u dataverse /usr/local/payara6/bin/asadmin start-domain` +1. Create a Java mail resource, pointing to your SMTP relay: + + `sudo -u dataverse /usr/local/payara6/bin/create-javamail-resource --mailhost "$SMTP_SERVER" --mailuser "dataversenotify" --fromaddress "do-not-reply@${HOST_ADDRESS}" mail/notifyMailSession` + 1. Create password aliases for your database, rserve and datacite jvm-options, if you're using them: ``` From e7af08cdef3f95a3a9ed762b415be38dac427ce7 Mon Sep 17 00:00:00 2001 From: Don Sizemore Date: Tue, 22 Aug 2023 16:07:30 -0400 Subject: [PATCH 9/9] #9340 final java mail edits per Kevin and Phil --- doc/release-notes/9340-payara5to6.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/release-notes/9340-payara5to6.md b/doc/release-notes/9340-payara5to6.md index aa44f4098d0..b2e6702f5e4 100644 --- a/doc/release-notes/9340-payara5to6.md +++ b/doc/release-notes/9340-payara5to6.md @@ -82,9 +82,9 @@ `sudo -u dataverse /usr/local/payara6/bin/asadmin start-domain` -1. Create a Java mail resource, pointing to your SMTP relay: +1. Create a Java mail resource, replacing "localhost" for mailhost with your mail relay server, and replacing "localhost" for fromaddress with the FQDN of your Dataverse server: - `sudo -u dataverse /usr/local/payara6/bin/create-javamail-resource --mailhost "$SMTP_SERVER" --mailuser "dataversenotify" --fromaddress "do-not-reply@${HOST_ADDRESS}" mail/notifyMailSession` + `sudo -u dataverse /usr/local/payara6/bin/asadmin create-javamail-resource --mailhost "localhost" --mailuser "dataversenotify" --fromaddress "do-not-reply@localhost" mail/notifyMailSession` 1. Create password aliases for your database, rserve and datacite jvm-options, if you're using them: