How to Install Docker
Follow the instruction here: https://docs.docker.com/get-docker/
Acquire/Configure Credentials
- Contact SMILE development team to acquire current SMILE credentials Chen Wang
- Alternatively, you can set up your own set of credentials by configuring the below shell script.
# system setting export DOCKERIZED=true # if use AWS algorithm, then you must use a static IP address export LOCAL_ALGORITHM=true export HOST_IP=<your host IP address> export HOME=<your path on host machine> export BUCKET_NAME=macroscope-smile # create mounted volumes on host machine mkdir -p ${HOME}/smile_data mkdir -p ${HOME}/smile_data/${BUCKET_NAME} mkdir -p ${HOME}/smile_user mkdir -p ${HOME}/smile_tag # align with AWS export AWS_ACCESSKEY= export AWS_ACCESSKEYSECRET= export EMAIL_PASSWORD= # social media platforms export REDDIT_CLIENT_ID= export REDDIT_CLIENT_SECRET= export TWITTER_CONSUMER_KEY= export TWITTER_CONSUMER_SECRET= # export export BOX_CLIENT_ID= export BOX_CLIENT_SECRET= export DROPBOX_CLIENT_ID= export DROPBOX_CLIENT_SECRET= export GOOGLE_CLIENT_ID= export GOOGLE_CLIENT_SECRET= # start docker-compose -f docker-compose-smile.yml up # stop # docker-compose -f docker-compose-smile.yml down -v
Note:
- You need to place your host IP address to HOST_IP variable.
- The HOME variable will be the location to hold persistent data, such as user information, social media and analytics output, tags and etc.
How to run
All images have been pushed to Docker Hub. All you need is the YAML configuration file to run.
Download compose yaml file here: docker-compose-smile.yml
To Start
docker-compose -f docker-compose-smile.yml up
To Stop
docker-compose -f docker-compose-smile.yml down -v
Appendix:
SMILE and BAE images on Docker Hub
https://hub.docker.com/orgs/socialmediamacroscope/repositories
Architectures
Docker vs Hubzero Tool mode
export DOCKERIZED=true → Dockerized version
export DOCKERIZED=false → Hubzero Tool version, can be run by command npm start