Skip to content
the global video & audio index
Java HTML JavaScript CSS Dockerfile Python
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
data added search controller and reconfigured Mar 16, 2011
scripts/knowledgemotion
src
.gitignore
Dockerfile add equiv to barb channels (#1350) Jun 25, 2018
LICENSE
NOTICE merging with kv-store branch Apr 27, 2010
README.md README.md: include kafka for local setup Apr 27, 2016
alias_mapping.js Remove errant parenthesis to allow parsing by MongoDB Oct 25, 2013
full_alias_migration.js intial version of namespace/value aliases, with no simple model and m… Jan 25, 2013
install.sh download javadocs and sources in install.sh Nov 19, 2011
log4j.properties olog4j file Nov 23, 2016
pom.xml Avoid cursor timeout (#1402) Jun 13, 2019
pull.sh added skipTests to pull.sh Dec 22, 2010
updateLovefilmLastUpdatedTime.js
youViewChannelUpdate.js Removed static channel map, as appropriate channel aliases and availa… Dec 17, 2012

README.md

Build and Run Atlas

The Atlas source-code is hosted at github.com/atlasapi and is split across 5 projects:

Additionally, github.com/atlasapi/atlas-client hosts the Java client library. github.com/atlasapi/atlas is the main entry point and you don't need the others unless you're interested in updating them too.

MongoDB

Atlas, and specifically atlas-persistence, uses MongoDB to store its indexed content. Atlas doesn't come packaged with MongoDB so you'll need to make sure it's installed - Download MongoDB.

During test runs, Atlas will run integration tests against a mongo running on port 8585. If one isn't running then it'll try and start one, assuming that mongod is available on its path, so either keep one running or make sure you've added mongo/bin to your path.

The running Atlas instance requires that MongoDB be running on its standard port:27107 and ZooKeeper/Kafka: running locally. Please make sure you've kicked them off.

Maven

Atlas uses Maven for all it's dependency and build management, so you'd better have mvn available on your path! We've included the MetaBroadcast public repo which houses all the dependencies that haven't been mavenised, and all our successful builds deploy to it so it has the latest atlas SNAPSHOTs available. This means you don't have to build the other atlas projects, if you don't want to.

It's worth noting that we don't current have a formal release process and everything's currently a SNAPSHOT release. We're sorry if this is a pain and we have every intention of creating some proper releases soon, when life has calmed down a bit.

Building and Running

So, to get everything built and ready:

mkdir /data                                      # Required for feed processing
git clone http://github.com/atlasapi/atlas.git
cd atlas
mvn clean install

This will download all the dependencies, compile the code and run the tests (make sure mongo's setup). To actually run the project locally:

mvn jetty:run -Dprocessing.config=true -Dupdaters.bbc.enabled=true -Djetty.port=8282 # Atlas processing
mvn jetty:run -Dprocessing.config=false                                              # Atlas front-end

This will startup Atlas locally using the lovely Jetty.

Go to

http://localhost:8282/system/scheduler

and run "BBC Ion schedule update (today only)" to ingest the BBC schedule for today. When that completes, run "BBC Mongo Schedule repopulator" to generate the schedule.

Then go to

http://localhost:8080/3.0/schedule.json?from=now.minus.3h&to=now.plus.10h&channel=bbcone&publisher=bbc.co.uk 

for some of today's BBC One schedule. You may need to modify the 'from' and 'to' parameters, depending on the time of day.

Enjoy!

Contributions

We welcome contributions to Atlas! If you'd like to get your hands dirty, please fork the repositories and submit pull requests with your changes.

You can’t perform that action at this time.