add upgrade instructions for Payara 5 to 6

[pdurbin]

What this PR does / why we need it:

Dataverse installations will need to upgrade from Payara 5 to 6.

Which issue(s) this PR closes:

• Closes determine upgrade path from Payara 5 to 6 #9340

Special notes for your reviewer:

I tested this on https://dev1.dataverse.org and it seemed to work.

Suggestions on how to test this:

Try the instructions.

Does this PR introduce a user interface change? If mockups are available, please link/include them here:

No.

Is there a release notes update needed for this change?:

It is a release note.

Additional documentation:

None.

[pdurbin]

@donsizemore your edits look great. I added a few more questions and suggestions.

[coveralls]

coverage: 20.37%. remained the same when pulling b894e6d on 9340-payara5to6 into 45a3936 on develop.

[kcondon]

Issues found:
[x] 0. When copying p6 domain.xml to domain.xml.ORIG, leaves file owned by root in p6 structure.
sudo cp /usr/local/payara6/glassfish/domains/domain1/config/domain.xml /usr/local/payara6/glassfish/domains/domain1/config/domain.xml.orig

[x] 1. You should add some additional detail saying add jvm-options to <java-config...> section under <configs><config name="server-config"> as opposed to <config name="default-config"...

The Xmx value should also go in the same server-config section.

If in addition to the above detail you want to include an example domain.xml/skeleton, that's fine

[x] 2. Need to specify the workaround, otherwise war file will fail to deploy:
asadmin create-jvm-options --add-opens=java.base/java.io=ALL-UNNAMED
asadmin restart-domain

Before deploying war file

[x] 3. App doesn't load, returns 503 error:
503_on_deploy_after_upgrade.txt

This is a result of the apache proxy, it works when going directly to port 8080. Is there something apache related we need to include? I restarted httpd but it made no difference.

I see, it is probably the next to last step, jk-connector. It is a little confusing that the app isn't accessible on port 80 once deployed.

[x] 4. Might want to put the two "restart" commands on separate lines (start/stop) or just use restart.

[x] 5. Upgrade fails smoketest:
-Remains on create user page, throws server.log error but does create user:
create_usr_err_upgrade.txt
-Can't create dataverse, same ejb log error as create user but shows create ejb err in ui, leaves on create dv page. Also does create dv,