Using the Content UI

Owned by Rumena Zlatkova (Deactivated)
Last updated: Dec 20, 2023 by Bala Harish A(AC)
5 min read

The Content UI allows the creation, viewing, and management of tenants, domains, buckets, and objects from the convenience of a web browser. 

Tip

For the best experience using the Content UI, use the latest Chrome or Firefox browsers. Safari browser is not supported.

The breadcrumb navigation at the top shows the location in the hierarchy (which is how access to content is segregated and controlled). The hierarchy is based on one-to-many relationships:

  1. Clusters (Swarm icon) can contain multiple tenants.

  2. Tenants can each contain multiple storage domains.

  3. Domains can each contain multiple buckets.

  4. Buckets hold named objects, which are files uploaded to Swarm by various clients and applications. 

Important

What is visible in the Content UI is controlled and protected by access permissions. A Domain admin is not able to see anything (domains, tenants, clusters) outside of the domain they are authorized to manage. 

The DataCore icon link attempts to take users to the top-most level (domain, tenant, or root) allowed for them by applied permissions. It takes them to the storage domain they logged in to (the URL in the address bar); the user must navigate to the root level, even if the permissions do not allow them to list if the hostname is not a storage domain.

See Content Gateway Concepts.

Accessing the Content UI

The admin users for the Content UI are defined during the Gateway Installation, via a root policy configuration file that grants full cluster permissions to a specific LDAP group or list of users.

Note

An authorized user must login. There is no anonymous access to the Content UI.

Cluster

Browse to the cluster's Content UI and use the login name and password created for the Root administrator to log in as a cluster administrator:

http://GATEWAY·IP:SCSP·BINDPORT/_admin/portal http://GATEWAY·IP:80/_admin/portal (default)

The SCSP·BINDPORT refer to bindPort settings in the Gateway Configuration, in the [scsp] section.

Tenant or Domain

To log in as a tenant or domain administrator, browse to a domain's Content UI and log in with the admin credentials:

http://STORAGE·DOMAIN:SCSP·BINDPORT/_admin/portal http://STORAGE·DOMAIN:80/_admin/portal (default)

The Content UI opens to the domain’s page, from which the tenant's information can be accessed (if allowed) by clicking the breadcrumb menu.

Different Tenant or Domain

To log in to a different tenant or domain with the existing credentials, specify the tenant or domain after the user name:

  • Tenant – append a plus '+' sign and the tenant name:  username+rtenant

  • Domain – append an at '@' sign and the domain name:  username@domain.com

Creating a Tenant

  1. From the list of Tenants, click the Add button.

  2. Type in the name of the new tenant. (See Naming Rules for Swarm.)

  3. Press Enter or click the Add button again to save it.

See Configuring Tenants.

Creating a Storage Domain

  1. Click on a tenant to view the list of domains within it.

  2. Click the Add button to create a domain.

  3. Type in the name of the new domain. (See Naming Rules for Swarm.)

  4. Select Add to save it.

See Configuring Domains.

Creating a Bucket

  1. Click on a domain to view the contents within it.

  2. Click the Add button to create a bucket.

  3. Clear the S3 Compatible checkbox if a non-S3-compliant name needs to be used.

  4. Type in the name of the new bucket. (See Naming Rules for Swarm.)

  5. Select Add to save it.

See Configuring Buckets.

Uploading Content

  1. Click the Uploads button from the bucket view.

  2. Set the Retention time if the default is not desired (Keep until deleted).

  3. Click Settings to set custom options for file naming and metadata tagging:

  1. Click Add to browse to local files or drag and drop them directly onto the upload area to queue them for upload:

  2. Click the Start Upload button to launch the upload with these settings.

See Uploading Files.

Creating a Search Collection

A new search is defined and run when a collection is added. The results can be saved as a named collection for future use after viewing the results.

  1. Click on the domain name in the breadcrumbs bar to return to the domain.

  2. Click the Search button to create a collection (which is a saved search).

  3. Search for some of the uploaded data and click the Refresh button to rerun the search:

    • Filter Objects - for string searches on object names.

    • Search Scope - search the entire domain, unnamed objects (Content IDs), or a specific bucket.

    • + Add Search Criteria - specify a new search filter, such as Type equal to the string text.

    • + Add Column Headers - customize the view of the list of matched content on the bottom half of the screen.

  4. Click the Save As button at the top right to save the search and display it as a collection for future use.

See Search Collections.

Resources

Located at the top right of the Content UI is the account name, which drops down a menu of resources:

  • Go to Location ... – opens a window for quick navigation to resources by name

  • About – reports the version of the software in use

  • Documentation – opens the searchable online help

  • Online Support – opens the Support site 

  • Logout – ends the current session

See Go to Location.

© DataCore Software Corporation. · https://www.datacore.com · All rights reserved.