Configuring a Ground Link proxy

  • Your Ground Link proxy server has sufficient hardware resources. See the recommended hardware setup.
  • You have and installed on the Ground Link proxy server. However, a separate license for is not necessary.
  • You are logged in to with a login account that has the System administrator server role. To create a login account, see Creating a login account.
  • Your Ground Link proxy server can connect to the on-premises resources (for example, a network folder or an external database) that you want to make available in the vault.

To configure a Ground Link proxy on the Ground Link proxy server:

  1. Open .
  2. In the left-side tree view, expand a connection to server.
  3. Select Ground Link Proxies.
  4. On the right-side pane, select New Ground Link Proxy.
    Result:The New Ground Link Proxy dialog is opened.
  5. Enter a name for the Ground Link proxy.
  6. Select the database engine for Ground Link proxy data.
    • To use , select Use Firebird.
      or
    • To use , select Use Microsoft SQL Server.
    For more information, see Database engine and data storage. Please make a note that while the proxy has a database connection, it does not save any object types, content, user data, or credential information. Thus, you can always use as a database engine for a Ground Link proxy.
  7. Select Define.
    Result:The settings dialog for the search engine is opened.
  8. Complete one of these options:
    OptionDescription
    On the Ground Link Proxy - Firebird dialog
    1. Select the ... button and select the file location for the Ground Link proxy data.
    2. Select OK to close the dialog.
    On the Ground Link Proxy - Microsoft SQL Server dialog Do the steps from 6 to 10 in Migrating the Proxy Database to.
  9. Select OK to close the New Ground Link Proxy dialog.
  10. Install those external repository connectors that your vault will use to the newly created Ground Link proxy.
    Note: If a valid vault application license is necessary for a connector, the license will be for the vault and for the server that contains the vault.

    For more information, see Installing and managing vault applications.

    Example: To get access to on-premises network folders from Cloud, install Network Folder Connector.
    Result:The Ground Link proxy is now ready for configuration.
  11. In the left-side tree view, under Ground Link Proxies, select the newly created Ground Link proxy.
  12. On the Configuration tab, specify these settings:
    Setting name Description Example value
    Enabled This setting specifies whether Ground Link is enabled or not. Yes
    Password Enter a password that you will use when you apply a configuration for a Ground Link service in the vault.
    Channel Network Address Enter the network location of the server to connect to.

    If you connect the Ground Link proxy to an , enter the DNS name of the vault.

    		 aa-consulting.cloudvault.m-files.com
    Port number Enter the port that the server listens. If you connect the Ground Link proxy to an vault, the correct port number is 443.

    If you use the gRPC protocol, use the same port number that your client uses to connect to the server. For more information, see Adding a vault connection.

    Make sure that the necessary ports are open in the firewall.

    		 443 or 7766
    Secure This setting specifies whether a secure (SSL encrypted) channel connection is used. In production environments, insecure connections are not recommended. Yes
    Vault GUID Enter the GUID of your vault.

    To see the vault GUID, open the context menu for the vault and select Properties. The GUID is shown in the Unique ID field in the Document Vault Properties dialog.

    		 {990827D8-8AF2-4A4EB121­4C1A8AD8ECD0}
    Shared Secret Copy the shared secret from the vault configuration. The channel connection cannot be established if the shared secret does not match one of the shared secrets specified for Ground Link.
    Reconnect Interval This value specifies in seconds how frequently the Ground Link proxy tries to connect when the vault is disconnected.

    60 (default value)
    Keep Alive Interval This value specifies in seconds how frequently the Ground Link proxy makes sure that the connection to the vault operates correctly.

    60 (default value)
    Timeouts The timeout values specify in seconds how long remote calls wait for a response. Use the default values.
    Multi-Server Compatibility Check Compatibility This setting specifies whether the multi-server mode compatibility is checked.

    If you connect the Ground Link proxy to an , this setting must be set to Yes.

    		 Yes (default value)
  13. Optional: Specify the other settings.
    For more information, select a setting and see the Info tab.
  14. Select Save.

The connection between the vault and the Ground Link proxy is established. Next, you can set up the Ground Link services in the vault.

You can see the status of the vault connection on the Dashboard tab.