Child pages
  • UI Installation -OLD VERSION
Skip to end of metadata
Go to start of metadata
Unable to render {include} The included page could not be found.

Configuring and Deploying Grouper's UIs

This document pertains to Grouper v1.5.0 and later.

In this section we describe how to configure, build, and deploy the Grouper UI web application.

UI Configuration

For many purposes, UI customization needs can be met by altering declarations in the grouper-ui/resources/grouper/media.properties file. Logos, use of subject attributes in various search and display contexts, sorting behavior, and much more is specified in this file. See Grouper UI Properties for the details.

The UI is designed to be deeply customizable while remaining "upgrade proof". Readers needing all of the gory details should consult Customising the Grouper UI.

Building & Deploying

  1. Copy grouper-ui/build.properties.template to grouper-ui/build.properties.


  1. Review grouper-ui/build.properties.


  1. #* Set login.ui-lite.show-link=true if you want users to be able to log in to the Lite UI and set ui-lite.link-from-admin-ui=true if you want the Administrative UI to use the Lite UI's membership management widget.
    • If you want the build script to automatically install the UI in your Tomcat instance, uncomment and set the appropriate value for deploy.home. If you do not set this you will need to copy the UI to your Tomcat installation's webapps directory. You will probably want to define the default.webapp.folder to suit how you intend to develop or customise the UI. See the Grouper UI Development Environment for options.
    • Make sure you set the grouper.folder property to the location of your Grouper installation.


  1. Copy grouper-ui/template-tomcat-context.xml to grouper-ui/tomcat-context.xml (or the value of the property deploy.context.xml if you have changed this).
    • Tomcat specific configuration can be added in this file e.g., container managed data sources.


  1. Change directory to grouper-ui and type "ant".
    • A list of build targets is displayed. If you have set deploy.home enter "default". Otherwise type "dist" or "war". If the former copy <dist.home>/grouper to <TOMCAT_HOME>/webapps, or if the latter, copy <dist.home>/grouper.war to <TOMCAT_HOME>/webapps.
    • If you want to take advantage of the 'nice' targets you must uncomment and set appropriate values for all the deploy properties in grouper-ui/build.properties.


Note: The build process will attempt to create a directory peer to the grouper-ui directory. Hence, the directory grouper-ui/.. must be writable.


     (question) Questions or comments? (info) Contact us.

Unable to render {include} The included page could not be found.
  • No labels