Logical Groups (LG's) may be used to group instances, databases and AutoScale Groups/Managed Groups within a single bundle of resources. This gives you more options when managing resources that normally work together, such as stacks and databases.
The logical group also lets you define a start and stop delay for individual resources within the group, allowing you to start certain resources first (such as databases), and giving them time to become stable before starting other resources. The resources assigned to a Logical Group must all be in the same AWS, Azure, Google Compute Platform (GCP), or Alibaba account.
For example, let's say that a logical group has been set up with three individual resources for the same AWS account and the start delays have been set to 0, 2, and 4. With logical groups, the resources (i.e. group members) will be started accordingly:
- Resource 1 - At the scheduled start time.
- Resource 2 - 2 minutes after the scheduled start time.
- Resource 3 - 4 minutes after the scheduled start time.
The same would be true if delays are set up for the stopping of grouped resources. By using logical groups, you are able to define the sequence of all included resources and configure delays accordingly. A logical group may be toggled on or off, parked, and managed just as single resources are in ParkMyCloud.
Creating Logical Groups in ParkMyCloud
Logical groups are created by viewing and selecting resources on the Resources screen. The selected resources cannot have the override only or never park restrictions (see Policy Management). If they do, then the options for creating a logical group or adding the selected instance(s) to an existing logical group will not be available on the Resources screen.
To set up a logical group, the first step will be to select the resources you want to be included as part of that group. This can be done by ticking the checkbox for each desired instance within the Bulk Column on the Resources screen. Then click on Group in the toolbar at the top of the Resources menu to begin setting up a logical group.
For this example, we will be grouping three AWS instances into a logical group; however, more or less can be chosen as long as they belong to the same AWS, Azure, Google Compute Platform (GCP), or Alibaba account. If no instances are selected or instances belonging to different providers are selected, then the Group option will be grayed out.
If the resource is restricted by a policy (see policy management) then it cannot be added to the logical group until the restrictions have been lifted. The Group option will be unavailable on the screen.
After clicking on Group, the following screen will appear and can be used to view current groups, create a new logical group, or to add instances to an existing group.
In this example, no logical groups exist and one must be set up in ParkMyCloud. Click on Create New Group to begin setting up your logical group for the chosen resources.
The create group screen provides several options for creating and working with logical groups in ParkMyCloud. It displays the current state of the logical group as well as each resource that is part of the group. Options are provided viewing / managing resources within the logical group, setting start/stop delays, viewing tags for each resource, and removing individual resources from the group.
When adding a group, the selected resources and available options will appear as shown below. You will need to enter a Name for the group. The name is required and will be displayed on the Resources screen. Make certain it is something recognizable because every user who has the appropriate permissions will be able to see the group in the resources list.
Next, you may configure restrictions for the resources within the logical group. No Restrictions is selected by default. Use the drop-down menu to make another selection (Never Park, or Schedule can only be overridden).
Next, you may configure the Start and Stop Delays for each instance within the logical group (i.e. group member). This allows the group members to be started and/or stopped in a defined sequence to ensure resources are available as they are needed. The maximum start/stop delay on instances is 59 minutes from the time of logical group scheduled start/stop.
To set up Start Delays, click on the field for each instance and enter a time in minutes. In the example below, the first server will start at the scheduled start time, the second will start 2 minutes after the scheduled start time, and the third will start 3 minutes after the scheduled start time. There are currently no stop delays configured.
A Stop Delay is not required to set up logical groups in ParkMyCloud. If no Stop Delay has been defined, then each group member will be stopped simultaneously at the scheduled stop time. However, when Stop Delays have been configured for a logical group, then the group members state will be changes to "stopped" in the defined sequence based on defined times in minutes. It is important to note that these are absolute times based on the scheduled stop times.
Click on the Stop Delay Field for each group member and then enter a number value to represent the delay in minutes. In the example below, the state change will occur in this manner:
- Resource 1 - Stop at scheduled stop time.
- Resource 2 - Stop 1 minute after the scheduled stop time.
- Resource 3 - Stop 2 minutes after the scheduled stop time.
Once the desired delays have been configured for each resource in the group, click on Save Changes at the top right of the screen to finish creating the logical group.
Click on the Back Button at the top left of the screen to exit the screen and return to the Resources Screen. You can also use this button to exit the screen and return to the resource list without creating the group.
If the Back Button is used and the group has not been saved, you will be prompted to either save or discard the changes.
Accessing and Viewing Logical Groups
Once a group has been created, you will be able to add instances to the group, remove instances from the group, and make configuration changes (set start and stop delays or change the name). The following actions may also be performed for a logical group:
- Toggle the Group's State
- Attach/Detach Parking Schedules
- Override Parking Schedules
To view logical groups currently set up in ParkMyCloud, select the Logical Groups Tab in the Resources Screen to view only those resources on the resources list. The state, team name, credential name, location, group name, and total cost will be displayed for each logical group.
The Filter option in the top right of the Resources screen can be used to find a specific logical group based on one or more configured filters.
Click on this field and enter a text value to view only logical groups matching the enter filter criteria. Use the X to remove the filter and view the entire list of logical groups again.
Click on the Down Arrow located to the right of the text field to access and use more specific filters based on the provided columns on the resources list.
Then click on a text field to enter text or use the provided drop-down menus to make a selection. Next, click on Search to filter the resources list. For this example, AWS has been chosen in the provider drop-down menu.
When filters have been set in the Resources list, the word Filtered will appear within the entry field. To remove the current filters, click on the X or you may click on the Down Arrow to configure different filters for the list.
Logical Group Details and Settings
Three icons can be found to the right of each group in the Resources Screen. The Tag Icon may be used to view any tags associated with the group and the Utilization Data Icon will be grayed out, as this icon is used to view utilization data for a resource and not a group of resources.
The Right Dive > Icon indicates that additional details may be viewed for the logical group. Clicking on a resource on the Resources screen will result in the screen diving right to show these additional details.
When resources are part of a logical group, they will no longer appear in other tabs within the Resources Screen. Instead, they will be displayed as the Logical Group they belong to. Click on the Logical Groups Tab to view logical groups within the Resources Screen.
To Dive Right > icon shows that additional information can be viewed for each Logical Group. Click anywhere except on the state toggles and action icons for the appropriate logical group in the Resources Screen. The screen will dive right to show additional information.
The following screen and information will appear within the Resources list. Here you can view information about each individual instance in the group including the instance name, ID, state, size, price, and location.
The Schedule Icon may be used to see if a schedule is currently attached to the resource and to change, attach, detach, or override a schedule for the group. Use the State Toggle to change the state of the logical group. Changes may also be made to the group name, resource configurations, etc. Click on the Back Button to return to the Resources screen.
The Recommendations Tab may be used to enable and disable SmartParking and Rightsizing recommendations for the Logical Group. Click on Details for the desired recommendation to view more information and to apply it.
Additionally, four more option icons will be present next to each instance in this pop-up window for Viewing Instance Utilization Data, Viewing Tags, Removing Resources from the Group, and Viewing Resource Details.
Click an icon to view additional information or to remove a resource from the group to view additional information about any instance currently included as part of the logical group.
Multiple Group Selections
The checkbox for each logical group in the Bulk Column may also be used to select multiple groups for performing a single action on them all at once.
For example, you can select multiple groups and attach a parking schedule to them, toggle the state, or move them to a different team all at the same time.
Adding Instances to a Logical Group
To add one or more instances to an existing logical group, first tick the checkbox next to each desired resource in the Bulk Column when viewing individual resources within the Resources Screen. Then click on Group within the toolbar.
In the pop-up window, logical groups will only be displayed for the resource type. For example, let's say two groups exist, but one is for AWS and the other is for GCP. if the selected resource is a GCP resource, then only the GCP logical groups will be displayed as a selection option.
Click on the appropriate radial to select the desired logical group. Then click on the Add Button to add the selected resources to the logical group.
The selected instance will appear highlighted in the configuration list and you can apply a Start and/or Stop Delay for the group member. Once finished, click on Save Changes to save the logical group configuration or the Back Button to exit without adding the instance to the group.
Removing Instances from a Logical Group
An instance (i.e. group member) may be removed from a logical group by first clicking on the Logical Group on the Resources Screen.
Then click on the Delete Icon (Trash Can) to the right of the appropriate instance to remove it from the logical group.
In this example, instance titled prod server 9006943 is being removed from the group. It will no longer appear in the configuration screen, but will remain a group member until you click on Save Changes at the top right of the screen. You may also click on Back Button to exit after saving the changes or to exit without saving the change.
The resource will now appear as an ungrouped resource when viewing the Resources Screen. To view individual resources, click on a tab (All, Computer, etc.) within the Resources Screen.
Removing Logical Groups from ParkMyCloud
A logical group can be removed from ParkMyCloud by viewing the configuration for your group. To access this screen, click on the group within in the Resources Screen.
Click on Delete Group to the left of the Save Changes option to remove the entire group from ParkMyCloud. This is helpful when the group contains a large number of resources because it allows you to simply remove the entire group rather than removing each individual resource.
Click on OK to to delete the selected group or Cancel to exit the confirmation message without removing the group form ParkMyCloud.
Making Group Configuration Changes
To access a group's configuration, click on the group within the Resources Screen. This will cause the screen to dive right and show additional details about the logical group in ParkMyCloud. Upon doing so, you will be able to view the group's current configuration and make any needed changes.
The resources list will appear as shown below when viewing the configuration of a selected logical group. Here, you can do perform the following actions:
- Alter the group's name.
- Change the Start and Stop Delays for each resource in the group.
- Remove group resources as needed.
- Attach, detach, or change schedules for the group.
- Toggle the group's state.
Once finished, click on Save Changes to save your changes to the group or the Back Button to exit without saving the changes.
Toggling Logical Group States
Just as with an individual resource in ParkMyCloud, you may toggle the state of a logical group to ON (Running) or OFF (Stopped). When the state is changed, every instance within the logical group will be affected.
As mentioned earlier, note that ParkMyCloud will enforce the currently set On/Off state for all members of the Logical Group, even if no schedule is attached.
They will start or stop based on the scheduled times as well as any delays you have configured as part of the logical group. If no delays have been configured, the group members will be started and stopped at the scheduled times.
To toggle a logical groups state to ON (Running), click on the slider for the appropriate group in the Resources Screen.
In the prompt window, click on OK to continue with the state change or Cancel to exit without altering the group's state.
Then wait patiently as it cycles from a stopped to running state. The state will change from pending, to starting, and finally to running, as shown below:
When viewing the details of the logical group, each individual resource will also show the current state as "running". Click on the resource to see more details.
To toggle a logical groups state to OFF (Stopped), click on the slider for the appropriate group in the Resources Screen.
In the prompt window, click on OK to continue with the state change or Cancel to exit without altering the group's state.
Then wait patiently as it cycles from a running to stopped state. The state will change from pending, to stopping, and finally to stopped, as shown below:
If the logical group is currently in a pending, starting, or stopping state, you will see the following message when attempting to click on the toggle slider. Wait patiently for this process to finish before trying again.
Attaching Parking Schedules
A parking schedule may be attached to a logical group by using the light bulb or the calendar icon next to each resource in the Resources Screen. To apply a schedule to more than one logical group, use the checkboxes in the Bulk Column and then click on the Schedule option above the listed resources
The Parking Recommendations Icon is assigned to a logical group based on tags and keywords (see keyword-based recommendation settings). In the example below, if any of the displayed keywords are part of the group's name or part of a tag, then it will appear as a parking recommendation.
Click on the Light Bulb next to each group on the Resources Screen to view its parking recommendation information and/or attach a schedule. For more information, please see Parking Recommendation Management.
Upon clicking on the icon, you will be redirected to the Recommendations Tab for the Logical Group. Click on Details to view more information about a SmartParking or Keyword-based recommendation.
Then tick the radial for the desired schedule or use the New option to create a new one and click Apply Schedule to finish. A parking recommendation can also be ignored for a logical group by clicking on Ignore in this screen.
An individual group may also be parked by clicking on the Calendar Icon to the left of its name. Once this has been done, you will need to follow the instructions below to finish attaching the parking schedule.
Use the checkboxes in the Bulk Column to select multiple resources for attaching a parking schedule and then click on Schedule within the toolbar at the top of the Resources Screen.
For this example, we will be attaching a parking calendar to a single logical group (Development Group). Parking calendars allow you to park resources and let the schedule control when they are ON/OFF. The following pop-up window will appear after clicking on the Calendar Icon.
Click on the Search Field and type in a value to find a specific schedule. Click on New to create a new parking schedule and attach it to the logical group.
You will need to click on the desired parking schedule in the list to attach it to the logical group or groups. In this example, we will park these using the Always Parked - Override to Use Instances schedule.
The selected schedule will be enforced immediately. Tick the checkbox labeled "Don't show this again." if you do not want to see the warning dialog below each time a schedule is selected.
A Clock Icon will now appear to the left of the state toggle to show that a parking schedule is currently attached to the logical group.
Detaching Parking Schedules
Once a parking schedule has been attached to one or more logical groups, it can removed by following similar steps. You will need to click on the Clock Icon next to the desired group in the Resources Screen.
Use the checkboxes in the Bulk Column to select multiple groups, as shown in the "Attaching Parking Schedules" section above and then click on Schedule in the toolbar. For this example, we will be detaching a parking schedule from the same logical group.
A prompt window will appear showing the currently attached schedule along with any other available schedules for the logical group. To detach the schedule, click on Detach Schedule.
Another message window will appear as shown below. This is an informational window showing that the change will result in lost money saving opportunities. You may tick the checkbox next to "Don't show this again." before clicking on Detach to prevent this message from appearing again.
If you want it to continue appearing, simply click on Detach to close the message window. Click on Cancel to exit this prompt without detaching the parking schedule from the logical group.
Once the schedule has been detached, the group's status will remain on whatever it was set to when the parking schedule was attached. If the group's status is supposed to be OFF - Stopped and is currently in an ON - Running state, then you will need to click on the Toggle Slider to change the status.
Overriding Parking Schedules
A parking schedule for a logical group may also be overridden to allow the logical group to be running outside of the defined "parking times". An override essentially delays the action of the parking schedule by a set number of hours (or days) to ensure the resource is running when needed and then shut down without intervention after the override has expired.
To override a parking schedule for a single logical group, click on the Clock Icon for the desired group when viewing logical groups in the Resources Screen.
Then click on Override Schedule in the pop-up window to begin setting up an override.
An override may be configured to last for a set number of hours or to be effective until a certain day and time. To configure the delay by hours, click on the radio titled For " " Hour(s) and then click on the entry field or arrow buttons to set the number of hours. Once finished, click on OK to initiate the override or Cancel to exit without setting up the override.
To configure the delay to end on a specific date at a certain time, click on the radio titled Until and then click on the Calendar Icon. Choose a Date and Time from the calendar pop-up. Use the Timezone Menu to choose a different timezone for the configured override.
In the example below, the override has been configured for one day and the US/Central timezone. Once finished, click on OK to initiate the override or Cancel to exit without setting up the override.
When a parking schedule has been overridden for a logical group, the icon will have a red clock, as shown below:
Hover the mouse over the Clock Icon for a logical group to see the date and/or time the override ends.