Differences

This shows you the differences between two versions of the page.

Link to this comparison view

en:quick_start_guide [2014/09/04 14:03]
admin [What you will need]
en:quick_start_guide [2016/01/13 20:28]
Line 1: Line 1:
-====== Calaos quick start guide ====== 
- 
-====== Raspberry pi quick start guide ====== 
-===== What you need ===== 
-  * A computer with Linux, MacosX or Windows 
-  * A Raspberry pi, Model B 
-  * An SD Card, We recommend an 2GB class 10 SD card (class 4 can be broken much more quickly) 
-  * Download the latest official calaos image for raspberrypi :[[ http://calaos.fr/download/experimental/calaos-image-raspberrypi-2014-04-28.tar.xz]] 
- 
-====== Creating the SD card with calaos os ======  
-=== Linux === 
-Launch a terminal and go in the directory where you download the calaos os image. 
- 
-   $ cd ~/Downloads 
-   $ tar xvf calaos-image-raspberrypi-2014-04-28.tar.xz 
- 
-Insert the sdcard into the sdcard reader of your PC. 
-You need to know what's the device created by linux when the card is inserted. The device name is something like /dev/sdX or /dev/mmcblkX. 
-To know the exact name use the following command : 
- 
-   $ dmesg | tail 
- 
- 
-You should get something like that : 
- 
-   [191385.790344] mmc0: new high speed SDHC card at address 1234 
-   [191385.790574] mmcblk0: mmc0:1234 SA04G 3.67 GiB 
-   [191385.791564]  mmcblk0: p1 p2 
- 
-In that case the device is /dev/mmvblk0 
- 
-We need to ensure that this device is not mounted on your system 
- 
-   $ sudo unmount /dev/mmvblk0p1 
-   $ sudo unmount /dev/mmvblk0p2 
-   ... 
- 
-or in case your device is detected as /dev/sdX 
- 
-   $ sudo unmount /dev/sdd1 
-   $ sudo unmount /dev/sdd2 
-   ... 
- 
-You can verify that the devices are not mounted by using the mount command  
- 
-   $ mount 
- 
-No sdcard must appears in the resulting list. 
- 
-Let's now copy the **calaos os** on the sdcard 
- 
-   sudo dd if=calaos-image-raspberrypi-2014-04-28.sdimg of=/dev/mmcblk0 
- 
-Once the operation is terminated, you can remove the sdcard, and insert it in the Raspberry pi. 
- 
- 
-=== Macos === 
- 
-You can use ApplePi-Baker. It's a free utility tha allows you to write an image to the sdcard. 
-It can be download here : [[http://www.tweaking4all.com/downloads/raspberrypi/ApplePi-Baker.zip]] 
- 
-=== Windows === 
-You can use Win32DiskImager. You can download it here : [[http://sourceforge.net/projects/win32diskimager/]] 
- 
-====== Connecting to the Rpi ======  
- 
-When you boot the raspberrypi, the network is configure to use dhcp, so you need to know what's the address the dhcp server give you. Or if you are using MacOS or Linux, you may try to connect to it with :  
- 
-   ssh root@rasberrypi 
- 
-If you already know the IP address, just connect directly : 
- 
-   ssh root@ip_address 
- 
-The default password is empty. 
-If you have trouble to find the ip adress, look here : http://www.raspberrypi.org/documentation/troubleshooting/hardware/networking/ip-address.md it may give you some hints. 
- 
-NOTE : on Linux and MacosX you can use the Terminal to use ssh. On windows you need a program like putty to connect to the raspberrypi : [[http://www.putty.org/]] 
- 
-======  Calaos Server configuration ======  
- 
-The first thing to do is to start calaos_server to let him create a defaut set of config files in /etc/calaos : 
- 
-    systemctl start calaos-server 
- 
-Then you can set the basic parameters of your calaos installation : username and password. 
- 
-    $ calaos_config set cn_user nico 
-    $ calaos_config set cn_pass calaos_rox 
- 
-These user and password are those that you will use to connect from Calaos Web, Calaos Home or Calaos Installer. 
-By default when you boot the raspberrypi with a **Calaos OS** image, calaos-server is not started automatically. 
-If you want it activated every time you start the card, enable it at startup with the following command : 
- 
-   systemctl enable calaos-server 
- 
-To see if everything is working fine with calaos server, you can try to connect to the server via Calaos Web. Start your favorite web browser and connect to http://raspberrypi or http://ip_address     
-You should be able to login, but nothing is displayed in the interface. It's completely **normal** as we don't have configured the whole installation yet. What we need now is to create the configuration of our house, and Calaos Installer will be used for that. 
- 
-======  House configuration with Calaos Installer ======  
- 
-Calaos Installer is an application for Linux, Macos X and Windows. 
-You can download it here : TBD