{{AppliesToNaon}}{{Applies_To_DVDKAppliesToNaonFamily}}

= Installation Steps Updating git repositories =

{{ImportantMessage|text=The update package consists in a compressed archive (nelk-xStarting with NELK 4.y0.x.tar.bz2). It can be downloaded from [http0, the following source trees are clones of '''DAVE Embedded Systems''' public git repositories://www.dave.eu/dave-cpu-module-am387x-dm814x-naon.html#developmentkits DAVE website] or it can be found on the NELK distribution (SD card or USB pen drive)}}

 {| class="wikitable" |-!| Component!GIT Remote!NELK Installation Directory|-|EZSDK *|git@git.dave.eu:dave/naon/sdk-x.xx.xx.xx.git|/home/shared/devel/dave/naon-DAA/sw/linux/sdk/sdk-x.xx.xx.xx|-|Linux|git@git.dave.eu:dave/naon/linux-omap3.git|/home/shared/devel/dave/naon-DAA/sw/linux/sdk/sdk-x.xx.xx.xx/board-support/linux-omap3.git|-|U-Boot|git@git.dave.eu:dave/naon/u-boot-omap3-arago.git|/home/shared/devel/dave/naon-DAA/sw/linux/sdk/sdk-x.xx.xx.xx/board-support/u-boot-omap3-arago.git|-|GStreamer|git@git.dave.eu:dave/naon/gstreamer_ti.git|/home/shared/devel/dave/naon-DAA/sw/linux/sdk/sdk-x.xx.xx.xx/component-sources/gstreamer_ti|} This means that these components can be kept in sync and up to date with '''DAVE Embedded Systems''' repositories. * N.B. '''sdk-x.xx.xx.xx''' is just a placeholder that must be replaced with the actual sdk version (eg: sdk-5.05.02.00). == RSA key generation == Please follow the procedure reported below to generate the RSA ssh key: * select your username (ad es. username@myhost.com)* start the DVDK and login into the virtual machine* start a shell session* enter the .ssh subdirectory into your home directory: <code>cd ~/.ssh/</code>* launch the following command: <br><pre>ssh-keygen -t rsa -C "username@myhost.com" -f username@myhost.com</pre>* this command creates the files <code>~/.ssh/username@myhost.com</code> ('''private key''') and <code>~/.ssh/username@myhost.com.pub</code> ('''public key''')* edit your <code>~/.ssh/config</code> adding the following lines: <pre>Host git.dave.eu User git Hostname git.dave.eu PreferredAuthentications publickey IdentityFile ~/.ssh/username@myhost.com</pre> Please send the public key file to one of the following email support addresses (depending on which SOM is included in your kit version) * [mailto:support-naon@dave.eu support-naon@dave.eu]* [mailto:support-maya@dave.eu support-maya@dave.eu]* [mailto:support-dido@dave.eu support-dido@dave.eu] with the request for the creation of a new public git account associated to your username. The support team will enable the account and send you a confirmation as soon as possible. == Synchronizing the repository == When the account is enabled, you can synchronize a source tree entering the repository directory and launching the <code>git fetch</code> command, like in the following example: <pre class="workstation-terminal">nelk@nelk-desktop:~$ cd /home/shared/devel/dave/naon-DAA/sw/linux/sdk/sdk-5.05.02.00/board-support/linux-omap3.git/nelk@nelk-desktop:/home/shared/devel/dave/naon-DAA/sw/linux/sdk/sdk-5.05.02.00/board-support/linux-omap3.git$ git fetch origin</pre> Please note that <code>git fetch</code> doesn't merge the commits on the current branch. To do that, you should run  <pre class="workstation-terminal">nelk@nelk-desktop:/home/shared/devel/dave/naon-DAA/sw/linux/sdk/sdk-5.05.02.00/board-support/linux-omap3.git$ git merge origin/naon</pre> or replace the ''fetch-merge'' process with a single <code>git pull</code> command. Please note that the recommended method is the ''fetch-merge'' process. For further information on Git, please refer to [http://git-scm.com/documentation Git Documentation]. = Installing the upgrade package = {{ImportantMessage|text=The update package consists in a compressed archive (nelk-x.y.x.tar.bz2). Please send your request to the email support address}} # Start the DVDK virtual machine* # '''Take a snapshot of the current VM state'''. This creates a sort of "backup" which on your host machine that can be used to restore the previous installation. We '''recommend''' to take the snapshot because to do the update you need to remove the previous SDK (unless you have extended the disk space - see [[VirtualBox Extending Disk Size]])<br><br>[[File: Vm-take-snapshot.png|600px]]<br><br>* # Fetch the nelk-x.y.x.tar.bz2 file. You have several options, including the following options:#** download downloading it from inside the virtual machine (with a browser or file downloader);#** share sharing the file from a shared folder on the host machine using the "Shared Folder" feature (you need to have the Virtual Guest extension installed, see [[VirtualBox Shared folders]]);#** share sharing the file from a shared folder on the local network (you need to have a working network configuration, see [[VirtualBox Network Configuration]];* # Open a terminal emulator* # Enter the '''sdk''' directory: <code>cd /home/shared/devel/dave/naon-DAA/sw/linux/sdk</code>* # Remove the symbolic link to the root file system: <code>rm rfs/nelk</code># Check the available disk space: <code>df -m</code>#* Unless if you have enough space more than 3 GB available on (check the <code>/dev/sda1</code> line), you can proceed to the next step without removing the VM disk (previous sdk version#* if you should have extended it following less than 3 GB available, you can follow the [[VirtualBox Extending Disk Size]] guide)to free some space and continue the procedure to the next step; otherwise, you must remove the previous sdk directory: <code>rm -fr sdk-x.xx.xx.xx</code>* # Un-compress the archive: <code>sudo tar xvjf <path-to-update-archive>nelk-x.y.z.tar.bz2</code>. Include in the command the actual path to the nelk-x.y.x.tar.bz2 archive according on how you fetched it