This document is intended to describe how to create a maven overlay project to build your own instance of the Scheduling Assistant configured for your Oracle Communications Suite Calendar Server instance.
These instructions are largely identical to those in Deploying the Scheduling Assistant - Bedework. The University of Wisconsin-Madison has verified these instructions work with version "7u1-1.11."
You'll need the following before you begin:
- Oracle Communications Suite Calendar Server 7 or later
- Administrative credentials for your Calendar Server instance
- Java Development Kit (JDK) version 6
- Apache Maven 3 https://maven.apache.org/
- Apache Ant 1.8 https://ant.apache.org/
- Apache Tomcat 6 https://tomcat.apache.org/
- A database to store Scheduling Assistant specific information (like Schedule Owner preferences and availability schedules, relationships, etc.)
At this time, the Scheduling Assistant supports HSQL and Oracle databases. The SQL used is ANSI and should work with other databases. If you wish to deploy against another database please contact the mailing list at 'firstname.lastname@example.org' and we'll help you get running.
The Scheduling Assistant needs super user credentials for your Oracle Communications Suite Calendar Server instance in order to create and manipulate appointments on behalf of the participants. The 'calmaster' user meets these requirements, you may wish to create a separate account for use by the Scheduling Assistant. If you create a separate account, it needs to be a "memberOf" the following LDAP group:
Creating the war overlay project
Maven's war plugin allows you to create an "overlay" of another maven war project. In short, this feature allows you to import another project and lay your own changes over the top.
You can find more information about maven war overlays at: https://maven.apache.org/plugins/maven-war-plugin/overlays.html
- Download the sample overlay project at https://mywebspace.wisc.edu/npblair/jasig/my-sched-assist-oraclecommssuite-war-1.0.2.zip and unzip on your filesystem.
The released versions of the Scheduling Assistant come pre-configured to talk to a Oracle Communications Suite Calendar Server instance. All you need to provide is a properties file that contains the hostnames, ports, usernames and passwords to integrate with your environment. Directly under your my-sched-assist-oraclecommssuite-war directory, open the file with the path:
- Edit the properties according to the comments. It is critical that you change the values of the ws.username and ws.password properties from the default to avoid being vulnerable to untrusted web service requests.
- Once the properties file matches your environment, save the file.
- You should also edit 'src/main/webapp/META-INF/context.xml' to match the JDBC credentials for the database; by default this file contains the credentials for the HSQL database that can be started from the Scheduling Assistant source.
Execute the following command from the root of your my-sched-assist-war directory:
- This will download the version of the Scheduling Assistant specified in the pom.xml and add your configuration. The result will be a war file named 'my-scheduling-assistant.war' in the target sub-directory.
Copy this war file to the webapps directory of your Tomcat 6 instance.
You can optionally change the name of the war and a few other properties by editing the project's POM:
- Open the pom.xml in the my-sched-assist-war directory. You can free to change the following properties as you see fit:
- name, description
- scheduling.assistant.version (under the properties section)
- finalName (under the build section)
Creating an overlay of the portlet
The Scheduling Assistant portlet requires no custom configuration for use with an Oracle Communications Suite environment. Follow the instructions in the Bedework documentation: