Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

6593 payara docs #6816

Merged
merged 54 commits into from
Apr 29, 2020
Merged

6593 payara docs #6816

merged 54 commits into from
Apr 29, 2020

Conversation

pdurbin
Copy link
Member

@pdurbin pdurbin commented Apr 13, 2020

What this PR does / why we need it:

Many, many places in the guide reference Glassfish 4. For Dataverse 5 we are moving to Payara 5.

Which issue(s) this PR closes:

Closes #6593

Special notes for your reviewer:

  • Details about a patch to Mojarra (JSF) have not yet been included. Added in b361999
  • "app server" was used where it makes sense to
  • An attempt was made to use a Unix user called "dataverse" instead of "glassfish".
  • In the Installation Guide, should we delete the old Two Ravens content? I put a note saying "Please note that in the text below, Glassfish was changed to Payara but not tested."
  • When should we update Vagrant code? Started in a7c986d but deferred until Get Vagrant working on Payara and with updated installer #6849
  • When should we update docker-aio code? @pameyer said he'd work on this
  • When should we update docker-dcm code? @pameyer said he'd work on this
  • Should we clear out the "Containers" page in the dev guide and delete the related scripts, Openshift config and Docker files? The content is old and references Glassfish. Done in e72ba3c.

Suggestions on how to test this:

  • Try to install Dataverse on Payara 5 with these instructions.
  • Set up as many extra features (Make Data Count, etc.) as is reasonable.

Does this PR introduce a user interface change?:

No

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

No.

Additional documentation:

None.

The plan is for the Python installer to support Payara. See #6761.
@pdurbin
Copy link
Member Author

pdurbin commented Apr 20, 2020

we should mention the jsf patch for those who will manually update their environment

I just added a line about the JSF patch in b361999.

@pdurbin
Copy link
Member Author

pdurbin commented Apr 20, 2020

I added a ton more "app server" references, as requested by @scolapasta

These are the open questions I have for reviewers:

  • In the Installation Guide, should we delete the old Two Ravens content? I put a note saying "Please note that in the text below, Glassfish was changed to Payara but not tested."
  • When should we update Vagrant code?
  • Should we clear out the "Containers" page in the dev guide and delete the related scripts, Openshift config and Docker files? The content is old and references Glassfish.

@pdurbin pdurbin removed their assignment Apr 20, 2020
@pdurbin pdurbin requested a review from scolapasta April 20, 2020 20:55
@pdurbin pdurbin marked this pull request as draft April 21, 2020 19:58
@pdurbin pdurbin self-assigned this Apr 21, 2020
@pdurbin
Copy link
Member Author

pdurbin commented Apr 21, 2020

We discussed this pull request in tech hours and decided a few things.

  • I'd like to update (or possibly delete) the Vagrant stuff, which has references to Glassfish 4.1. Progress captured in a7c986d but deferred until Get Vagrant working on Payara and with updated installer #6849.
  • I'd like to delete the aging OpenShift content and files, which references Glassfish 4.1. Done in e72ba3c.
  • We'll let @pameyer update the docker-aio/docker-dcm content when he's ready (no rush!).
  • I'd like @landreev to take a look at the "run the installer" content in the Installation Guide. I made a few tweaks to it (making the new Python installer the default). @donsizemore mentioned that it should be written with an eye toward CentOS or RHEL rather than a laptop.

The other day in Slack we discussed Two Ravens.

  • @djbrooke will give us guidance if we can delete the "how to install TwoRavens" content, which had a lot of references to Glassfish.

If there are other things I'm forgetting, please let me know.

We are deferring the rest of this work until #6849

Fixes #4519 (switched to dataverse-ansible Vagrantfile).

The guides have been updated to de-emphasize Vagrant.
The OpenShift content has not been kept up to date. We can always dig it
out of the git history if necessary. A better starting point for
OpenShift support at this point is probably
https://github.com/IQSS/dataverse-kubernetes
@pdurbin pdurbin marked this pull request as ready for review April 22, 2020 15:58
@pdurbin pdurbin removed their assignment Apr 22, 2020
@scolapasta scolapasta self-assigned this Apr 23, 2020
Copy link
Contributor

@scolapasta scolapasta left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's a lot, but I'm seeing the changes I requested.

(There's probably more places we can generalize still, but I'd rather keep this moving and if need be, surgically make changes later)

@scolapasta scolapasta removed their assignment Apr 28, 2020
@kcondon kcondon self-assigned this Apr 29, 2020
@kcondon kcondon merged commit 5ffc7b0 into develop Apr 29, 2020
@kcondon kcondon deleted the 6593-payara-docs branch April 29, 2020 20:46
@djbrooke djbrooke added this to the Dataverse 5 milestone May 1, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Payara Documentation Updates
5 participants