Manage a Registered Repository

Use the tasks below to manage a registered repository.

After you Initialize a Repository, a user with the proper credentials can use the repository. Rather than providing credentials with every command, there is a one-time registration process per user on a host to provide the required credentials. You must complete the registration for any individual host in which a user plans to use the repository. The registration information is retained for the user on the host for any subsequent commands issued to the repository by the user.

Do the following to register an initialized repository:

  1. Log in to the FlexSync Dashboard.

    Do the following to access your FlexSync dashboard.

    Prerequisites

    • You will need a FlexSync user account before you can create a replication task. See Step 4: Manage FlexSync Users.
    • In order to access the FlexSync GUI, the appliance host name must be resolvable through a DNS name or IP address. If you use a DNS name, it must be resolvable on the DNS or it must have a local entry in the local appliance /etc/hosts file.

    1. Access the StorNext User Interface (new UI introduced in StorNext 7.0.1).

    2. On the top navigation, click Services. The Services page appears.

    3. Under the Service Name heading, click the service name that corresponds with your FlexSync service.

      The FlexSync dashboard appears.

  2. In the Hosts column, click the Registered Repositories icon.

    The Registered Repositories page appears.

  3. Click the Register New Repository icon.

    The Register New Repository dialog appears.

  4. In the Register New Repository dialog, complete the information:

    Parameter

    Description
    Repository Name

    Select the name of the repository to associate with your registered repository.
    Type

    Select the type of repository.

    The default is S3.
    Hostname

    Enter the Uniform Resource Identifier (URI) of the S3 endpoint being used for the repository (for storage and retrieval of an object).

    For example:

    s3.us-west-2.amazonaws.com
    Bucket Name Enter the name of the S3 bucket.
    User Name Enter the user name or access key ID of your repository, assigned during creation of your S3 bucket.
    Password Enter the password or secret access key of your repository, assigned during creation of your S3 bucket.
    Port Enter the port on which the S3 endpoint is available.
    Signing

    Specifies the type of signing to use on S3 requests. Click V2 or V4.

    The default is V2.
    SSL Displays if the SSL protocol is enabled or disabled on your repository.
    Register Hostgroup

    Select the hostgroup to associate with your registered repository.
    Register Host

    Select the host to associate with your registered repository.
    Register User

    Enter the user account on your host system to associate with your registered repository. The user account you enter is used to identify who performs a commit process to the repository.

    Note: The user must already exist on the host system; if you have access to the S3 credentials, you cannot register an initialized repository unless the user account you are attempting to register with already exists on the host system. The user does not imply ownership of the S3 repository. By default, the root user is registered.

  5. Click Save. If successful, the registered repository appears in the Registered Repositories page.

Do the following to deregister an initialized repository:

  1. Log in to the FlexSync Dashboard. See Access the FlexSync Dashboard.

  2. In the Hosts column, click the Registered Repositories icon.

    The Registered Repositories page appears.

  3. Click the Unregister Repository From Host icon.

    A confirmation dialog appears.

  4. Click Delete to confirm the operation, or click Cancel to abort the operation and return to the previous page. A confirmation dialog appears.

  5. In the confirmation field, enter DELETE and then click Delete. If successful, the Repository <repository> unregistered dialog appears.

Do the following to view details of a registered repository:

  1. Log in to the FlexSync Dashboard. See Access the FlexSync Dashboard.

  2. In the Hosts column, click the Registered Repositories icon.

    The Registered Repositories page appears.

  3. Click the Repository Details icon.

    The Repository Details dialog appears.

You can only edit a managed repository using the flexsyncadmin edit-register-config CLI command. For complete details regarding the flexsyncadmin edit-register-config command, see the FlexSync Man Pages Reference Guide.