From f09d28e37ec4063df2652f48dce979370fbab75d Mon Sep 17 00:00:00 2001 From: Philip Durbin Date: Wed, 2 Feb 2022 12:17:51 -0500 Subject: [PATCH] explain what info to send for installation support #8198 --- .../source/installation/installation-main.rst | 7 ++++++- doc/sphinx-guides/source/installation/intro.rst | 11 +++++++++++ 2 files changed, 17 insertions(+), 1 deletion(-) diff --git a/doc/sphinx-guides/source/installation/installation-main.rst b/doc/sphinx-guides/source/installation/installation-main.rst index 4aebf751d5f..0042a0db6d8 100755 --- a/doc/sphinx-guides/source/installation/installation-main.rst +++ b/doc/sphinx-guides/source/installation/installation-main.rst @@ -131,7 +131,7 @@ Next you'll want to check out the :doc:`config` section, especially the section Troubleshooting --------------- -If the following doesn't apply, please get in touch as explained in the :doc:`intro`. You may be asked to provide ``payara5/glassfish/domains/domain1/logs/server.log`` for debugging. +If the following doesn't apply, please get in touch as explained in :ref:`support`. Dataset Cannot Be Published ^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -254,3 +254,8 @@ Rerun Installer With all the data cleared out, you should be ready to rerun the installer per above. Related to all this is a series of scripts at https://github.com/IQSS/dataverse/blob/develop/scripts/deploy/phoenix.dataverse.org/deploy that Dataverse Project Team and Community developers use have the test server http://phoenix.dataverse.org rise from the ashes before integration tests are run against it. For more on this topic, see :ref:`rebuilding-dev-environment` section of the Developer Guide. + +Getting Support for Installation Trouble +---------------------------------------- + +See :ref:`support`. diff --git a/doc/sphinx-guides/source/installation/intro.rst b/doc/sphinx-guides/source/installation/intro.rst index 4dd5f9e8795..2251af7b81b 100644 --- a/doc/sphinx-guides/source/installation/intro.rst +++ b/doc/sphinx-guides/source/installation/intro.rst @@ -39,6 +39,17 @@ To get help installing or configuring a Dataverse installation, please try one o - asking at http://chat.dataverse.org - emailing support@dataverse.org to open a private ticket at https://help.hmdc.harvard.edu +Information to Send to Support When Installation Fails +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +If you've encountered a problem installing Dataverse and are ready to ask for help, please consider sending along the following information so that the Dataverse team and community can more easily assist you. + +- Version of Dataverse you are trying to install. +- Operating system (usually a Linux distribution) and version. +- Output from the installer (STDOUT, STDERR). +- The ``scripts/api/setup-all.*.log`` files left behind by the installer. +- The ``server.log`` file from Payara (by default at ``/usr/local/payara5/glassfish/domains/domain1/logs/server.log``). + Improving this Guide --------------------