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 match 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 the estimated duration for the request do not overlap with any deployment window.

This topic consists of the following sections:

• • Creating a deployment window series
  • Editing a deployment window series
  • Changing the status of a deployment window series
  • Suspending and resuming a deployment window event
  • Rescheduling a deployment window series event
  • Creating a request for the allow deployment window
  • Viewing requests associated with a deployment window series

Creating a deployment window series

You can create a deployment window series with a one-time deployment window event or with recurring deployment window events. For a recurring deployment window series, you configure the following settings:

• 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

To create a deployment window series

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

2. Based on the deployment policy for deployment windows,at the right side, click one of the following:

   • Create Allow Deployment Window

   • Create Prevent Deployment Window
3. In the Name box, enter a name for the deployment window.
4. In the Start and Finish boxes, enter the date and time when the deployment window begins and ends.
5. (Optional) To create a recurring deployment window series, do the following:
   1. Select the Recurrent check box.
   2. In the Frequency list, select Set schedule.
   3. In the Frequency dialog box, in the Type list, select one of the following:
      • Daily: for the deployment window series to occur on a daily basis, and then indicate the time interval in days (for example, every 2 days).
      • Weekly: for the deployment window series to occur on a weekly basis and then provide the following information:
        
        • Indicate the time interval in weeks (for example, every 2 weeks).
        • Click the day or days of the week when the deployment window series will occur.
      • Monthly: for the deployment window series to occur on a monthly basis, indicate the time interval in months (for example, every 2 months), and then do one of the following:
        
        • Select Day of month, and then select the day or days of the month when the deployment window series will occur.
        • Select Day of week, and then select the day or days in the weeks of the month when the deployment window series will occur.
   4. To save your recurrence settings, click Set.
   5. In From and To, specify the time of the day when the deployment window series will begin and end.

   6. In the Duration list, select the number of days for which you want to extend the deployment window series occurrence.

      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.

6. Click Add Environment, and then, in the Select Environments dialog box, do the following:

   1. In a list on the left, select the environments that you want to associate with the deployment window, and then click >.

      Note

      The list displays environments of the following deployment policies:

      • Closed for the Allow Deployment Window series
      • Opened for the Prevent Deployment Window series
   2. To save your environments selection, click Select Environments.
7. To save the deployment window, click Create.

8. (Optional) To make the deployment window available for other users, in the Actions column, change its status to other than Draft.
   
   For more information see Using-status-of-objects .

   Note

   When you create a deployment window series, a list of events for the deployment window is created by a 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.

_{Back to top}

Editing a deployment window series

You can edit a deployment window series from the metadata or from the calendar report. The following options are available:

• Move
• Suspend/Resume
• Edit series

Choosing the Edit series option allows you to make changes to the deployment window event for a single environment.

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

To edit a deployment window series from metadata

1. Go to Environments > Metadata > Manage Deployment Windows.
2. In the deployment windows list, in the Actions column, click Edit next to the appropriate deployment window.
3. Modify the deployment window series as required.
4. To save your changes, click Update.

To edit a deployment window series from the calendar report

1. Go to Reports > Calendars.
2. In the Select calendar list at the right side, click Deployment Windows Calendar.
3. Click the appropriate deployment window event in the calendar, and then click Edit in the dialog box that opens.
4. In the Edit Deployment Window dialog box, click Edit Series.
5. Modify the deployment window as required.
6. To save your changes, click Update.

_{Back to top}

Changing the status of a deployment window series

You can use the status of a deployment window series to manage the ability of users to access and use the deployment window. The states available depend on a current state of the deployment window. For example, if the current state is Draft, you can change the state to Pending; if the current state is Pending, you can change the state to Draft or Released. For more information, see Using-status-of-objects.

To change the status of a deployment window series

1. Go to Environments > Metadata > Manage Deployment Windows.
2. In the deployment windows list, locate the appropriate deployment window series and its corresponding status.
3. In the Actions column, click the required status.

Suspending and resuming a deployment window event

You can suspend and resume a deployment window series from the metadata or from the calendar report. The following options are available:

• Move
• Suspend/Resume
• Edit Series

Choosing the Suspend/Resume option allows you to suspend or resume a deployment window event for a single environment.

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

To suspend or resume a deployment window event from the metadata

1. Go to Environments > Metadata > Manage Deployment Windows.
2. In 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, in the Environments column, click the environment that you want to suspend or resume.
   • For a recurring deployment windows series:
     1. Click Occurrences for the appropriate deployment window series.
     2. In the Occurrences list, locate the appropriate deployment window series event.
     3. In the Environments column, click the environment that you want to suspend or resume.
4. Click Edit.
5. In the Edit Deployment Window dialog box, click Suspend/Resume.
6. In the Suspend (or Resume) Deployment Window dialog box, in the Reason box, enter the reason to suspend or resume the deployment window event.
7. Click Suspend or Resume.

To suspend or resume a deployment window event from the calendar report

1. Go to Reports > Calendars, and then click Deployment Windows Calendar at the right side.

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

   Tip

   You can use filters at the top of Deployment Windows Calendar Report to find the appropriate environment.

3. Click Edit.
4. In the Edit Deployment Window dialog box, click Suspend/Resume.
5. In the Suspend (or Resume ) Deployment Window dialog box, in the Reason box, enter the reason to suspend or resume the deployment window event.
6. Click Suspend or Resume.

_{Back to top}

Rescheduling a deployment window series event

You can reschedule a deployment window series event from the metadata or from the calendar report. The following options are available:

• Move
• Suspend/Resume
• Edit Series

Choosing the Move option allows you to move a deployment window event for a single environment.

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

To move a deployment window event from metadata

1. Go to Environments > Metadata > Manage Deployment Windows.
2. In the deployment windows list, locate the appropriate deployment window series.
3. Depending on the deployment window series type, do one of the following:
   • For a one-time deployment window series, in the Environments column, click the environment that you want to move.
   • For a recurring deployment windows series:
     1. Click Occurrences for the appropriate deployment window series.
     2. In the Occurrences list, locate the appropriate deployment window series event.
     3. In the Environments column, click the environment that you want to move.
4. Click Edit.
5. In the Edit Deployment Window dialog box, click Move.
6. In the Move Deployment Window dialog box:
   

   1. Specify a new Start At and Finish At time.

      Note

       You cannot move the deployment window series event outside of the start and finish range for the series.

   2. In the Reason box, enter the reason to move the deployment window event.
7. To save your changes, click Move.

To move a deployment window event from the calendar report

1. Go to Plans > Calendars > Deployment Windows Calendar.

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

   Tip

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

3. Click Edit.
4. In 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 box, enter the reason to move the deployment window event.
6. To save your changes, click Move.

_{Back to top}

Creating a request for the allow deployment window

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

To create a request for the allow deployment window from metadata

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

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

1. Go to Reports > Calendars.
2. On the right pane, click Deployment Windows Calendar.
3. On the Deployment Windows Calendar Report page, perform the following steps:

   1. Locate the appropriate environment.

      Tip

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

   2. Click the corresponding deployment window event for which you want to schedule a request.
   3. Click Schedule Request.
4. In the Schedule Request dialog box, specify the following parameters for the request:
   1. In the Name box, enter the name for the request.
   2. In the Plan list, select the plan for your request.
   3. In the Stage list, select the plan stage for your request.
   4. In the Application list, select the application for the request.
   5. In the Estimate list, select the estimated time for the request.
   6. In Planned Start, enter the start date and time for the request.
   7. In the Request template list, select the template for your request.
5. To save the request, click Schedule.

Viewing requests associated with a deployment window series

You can view a list of active requests that are associated with a deployment window series.

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

1. Go to Environments > Metadata > Manage Deployment Windows.
2. In the deployment windows list, locate the appropriate deployment window series, and then click Active Requests at the right side.

_{Back to top}