fix,docs(deps): delete lib/databases folder in scripts IQSS#8947

With the update to a Payara version past 5.2021.8, the `lib/databases` folder needs to be removed by scripts etc (as with osgi-cache and generated folders) during rebuild/upgrade of a domain to avoid incompatibilities. See also: IQSS#8230
poikilotherm · Sep 20, 2022 · d53600c · d53600c
1 parent e8cfd01
commit d53600c
Show file tree

Hide file tree

Showing 5 changed files with 6 additions and 5 deletions.
diff --git a/doc/sphinx-guides/source/_static/util/clear_timer.sh b/doc/sphinx-guides/source/_static/util/clear_timer.sh
@@ -17,6 +17,7 @@ DV_DIR=${PAYARA_DIR}/glassfish/domains/domain1
 ${PAYARA_DIR}/bin/asadmin stop-domain
 
 rm -rf ${PAYARA_DIR}/${DV_DIR}/generated/
+rm -rf ${PAYARA_DIR}/${DV_DIR}/lib/databases
 rm -rf ${PAYARA_DIR}/${DV_DIR}/osgi-cache/felix
 
 # restart the domain (also generates a warning if app server is stopped)

diff --git a/doc/sphinx-guides/source/admin/troubleshooting.rst b/doc/sphinx-guides/source/admin/troubleshooting.rst
@@ -96,10 +96,8 @@ Sometimes your Dataverse installation fails to deploy, or Payara fails to restar
 
 We don't know what's causing this issue, but here's a known workaround: 
 
-- Stop Payara; 
-
-- Remove the ``generated`` and ``osgi-cache`` directories;
-
+- Stop Payara;
+- Remove the ``generated``, ``lib/databases`` and ``osgi-cache`` directories from the ``domain1`` directory;
 - Start Payara
 
 The shell script below performs the steps above. 

diff --git a/doc/sphinx-guides/source/installation/installation-main.rst b/doc/sphinx-guides/source/installation/installation-main.rst
@@ -207,7 +207,7 @@ Fresh Reinstall
 Early on when you're installing the Dataverse Software, you may think, "I just want to blow away what I've installed and start over." That's fine. You don't have to uninstall the various components like Payara, PostgreSQL and Solr, but you should be conscious of how to clear out their data. For Payara, a common helpful process is to:
 
 - Stop Payara; 
-- Remove the ``generated`` and ``osgi-cache`` directories;
+- Remove the ``generated``, ``lib/databases`` and ``osgi-cache`` directories from the ``domain1`` directory;
 - Start Payara
 
 Drop database

diff --git a/scripts/dev/dev-rebuild.sh b/scripts/dev/dev-rebuild.sh
@@ -17,6 +17,7 @@ $ASADMIN stop-domain
 
 echo "Deleting \"generated\" directory..."
 rm -rf $PAYARA_DIR/glassfish/domains/domain1/generated
+rm -rf $PAYARA_DIR/glassfish/domains/domain1/lib/databases
 
 echo "Deleting ALL DATA FILES uploaded to Dataverse..." 
 # TODO: Make this configurable.

diff --git a/scripts/installer/as-setup.sh b/scripts/installer/as-setup.sh
@@ -167,6 +167,7 @@ if [ "$DOCKER_BUILD" = "true" ]
     chmod -R 777 /usr/local/payara5/
     rm -rf /usr/local/payara5/glassfish/domains/domain1/generated 
     rm -rf /usr/local/payara5/glassfish/domains/domain1/applications
+    rm -rf /usr/local/payara5/glassfish/domains/domain1/lib/databases
     popd
     exit 0
 fi