Add policy basic auth onap beijing
[cli.git] / README.md
index 737cd04..cffd134 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,15 +1,58 @@
-Onap Command-line interface (CLI).
+Open Command-line interface Platform (OCLIP)
+============================================
 
-One Command to command whole Onap !! It provides the unified commands
-to access and operate Onap functionalities. To use this CLI, please
-configure the following environment variables:
+Provides unified commands to operate any cloud enabled software
+products from Linux/Web console.
 
-1. ONAP_MSB_URL - Onap Micro service bus(MSB) URL
-2. ONAP_USERNAME - Onap user name
-3. ONAP_PASSWORD - Onap user password
+Set the following environment variable, before using OCLIP:
 
-To know the CLI version, type onap [-v|--version]
-To know the CLI usage, type onap [-h|--help]
-To know the usage of sub commands, type onap <command> [-h|--help]
+**OPEN_CLI_HOME** - Complete path of directory, where OCLIP is installed.
 
-To know more, please refer the Onap wiki https://wiki.onap.org
\ No newline at end of file
+To Run a command
+-----------------
+Configure the following environment variables:
+
+1. **OPEN_CLI_HOST_URL** - Catalog service URL or a service URL
+2. **OPEN_CLI_HOST_USERNAME** - Service user name
+3. **OPEN_CLI_HOST_PASSWORD** - Service password
+
+Run **oclip <command>** from Linux console.
+
+To Run in Interactive mode
+--------------------------
+Run **oclip** from Linux console.
+
+And use the directive set to set the values for following parameters:
+
+1. **host-url** - Catalog service URL or a service URL
+2. **host-username** - Service user name
+3. **host-password** - Service password
+
+NOTE: This mode is available as Web command console when OCLIP is running from docker.
+
+Select the product version
+--------------------------
+CLI framework is enhanced to handle multiple product versions at same
+time. so to choose the product version, set evironment variable
+**OPEN_CLI_PROUDCT_IN_USE**.
+
+NOTE: In interactive mode, product version can be selected using
+typing **use <product-version>**
+
+Run *oclip [-v|--version]* to see the available product version details.
+
+Set the parameter values
+------------------------
+Use the directive 'set' for setting the values for parameters and 'unset' for un-seting the values.
+
+Help
+----
+*oclip [-h|--help]*
+*oclip <command> [-h|--help]*
+
+Debug Mode
+----------
+To run in debug mode, set following environment variables:
+
+1. OPEN_CLI_DEBUG - By default its false, otherwise Set to true
+2. OPEN_CLI_DEBUG_PORT - By default it is 5005, otherwise set to new TCP port number