Preloading Client Side Server Details
  • 19 Sep 2023
  • 1 Minute to read
  • PDF

Preloading Client Side Server Details

  • PDF

Article summary

It is possible to pre-define the list of servers and their settings for a client to read.

If %appdata%\12dSynergy\ServerAddresses.xml exists, the client application will attempt to read this at start up.

This is part of the roaming user profile for each user.

Note that this will only ADD or UPDATE existing servers. If a server that was previously added is not found in the file, it will not be removed from the server list.

The format is as follows:

<!--
    the root element has an attribute of Add, which can be either Always or NewDatabase
    this determines whether the system should always read the file, or only when it's a new Local Database
-->
<Servers Add="AlwaysOrNewDatabase">
 
   <Server>
      <Name>Server Name</Name>
      <Guid>ServerGuid</Guid> <!-- the Server GUID can be found in your administrative console. if you are connecting to a third party server, please ask the administrator of the remote system -->
      <UseAsDefault>TrueOrFalse</UseAsDefault> <!-- whether or not this server should be the default server when opening the application -->
      <Addresses>
        <!-- you can have one or two addresses at this level - one for local, one for remote -->
        <Address>
          <ServerAddress>MyServerAddress</ServerAddress>
          <FileReplicationServerAddress>OptionalFRSAddress</FileReplicationServerAddress>
          <IsLocal>TrueOrFalse</IsLocal>
        </Address>
      </Addresses>
   </Server>
</Servers>

Here is a sample file.

This will add one server with both a local and remote address, with an FRS for the remote server

<Servers Add="Always">
  <Server>
     <Name>My Synergy Server</Name>
     <Guid>2A7816C6-DDA6-4F08-A608-47FCEA4839D1</Guid>
     <Addresses>
        <Address>
            <ServerAddress>MyLocalServer</ServerAddress>
            <IsLocal>True</IsLocal>
        </Address>
        <Address>
            <ServerAddress>Synergy.MyCompany.com</ServerAddress>
            <FileReplicationServerAddress>FRS.MyCompany.com</FileReplicationServerAddress>
            <IsLocal>False</IsLocal>
        </Address>       
     </Addresses>
  </Server>
</Servers>

Was this article helpful?