Updating docs
Change-Id: I401b0a2aed56906601d25c693b6ef766b69d4269
diff --git a/SUMMARY.md b/SUMMARY.md
index 2950f39..c42479d 100644
--- a/SUMMARY.md
+++ b/SUMMARY.md
@@ -30,8 +30,11 @@
* [Base OpenStack](charts/base-openstack.md)
* [VTN Setup](prereqs/vtn-setup.md)
* [M-CORD](charts/mcord.md)
+ * [XOSSH](charts/xossh.md)
* [Operations Guide](operating_cord/operating_cord.md)
* [General Info](operating_cord/general.md)
+ * [GUI](operating_cord/gui.md)
+ * [Configuring the Service Graph](xos-gui/developer/service_graph.md)
* [REST API](operating_cord/rest_apis.md)
* [TOSCA](xos-tosca/README.md)
* [XOSSH](xos/dev/xossh.md)
@@ -68,7 +71,6 @@
* [SimpleExampleService](simpleexampleservice/simple-example-service.md)
* [GUI Development](xos-gui/developer/README.md)
* [Quickstart](xos-gui/developer/quickstart.md)
- * [Service Graph](xos-gui/developer/service_graph.md)
* [GUI Extensions](xos-gui/developer/gui_extensions.md)
* [GUI Internals](xos-gui/architecture/README.md)
* [Module Strucure](xos-gui/architecture/gui-modules.md)
diff --git a/charts/voltha.md b/charts/voltha.md
index 6ddabc0..539be82 100644
--- a/charts/voltha.md
+++ b/charts/voltha.md
@@ -4,13 +4,12 @@
Add the kubernetes helm charts incubator repository
```shell
-cd voltha
helm repo add incubator https://kubernetes-charts-incubator.storage.googleapis.com/
```
Build dependencies
```shell
-helm dep build
+helm dep build voltha
```
There's an etcd-operator **known bug** we're trying to solve that
diff --git a/charts/xos-core.md b/charts/xos-core.md
index 50c7b1f..b0ecc55 100644
--- a/charts/xos-core.md
+++ b/charts/xos-core.md
@@ -5,6 +5,15 @@
helm install -n xos-core xos-core
```
+> We highly suggest to override the default values of
+> `xosAdminUser` and `xosAdminPassword` with custom values
+
+You can do it using a [`values.yaml`](https://docs.helm.sh/chart_template_guide/#values-files) file or using this command:
+
+```shell
+helm install -n xos-core xos-core --set xosAdminUser=MyUser --set xosAdminPassword=MySuperSecurePassword
+```
+
## Deploy kafka
Some flavors of XOS require kafka, to install it please
diff --git a/charts/xossh.md b/charts/xossh.md
new file mode 100644
index 0000000..5a31d74
--- /dev/null
+++ b/charts/xossh.md
@@ -0,0 +1,5 @@
+# Deploy XOSSH
+
+```shell
+helm install xos-tools/xossh -n xossh
+```
diff --git a/operating_cord/gui.md b/operating_cord/gui.md
new file mode 100644
index 0000000..48985ad
--- /dev/null
+++ b/operating_cord/gui.md
@@ -0,0 +1,36 @@
+# GUI
+
+The GUI is very useful for development and demos. At the moment it's not
+designed to support the amount of datas that we expect to have in production-like
+deployment.
+
+## How to acces the GUI
+
+Once you have CORD up and running you can find the port on which the GUI is
+exposed by running:
+
+```shell
+kubectl get service xos-gui
+
+
+NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
+xos-gui NodePort 10.102.239.199 <none> 4000:30001/TCP 2h
+```
+
+> By default the GUI is exposed on port `30001`
+
+To connect to the GUI you can just open a browser at `<cluster-ip>:<gui-port`,
+where `cluster-ip` is the ip of any node in your kubernetes cluster.
+
+> Username and password for the GUI are defined in the [`xos-core`](../charts/xos-core.md) helm chart.
+
+### Opening the GUI in minikube
+
+The above workflow will work just the same way when running on `minikube`, but
+this helper is also available:
+
+```shell
+minikube service xos-gui
+```
+
+> This command will open the GUI in you default browser
\ No newline at end of file