Upgrade script for Windows

[ghys]

This script will download a release or snapshot build, extract it
and perform an in-place upgrade.

Known limitations:
It will not take care of addons (.jar or .kar files for offline
installation) in the addons folder. It will also not be able to update
itself before performing the actual update, or check the current openHAB
version.

Signed-off-by: Yannick Schaus habpanel@schaus.net

[ThomDietrich]

Hey @ghys 👋
That's a nice looking script. Great what you got together in such a short time! May I ask why you didn't use the existing script as a starting point!?
Just to be clear: Are you still working on the script now or is the PR finished?

[ghys]

Instructions for running the script (for the release notes):

1. Run PowerShell with the Run as Administrator option
2. Allow scripts to execute by running this command (confirm the security prompt):

PS > Set-ExecutionPolicy Bypass

3. Navigate to your openHAB directory
4. Download the script:

PS > Invoke-WebRequest -Uri https://raw.githubusercontent.com/openhab/openhab-distro/master/distributions/openhab/src/main/resources/bin/update.ps1 -OutFile update.ps1

5. Run the script with this command (note the . at the beginning!):

PS > . .\update.ps1

6. This will add a new cmdlet Update-openHAB to your system.
   You can use:

PS > man Update-openHAB -detailed

to get help on the available parameters.

7. Run the update with no parameters to upgrade the distribution in the current directory to the current stable version.

PS > Update-openHAB

8. (Optional) Restore the execution policy to the default setting with:

PS > Set-ExecutionPolicy Default

[ghys]

@ThomDietrich I have nothing to add to this script for now! I think we'll live with the current limitations. :)

[kaikreuzer]

could you please rename OpenHAB to openHAB?

[ghys]

@kaikreuzer I made this "mistake" on purpose because I think it's the de facto standard casing for PowerShell cmdlets (https://technet.microsoft.com/en-us/library/ff714569.aspx) 😋

But if you insist! 😉

(btw, they are not case sensitive, so even update-openhab would work too: https://technet.microsoft.com/en-us/library/bb648607(v=vs.85).aspx)

[ThomDietrich]

1. Run PowerShell with the Run as Administrator option

I fear many will not know how to do that.

[kaikreuzer]

@ThomDietrich So you vote against doing it with this script or are you asking for a more detailed description?

[ThomDietrich]

No the script is perfectly fine, just add a more detailed description

Hmmmm how about

Execute PowerShell with elevated rights (e.g. by right-clicking the start menu PowerShell entry and selecting 'Run as Administrator')

[kaikreuzer]

Great what you got together in such a short time!

Indeed, pretty impressive, thanks!

I made this "mistake" on purpose because I think it's the de facto standard casing for PowerShell cmdlets

I was obviously not aware of this :-) Thanks for changing it anyhow 😎

[kaikreuzer]

Ok then, let's merge the script and I will update the release notes.

[kaikreuzer]

Done: https://github.com/openhab/openhab-distro/releases/tag/2.1.0#manual-installations

[ghys]

Nice! Glad to have been of help and also credit where credit is due - the UNIX Shell script and the former PowerShell script.