Add note on copyong extended attributes

This note tries to answer to the common error of missing to copy the extended attributes to the SDcard.

1 files changed, 29 insertions, 0 deletions

diff --git a/getting-started/troubleshooting.md b/getting-started/troubleshooting.md
index 96f544d..96bdda5 100644
--- a/getting-started/troubleshooting.md
+++ b/getting-started/troubleshooting.md
@@ -1,4 +1,33 @@
 # Troubleshooting
+
+## Extended attributes MUST be copied
+
+***IMPORTANT, The extended attribute set during image construction MUST be copied to the SD card.***
+
+When using tar to create the SDcard, it is a common error to not copy the extended attributes. Find below instruction for using tar.
+
+Verify that **tar** version is 1.28 or newer:
+
+```
+tar --version
+tar (GNU tar) 1.28
+[snip]
+```
+
+If it is not the case, a native up-to-date version of tar is also generated while building AGL distribution:
+```
+tmp/sysroots/x86_64-linux/usr/bin/tar-native/tar --version
+tar (GNU tar) 1.28
+[snip]
+```
+
+To copy Automotive Grade Linux (AGL) files AND EXTENDED ATRIBUTES onto the SDcard using tar the command is:
+
+```
+tar --extract --numeric-owner --preserve-permissions --preserve-order --totals \
+           --xattrs-include='*' --directory=DESTINATION_DIRECTORY --file=agl-demo-platform.....tar.bz2
+```
+
 ## meta-rust
 Due to a known bug in the upstream of meta-rust the Yocto/OE recipe for rust-cross may fail while building RVI SOTA Client or another application written in the Rust programming language.  
 Until the complete resolution of the issue the workaround is to disable all use of the CXX11 ABI by applying the following lines to **conf/local.conf**: