Syncplicity Support

Search our knowledgebase to get the help you need, today

Follow

Adding and Editing StorageVaults

You can add StorageVaults or change their settings in the administrator section of https://my.syncplicity.com/.

Add a StorageVault

Prerequisites
  • This operation requires Global Administrator credentials.
  • Storage Connector must be installed in your environment.
  • You need to know the URL of at least one Storage Connector instance that will connect the new StorageVault to the local storage endpoint.
Procedure
  1. In a browser, navigate to https://my.syncplicity.com/ and log in as a Global Administrator user.
  2. Select Admin → Settings.
  3. Select Manage StorageVaults from the Enterprise Edition Features section.
  4. Click Add StorageVault and configure the following properties.

    Property Description

    Name

    A unique name to identify the StorageVault.

    Description 

    Text that identifies the StorageVault and its intended use.

    Storage Quota

    The maximum amount of storage from this StorageVault that can be used by the Syncplicity account. See Storage Quota.

    Microsoft Integration

    If editing the settings for a StorageVault and the Microsoft Integration feature is enabled for your account, you can choose to enable this feature for this StorageVault. For details see the section about Microsoft Integration for on-premises storage later in this article.

    On-Premises Storage Connector Servers

    The URL of one or more Storage Connectors that allow access to the storage endpoints. For details see the section about on-premises storage connector servers later in this article.

    Secure Shared Files

    If editing the settings for a StorageVault and the Secure Shared Files feature is enabled for your account, you can choose to enable the feature for this StorageVault. Depending on your configuration, you may be able to select the Cloud Rights Management Server or a local Rights Management Server. You can configure the StorageVault to use only one Rights Management Server. Once you select a Rights Management Server, click the associated button to test the connection. See Syncplicity Rights Management.

  5. Click Save to create the StorageVault.
    The new StorageVault appears in the Manage StorageVaults list. An access key is assigned to the StorageVault and you cannot change it. See Access Key.

 

Edit a StorageVault

Prerequisites
  • This operation requires Global Administrator privileges.
Procedure
  1. In a browser, navigate to https://my.syncplicity.com/ and log in as a Global Administrator user.
  2. Select Admin → Settings.
  3. Select Manage StorageVaults from the Enterprise Edition Features section.
  4. Click the name of the StorageVault that  you want to edit.
    The StorageVault Information page opens.

  5. Change the settings as needed.

    Property Description

    Name

    A unique name to identify the StorageVault.

    Description 

    Text that identifies the StorageVault and its intended use.

    Storage Quota

    The maximum amount of storage from this StorageVault that can be used by the Syncplicity account. See Storage Quota.

    Microsoft Integration

    If editing the settings for a StorageVault and the Microsoft Integration feature is enabled for your account, you can choose to enable this feature for this StorageVault. For details see the section about Microsoft Integration for on-premises storage later in this article.

    On-Premises Storage Connector Servers

    The URL of one or more Storage Connectors that allow access to the storage endpoints. For details see the section about on-premises storage connector servers later in this article.

    Secure Shared Files

    If editing the settings for a StorageVault and the Secure Shared Files feature is enabled for your account, you can choose to enable the feature for this StorageVault. Depending on your configuration, you may be able to select the Cloud Rights Management Server or a local Rights Management Server. You can configure the StorageVault to use only one Rights Management Server. Once you select a Rights Management Server, click the associated button to test the connection. See Syncplicity Rights Management.

    NOTE: The access key was assigned when you created the StorageVault and you cannot change it. See Access Key.

  6. Click Save to apply the changes. All settings take effect immediately.

StorageVault Properties

Access key

Every account configured for on-premises storage is provided an access key. An access key is a shared secret between an on-premises deployment and the Syncplicity service. It is used to identify and authenticate the on-premises deployment. Each Storage Connector in your on-premises deployment has the access key entered in its configuration file.

The access key is a critical security token that must not become known to anyone else but the Syncplicity account administrator and the system administrator in charge of the on-premises deployment. If there is any suspicion the access key has been compromised, contact Syncplicity Support immediately.

Storage quota

As files synchronize, the Syncplicity service keeps track of how much data has been uploaded into each user's account, and subsequently into the overall company account. The quota setting in this section defines a limit on the amount of data that can be stored in the storage endpoint. When this limit is exceeded, Syncplicity clients are no longer allowed to upload additional data; users see an "out of space" notification. Use this setting to specify the storage limit for your deployment.

Due to compression and de-duplication, the amount of physical space taken up on your storage endpoint is lower than the amount of space reported in the Syncplicity administrator pages, which affects your quota. The exact delta depends on the type of data your company's users are synchronizing and the compression and encryption settings in your on-premises deployment.

On-premises Storage Connector servers

In addition to an EMC Isilon or EMC Atmos storage backend, each on-premises deployment consists of two or more Storage Connectors. The exact number of Storage Connectors depends on the expected load on the system; your account representative can aid in sizing your specific deployment. Each Storage Connector plays a key role in any on-premises deployment:

  • Exposes upload and download APIs that all Syncplicity clients access when transferring files to and from the Syncplicity account.
  • Compresses and encrypts all data according to a configuration preference.
  • Communicates with the Syncplicity server to authorize client connections and exchange necessary metadata.

Microsoft Integration for on-premises storage

Integration with Microsoft for online viewing and editing of Office documents within the Syncplicity file browser using Office Online, and on mobile devices using Office for mobile, can be configured for on-premises storage. A separate on-premises connector, called the WOPI Connector, must be downloaded, deployed and configured for each StorageVault that you wish to enable this integration. Before continuing with the steps in this section you must first have completed the deployment and configuration of the WOPI connector. For more information, see Deploying Syncplicity On-Premises WOPI Connector.

NOTE: Access to Syncplicity folders in on-premises storage configured with StorageVault Authentication (SVA) is restricted for Microsoft Office for mobile. This is due to the design of SVA and the Microsoft architecture.

Once you have completed the installation and configuration of the WOPI connector, there are still a few more steps to make your Syncplicity files stored in your on-premises storage available to be viewed and/or edited by Microsoft Office. These additional steps are required because Microsoft Office applications communicate through the Syncplicity registered domain. Each Syncplicity on-premises storage endpoint that is to be enabled for Microsoft Integration must be allocated a unique sub-domain of wopi.syncplicity.com.

  1. Contact Syncplicity Support to choose a hostname that will be used to create the WOPI sub-domain. You should contact Support by sending an email to support@syncplicity.com.
    • The generic format of the sub-domain is created by adding your unique hostname to the *.wopi.syncplicity.com domain.
    • For example, for a given hostname "acme-1", the FQDN for your sub-domain would be:
      https://acme-1.wopi.syncplicity.com
  2. Once Syncplicity has confirmed that your unique host name is available, you will need to provide the following information:
    • The externally-addressable IP address for the WOPI Connector. This should be behind a load balancer.
    • The certificate signing request (CSR) file for your sub-domain. The CSR must be generated by you, and will be used by Syncplicity to create the SSL certificate for the registered DNS entry. You will own and retain the private key for this CSR, which you should not share with Syncplicity (or anyone else).
      NOTE: For your security, although you are sharing the CSR with Syncplicity, you will retain sole ownership of the corresponding private key. The CSR data file includes the public key that is paired with your private key. Syncplicity submits the CSR to our SSL Certificate Authority (CA), who creates the SSL certificate without compromising the key itself. Neither Syncplicity nor the CA ever see the private key.
  3. With the provided CSR file, unique hostname and IP address, Syncplicity will generate the SSL certificate and register the FQDN for your sub-domain.
    • Syncplicity needs to create the SSL certificate on your behalf for this sub-domain because we are the registered owners of the top-level domain *.syncplicity.com. Syncplicity has registered this domain with Microsoft for all files accessed through the Syncplicity service.
  4. Syncplicity Support will provide you with the generated SSL certificate and confirmation of the registered sub-domain to you.
    • You will need to install the SSL certificate on the load balancer which is configured for SSL offloading to your WOPI Connector. See the "Prerequisites for the WOPI Connector" article for more details.
  5. For the final step, you need to enable Microsoft Integration.

You should now be configured to start using Microsoft Integration for this StorageVault.

Powered by Zendesk