Skip to content

IGEL OS is built on a highly secure Linux distribution. Properly deployed, IGEL OS is locked down to the configurations and applications defined via UMS Profiles. The Custom Partitions feature allows you to implement custom scripts, apps, or other files to one or a group of devices running the IGEL OS.

License

Notifications You must be signed in to change notification settings

IGEL-Community/IGEL-Custom-Partitions

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Building IGEL OS Custom Partition


Tutorial videos

Video: Build Microsoft Teams Custom Partition in 42 seconds

Video: Add Zoom CP to UMS

Video: Add Multiple CP to UMS

Video: CP Build Automation Workflow

Video: IGEL Demo on Dynabook

Video: Privoxy CP for web filtering


Summary of steps to create custom partitions

Step Description
1. Setup lab environment
2. Download Linux package (<package.deb>)
3. Unpack the package on a Linux Ubuntu (Pre OS11.09 = 18.04; OS11.09+/10+ = 22.04; OS12= 20.04) system (dpkg -x <package.deb> <directory>)
4. Create the initialization script
5. Compress the custom partition contents (tar cvjf <package.tar.bz2> <directory> <init_script.sh>)
6. Write the *.inf Metadata file
7. Upload the files to the UMS
8. Create a UMS profile for the custom partition
9. Assign the profile, check for missing libraries, and test the application

See the following:
IGEL KB Document: Custom Partition Tutorial
How to Install Microsoft Teams in a Custom Partition on IGEL OS - White Paper


Finding and adding missing shared libraries

Find the missing libraries on the IGEL OS.

On IGEL OS:

cd /custom/<folder>
find . -executable -type f -exec ldd ‘{}’ \; | grep ‘not found’ >> /custom/ldd.txt

On Linux Ubuntu:

apt download <filename>
dpkg -x <filename>.deb <folder>

Optional -- Install Gdebi to help resolve any dependencies

Gdebi lets you install local deb packages while resolving and installing related dependencies.

sudo apt-get update
sudo apt-get install gdebi

How to use Gdebi

  • Open Files, Right-click on DEB package to install, select "Open with Other Application", and then run "Gdebi Package Installer"
  • Collect the dependencies and add to installer (MISSING_LIBS)

How-to use a Custom Partition


General

IGEL custom partitions are delivered as a zip archive. The archive has the following content:

Folder / File Description
igel folder containing UMS profiles
target folder containing Custom Partition (inf and tar.bz2 files)
target/build files for build automation (updates in progress as of 30 December, 2021)
disclaimer.txt disclaimer note
readme.txt Short Installation guide

Steps to deploy the Custom Partition

Step Description
1. Copy the contents of the folder target into the ums_filetransfer folder on the UMS Server
2. Check the accessibility of the data using Internet browser:
https://<ums_server>:8443/ums_filetransfer/cpname.inf
3. Import the profile (profiles.zip) into the UMS via:
"System->Import->Import Profiles"
The imported profile should now appear in UMS under Profiles.
4. Edit the profile and adopt the settings according to your environment via:
System->Firmware Customization->Custom Partition->Download
a. https://<ums_server>:8443/ums_filetransfer/<cpname>.inf
b. Username: <ums-username>
c. Password: <ums-password>
5. Assign the profile and files to IGEL device(s).
6. In some cases it is required to restart the TC after deployment of the CP.

Build Ubuntu (Pre OS11.09 = 18.04; OS11.09+/10+ = 22.04; OS12 = 20.04) Virtual Machine and Snapshots to roll back to baseline

Step Description
1. Install and configure Ubuntu (Pre OS11.09 = 18.04; OS11.09+/10+ = 22.04; OS12 = 20.04) desktop
2. Take snapshot of the base VM
3. Setup and package application
4. Roll back to base VM snapshot

Configure Ubuntu (Pre OS11.09 = 18.04; OS11.09+/10+ = 22.04; OS12 = 20.04) OS:

sudo apt-get update -y
sudo apt-get upgrade -y
sudo apt-get install build-essential gcc make perl dkms -y
sudo apt-get install chrony -y
sudo apt-get install apt-rdepends -y
sudo apt-get install zip unzip -y
sudo apt-get install gdebi -y

IGEL Disclaimer

The provided packages for use with the IGEL OS Custom Partition feature are without any warranty or support by IGEL Technology.

The files are not designed for production usage, use at your own risk. IGEL Technology will not provide any packages for production use and will not create or support any other packages or the implementation for other 3rd party software.

IGEL Technology is not responsible for any license violation created with the custom partition technology or the provided technical demonstation packages.

The custom partition technology can create a permanent damage in the IGEL OS host system, services related to the wrong usage/misinstallation of a custom partition and/or the deployed packages are not covered by the warranty in any kind.

You will not get support as long the custom partition is used on a system, to avoid conflicts you've to reset the device back to factory defaults before opening a support call.

All packages are designed as technical demonstration samples!

Use at your own risk!

Your IGEL Support/PreSales Team April 2012



Revision Summary

Element Version Date Change Owner Description
0.7 05-May-2024 Ron Neher Pre OS11.09 = 18.04; OS11.09+/10+ = 22.04; OS12 = 20.04
0.6 04-December-2023 Ron Neher Pre OS11.09 = 18.04; OS11.09+ = 22.04; OS12 = 20.04
0.5 17-March-2023 Ron Neher Adding OS11 vs OS12 build logic
0.4 29-December-2021 Ron Neher Updated CP build automation workflow
0.3 30-November-2021 Ron Neher Adding build folder for automation
0.2 09-August-2020 Ron Neher Completed the GitHub automation to take CP files and create package.zip files
0.1 23-July-2020 Ron Neher Initial version


Outstanding Issues

Ref Description
OI.1 NTR

Zip file layout:

disclaimer.txt
profiles/
   profiles.zip (profile.xml, OS_VER.xml)
readme.txt   
target/
   <package>.tar.bz2
   <package>.inf
target/build
   files for build automation

About

IGEL OS is built on a highly secure Linux distribution. Properly deployed, IGEL OS is locked down to the configurations and applications defined via UMS Profiles. The Custom Partitions feature allows you to implement custom scripts, apps, or other files to one or a group of devices running the IGEL OS.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages