Managing deployment windows

Deployment windows are special calendar events for allowing or preventing application deployment to specific environments. Based on their deployment policy, there are two types of deployment windows:

• Allow deployment windows: Users can access associated environments only during the allow deployment windows. You can create allow deployment windows only for environments with the closed deployment policy. In a request with a closed environment, make sure that the planned start date and time and the estimated duration for the request matches the selected deployment window.
• Prevent deployment windows: Users cannot access associated environments during the prevent deployment window. You can create prevent deployment windows only for environments with the opened deployment policy. In a request with an opened environment, make sure that the planned start date and time and estimated duration for the request does not overlap with any deployment window.

You can create a deployment window series with one-time deployment window event or a deployment window series with recurring deployment window events. For a recurring deployment window series, various settings are available:

• Daily, weekly, and monthly deployment windows frequency settings
• Duration and date and time settings for deployment window occurrences
• Start and end date for the whole series.

You can edit deployment window events for a single environment, including moving, suspending, and resuming the deployment window event.

Users can see deployment windows on the calendar based on their user roles and environment access permissions.

For allow deployment windows, you can create a request from the request template and schedule this request for the appropriate deployment window event.

To manage deployment windows, you can perform the following actions:

• • • To create a new one-time deployment window series
    • To create a new recurring deployment window series
    • To edit a deployment window series from metadata
    • To edit a deployment window series from calendar report
    • To suspend a deployment window event from the metadata
    • To suspend a deployment window event from the calendar report
    • To suspend the deployment window event from the metadata
    • To resume the suspended deployment window event from the calendar report
    • To move the deployment window event from metadata
    • To move the deployment window event from the calendar report
    • To create a request for the allow deployment window from metadata
    • To create a request for the allow deployment window from a calendar report
    • To see a list of requests associated with the deployment window series
    • Related topics

To create a new one-time deployment window series

1. Go to Environments > Metadata > Manage Deployment Windows.

2. Based on the deployment policy for deployment windows, click one of the following links:

   • Click Create Allow Deployment Window on the right

   • Click Create Prevent Deployment Window on the right.
3. In Name, enter a name for the deployment window.
4. In Start and Finish, enter the appropriate values for date and time when the deployment window begins and ends.
5. Ensure that the Recurring check box is not selected.
6. Click Add Environments.

7. From the Environments list, select environments to associate with the deployment window.

   Note

   You can use the search string at the top of the environments list to find the needed environment

8. Click Select Environment to save your environments selection.
9. Click Create to save your deployment window.

To create a new recurring deployment window series

1. Go to Environment > Metadata > Manage Deployment Windows.
2. Based on the deployment policy for deployment windows, select one of the following options:
   • Click Create Allow Deployment Window on the right.
   • Click Create Prevent Deployment Window on the right.
3. In Name, enter a name for the deployment window series.
4. Select the Recurrent check box.
5. In Start and Finish, enter the appropriate date and time when the deployment window begins and ends.
6. From Frequency list, select Set schedule.
    The Frequency dialog box opens.
7. From the Type list, select one of the following options:
   • Select Daily for a daily recurrence, and then enter the interval in days for the deployment window recurrence.
   • Select Weekly for a weekly recurrence, then select week days and enter interval in weeks for the deployment window recurrence.
   • Select Monthly for a monthly recurrence, enter the interval in months for the deployment window recurrence, and then select one of the following monthly recurrence types:
     • Select Day of month, and then select dates of the month for the deployment window recurrence.
     • Select Day of week, and then select days of the week for the whole month for the deployment window recurrence.
8. Click Set to save your deployment windows recurrence settings.
9. In From and To, enter the appropriate time of the day when the deployment window events begin and ends.

10. In Duration, enter the duration in days for the single event of the deployment window series.

    Note

    Duration adds the specified number of days to the deployment window single occurrence time frame. For example, if  in Duration, you enter 1,  the deployment window occurrence is extended by 24 hours.

11. Click Add Environments, and then from the new dialog box opened, select environments to associate with the deployment window series.

    Note

    You can use the search string at the top of the environments list to find the needed environment

12. Click Select Environment to save your environments selection.

13. Click Create to save your deployment window series.

    Note

    When you create a deployment window series, the list of events for this deployment window is created by the background process. You can see the complete list of events for the deployment windows series after a certain time period, depending on the number of deployment window events. To see the list of events in the deployment window series, go to Environment > Metadata > Manage Deployment Windows, and then click Occurrences at the right of the deployment window name.

To edit a deployment window series from metadata

1. Go to Environments > Metadata >Manage Deployment Windows.
2. From the deployment windows list, click Edit for the appropriate deployment window.
3. Make changes to the deployment window series as necessary.
4. Click Update to save your changes.

To edit a deployment window series from calendar report

1. Go to Plans > Calendars
2. On the right, from the Select calendar list, click Deployment Windows Calendar.
3. Click the appropriate deployment window event on the calendar, and then click Edit from the dialog box opened.
   The Edit Deployment Window dialog box opens.
4. From the Edit Deployment Window dialog box, click Edit Series.
5. Make changes to the deployment window as necessary.
6. Click Update to save your changes.

To suspend a deployment window event from the metadata

1. Go to Environments > Metadata > Manage Deployment Windows.
2. From the deployment windows list, select the appropriate deployment window series.
3. Depending on the deployment window series type, complete the following actions:
   • For a one-time deployment window series, from the Environments column, click the environment that you want to suspend.
   • For recurring deployment windows series:
     1. Click Occurrences for the appropriate deployment window series.
     2. From the Occurrences list, select the appropriate deployment window series event.
     3. From the Environments column, click the environment that you want to suspend.
4. From the dialog box opened, click Edit.
   The Edit Deployment Window dialog box opens.
5. From the Edit Deployment Window dialog box, click Suspend/Resume.
   The Suspend Deployment Window dialog box opens.
6. In the Reason text box, enter the reason to suspend the deployment window event.
7. Click Suspend.

To suspend a deployment window event from the calendar report

1. From Plans > Calendars, click Deployment Windows Calendar on the right.

2. On the Deployment Windows Calendar Report,  select the appropriate environment, and then click the deployment window event that you want to suspend.

   Tip

   Use filters at the top of Deployment Windows Calendar Report to find the appropriate environment.

3. From the dialog box opened, click Edit.
   The Edit Deployment Window dialog box opens.
4. From the Edit Deployment Window dialog box, click Suspend/Resume.
   The Suspend Deployment Window dialog box opens.
5. In the Reason text box, enter the reason to suspend or resume the deployment window event.
6. Click Suspend.

To suspend the deployment window event from the metadata

1. Go to Environments > Metadata > Manage Deployment Windows.
2. From the deployment windows list, select the appropriate deployment window series.
3. Depending on the deployment window series type, complete the following actions:
   • For a one-time deployment window series, from the Environments column, click the environment that you want to suspend.
   • For recurring deployment windows series:
     1. Click Occurrences for the appropriate deployment window series.
     2. From the Occurrences list, select the appropriate deployment window series event.
     3. From the Environments column, click the environment that you want to suspend.
4. From the dialog box opened, click Edit.
   The Edit Deployment Window dialog box opens.
5. From the Edit Deployment Window dialog box, click Suspend/Resume.
   The Resume Deployment Window dialog box opens.
6. In the Reason text box, enter the reason to resume the deployment window event.
7. Click Resume.

To resume the suspended deployment window event from the calendar report

1. From Plans > Calendars, click Deployment Windows Calendar on the right.

2. On the Deployment Windows Calendar Report, select the appropriate environment, and then click the deployment window event that you want to resume.
   
   

   Tip

   Use filters at the top of Deployment Windows Calendar Report to find the appropriate environment.

3. From the dialog box opened, click Edit.
   The Edit Deployment Window dialog box opens.
4. From the Edit Deployment Window dialog box, click Suspend/Resume.
   The Resume Deployment Window dialog box opens.
5. In the Reason text box, enter the reason to resume the deployment window event.
6. Click Resume.

To move the deployment window event from metadata

1. Go to Environments > Metadata > Manage Deployment Windows.
2. From the deployment windows list, select the appropriate deployment window series.
3. Depending on the deployment window series type, complete the following actions:
   • For a one-time deployment window series, from the Environments column, click the environment that you want to suspend.
   • For recurring deployment windows series:
     1. Click Occurrences for the appropriate deployment window series.
     2. From the Occurrences list, select the appropriate deployment window series event.
     3. From the Environments column, click the environment that you want to suspend.
4. From the dialog box opened, click Edit.
   The Edit Deployment Window dialog box opens.
5. From the Edit Deployment Window dialog box, click Move.
6. In the Move Deployment Windowdialog box:
   1. Specify new Start At and Finish At date and time.
   2. In the Reason text box, enter the reason to reschedule the deployment window event.
7. Click Move to save your changes.

To move the deployment window event from the calendar report

1. Go to Plans > Calendars > Deployment Windows Calendar

2. On the Deployment Windows Calendar Report, select the appropriate environment, and then click the deployment window event that you want to reschedule.
   
   

   Tip

   Use filters at the top of Deployment Windows Calendar Report to find the appropriate environment.

3. From the dialog box opened, click Edit.
4. From the Edit Deployment Window dialog box, click Move.
5. In the Move Deployment Window dialog box:
   1. Enter new date and time for Start At and Finish At.
   2. In the Reason text box, enter the reason to reschedule the deployment window event.
6. Click Move to save your changes.

To create a request for the allow deployment window from metadata

1. Go to Environments > Metadata > Manage Deployment Windows.
2. From the deployment windows list, select the appropriate deployment window series.
3. Depending on the deployment window series type, complete the following actions:
   • For a one-time deployment window series, from the Environments column, click the environment that you want to suspend.
   • For recurring deployment windows series:
     1. Click Occurrences for the appropriate deployment window series.
     2. From the Occurrences list, select the appropriate deployment window series event.
     3. From the Environments column, click the environment that you want to suspend.
4. From the new dialog box opened, click Schedule request.
5. In the Schedule Request dialog box, specify the following parameters for the request:
   1. In Name, enter the name for the request.
   2. From the Plan list, select the plan for your request.
   3. From the Stage list, select the plan stage for your request.
   4. From the Application list, select the application for the request.
   5. From the Estimate list, select the estimated time for the request.
   6. In Planned Start, enter the start date and time for the request.
   7. From the Request template list, select the template for your request.
6. Click Schedule to save the request.

To create a request for the allow deployment window from a calendar report

1. From Plans > Calendars, click Deployment Windows Calendar on the right

2. On the Deployment Windows Calendar Report, for the appropriate environment, click the deployment window occurrence for which you want to schedule a request.

   Tip

   Use filters at the top of the Deployment Windows Calendar Report window to find the appropriate environment.

3. From the dialog box opened, click Schedule request.
4. In the Schedule Request dialog box, specify the following parameters for the request:
   1. In Name, enter the name for the request.
   2. From the Plan list, select the plan for your request.
   3. From the Stage list, select the plan stage for your request.
   4. From the Application list, select the application for the request.
   5. From the Estimate list, select the estimated time for the request.
   6. In Planned Start, enter the start date and time for the request.
   7. From the Request template list, select the template for your request.
5. Click Schedule to save the request.

To see a list of requests associated with the deployment window series

1. Go to Environments > Metadata > Manage Deployment Windows.
2. From the deployment windows list, select the appropriate deployment window series.
3. Click Active Requests for the selected deployment window series.
   The list of request associated with the deployment window series opens.

Related topics

Deployment-Windows-report

Managing-requests

Managing-environments