diff options
-rw-r--r-- | README.md | 41 | ||||
-rw-r--r-- | README.org | 39 |
2 files changed, 41 insertions, 39 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..fdad92a --- /dev/null +++ b/README.md @@ -0,0 +1,41 @@ +[![dump-genenetwork-database-tests CI +badge](https://ci.genenetwork.org/badge/dump-genenetwork-database-tests.svg)](https://ci.genenetwork.org/jobs/dump-genenetwork-database-tests) +[![dump-genenetwork-database CI +badge](https://ci.genenetwork.org/badge/dump-genenetwork-database.svg)](https://ci.genenetwork.org/jobs/dump-genenetwork-database) + +The GeneNetwork database is being migrated from a relational database to +a plain text and RDF database. This repository contains code to dump the +relational database to plain text. + +# Using + +Drop into a development environment with + +``` shell +$ guix shell +``` + +Describe the database connection parameters in a file *conn.scm* file as +shown below. Take care to replace the placeholders within angle brackets +with the appropriate values. + +``` scheme +((username . "<username-here>") + (password . "<password-here>") + (database . "<database-name-here>") + (host . "<hostname-here>") + (port . <port-here>)) +``` + +Then, to dump the database to \~/data/dump, run + +``` shell +$ ./pre-inst-env ./dump.scm conn.scm ~/data/dump +``` + +Make sure there is enough free space! It\'s best to dump the database on +penguin2 where disk space and bandwidth are not significant constraints. + +# Contributing + +See bugs and tasks in BUGS.org. diff --git a/README.org b/README.org deleted file mode 100644 index f5b0f4f..0000000 --- a/README.org +++ /dev/null @@ -1,39 +0,0 @@ -[[https://ci.genenetwork.org/jobs/dump-genenetwork-database-tests][https://ci.genenetwork.org/badge/dump-genenetwork-database-tests.svg]] [[https://ci.genenetwork.org/jobs/dump-genenetwork-database][https://ci.genenetwork.org/badge/dump-genenetwork-database.svg]] - -The GeneNetwork database is being migrated from a relational database -to a plain text and RDF database. This repository contains code to -dump the relational database to plain text. - -* Using - -Drop into a development environment with - -#+BEGIN_SRC shell - $ guix shell -#+END_SRC - -Describe the database connection parameters in a file /conn.scm/ file -as shown below. Take care to replace the placeholders within angle -brackets with the appropriate values. - -#+BEGIN_SRC scheme - ((username . "<username-here>") - (password . "<password-here>") - (database . "<database-name-here>") - (host . "<hostname-here>") - (port . <port-here>)) -#+END_SRC - -Then, to dump the database to ~/data/dump, run - -#+BEGIN_SRC shell - $ ./pre-inst-env ./dump.scm conn.scm ~/data/dump -#+END_SRC - -Make sure there is enough free space! It's best to dump the database -on penguin2 where disk space and bandwidth are not significant -constraints. - -* Contributing - -See bugs and tasks in BUGS.org. |