CA API Gateway 9.1

9.4 9.1

Manage Solution Kits

The Manage Solution Kits task adds, removes, or upgrades Solution Kits on the .
gateway90
The
Manage Solution Kits
 task adds, removes, or upgrades Solution Kits on the 
API Gateway
.
A Solution Kit adds new functionality to the 
API Gateway
. Built-in conflict resolution helps you resolve any conflicts between an incoming Solution Kit and existing functionality.
Note that some Solution Kits require separate licensing.
The Solution Kit Installation Wizard guides you through the necessary steps.
To access this task:
Tasks > Manage Solution Kits
.
(1) Reconnect the Policy Manager after installing a Solution Kit to ensure that all the new entities are visible. (2) Solution Kits can also be installed using the REST Management API, bypassing the graphical user interface. (3) You may customize any of the entities installed by a Solution Kit but do not delete any entities, even if you have no need for that entity. Doing so will cause difficulties upgrading the Solution Kit at a later date.
Contents
Prerequisites
Ensure that you have:
  • A .
    sskar
     file for the Solution Kit being installed; ensure that it is not the unsigned ".skar" version
  • License files for the Solution Kits being installed.
Security
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
  • The following actions are not dependent on a table row:
    Install
Restrictions for Browser Client:
 The following operations are
not
 available from the browser client version of the Policy Manager:
Install, Upgrade, Properties
. To run these operations, use the desktop client instead.
Wizard
The Solution Kit Installation Wizard runs when you select the Install or Upgrade actions.
Step
What you should know...
1
Select a Solution Kit installation file to install or to be used for the upgrade. These files have the 
.sskar
 extension.
2
If the installation file contains multiple Solution Kits, select which ones to install. If only one Solution Kit is present, it is automatically selected.
Required:
 Click
Manage Licenses
 to 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.
Optional:
 Click
Set Instance Modifier
 to 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 followings ("v1" in the following examples):
  • As a suffix to all folder names (example: "My Folder Name v1")
  • As a prefix to all policy names (example: "v1 My Policy Name")
  • As a prefix to encapsulated assertion names (example: "v1 My Encass Name")
  • As a prefix URL pattern to all service names (example, "/v1/my_query")
  • As a prefix to scheduled tasks names (example, "v1 My Scheduled Task Name")
  • As a prefix to policy-backed service names (example: "v1 My Policy-Backed Service Name")
Additional custom buttons may be implemented by the Solution Kit author. Contact the author for instructions on how to use those buttons.
3
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:
  1. (Optional)
     Select the tab corresponding to the Solution Kit to check.
  2. Double-click anywhere within the row or use the
    Resolve
     button to display the Resolve Entity Conflict dialog.
  3. Review the entity details and then select a replacement from the drop-down list.
    Tip:
     If the entry you need is not displayed, click
    Manage
     to define it now.
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:
  • Uninstall and reinstall the original Solution Kit, then run the upgrade again. You will lose any customized entities using this method.
  • Reinstall the same Solution Kit with a unique instance modifier, then run the upgrade again. The advantage of this method is that you have access to the original Solution Kit entities, as reference for any customizations.
Frequently Asked Questions
Question
Answer
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.
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 a deletion bundle. 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, manually edit that policy afterwards.
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.enable
 cluster 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 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.

Content feedback and comments