1. Author: Craig Gallen, OpenNMS Copyright© OpenNMS, 2010
Getting Started with JOSIF
Author: Craig Gallen, OpenNMS
Copyright© OpenNMS, 2010

2. Timetable
Copyright Hewlett-Packard
11-Nov-18

3. Agenda Overview of JOSIF build components download and Installation
starting a project

4. Realistic Model Driven Engineering
Interface model directly derived from the SID
Model based interface generation
Spec RI
CTK
Implementation Libraries
Interface Operations added in Tigerstripe
SID modelled in Rational RSM
Interface Implementation
Same framework for all interfaces
Can be extended to new managed technologies (Modelling: 3G, Ethernet etc)
Can be extended to different management technologies (WSDL, JAVA, etc)
Can be offered to other standards organisations (ITU-T, 3GPP etc)
Can be used internally by SP’s, SI’s, Equipment vendors
OSS
Interface Specification
OSS
OSS
Interface API
(Like OSS/J)

5. Generic Tigerstripe Build Process
Project
Website
Maven 2
Public
Repo
Eclipse Tigerstripe
Workspace
TS Model Project
TS Plugin Project
Packaging Project
jar
pom.xml
zip
doc
Generated
website
Transitory Dependency
Jar in local .m2 repository
Deployed Plugin
Deployed Models
Release Naming
Release n.n SNAPSHOT – under development
Release n.n Final Release
Machine Readable Packaging
Maven Repo; Pom + Jar or OSGi Bundle
Mirrored repo
Web site for XSD checking
Human Readable packaging
Project Web Site
Automatically generated documentation
Test results
Jira – bug /feature tracking
Automatic continuous build process
Triggered by changes to subversion
Checks out changes
Uses Maven to build, est and deploy entire project as a SNAPSHOT
Reports build failure to developer list
Stereotypes
Annotations

6. Interface Program (TIP) Project Organisation
Project Infrastructure
Technology
Tigerstripe
Maven build system
Project Creator
Site
Subversion
Maven Repository
M2 Generated Documentation
Wiki
Bug Tracker
Mail lists
Interface Projects
Model
Specification
Documentation RI
CTK
Implementation Library
Project Infrastructure
Platform Projects
Framework Projects
Interface Projects
Framework Projects
Tigerstripe DOC Generators
Tigerstripe SOAP Generators
TIP Common Model
TIP Internal Model
Test Models
Platform Projects
Java Implementation Generators
Implementation Base Classes
Technology
Maven
Spring
EJB 3 – open EJB
Junit
JPA – Hibernate
JAXB, JAX-WS - Apache CXF
Future
JPA2 - criteria
OSGi dynamic module system for java
SCA Service Component Architecture
Project Namespaces
org.tmforum.tip
Namespace of TM Forum Standard
Group name in maven repo of the standard artefacts from TM Forum Interface Program
org.openoss.tip
Namespace of this specific implementation (one of many)
Group name in maven repo of Implementation artefacts

7. Infrastructure: Project Workspaces
Flat maven structure means related projects can co-exist in same Tigerstripe Workspace but still pass dependencies using maven

8. Agenda Overview of JOSIF build components download and Installation
starting a project

9. Java Download and Installation
NOTE; use JDK 6 Update 20 NOT Update 21 or follow instructions at .0_21_on_Windows
Set (windows) class path to point to JDK
right click on desktop Computer icon
select properties
select advanced system settings
select environment variables
Path
C:\Program Files\PHP\;C:\Program Files\CollabNet Subversion;C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\Program Files\CyberLink\Power2Go\;C:\Program Files\Java\jdk1.6.0_18\bin;C:\Program Files\Apache_Software_Foundation\apache-maven-2.2.1\bin;C:\Program Files\Common Files\Teleca Shared:C:\Program Files\OpenOffice.org 2.0\program;C:\Program Files\CollabNet Subversion;C:\ant\apache-ant-1.7.1\bin;C:\Program Files\PuTTY\;C:\Program Files\Samsung\Samsung PC Studio 3\;C:\cygwin\bin;C:\Program Files\QuickTime\QTSystem\;C:\Program Files\Microsoft SQL Server\100\Tools\Binn\;C:\Program Files\Microsoft SQL Server\100\DTS\Binn\
to test in command window try
java –version
javac -version

10. Eclipse Galileo Installation
Note ensure to use Eclipse Galileo NOT Helios
Download Eclipse IDE for Java EE Developers (32 bit windows - eclipse-jee-galileo- win32.zip
Unpack zip file to location near C:/
I use C:\eclipsets
edit eclipse.ini file:
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_ v
-startup
plugins/org.eclipse.equinox.launcher_ R35x_v jar
-product
org.eclipse.epp.package.jee.product
--launcher.XXMaxPermSize
256M
-showsplash
org.eclipse.platform
256m
-vmargs
-XX:MaxPermSize=500m
-Dfile.encoding=UTF-8
-Dosgi.requiredJavaVersion=1.5
-Xms500m
-Xmx768m
Start up eclipse – double click on eclipse.exe
Eclipse will ask you to select a workspace- Use one Near to C://
I use C://ws-ts1

11. Other eclipse settings
In window / preferences
Java
set java JRE to point to installed JDK
Select search for JRE and look in
C:\\program files\java
XML
set xml editor to 160 character width
set xml editor to use spaces (2) instead of tabs
Ant
set ant editor to 160 character width
set ant editor to use spaces (2) instead of tabs
set ant editor to no folding

12. Eclipse Plugin Installation
Tigerstripe site
see
In eclipse select help>Install new software
enter new update site
Use Tigerstripe Interim download site
Install Subversion client
Subclipse -
Optional
May also install
TestNG Buest -
AnyEdit -
These are installed by dropping jar into C:\eclipsets\plugins

13. Maven Download and Installation
( read install instructions)
download apache-maven-2.2.1
install at
C:\Program Files\Apache_Software_Foundation\apache-maven
set environment variables
set class path ( see example for java)
set M2_HOME
C:\Program Files\Apache_Software_Foundation\apache-maven-2.2.1
set MAVEN_OPTS
-XX:MaxPermSize=256m -Xmx1024m
Test in command window type mvn -version

14. Simple Maven Example simple example
see
mvn archetype:generate
choose simple example (15)
change to directory of created project
type mvn clean install
Look in your home directory look for m2 repository
C:\Users\cgallen\.m2\repository
to see in eclipse – need to map into eclipse class path
got to window>Preferences>Java>Build Path>Classpath variables
add variable M2_REPO pointing at C:\Users\cgallen\.m2\repository
import project into eclipse
right click project explorer
import> existing projects into workspace
browse to project workspace and select generated projects
To see whole project select customize view – unclick *.resources

15. Agenda Overview of JOSIF build components download and Installation
starting a project

16. Using Project Creator if needed download latest project creator from
create new workspace
create M2_REPO class path variable
download latest project creator from
snapshots/org/openoss/tip/TIP_Project_Creator/
named something like;
TIP_Project_Creator standard.jar
run project creator
place project creator in workspace and double click on jar
or in command window java –jar TIP_Project_Creator standard.jar
Will create multiple related projects in workspace

17. Import new project into eclipse
cd to <projectname>_BaseProject
this is the main project which calls the build of all other projects
type mvn clean install
this should start the build – but the build may fail because no plugins or profile are installed
Start Eclipse and import projects into workspace
follow same steps as with simple maven project – note you may not be able to import all the projects if build does not complete
Import plugins and tigerstripe profile
These will be downloaded into <projectname>_Model/TigerstripeGenerators
double click on tip_profile.wbp – load into tigestripe workspace
Eclipse>tigerstripe>plugins – right click and import the plugins downloaded into TigerstripeGenerators
exit eclipse and again type mvn clean install in <projectname>_BaseProject
this should complete
restart eclipse and import all the projects into the workspace

18. checking out existing project
You need to have installed subclipse
eclipse>window>open perspective>SVN repository exploring
right click on SVN repositories pane
add new repository location
navigate to the project and check out into workspace
tip/interfaces/ServiceProblemManagement/trunk
right click on all projects and check out into workspace
set tigerstripe.properties file
IN <projectname>_Model/
copy tigerstripe.properties-TEMPLATE to tigerstripe.properties
change the paths in tigerstripe.properties to point to your tigerstripe installation and to your project worksapace
Now follow same steps as when using project creator to build project and import into workspace
after build set svn:ignore on target, .properties, *log*, .classpath if not already set for checked out project.

19. References
JOSIF main page noss/index.php?title=TIP_Main_Page
JOSIF GuideBook noss/index.php?title=Framework_Guidebook
JOSIF Getting Started noss/index.php?title=Getting_Started
Copyright Hewlett-Packard
11-Nov-18