Extensions Management

You can create and manage multiple ClearPass extensions. ClearPass extensions are self-contained micro-services that can run on top of the ClearPass platform and provide access to some features that are not yet part of the current ClearPass version. Extensions are easy to install from the ClearPass Extensions Store. In a cluster, extensions can be installed on a subscriber independently of the publisher.

To view and work with the list of extensions and to install and configure new extensions, go to Guest > Administration > Extensions. The Manage Extensions list view opens. All extensions that have been installed are included in the list. Information shown for each extension includes its name, version, state (running or stopped), hostname, and IP address.

Figure 1 The Manage Extensions List View

You can click an extension’s row in the list for additional options:

Options in the Manage Extensions List View
Field	Description
Name	The name of the extension.
Version	The version number of the extension.
State	The extension’s current state, either Running or Not Running.
Hostname	The hostname for the extension.
IP Address	The IPv4 address used for the extension. This address will be within the network range 172.17.0.1/16.
Filter	Lets you filter for an extension by name, version, state, hostname, or IP address.
Show Details	Displays details for the extension such as its state, instance ID, store ID, and any content items.
Reinstall	Opens the Extension Reinstall form, which lets you delete and then reinstall the extension. You may also modify the IP address. When it is reinstalled, it retains its previous configuration and includes any current Extension Store updates for the extension. After it is reinstalled, the extension’s details show the time it was installed.
Delete	Deletes the extension. You will be asked to confirm the deletion.
Stop	Stops a running extension.
Restart	Restarts a stopped extension.
Show Logs	Displays log messages for extensions actions and various extension-related actions.
Configuration	The form expands to include the Extension Configuration form with the extension’s current configuration, if any. If you modify the default configuration, you must then select the Restart extension after updating configuration check box in order to have the changes take effect, and then click Save Changes. A progress bar is displayed while the extension is being restarted.
Install extension	To install an extension, click this link in the list or in the upper right corner. The initial setup page of the Install Extension form opens. See the next section, Installing Extensions.
Refresh	Clears any filter selections and refreshes the full list of installed extensions.