Skip to content

Latest commit

 

History

History
60 lines (44 loc) · 2.57 KB

05-Install-Components.md

File metadata and controls

60 lines (44 loc) · 2.57 KB
Raw

Install Components

Once you added and/or synced your repositories and configured - if required - your locks, we can start installing components.

For this we will use Install-IcingaComponent.

Note: When the install component is looking up available versions, all defined repositories will be searched and the latest version available used by default. If a specific version is set, it will stop once this version is found in one of the repositories and go with this package.

Available Arguments

Argument Type Description
Name String The name of the component you want to install
Version String Specifies to install a specific version of the component, instead of the latest one found. Is ignored in case you added a lock to this component
Release Switch Includes release versions only if set. If neither Release nor Snapshot is defined, it will enforce release
Snapshot Switch Includes snapshots versions only if set. If neither Release nor Snapshot is defined, it will enforce release
Confirm Switch Skips the message asking you if you want to install this component
Force Switch In case the same version is already installed, it will be skipped by default. Use this switch to install the same version again

Install Release Components

You can install release components either by adding the -Release switch or by not adding -Release and -Snapshot at all, to enforce release versions. If no version is specified, the latest version found will be used. Use -Confirm in addition to skip the dialog requiring an approval to install it.

Install-IcingaComponent `
    -Name 'agent' `
    -Confirm;

Install Specific Component Version

If your repository contains multiple versions, you can specify which version will be installed:

Install-IcingaComponent `
    -Name 'agent' `
    -Version '2.11.2' `
    -Confirm;

Reinstall Installed Component

If a component with a specific version is already installed, you can use -Force to re-install it.

Install-IcingaComponent `
    -Name 'agent' `
    -Version '2.11.5' `
    -Confirm `
    -Force;

This also works for auto detected latest versions:

Install-IcingaComponent `
    -Name 'agent' `
    -Confirm `
    -Force;