You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 37 Next »


 This topic is discussed in the "Grouper Installer" training video.

Unknown macro: {children }

The Grouper Installer is a jar that will install the Grouper API, quickstart data, UI, WS, and client.  The only prerequisites are Java 1.6+ JDK, and the grouperInstaller.jar.  It will work in Windows, Unix, Mac (any OS where you can run DOS or shell scripts).  It prints out which files are being edited, and which commands are being run, so the user can learn from what is going on.  It uses the stock Grouper packages so there is no magic or hidden configuration included.

In Grouper 2.2.1 the installer can [upgrade ]Grouper as well.

Here is a movie showing the installer (windows, unix/linux/mac)

Running without network

The Grouper installer requires the internet to download the Grouper tarballs.  If you want to run this without the network, download all the tarballs (example links for 2.0.2) (apiBinary, ui, ws, client) and the subjects file (into subjects.sql), and quickstart file (into quickstart.xml), ant, tomcat to the install directory.  When the script asks if you want to use the local files, type: t (or just <Enter> since the default is t)

FAQ

How do I create a schema for my database?

Ask the DBA to do this, here is an example for a local Oracle installation

I'm using local files for grouperInstaller.jar, but don't see an option for using local files which are in the jar's directory.

It will install the first time without using local files.  Then once things are downloaded and built, stop tomcat and hsql, and put some jars in the API lib/custom directory.  Then run the installer again, but dont download or extract the tarballs again, and it should build the UI/WS with your jars.

Problem with HSQL DB port:

If there is a problem with the HSQL port, then select that you do not want to use the default included database, then for the database URL, change the port to something else, e.g. from 9001 to 9002 with URL like this: jdbc:hsqldb:hsql://localhost:9002/grouper     Leave the username and pass as "sa" and <blank>, and continue

Problem with Java JDK:

There are two types of Java: JRE (runtime env), and JDK (development kit).  If you are running with the JRE (which doesnt have a compiler), then you need to make sure you run with the JDK.  If you type "javac -version" in your prompt, and it is not java6, or it is not found, then try running the installer with the absolute path of java, e.g. on windows:

What do I do when I am done with the installer?

See the page on Getting Ready for Production

Example output

See also

Grouper API

  • No labels