From e722a45f53004875a61e29d2105b219d06ddceb6 Mon Sep 17 00:00:00 2001 From: jbags81 Date: Mon, 13 Jun 2016 20:48:37 -0400 Subject: [PATCH] Updated documentation to reflect latest script updates Updates to documentation to mirror current AiO script updates. Includes: Warning instead of dying on error. Specifying installation report output file Location of configs updated to ".homeassistant" Installs Mosquitto v1.4.9 Detects PI hardware revision and modifies install syntax accordingly. --- .../installation-raspberry-pi-all-in-one.markdown | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/source/getting-started/installation-raspberry-pi-all-in-one.markdown b/source/getting-started/installation-raspberry-pi-all-in-one.markdown index e054f5091a7..b6672febf9d 100644 --- a/source/getting-started/installation-raspberry-pi-all-in-one.markdown +++ b/source/getting-started/installation-raspberry-pi-all-in-one.markdown @@ -19,13 +19,13 @@ $ wget -Nnv https://raw.githubusercontent.com/home-assistant/fabric-home-assista ``` *Note this command is one line and not run as sudo* -Installation will take approx. 1-2 hours depending on the Raspberry Pi model the installer is being run against. +Installation will take approx. 1-2 hours depending on the Raspberry Pi model the installer is being run against. The installer will identitfy what Raspberry PI hardware revision you are using and adjust commands accordingly. A complete log of the install is located at: `/home/pi/fabric-home-assistant/installation_report.txt` The installer has been updated to simply log any errors encountered, but resume installing. Please consult the "installation report" if your install encountered issues. [BRUH automation](http://www.bruhautomation.com) has created [a tutorial video](https://www.youtube.com/watch?v=VGl3KTrYo6s) explaining how to install Raspbian on your Raspberry Pi and install Home Assistant using the All-In-One Installer. Once rebooted, your Raspberry Pi will be up and running with Home Assistant. You can access it at [http://your_raspberry_pi_ip:8123](http://your_raspberry_pi_ip:8123). -The Home Assistant configuration is located at `/home/hass`. The virtualenv with the Home Assistant installation is located at `/srv/hass/hass_venv`. As part of the secure installation, a new user is added to your Raspberry Pi to run Home Assistant as named, **hass**. This is a system account and does not have login or other abilities by design. When editing your configuration.yaml files, you will need to run the commands with "sudo" or by switching user. +The Home Assistant configuration is located at `/home/hass/.homeassistant`. The virtualenv with the Home Assistant installation is located at `/srv/hass/hass_venv`. As part of the secure installation, a new user is added to your Raspberry Pi to run Home Assistant as named, **hass**. This is a system account and does not have login or other abilities by design. When editing your configuration.yaml files, you will need to run the commands with "sudo" or by switching user. *Windows users* - Setting up WinSCP to allow this seemlessly is detailed below. By default, installation makes use of a Python Virtualenv. If you wish to not follow this recommendation, you may add the flag `-n` to the end of the install command specified above. @@ -38,18 +38,24 @@ The All-In-One Installer script will do the following automatically: * Setup a python virtualenv to run Home Assistant and components inside. * Run as `hass` service account * Install Home Assistant in a virtualenv -* Build and install Mosquitto from source with websocket support running on ports 1883 and 9001 +* Build and install Mosquitto v1.4.9 from source with websocket support running on ports 1883 and 9001 * Build and Install Python-openzwave in the Home Assistant virtualenv * Build openzwave-control-panel in `/srv/hass/src/open-zwave-control-panel` * Add both Home Assistant and Mosquitto to systemd services to start at boot -To upgrade the All-In-One setup: +To upgrade the All-In-One setup manually: * Login to Raspberry Pi ```ssh pi@your_raspberry_pi_ip``` * Change to hass user `sudo su -s /bin/bash hass` * Change to virtual enviroment `source /srv/hass/hass_venv/bin/activate` * Update HA `pip3 install --upgrade homeassistant` + +To upgrade with fabric: + +* Login to Raspberry Pi ```ssh pi@your_raspberry_pi_ip``` +* Change to `cd ~/fabric-home-assistant` +* Run `fab upgrade_homeassistant` To launch the OZWCP webapp: