Documentation Home

The Resource Scheduler for Microsoft Azure provides a quick and easy way to create group schedules to stop and start Azure VMs on the schedule (days and times) you specify.

NOTE: While additional resource types may be added in the future, “resources” in the current release refers to Azure VMs.

Table of Contents

VIDEO GUIDANCE: Installation and configuration video links are available in the Installation and Configuration sections below.

A Note on Azure Managed Apps

The Resource Scheduler is an Azure managed application, a feature unique to Microsoft Azure. It is similar to a solution template in the Marketplace, with one key difference. With a managed application, the resources are deployed to a resource group that’s managed by the publisher of the app (Lumagate, in this case), so we can ensure your app is always up-to-date. The resource group is present in your subscription, but an identity in the publisher’s tenant has access to the resource group.

IMPORTANT: This does NOT grant Lumagate permissions of any kind over your resources outside the resource group hosting the Resource Scheduler.

back to ToC

Scope of a Resource Scheduler instance

A Resource Scheduler instance is associated to a single Azure Active Directory (AD) tenant. A Resource Scheduler instance can manage schedules for starting and stopping VMs in Azure connected subscriptions associated with an Azure AD tenant. In other words:

back to ToC

Install and Configure

This section covers the initial installation and configuration of the Resource Scheduler.

Installation

INSTALLATION VIDEO WALKTHROUGH: Available HERE

Written version of Resource Scheduler installation steps is available immediately below.

  1. Browse to the Azure portal at https://portal.azure.com. Login using an account with Global Administrator rights.

  2. In the search box at the top of the browser window, type “Marketplace”. Select the Marketplace icon to go to the Azure Marketplace.

  3. In the Marketplace search box, type “Resource Scheduler”.

  4. Click the “Resource Scheduler” tile in the search results.

  5. To install the Resource Scheduler, click the Create button.

    marketplace

    FIGURE 1. Resource Scheduler in the Azure Marketplace

  6. In the boxes provided, specify the subscription, resource group name, and an the Azure region where the Resource Scheduler will reside.

  7. Then, click the Next : General Settings button.

    install001

    FIGURE 2. Subscription, Resource group, and Azure region

  8. Specify a value for the Resource Prefix. This can be any random alpha string up to 8 characters. (no numbers or special characters are supported)

  9. In the Location for Application Insights field, specify the same region you selected when specifying a resource group name.

    install002

    FIGURE 3. Resource group prefix and App Insights region

  10. To deploy the Resource Scheduler, click Review + create.

    install003

    FIGURE 4. Agreement and Deployment

  11. Once the deployment begins, you will see the “Your deployment is underway” screen shown in Figure 5.

    install004

    FIGURE 5. Resource Scheduler in Azure

  12. When the deployment is complete, you will see the “Welcome to your Managed Application” screen shown in Figure 6.

    install005

    FIGURE 6. Resource Scheduler in Azure

  13. Now, click on the Parameters and Outputs link in the left navigation menu (shown in Figure 7). You will find the URL of your Resource Scheduler instance in the lower right.

  14. Copy the URL to the clipboard (shown in Figure 7).

    NOTE: The current limitations of the Azure Managed Application framework make this a necessary step to retrieve your site URL.

    install008

    FIGURE 7. Deployment outputs (website name)

  15. Paste the link into a web browser. (The Resource Scheduler has been tested in Edge, Chrome, Firefox, and Safari)

  16. Click Login button in the upper right, and provide your Azure AD credentials.

  17. You will then be prompted to allow the Resource Scheduler to read your profile information. Check the box and click Accept.

    NOTE: This consent only affects your user account, and is the minimum required for any Azure app you login to.

    install010

    FIGURE 8. Profile read access

You are now ready to configure schedules and add resources (VMs) to them.

back to ToC

Configuration

CONFIGURATION VIDEO WALKTHROUGH: Available HERE

Written version of Resource Scheduler configuration steps is available in the sections below.

back to ToC

Grant Permissions

The Resource Scheduler includes custom roles based on Azure role-based access control. Roles include:

IMPORTANT NOTE: Since the Scheduler Manager role can schedule based on Tags, a member of this role may be able to schedule resources they cannot see. This issue also exists when using tags with script or runbook-based scheduling, because Azure does not support RBAC for tags.

To assign a Resource Scheduler role to a user or group, perform the following steps:

  1. In the Azure portal or Office 365 Admin Center, select Azure Active Directory.
  2. Then, select Enterprise Applications. From the list, find and select Resource Scheduler (shown in Figure 9 below).
  3. Click Add user > Users and Groups. Then, select the user or group you wish to add the role. Click Select to save your changes.
  4. Next, click Select Role, and choose the role you would like to assign to the selected user or group (Administrator, Auditor, or Schedule Manager). Click Select to save your changes.

entapps

FIGURE 9. Enterprise Apps list in Azure Active Directory

Menu appearance will vary by role assignment. Member of the Administrator role will see the Subscriptions and Settings menus, as shown in Figure 10.

menus

FIGURE 10. Enterprise Apps list in Azure Active Directory

back to ToC

Connect Subscriptions

You can associate multiple subscriptions to a single Resource Scheduler instance. The only requirement is that the subscriptions are associated to the same Azure AD tenant as the Resource Scheduler instance.

To connect a new subscription to the Resource Scheduler instance, perform the following steps:

  1. From the left menu, select Subscriptions.
  2. From the Available Subscriptions, find the subscription you want to add.
  3. Click the blue add add button next to the right of the subscription. Click Connect to confirm the change.

NOTE: It can take up to 5 minutes after you deploy Resource Scheduler for the managed identity to be linked to the database. If you receive the error “The Managed Identity for Resource Scheduler has not been updated in the database yet.”, simply wait about 5 minutes and try again.

To disconnect a subscription to the Resource Scheduler instance, perform the following steps:

  1. From the left menu, select Subscriptions.
  2. From the Connected Subscriptions, find the subscription you want to remove.
  3. Click the red disconnect delete button next to the right of the subscription. Click Disconnect to confirm the change.

back to ToC

Configure Time Zone

The time zone settings determines the time zone by which schedules will be set and displayed in the Resource Scheduler portal. Only a user in the Resource Scheduler Administrator role can change this setting.

To connect a new subscription to the Resource Scheduler instance, perform the following steps:

  1. From the left menu, select Settings.
  2. Under Timezone, select the desired time zone.
  3. Click Save to save your changes.

IMPORTANT! If you change the Timezone setting after configuring schedules, it will change the time by which all schedules are evaluated! This should be clear from the time zone notices throughout the Resource Scheduler portal, but we wanted to mention it again here! :grin:

back to ToC

A quick note on Managed Identity

To complete scheduled actions, the Resource Scheduler uses a managed identity. The managed identity is an account in the customer’s Azure Active Directory (AD) that only Azure / Azure AD know the password of, similar to the Managed Service Account in Active Directory. When you connect a subscription, you authorize this account to have rights to the subscription, allowing it to start, stop, and inventory VMs and tags without a user signed in. (This is useful when the schedule kicks off before/after working hours, when you are not sitting at your computer).

back to ToC

Managing Schedules

This section describes how to schedule resources for start and stop at the days and times you specify. There are two approaches for scheduling resources:

  1. Scheduling resources directly. With directly scheduling, you associate VMs to a schedule one at-a-time, using a simple search interface. This is great for smaller environments or schedules that affect a small number of VMs. See “Schedule Resources Directly” for configuration steps.
  2. Scheduling by tag. This option will automatically associate the schedule to all Azure VMs with the tag you specify. This is the preferred option for bulk scheduling and large environments. See “Schedule Resources by Tag” for configuration steps.

A note on multiple schedules. You can assign multiple schedules through direct assignment or using tags.

back to ToC

Schedule Resources Directly

Associating resources to schedules directly is the preferred method for managing small numbers of VMs, as explained in Managing Schedules above.

To add VMs to a schedule, perform the following steps:

  1. From the left menu, select Schedules.
  2. Click the plus (+) sign by Schedules, shown in Figure 11 below. This will bring up the schedule form.
  3. Complete the values in the schedule form.
  4. Add VMs in the Resources field, using the search and list controls, shown in Figure 12 below.
  5. Click Save to save your changes.

schedule

FIGURE 11. Schedule menu in Resource Scheduler

schedule

FIGURE 12. Adding VM resources directly to a schedule

back to ToC

Schedule Resources by Tag

Associating schedules to resources with Azure tags is the preferred method for managing large numbers of resources as explained in Managing Schedules above. The Resource Scheduler looks for the tag values you specify when associating a schedule to a tag. If you are not familiar with tags in Azure, see “Use tags to organize your Azure resources”.

IMPORTANT REMINDER! To avoid confusion and unintentional scheduling of VMs, the Resource Scheduler will look for tags only on the VM resource itself!

To associate a tag to a schedule, perform the following steps:

First, you will create the schedule:

  1. From the left menu, select Schedules.
  2. Click the plus (+) sign by Schedules. This will bring up the schedule form.
  3. Complete the values in the schedule form. Leave the Resources field blank.
  4. Click Save to save your changes.

Next, you will associate the schedule to tags:

  1. From the left menu, select Tags.
  2. In the Available Tags list, find the tag name associated to the resources you wish to schedule.
  3. To the right of your tag, click the orange Schedule tag button, shown in Figure 13. This will bring up the schedule form.
  4. In the Schedule Trigger Values field, add one or more tag values that will trigger schedule actions. The tag values are provided to you in the dropdown list, shown in Figure 14 below.
  5. In the** Attached Schedules** field, select the desired schedule or schedules from the dropdown list.
  6. Click Save to save your changes.

availtags

FIGURE 13. Adding VM resources directly to a schedule

schedtags

FIGURE 14. Adding VM resources directly to a schedule

back to ToC

Troubleshooting and Support

This section details where to view logs related to Resource Scheduler operation, as well as how to ask a question or request support.

Viewing Resource Logs

To view logs related to a resource, perform the following steps:

  1. From the left menu, select Schedules.
  2. Click the Expand details icon to the right of the resource (VM) in question.
  3. Select the Logs tab.

Events are listed in descending order (newest event at the top).

back to ToC

Request Support

E-mail support is available to Resource Scheduler customers.

To request support, perform the following steps:

NOTICE OF SUPPORT HOURS: Support hours for Resource Scheduler are 8am - 6pm Eastern Time, Monday-Friday.

STEP 1: Check the FAQs

Begin by checking our FAQs Page to see if your question is answered there. If it is not, proceed to STEP 2.

STEP 2: Screenshot your Claims

Visit https://<tenant>.azurewebsites.net/claims and capture a screenshot of the claims associated with your account. If you are logging a request for another user, ask them to capture this data and forward to you.

IMPORTANT! Be sure to complete this step. Your support analyst may ask for this information.

STEP 3: Log a ticket

To log a ticket, visit our Support page at https://lumagate.us/support and click the “CONTACT US” button. In the form provided, select “Resource Scheduler” in the Product dropdown. Complete the required fields in the form and click Submit. A support ticket will be logged and routed automatically. You will receive an e-mail confirmation that your request was received.

back to ToC

Start and Stop VMs from Resource Scheduler

If desired, you can start and stop VMs on-demand directly from the Resource Scheduler portal.

To start or stop a VM, perform the following steps:

  1. From the left menu, select Resources.

  2. Then, click the Start or Stop button as appropriate. Which button appears depends on the current state of the VM:
    • The Start button start only appears for VMs currently in a stopped or deallocated state.
    • The Stop button stop only appears for VMs currently in a running state.
  3. Press the appropriate button to start or stop the VM in Figure 15.

    • To START a VM: Click the green start button next to the right of the VM resource. Click the green start button again in the prompt to confirm the action.
    • To STOP a VM: Click the stop stop button next to the right of the VM resource. Click the red stop button again in the prompt to confirm the action.

NOTE: The state of the VM may take up to 5 minutes after button press to reflect the change in state, as mentioned on the confirmation screen.

schedtags

FIGURE 15. Start and Stop buttons for VM resources

back to ToC

Resource Scheduler Licensing

Resource scheduler is licensed according to the number of resources (VMs) you need to schedule. For pricing information, see “Resource Scheduler Licensing” on the Lumagate website.

back to ToC

Frequently Asked Questions

Frequently asked questions are maintained on our FAQs Page

back to ToC

Referral Partner Program

Prospective partners can learn more about Lumagate’s Resource Scheduler partner program on our Referral Partner Program page.

back to ToC