improve readme

README.md

@@ -6,10 +6,34 @@ It is best for complex mapping development. It can also be used for regression t
 
 ## Installation & Usage
 
-* Install Java 11
-* Download `pizug-test.jar` file
-* Prepare test cases & `pizug-test.yaml` configuration file
-* Run tests with `java -jar pizug-test.jar` in the folder
+* Obtain Java 11
+  * You can download OpenJDK zip from [Red Hat here](https://developers.redhat.com/products/openjdk/download), For example: `jre-11.0.8-x64 ZIP | JRE 11 Windows 64-bit` (47MB)
+* Download `pizug-cpi-mapping-test.jar` file from [the latest release](https://github.com/pizug/cpi-mapping-test/releases/latest)
+* Prepare test cases & `pizug-test.yaml` test suite configuration file
+* Run test suite with `C:\path\to\java -jar C:\path\to\pizug-cpi-mapping-test.jar` in the folder
+
+## Passwords
+You can't write passwords to configuration file. This is to prevent committing passwords if you are using Git or sharing your test suite with eg. FTP, OneDrive/SharePoint, Dropbox.
+
+You can run the tool with option `--password` and it will ask for your password without showing it in the terminal.
+
+You can define an environment variable name. For a test suit config containing:
+`password_environment_variable: "CPI_PASSWORD"` , you can set the environment variable for the terminal session as below and run the tool multiple times without requiring passwords. You can also use this method for CI/CD pipelines.
+
+The tool will look for both passwords and pick environment variable over console provided password. If you haven't defined any, it will give error. If your password is incorrect processing will be stopped after first call to prevent locking S-user password. (After 5 consecutive failed attempts S-user password gets locked for 1 hour)
+
+### Setting environment variable
+For Windows Powershell:
+
+`$env:CPI_PASSWORD="yourpass"`
+
+For Windows cmd.exe:
+
+`set CPI_PASSWORD=yourpass`
+
+For Linux:
+
+`export CPI_PASSWORD=yourpass`
 
 ## Example
 You can find the example test suite in `example-test-data` folder.