In the Tenant drop-down list, select the tenant to assign the imported resources to.
In the Import source drop-down list, select one of the following options:
File
If you select this option, enter the password and click the Import button.
Repository
If you select this option, a list of packages available for import is displayed. We recommend starting the import with the "OOTB resources for KUMA 2.1" package and then importing the packages one by one. If you receive a "Database error" error when importing packages, try importing the package mentioned in the error message again, selecting only the specified package for import. You can also configure automatic updates.
You can select one or more packages to import and click the Import button.
The imported resources can only be deleted. To rename, edit or move an imported resource, make a copy of the resource using the Duplicate button and perform the desired actions with the resource copy. When importing future versions of the package, the duplicate is not updated because it is a separate object.
Resolve the conflicts between the resources imported from the file and the existing resources if they occur. Read more about resource conflicts below.
If the name, type, and guid of an imported resource fully match the name, type, and guid of an existing resource, the Conflicts window opens with the table displaying the type and the name of the conflicting resources. Resolve displayed conflicts:
To replace the existing resource with a new one, click Replace.
To replace all conflicting resources, click Replace all.
To leave the existing resource, click Skip.
To keep all existing resources, click Skip all.
Click the Resolve button.
The resources are imported to KUMA. The Secret resources are imported blank.
About conflict resolving
When resources are imported into KUMA from a file, they are compared with existing resources; the following parameters are compared:
Name and kind. If an imported resource's name and kind parameters match those of the existing one, the imported resource's name is automatically changed.
ID. If identifiers of two resources match, a conflict appears that must be resolved by the user. This could happen when you import resources to the same KUMA server from which they were exported.
When resolving a conflict you can choose either to replace existing resource with the imported one or to keep exiting resource, skipping the imported one.
Some resources are linked: for example, in some types of connectors, the connector secret must be specified. The secrets are also imported if they are linked to a connector. Such linked resources are exported and imported together.
Special considerations of import:
Resources are imported to the selected tenant.
Starting with version 2.1.3, if a linked resource is in the Shared tenant, it ends up in the Shared tenant when imported.
In version 2.1.3 and later, in the Conflicts window, the Parent column always displays the top-most parent resource among those that were selected during import.
In version 2.1.3 and later, if a conflict occurs during import and you choose to replace existing resource with a new one, it would mean that all the other resources linked to the one being replaced are automatically replaced with the imported resources.
Known bugs in version 2.1.3:
The linked resource ends up in the tenant specified during the import, and not in the Shared tenant, as indicated in the Conflicts window, under the following conditions:
The associated resource is initially in the Shared tenant.
In the Conflicts window, you select Skip for all parent objects of the linked resource from the Shared tenant.
You leave the linked resource from the Shared tenant for replacement.
After importing, the categories do not have a tenant specified in the filter under the following conditions:
The filter contains linked asset categories from different tenants.
Asset category names are the same.
You are importing this filter with linked asset categories to a new server.
In Tenant 1, the name of the asset category is duplicated under the following conditions:
in Tenant 1, you have a filter with linked asset categories from Tenant 1 and the Shared tenant.
The names of the linked asset categories are the same.
You are importing such a filter from Tenant 1 to the Shared tenant.
You cannot import conflicting resources into the same tenant.
The error "Unable to import conflicting resources into the same tenant" means that the imported package contains conflicting resources from different tenants and cannot be imported into the Shared tenant.
Solution: Select a tenant other than Shared to import the package. In this case, during the import, resources originally located in the Shared tenant are imported into the Shared tenant, and resources from the other tenant are imported into the tenant selected during import.
Only the general administrator can import categories into the Shared tenant.
The error "Only the general administrator can import categories into the Shared tenant" means that the imported package contains resources with linked shared asset categories. You can see the categories or resources with linked shared asset categories in the KUMA Core log. Path to the Core log:
/opt/kaspersky/kuma/core/log/core
Solution. Choose one of the following options:
Do not import resources to which shared categories are linked: clear the check boxes next to the relevant resources.
Perform the import under a General administrator account.
Only the general administrator can import resources into the Shared tenant.
The error "Only the general administrator can import resources into the Shared tenant" means that the imported package contains resources with linked shared resources. You can see the resources with linked shared resources in the KUMA Core log. Path to the Core log:
/opt/kaspersky/kuma/core/log/core
Solution. Choose one of the following options:
Do not import resources that have linked resources from the Shared tenant, and the shared resources themselves: clear the check boxes next to the relevant resources.
Perform the import under a General administrator account.