Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update windows.md #262

Merged
merged 4 commits into from Jan 25, 2017
Merged

Update windows.md #262

Changes from 2 commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
c9d6f0a
Update windows.md
DimitrisSar Jan 24, 2017
1003673
Update windows.md
DimitrisSar Jan 25, 2017
06c49aa
Update windows.md
DimitrisSar Jan 25, 2017
8e38c43
Fix arrows
ThomDietrich Jan 25, 2017
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
23 changes: 17 additions & 6 deletions installation/windows.md
View file
Open in desktop
Expand Up @@ -5,27 +5,36 @@ title: Windows

{% include base.html %}

# openHAB on Windows
# openHAB 2 on Windows

The following instructions will guide you through the process of setting up openHAB 2.

## Prerequisites

First, be sure to check that your system has the necessary [prerequisites]({{base}}/installation/index.html#prerequisites).

Add the JAVA_HOME System Environment Variable in Windows: Navigate to
`Control Panel\System and Security\System\Advanced system settings\Environment variables\System variables` and create a New System Variable based on your Java installation directory:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To stay in sync with other parts I'd suggest to put JAVA_HOME in ``.
The path through the Windows menu would be better described by -> or → or ➡


![JAVA_HOME](http://imageshack.com/a/img921/5017/HZjFl6.png)

The directory that openHAB is installed to must **contain no spaces**.
On this page, we will be using `C:\openhab` as an example.
On this page, we will be using `C:\openHAB2` as an example.

## Installation

The openHAB runtime is distributed using a platform-independent zip file.
To install it, follow these simple steps:

1. Choose between the [RC (Release client) version](https://bintray.com/openhab/mvn/download_file?file_path=org%2Fopenhab%2Fdistro%2Fopenhab%2F2.0.0.RC1%2Fopenhab-2.0.0.RC1.zip) or the [latest snapshot version](https://openhab.ci.cloudbees.com/job/openHAB-Distribution/lastSuccessfulBuild/artifact/distributions/openhab/target/openhab-2.0.0-SNAPSHOT.zip) of openHAB2.
1. Choose between the Stable Version [ ![Download](https://api.bintray.com/packages/openhab/mvn/openhab-distro/images/download.svg) ](https://bintray.com/openhab/mvn/download_file?file_path=org%2Fopenhab%2Fdistro%2Fopenhab%2F2.0.0%2Fopenhab-2.0.0.zip) or the latest Snapshot Version [ ![Download](https://api.bintray.com/packages/openhab/mvn/openhab-distro/images/download.svg?version=2.1.0) ](https://openhab.ci.cloudbees.com/job/openHAB-Distribution/lastSuccessfulBuild/artifact/distributions/openhab/target/openhab-2.1.0-SNAPSHOT.zip) of openHAB2.

2. Unzip the file in your chosen directory (e.g. `C:\openHAB2`)

2. Unzip the file in your chosen directory (e.g. `C:\openhab`)
![openHAB 2 Folders](http://imageshack.com/a/img924/8420/QHo9LU.png)

3. Start the server: Launch the runtime by executing the script `start.bat` and wait a while for it to start and complete.
3. Start the server: Launch the runtime by executing the script `C:\openHAB2\start.bat` and wait a while for it to start and complete.

![Karaf_Windows](http://imageshack.com/a/img921/5466/TOJADy.png)

4. Point your browser to `http://localhost:8080`. You should be looking at the openHAB [package selection page]({{base}}/configuration/packages.html).
When you've selected an appropriate package, this page will contain the [UI]({{base}}/addons/uis.html) selection screen.
Expand All @@ -44,7 +53,7 @@ Assuming a successful install, you will now have various folders inside `C:\open
## Backup
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is one C:\openhab mentioning above

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Additionally, Could you name the headline "File Locations" and bring everything in sync with http://docs.openhab.org/installation/linux.html#file-locations
That would be nice.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

working on it now :)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pushed another small update
Check please @ThomDietrich


Make sure that you make regular backups of the **conf** and **userdata** folders, you can zip and unzip these folders too and from openHAB installations (even across most versions).
When you have a setup that you are happy with, it would be a good idea to make a backup of the whole `C:\openhab` folder. Which can be used any time after a failure.
When you have a setup that you are happy with, it would be a good idea to make a backup of the whole `C:\openHAB2` folder. Which can be used any time after a failure.

## Updating the openHAB Runtime

Expand All @@ -69,4 +78,6 @@ There is currently no automatic update script for Windows. To update manually, d

## Starting openHAB as a service

(work in progress...)

{% include contribution-wanted.html %}