Manage Solution Kits
The Manage Solution Kits task adds, removes, or upgrades Solution Kits on the gateway.
Manage Solution Kitstask adds, removes, or upgrades Solution Kits on the
Layer7 API Gateway.
A Solution Kit adds new functionality to the
Layer7 API Gateway. Built-in conflict resolution helps you resolve any conflicts between an incoming Solution Kit and existing functionality.
Certain functionality, like the Layer7 API Management OAuth Toolkit, are delivered as Solution Kits and require separate licensing. Be sure to consult the documentation accompanying your Solution Kit for specific installation instructions.
The Solution Kit Installation Wizard guides you through the necessary steps.
To access this task:
Tasks > Extensions and Add-Ons > Manage Solution Kits
(1) Reconnect the Policy Manager after installing a Solution Kit to ensure that all the new entities are visible. (2) Alternatively, you can install Solution Kits using the REST Management API, bypassing the graphical user interface.
Ensure that you have:
- A .sskarfile for the Solution Kit being installed; ensure that it is not the unsigned ".skar" version
- License files for the Solution Kits being installed (if the Solution Kit requires separate licensing).
This task requires the 'Administrator' role.
Main Dialog Box
The Manage Solution Kits dialog lists the Solution Kits that are currently installed on the API Gateway.
- Select a table row before using any of these actions:Uninstall, Upgrade, Properties
- You do not need to select a table row for this action:Install
Upgrading Solution Kits
Select your Solution Kits carefully when upgrading.
- If you select aparentSolution Kit in step 1 of the wizard,note that all child Solution Kits are removed first. The upgrade results will then depend on what you select in step 2 of the wizard. For example, a parent has five children (child 1-5). If you update it using a parent that contains only four children (say upgrades to childs 1, 3, 5, plus a new child 6), the two non-upgraded children (2, 4) are no longer present after upgrading. But the new child kit 6 is installed.
- If you select achildSolution Kit in step 1 of the wizard, only that child is upgraded. No other child Solution Kits are removed.
The Solution Kit Installation Wizard runs when you select the
What you should know...
Select a Solution Kit installation file to install or to be used for the upgrade. These files have the
If the installation file contains multiple Solution Kits, select which ones to install. If only one Solution Kit is present, it is automatically selected.
Manage Licensesto upload license files for any Solution Kit name prefixed with "(Unlicensed)". This prefix is removed once the licenses are installed. For help on installing a license, see Manage Gateway Licenses.
Set Instance Modifierto specify a string to add to the names of all the items within the Solution Kit. This string keeps the names unique.
Tip:The instance modifier is required when installing multiple instances of the same Solution Kit.
The instance modifier is added as follows for the various entities ("v1" in the following examples):
The Solution Kit author may implement additional custom controls. Contact the author for instructions on how to use these controls.
This step is displayed after the wizard checks for conflicts.
This step lists the entities and actions for the Solution Kit. If errors exist (see Error Type column), resolve them before continuing:
When a conflict is resolved, the Resolved column changes to 'Yes'. This column must contain all 'Yes' or '---' before the wizard can finish.
Upgrading a Solution Kit with Deleted Entities
You cannot upgrade a Solution Kit if any of its entities are missing. For example, an encapsulated assertion installed by the Solution Kit was deleted accidentally. You will see an error during upgrading. To respond to this error, cancel the upgrade and do one of the following:
Frequently Asked Questions
Why is the wizard not letting me finish when I click 'Finish'?
Unresolved errors are present. Ensure that you have resolved all errors showing in the Error Type column before clicking [Finish].
Tip:If multiple child Solution Kits are involved, be sure to review all the tabs for errors.
Why must I reinstall a Solution Kit before upgrading?
This is necessary only if entities originally installed by the Solution Kit have been deleted. All entities must be present before upgrade can occur. The system will warn you if entities are missing.
Can I install the same Solution Kit more than once?
Yes. The instance modifiers allow you to install the same Solution Kit multiple times. Installation cannot continue if there are not unique instance modifiers.
Why do some Solution Kits show "(Unlicensed)" even though I installed the license file?
A parent Solution Kit may contain many child Solution Kits. The license you obtained unlocks the functionality meaningful to you, which may not include all solutions kits within the parent.
Less commonly, this may indicate that the Solution Kit license is not compatible with the license installed on the Gateway.
Why am I asked to manually remove entities after an uninstall?
Solution Kits should uninstall cleanly most of the time. You see this message only if the Solution Kit did not include the proper deletion logic. Contact the Solution Kit author for a list of the entities to uninstall manually.
When I uninstall a Solution Kit, what is removed?
Uninstalling a Solution Kit removes everything that was installed, including added entities such as encapsulated assertions and policy endpoints. If there is policy logic that relies on an uninstalled entity, you must manually edit that policy afterwards to remove the references.
Is it possible to simply disable Solution Kit to re-enable later?
No. You cannot disable a Solution Kit; only uninstall is supported.
What does a "409" error mean?
This error indicates there are conflicting records on the Gateway or that creating or updating a record will cause a conflict. Examples of conflicting fields include: Name, GUID, or Host/Port combination.
I discovered my Server Module File functionality is disabled. Does this affect my Solution Kits?
If the Solution Kit contains assertions and the server module functionality is intentionally disabled (using the
serverModuleFile.upload.enablecluster property), these assertions are uploaded into the database. However, they are not available until you re-enable the cluster property and restart the Gateway node.
Why are some of the entities behaving "oddly" after I install a Solution Kit?
This could be because the Solution Kit author has designated some entities as "read only" to prevent accidental changes or deletions.
Signs that an entity is read only:
Read only entities cannot be altered, even if you have Administrator privileges.