From about OpenWis.
OpenWIS is an implementation of WMO Information System (WIS) and aims to perform the three functions required by the WIS, i.e. GISC, DCPC and NC. It is originally developed by AKKA Information System (France) on behalf of OpenWIS Association (with UKMO, MF, BoM, KMA, and MFI as the founding members)
- Oracle JDK 1.7
- Maven 2.2.1
The JAVA_HOME should be set with the valid JDK path.
The MAVEN_OPTS should be set with "-Xms256m -Xmx512m -XX:MaxPermSize=256m" to avoid OutOfMemory issue during the build.
The "mvn" command should be available in the terminal, maybe you should add the /bin directory to the PATH
Repository Contents:
.
+-- pom.xml
|+--openwis-dataservice
|+--openwis-dataservice-cache
|+-- openwis-dataservice-cache-core
|+-- openwis-dataservice-cache-ejb
|+-- openwis-dataservice-cache-ftpreplication (not used)
|+-- openwis-dataservice-cache-test (not used)
|+-- openwis-dataservice-cache-webapp
|+--openwis-dataservice-common
|+-- openwis-dataservice-common-domain
|+-- openwis-dataservice-common-timer
|+-- openwis-dataservice-common-utils
|+--openwis-dataservice-server
|+-- openwis-dataservice-server-ear
|+-- openwis-dataservice-server-ejb
|+-- openwis-dataservice-server-test (not used)
|+-- openwis-dataservice-server-webapp
|+--openwis-factorytests
|+--openwis-harness
|+--openwis-harness-client
|+--openwis-harness-dissemination
|+--openwis-harness-localdatasource
|+--openwis-harness-mssfss
|+--openwis-harness-samples (not used)
|+--openwis-harness-subselectionparameters
|+--openwis-management
|+--openwis-management-client
|+--openwis-management-server
|+--openwis-metadataportal
|+--cachingxslt
|+--jeeves
|+--oaipmh
|+--openwis-portal
|+--openwis-portal-solr
|+--schematrons (not used)
|+--sde
|+--openwis-portal-client
|+--openwis-securityservice
|+--openwis-securityservice-war
|+--openwis-securityservice-utils
|+--GenerateSPConfFiles
|+--PopulateLDAP
|+--openwis-stagingpost
|+--resources
|+--openwis-libs
- openwis-dataservice: contains the dataservice module (including the cache system)
- openwis-factorytests: contains selenium functional tests
- openwis-harness: contains harness WSDL (dissemination, localdatasource) and samples harness implementations
- openwis-management: contains management module (monitoring and control)
- openwis-metadataportal: contains portals module
- openwis-release: contains some binary (JBoss, PostgreSQL, ...)
- openwis-securityservice: contains the security module
- openwis-stagingpost: contains the staging post web application
- resources: contains jars required for build but not available on Public Maven repositories
- openwis-libs: module which makes use of the maven install-file plugin in ordet to install openam and forgerock dependencies and must be built in the beginning with the profile 'dependencies'
Harness WSDL
- The harness dissemination WSDL and WSD: openwis-harness/openwis-harness-dissemination/src/wsdl/
- The harness localdatasource WSDL and WSD: openwis-harness/openwis-harness-localdatasource/src/wsdl/
- The harness MSSFSS WSDL and WSD: openwis-harness/openwis-harness-mssfss/src/wsdl/
- The harness subselectionparameters WSDL and WSD: openwis-harness/openwis-harness-subselectionparameters/src/wsdl/
#1. Installing JavaEE
Javee is a library that is shipped with installations of GlassFish but is not available in any pulic Maven repository. In a terminal launch the command mvn clean exec:exec
#2.Launch the Maven build
In a terminal, go into the root directory and launch the command: mvn clean install -Pdependencies,openwis -DskipTests -Dfile.encoding=UTF-8
After few minutes the build should finished successfully like this:
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO] ------------------------------------------------------------------------
[INFO] OpenWIS ............................................... SUCCESS [1.248s]
[INFO] openwis-libs .......................................... SUCCESS [2.572s]
[INFO] openwis-harness ....................................... SUCCESS [0.000s]
[INFO] openwis-harness-subselectionparameters ................ SUCCESS [6.724s]
[INFO] openwis-harness-localdatasource ....................... SUCCESS [1.232s]
[INFO] openwis-harness-client ................................ SUCCESS [0.796s]
[INFO] openwis-harness-mssfss ................................ SUCCESS [1.560s]
[INFO] openwis-harness-dissemination ......................... SUCCESS [1.264s]
[INFO] openwis-management .................................... SUCCESS [0.046s]
[INFO] openwis-management-client ............................. SUCCESS [4.134s]
[INFO] openwis-management-service ............................ SUCCESS [0.016s]
[INFO] openwis-management-service-common ..................... SUCCESS [1.045s]
[INFO] openwis-management-service-ejb ........................ SUCCESS [6.740s]
[INFO] openwis-management-service-ear ........................ SUCCESS [4.118s]
[INFO] openwis-dataservice ................................... SUCCESS [0.016s]
[INFO] openwis-dataservice-common ............................ SUCCESS [0.015s]
[INFO] openwis-dataservice-common-utils ...................... SUCCESS [1.513s]
[INFO] openwis-dataservice-common-domain ..................... SUCCESS [2.762s]
[INFO] openwis-dataservice-common-timer ...................... SUCCESS [2.761s]
[INFO] openwis-dataservice-cache ............................. SUCCESS [0.016s]
[INFO] openwis-dataservice-cache-core ........................ SUCCESS [0.998s]
[INFO] openwis-dataservice-cache-ejb ......................... SUCCESS [3.354s]
[INFO] openwis-dataservice-cache-webapp ...................... SUCCESS [1.728s]
[INFO] openwis-dataservice-server ............................ SUCCESS [0.011s]
[INFO] openwis-dataservice-server-ejb ........................ SUCCESS [4.073s]
[INFO] openwis-dataservice-server-webapp ..................... SUCCESS [1.295s]
[INFO] openwis-dataservice-server-ear ........................ SUCCESS [0.515s]
[INFO] openwis-dataservice-config ............................ SUCCESS [2.621s]
[INFO] openwis-portal-client ................................. SUCCESS [17.862s]
[INFO] GeoNetwork opensource ................................. SUCCESS [0.000s]
[INFO] Caching xslt module ................................... SUCCESS [0.514s]
[INFO] Jeeves modules ........................................ SUCCESS [4.181s]
[INFO] Oaipmh modules ........................................ SUCCESS [1.155s]
[INFO] ArcSDE module (dummy-api) ............................. SUCCESS [1.560s]
[INFO] openwis-portal-solr ................................... SUCCESS [7.301s]
[INFO] openwis-securityservice ............................... SUCCESS [0.015s]
[INFO] openwis-securityservice-utils ......................... SUCCESS [0.000s]
[INFO] openwis-securityservice-utils-populate-ldap ........... SUCCESS [4.181s]
[INFO] openwis-securityservice-war ........................... SUCCESS [9.657s]
[INFO] openwis-stagingpost ................................... SUCCESS [0.327s]
[INFO] OpenWIS module ........................................ SUCCESS [36.687s]
[INFO] ------------------------------------------------------------------------
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 3 minutes 43 seconds
[INFO] Finished at: Tue Dec 01 13:24:46 GMT 2015
[INFO] Final Memory: 237M/416M
[INFO] ------------------------------------------------------------------------
#3. Generate the admin portal
In a terminal, go to the root directory and launch the command: mvn clean install -P admin -DskipTests -Dfile.encoding=UTF-8
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO] ------------------------------------------------------------------------
[INFO] OpenWIS module ........................................ SUCCESS [26.004s]
[INFO] OpenWis ............................................... SUCCESS [0.402s]
[INFO] ------------------------------------------------------------------------
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 26 seconds
[INFO] Finished at: Tue Dec 01 13:25:56 GMT 2015
[INFO] Final Memory: 42M/302M
[INFO] ------------------------------------------------------------------------
#4 Getting built artifacts
- dataservice EAR: /openwis-dataservice/openwis-dataservice-server/openwis-dataservice-server-ear/target/openwis-dataservice.ear
- dataservice configs: /openwis-dataservice/openwis-dataservice-config/target/openwis-dataservice-config-files.zip
- harness client: /openwis-harness/openwis-harness-client/target/openwis-harness-client.jar
- security service: /openwis-securityservice/openwis-securityservice-war/target/openwis-securityservice.war
- user portal WAR: /openwis-metadataportal/openwis-portal/openwis-user-portal/openwis-user-portal-user.war
- admin portal WAR: /openwis-metadataportal/openwis-portal/openwis-admin-portal/openwis-admin-portal-admin.war
- SolR search WAR: /openwis-metadataportal/openwis-portal-solr/target/openwis-portal-solr.war
- staging post WAR: /openwis-stagingpost/target/stagingPost.war
- Management Service: /openwis-management/openwis-management-service/openwis-management-service-ear/target/openwis-management-service.ear
#5 Changing Version Number
In a terminal, go into the root directory and launch the command: mvn versions:set -DnewVersion=0.0.1-SNAPSHOT -P openwis or whatever version you wish to change the project to.
In some cases, you may find that OpenWIS complains about missing dependencies, should this happen try running 'mvn versions:set -DnewVersion=0.0.1-SNAPSHOT -P openwis' followed by 'mvn versions:set -DnewVersion=0.0.1-SNAPSHOT -P admin'
#6 Maven Releasing
Maven releasing for OpenWIS is two step process as the portal requires the build to be run twice (once for admin portal and once for the user portal).
In a terminal, go into the root directory and launch the command: `mvn -Dresume=false release:prepare -Popenwis release:perform -Dgoals="install"' this needs to be followed by a build of the admin portal as desribed in #3
This will not deploy to the CloudBees repo as there are currentl permissions issues
#6 Running SonarCloud
Update OpenWIS pom.xml to include the following plugin under the PluginManagement section:
<plugin>
<groupId>org.sonarsource.scanner.maven</groupId>
<artifactId>sonar-maven-plugin</artifactId>
<version>3.7.0.1746</version>
</plugin>
In a terminal, execute the analysis with the command:
mvn sonar:sonar -Popenwis,admin,user -Dsonar.organization=${SONAR_ORGANIZATION} -Dsonar.projectKey=${SONAR_PROJECT_KEY} -Dsonar.host.url=${SONAR_URL} -Dsonar.login=${SONAR_KEY}
This does take a while given the number of modules that need to run.
Please contact OpenWIS-TC team for the values needed in the command above.
#7 Running OWASP Dependency Check
In order to run the OWASP Dependency Check, the following command must be run:
mvn -Popenwis,user,admin org.owasp:dependency-check-maven:aggregate
SonarQube supports the integration of the report in the analysis results, but unfortunately SonarCloud does not support this feature.
#7 Travis-CI Integration
OpenWIS project is integrated with Travis-CI and the build history can be accesses from here.
(C) Copyright OpenWIS Association AISBL.
OpenWIS® is free software: you can redistribute it and/or modify it under the terms of the License specified for each OpenWIS® Project (see LICENSE).