Docs: Adopt latest MSI doc enhancements from upstream master

Signed-off-by: Michael Schuster <michael@schuster.ms>
This commit is contained in:
Michael Schuster 2020-09-29 19:04:08 +02:00 committed by Kevin Ottens (Rebase PR Action)
parent 8e48d53b04
commit bf6980d31a

View file

@ -39,11 +39,11 @@ System Requirements
.. note:: .. note::
For Linux distributions, we support, if technically feasible, the latest 2 versions per platform and the previous LTS. For Linux distributions, we support, if technically feasible, the latest 2 versions per platform and the previous LTS.
Customizing the Windows installation Customizing the Windows Installation
------------------------------------ ------------------------------------
If you just want to install ownCloud Desktop Synchronization Client on your local If you just want to install ownCloud Desktop Synchronization Client on your local
system, you can simply launch the .msi file and configure it in the wizard system, you can simply launch the `.msi` file and configure it in the wizard
that pops up. that pops up.
Features Features
@ -51,13 +51,13 @@ Features
The MSI installer provides several features that can be installed or removed The MSI installer provides several features that can be installed or removed
individually, which you can also control via command-line, if you are automating individually, which you can also control via command-line, if you are automating
the installation:: the installation, then run the following command::
msiexec /passive /i ownCloud-x.y.z.msi msiexec /passive /i ownCloud-x.y.z.msi
will install the ownCloud Desktop Synchronization Client into the default location The command will install the ownCloud Desktop Synchronization Client into the default location
with the default features enabled. If you want to disable, e.g., desktop shortcut with the default features enabled.
icons you can simply change the above command to:: If you want to disable, e.g., desktop shortcut icons you can simply change the above command to the following::
msiexec /passive /i ownCloud-x.y.z.msi REMOVE=DesktopShortcut msiexec /passive /i ownCloud-x.y.z.msi REMOVE=DesktopShortcut
@ -93,21 +93,21 @@ If you for instance want to install everything but the ``DesktopShortcut`` and t
msiexec /passive /i ownCloud-x.y.z.msi NO_DESKTOP_SHORTCUT="1" NO_SHELL_EXTENSIONS="1" msiexec /passive /i ownCloud-x.y.z.msi NO_DESKTOP_SHORTCUT="1" NO_SHELL_EXTENSIONS="1"
.. NOTE:: .. NOTE::
The ownCloud .msi remembers these properties, so you don't need to specify them on upgrades. The ownCloud `.msi` remembers these properties, so you don't need to specify them on upgrades.
.. NOTE:: .. NOTE::
You cannot use these to change the installed features, if you want to do that, see the next section. You cannot use these to change the installed features, if you want to do that, see the next section.
Changing installed features Changing Installed Features
~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
You can change the installed features later by using `REMOVE` and `ADDDEFAULT` properties. You can change the installed features later by using `REMOVE` and `ADDDEFAULT` properties.
1. If you want to add the the desktop shortcut later:: 1. If you want to add the the desktop shortcut later, run the following command::
msiexec /passive /i ownCloud-x.y.z.msi ADDDEFAULT="DesktopShortcut" msiexec /passive /i ownCloud-x.y.z.msi ADDDEFAULT="DesktopShortcut"
2. If you want to remove it, simply do:: 2. If you want to remove it, simply run the following command::
msiexec /passive /i ownCloud-x.y.z.msi REMOVE="DesktopShortcut" msiexec /passive /i ownCloud-x.y.z.msi REMOVE="DesktopShortcut"
@ -120,7 +120,7 @@ on the Windows Installer Guide.
.. NOTE:: .. NOTE::
You cannot specify `REMOVE` on initial installation as it will disable all features. You cannot specify `REMOVE` on initial installation as it will disable all features.
Installation folder Installation Folder
^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^
You can adjust the installation folder by specifying the `INSTALLDIR` You can adjust the installation folder by specifying the `INSTALLDIR`
@ -129,18 +129,17 @@ property like this::
msiexec /passive /i ownCloud-x.y.z.msi INSTALLDIR="C:\Program Files (x86)\Non Standard ownCloud Client Folder" msiexec /passive /i ownCloud-x.y.z.msi INSTALLDIR="C:\Program Files (x86)\Non Standard ownCloud Client Folder"
Be careful when using PowerShell instead of `cmd.exe`, it can be tricky to get Be careful when using PowerShell instead of `cmd.exe`, it can be tricky to get
the whitespace escaping right there. Specifying the `INSTALLDIR` like this the whitespace escaping right there.
only works on first installation, you cannot simply reinvoke the .msi with a Specifying the `INSTALLDIR` like this only works on first installation, you cannot simply re-invoke the `.msi` with a different path. If you still need to change it, uninstall it first and reinstall it with the new path.
different path. If you still need to change it, uninstall it first and reinstall
it with the new path.
Disabling automatic updates Disabling Automatic Updates
^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^
To disable automatic updates, you can pass the `SKIPAUTOUPDATE` property.:: To disable automatic updates, you can pass the `SKIPAUTOUPDATE` property.::
msiexec /passive /i ownCloud-x.y.z.msi SKIPAUTOUPDATE="1" msiexec /passive /i ownCloud-x.y.z.msi SKIPAUTOUPDATE="1"
Launch after installation Launch After Installation
^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^
To launch the client automatically after installation, you can pass the `LAUNCH` property.:: To launch the client automatically after installation, you can pass the `LAUNCH` property.::
@ -153,7 +152,7 @@ for non passive/quiet mode.
.. NOTE:: .. NOTE::
This option does not have any effect without GUI. This option does not have any effect without GUI.
No reboot after installation No Reboot After Installation
^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The ownCloud Client schedules a reboot after installation to make sure the Explorer extension is correctly (un)loaded. The ownCloud Client schedules a reboot after installation to make sure the Explorer extension is correctly (un)loaded.