afimb / chouette

chouette is a Java program for validating and exchanging Public Transport datas. Comes with a ruby web app : https://github.com/afimb/chouette2
http://www.chouette.mobi
Other
23 stars 22 forks source link

Chouette Build StatusCoverity Scan

Chouette is a java project for handling public transport (PT) data in different formats: Neptune, NeTEx, GTFS and provides 3 main services:

The Import, Export and Validation services are provided as Web Services and performed asynchronously.

The Chouette Web Service API is specified here :

Chouette is used by :

Format documentations are available for:

The Chouette java project is split into modules :

For more information see the Architecture Documentation , in French.

Installation instructions for the command line standalone program are available here

Release Notes

The Chouette release notes (in French) can be found in CHANGELOG file

Requirements

This code has been run and tested on Travis with :

Chouette External Dependencies

Chouette V3.x requires Postgresql V9.4 or above

On Debian/Ubuntu/Kubuntu OS :

sudo apt-get install postgresql-9.4
sudo apt-get install postgresql-9.4-postgis-2.3
sudo apt-get install openjdk-7-jdk 

For installation from sources :

sudo apt-get install git
sudo add-apt-repository ppa:natecarlson/maven3
sudo apt-get update 
sudo apt-get install maven3
sudo ln -s /usr/share/maven3/bin/mvn /usr/bin/mvn

if apt-get update fails, modify file : /etc/apt/sources.list.d/natecarlson-maven3-trusty.list and replace trusty by precise

Chouette Installation

On Debian, Chouette can also be installed as a package : see debian packages

Prerequisite

Create Postgres user and databases

Installation from sources

Get git repository :

git clone -b Vx_y git://github.com/afimb/chouette
cd chouette

Test :

mvn test -DskipWildfly

Deployment :

change the data storage directory (USER_HOME by default) : copy properties file iev.properties in /etc/chouette/iev/ directory change property iev.directory value to desired directory change property iev.started.jobs.max value to limit parallel jobs processing (default = 5) change property iev.copy.by.import.max value to limit parallel single line import by import job (default = 5)

Install and configure Wildfly

For existing chouette_iev deployment : update postgres / wildfly configuration

deploy ear (wildfly must be running)

mvn -DskipTests install

Installation from the binaries

download chouette_iev.x.y.z.zip from maven repository

change the data storage directory (USER_HOME by default) copy the properties file iev.properties into /etc/chouette/iev/ directory change the iev.directory value to the desired directory change the iev.started.jobs.max value in order to limit the max number of parallel jobs (default = 5)

Install and configure Wildfly

. For an existing chouette_iev deployment prior to 3.2 : update the postgres / wildfly configuration

in the wildfly installation repository :

bin/jboss-cli.sh --connect --command="deploy (path to ...)/chouette.ear"

Chouette command installation and usage

see chouette command examples

More Information

An exhaustive technical documentation in French is avalailable here

License

Chouette is licensed under the CeCILL-B license, a copy of which can be found in the LICENSE file.

Support

Users looking for support should file an issue on the GitHub issue tracking page, or file a pull request if you have a fix available.