Description
The grouper installer admin tool will help grouper administrators perform tasks administrative tasks on grouper (generally for grouper installed by the installer but might be useful for other installations as well).
Run the admin tool
java -jar grouperInstaller.jar Do you want to 'install' a new installation of grouper, 'upgrade' an existing installation or 'patch' an existing installation (enter: 'install', 'upgrade', 'patch', 'admin' or blank for the default) [install]: admin
Main menu
in the admin tool you can:
What admin action do you want to do (manage, upgradeTask)?
- manage
- find logs
- stop/start services
- upgrade tasks
- convert ehcache xml to properties
Admin - Manage
What do you want to manage (logs, services, back, exit)?
Admin - Manage - Logs
API logs example
Chriss-MacBook-Air:grouper-installer mchyzer$ java -jar grouperInstaller.jar
Do you want to 'install' a new installation of grouper, 'upgrade' an existing installation, 'patch' an existing installation, 'admin' utilities, or 'createPatch' for Grouper developers (enter: 'install', 'upgrade', 'patch', 'admin', 'createPatch' or blank for the default): admin
What admin action do you want to do (manage, upgradeTask)? : manage
Enter in the Grouper install directory (note: better if no spaces or special chars) : /Users/mchyzer/tmp/grouperInstaller
What do you want to manage (logs, services, back, exit)? logs
What do you want to look at logs for? api, ui, ws, pspng, or psp? [api]:
First we need to find where the application is running, then find the log4j.properties in the classpath.
The API (generally invoked via GSH) logs to where the log4.properties specifies.
By default the installer configures the log file to be: /Users/mchyzer/tmp/grouperInstaller/grouper.apiBinary-2.3.0/logs/grouper_error.log
The log4j.properties is located in: /Users/mchyzer/tmp/grouperInstaller/grouper.apiBinary-2.3.0/conf/log4j.properties
Examine the log4j.properties to see where it is logging
Generally the log4j.rootLogger property shows where logs go, it is set to: ERROR, grouper_error
The log4j.rootLogger property in log4j.properties is set to: grouper_error
There is a property in log4j.properties: log4j.appender.grouper_error.File = ${grouper.home}logs/grouper_error.log
Grouper log should be: /Users/mchyzer/tmp/grouperInstaller/grouper.apiBinary-2.3.0/logs/grouper_error.log
Press <enter> to continue.
What do you want to manage (logs, services, back, exit)? : exit
Chriss-MacBook-Air:grouper-installer mchyzer$
UI logs example
Chriss-MacBook-Air:grouper-installer mchyzer$ java -jar grouperInstaller.jar Do you want to 'install' a new installation of grouper, 'upgrade' an existing installation, 'patch' an existing installation, 'admin' utilities, or 'createPatch' for Grouper developers (enter: 'install', 'upgrade', 'patch', 'admin', 'createPatch' or blank for the default) [admin]: What admin action do you want to do (manage, upgradeTask)? : manage Enter in the Grouper install directory (note: better if no spaces or special chars) : /Users/mchyzer/tmp/grouperInstaller What do you want to manage (logs, services, back, exit)? : logs What do you want to look at logs for? api, ui, ws, pspng, or psp? [api]: ui Find where the application is running, then find the log4j.properties in the classpath. Tomcat logs STDOUT and STDERR to the catalinaErr.log and catalinaOut.log logfiles, which should be here: /Users/mchyzer/tmp/grouperInstaller/apache-tomcat-6.0.35/logs Locate the logs files. By default the installer has the UI running based on the tomcat server.xml, but could also run in the webapps dir. The server.xml is located: /Users/mchyzer/tmp/grouperInstaller/apache-tomcat-6.0.35/conf/server.xml What is the URL starting path? [grouper]: grouper Looking for an entry in the server.xml that looks like this: <Context docBase="/Users/mchyzer/tmp/grouperInstaller/grouper.ui-2.3.0/dist/grouper" path="/grouper" reloadable="false"/> The docBase for the grouper entry in the server.xml is: /Users/mchyzer/tmp/grouperInstaller/grouper.ui-2.3.0/dist/grouper The log4j.properties is located in: /Users/mchyzer/tmp/grouperInstaller/grouper.ui-2.3.0/dist/grouper/WEB-INF/classes/log4j.properties Examine the log4j.properties to see where it is logging Generally the log4j.rootLogger property shows where logs go, it is set to: ERROR, grouper_error The log4j.rootLogger property in log4j.properties is set to: grouper_error There is a property in log4j.properties: log4j.appender.grouper_error.File = /Users/mchyzer/tmp/grouperInstaller/apache-tomcat-6.0.35/logs/grouperUi/grouper_error.log Grouper log should be: /Users/mchyzer/tmp/grouperInstaller/apache-tomcat-6.0.35/logs/grouperUi/grouper_error.log Press <enter> to continue. What do you want to manage (logs, services, back, exit)? : exit Chriss-MacBook-Air:grouper-installer mchyzer$
UI logs not from installer
[appadmin@i2midev1 patchesAuto]$ java -jar grouperInstaller.jar Do you want to 'install' a new installation of grouper, 'upgrade' an existing installation, 'patch' an existing installation, 'admin' utilities, or 'createPatch' for Grouper developers (enter: 'install', 'upgrade', 'patch', 'admin', 'createPatch' or blank for the default) [install]: admin What admin action do you want to do (manage, upgradeTask)? : manage Enter in the Grouper install directory (note: better if no spaces or special chars) [/opt/grouper/2.3/patchesAuto]: /opt/tomcats/tomcat_f What do you want to manage (logs, services, back, exit)? : logs What do you want to look at logs for? api, ui, ws, pspng, or psp? [api]: ui Find where the application is running, then find the log4j.properties in the classpath. Tomcat logs STDOUT and STDERR to the catalinaErr.log and catalinaOut.log logfiles, which should be here: /opt/tomcats/tomcat_f/logs Locate the UI application files. By default the installer has the UI running based on the tomcat server.xml, but could also run in the webapps dir. The server.xml is located: /opt/tomcats/tomcat_f/conf/server.xml What is the URL starting path? [grouper]: grouper_v2_3 Looking for an entry in the server.xml that looks like this: <Context docBase="/opt/tomcats/tomcat_f/grouper.ui-2.3.0/dist/grouper" path="/grouper_v2_3" reloadable="false"/> The docBase could not be found in the server.xml, check in the tomcat/webapps directory The log4j.properties is located in: /opt/tomcats/tomcat_f/webapps/grouper_v2_3/WEB-INF/classes/log4j.properties Examine the log4j.properties to see where it is logging Generally the log4j.rootLogger property shows where logs go, it is set to: ERROR, grouper_error The log4j.rootLogger property in log4j.properties is set to: grouper_error There is a property in log4j.properties: log4j.appender.grouper_error.File = /opt/tomcats/tomcat_f/logs/grouper_v2_3/grouper_error.log Grouper log should be: /opt/tomcats/tomcat_f/logs/grouper_v2_3/grouper_error.log Press <enter> to continue. What do you want to manage (logs, services, back, exit)? : exit [appadmin@i2midev1 patchesAuto]$
Admin - Upgrade - Convert ehcache XML to properties
[appadmin@i2midev1 patchesAuto]$ java -jar grouperInstaller.jar Do you want to 'install' a new installation of grouper, 'upgrade' an existing installation, 'patch' an existing installation, 'admin' utilities, or 'createPatch' for Grouper developers (enter: 'install', 'upgrade', 'patch', 'admin', 'createPatch' or blank for the default) [install]: admin What admin action do you want to do (manage, upgradeTask)? : upgradeTask What upgrade task do you want to do (convertEhcacheXmlToProperties)? : convertEhcacheXmlToProperties Note, you need to convert the ehcache.xml file for each Grouper runtime, e.g. loader, WS, UI. Note, you need to be running Grouper 2.3.0 with API patch 35 installed. Enter the location of the ehcache.xml file: /opt/tomcats/tomcat_f/webapps/grouper_v2_3/WEB-INF/classes/ehcache.xml Enter the location of the grouper.cache.base.properties file [/opt/tomcats/tomcat_f/webapps/grouper_v2_3/WEB-INF/classes/grouper.cache.base.properties]: Enter the location of the grouper.cache.properties file (to be created) [/opt/tomcats/tomcat_f/webapps/grouper_v2_3/WEB-INF/classes/grouper.cache.properties]: File was written: /opt/tomcats/tomcat_f/webapps/grouper_v2_3/WEB-INF/classes/grouper.cache.properties
sdf
sdf