TNExT

The Transit Network Explorer Tool (TNExT) is a web-based software tool developed for the visualization, analysis, and reporting of regional and statewide transit networks in the state of Oregon.

The TNExT software tool has been developed using open source tools.

Running using Docker

This repository is provides a set of Docker containers to compile and run TNExT, together with a PostGIS database. This is the simplest approach to running TNExT locally, since you will not have to install all project dependencies.

1. Install Docker for Mac, Docker for Windows, or Docker CE for your Linux distribution.
2. Clone a local copy of this repository: git clone https://github.com/ODOT-PTS/TNExT.git
3. Start a Docker Compose right: docker-compose up

Creating a new installation from a database snapshot

1. docker-compose build to prepare images
2. Add a database snapshot to the ./data directory, which will be mounted as /data inside the tnext container.
3. Create the database, e.g. may2018: docker-compose run tnext createdb may2018
4. Import the database: docker-compose run tnext pg_restore -v -Fc -d may2018 /data/may2018.backup
5. Create a config file listing this database, as ./conf/admin/resources/dbInfo.csv, adjusting parameters as necessary:

databaseIndex,dbnames,spatialConfigPaths,ConfigPaths,connectionURL,username,password,censusMappingSource,gtfsMappingSource1,gtfsMappingSource2,defaultDate
0,May 2018,,,jdbc:postgresql://db:5432/may2018,postgres,postgres,,,,20180428

6. Start normally: docker-compose up and access at http://localhost:8080

Running using local system dependencies

The following software packages must be installed on a computer to be able to host an instance of TNExT:

1. Java Development Kit 1.8.
2. PostgreSQL 9.4. The TNExT utilizes the PostgreSQL database management system to store data and to run both standard and spatial queries. The current version of the TNExT is set to run on PostgreSQL 9.4.
3. PostGIS extension to PostgreSQL to enable spatial analysis.
4. Database dumps. Database dumps can be found here. Note that database dumps have to be restored with the same name. In other words, winter16.backup should be restored to a postgreql database named winter16.
5. Java IDE. For development purposes, any Java IDE can be used to clone the source code available at the GitHub repository. Otherwise, the source code can be downloaded directly from GitHub.
6. Maven Apache Project. Maven is used to run the TNExT on a Tomcat7 web server.
7. Tomcat Config The war file should be installed as ROOT.war on the Tomcat7 server, it will be installed to '/' on the server.

Testing

See the integration test readme.