Upgrade instructions from v5.14 to v6.0

Dear Dataverse Developers,

Today I tried to upgrade our installation and failed, unfortunately.
While I am still figuring out the cause, I would like to report that probably some information is missing in the instructions:

1. Update to Solr 8 is mentioned in Section "Runtime", however not in the instructions.
2. In Instructions the undeployment of 5.14 is mentioned, but no instructions for deployment of v6.0
3. There is a statement "You'll want to perform similar commands for rserve_password_alias and doi_password_alias" but it not clear, what exactly "similar" means.

I tried to figure out the missing information myself, but may be it would be better if the instructions get revised, there might be more issues.
As I mentioned, my deployment failed with an error:

wget https://github.com/IQSS/dataverse/releases/download/v6.0/dataverse-6.0.war
export PAYARA=/usr/local/payara6
$PAYARA/bin/asadmin deploy dataverse-6.0.war


remote failure: Error occurred during deployment: JNDI lookup failed for the resource: Name: [VDCNet-ejbPU], Lookup: [java:app/jdbc/dataverse], Type: [javax.sql.DataSource] -- Lookup failed for 'java:app/jdbc/dataverse' in SerialContext[myEnv={java.naming.factory.initial=com.sun.enterprise.naming.impl.SerialInitContextFactory, java.naming.factory.state=com.sun.corba.ee.impl.presentation.rmi.JNDIStateFactoryImpl, java.naming.factory.url.pkgs=com.sun.enterprise.naming}. Please see server.log for more details.

With the logs:

[#|2023-10-24T16:31:00.418+0200|SEVERE|Payara 5.2022.3|javax.enterprise.system.tools.deployment.dol|_ThreadID=92;_ThreadName=admin-thread-pool::admin-listener(1);_TimeMillis=1698157860418;_LevelValue=1000;_MessageID=AS-DEPLOYMENT-00026;|
  JNDI lookup failed for the resource: Name: VDCNet-ejbPU, Lookup: java:app/jdbc/dataverse, Type: javax.sql.DataSource.|#]

[#|2023-10-24T16:31:00.420+0200|SEVERE|Payara 5.2022.3|javax.enterprise.system.core|_ThreadID=92;_ThreadName=admin-thread-pool::admin-listener(1);_TimeMillis=1698157860420;_LevelValue=1000;|
  JNDI lookup failed for the resource: Name: [VDCNet-ejbPU], Lookup: [java:app/jdbc/dataverse], Type: [javax.sql.DataSource] -- Lookup failed for 'java:app/jdbc/dataverse' in SerialContext[myEnv={java.naming.factory.initial=com.sun.enterprise.naming.impl.SerialInitContextFactory, java.naming.factory.state=com.sun.corba.ee.impl.presentation.rmi.JNDIStateFactoryImpl, java.naming.factory.url.pkgs=com.sun.enterprise.naming}|#]

It might be because I did something wrong. So I would wait until instructions get revised and will try again.

Thank you and best regards
Sergej

Start with the v5.14-to-v6.0 upgrade instructions, especially the Runtime and Instructions sections. Verify that the Solr 8 update, v6.0 deployment, and rserve_password_alias and doi_password_alias steps are explicit, and use the reported deployment failure as a check for missing guidance. Done means the upgrade path is complete and unambiguous.