summaryrefslogtreecommitdiffstats
path: root/dcae-cli/README.md
diff options
context:
space:
mode:
authorMichael Hwang <mhwang@research.att.com>2017-09-18 13:25:28 -0400
committerMichael Hwang <mhwang@research.att.com>2017-09-19 09:42:33 -0400
commit249fa95e2bea21f840f3ee5c8311a0bfe13a1b3c (patch)
treea6f48400fe4bb7ecfc314639f24e355e97872aef /dcae-cli/README.md
parent4188380fb7b806640103f557afec344455787a34 (diff)
Make dcae-cli more tolerant aka configurable
* Seeding configuration is no longer a fatal issue * Setup database connection * Seeding profiles is no longer a fatal issue Change-Id: Ica2150a1ca52bb422e4bf6d1213c6eacfb0ba128 Issue-Id: DCAEGEN2-110 Signed-off-by: Michael Hwang <mhwang@research.att.com>
Diffstat (limited to 'dcae-cli/README.md')
-rw-r--r--dcae-cli/README.md16
1 files changed, 14 insertions, 2 deletions
diff --git a/dcae-cli/README.md b/dcae-cli/README.md
index bcbc065..2806f5e 100644
--- a/dcae-cli/README.md
+++ b/dcae-cli/README.md
@@ -1,7 +1,19 @@
# dcae-cli
-The DCAE on-boarding Python command-line tool that provides functionality to manage data formats and components.
+The `dcae-cli` is a Python command-line tool used to manage and to test components and their data formats in onboarding.
## Documentation
-Please review the [DCAE platform documentation](ONAP URL TBD) which has a [`dcae-cli` walkthrough](ONAP URL TBD).
+Please review the [DCAE platform documentation](ONAP URL TBD) which has a detailed [`dcae-cli` walkthrough](ONAP URL TBD).
+
+## Local use
+
+The dcae-cli requires access to an onboarding catalog which is a postgres database. If there is no shared instance for your team or organization, then a workaround is to run a local instance of postgres on your machine. One quick way is to run a postgres Docker container:
+
+```
+docker run -e POSTGRES_PASSWORD=<your password> -e PGDATA=/var/lib/postgresql/data/pgdata -v <local directory>:/var/lib/postgresql/data/pgdata -p 5432:5432 -d postgres:9.5.2
+```
+
+Use your favorite sql client to log into this local instance and create a database named `dcae_onboarding_db`.
+
+Now that your onboarding catalog is setup, run `dcae_cli --reinit` and walkthrough the prompts to configure your dcae-cli to point to this local instance.