Introduction
This article outlines the steps needed to setup an Amino H-Series media player to automatically load a remotely hosted Web Application at startup.
It covers how to configure the H200 for all three network environments of USB provisioned, DHCP-VCI-HTTP provisioned and also using the Amino Orchestrate Management Platform.
Prerequisites
An Amino H200 Media Player
Summary
The URL for the landing page of the Web Application you want the H200 to load.
- For USB provisioning use-case
- A 2GB USB stick (or larger) formatted to VFAT filesystem
- Amino H200 USB Provisioning image. (Available from Amino Self-service support site)
- For DHCP provisioning use-case
- Admin privileges to DHCP server
- Publishing privileges to HTTP Web Server
- For Orchestrate provisioning use-case
- Admin permissions to the Orchestrate "Manage" module
Note: The in-built browser will launch the homepage IF and ONLY IF the "tvapp.package_id" parameter is NOT set, or the tvapp.package_id is set to "com.aminocom.browser"
USB Provisioned Use-Case
Important Note: Please see the generic Quick start guide or USB Provisioning Guide for general information on how to create a USB image for provisioning the H200 via this method.
To configure your web app for your devices, when using the Amino USB Image Creator, select the Parameter "webapp.homepage".
Then, in the next step, enter the URL of your web application. Setting this parameter will set your web application as the default URL for your device.
When you boot the H200 to your newly created USB image, you should now see your web application load after bootup.
DHCP-VCI-HTTP Provisioned Use-Case
Important Note: This article assumes you have already setup your DHCP to support the "VCI" strings to match and provision the H200. If not, please see the relevant setup guide before proceeding.
Within your DHCP configuration, edit the file to which the "option AMINOENTERPRISE.AMINOINI" URL is pointing. This is the INI file you have configured your H200's to provision upon boot. In my example dhcpd.conf entry:
option space AMINOENTERPRISE;
option AMINOENTERPRISE.AMINOINI code 106 = text;
# h200
class "AMINO-APP-107" {
match if substring (option vendor-class-identifier, 0, 13)="AMINO-APP-107";
vendor-option-space AMINOENTERPRISE;
option AMINOENTERPRISE.AMINOINI "https://aminoacme.org/h200/dhcp_boot.ini";
default-lease-time 3600;
}Edit or create the file: "dhcp_boot.ini", adding the following line:
webapp.homepage="https://aminoacme.org/path/to/webapp"Once you have published the file to your Web server, the above line will provision the H200 to launch the URL "https://aminoacme.org/path/to/webapp" upon boot up.
Orchestrate Provisioned Use-Case
Important Note: This article assumes you have access to Orchestrate, have added your H200 media player devices to your domain, and have created a simple group for your devices. Please refer to the relevant articles or the Orchestrate User Manual for more information on setting up your Orchestrate account.
1 - Log in to your Orchestrate portal.
2 - In the left-side menu, click on Configurations.
3 - From the list of configurations, select the group you want to edit
4 - You’ll land on the Configuration Details page. Scroll down and make sure the "Parameters" tab is selected (it is selected by default).
5 - Under Application Settings, find the Web Browser Home Page field.
6 - Enter the desired URL (e.g., https://your-default-url.com) into the field.
7 - Click the Save Changes button at the bottom right of the screen.
Populate the empty "webapp.homepage" value's text area with the URL for the Web application you want to auto-launch on bootup, ensuring you include either "http://" or "https://".
If you have not already assigned any media players to your configuration, go to:
1 - Device list from the left-hand menu.
2 - Select the checkbox next to the device(s) you want to assign.
3 - Click the Attach Configuration button at the top of the screen.
4. From the dropdown list, select the desired configuration.
Once assigned, the device will follow the settings and parameters defined in that configuration.
Finishing Up
All media player devices that are assigned to this group will have the Amino ACME Web Application launched from bootup.
References
None