OpenHAB
/
openhab-docs
mirror of https://github.com/openhab/openhab-docs.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

[Linux] Add stable instructions for Linux (#240) 

* Add stable instructions for Linux

Signed-off-by: Ben Clark <ben@benjyc.uk>

* IRT Review

Signed-off-by: Ben Clark <ben@benjyc.uk>

* Added manual instructions and updated to RC1

Signed-off-by: Ben Clark <ben@benjyc.uk>

* Added info about changing versions

Signed-off-by: Ben Clark <ben@benjyc.uk>

* Add apt next to apt-get

Signed-off-by: Thomas Dietrich <thomas.dietrich@tu-ilmenau.de> (github: ThomDietrich)

* Clarify Legacy meaning

Signed-off-by: Thomas Dietrich <thomas.dietrich@tu-ilmenau.de> (github: ThomDietrich)
pull/221/merge
Ben Clark 2017-01-22 22:26:54 +00:00 committed by Thomas Dietrich
parent 63516d93bd
commit 5e37934511
1 changed files with 68 additions and 39 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

107
installation/linux.md
View File

@ -47,7 +47,7 @@ sudo apt-get install oracle-java8-set-default
## Installation ## Installation
openHAB 2 can be installed though a package repository or manually from file. openHAB 2 can be installed though a package repository or manually from file.
The installation through a provided **package repository** (using `apt-get`) is **recommended** for end users. The installation through a provided **package repository** (using `apt` / `apt-get`) is **recommended** for end users.
The manual installation through a platform independent archive file is suited for users who know what they are doing and systems with a non-Debian distribution, not using the apt/deb package system. The manual installation through a platform independent archive file is suited for users who know what they are doing and systems with a non-Debian distribution, not using the apt/deb package system.
### Package Repository Installation ### Package Repository Installation
@ -61,60 +61,61 @@ First, add the openHAB 2 Bintray repository key to your package manager:
wget -qO - 'https://bintray.com/user/downloadSubjectPublicKey?username=openhab' | sudo apt-key add - wget -qO - 'https://bintray.com/user/downloadSubjectPublicKey?username=openhab' | sudo apt-key add -
``` ```
As long as openHAB 2 is in its development state you may choose between the latest *Beta* release or a *Snapshot* build. Then, you can choose between, *Official (Stable)*, *Beta* or *Snapshot* builds:
The snapshot build is created [almost daily](https://bintray.com/openhab/apt-repo2/openhab2#release), always including the latest changes to the openHAB 2 core and add-ons.
Decide between two options: * **Official Release**
The stable builds contain the latest official release with tested features.
Add the **openHAB 2 Stable Repository** to your systems apt sources list:
```shell
echo 'deb http://dl.bintray.com/openhab/apt-repo2 stable main' | sudo tee /etc/apt/sources.list.d/openhab2.list
```
* **Beta Release** * **Beta Release**
Add the **openHAB 2 Beta Repository** to your systems apt sources list (will overwrite the existing `openhab2.list`): The beta builds come out less frequently, but will contain new features that are currently in the testing phase.
Add the **openHAB 2 Beta Repository** to your systems apt sources list:
```shell ```shell
echo 'deb http://dl.bintray.com/openhab/apt-repo2 testing main' | sudo tee /etc/apt/sources.list.d/openhab2.list echo 'deb http://dl.bintray.com/openhab/apt-repo2 testing main' | sudo tee /etc/apt/sources.list.d/openhab2.list
``` ```
Resynchronize the package index:
```shell
sudo apt-get update
```
Finally install openHAB2 as either an offline or online distribution.
The **offline distribution** comes with all add-ons, the **online distribution** will install additional add-ons from the internet on request.
```shell
sudo apt-get install openhab2-offline
# OR #
sudo apt-get install openhab2-online
```
* **Snapshot Release** * **Snapshot Release**
Add the **openHAB 2 Unstable Repository** to your systems apt sources list (will overwrite the existing `openhab2.list`): The snapshot build is created [almost daily](https://bintray.com/openhab/apt-repo2/openhab2#release), and includes the latest changes to the openHAB 2 core and add-ons.
These changes are often unstable, so you should use this branch only for testing or development purposes.
Add the **openHAB 2 Unstable Repository** to your systems apt sources list:
```shell ```shell
echo 'deb http://dl.bintray.com/openhab/apt-repo2 unstable main' | sudo tee /etc/apt/sources.list.d/openhab2.list echo 'deb http://dl.bintray.com/openhab/apt-repo2 unstable main' | sudo tee /etc/apt/sources.list.d/openhab2.list
``` ```
Resynchronize the package index: Next, resynchronize the package index:
```shell ```shell
sudo apt-get update sudo apt-get update
``` ```
Now install openHAB with the following command: Now install openHAB with the following command:
```shell ```shell
sudo apt-get install openhab2 sudo apt-get install openhab2
``` ```
The latest snapshots will download add-ons on request, if you plan on disconnecting your machine from the internet then you will want to also install the add-ons package. When you choose to install an add-on, openHAB will download it from the internet on request.
Optionally, you can also install the legacy add-ons package, which contains [1.x bindings]({{base}}/addons/bindings.html#legacy-1x-bindings) for compatibility (useful if you're [coming from openHAB 1.x]({{base}}/tutorials/migration.html) for example): If you plan on disconnecting your machine from the internet, then you will want to also install the add-ons package.
```shell ```shell
sudo apt-get install openhab2-addons sudo apt-get install openhab2-addons
sudo apt-get install openhab2-addons-legacy ```
```
Optionally, you may in addition install the legacy add-ons package `openhab2-addons-legacy`.
This package contains 1.x bindings, for which there is already a 2.x version available.
This might be useful if you're [coming from openHAB 1.x]({{base}}/tutorials/migration.html) for example.
If everything went well, you can start openHAB and register it to be automatically executed at system startup: If everything went well, you can start openHAB and register it to be automatically executed at system startup:
@ -140,6 +141,7 @@ If everything went well, you can start openHAB and register it to be automatical
The first start may take **up to 15 minutes**, this is a good time to reward yourself with hot coffee or a freshly brewed tea! The first start may take **up to 15 minutes**, this is a good time to reward yourself with hot coffee or a freshly brewed tea!
You should be able to reach the openHAB 2 portal at [http://openhab-device:8080](http://openhab-device:8080) at this point. You should be able to reach the openHAB 2 portal at [http://openhab-device:8080](http://openhab-device:8080) at this point.
If you're new to openHAB, then you should checkout the [beginner's tutorial]({{base}}/tutorials/beginner/1sttimesetup.md)!
![The openHAB 2 portal page](images/Accueil_Openhab_2.png) ![The openHAB 2 portal page](images/Accueil_Openhab_2.png)
@ -158,6 +160,22 @@ sudo apt-get update
sudo apt-get upgrade sudo apt-get upgrade
``` ```
#### Changing Versions
You may want to switch to a different repo, or an older (but more stable) version of openHAB.
To do this, simply select the repo as in the [installation instructions above](#package-repository-installation), then find the version by bringing a list of all versions available to install:
```shell
sudo apt-get update
apt-cache showpkg openhab2
```
Once you know which version you want, you can upgrade/downgrade to it by using the `apt-get install=[version]` command, for example:
```shell
sudo apt-get install openhab2=2.0.0-1
```
#### Backup and Restore #### Backup and Restore
To make a backup of your openHAB 2 system, you need to retain your configuration and userdata files. To make a backup of your openHAB 2 system, you need to retain your configuration and userdata files.
@ -215,14 +233,25 @@ We are going to download a platform independent archive file and extract it to t
Choose between the latest Beta release or a Snapshot with all incoming contributions, created daily. Choose between the latest Beta release or a Snapshot with all incoming contributions, created daily.
As openHAB 2 is still in an evolving state, the snapshot may be the **preferred choice**. As openHAB 2 is still in an evolving state, the snapshot may be the **preferred choice**.
* **Beta Release** * **Official Release**
Download and extract the desired **offline or online** beta version of openHAB 2 from [bintray.com/openhab](https://bintray.com/openhab/mvn/openhab-distro) to your host. Download and extract the latest offical version of openHAB 2 from [bintray.com/openhab](https://bintray.com/openhab/mvn/openhab-distro/2.0.0) to your host.
We will use `openhab-offline-2.0.0.b5.zip` as an example:
```shell ```shell
cd /tmp cd /tmp
wget -O openhab-download.zip https://bintray.com/openhab/mvn/download_file?file_path=org%2Fopenhab%2Fdistro%2Fopenhab-offline%2F2.0.0.b5%2Fopenhab-offline-2.0.0.b5.zip wget -O openhab-download.zip https://bintray.com/openhab/mvn/download_file?file_path=org%2Fopenhab%2Fdistro%2Fopenhab%2F2.0.0%2Fopenhab-2.0.0.zip
sudo unzip openhab-download.zip -d /opt/openhab2
rm openhab-download.zip
```
* **Beta/RC Release**
Download and extract the desired beta or release client version of openHAB 2 from [bintray.com/openhab](https://bintray.com/openhab/mvn/openhab-distro) to your host.
We will use `openhab-offline-2.0.0.RC1.zip` as an example:
```shell
cd /tmp
wget -O openhab-download.zip https://bintray.com/openhab/mvn/download_file?file_path=org%2Fopenhab%2Fdistro%2Fopenhab%2F2.0.0.RC1%2Fopenhab-2.0.0.RC1.zip
sudo unzip openhab-download.zip -d /opt/openhab2 sudo unzip openhab-download.zip -d /opt/openhab2
rm openhab-download.zip rm openhab-download.zip
``` ```