Upgrading to Card Synchronization plugin 3.2 - Card Synchronization 3.2

Card Synchronization Plugin Guide 3.2

Applies to
Card Synchronization 3.2
Last updated
Content type
Guides > Plugin and extension guides
Card Synchronization
Plugin and extension guides

You can upgrade Card Synchronization plugin from any earlier version directly to version 3.2.

Before you begin

What you should know

  • It is not required to uninstall the plugin before upgrading to the new version.
  • You can upgrade directly from any earlier version to the latest version.
  • The plugin must be upgraded on all Security Center client and server computers.
  • The upgrade keeps your current data sources, imported entities, and all event notifications.
    NOTE: After upgrading, verify the plugin properties to make sure that no data was lost.
  • Starting in version 3.2, the data schemas were redesigned and the Data source configuration wizard was improved. As a result, it is easier to add data sources and map fields. However, only data sources created in the latest version of the plugin have access to the updated schema and wizard. The wizard is unavailable to data sources created in version 3.0 and 3.1 of the plugin.
  • To use the updated schema and the new wizard, delete your data sources, and re-add them.
IMPORTANT: For Security Center and later, the names used to reference native Security Center card formats changed. As a result, if you are using native card format names in your data source, you must change them in your data source to either follow the bit length naming or a card format alias. You can replace existing names using the transform tool in the new Data source configuration wizard. For details, see Card format aliases for use with Card Synchronization plugin.


  1. Deactivate the plugin role.
  2. Open Server Admin, and back up the Directory database.
  3. Install the new version of the plugin.
  4. Activate the plugin role.
    The plugin is ready for use.
  5. If you are running Security Center or later, make sure that the credentials in the data sources are using one of the following format names:
    • bit length, such as 26 bit Wiegand.
    • alias, such as Standard.
  6. If your data source contains native credential format names, replace them either directly in the data source or using the transform tool available in the latest Data source configuration wizard.
  7. If you want to use the latest the Data source configuration wizard, delete all your data sources, and then add them again and re-import the entities using a unique global key.