Preloading Client Side Server Details
  • 23 Aug 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 the ServerAddresses.xml file exists at %appdata%\12dSynergy folder, the 12d Synergy Client application will attempt to read it at startup. This is part of the roaming user profile for each user.

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

1.1. XML file format to Preload the Server  

<!-- 
    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>

1.2. A sample file for Adding one Server with both, Local and Remote Addresses, 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?