grouper-users - RE: [grouper-users] Grouper patching I don't fully understand
Subject: Grouper Users - Open Discussion List
List archive
- From: "Black, Carey M." <>
- To: Olivier Salaün <>, "" <>
- Subject: RE: [grouper-users] Grouper patching I don't fully understand
- Date: Wed, 22 Jan 2020 15:03:20 +0000
- Arc-authentication-results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=osu.edu; dmarc=pass action=none header.from=osu.edu; dkim=pass header.d=osu.edu; arc=none
- Arc-message-signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=C4/tMeiT8FHCfQ8hzVt7w5fVuTu1ZpDZ9VMp47ffu20=; b=jk/uqBw3d//VM4n7sEUg3TUQPwIvv3bszuk4i0JJQQmXqeC42hq/HFPP2esz7X3i5FOzzBlbgQhxMBf8O2z52Nykr7f2PJUEo74oTr2n2gjRo8RjhwiClzFxRi3oCEx5BMdmGD6KWyMgl3OWgPAwD7nGFoMr/3Q06JsbRhrRqlLhistt4sKNg7jyVk6fEsfiYcgxz80xJbCAbMjkqtnvuXZv7yqxDPW5tVhfUHU0xqeyglQUIxtZ4Vr6DSmxajn/iMAeeNJgbOUPi3fnhBa9QAH8rpmDvX8xJszibfV23O4bAqCNjgcwztCPnLoLFogXexnkT5kaZjPknZwS04GA6g==
- Arc-seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=kCEWx/k0a5coKBIcjzOdICcRc4mF0xVP6YL8Wy6YqJpSKA0xhf+9pPgiGLS4nKB1A410peITeNIOTvBES0VAZTPqZblrbM85N/eBFzHbbanY4JvbZIK8KffxZg+zHhryIWAMedFv4bVeg2wGypSFQC6NEKt7L+Oq/GNXFeHlyXjO+Q3uoLXhNq9X+AeXN8JN8gVhWqgu1z7maqGBRbHhJONlH1DCZGbW1QNwNo5VAEUEZnOnCcCRxFffnuH4JZn9Fz2jON3yy2fQpy1Z2zwDfgL4OQlmyMnV5P2Zb4wRNe9Jd30rsS3eYCBlay5SAx6OqsMRXRFdwHI/QJxaVX3Osg==
|
Olivier,
Sadly (IMHO), the Grouper “install process” is being “modernized” into the use of containers. If you are on v2.4 it is strongly encouraged that you move to using a container based deployment model instead of a “local install”.
REF: https://github.internet2.edu/docker/grouper Of note is the https://hub.docker.com/r/tier/grouper/tags link. ( This is currently the place to get the ITAP containers from. ) REF: https://spaces.at.internet2.edu/display/ITAP/InCommon+Trusted+Access+Platform+Release REF: https://github.internet2.edu/docker/grouper/blob/2.4.0-80-u51-w10-p11-20191118/README.md Note latest URL/version will be slightly different all the time. (These are links to a github branch that is specific to a combination of “API”, “UI”, “WS”, and “PSPNG” versions. ) Note: This is really for docs/info more than “code”. You likely don’t need to “compile” or “install” to “deploy using a container”.
This might be a good reference guide for starting where you are and moving towards the container model.
However, ( back to your comments about the current grouperInstaller)
I see your confusion about the “local install” process. Here are a few things that took me a while to wrap my head around. I try to forget about the parts and focus on the “install locations”. A UI “install location” has the UI, and the API. ( and maybe local customizations ) A WS “install location” has the WS, and the API. ( and maybe local customizations ) A daemon ( AKA: api ) “install location” only has the API. ( and maybe local customizations ) Etc… etc… ( and maybe local customizations )
Each location needs to be “patched” and/or “upgraded” independently by the grouperInstaller. Because when you run it, you point it at “a single location”. So when you use only the UI, then you only have to patch the UI location(s). But you never *only* have the UI. You always need a daemon/API to have a full system too. ( WS is optional, PSPNG optional, etc…, etc… ) So you also always have to patch more than one location.
So you need to have a set of config files for each *location* and run the installer per location to get everything up to date. However, there is this clause “It will apply and manage the API patches as well.”. So when you patch the “UI” (location) the grouperinstaller knows to also patch the API that exists in that location. This helps to avoid needing to run the patches on the same location more than once. (Assuming it all works the first time. :) )
For what it is worth: The container model is very different. The container has “all the standard files” in “well known locations”. You pull the right container and you get all of the “install locations” in it, and patched to a known level in that one step. You need to add your config ( and maybe local customizations ) to get it to be “your Grouper install”. ( And there are very “docker” specific choices to make about how you add what you want added. But it ultimately becomes a script/process. ) The “maturity level 0” link is likely a way to plan/transition into a container model.
Since you are already on v2.4 really all you would need to do is be able to spin up the container with your config ( and maybe local customizations ). So look at the Daemon, UI, (maybe WS? ) links on that page for the “basic how to”.
Daemon: https://spaces.at.internet2.edu/display/Grouper/Install+the+Grouper+2.4+container+with+maturity+level+0#InstalltheGrouper2.4containerwithmaturitylevel0-Daemon UI: https://spaces.at.internet2.edu/display/Grouper/Install+the+Grouper+2.4+container+with+maturity+level+0#InstalltheGrouper2.4containerwithmaturitylevel0-UI WS: https://spaces.at.internet2.edu/display/Grouper/Install+the+Grouper+2.4+container+with+maturity+level+0#InstalltheGrouper2.4containerwithmaturitylevel0-WS
Hope that helps.
-- Carey Matthew
From: <>
On Behalf Of Olivier Salaün
Hello, We are moving to Grouper 2.4.0 on a Linux server and while applying latest patches I got troubles applying patches to the grouper API. I think I understand the process now, but I want to make sure I apply patches the right way. Also since the documentation was confusing (for me), maybe this email might be helpful for others. We run the grouper installer for patching as follows :
The grouper.installer.properties file includes the following entries :
https://spaces.at.internet2.edu/display/Grouper/Grouper+patching states that:
Therefore I assumed running Grouper installer in patch mode on grouper.ui-2.4.0/dist/grouper/ would also patch the Grouper API used by gsh.sh (GROUPER_HOME=/data/webapps/grouper-test.univ-rennes1.fr/application/grouper.apiBinary-2.4.0), but it didn't.
The Grouper installer patched code in the grouper.ui-2.4.0/dist/grouper/WEB-INF/classes/ hierarchy, which is a copy of the grouper.apiBinary-2.4.0/conf/edu/ hierarchy. I indeed realized $GROUPER_HOME/bin/gsh.sh did not have the latest patches applied :
I found out I have 5 versions of gsh.sh in my Grouper hierarchy:
I had to run the grouper installer again to patch the API located in the grouper.apiBinary-2.4.0/ hierarchy and now gsh.sh is up to patch 89 :-) Can you confirm that I need to run the patching process twice to update both UI and API code? Any way to make Grouper install a single version of the Grouper API code (for the sake of maintenability and comprehensibility)? -- Olivier Salaün DSI / pôle SI / équipe SNUM Tel : 02 23 23 74 54 |
- [grouper-users] Grouper patching I don't fully understand, Olivier Salaün, 01/22/2020
- RE: [grouper-users] Grouper patching I don't fully understand, Black, Carey M., 01/22/2020
- Re: [grouper-users] Grouper patching I don't fully understand, Olivier Salaün, 01/22/2020
- RE: [grouper-users] Grouper patching I don't fully understand, Hyzer, Chris, 01/22/2020
- RE: [grouper-users] Grouper patching I don't fully understand, Black, Carey M., 01/22/2020
Archive powered by MHonArc 2.6.19.