Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
doc:docker:add-dataset [2014/10/14 15:49] – [Adding a query library] admin | doc:docker:add-dataset [2014/11/17 15:35] – [Adding a dataset to data.open-ease.org] admin | ||
---|---|---|---|
Line 57: | Line 57: | ||
==== Adding a query library ==== | ==== Adding a query library ==== | ||
- | The entries in the query library, that is commonly in the lower left corner of the interface, are generated from a JSON file of the following format. Each entry in the ' | + | The entries in the query library, that is commonly in the lower left corner of the interface, are generated from a JSON file of the following format. Each entry in the ' |
<code javascript> | <code javascript> | ||
Line 78: | Line 78: | ||
== Required actions: == | == Required actions: == | ||
Add your query library to the [[https:// | Add your query library to the [[https:// | ||
- | |||
- | |||
Line 85: | Line 83: | ||
==== Rebuilding the containers ==== | ==== Rebuilding the containers ==== | ||
- | Depending on which components you have added to your data set, you will need to re-create some of the containers the openEASE system is composed of. To do so, you will need a checkout of the [[https:// | + | The previous steps have added the different components of your data set (OWL log files, Prolog code, MongoDB dumps) to the right places in the system. To include this information into the docker containers, you will need to re-create some of the containers the openEASE system is composed of. Which containers have to be re-built depends on which components you have added to your data set. |
+ | |||
+ | For re-building them, you will need a checkout of the [[https:// | ||
<code bash> | <code bash> | ||
Line 96: | Line 96: | ||
# build is finished. Check the build details tab here: | # build is finished. Check the build details tab here: | ||
# https:// | # https:// | ||
- | docker pull knowrob/ | + | docker pull knowrob/ |
+ | docker rm knowrob_data | ||
+ | docker run --name knowrob_data knowrob/ | ||
| | ||
# if you have added your own query library: | # if you have added your own query library: | ||
Line 105: | Line 107: | ||
==== Accessing your new experiment ==== | ==== Accessing your new experiment ==== | ||
+ | After rebuilding the containers, you can start the system locally and see if you can access your data. The // | ||
+ | ~/ | ||
- | http://data.open-ease.org/ | + | You should now be able to login to the system at http://localhost and then open http:// |
+ | |||
+ | |||
+ | |||
+ | |||
+ | ==== Debugging the containerized setup ==== | ||
+ | |||
+ | If you have tested your code with a ' | ||
+ | |||
+ | * The terminal in which you executed the ' | ||
+ | * To inspect the output of the KnowRob container, you can use the [[https:// | ||
+ | * If you make changes to the query library and it is not reloaded, this may be related to the browser cache. Try opening that file directly (e.g. http:// | ||
+ | |||
+ | |||
+ | ==== Deploying your code to the server ==== | ||
+ | |||
+ | When verything works fine on your computer, you are ready to deploy the containers to the server at data.open-ease.org. | ||
+ | |||
+ | Please be careful with updates of the server -- only deploy well-tested code and refrain from deleting other people' | ||
+ | |||
+ | The following steps need to be performed after logging into the server: | ||
+ | - Import your data into the MongoDB on the server as described above. You will need to copy your-tf.json to the server and run the mongoimport program from there. | ||
+ | - Rebuild the containers you have changed as you have done it on your local computer (see description above) | ||
+ | - The startup script is running in a [[http:// | ||
+ | <code bash> | ||
+ | # connect to the server | ||
+ | ssh data.open-ease.org | ||
+ | |||
+ | # resume the screen session | ||
+ | screen -r | ||
+ | |||
+ | # stop the script with CRTL+C | ||
+ | |||
+ | # start the script again | ||
+ | ./ | ||
+ | |||
+ | # detach the screen session using CTRL+A+D | ||
+ | </ |