Skip to main content
Hitachi Vantara Knowledge

Namespace Browser

This section of the Help contains information on using the HCP Namespace Browser.

Introduction to the Namespace Browser

The HCP Namespace Browser lets you manage namespace content and view information about namespaces. This chapter contains instructions for logging in to the Namespace Browser and describes the Browser interface.

About the Namespace Browser

The Namespace Browser is an easy-to-use web application that lets you:

  • Navigate and manage namespace content
  • View information about namespaces

When you work with namespace content, you can list directories and view or retrieve objects. You can also manage namespace content by adding directories and by adding and deleting objects. If versioning is enabled, you can list, view, and retrieve old versions and view deleted objects.

When you view information about namespaces, the Browser can display the namespaces that you can access, retention classes that you can use in a namespace, permissions for namespace access, and statistics about a namespace.

Depending on the namespace configuration, you can log into the Namespace Browser as an authenticated user or you can log in anonymously. If the namespace supports Active Directory authentication, it can also be configured to support single sign-on. With single sign-on, if you’re logged in to a Windows client with an AD user account that HCP recognizes, you do not need to explicitly log into the Namespace Browser.

NoteIf the namespace is configured to support single sign-on, you cannot log into the Namespace Browser anonymously.

For single sign-on to work, your web browser must be configured to support it.

The information you see and actions you can perform in the Namespace Browser depend on the permissions you have.

Namespace Browser sessions

A Namespace Browser session begins when you take one of these actions:

  • Log into the Browser using an HCP user account.
  • Log into the Browser anonymously.
  • Access a Browser page using single sign-on.
  • Log into the Browser using a recognized AD user account other than the one with which you’re currently logged in to Windows.

A session ends when you log out.

During a session, if you don’t take any action for a certain amount of time, the Browser displays an idle timeout message. When you try to click an option in the Browser menu bar at the top of the page, the Namespace Browser automatically logs you out if you explicitly logged in or, in the case of single sign-on, allows you to go to the page you clicked. The exact amount of idle time allowed is determined by the tenant configuration.

Accessing the Namespace Browser

Procedure

  1. Open a web browser window.

  2. In the address field, enter the URL for the namespace you want to access, in this format:

    http[s]://namespace-name.tenant-name.hcp-domain-name/browser
    For example, to use HTTPS to browse the finance.europe.hcp.example.com namespace, enter:
    https://finance.europe.hcp.example.com/browser
    The namespace configuration determines whether you need to use HTTP or HTTPS.
    Note
    • You cannot use an IP address in the URL to access the Namespace Browser.
    • If you enter a URL that includes /rest, HCP redirects you to a URL that includes /browser.

Results

One of these happens:
  • If all of these are true, you’re automatically logged in to the Namespace Browser, which opens to the Content page:
    • The namespace supports AD authentication.
    • Your web browser is configured to support single sign-on.
    • You’re currently logged in to a Windows client with an AD user account that HCP recognizes.

    This is single sign-on. No further action is required.

  • If both of these are true, the Namespace Browser opens to the Content page:
    • The namespace does not support AD authentication.
    • The namespace supports anonymous access through the HTTP protocol.

    In this case, you access the Namespace Browser as an unauthenticated user. No further action is required.

  • If both of these are true, the Namespace Browser login page appears:
    • The namespace does not support AD authentication.
    • The namespace requires user authentication for access to the Namespace Browser.
    NoteThe URL for the Namespace Browser login page always includes HTTPS. If the namespace does not support HTTP with SSL security, the URL for the login page includes HTTPS but the URLs for other Namespace Browser pages include HTTP.
  • If the namespace supports AD authentication but any of the following are true, a message appears indicating that single sign-on was not possible:
    • Your web browser is not configured for single sign-on.
    • You’re not logged in to a Windows client with an AD user account that HCP recognizes.
    • You’re not on a Windows client.

    Click the link to display the Namespace Browser login page.

Logging into the Namespace Browser as an authenticated user

Procedure

  1. On the Namespace Browser login page, enter your user name and password.

  2. If the namespace supports AD authentication, in the Domain field, take either of these actions:

    • If you’re accessing the Namespace Browser with an AD user account, select the AD domain in which your user account is defined.
    • If you’re accessing the Namespace Browser with a user account that’s defined in HCP, select the domain name of the HCP system.
  3. Click Log In.

Results

The Namespace Browser opens to the Content page.

Logging into the Namespace Browser anonymously

Procedure

  1. On the Namespace Browser login page, select Log in anonymously.

  2. Click Log In.

Results

The Namespace Browser opens to the Content page.

Common elements

All Namespace Browser pages have these options in the menu bar at the top of the page:

  • Content

    Displays the top-level directories in the current namespace.

  • Namespace

    Displays the list of namespaces you can access and provides access to information about these namespaces.

  • Search HCP

    Opens the HCP Search Console.

    This option appears only if search is enabled for the namespace.

  • Log Out

    Logs you out and displays the login page.

  • Password

    Displays the Change Password page.

    This option is not available if you used an Active Directory user account to access the Namespace Browser or if you accessed the Browser anonymously.

Changing your password

If you are accessing the Namespace Browser with a locally authenticated HCP user account, you can change your password in the Namespace Browser. When you change your password in the Namespace Browser, it also changes the password for any other HCP interfaces to which your user account gives you access.

The next procedure describes how to change your password using the Namespace Browser.

Procedure

  1. In the Namespace Browser menu bar, click Password.

  2. On the Change Password page:

    1. In the Existing Password field, type your current password.

    2. In the New Password field, type your new password.

      Passwords can be up to 64 characters long, are case sensitive, and can contain any valid UTF-8 characters including white space. To be valid, a password must include at least one character from two of these three groups: alphabetic, numeric, and other. When changing your password, you cannot reuse your current password.
    3. In the Confirm New Password field, type your new password again.

  3. Click Update Password.

Next steps

To continue using the Namespace Browser after you change your password, navigate to another page.

Working with namespace contents

Listing directory contents

To list the contents of a directory in a namespace, click Content in the Namespace Browser menu bar and navigate to the directory you want. Each directory name is a link that lists the directory contents.

All directory listing pages, except the page that lists the top-level directories, have a parent directory icon (GUID-82EEE6AB-2EE9-47AC-B8B5-BAA524A917A5-low.png) in the upper left next to the directory path. Click this icon to display the parent directory.

Directory listing

The directory listing displays information about the objects in a directory and provides access to subdirectories, symbolic links, and object versions.

The Namespace Browser displays up to 100 entries at a time. If a directory has more than 100 entries, you can use the Previous and Next buttons to page through the directory to see all its contents.

Click any column heading to sort the listing by the column values. Clicking a heading alternately sorts in ascending and descending order.

The list below describes the information shown for each item in the directory listing.

  • Type icon

    An icon indicating the item type:

    • GUID-3D264010-44EB-493A-9197-45389669AAD8-low.png

      Directory

    • GUID-E5E008E4-5204-44EF-B255-87967CDB6DF5-low.png

      Object or symbolic link

    • GUID-39E82983-397F-4957-8FF3-1B1705B05BBB-low.png

      Deleted object

    Click the icon to display the directory contents, view or retrieve the object, or read through the symbolic link. Clicking the icon for a deleted object has no effect.

  • Action icon

    • GUID-92F5D750-CD63-42A2-8A46-856A5CE62AD9-low.png

      A control for deleting an object or symbolic link. This icon appears only if the item can be deleted.

    • GUID-BFCBA7B0-8059-4DC3-BDCD-310C3D493A8C-low.png

      A control for listing object versions. This icon appears if versioning is enabled for the namespace.

  • Name

    The name of the item. If deleted objects are displayed, their names are crossed-out.

    Click the name to display the directory contents, view or retrieve the object, or read through the symbolic link.

  • Owner

    The user that owns the object, if any.

  • Domain

    If the object is owned by an Active Directory user, the AD domain in which the user account for the object owner is defined.

  • Size

    The object size, in bytes.

  • Retention

    The retention setting as a date and time or as a special value such as Deletion Allowed.

  • Retention Class

    The retention class name, if any.

  • Ingested

    A representation of the state of the object metadata:

    • GUID-DDA8DE95-2A9E-489D-98EC-4F487DB71900-low.png

      The object is on hold.

    • GUID-7935AC47-5BEC-45C2-8399-F3FB91307FE5-low.png

      The object will be shredded when it’s deleted.

    • GUID-6015994C-25E4-47CD-9CCF-73772FCE0A46-low.png

      The object is marked for indexing.

    • GUID-493C2CE5-F6A0-40D8-8706-7F9C76D791F9-low.png

      The object has one or more annotations. Clicking this icon displays a list of annotations. You can then click the name of an annotation to view its contents.

    • GUID-ED391B38-A39A-41DA-BEB7-B527E483A9C7-low.png

      The object has an ACL. Click this icon to view the ACL.

  • DPL

    The data protection level.

  • Hash (algorithm-name)

    Hash information for the object. Move the hover over the View Hash link to display the hash value. You can then highlight the value and copy it to the clipboard.

By default, when you click an object or custom metadata icon in the Namespace Browser, the object content or custom metadata is displayed in the browser window, if possible. If the object content or custom metadata contains a script that can be executed by that browser, that script is executed. If this is an issue for you, ask your tenant administrator about having the display behavior changed.

TipYou can use the view-source option in the web browser to see the XML for the Namespace Browser page.

Showing and hiding deleted objects and directories

By default, the directory listing does not include deleted objects, directories, or symbolic links. If the namespace has versioning enabled, you can show or hide deleted items by clicking the link that says Show deleted objects (if deleted objects are not being shown) or Hide deleted objects (if they are being shown).

When you show deleted items, you can click a deleted directory to view the list of objects, subdirectories, and symbolic links that it contained. All items in a deleted directory are also deleted. Deleted items are visible until HCP removes them from the system.

Listing object versions

To view a list of the versions of an object, browse to the directory that contains the object and click the version icon (GUID-BFCBA7B0-8059-4DC3-BDCD-310C3D493A8C-low.png) for the object. If the directory listing includes deleted objects, you can list the versions of the deleted objects.

All version listing pages have a parent directory icon (GUID-82EEE6AB-2EE9-47AC-B8B5-BAA524A917A5-low.png) in the upper left next to the object path. Click this icon to display the directory that contains the object whose versions are listed.

Version history list

The version history list shows all versions of an object that remain in the namespace.

The Namespace Browser displays up to 100 entries at a time. If an object has more than 100 versions, you can use the Previous and Next buttons to page through all the versions.

If the list displays delete markers, they appear in gray text. In a row for a delete marker, the Version and Ingested columns show information for the delete marker (that is, the deletion record). All other columns show information about the version that was deleted.

Click any column heading to sort the list by the column values. Clicking a heading alternately sorts in ascending and descending order.

The list below describes the information displayed for each item in the version list.

  • Type icon

    An icon indicating the version type:

    • GUID-E5E008E4-5204-44EF-B255-87967CDB6DF5-low.png

      Normal version. Click this icon to view or retrieve this version.

    • GUID-39E82983-397F-4957-8FF3-1B1705B05BBB-low.png

      Delete marker. This icon is inactive.

  • Version

    The version ID. Click this entry to view or retrieve this version.

    If the entry represents a delete marker, the ID is inactive.

  • Owner

    The user that owns the object, if any.

  • Domain

    If the object is owned by an Active Directory user, the AD domain in which the user account for the object owner is defined.

  • Size

    The object size, in bytes.

  • Retention

    The retention setting as a date and time or as a special value such as Deletion Allowed.

  • Retention Class

    The retention class name, if any.

  • Ingested

    One of:

    • For object versions, the date and time the version was added to the namespace.
    • For delete markers, the date and time the object was deleted.
  • Metadata

    A representation of the state of the metadata for the version:

    • GUID-DDA8DE95-2A9E-489D-98EC-4F487DB71900-low.png

      The object is on hold. All versions of an object have the same hold setting.

    • GUID-7935AC47-5BEC-45C2-8399-F3FB91307FE5-low.png

      The version will be shredded when it is deleted.

    • GUID-6015994C-25E4-47CD-9CCF-73772FCE0A46-low.png

      The version is marked for indexing.

    • GUID-493C2CE5-F6A0-40D8-8706-7F9C76D791F9-low.png

      The version has one or more annotations. Clicking this icon displays a list of the annotations. You can then click the name of an annotation to view its contents.

    • GUID-ED391B38-A39A-41DA-BEB7-B527E483A9C7-low.png

      The version has an ACL. Click this icon to view the ACL.

  • DPL

    The data protection level.

  • Hash (algorithm name)

    Hash information. Hover over the View Hash link to display the hash value for the object. You can then highlight the value and copy the hash value to the clipboard.

Listing versions of deleted objects and directories with the same name

A directory listing in the Namespace Browser can include only one item with a specific name, but a version listing for a deleted object can include entries for both the object and a deleted directory with the same name. The following example shows how this can happen

Procedure

  1. Create a directory named test1.

  2. In the test1 directory, create and delete a subdirectory named test2.

  3. In the test1 directory, save and delete an object with the name test2.

  4. List the contents of the test1 directory and select Show deleted objects.

    The test1 directory listing includes the deleted test2 object but not the deleted test2 directory.
  5. List the versions of the test2 object and select Show deleted objects.

    The version list includes the deleted test2 directory.
    NoteIf you create and delete the test2 object before you create the test2 directory (whether you delete the test2 directory or not), you cannot list versions of test2 in the Namespace Browser, and you cannot see the deleted object versions. You can however, use direct HTTP requests (for example, with curl) to get this information.

Accessing objects

To view or retrieve an object, navigate to the directory that contains the object and click the object name or the type icon to the left of the object name. The browser downloads the object data and either opens it in the default application for the content type or prompts to open or save it.

Accessing old versions of an object

  1. Navigate to the directory that contains the object.

  2. Click the version icon (GUID-BFCBA7B0-8059-4DC3-BDCD-310C3D493A8C-low.png) to display a list of the versions of the object.

  3. In the version list, click the version ID or type icon for the version you want.

Storing objects and versions

Procedure

  1. Navigate to the directory in which you want to store the object or version.

  2. If the Upload Object tab is not active, click it.

  3. Click Browse. Then select the file you want.

  4. Click Upload.

Results

The new object is added with the default metadata values for the namespace.

Deleting objects and symbolic links

Procedure

  1. Navigate to the directory that contains the object or symbolic link.

  2. Click the delete icon (GUID-92F5D750-CD63-42A2-8A46-856A5CE62AD9-low.png) for the object or link you want to delete.

    NoteDeleting a symbolic link deletes the link itself, not the target object.
  3. In response to the confirming message, click OK.

Results

If the list displays deleted objects, the object name is crossed-out. If the list does not display deleted objects, the object disappears from the list.

Creating directories

  1. Navigate to the parent directory.

  2. If the Create Directory tab is not active, click it.

  3. Enter the name of the new directory in the entry field below the Create Directory tab.

  4. Click Create.

Viewing namespace information

Viewing accessible namespaces

You can use the Namespace Browser to view a list of the namespaces to which you have access. When you view accessible namespaces, the list shows all namespaces owned by the specified tenant for which you have at least one permission.

NoteIf you’re accessing the Browser anonymously, this list can include namespaces that allow anonymous access through protocols other than HTTP but do not allow anonymous access through HTTP. You cannot access such namespaces anonymously through the Namespace Browser.

To view the namespaces that you can access, click Namespaces in the Namespace Browser menu bar.

Namespace information

The Namespaces page contains a list of the namespaces you can access. For each namespace, the list shows:

  • Namespace name.
  • Hash algorithm.
  • Data protection level.
  • Whether versioning is enabled.
  • Whether search is enabled.
  • Retention mode. This mode affects whether privileged operations are allowed on objects. A namespace can be in either of two retention modes: compliance or enterprise. In enterprise mode, privileged operations are allowed. In compliance mode, they are not allowed.
  • Default shred setting for objects added to the namespace.
  • Default index setting for objects added to the namespace.
  • Default retention setting for objects added to the namespace.
  • Namespace description.

Managing the namespace list

By default, the namespace list on the Namespaces page includes all existing namespaces. The namespaces are listed 20 a time in ascending order by namespace name.

You can page through, sort, and filter the list of namespaces. The Namespaces page indicates which namespaces are shown out of the total number of namespaces in the current list.

Paging

You can change the number of namespaces shown at a time on the Namespaces page. To do this, in the Items per page field, select the number of namespaces you want. The options are 10, 20, and 50.

To page forward or backward through the namespace list, click the next (GUID-E53D8EEE-3705-4C3C-B18A-BEB5FB24120A-low.png) or back (GUID-18C7E4A4-FD0B-42E4-B8A2-398D820683E9-low.png) control, respectively.

Procedure

  1. In the Page field, type the page number you want.

  2. Press Enter.

Sorting

You can sort the namespace list in ascending or descending order by namespace name or by hard quota. To sort the list, click the column heading for the property you want to sort by. Each time you click the column heading, the sort order switches between ascending and descending.

Filter using filter fields

You can filter the namespace list by namespace name or tag. The filtered list includes only those namespaces with a name or tag, as applicable, that begins with a specified text string.

You can filter the namespace list by name or by tag by using the fields above the list.

Procedure

  1. In the field above the Name column, select Name to filter by name or Tag to filter by tag.

  2. In the next field, type the text string you want to use as a filter.

    This string can be up to 64 characters long, can contain any valid UTF-8 characters except commas (,), and is not case sensitive. White space is allowed.
  3. Click the find control (GUID-6E913982-4DF5-4877-8C35-9F689D3C126D-low.png).

Next steps

To redisplay the entire list of namespaces after filtering it, click the clear filter control (GUID-2642447B-5A00-4823-9C72-F52C8FB6018E-low.png).
Filter using tag control
  1. Click the tag control (GUID-DC59DF92-A92F-457B-8A8E-72034AEF04E5-low.png) on the right above the namespace list.

    The Tags window opens. This window lists all the tags currently associated with the existing namespaces owned by the current tenant. For each tag, the window shows the number of associated namespaces.
  2. Click the tenant-count icon (GUID-D2C90165-8D35-47E7-BA1C-8D1EA272E7B8-low.png) for the tag you want.

    The namespace list shows only the namespaces that have the selected tag, and the fields above the Name column show the filter criteria.

Viewing namespace statistics and description

  1. In the Namespace Browser menu bar, click Namespaces to open the list of accessible namespaces.

  2. Click the row for the namespace you want.

    The Overview panel for the namespace opens. In this panel, if a description has been specified for the namespace, the description appears below the namespace statistics.

Namespace statistics

  • Total Capacity (Bytes)

    The number of bytes of storage allocated to the namespace. This is the total space available for all data stored in the namespace, including object data, metadata, and the redundant data required to satisfy the namespace DPL.

  • Used Capacity (Bytes)

    The number of bytes currently occupied by all data stored in the namespace, including object data, metadata, and any redundant data required to satisfy the namespace DPL.

  • Soft Quota

    The percentage of the Total Capacity value at which HCP notifies the tenant that free storage space for the namespace is running low.

  • Object Count

    The number of objects, including old versions of objects, stored in the namespace.

    Each multipart object counts as a single object. Objects that are in the process of being created by multipart uploads are not included in the object count.

    The object count does not include object versions that are delete markers.

  • Shred Object/Part Count

    The total number of these items waiting to be shredded: objects, old versions of objects, parts of multipart objects, parts of old multipart versions of objects, replaced parts of multipart uploads, parts of aborted multipart uploads, unused parts of completed multipart uploads, and transient parts created during the processing of certain multipart upload operations.

  • Shred Object/Part Size

    The total number of bytes of object, object version, and part data and metadata waiting to be shredded.

  • Custom Metadata Object Count

    The number of objects and object versions that have one or more annotations.

  • Custom Metadata Size

    The number of bytes occupied by all annotations for all objects and object versions.

Viewing permissions

View the permissions for the namespace and the current user.

Procedure

  1. In the Namespace Browser menu bar, click Namespaces to open the list of accessible namespaces.

  2. Click the row for the namespace you want.

  3. Click the Permissions tab.

Namespace permissions

  • Namespace namespace-name‘s permissions

    The permissions specified for the namespace.

  • Namespace namespace-name’s effective permissions

    The permissions that are in effect for the namespace. This is the logical AND of the permissions specified at the system, tenant, and namespace levels.

  • User account user-name’s permissions

    Your user permissions.

  • User user-name’s effective permissions

    The permissions that are in effect for the combination of the namespace permissions and your user permissions. This is the logical AND of the permissions specified for the system, tenant, and namespace and your user permissions.

Viewing retention classes

Procedure

  1. In the Namespace Browser menu bar, click Namespaces to open the list of accessible namespaces.

  2. Click the row for the namespace you want.

  3. Click the Retention Classes tab.

Results

For each retention class, the Namespace Browser shows:
  • Retention class name
  • Retention setting
  • Whether to automatically delete objects in the class after their retention periods expire
  • Retention class description

 

  • Was this article helpful?