parent
e0ee60f225
commit
2d9d55d53e
|
@ -1,46 +0,0 @@
|
|||
{% include base.html %} {% assign docu = base %}
|
||||
|
||||
<ul class="nav">
|
||||
<li><a href="{{docu}}/index.html">Overview</a></li>
|
||||
<li><a href="{{docu}}/esh/items.html">Concepts</a>
|
||||
<ul>
|
||||
<li><a href="{{docu}}/esh/items.html">Items</a></li>
|
||||
<li><a href="{{docu}}/esh/things.html">Things</a></li>
|
||||
<li><a href="{{docu}}/esh/discovery.html">Inbox & Discovery</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="{{docu}}/features/addons.html">Add-ons</a>
|
||||
<ul>
|
||||
<li><a href="{{docu}}/features/bindings.html">Bindings</a>
|
||||
<ul>
|
||||
{% for binding in site.data.bindings %}
|
||||
<li><a href="{{docu}}/features/bindings/{{ binding.id }}/readme.html">{{ binding.label }}</a></li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="{{docu}}/features/uis.html">User Interfaces</a>
|
||||
<ul>
|
||||
<li><a href="{{docu}}/features/ui/basic/readme.html">Basic UI</a></li>
|
||||
<li><a href="{{docu}}/features/iconsets/classic/readme.html">Classic Iconset</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="{{docu}}/features/io.html">System Integrations</a>
|
||||
<ul>
|
||||
<li><a href="{{docu}}/features/io/homekit/readme.html">HomeKit</a></li>
|
||||
<li><a href="{{docu}}/features/io/hueemulation/readme.html">Amazon Echo</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="{{docu}}/development/ide.html">Development</a>
|
||||
<ul>
|
||||
<li><a href="{{docu}}/development/ide.html">IDE Setup</a></li>
|
||||
<li><a href="{{docu}}/esh/guidelines.html">Guidelines</a></li>
|
||||
<li><a href="{{docu}}/development/bindings.html">Bindings</a></li>
|
||||
</ul></li>
|
||||
<li><a href="{{docu}}/community/contributing.html">Community</a>
|
||||
<ul>
|
||||
<li><a href="{{docu}}/community/contributing.html">Contributing</a></li>
|
||||
<li><a href="{{docu}}/community/downloads.html">Downloads</a></li>
|
||||
</ul></li>
|
||||
</ul>
|
|
@ -1,18 +0,0 @@
|
|||
{% include base.html %} {% assign docu = base %}
|
||||
|
||||
<ul class="nav">
|
||||
<li><a href="{{docu}}/index.html">openHAB Basics</a>
|
||||
<ul>
|
||||
<li><a href="{{docu}}/index.html">Things, Items & Co</a></li>
|
||||
<li><a href="{{docu}}/index.html">Sitemaps</a></li>
|
||||
<li><a href="{{docu}}/index.html">Add-ons</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="{{docu}}/index.html">Installing openHAB</a>
|
||||
<ul>
|
||||
<li><a href="{{docu}}/index.html">Java</a></li>
|
||||
<li><a href="{{docu}}/index.html">Runtime</a></li>
|
||||
<li><a href="{{docu}}/index.html">Designer</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
|
@ -13,7 +13,7 @@
|
|||
<li><a href="{{docu}}/installation/index.html">Installation</a>
|
||||
<ul>
|
||||
<li><a href="{{docu}}/installation/index.html">Overview</a>
|
||||
<li><a href="{{docu}}/installation/checkingjava.html">Prerequisites</a></li>
|
||||
<li><a href="{{docu}}/installation/prereqs.html">Prerequisites</a></li>
|
||||
<li><a href="{{docu}}/installation/apt.html">Linux (APT)</a></li>
|
||||
<li><a href="{{docu}}/installation/linux.html">Linux (manual)</a></li>
|
||||
<li><a href="{{docu}}/installation/rasppi.html">Raspberry Pi</a></li>
|
||||
|
|
|
@ -4,11 +4,11 @@ layout: documentation
|
|||
|
||||
{% include base.html %}
|
||||
|
||||
# Checking Java
|
||||
# Prerequisites
|
||||
|
||||
Before anything else, check that the correct version of Java has been installed.
|
||||
You require a JDK 8 in order to run openHAB. Note that there are often issues with OpenJDK, therefore it is advised to use the OracleJDK instead.
|
||||
|
||||
To do this :
|
||||
Check that the correct version of Java has been installed:
|
||||
|
||||
* Open the terminal window
|
||||
|
|
@ -0,0 +1,70 @@
|
|||
---
|
||||
layout: intro
|
||||
---
|
||||
|
||||
{% include base.html %}
|
||||
|
||||
# Quick Start with a Demo Setup
|
||||
|
||||
## Prerequisites
|
||||
|
||||
Make sure that you have a [JDK 8](/installation/prereqs.html) installed.
|
||||
|
||||
## Installation
|
||||
|
||||
openHAB comes as a [platform independent zip file](https://openhab.ci.cloudbees.com/job/openHAB-Distribution/lastSuccessfulBuild/artifact/distributions/openhab-offline/target/openhab-offline-2.0.0-SNAPSHOT.zip), which you only need to extract to some folder.
|
||||
|
||||
You will find the following folders:
|
||||
|
||||
- `conf`: This contains all your user specific configuration files.
|
||||
- `runtime`: This contains the openHAB binaries, there should normally be no need to touch anything in here - the whole folder can be considered to be read-only.
|
||||
- `userdata`: Here you will find all the data that is generated during runtime: log files, database files, etc. In theory this should be the only folder where openHAB needs write permission on.
|
||||
- `addons`: Here you can drop add-ons (or any other OSGi bundles) that you want to be deployed in your instance. These can be add-ons for openHAB 1.x and 2.x likewise. Note that all "normal" add-ons are already included in the openHAB distribution and all you need is to name them in your 'addons.cfg' file (see below). Hence the `addons` folder is mainly useful if you have received jars from other sources and want to install and test them.
|
||||
|
||||
## Choosing Demo as a Base Package and further add-ons to be Installed
|
||||
|
||||
The demo package consists out of demo configuration files (for items, sitemaps, etc.) and a selection of add-ons and UIs. In order to install it, you should directly edit the file 'conf/services/addons.cfg'.
|
||||
You need to uncomment the line `package=` and set it to `demo` as shown below:
|
||||
|
||||
```
|
||||
# The base installation package of this openHAB instance (default is "standard")
|
||||
# Valid options:
|
||||
# - minimal : Installation only with dashboard, but no UIs or other addons
|
||||
# - standard : Typical installation with all standards UIs
|
||||
# - demo : A demo setup which includes UIs, a few bindings, config files etc.
|
||||
package = demo
|
||||
|
||||
...
|
||||
```
|
||||
|
||||
## Starting the Runtime
|
||||
|
||||
Once you have configured your runtime, you can simply start openHAB by calling `start.sh` resp. `start.bat` on Windows and the runtime will start up:
|
||||
|
||||

|
||||
|
||||
Point your browser to ```http://<hostname>:8080``` (allow the runtime some time to start before the HTTP server is available, especially on the very first start) and you will be welcomed by the openHAB Dashboard, which is the entry point to the different web UIs:
|
||||
|
||||

|
||||
|
||||
Selecting the _Basic UI_ will give you a virtual home and examples of the different widget types that exist:
|
||||
|
||||

|
||||
|
||||
The files that are used by these demo setup are available in the `conf` folder.
|
||||
To understand their meaning and how you can tweak them all, please refer to our [beginner tutorial](beginner).
|
||||
|
||||
_NOTE:_ As long as you have selected the `demo` package in `addons.cfg`, you are not able to uninstall any of the installed addons.
|
||||
So once you are ready to build your personal setup, don't forget to switch the base package back to `standard`.
|
||||
|
||||
## Using the Shell
|
||||
|
||||
openHAB uses Apache Karaf and thus comes with a very powerful shell for managing the installation. Please check the [Karaf command reference](http://karaf.apache.org/manual/latest/commands/commands.html) for details. Useful commands e.g. include:
|
||||
|
||||
- `log:tail`: Show the live logging output, end it by pressing ctrl+c.
|
||||
- `log:exception-display`: Show the last exception of the log file.
|
||||
- `log:set DEBUG org.openhab.binding.sonos`: Enables debug logging for a certain binding.
|
||||
- `feature:list`: Lists all features available and shows there status. openHAB add-ons are made available as such Karaf features.
|
||||
- `feature:install openhab-binding-knx`: Installs a certain add-on (here KNX).
|
||||
- `bundle:list -s`: Lists all installed bundles with their symbolic name.
|
||||
- `logout`: Shuts down openHAB.
|
Binary file not shown.
After Width: | Height: | Size: 49 KiB |
Binary file not shown.
After Width: | Height: | Size: 14 KiB |
Binary file not shown.
After Width: | Height: | Size: 99 KiB |
|
@ -8,7 +8,19 @@ layout: raw
|
|||
<h1>Tutorials</h1>
|
||||
<p>There are different tutorials to get you started with openHAB:
|
||||
<div class="row center targets">
|
||||
<div class="col s12 m4 l4">
|
||||
<div class="col s12 m3 l3">
|
||||
<a href="demo.html">
|
||||
<div class="target target-beginner card">
|
||||
<i class="mdi-device-dvr icon-large"></i>
|
||||
<div class="footer">
|
||||
<div class="valign-wrapper">
|
||||
<h2 class="valign">Demo Setup</h2>
|
||||
</div>
|
||||
</div>
|
||||
</div></a>
|
||||
</div>
|
||||
|
||||
<div class="col s12 m3 l3">
|
||||
<a href="beginner">
|
||||
<div class="target target-beginner card">
|
||||
<i class="mdi-social-person icon-large"></i>
|
||||
|
@ -20,7 +32,7 @@ layout: raw
|
|||
</div></a>
|
||||
</div>
|
||||
|
||||
<div class="col s12 m4 l4">
|
||||
<div class="col s12 m3 l3">
|
||||
<a href="advanced">
|
||||
<div class="target target-advanced card">
|
||||
<i class="mdi-social-people icon-large"></i>
|
||||
|
@ -30,7 +42,7 @@ layout: raw
|
|||
</div>
|
||||
</div></a>
|
||||
</div>
|
||||
<div class="col s12 m4 l4">
|
||||
<div class="col s12 m3 l3">
|
||||
<a href="migration">
|
||||
<div class="target target-migration card">
|
||||
<i class="mdi-maps-directions icon-large"></i>
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
layout: documentation
|
||||
layout: intro
|
||||
---
|
||||
|
||||
{% include base.html %}
|
Loading…
Reference in New Issue