Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contentstoc
minLevel1
maxLevel2
outlinefalse
typelist
printablefalse

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

Tipinfo

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. Tenantscan each contain multiple storage domains.

  3. Domains can each contain multiple buckets.

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

Info

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. 

Image Modified 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 installationInstallation, 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:

Code Block
languagexml
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
Info

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:

Image Modified Image Modified

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:

Code Block
languagexml
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.
Image Modified

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. (

...

  1. See Naming Rules for Swarm.)

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

Note

The SYSTEM TENANT 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. (

...

  1. See Naming Rules for Swarm.)

  2. 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.

    Image Modified
  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. (

...

  1. See Naming Rules for Swarm.)

  2. Select Add to save it.

See Configuring Buckets.

Uploading

...

Content

  1. Click the Uploads button from the bucket view.

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

...

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

    Image Modified
Info

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:
    Image Modified

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

Tip

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 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:

    Image Modified
    • 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.