Difference between revisions of "Template:Install custom linux image"

From Chordata documentation
Jump to: navigation, search
(Created page with "{{note | The information in this page describes a process that is '''not implemented yet!''' Refer to this section to le...")
(No difference)

Revision as of 08:37, 8 April 2019

The information in this page describes a process that is not implemented yet! Refer to this section to learn how to install the Chordata software

The software part of the Chordata system is composed of several programs, and most of them should be running on the SBC. The easier way to get them all, and configure them correctly, is to download our custom linux (Raspbian based) image, and flash it to the SD card. The card can then be used to boot the raspberry with a complete running Chordata environment. This process only works on Raspberry Pis, if you want to try some different SBC, look at the end of this chapter for some advanced procedures.

The process is really simple using the dedicated tool Etcher, available for windows, mac and linux. Start by downloading from their webpage, and installing it.

  • Download the Chordata linux image from our web page
  • Insert the SD card on your computer’s card reader.
  • On Etcher select the downloaded file, select your SD card as a destination disk and hit Flash!

Wait until the Flash process is finished (it might take a couple of minutes), follow the instructions to unmount the card and voila! you now got a complete working system in your fingertips.

Chordata notochord banner

If you want to test if it’s working you can put the card on the raspberry, connect it to and HDMI monitor and power it. You should see the init system log displayed, and at the end the Chordata notochord banner. If you don’t have an HDMI monitor, in chapter 1.6 we’ll show you a different method for testing the installation.

If you prefer to impress your friends with your ninja-hacker console capacities, and your computer runs mac or linux, you can always use the old and good dd to flash your card

After identifying the device file for your SD card, (and probably unmounting it) you can just

cd <directory where the image file is>
gzip -d notochord_raspbian_0-1-0a.img.gz
sudo dd bs=4M if=notochord_raspbian_0-1-0a.img of=<SD card device file>

Advanced system configuration

If you want to use a different SBC, or just want to install the Chordata utilities without re flashing you SD card (why would you?), there are alternative ways of achieving the same result. If you are happy with the default method, feel free to skip the rest of this chapter

Configuration scripts

In the repository at http://gitlab.com/chordata/sd-card_factory you will find some configuration scripts with a unique entry point notochord_OS.sh. From your SBC you can use the following commands:

git clone http://gitlab.com/chordata/sd-card-factory
cd sd-card-factory
sudo notochord_OS.sh

If you are not in a raspbian system you can change the system specific configuration by tweaking the file called configure.sh Keep in mind that, for all these scripts, the dependencies are installed using apt-get. If you are not in a debian-based system, all of the command lines in the script that run this app should be adapted to your distribution. We would love to see portings of the Chordata system to different SBCs, so if you are attempting to do so and have some issues please ask in the [| forum], we’ll be there to assist you personally. If you already managed to do it, please share the steps it took you to do so in the same forum section!