Skip to main content

IGEL

Frame provides a convenient Custom Partition for IGEL OS bundled with UMS Profiles for easy and secure integration with IGEL OS and management with IGEL's UMS. The included UMS Profiles allow admins to quickly and easily deploy Frame App tailored for your users and use-case(s).

Version Requirements​

  • Frame App 7.4.x+ is compatible with IGEL OS 12
  • IGEL UMS 11 or higher

Frame App Custom Partition​

You can bundle Frame App into an IGEL Custom Partition for use with IGEL OS 12 following the instructions below. Building the custom partition bundle currently requires Ubuntu 18.04 with IGEL OS 11.

Frame App IGEL Bundling instructions For Ubuntu 18.04​

  1. Download the latest Frame App for Linux (Debian) to your ~/Downloads directory.
  2. Download and unzip Frame.zip from https://github.com/IGEL-Community/IGEL-Custom-Partitions/raw/master/CP_Packages/Apps/Frame.zip.
  3. Using a terminal, navigate to the unzipped directory to /target/build/ and execute build-frame-cp.sh
  4. Copy frame.ini and frame.tar.bz2 from /target/ to a new Frame folder in the UMS "ums_filetransfer" path depending on your OS:
    • UMS upload path on Linux: /opt/IGEL/RemoteManager/rmguiserver/webapps/ums_filetransfer/Frame/
    • UMS upload path on Windows: C:/Program Files/IGEL/RemoteManager/rmguiserver/webapps/ums_filetransfer/Frame/
  5. Import Frame's Custom Profile(s) from /igel/*
  6. Edit the profile and set up Firmware Customization -> Custom Partition -> Download with your UMS server info and credentials.
  7. Setup env variables as instructed in the guides below.

Building the bundle will provide you with a zip file relative to the version of Frame App that was bundled. This bundle also includes Frame-provided UMS Profiles that you can quickly import and begin using with your Frame Custom Partition.

note

The UMS Profiles provided by Frame serve as starting points for your implementation. However, they don't limit your options for customization. Frame is highly extensible, allowing for extensive customization of various aspects including authentication, Role-Based Access Control (RBAC), and user interface (UI). Advanced customizations can be achieved through:

  • Orchestrating Secure Anonymous Tokens for fine-grained control over authentication flows and RBAC
  • Leveraging the Session API to manage how, when, and where customers interact with your Frame resources

These tools enable you to tailor the Frame experience to your specific needs, going beyond the default configurations provided in the UMS Profiles.

Frame-Provided Profiles​

Frame-provided UMS Profiles offer various configuration options to customize and optimize your IGEL environment. These profiles range from basic Frame App desktop integration to specialized kiosk modes supporting SAML2 and Secure Anonymous Tokens (SAT) authentication.

More details are provided in the document listed below:

Testing New Versions of Frame App​

When a new version of Frame App comes out, admins should test the new version of Frame App on a small subset of devices before rolling it out to the rest of their users. In order to configure multiple versions of Frame App in your UMS, you need to follow a few steps below to add a custom installation path of a test Frame App Custom Partition.

info

When building the custom partition for Frame App 7.x+, make sure to use the build-frame-cp.sh script.

  1. Create a new folder in your UMS file transfer server, something like Frame-Test. This would result in a folder at the following path:

    /IGEL/RemoteManager/rmguiserver/webapps/ums_filetransfer/Frame-Test/

  2. Once that's complete, import or create a copy of an existing profile and edit it. Navigate to Firmware Customization > Custom Partition > Download and edit the download URL to reference the same path.

    For our example: https://[YOUR_UMS_SERVER]:8443/ums_filetransfer/Frame-Test/frame.inf

  3. That's it! Assign the profile to your devices and they should download the new partition accordingly.

note

Multiple versions of Frame App are not currently available on the same IGEL device. Admins must assign only one Frame App Custom Partition to a device at a time.

Troubleshooting​

As of now, there are no specific common issues reported for Frame App 7 on IGEL OS. However, we are continuously monitoring user feedback and will update this section with any relevant troubleshooting information as it becomes available.

If you encounter any issues, please contact our support team for assistance.