PROCESS.md

Setup Process

This documents the steps taken to setup the project at http://openfda.nucivic.build.

They do not represent what is needed to get the project running locally.

1. Create a GitHub Repository: https://github.com/NuCivic/data-openFDA
2. Add the DKAN Starter repository located at https://github.com/nucivic/data_starter as a remote and pull the master branch into the repo.
3. Create a ubuntu 14 server on softlayer named "devshop.opendata.nucivic.build"
4. Login as root.
5. Run the devshop install script.
6. Click link to login to devshop.
7. Go to Admin > Hosting > Devshop > GitHub.
8. Visit https://github.com/settings/tokens. Create a token and copy it.
9. Return to devshop to enter your token and hit "Save Configuration".
10. Click "Create your first Project".
11. Call it "dkan", add this repo as the git url.
12. Click "show ssh key" to access the server's public key. add it to your github account so the server can clone the repo.
13. Click "Next".
14. Select "Immediate "Deployment" for "Deploy Code Method", Check "Create Environments for Pull Requests", "Delete Pull Request Environments", and "Clone the live environment". Enter "openfda.nucivic.build" as the "Live Domain", and check "For new environments, create subdomains under Live Domain.". Fill in "docroot" for "Path to Drupal", then click "Next".
15. Create a "live" environment, set to master branch.
16. Click "Next" and wait for your code to clone.
17. Select DKAN as the install profile.
18. Click "Finish" to complete project setup.
19. Click "Setup Webhook". Copy webhook URL and click "Add a Webhook at GitHub.com."
20. Paste the project's webhook URL into "Payload URL". Content type should be "application/json", Secret can be empty. Select "Let me select individual events" and select "Pull Request", "Push", and "Create". Click "Add webhook".
21. Go back to devshop, reload the project dashboard and note the "last commit" should now read "x seconds ago".
22. Click Settings > project settings. Select "live" for "live environment". Hit Save.
23. Click "Log In" on the live environment to access the DKan site.
24. Add "Open Data Federal Agency Extras module" to the git repo and push, then visit Admin > Modules and enable it.
25. Add "Visualization Entity" and Visualization Entity Charts" to the repo. (https://github.com/NuCivic/visualization_entity and https://github.com/NuCivic/visualization_entity_charts)
26. Add "geo_file_entity" module: https://github.com/NuCivic/geo_file_entity
27. Populate the site with data.

DKAN Setup

1. Create user accounts for anyone who needs access to the dkan site.
2. Turn off registration for anonymous users:
3. Visit "Configuration" > "People" > "Account Settings".
4. Select "Administrators only" for "Who can register accounts".
5. Add a new logo:
6. Visit "Appearance" > "Settings".
7. Uncheck "Use the default logo".
8. Click "Choose File" and select your desired logo.

@TODO: Complete description of what was done to the DKAN site. 4. Click "Save configuration".