aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSebastien Douheret <sebastien.douheret@iot.bzh>2017-10-16 22:35:26 +0200
committerSebastien Douheret <sebastien.douheret@iot.bzh>2017-10-16 22:39:03 +0200
commit92b5cf7ed66c1dbec7a5d0c5f1ef5f0c35a0e5dc (patch)
tree10cc1a976008452ba053f4fa4e247b730c467bba
parent938da5a671f370c7a07b884df66d2c8a83b167d2 (diff)
Update xds-server doc
Signed-off-by: Sebastien Douheret <sebastien.douheret@iot.bzh>
-rw-r--r--docs/part-1/2_install-xds-server.md19
-rw-r--r--docs/part-1/3_install-sdks.md9
2 files changed, 19 insertions, 9 deletions
diff --git a/docs/part-1/2_install-xds-server.md b/docs/part-1/2_install-xds-server.md
index a84da95..7a8ff23 100644
--- a/docs/part-1/2_install-xds-server.md
+++ b/docs/part-1/2_install-xds-server.md
@@ -2,7 +2,7 @@
Depending of your configuration, this step is necessary or not.
-IOW **you are a developer and plan to use/connect to an existing `xds-server`**
+In other words **you are a developer and plan to use/connect to an existing `xds-server`**
running on your local network (On-Premise config) or in the Cloud (SaaS config),
**you don't need to install the server part and you can skip this step**.
@@ -70,6 +70,9 @@ interface, what we call the "Dashboard", using a web browser :
seb@laptop ~$ xdg-open http://localhost:8000
```
+`xds-server` is now up and running, you can now install AGL SDKs, please refer
+to chapter named "Installing AGL SDKs"
+
### Container settings
This container (ID=0) exposes following ports:
@@ -97,9 +100,9 @@ _coming soon ..._
## <a name="native"></a> Native installation
-<!-- note -->
-Only Linux host OS is supported and tested for native installation !
-<!-- endnote -->
+You can chose to install xds-server 'natively' instead of within a docker
+container but only Linux host OSes are supported and tested for native
+installation !
### Install packages for debian distro type
@@ -184,16 +187,16 @@ All fields are optional and example below corresponds to the default values:
```bash
# Status XDS server:
-seb@laptop ~$ sudo systemctl status xds-server.service
+seb@laptop ~$ systemctl --user status xds-server.service
# Stop XDS server
-seb@laptop ~$ sudo systemctl stop xds-server.service
+seb@laptop ~$ systemctl --user stop xds-server.service
# Start XDS server
-seb@laptop ~$ sudo systemctl start xds-server.service
+seb@laptop ~$ systemctl --user start xds-server.service
# Get XDS server logs
-seb@laptop ~$ sudo journalctl --unit=xds-server.service --output=cat
+seb@laptop ~$ systemctl --user --unit=xds-server.service --output=cat
```
To check if xds-server is correctly install and running, you can access the web
diff --git a/docs/part-1/3_install-sdks.md b/docs/part-1/3_install-sdks.md
index 3b85573..6a747ac 100644
--- a/docs/part-1/3_install-sdks.md
+++ b/docs/part-1/3_install-sdks.md
@@ -13,7 +13,7 @@ a pre-packaged AGL SDK.
`sdkRootDir` setting (see `xds-server` configuration chapter for more details).
For now, you can only install SDK using a bash script but in a near future you
-will be able to do that using XDS Dashboard.
+will be able to manage SDKs using XDS Dashboard.
So to install a SDK, use provided `install-agl-sdks` script:
@@ -23,6 +23,13 @@ seb@laptop ~$ ssh -p 2222 devel@localhost
# For example, Install ARM64 SDK (automatic download)
devel@docker ~$ sudo /opt/AGL/xds/server/xds-utils/install-agl-sdks.sh --arch aarch64
+```
+
+You may also want to install an SDK that you built manually (see [Part 1 - SDK-compilation-installation](http://docs.automotivelinux.org/docs/devguides/en/dev/reference/sdk-devkit/docs/part-1/1_7-SDK-compilation-installation.html))
+
+```bash
+# Optional - Log into the container (only necessary when xds-server is running within a docker container)
+seb@laptop ~$ ssh -p 2222 devel@localhost
# Install Intel corei7-64 SDK (using an SDK tarball that has been built or downloaded manually)
devel@docker ~$ sudo /opt/AGL/xds/server/xds-utils/install-agl-sdks.sh --arch corei7-64 --file /tmp/poky-agl-glibc-x86_64-agl-demo-platform-crosssdk-corei7-64-toolchain-