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.
This commit is contained in:
jbags81 2016-06-13 20:48:37 -04:00 committed by GitHub
parent 0b3721a565
commit e722a45f53

View File

@ -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: