Add Or Edit Environments

Users can add and edit Environments on the Environment Manager page. Users can also duplicate environments.

Details Tab

To add or edit an Environment:

Users must have the Update Environment user permission.  

  1. Add:
    1. By + New:
      1. Go to + New > Environment > Manager.
        Administrators can use Title Names Customization to customize the name of the Environment module where it appears throughout Plutora.
    2. By Environment Manager:
      1. Go to Environment > Manager:
      2. Click + New Environment.
  2. Edit:
    1. Go to Environment > Manager.
    2. Click an Environment Name.
  3. Click the Contact stakeholders:
    1. Choose one of the following:
      1. To send the email to all the Stakeholders click to select the Send to all Stakeholders radio button.
      2. To select from a list of Stakeholders who will receive the email, click to select the Send to selected Stakeholders radio button:
        1. Click the combo box and click to select the checkboxes of the Stakeholders you would like to email.

          Stakeholders are listed from the selected Environment and any related Environment Group. 
    2. Type a single email address into the From field. (Mandatory field.)
    3. Type an email Subject.
    4. Type an email Body.
    5. Click Send.
  4. Fill in the Environment Definition form:
    1. Type an Environment Name.
    2. Add or edit Description.
    3. Select a System from the System drop-down menu:
      • The System’s My Environment Booking approvers are listed in a clickable tooltip under the System drop-down menu so users know which person to ask for permission to use the System.
      • Administrators can prevent users from selecting Systems outside their Portfolio Association by selecting the My Portfolio Association checkbox for the Restrict Site-Wide View of Environments user permission.
      • Once you have selected a System, you can select a Build that is linked to that System. See Manage Builds.
    4. Select a Build:
    5. Select an Integrated Environment Group from the Integrated with menu or:
      Integrated Environment Groups can be toggled on Environment Map.

      1. Select an existing Environment Group from the drop-down menu.
        Administrators can prevent users from selecting Environment Groups outside their Portfolio Association by selecting the My Portfolio Association checkbox for the Restrict Site-Wide View of Environments user permission
      2. Create a new Environment Group for the Environment:
        1. Click  and see Manage Environment Groups for the procedure.
    6.  Type the URL.
    7. Select Used for Phase.
      This menu is customized in Used For Phase Customization.
    8. Select a Scheduler Display color or type a Hex color to choose the color that is displayed in Environment Schedule.
    9. Type a Vendor.
    10. Manage Linked Environments:
      Linking Environments enables users to select a parent Environment in a TEBR (with or without a Release) or an Enterprise, Project, or Independent Release and drag and drop the Environment, its Child, and Grandchild Environments all at once.

      1. Add a Linked Environment:

        To enable Linked Environments, go to Environment Setup Customization. Environments already selected but outside the user’s Portfolio Association will be hidden if administrators select the My Portfolio Association checkbox for the Restrict Site-Wide View of Environments user permission. Environments outside the user’s Portfolio Association will also not be available for selection.

        1. Click a green cross.
        2. Click the combo menu and click to select one or more of the Environment checkboxes.
        3. Click Save & Close.
      2. Apply Parent Environment Status to Child Environments:
        1. Click Apply Status to all Children.

          The Apply Status to all Children button provides a one-off Environment Status push. If you change the Parent Environment status again, the Child Environments will not automatically update and you will need to click Apply Status to all Children again.

      3. Remove an Environment link:
        1. Hover your mouse cursor over the blue Environment link until the delete button appears.
        2. Click Red delete button linked changes.
    11. Click to select an Environment Status.
      This menu is customized in Status Customization
    12. Click to select an Icon:
      • Icons are displayed in the Environment Map and provide an extra layer of information about the Environment.
      • For example, whether the Environment is a Cloud Server.
    13. Click to select the This is a Shared Environment checkbox if the Environment can be booked multiple times simultaneously.
    14. Click to select the Any booking will be automatically approved checkbox to automatically approve any booking of an Environment, whether booked from a TEBR (with or without a Release) or a Release (Enterprise, Project, or Independent). The booking will stay in an approved state even if the dates of the booking are changed.
    15. Manage booking alerts:

      Booking alerts pop up to provide a user with extra information when they try to book the Environment.

      1. Click to select the Display booking alert checkbox to make the alert pop up appear.
        If you cannot see this checkbox, use the scrollbar to scroll down.
      2. Type the Message that will appear in the pop up.
  5. Manage the Health Check Dashboard status for this Environment:

    Health Check Dashboard provides a view of the health of selected Environments, both now and over the previous 24 hours, and their associated TECRs and TEBRs.

    1. Select the Enable Health Check checkbox in Environment Setup Customization first.
    2. See the Swagger article for how to generate a token and use Swagger to access Plutora’s external APIs.
    3. Use the following API endpoints to update your Health Check Status:
      • POST /environmentHealthCheck
        • Populates the data in the Environment Health Check panel and Health Check Dashboard.
        • Include the following data:
          • Test Name.
          • Status.
          • An optional Log File or Test File as a text file attachment.
      • POST /environmentHealthCheck/FullHistory
      • POST /environmentHealthCheck/CurrentStatus
    4. Any health status recorded in Plutora will only be valid for a 24-hour period. If no updates are received within a 24 hour period, the current status will default back to No Data.
    5. When no data is present, the Environment Health Check panel looks like this:
  6. View the configured Health Check Dashboard information:
    1. View the Environment status:
      • NO DATA: No data has been provided via the API.
      • ONLINE: The Environment is online.
      • OFFLINE: The Environment is offline.
      • ISSUE: The Environment is neither online nor offline but has an issue.
    2. Click Refresh to get the latest statuses.
  7. Fill in the Technical Specs and Configuration form. For more information, see Manage Technical Specs and Configuration.
  8. Check the Environment Allocation Schedule:
    • The previous Environment Allocation Schedule panel, which only showed bookings for Releases and TEBRs with a Release, has been replaced by a button.
    • The button is only clickable when editing an Environment.
    • Clicking the button:
      • Opens the Environment in Environment Schedule’s Environment View with:
        • The Grouping set to None.
        • The Timeline set from now to six months’ time.
      • Shows all bookings for that Environment, not just Release-related bookings.
  9. Click Save.

Additional Information Tab

The Additional Information tab contains custom fields, which administrators have added using Environment Custom Fields Customization. These fields will vary between each Plutora installation. Please consult your administrator for the procedure for filling in these fields.

If a user lacks permission to see a custom field tab’s fields, that tab will now be hidden for that user. (The permission is set in Release Custom Fields Customization.)

  1. Click Additional Information tab.
  2. Fill in the fields.
  3. Click Save when you have finished.
  4. Click Stakeholders tab.

Stakeholders Tab

Add and manage stakeholders for the Environment in the ‘Stakeholders’ tab. For details, see Manage Environment Stakeholder.

Linked Items Tab

See the TECRs and TEBRs associated with this Environment. Filter your linked TECRs and TEBRs by clicking the View by radio buttons.

Automated Jobs Tab

The Automated Jobs tab displays the list of automated jobs that are linked to that Environment’s System. The list can only be managed from the System.

Parameters are managed at the TECR level, so any changes to the parameters in the Environment will not be used.

Click View Execution History to see all the automated job execution logs for that Environment, including every associated TECR and Deployment Activity job.

See Orchestration Using Automated Jobs, Setting Up Jenkins Integration, and Continuous Delivery Pipeline for more information.

Save & Close

  1. Click Save & Close.

View Audit History

Click the clock-shaped button  to view the Audit History of the record. To see more information about Audit History, click here.

Copy URL to Clipboard

Users can copy an Environment’s URL to the clipboard by clicking the Copy to Clipboard  button on the top right of the pop up.

Related Articles


Be the first to find out about new features. Subscribe to the Release Notes email.

Was this article helpful?

Thanks for your answer!