Sample Remote Agent Extension

Information

This extension is a sample module for the Remote Agent. It demonstrates how to:

  • Integrate custom logic with the OS installation workflow,
  • Listen to system events (e.g. Kickstart generation),
  • Replace template placeholders with dynamically calculated values,
  • Extend Kickstart templates with your own installation instructions.

The module is intended as a learning example for developers who want to create their own Remote Agent extensions and customize the provisioning process.

Any modifications introduced by this extension must be based on the official documentation of the respective operating system or virtualization platform (e.g. Linux distributions, Windows unattended setup, VMware installation guides). This ensures that generated Kickstart/answer files remain valid and supported.

Download

An exemplary extension may be downloaded from this location: Sample Extension

Installation

Unzip all files to /opt/easydcim_remote/modules/custom_remote_module directory.

Operation

The module listens to the Kickstart generation event during the OS installation process.
This makes it possible to adjust the script content before it is applied.

  • The value of network.netmask is automatically converted into CIDR notation
    (e.g. 255.255.255.0/24) and inserted in place of the {{custom:cidrMask}} variable in the Kickstart template.
  • If the OS template is marked with the customtag tag, the CustomKickstart class is executed,
    allowing the generation of custom Kickstart fragments.

Thanks to the CustomKickstart class, administrators can easily write and include their own
installation elements in the template, such as additional repositories, packages, or configuration rules.