> For the complete documentation index, see [llms.txt](https://docs.enginsight.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enginsight.com/docs/manual/english/platform-usage/alerts/management/maintenance-periods/add-maintenance-period.md).

# Add Maintenance Period

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Add Maintenance Period** in the upper-right corner of the [maintenance periods overview](https://docs.enginsight.com/docs/manual/english/archive/issues/maintenance-periods.md#maintenance-periods-overview) and select one of the following options from the submenu that opens:

* [Create New](#create-a-new-maintenance-period): Select this option if you want to create a new maintenance period.
* [Import](#import-maintenance-periods): Select this option if you want to import one or more maintenance periods that you previously exported, for example from other organizations.

***

## Creating a New Maintenance Period

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Add Maintenance Period** in the upper-right corner of the [maintenance periods overview](https://docs.enginsight.com/docs/manual/english/platform-usage/alerts/management/maintenance-periods.md#maintenance-periods-overview) and select **Create New** from the submenu that opens to add a new maintenance period.

The **Alerts** → **Maintenance Periods** → **Add** view opens.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2Fnn9DsD3c9gKKAC0Gs3zV%2Fenginsight-screenshot-alerts-management-maintenance%20periods-add%20maintenace%20period.jpg?alt=media&amp;token=d11d951f-b6d2-49ea-b71a-1aa900a644e0" alt=""><figcaption></figcaption></figure>

<i class="fa-computer-mouse">:computer-mouse:</i> Click **Add Maintenance Period** after configuring all settings to save and create the new maintenance period.

<i class="fa-computer-mouse">:computer-mouse:</i> Click **Back** to return to the list overview.

{% hint style="danger" %}
**Please note**: If you leave this view without saving, all configured settings will be lost and cannot be recovered.
{% endhint %}

***

## General Settings

Here you can configure various basic settings.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2F4eY62vm07P93Eznnd66h%2F-enginsight-screenshot-alerts-management-maintenance%20periods-add%20maintenace%20period-general%20settings.jpg?alt=media&amp;token=9aa86de2-66f4-4329-9670-6bf4892fab94" alt="" width="563"><figcaption></figcaption></figure></div>

The following options are available:

<table><thead><tr><th width="200.56640625">Option</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>Enter a meaningful name for the maintenance period.</td></tr><tr><td>Description</td><td><p>Provide a more detailed description of the maintenance period.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This field is optional.</p></div></td></tr><tr><td>Enabled</td><td><p>Enable the maintenance period to prevent alerts from being triggered during the specified period.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This option is enabled by default.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Select or deselect the checkbox <i class="fa-square">:square:</i> next to <strong>Enabled</strong> to enable or disable the maintenance period.</p></td></tr></tbody></table>

***

## Schedule

Here you can define when and at what interval the maintenance period should run.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FiHbxxUX8yyBzCm3XTKWH%2F-enginsight-screenshot-alerts-management-maintenance%20periods-add%20maintenace%20period-schedule.jpg?alt=media&amp;token=5d82cca8-9e43-42e1-9e56-f663549b6d18" alt="" width="563"><figcaption></figcaption></figure></div>

The following options are available:

<table><thead><tr><th width="199.71484375">Option</th><th>Description</th></tr></thead><tbody><tr><td>Once</td><td>Select this option to schedule the maintenance period to run once.</td></tr><tr><td>Recurring</td><td>Select this option to run the maintenance period regularly at a custom interval.</td></tr></tbody></table>

<i class="fa-shuffle">:shuffle:</i> Different fields are shown depending on whether you select the options [Once](#once) or [Recurring](#recurring).

{% tabs %}
{% tab title="Once" %} <i class="fa-eye">:eye:</i> These fields are only shown when you select the option **Once**.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FprkRvozRF7jspQtKYgyL%2F-enginsight-screenshot-alerts-management-maintenance%20periods-add%20maintenace%20period-schedule-tab%20once.jpg?alt=media&amp;token=b0e32c9a-f8f9-4298-9793-f14d4df223c8" alt="" width="563"><figcaption></figcaption></figure></div>

The following options are available:

<table><thead><tr><th width="200.37890625">Option</th><th>Description</th></tr></thead><tbody><tr><td>Start Time</td><td><p>Define the date and time, in your <em>browser's local time zone</em>, when the one-time maintenance period should begin.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The default start time is the time at which the maintenance period is created.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Start Time</strong> field to open the date picker. Select a date and time.</p></td></tr><tr><td>End Time</td><td><p>Define the date and time, in your <em>browser's local time zone</em>, when the one-time maintenance period should end.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>By default, the end time is set to one hour after the maintenance period is created.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>End Time</strong> field to open the date picker. Select a date and time.</p></td></tr><tr><td>Duration</td><td>Shows the duration of the one-time maintenance period based on the selected start and end times.</td></tr></tbody></table>

#### Date Picker

Here you can select the date and exact time in 24-hour format.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FoXBrzbN124BOoHsibNHW%2F-enginsight-screenshot-alerts-management-maintenance%20periods-add%20maintenace%20period-schedule-tab%20once-date%20picker.jpg?alt=media&amp;token=2dd5bc2a-007e-46f3-bf4f-42af356cfdb8" alt="" width="375"><figcaption></figcaption></figure></div>

<i class="fa-computer-mouse">:computer-mouse:</i> Select a date using the calendar.

<i class="fa-computer-mouse">:computer-mouse:</i> Use the dial to set an exact time in 24-hour format. First select the hour. The dial then switches to the minute view. Select the required minutes.
{% endtab %}

{% tab title="Recurring" %} <i class="fa-eye">:eye:</i> These fields are only shown when you select the option **Recurring**.

### Time Interval Selector

You have three options for defining a time interval. The different options are available via tabs:

* [Tab: Time](#time)
* [Tab: Interval](#interval)
* [Tab: Expert Mode](#expert-mode)

{% tabs %}
{% tab title="Time" %}
Here you can define a specific time in your browser’s local time zone and the days of the week on which the respective time period starts.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2F9nc1qge2rN5TB0Kv3X2b%2F-enginsight-screenshot-alerts-management-maintenance%20periods-add%20maintenace%20period-schedule-tab%20recurring-time.jpg?alt=media&amp;token=13a92235-ddea-47b3-b4b0-7899544ec41f" alt="" width="563"><figcaption></figcaption></figure></div>

The following options are available:

<table><thead><tr><th width="199.62109375">Option</th><th>Description</th></tr></thead><tbody><tr><td>Time</td><td><p>Use the dial to set an exact time in 24-hour format.</p><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Time</strong> field to open the time picker.</p><p></p><p><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2F7c4qNQRtzhX18ZustEZc%2FEnginsight-EN-Time%20Interval%20Selection-Clock%20Dial.jpg?alt=media&amp;token=b41b9398-7826-4c49-a89a-4c6292eb081b" alt=""></p><p></p><p>First select the hour. The dial then switches to the minute view. Select the required minutes.</p></td></tr><tr><td>Time Zone</td><td>Define the time zone that should apply to the respective time period.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Click the displayed time zone to open a list of available time zones and select one.</td></tr><tr><td>Days of the Week</td><td>Define the days of the week on which the respective time period should apply.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Click one or more days of the week to select them. Click a selected day again to deselect it.</td></tr><tr><td>Next Execution</td><td>Shows the date and time of the next execution of the respective time period in your <em>browser’s</em> <em>local time zone</em>.</td></tr><tr><td>Duration (Minutes)</td><td><p>Define the duration of the time period in minutes.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The default duration is <strong>60 minutes</strong>.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Duration (Minutes)</strong> field and enter a value. Alternatively, use the <i class="fa-angle-up">:angle-up:</i> and <i class="fa-angle-down">:angle-down:</i> buttons to increase or decrease the value.</p></td></tr></tbody></table>
{% endtab %}

{% tab title="Interval" %}
Here you can define the interval at which the time period should run regularly.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FSu2iVVtTYJ51vn1XHTVp%2F-enginsight-screenshot-alerts-management-maintenance%20periods-add%20maintenace%20period-schedule-tab%20recurring-interval.jpg?alt=media&amp;token=73c30dc6-1923-46ad-85c4-cb2f07871f72" alt="" width="563"><figcaption></figcaption></figure></div>

The following options are available:

<table><thead><tr><th width="200.1796875">Option</th><th>Description</th></tr></thead><tbody><tr><td>Interval</td><td>Define the interval at which the respective time period should be run.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Interval</strong> field to open a list of all available intervals and select an interval from the list.</td></tr><tr><td>Duration (Minutes)</td><td><p>Define the duration of the time period in minutes.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The default duration is <strong>60 minutes</strong>.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Duration (Minutes)</strong> field and enter a value. Alternatively, use the <i class="fa-angle-up">:angle-up:</i> and <i class="fa-angle-down">:angle-down:</i> buttons to increase or decrease the value.</p></td></tr></tbody></table>
{% endtab %}

{% tab title="Expert Mode" %}
Here you can use a cron expression to define the interval at which the respective time period should be run regularly.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2F7NgRhKPb56L66fKD9hV5%2F-enginsight-screenshot-alerts-management-maintenance%20periods-add%20maintenace%20period-schedule-tab%20recurring-expert%20mode.jpg?alt=media&amp;token=6b4c0573-3520-4f89-9ba1-37f6d749cc19" alt="" width="563"><figcaption></figcaption></figure></div>

The following options are available:

<table><thead><tr><th width="199.64453125">Option</th><th>Description</th></tr></thead><tbody><tr><td>Cron Expression (Vixie / Unix)</td><td><p>Shows the defined interval for the regular execution of the respective time period as a cron expression. The displayed cron expression updates automatically as soon as you set a time interval manually.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Cron Expression</strong> field to <a href="https://docs.enginsight.com/docs/manual/english/appendix/angabe-von-cron-ausdruecken.md">edit the cron expression directly</a>.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Expand</strong> icon <i class="fa-arrow-up-right-and-arrow-down-left-from-center">:arrow-up-right-and-arrow-down-left-from-center:</i> to open a new window where you can configure the cron expression manually using a time picker.<br></p><p><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2F51Z9vj8rVtvpPUCaA9vA%2F-enginsight-screenshot-alerts-management-maintenance%20periods-add%20maintenace%20period-schedule-tab%20recurring-expert%20mode-cron%20expression.jpg?alt=media&amp;token=a31d82d9-36a9-4d67-8a44-b9a6bef4017d" alt=""></p></td></tr><tr><td>Description</td><td>Shows the defined interval for the regular execution of the respective time period in plain language.</td></tr><tr><td>Time Zone</td><td>Define the time zone that should apply to the respective time period.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Click the displayed time zone to open a list of available time zones and select one.</td></tr><tr><td>Next Execution (Local Time Zone)</td><td>Shows the date and time of the next execution of the respective time period in your <em>browser’s</em> <em>local time zone</em>.</td></tr><tr><td>Duration (Minutes)</td><td><p>Define the duration of the time period in minutes.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The default duration is <strong>60 minutes</strong>.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Duration (Minutes)</strong> field and enter a value. Alternatively, use the <i class="fa-angle-up">:angle-up:</i> and <i class="fa-angle-down">:angle-down:</i> buttons to increase or decrease the value.</p></td></tr></tbody></table>
{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}

***

## Importing Maintenance Periods

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Add Maintenance Period** in the upper-right corner of the [maintenance periods overview](https://docs.enginsight.com/docs/manual/english/platform-usage/alerts/management/maintenance-periods.md#maintenance-periods-overview) and select <i class="fa-up-from-line">:up-from-line:</i> **Import** from the submenu that opens to import maintenance periods.

The **Import Maintenance Periods** window opens.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FJhNyHIK6XofTRNOB1Abv%2Fenginsight-screenshot-alerts-management-maintenance%20periods-add%20maintenace%20period-import.jpg?alt=media&amp;token=7772af80-7ae9-4142-875f-fbce738be1f3" alt="" width="375"><figcaption></figcaption></figure></div>

<i class="fa-computer-mouse">:computer-mouse:</i> Click in the window to select a ZIP file from your device that contains the objects intended for import. Alternatively, drag and drop a ZIP file into the window to validate it and prepare it for import.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2F6knKBD0IlyDkFDYkhZo9%2Fenginsight-screenshot-alerts-management-maintenance%20periods-add%20maintenace%20period-import%20window.jpg?alt=media&amp;token=2904e6c2-6104-4984-b418-000eb772762b" alt="" width="563"><figcaption></figcaption></figure></div>

Once validation is complete, you will see whether the file to be imported matches the expected format and how many objects can be imported. The following import options are available:

<table><thead><tr><th width="200.55078125">Option</th><th>Description</th></tr></thead><tbody><tr><td>Create New</td><td>Select this option to create a new entry for each imported object.</td></tr><tr><td>Update</td><td>Select this option to update existing objects during import. All other imported objects will be added as new entries.</td></tr><tr><td>Skip</td><td><p>Select this option to skip objects that already exist. All other imported objects will be added as new entries. </p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This option is selected by default.</p></div></td></tr></tbody></table>

<i class="fa-computer-mouse">:computer-mouse:</i> Click **Import** to start importing the file. Once the import is complete, you can find the newly added objects in the corresponding list overview.

<i class="fa-computer-mouse">:computer-mouse:</i> Click **Abort** to return to the list overview.

***
