Date: Fri, 29 Mar 2024 05:29:05 +0000 (UTC) Message-ID: <727341575.7495.1711690145211@ip-10-10-7-29.ec2.internal> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_7494_1079434962.1711690145211" ------=_Part_7494_1079434962.1711690145211 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
For Grouper 2.5+ = see the new approach for Grouper 2.5+ packaging and versioning strategy
The grouper installer can run in non interactive mode and you can answer= all the questions in the grouper.installer.properties.
To run with a grouper.installer.properties create the config file and ru= n like this. Note on windows use a semicolon instead of a colon
UNIX java -cp .:grouperInstaller.jar edu.internet2.middleware.grouperInstaller.G= rouperInstaller WINDOWS java -cp .;grouperInstaller.jar edu.internet2.middleware.grouperInstaller.G= rouperInstaller
See the use defaults as much as possible in the grouper.installer.proper= ties (copy from grouper.installer.example.properties to the grouper.install= er.properties, then look at the commonly changed items and move them to the= grouper.installer.properties as needed
#######= ####################### ## Autorun properties ## ## If you uncomment one of these properties it will be used as empty, only = uncomment to use ##=20 ############################## #### set this to true to try to use defaults for everything. Only things w= ithout default values will need to be set grouperInstaller.autorun.useDefaultsAsMuchAsAvailable =3D false ########## AUTORUN PROPERTIES WITH NO DEFAULT OR ARE COMMONLY CHANGED ## Note: not all of them need to be filled out for all operations # autorun Do you want to 'install' a new installation of grouper, 'upgrade'= an existing installation # or 'patch' an existing installation\n"=20 # (enter: 'install', 'upgrade', 'patch' or blank for the default) # default is controlled in a config in this config file: grouperInstaller.d= efault.installOrUpgrade # grouperInstaller.autorun.actionEgInstallUpgradePatch =3D=20 # autorun, What do you want to install/upgrade/patch? api, ui, ws, or psp?= =20 # note, default is configured in this file: grouperInstaller.default.appToU= pgrade # grouperInstaller.autorun.appToUpgrade =3D=20 # autorun, Where is the grouper api/ui/ws/psp installed for upgrades / patc= hing? # grouperInstaller.autorun.grouperWhereInstalled =3D=20 # autorun grouper system password (its not secure to have a plain text pass= in a config file) # grouperInstaller.autorun.grouperSystemPassword =3D # autorun db url=20 # grouperInstaller.autorun.dbUrl =3D # autorun db user # grouperInstaller.autorun.dbUser =3D # autorun db pass (note, it is not good security to have plaintext password= s in text config files) # grouperInstaller.autorun.dbPass =3D # autorun Do you want to init the database (delete all existing grouper tab= les, add new ones) (t|f)?=20 # grouperInstaller.autorun.deleteAndInitDatabase =3D f # autorun, uncomment to make work, Enter in the Grouper install directory (= note: better if no spaces or special chars) # default is controller in a config in this config file: grouperInstaller.d= efault.installDirectory # if that is blank or not configured, default is current working directory # grouperInstaller.autorun.installDirectory =3D=20 # autorun, uncomment to make work, Enter in a Grouper temp directory to dow= nload tarballs # default is controller in a config in this config file: grouperInstaller.d= efault.tarballDirectory # if that is blank or not configured, default is current working directory # grouperInstaller.autorun.tarballDirectory =3D=20 # autorun patchCreator: Enter a description for this patch, e.g. GRP-123: f= ixes a problem with such and such: [required] # grouperInstaller.autorun.patchDescription =3D=20 # autorun patchCreator: Enter the risk level for the patch: (low|medium|hig= h): [required] # grouperInstaller.autorun.patchRiskLevel =3D=20 # autorun patchCreator: Is this a security patch? (t|f): [t] # grouperInstaller.autorun.patchSecurity =3D=20 # autorun What is the location of your tomcat server.xml for the UI? # Note, if you dont use tomcat just leave it blank or type 'blank': # grouperInstaller.autorun.locationOfTomcatServerXml =3D=20 # autorun patch action: What do you want to do with patches (install, rever= t, status) # grouperInstaller.autorun.patchAction =3D # autorun patch Enter the comma separated list of files to make a patch fro= m: [required]=20 # grouperInstaller.autorun.patchFilesCommaSeparated =3D # autorun Enter any patch names that are dependencies that you know of (com= ma separated), or blank for none:\n"); # grouperInstaller.autorun.patchNameDependenciesCommaSeparated =3D # It is NOT detected that your patch requires restart, please confirm this,= does it require restart (t|f)? [f] # grouperInstaller.autorun.patchOverrideDoesntRequireRestart =3D t # Enter a Jira key (e.g. GRP-123) for this patch: [required]=20 # (note, will try to get this from patch description, if its there, this ca= n be blank) # grouperInstaller.autorun.patchJiraKey =3D ########## AUTORUN PROPERTIES THAT HAVE A DEFAULT VALUE # autorun rebuild ui after having been built # grouperInstaller.autorun.rebuildUiAfterHavingBeenBuilt =3D t # autorun rebuild client after having been built [t] # grouperInstaller.autorun.rebuildClientAfterHavingBeenBuilt =3D # autorun rebuild grouper api after having been built [t] # grouperInstaller.autorun.rebuildGrouperApiAfterHavingBeenBuilt =3D # autorun rebuild PSP after having been built [t] # grouperInstaller.autorun.rebuildPspAfterHavingBeenBuilt =3D # autorun rebuild subject API after having been built [t] # grouperInstaller.autorun.rebuildSubjectApiAfterHavingBeenBuilt =3D # autorun uncomment to make work, The Grouper WS has been built in the past= , do you want it rebuilt? (t|f) # note, this default can be set in this config file grouperInstaller.defaul= t.ws.rebuildIfBuilt, or default true # grouperInstaller.autorun.rebuildWsIfBuiltAlready =3D # autorun if the log directory of UI should be set # grouperInstaller.autorun.setLogDirOfUi =3D t # autorun log dir of UI # grouperInstaller.autorun.uiLogDir =3D=20 # autorun path of sh command if not in a standard path # grouperInstaller.autorun.pathOfShCommandIfNotFound =3D=20 # autorun if tomcat should be stopped anyways when detected not running # grouperInstaller.autorun.stopTomcatAnyway =3D t # autorun if tomcat should be starts anyways when detected running # grouperInstaller.autorun.startTomcatAnyway =3D t # autorun if the ports of tomcat should be checked when stopping # grouperInstaller.autorun.stopTomcatCheckPorts =3D t # autorun if the ports of tomcat should be checked when starting # grouperInstaller.autorun.startTomcatCheckPorts =3D t # autorun if continue after tomcat error # grouperInstaller.autorun.continueAfterTomcatError =3D t # autorun set grouper system password in tomcat users xml # grouperInstaller.autorun.setGrouperSystemPasswordInTomcatUsers =3D t # autorun conflicting jar continue (you can just uncomment, doesnt need a v= alue) # grouperInstaller.autorun.conflictingJarContinue =3D=20 # autorun branch to create a patch for, default to the one the version is a= bove # grouperInstaller.autorun.branchToCreatePatchFor =3D # autorun branch to create a patch for PSP, default to the one the version = is above # grouperInstaller.autorun.branchForPspToCreatePatchFor =3D # autorun backup your files (uncomment to make work): You should backup you= r files and database before you start. Press <enter> to continue. # grouperInstaller.autorun.backupFiles =3D # any running processes: Are there any running processes using this install= ation? tomcats? loader? psp? etc? (t|f)? [f]: # grouperInstaller.autorun.runningProcesses =3D f # autorun, uncomment to make work, If you have edited the Owasp.CsrfGuard.o= verlay.properties please merge the changes to the new file # grouperInstaller.autorun.continueAfterEditedOwaspCsrfGuard =3D=20 # autorun, uncomment to make work, If you customized the web.xml please mer= ge your changes back in # grouperInstaller.autorun.continueAfterMergeWebXml =3D=20 # autorun, uncomment to make work, Merge nav.properties # grouperInstaller.autorun.continueAfterNavProperties =3D=20 # autorun, uncomment to make work, Merge media.properties # grouperInstaller.autorun.continueAfterMediaProperties =3D=20 # autorun, Remove old keys nav.properties # grouperInstaller.autorun.removeOldKeysFromNavProperties =3D t # autorun, Remove old keys media.properties # grouperInstaller.autorun.removeOldKeysFromMediaProperties =3D t # autorun, view list of files changed in copy # grouperInstaller.autorun.viewListOfFilesChangedInCopy =3D f # autorun, uncomment to make work, continue after merging sources.xml # grouperInstaller.autorun.continueAfterMergingSourcesXml =3D # autorun, You are upgrading from pre API version 2.0.0, do you want to run= Unresolvable Subject Deletion Utility (USDU) (recommended) (t|f)? [t] # grouperInstaller.autorun.runUsduPre2.0.0 =3D t # autorun, You are upgrading from after API version 2.0.0, so you dont have= to do this, but do you want to run Unresolvable Subject Deletion Utility (= USDU) (not recommended) (t|f)? [f] # grouperInstaller.autorun.runUsduPost2.0.0 =3D f # autorun, ERROR, cannot find grouper version in grouper jar file, do you w= ant to continue? (t|f)? [f]: # grouperInstaller.autorun.shouldContinueAfterNoGrouperVersionFound =3D f # autorun, You are upgrading from pre API version 2.0.0, do you want to res= olve all group subjects (recommended) (t|f)? [t]: "); # grouperInstaller.autorun.resolveGroupSubjectsPre2.0.0 =3D t # autorun, You are upgrading from after API version 2.0.0, so you dont have= to do this,=20 # but do you want to resolve all group subjects (not recommended) (t|f)? [f= ]: # grouperInstaller.autorun.resolveGroupSubjectsPost2.0.0 =3D f # autorun You are upgrading from pre API version 2.1.0, do you want to=20 # see if you have rules with ruleCheckType: flattenedPermission* (recommend= ed) (t|f)? [t]: "); # grouperInstaller.autorun.seeRulesFlattenedPermissionsPre2.1.0 =3D t # autorun You are upgrading from after API version 2.1.0, so you dont have = to do this, # but do you want to see if you have rules with ruleCheckType: flattenedPer= mission* (not recommended) (t|f)? [f]: # grouperInstaller.autorun.seeRulesFlattenedPermissionsPost2.1.0 =3D f # autorun Error getting count of rules, would you like to continue (t|f)? [= t]: # grouperInstaller.autorun.shouldContinueAfterErrorCountFlattenedRules =3D = t # autorun You have flattenedPermission rules that need to be removed. You = need to look in the view=20 # grouper_rules_v and notify the owners and remove these rules. Do you wan= t to continue (t|f)? [t]:=20 # grouperInstaller.autorun.shouldContinueAfterFoundFlattenedRules =3D t # autorun You are upgrading from pre API version 2.2.0,=20 # do you want to run the 2.2 upgrade GSH script (recommended) (t|f)? [t]: # grouperInstaller.autorun.run2.2gshUpgradeScriptPre2.2.0 =3D t # autorun You are upgrading from after API version 2.2.0, so you dont have = to do this, # but do you want to run the 2.2 upgrade GSH script (not recommended) (t|f)= ? [f]: # grouperInstaller.autorun.run2.2gshUpgradeScriptPost2.2.0 =3D f # autorun You are upgrading from pre API version 2.2.1, do you want to=20 # run the 2.2.1 upgrade GSH script (recommended) (t|f)? [t]:=20 # grouperInstaller.autorun.run2.2.1gshUpgradeScriptPre2.2.1 =3D t # autorun You are upgrading from after API version 2.2.1, so you dont have = to do this # but do you want to run the 2.2.1 upgrade GSH script (not recommended) (t|= f)? [f]:=20 # grouperInstaller.autorun.run2.2.1gshUpgradeScriptPost2.2.1 =3D f # autorun Error: we tried to upgrade the database but it didnt work, would = you like to continue skipping DDL (t|f)? # grouperInstaller.autorun.shouldContinueIfErrorUpgradingDatabase =3D f # autorun Review the script(s) above if there are any, do you want the upgr= ader to run it to upgrade the DDL for you (t|f)? [t]: # grouperInstaller.autorun.shouldRunDdlScript =3D t # autorun uncomment to make work There are multiple related jars for *jarNa= me* GrouperInstallerUtils.toStringForLog(relatedJars)); # There should be only one, remove the others, if this is a mistake, then y= ou need to\n rename the prefix so they are different, and report to the Gr= ouper team # grouperInstaller.autorun.continueAfterFoundMultipleJars =3D=20 # autorun uncomment to make work Compare you old ehcache.xml with the new e= hcache.xml file # grouperInstaller.autorun.continueAfterCompareEhcache =3D=20 # autorun remove redundant properties from grouper client # grouperInstaller.autorun.removeRedundantPropetiesFromGrouperClient =3D t # autorun remove redundant properties from grouper properties # grouperInstaller.autorun.removeRedundantPropetiesFromGrouperProperties = =3D t # autorun remove redundant properties from grouper hibernate properties # grouperInstaller.autorun.removeRedundantPropetiesFromGrouperHibernateProp= erties =3D t # autorun remove redundant properties from grouper loader properties # grouperInstaller.autorun.removeRedundantPropetiesFromGrouperLoaderPropert= ies =3D t # autorun remove redundant properties from grouper ws properties # grouperInstaller.autorun.removeRedundantPropetiesFromGrouperWsProperties = =3D t # autorun remove redundant properties from subject properties # grouperInstaller.autorun.removeRedundantPropetiesFromSubjectProperties = =3D t # autorun, uncomment to make work, Error: cant find directory for patch, pr= ess <enter> to continue # grouperInstaller.autorun.continueAfterCantFindPatchDir =3D=20 # This patch requires all processes that user Grouper to be stopped. # Please stop these processes if they are running and press <enter> t= o continue... # grouperInstaller.autorun.continueAfterStoppingGrouperProcesses =3D=20 # autorun, when reverting Would you like to revert patch " + keyBase + " (t= |f)? [f]: # grouperInstaller.autorun.revertPatch =3D f # autorun, uncomment to make work Cannot install patch " + keyBase + " sinc= e it is dependent on a patch=20 # which is not installed: " + dependency continue? # grouperInstaller.autorun.continueAfterPatchDependencyFails =3D # autorun Would you like to install patch " + keyBase + " (t|f)? [t]: # grouperInstaller.autorun.installPatch =3D t # autorun uncomment to make work This patch requires all processes that use= r Grouper to be stopped. # Please stop these processes if they are running and press <enter> t= o continue... # grouperInstaller.autorun.continueAfterPatchStopProcesses =3D=20 # autorun Would you like to be prompted about this patch next time? (t|f)? = [t]: # grouperInstaller.autorun.promptAboutPatchNextTime =3D t # autorun When creating patch if grouper source is already downloaded, use = local source? # grouperInstaller.autorun.createPatchDownloadSourceUseLocalIfExist =3D f # autorun WS uncomment to make work, Since patches were applied/reverted, y= ou should delete files=20 # in your app server work directory, # in tomcat it is named 'work'. Hit <enter> to continue:=20 # grouperInstaller.autorun.continueAfterDeleteWsWorkDirectory =3D # autorun UI uncomment to make work, Since patches were applied/reverted, y= ou should delete files=20 # in your app server work directory, # in tomcat it is named 'work'. Hit <enter> to continue:=20 # grouperInstaller.autorun.continueAfterDeleteUiWorkDirectory =3D # autorun (blank is default) Enter the default IP address for checking port= s (just hit enter to accept the default=20 # unless on a machine with no network, might want to change to 127.0.0.1): = [0.0.0.0]:=20 # grouperInstaller.autorun.defaultIpAddressForPorts =3D # autorun (blank is default) Do you want to use the default and included hs= qldb database (t|f)? [t]:=20 # grouperInstaller.autorun.useBuiltInHsql =3D # autorun uncomment to make work, Note: you need to change the search sql i= n the=20 # jdbc source in the grouperApi/conf/sources.xml... the change is in the co= mments in that file # Ready to continue? (t|f)? [t] # grouperInstaller.autorun.dbContinueAfterChangeSourcesXmlForPostgresSqlSer= ver =3D # autorun uncomment to make work, Do you want to install the provisioning s= ervice provider (t|f)? [t]:=20 # grouperInstaller.autorun.installPsp =3D # autorun uncomment to make work, Do you want to set " + specify + "gsh scr= ipt to executable (t|f)? [t]:=20 # grouperInstaller.autorun.setGshScriptsToExecutable =3D # autorun uncomment to make work, Do you want to run dos2unix on gsh.sh (t|= f)? [t]:=20 # grouperInstaller.autorun.dos2unixOnGsh =3D # autorun uncomment to make work, Do you want to set the tomcat memory limi= t (t|f)? [t]:=20 # grouperInstaller.autorun.setTomcatMemoryLimit =3D # autorun uncomment to make work, Do you want to set tomcat scripts to exec= utable (t|f)? [t]:=20 # grouperInstaller.autorun.setTomcatScriptsToExecutable =3D # autorun uncomment to make work, Do you want to run dos2unix on tomcat sh = files (t|f)? [t]:=20 # grouperInstaller.autorun.runDos2unixOnTomcatFiles =3D # autorun uncomment to make work, What ports do you want tomcat to run on (= HTTP, JK, shutdown): (will default to whats in config file) # grouperInstaller.autorun.tomcatPorts =3D =20 # autorun uncomment to make work, The tomcat HTTP/JK port is in use or unav= ailable: do you want to pick different ports? (t|f) # grouperInstaller.autorun.pickDifferentPortIfInUse =3D f # autorun uncomment to make work, Do you want to set URIEncoding to UTF-8 i= n tomcat server.xml <Connector> elements (t|f)? [t] # note this default can be set in this config file, grouperInstaller.defaul= t.ui.setTomcatUriEncoding, or defaults to true if blank # grouperInstaller.autorun.setUriEncodingToUtf8inServerXml =3D=20 # autorun uncomment to make work, do you want to use local UI download, tar= , etc, default true # grouperInstaller.autorun.useLocalUiDownloadTarEtc =3D=20 # autorun uncomment to make work, do you want to use local WS download, tar= , etc, default true # grouperInstaller.autorun.useLocalWsDownloadTarEtc =3D=20 # autorun uncomment to make work, do you want to use local API download, ta= r, etc, default true # grouperInstaller.autorun.useLocalApiDownloadTarEtc =3D=20 # autorun uncomment to make work, do you want to use local PSP download, ta= r, etc, default true # grouperInstaller.autorun.useLocalPspDownloadTarEtc =3D=20 # autorun uncomment to make work, do you want to use local ant/tomcat/etc d= ownload, tar, etc, default true # grouperInstaller.autorun.useLocalToolsDownloadTarEtc =3D=20 # autorun uncomment to make work, Do you want to add quickstart subjects to= DB (t|f)? [t]:=20 # grouperInstaller.autorun.addQuickstartSubjectsToDb =3D=20 # autorun uncomment to make work, Do you want to add quickstart data to reg= istry (t|f)? [t] # grouperInstaller.autorun.addQuickstartData =3D=20 # autorun Do you want to start the Grouper loader (daemons)? # grouperInstaller.autorun.startGrouperDaemons =3D f # autorun Do you want this script to start the hsqldb database (note, it mu= st not be running in able to start) (t|f)? [t]: # grouperInstaller.autorun.startHsqlDatabase =3D f # autorun This port does not seem available, even after trying to stop the = DB! continue? # grouperInstaller.autorun.continueAfterPortNotAvailable =3D t # autorun Enter the URL path for the UI [grouper]: # grouperInstaller.autorun.urlPathForUi =3D t # autorun uncomment to make work, Enter the WS log dir: (defaults to the to= mcat logs/grouperWs dir # grouperInstaller.autorun.wsLogDir =3D # autorun Do you want to set the log dir of WS (t|f)? [t]:=20 # grouperInstaller.autorun.setWsLogDir =3D # autorun Enter the URL path for the WS [grouper-ws] # grouperInstaller.autorun.wsUrlPath =3D # autorun uncomment to make work, do you want to use local client download,= tar, etc, default true # grouperInstaller.autorun.useLocalClientDownloadTarEtc =3D=20 # autorun uncomment to make work, Is it ok to run a script that copies chan= ge log temp records to the change log (recommended) (t|f) # default is in this file in: grouperInstaller.default.api.runChangeLogToCh= angeLogTemp # grouperInstaller.autorun.runChangeLogTempToChangeLog =3D=20 # autorun, Download patch if already exists on filesystem, unzip, etc? (def= ault true) # grouperInstaller.autorun.useLocalPatchIfExists =3D # autorun, uncomment to make work, if the version that is detected to be ne= xt is ok (t|f) [t] # grouperInstaller.autorun.patchIndexIsOk =3D # autorun, uncomment to make work, Local patch dir exists, is it ok to be a= utomatically deleted? (t|f)? [t] # grouperInstaller.autorun.deleteLocalPatchFile =3D # autorun, unncomment to make work, continue after copying wiki markup # grouperInstaller.autorun.patchContinueAfterWikiMarkup =3D # autorun, Do you want to name this file as a test version so you can test = it without affecting other users? (t|f) [t]: # grouperInstaller.autorun.patchNameFileAsTestVersion =3D
sdf