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

Note

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

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 https://perifery.atlassian.net/wiki/spaces/public/pages/2443810201/Gateway+Configuration?search_id=2851354e-4ea7-4259-aa52-587bdb750117, in the [scsp] section.

Tip

Navigate to the Content UI directly by clicking the top left Swarm logo to reach the sitemap if logged in to the Swarm UI:

 

The Content UI opens to the correct port, as defined in the https://perifery.atlassian.net/wiki/spaces/public/pages/2443810201/Gateway+Configuration?search_id=2851354e-4ea7-4259-aa52-587bdb750117 when Content is clicked.

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.

note

Note

The System Tenant has no owner or configuration options; it is the permanent system-created tenant that manages any storage domain not associated with another tenant.

Note

The System Tenant has no owner or configuration options; it is the permanent system-created tenant that manages any storage domain not associated with another tenant.

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:

Optional

This step is optional.

  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.

Tip (for step 4)

Check the Target Name column to validate the final object names before uploading. There is no name prefix option when uploading files as Content IDs.

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:

  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:

See Go to Location.