{{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, and you need this . 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