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

8947 Update to Payara 5.2022.3 #8949

Merged
merged 5 commits into from
Sep 21, 2022
Merged

Conversation

poikilotherm
Copy link
Contributor

@poikilotherm poikilotherm commented Aug 31, 2022

What this PR does / why we need it:

Upgrade to Payara 5.2022.3. Security and bug fixing.

Which issue(s) this PR closes:

Closes #8947
Closes IQSS/dataverse-security#66

Special notes for your reviewer:
None.

Suggestions on how to test this:
Follow instructions. @donsizemore says to check for greatly increased logging when using S3 (#8219). We might need to document how to lower the logging level.

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

Is there a release notes update needed for this change?:
Yes. 🔋 included.

Additional documentation:
None.

@coveralls
Copy link

coveralls commented Aug 31, 2022

Coverage Status

Coverage increased (+0.001%) to 20.1% when pulling 6167940 on poikilotherm:8947-payara-5-2022-3 into 454f3f1 on IQSS:develop.

Copy link
Member

@qqmyers qqmyers left a comment

Choose a reason for hiding this comment

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

Looks like a find/replace of all instances of 5.2021.6 - except

// of properties can be found at https://docs.payara.fish/community/docs/5.2021.6/documentation/payara-server/jdbc/advanced-connection-pool-properties.html#full-list-of-properties
-should that be changed too?


*NOTE: this might be rephrased to "required" depending on https://github.com/IQSS/dataverse/pull/8915 being merged.*

With lots of bug and security fixes included, we encourage everyone to update to Payara 5.2022.3 as soon as possible.
Copy link
Member

Choose a reason for hiding this comment

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

I expect others will want to wordsmith the release notes more, but I'll note that we should probably not make this optional - while I think v5.12 will be compatible with earlier versions, after this PR we're not testing that anymore.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I absolutely agree!

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@pdurbin WDYT - should we make a bold statement? (Especially as it seems to be another good reason to update because of #8823)

IQSS/dataverse (TO BE RETIRED / DELETED in favor of project 34) automation moved this from On Deck 🛎 to QA ✅ Aug 31, 2022
@poikilotherm
Copy link
Contributor Author

poikilotherm commented Aug 31, 2022

-should that be changed too?

Actually that one was on purpose. The docs links changed upstream and I was really hoping for #8915 being merged as it is fairly small and helps people. That PR is already updating this place.

@pdurbin
Copy link
Member

pdurbin commented Sep 7, 2022

I'm pulling this out of QA and assigning it to @poikilotherm because he offered to document the extra steps around lib/databases and such as originally written up by @qqmyers at #8064 (comment)

I assume this should go in the guides? I found a few related references:

$ ack osgi source
source/admin/troubleshooting.rst
101:- Remove the ``generated`` and ``osgi-cache`` directories;

source/_static/util/clear_timer.sh
20:rm -rf ${PAYARA_DIR}/${DV_DIR}/osgi-cache/felix

source/installation/installation-main.rst
210:- Remove the ``generated`` and ``osgi-cache`` directories;

There's also stuff in "scripts":

$ ack generated scripts
scripts/dev/dev-rebuild.sh
18:echo "Deleting \"generated\" directory..."
19:rm -rf $PAYARA_DIR/glassfish/domains/domain1/generated

scripts/installer/dvinstall/as-setup.sh
168:    rm -rf /usr/local/payara5/glassfish/domains/domain1/generated 

@PaulBoon thanks for pinging us about this.

@poikilotherm
Copy link
Contributor Author

@pdurbin @qqmyers @donsizemore I added the notes and modifications regarding #8230. Please take a look.

Copy link
Member

@pdurbin pdurbin left a comment

Choose a reason for hiding this comment

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

I added a suggestion.

doc/release-notes/8947-payara-update.md Show resolved Hide resolved
@pdurbin
Copy link
Member

pdurbin commented Sep 12, 2022

@poikilotherm thanks for the updates. At standup we talked about how next we need someone to review this so I unassigned you.

On a related note, @donsizemore is testing with Ansible. Thanks, Don!

As documented by @qqmyers in IQSS#8230 one needs to remove the
`lib/databases` folder from the domain dir on update to
a Payara version beyond 5.2021.8.
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
Copy link
Contributor Author

I'm sorry but I had to force push this after rebasing on latest develop to avoid the merge conflict.

3. Move the current Payara directory out of the way

```shell
mv $PAYARA $PAYARA.MOVED
Copy link
Contributor

Choose a reason for hiding this comment

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

Where does PAYARA.MOVED get set/exported?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Oh this was just copy-pasta from the v5.6 instructions.

The shell expansion will stop at the ".", so if $PAYARA is "x", it'll be "x.MOVED".

@pdurbin pdurbin merged commit b0f967c into IQSS:develop Sep 21, 2022
IQSS/dataverse (TO BE RETIRED / DELETED in favor of project 34) automation moved this from QA ✅ to Done 🚀 Sep 21, 2022
poikilotherm added a commit to poikilotherm/dataverse that referenced this pull request Sep 22, 2022
With the merge of IQSS#8949 the custom version is no longer necessary.
@poikilotherm poikilotherm deleted the 8947-payara-5-2022-3 branch May 21, 2023 19:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
No open projects
Development

Successfully merging this pull request may close these issues.

Update to Payara 5.2022.3
5 participants