Installation Guide

Important

Breeze 5 can support single sign-on from an external system via modifications to it's configuration to support HTTP Header Authentication. However, additional modifications must be made in order for this authentication to work with the XML API. By making these modifications, any external system that can process HTTP requests will be able to communicate to a Breeze 5 server's XML API without having to reauthenticate.

Information

Installation instructions for the breeze tool for system administrators.

Pre-requisite

This tool is designed to work with Sakai Schedule tool. So before adding this tool in any Sakai site, please make sure the site has Sakai Schedule tool installed correctly. Once done by integrating both Sakai Schedule tool and Sakai Breeze tool in a Sakai site, all Meeting event created in Sakai Schedule tool will be automatically added a link to the corresponding Breeze Server, which will be concerned in the next steps.

How to get the source code and build breeze tool

Breeze works on Sakai 2.4, it may work on earlier versions but this is at your own risk

Change to your sakai source directory (e.g. /opt/sakai-2.4/)
Run svn co https://source.sakaiproject.org/contrib/caret/breeze/trunk breeze
- Note: Subversion will create a breeze directory for you, you can use any directory name you like, just change the last word of the svn command
Change to your breeze source directory (e.g. /opt/<sakai-src>/breeze/)
Run maven sakai
1. If it fails, go and open your build.properties file under $USER_HOME/ directory, check if it includes all the source repository information here:
  maven.repo.remote = http://source.sakaiproject.org/maven/,http://ponder.org.uk/maven,http://www2.caret.cam.ac.uk/maven
  then go back to breeze source directory and run maven sakai again.
2. If it still fails, check the build log to see if any library file failed to be downloaded. If so, download them from http://www2.caret.cam.ac.uk/maven/ into library repository (by project.properties file you can get the version of libraries needed, usually it should be the latest), which is in $USER_HOME/.maven/repository/ directory.

How to install this application in Sakai

Start tomcat
Login to sakai as an admin user: (e.g. admin, password: admin)
In the workspace panel, click My Workspace
In the left panel, click Sites
In the Sites function pages panel, click New Site
Name the new sites Site Id as breeze or any other words.
Click Save button at bottom to finish its creation.
Click Worksite Setup in the left panel.
Click the newly created site name, click Revise in the Worksite Setup function page panel.
Click Edit Tools in the function panel.
Select Aurai - Sakai Breeze Integration. Sakai Breeze Integration Tool in the list, click Continue button, click Finish button.
Enter the new site by clicking it in the workspace panel.
If Aurai - Sakai Breeze Integration appears in the left panel, congratulations! You've installed breeze tool.

There could be some configuration problems, just ignore them for now. They will be solved in the next Configuration steps.

Setup Breeze Server before configuring Sakai

Make sure your Breeze Server software is updated

Configure breeze server web.xml

Open the file $BreezeFolder\appserv\conf\WEB-INF\web.xml and remove the comments surrounding the HeaderAuthenticationFilter group.

Comment out the <init-param> tag surrounding the /api/ <param-value> within the HeaderAuthenticationFilter group. Then this part should be like this:

  <filter>
    <filter-name>HeaderAuthenticationFilter</filter-name>
    <filter-class>com.macromedia.airspeed.servlet.filter.HeaderAuthenticationFilter</filter-class>
<!--
    <init-param>
      <param-name>ignore-pattern-0</param-name>
      <param-value>/api/</param-value>
    </init-param>
-->
    <init-param>
      <param-name>ignore-pattern-1</param-name>
      <param-value>/common/</param-value>
    </init-param>
    <init-param>
      <param-name>ignore-pattern-2</param-name>
      <param-value>/servlet/gateway/</param-value>
    </init-param>
    <init-param>
      <param-name>ignore-pattern-3</param-name>
      <param-value>/servlet/mirror</param-value>
    </init-param>
    <init-param>
      <param-name>ignore-pattern-4</param-name>
      <param-value>/servlet/testbuilder</param-value>
    </init-param>
    <init-param>
      <param-name>ignore-pattern-5</param-name>
      <param-value>/cfbreeze-war/</param-value>
    </init-param>
  </filter>

Configure custom.ini
1. Open the file $BreezeFolder\custom.ini and add an entry for the name of the custom header
```
HTTP_AUTH_HEADER=My-header-name
```
2. My-header-name should be protected as much as a password, although it is written as plain text in breeze server.
Restart Breeze server

Permissions

This tool uses full Sakai permissions, without them set correctly, the user will not have
any options appear when they enter the tool (unless an admin has setup some meetings, in which case they can join them)

Make sure your site maintainer has the following permissions
- For accessing the options and sceduling events in the tool
  1. conf.sched.admin
  2. site.view
  3. site.upd
- For creating meetings in Schedule
  1. calendar.delete.own
  2. calendar.new
  3. calendar.read
  4. calendar.revise.own

No special permissions are needed to view and join events at this time

How to configure breeze tool

Login to sakai as user: admin, password: admin
Enter the breeze site by clicking it in the workspace panel.
Click Aurai - Sakai Breeze Integration in the left panel.
Click Options in the functional panel.
Fill in the boxes with the following information:
```
Breeze User:        user@mycompany.com
Breeze Server:      http://breeze.mycompany.com/
Http Header:        My-header-name
```
1. user@mcompany.com is a user on the Breeze server.
2. http://breeze.mycompany.com/ is the Breeze server's URL
3. My-header-name is the header you set in Pre-works on Breeze Server before configuring Sakai chapter.
Click Update Configurations
If Scheduled Meetings and Expired Meetings bold words appear, congratulations! You have successfully configured it right.

How to use breeze tool

Breeze tool lists all the Scheduled Meetings and Expired Meetings in its page, click the link will lead you in the corresponding breeze meeting without asking for username or password.
For detail, please refer to Users Guide.
For how to use breeze, please refer to http://www.adobe.com/products/acrobatconnectpro/.