Page History

...

1. Download or unzip grouper-ui
   1. e.g. for the 1.4 branch
2. Run ant    -   exit
3. Edit the build.properties,
   1. set the grouper.folder if not ../grouper
   2. set dist.home,  e.g. dist.home=dist
   3. set no metainf context: should.copy.context.xml.to.metainf=false
4. Run ant    -    dist
5. Edit your tomcat_home/conf/server.xml, add a context for the UI
   1. <Engine defaultHost="localhost" name="Catalina">
        <Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase"/>
        <Host appBase="webapps" autoDeploy="true" name="localhost" unpackWARs="true" xmlNamespaceAware="false" xmlValidation="false">
          <Context docBase="C:\dev_inst\eclipse\workspace_v33\grouper-ui\dist\grouper" path="/grouper" reloadable="false"/>
        </Host>
      </Engine>
   2. Edit the <Connectors to have uri encoding of utf8
      <Connector  URIEncoding="UTF-8"
6. Add the user/pass to your tomcat_home/conf/tomcat-users.xml
   1. <tomcat-users>
        <role rolename="grouper_user"/>
        <user username="mchyzer" password="whateveryouwant" roles="grouper_user"/>
      </tomcat-users>
7. Start tomcat
8. Go to URL: http://localhost:8080/grouper (or wherever you mapped this to tomcat)
9. You should be able to login with the credentials in the tomcat-users.xml, and you should see the act as admin dropdown in the upper right

...

1. Checkout or download grouper web services
   1. e.g. for the 1.4 branch
2. Stop tomcat
3. Do a build in ws: ant quick
4. Change these settings in the build.properties:
   1. grouper.lib.dir=../grouper/lib/grouper
      grouper.jar.name=../grouper/dist/lib/grouper.jar
      grouper.conf.dir=../grouper/conf
      generated.client.project.dir=../grouper-ws-java-generated-client_HEAD
5. Edit these lines in the grouper-ws.properties
   1. ws.act.as.group = etc:webServiceActAsUsers
      ws.client.user.group.name = etc:webServiceUsers
6. Do another build: ant quick
7. Edit your tomcat_home/conf/server.xml, add a context for the WS
   1. <Engine defaultHost="localhost" name="Catalina">
        <Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase"/>
        <Host appBase="webapps" autoDeploy="true" name="localhost" unpackWARs="true" xmlNamespaceAware="false" xmlValidation="false">
          <Context docBase="C:\dev_inst\eclipse\workspace_v33\grouper-ui\dist\grouper" path="/grouper" reloadable="false"/>
          <Context docBase="C:\dev_inst\eclipse\workspace_v33\grouper-ws_HEAD\build\dist\grouper-ws" path="/grouperWs" reloadable="false"/>
        </Host>
      </Engine>
8.  Start tomcat

...

To use hsql, you should go in server mode.  To do this,

• start the server:

F:\temp\grouper1.4\grouper-api-1.4.1\bin>java -cp ..\lib\jdbcSamples\hsqldb.jar org.hsqldb.Server -database.0 file:grouper -dbname.0 grouper

* Change your grouper.hibernate.properties:

hibernate.dialect               = org.hibernate.dialect.HSQLDialect
hibernate.connection.driver_class = org.hsqldb.jdbcDriver
hibernate.connection.url = jdbc:hsqldb:hsql://localhost/grouper
hibernate.connection.username         = sa
hibernate.connection.password         =

* Start admin tool if you like

F:\temp\grouper1.4\grouper-api-1.4.1\bin>java -cp ..\lib\jdbcSamples\hsqldb.jar org.hsqldb.util.DatabaseManager -url jdbc:hsqldb:hsql://localhost/grouper

* To delete the database, delete the files from the dir where you started hsqldb: grouper.log, grouper.properties, grouper.script