Requirements

Before you create the Platform assets catalog, understand the required permissions and the requirements for storage and duplicate handling.

Required permission

You must have one of these roles or permissions to create the Platform assets catalog:

• The IAM Administrator role in the IBM Cloud account.
• If you have the IBM Knowledge Catalog service, the Manage catalogs user permission that is provided with the Manager IAM service access role for Cloud Pak for Data.

To view your roles, go to Administration > Access (IAM). Then select Roles in the IBM Cloud console.

Storage requirement

Specify the IBM Cloud Object Storage instance that is configured during IBM Cloud account setup. If you are not an administrator for the IBM Cloud Object Storage instance, it must be configured to allow catalog creation.

Duplicate asset handling

Assets are considered duplicates if they have the same asset type and the same name.

Select how to handle duplicate assets:

• Update original assets
• Overwrite original assets
• Allow duplicates (default)
• Preserve original assets and reject duplicates

You can change the duplicate handling preferences at any time on the catalog Settings page. Find out more information about duplicate asset handling options in Handling duplicate assets in catalogs.

Creating the Platform assets catalog

To create the Platform assets catalog:

1. From the main menu, choose Data > Connectivity.

2. Click Create catalog.

3. Select the IBM Cloud Object Storage service. If you don't have an existing service instance, create a IBM Cloud Object Storage service instance and then refresh the page.

4. Click Create. The Platform assets catalog is created in a dedicated storage bucket. Initially, you are the only collaborator in the catalog.

5. Add collaborators to the catalog. Go to the Access control page in the catalog and add collaborators. You assign each user a role:

   • Assign the Admin role to at least one other user so that you are not the only person who can add collaborators.
   • Assign the Editor role to all users who are responsible for adding connections to the catalog.
   • Assign the Viewer role to the users who need to find connections and use them in projects.
     
     

   You can give all the users access to the Platform assets catalog by assigning the Viewer role to the Public Access group. By default, all users in your account are members of the Public Access group. See add collaborators.
   
   

6. Add connections to the catalog. You can delegate this step to other collaborators who have the Admin or Editor role. See Add connections to the Platform assets catalog.

The Platform assets catalog also appears on the list of catalogs when you choose Catalogs > View all catalogs. When you access the Platform assets catalog from the Your catalogs page, you can view and add other assets besides connection assets to the catalog.

Next steps

Finish the remaining steps for setting up the platform.

Learn more

• Managing access to a catalog
• Administering a catalog

Parent topic: Setting up the platform for administrators