Create a scheduled install (or uninstall) so that apps appear on your devices when you choose.
In this article:
- Why Do Scheduled Installs?
- Creating a Scheduled Install or Uninstall
- Checking the Schedule Window
- Editing, Canceling, or Deleting a Scheduled Install
- Troubleshooting
Why Do Scheduled Installs?
At times, you’ll want to install apps through the console’s typical methods via provisioning or from the Device or Group App Menu. However, scheduled commands are usually ideal for large-scale app updates.
Let's say you update a group of devices where a number of those devices are turned off. A scheduled command will ensure only the working devices receive the updates within the timeframe. Plus, you won't waste resources on devices that aren't communicating with Esper.
Creating a Scheduled Install or Uninstall
Step 1: Navigate to the Scheduled Install Section
Scheduling an app update from the Devices & Groups section is one way to update apps using a blueprint However, devices won't match their blueprint if apps are updated this way. Use a blueprint to update applications to keep blueprints and devices aligned. You can also set a scheduled converge from the Devices & Groups section (Android only).
If you still want to update an app from the Devices & Groups section, select a group, and click on the Actions button to open the dropdown. Then select App Management.
Then navigate to the scheduled install tab and press Create scheduled install.
Go to Devices & Groups and select the group you’d like to install the app. Click on the Details (eye) icon.
Step 2: Set the Application Information
Fill out the following information:
- Name the scheduled install a helpful name (such as the app you’re planning to install)
- Select the action. You can schedule an app install or an uninstall.
- Select the app. Only one app can be scheduled at a time.
- Select the app or build version.
Step 3: Set the Installation Schedule
Whether you are installing or uninstalling, you can create a window of time when these actions take place. Select Install relative to Device time or Console time.
Then, specify if the installation will be non-recurring or recurring schedule. Learn more about Scheduled Command behavior.
When an installation is non-recurring, that means the apps will install (or uninstall) at any point within the install window. This option is recommended for devices in a warehouse or in a similar storage location where they won’t disrupt your day-to-day business or end-user experience.
In this example, the installation window will begin on March 21st, 2023 at 2:00 AM. The window will close on May 21st, /2023 at 2:00 AM. (Note: both times are device times, as selected in the previous step.)
When an installation is on a recurring schedule, the app will install (or uninstall) only on the days and times specified. The command will be attempted until the schedule expires, and once installed, it won't install again (or uninstall again). Use this option for devices that are out in the field. The installations will only run on the specified days between the hours you set, ensuring that you don’t interrupt an end user’s experience.
In this example, a recurring install is set between the hours of 12:00 AM and 6:00 AM on Sundays, Wednesdays, and Saturdays. The window will start on March 21st, 2023 and end on August 20th, 2023. Although the installation window date starts on March 21st (a Tuesday), it will not start installing apps until 12:00 AM on March 22nd (a Wednesday) since Tuesdays are not approved on this recurring schedule.
Once you’ve set the scheduled times, click Create schedule. A schedule will be created.
Checking the Schedule Window
Once an installation is scheduled, you can view its progress from the group’s Apps section, the group’s Event Feed, and the Scheduled Install section. It may take a few minutes before the View button becomes active.
To see each device’s status, navigate to the group’s Apps section, and then select Results > View.
You can also cancel the installation (or uninstallation) from this menu.
Editing, Canceling, or Deleting a Scheduled Installation
You may cancel an install (or uninstall) at the group or device level. See Checking the Installation to see how to cancel installs for individual devices.
To cancel the scheduled installation, go to the group’s Apps menu and click the Scheduled Install tab.
Then, under the Action tab, click on the ellipsis (...).
Here, you’ll find options to:
- Edit or update the installation, including changing the dates, selected app, and type of action (install or uninstall).
- Cancel the installation. The remaining queued commands will be canceled, but the event will still appear in places such as the Event Feed, Group App Menu, and the Schedule Install menu. In the Group App History section, the event will have a status of Successful, even if it was Canceled before any apps were installed.
- Delete the installation. The remaining queued commands will be canceled, and the event will be deleted from places such as the Event Feed, Group App Menu, and Schedule Install menu.
Troubleshooting
There are a few reasons why apps could fail to install (or uninstall) even by the end of the window.
- The device was Last Seen < 30 for the entire schedule and so could never receive the command. Check the device's last registered location in Reports.
- A firewall prevented the command from reaching the device. You may see “Command Timed Out” in the Group’s Event Feed.
- The device has a very slow network connection, and the app you’re trying to install is very large. You may see “Download Timed Out” in the Event Feed.
Even devices that are newly added to the group will install the apps as long as they were added within the scheduled window. Use Scheduled updates to manage applications at scale.