Setting up your default catalog

Setting up the default catalog

The Admin user must set up the default catalog.

To set up the automatically-created default catalog:

1. Open the catalog by going to Catalogs > All catalogs and clicking Default Catalog.

2. Add collaborators to the catalog with the appropriate catalog roles. All Cloud Pak for Data user roles have permission to access the catalog. Catalog roles determine user permissions within a specific catalog.

   • Admin: Control collaborators and assets. If you don't want to be the only user who can add collaborators to the catalog, give this role to one or more collaborators.
   • Editor: Control assets within the catalog and use them in projects.
   • Viewer: Find assets in the catalog and use them in projects.

3. Ensure that the duplicate handling setting has been manually selected for the default catalog. With no set configuration for duplicate asset handling, Add duplicate doesn't appear as an option when you're publishing an asset to the catalog.

   To allow for publishing assets to the default catalog as duplicates:

   1. On the default catalog Settings page, change the Duplicate asset handling setting to anything other than Allow duplicates.
   2. Immediately change the setting back to Allow duplicates.

   Now, when you publish to the default catalog, the UI for publishing assets displays the Add duplicate option.

If you later delete the default catalog, you can create a new default catalog manually.

You can also add collaborators by using an API instead of the user interface. For more information, see Data and AI Common Core API: Adding members to a catalog.

Creating the default catalog manually

If the default catalog is not created automatically, a user with the Cloud Pak for Data Administrator role or the Manage catalogs permission must create the default catalog.

To manually create the default catalog:

1. Go to Administration > Catalogs.

2. Click the Catalog Setup tab.

3. Enter the catalog name and description and click Create.

4. Open the catalog by going to Catalogs > All catalogs and clicking the catalog name.

5. Add collaborators to the catalog with the appropriate catalog roles.

6. Load and publish the predefined data classes:

   1. Create a Cloud Pak for Data bearer access token. For more information, see Creating a Cloud Pak for Data bearer token.

   2. Run this curl command:

      curl -k -X POST \
      'https://{cpd_cluster_host}/v3/glossary_terms/admin/initialize_content' \
          -H "accept: application/json" \
          -H "Authorization: Bearer {token} " \
          -H "Content-Type: application/json" \
          -d "{}"
      

      Replace these variables:

      • {cpd_cluster_host} → Your Cloud Pak for Data cluster host name
      • {token} → Your bearer access token

You can also create the default catalog by using an API instead of the user interface. See Data and AI Common Core API: Creating the default catalog.

Learn more

• Adding collaborators to the catalog
• Catalog collaborator permissions
• Administering IBM Knowledge Catalog
• Creating a Cloud Pak for Data bearer token
• Data and AI Common Core API: Creating the default catalog
• Data and AI Common Core API: Adding members to a catalog