COBRAS

Contents

COBRAS Overview. 1

COBRAS “Hot Mode” vs. “Briefcase Mode” 1

A Word about Phone Passwords. 2

Obtaining Updates. 2

Revision History. 2

Import For Unity 4.x/5.x/7.x/8.x. 2

Export For Unity 4.x/5.x/7.x/8.x. 8

Export For Connection 1.2(1) 17

Export For Connection 7.x/8.x. 19

Import For Connection 7.x/8.x. 28

COBRAS Overview

Consolidated Object Backup and Restore Application Suite (COBRAS) is a set of tools designed to allow administrators to backup all subscribers, call handlers, interview handlers, name lookup handlers, public distribution lists, and schedules and to restore some or all of that information onto another Unity or Connection server.  It is specifically designed to allow for partial restores, restores onto different versions or products than the version that was backed up, and “merges” of data from multiple system backups.  This tool does not provide the same functionality as DiRT (Disaster Recovery Tools) for Unity or the DRS (Disaster Recovery Service) built into Unity Connection in that it does not do a full backup of the entire database and restore it “en mass” on a new server. 

There are two separate help files for COBRAS – one for each “mode” it runs in – the following links will open the respective help files with details on how COBRAS works in that mode:

Briefcase Mode (the most common) help.

Hot Mode for Connection to Connection migrations help.

COBRAS “Hot Mode” vs. “Briefcase Mode”

COBRAS works in two different modes.  The most common is “Briefcase Mode” which is what most sites will use and has been out in production for some time now.  In Briefcase Mode you can do a backup of Unity or Unity Connection and then restore that backup or only selected objects from that backup onto another Unity or Unity Connection server (see the Version Support section in the Briefcase Mode help file above for details).  In Briefcase Mode there are never any changes made to the system that is backed up.  You can restore some or all of the data to multiple target systems as many times as you like.  The intent here is to allow sites to copy data from one install to another even when there is no direct network connection between the two – like putting the backup in you briefcase and walking to a new network to restore it.

Briefcase Mode is by far the more common usage scenario.

Hot Mode” is designed for Connection to Connection migrations where both Connection servers are running 8.5 or later and are configured into a digital network.  This is used for load balancing users between servers in a digital network.

The primary difference for Hot Mode is that users are MOVED from the source server to the target server.  In other words the user’s mailstore is no longer homed on the source server (Unity or Connection depending on which version you’re running), but instead on the new target Unity Connection server in the digital network.  In short there ARE changes made to the source server in this case – it’s not just a simple backup and copy operation as far as users are concerned.  Call handlers, interview handlers, name lookup handlers and schedules are still copied from the source to the target Unity Connection server – only users are treated differently when running in Hot Mode.

More details about the migration process itself and differences with Briefcase mode can be found in the respective help files which you can open at the links above.

A Word about Phone Passwords

Since this affects all COBRAS import/exports modes (briefcase, hot mode, tenants) it’s being added here at the top level for clarity.  A number of escalations of late have been raised claiming that COBRAS does not properly preserve PINs (phone passwords) when migrating across versions.  To be clear COBRAS support migrations of PINs perfectly from any version of Unity and Unity Connection into any version of Connection 7.0(2) and later.  Period.  This has been tested hundreds of times and never fails.

However – if you are migrating a site that never requires users to change their PINs (I’ve seen sites with 10 year old PINs!) and you are doing migrations of systems that have previously been migrated from older versions of Unity or Connection these old PINs will very likely not work on your new system.  This is not a bug and it cannot be fixed and there is no way around it.  Short version sites that have such unsecure practices such as never requiring PINs and passwords be changed will experience pain during migrations – by design.  Tools such as User Data Dump have features which allow you to determine how long PINs have been around and “spot” older style PIN constructions to assist with this but in reality everyone should change their PIN at least once a year at an absolute minimum. 

So why is this you ask?  PINs and passwords are stored as a hash string.  This means when the system is validating “1831209” as John Smith’s PIN at login time it is not “unencrypting” their PIN in the database and comparing it to 1831209 to see if it matches.  No well-designed system does that for any password construction.  Instead it hashes the PIN entered by the user with the same algorithm and seed string(s) and sees if it matches the hash string in the database for John Smith.  No one can ever know what the actual PIN really is – it’s stored as a “one way hash” by design.  If someone hacks your DB and gets the hash they can’t reverse engineer it to find out what the PIN is and then log in as that user.  That’s the point of the design.

Over the years there have been a number of hash methods used in Unity (on Windows) and Connection (on Windows and Linux).  Older hash styles are supported in the newer systems so that migrations from older versions work.  When COBRAS imports the user it notes to the new system what version these users are coming from such that it knows which hash pattern to use.  This is how exports of 7.03 that are imported into 10.0(1) allow users to log into their mailboxes even though 7.0 and 10.0 use different hash algorithms natively.  This works from all versions and is regularly tested.

However, and this is an important “however”, if you import from, say, Unity 5.0(1) into Connection 7.0(3) and then allow your users to NEVER change their PINs for years and then export from 7.0(3) into 10.0(1) what happens?  Bad things happen.  COBRAS notes that the version being imported from is 7.0(3) such that the Connection 10.0(1) system knows to use the hash style for that version.  However, since the site never changed any of their PINs in years it’s actually using a VERY old hash style from Unity 5.0(1).  When 10.0(1) goes to validate the user’s PIN when they log in it uses the hash style for 7.0(3) and, surprise, it does not match. 

Yes, there are all kinds of insecure and hacky methods to try and “guess” which PIN style is used based on length, string style etc… that COBRAS would try and use to work around this and allow users to keep the same PINs forever.  These are difficult, unreliable and represent a rather large amount of ongoing work.  These will not be happening. 

So if your site feels that minimum modern password and PIN security measures are more trouble than they’re worth then expect to have difficulty keeping these stale passwords and PINs across multiple migrations of Unity and Connection systems.  We recommend that if you’re faced with such a situation that you get all your users to change their PINs at least once before migrating.  Again, tools like User Data Dump and simple “change password at next login” features built into Connection make this reasonably easy for administrators to enforce and monitor.  If that is considered to “intrusive” to the user base then expect to have to reset everyone’s password during migration – COBRAS has such a feature built into it or you can use other tools such as the Password and PIN Reset tool that can be used to assign random PINs to all users and generate a CSV file for administrators to use for emailing purposes or the like.

Obtaining Updates

To check for updates to all the COBRAS tools, visit http://www.ciscounitytools.com/Applications/General/COBRAS/COBRAS.html

Revision History

Import For Unity 4.x/5.x/7.x/8.x

1.1.32 – 3/10/2011

·         Updated all the link resolution forms to force the grid to ignore bogus edit events fired in some remote login scenarios (remote desktop access or VNC).

1.1.31 – 11/2/2010

·         Replaced FRM20 controls with the HexUnicode controls for UTF8/16 text display.

1.1.30 – 5/6/2010

·         Updated help to clarify secure message support.

1.1.28 – 1/26/2010

1.1.26 – 1/13/2010

1.1.24 – 11/24/2009

1.1.22 – 11/13/2009

1.1.21 – 9/29/2009

1.1.20 – 8/22/2009

1.1.19 – 6/2/2009

1.1.18 5/28/2009

1.1.17 – 5/12/2009

1.1.16 – 4/27/2009

1.1.15 – 4/8/2009

1.1.14 – 2/3/2009

1.1.13 – 1/30/2009

1.1.11 – 12/23/2008

1.1.9 – 12/20/2008

1.1.5 -12/12/2008

1.1.4 – 12/3/2008

1.1.3 – 12/1/2008

1.1.1      – 11/9/2008

1.0.37 – 10/17/2008

1.0.36 – 10/14/2008

1.0.35 – 10/4/2008

1.0.34 – 9/19/2008

1.0.31 – 8/29/2008

1.0.30 – 8/25/2008

1.0.29 – 8/7/2008

1.0.28 – 7/25/2008

1.0.27 – 6/30/2008

1.0.26 – 6/24/2008

1.0.24 – 6/9/2008

1.0.22 – 5/20/2008

1.0.21 – 5/15/2008

1.0.19 – 4/14/2008

1.0.17 – 3/31/2008

1.0.14 – 3/18/2008

1.0.13 – 1/21/2008

1.0.12 – 1/3/2008

1.0.11 – 12/26/2007

1.0.8 – 12/18/2007

1.0.7 – 12/13/2007

1.0.4 – 11/21/2007

1.0.3 – 11/12/2007

1.0.2 – 11/5/2007

1.0.1 – 10/30/2007

Export For Unity 4.x/5.x/7.x/8.x

7.0.128 – 12/5/2013

·         Updated MDB file definition to accommodate 256 characters of static text in notification devices. 

·         Updated message export logic for secure messages.

7.0.125 – 9/17/2013

7.0.124 - 1/9/2013

·         Added more logging, debug output and error handling around fetching license data via the ASP usage statistics page - unexpected content on the page was causing parsing errors which resulted in all license data not being written out to the database during export.

7.0.122 – 9/20/2012

·         Added more logging/diag info around the licensing extraction – additional checks against MAC/hostId values and around reading effectiveLicense ASP page.

7.0.121 - 8/13/2012

·         Fixed a problem with the licensing export where redundant dictionary keys were not being explicitly checked before trying to add a new key item.

7.0.120 – 11/8/2011

7.0.119 – 10/21/2011

·         Added logic to push the DOH timezone hash for the Windows default timezone into the Subscriber table for users set to NULL (meaning they use Window’s timezone).  This allows us to import users and preserve their timezone even when the system timezone is not the same (i.e. on a typical regional “merge” scenario).

7.0.118 – 9/27/2011

·         Added logic to gather licensing data into the backup for all Unity exports.  This data will get used when migrating to Connection 9.0 and later for the new enterprise licensing server model coming in that release.

7.0.116- 9/23/2011

7.0.114 – 9/2/2011

·         Fixed the install to include a newer version of the secure message encryption library for Unity 5.0 and an updated ZIP library to resolve a problem decrypting and then storing secure messages in the MDB file.

7.0.113 – 8/17/2011

·         Added “/JustBackupUsers” CLI option.

7.0.112 – 7/11/2011

·         Fixed a problem where limited backups (via CLI option) do not offer the option to export secure messages in addition to regular voice messages.

7.0.111 – 6/19/2011

·         Fixing problem exporting from multiple switch configuration situations for non primary call handlers configured for alternate switch ID’s.  These were being output as 0 in all cases.

7.0.109 – 5/20/2011

·         Adding support for Unity 4.0(4) and 4.0(3) exports for migration to Connection only (no imports into Unity from these versions will be supported).

7.0.107 – 5/7/2011

·         Changed message export logic to use rolling GUIDs for all temporary WAV file names for compound and non secure messages during export to prevent issues where the OS is “lagging” in releasing handles to WAV files during packing and unpacking of files to the database.

7.0.106 – 1/24/2011

·         Added user count to progress display instead of just percentage complete for message export view.

7.0.104 – 11/2/2010

·         Fixed a problem with the message age filter that was not properly excluding messages older than the number of days requested on the main form.

7.0.103 – 10/18/2010

·         Added support for MAPI MessageID export of messages from Exchange to be used on import into Connection 7.x and later to preserve uniqueness.

7.0.100 – 9/1/2010

·         Fixed a problem with UCI hot mode backups of directory handlers kicking out bogus errors.

7.0.98 – 7/10/2010

7.0.95 – 6/2/2010

7.0.94 – 4/30/2010

7.0.93 – 4/28/2010

7.0.90 – 4/12/2010

·         Added support for including secure messages in the output for Unity 5.0 and later exports.

7.0.88 – 4/1/2010

·         Added more details to the name lookup handler export routine for future inclusion in Connection 7 and later restores.

7.0.87 – 3/10/2010

7.0.86 – 1/27/2010

7.0.83 – 12/14/2009

7.0.82 – 12/4/2009

·         Added additional debug output surrounding menu entry export and notification device exports when the “debug output” option is selected.

7.0.73 – 11/17/2009

7.0.72 – 11/5/2009

7.0.71 – 11/3/2009

7.0.69 – 10/23/2009

7.0.68 – 10/20/2009

7.0.67 – 9/29/2009

7.0.66 – 9/24/2009

7.0.65 – 9/18/2009

7.0.64 – 8/4/2009

7.0.62 – 7/29/2009

7.0.61 – 7/24/2009

7.0.60 – 6/12/2009

7.0.59 – 6/6/2009

7.0.58 – 5/27/2009

7.0.57 – 5/14/2009

7.0.56 – 5/4/2009

7.0.53 – 4/14/2009

7.0.51 – 4/8/2009

7.0.50 – 4/1/2009

7.0.49 – 3/18/2009

7.0.48 – 3/11/2009

7.0.47 – 2/20/2009

7.0.46 – 2/3/2009

7.0.45 – 12/23/2008

7.0.44 – 12/20/2008

7.0.41 – 12/11/2008

7.0.36 – 11/25/2008

7.0.35 – 11/20/2008

7.0.34 – 11/12/2008

7.0.33 – 11/6/2008

7.0.30 – 11/2/2008

7.0.29 – 10/31/2008

7.0.28 – 10/22/2008

7.0.26 – 10/19/2008

7.0.25 – 10/14/2008

7.0.24 – 9/19/2008

7.0.22 – 9/18/2008

7.0.21 – 9/11/2008

7.0.20 – 8/29/2008

7.0.19 – 8/1/2008

7.0.18 – 7/25/2008

7.0.17 – 6/20/2008

7.0.16 – 6/6/2008

7.0.15 – 4/20/2008

7.0.14 – 1/31/2008

7.0.13 – 1/20/2008

7.0.11 -  1/6/2008

7.0.8 – 12/12/2007

7.0.5 - 11/21/2007

7.0.4 11/12/2007

7.0.3 – 11/5/2007

7.0.2 – 10/30/2007

 7.01 – 10/24/2007

Export For Connection 1.2(1)

1.3.15 – 8/3/2010

·         Converted setup to qSetup from Install Shield

·         Fixed a problem with Directory Handler exports that caused the ObjectID value to be blank.

1.3.14 – 4/2/2010

·         Added additional directory handler data into the backup for future use in Connection 7.x and later restores.

1.3.13 – 3/26/2010

·         Added updated message backup database template that includes the secure message framework – secure messages are not yet exported from CUC 1.2 but the import will expect the framework to be in place anyway.

1.3.12 – 3/11/2010

·         Added SMTP address output for subscribers for future use on Connection imports.

1.3.11 – 3/8/2010

·         Added a check for spaces in the alias string – this is technically legal (though not advised), however the CLI message extraction tool provided by Connection 1.2 does not handle spaces in the alias on input – as such COBRAS cannot export messages for users with spaces.  COBRAS now checks for this and issues a specific error message for this condition.  CSCte58553.

1.3.10 – 2/4/2010

·         Added additional diagnostic output for the message export CLI utility to help with situations where messages are not being extracted for some users.

1.3.9 – 9/30/2009

1.3.8 – 8/19/2009

1.3.7 – 8/6/2009

1.3.6. – 7/29/2009

1.3.5 – 5/14/2009

1.3.4 – 2/20/2009

1.3.3. – 12/19/2008

1.3.1 – 12/1/2008

1.2.5 – 10/19/2008

1.2.4 – 6/20/1008

1.2.3 – 5/23/2008

1.2.2 – 3/30/2008

1.2.1 – 3/12/2008

Export For Connection 7.x/8.x             

8.0.0.89 – 12/28/2021

Fixed CDET CSCwa57104, Exception during export through COBRAS in connection version 12.X. Table (unitymbxdb1:tbl_gsuitemap) is not in the database.

8.0.0.88 – 04/19/2021

·      Added support of Google workspace UMS mapping data export. It enables user to perform Google workspace <-> Cnx sync after successful import/restore.

8.0.0.87 – 12/09/2020

·        Fix for Cobra Export showing bug popup in silent mode and EnryptionKeyHelper class object null pointer exception in COBRAS support for Unity Connection Pin/Password changes

8.0.86 – 11/26/2019

·         Updated /useCUMI functionality to handle text attachments from Speech View enabled user messages.

·         Updated export to force multipart/mixed message type construction if a text body is present when using CUMI for export instead of IMAP.

8.0.84 – 1/20/2019

·         Updated NeGet packages and rebuilt setup to match COBRAS Import for hot mode

8.0.83 – 12/19/2018

·         Removed unused columns in the subscriber external service map table for 8.0.x versions of Connection.

8.0.82 – 12/11/2018

·         Added MDB version 55 that includes the vw_timezone from Connection into the backup to handle timezone restores where the ID rolls

·         Added logic to handle duplicate timezone ids in a multi language install

8.0.80 – 10/13/2018

·         Updated backup database for CUC_AdminUsers table to support SHA256 hashes for password fields

8.0.77 – 7/17/2018

·         Updated main project and key subproject libraries to .NET 4.6.1

·         Added additional SSH/TLS negotiation logic for HTTPS connections

·         Updated backup database to accommodate SHA256 hashes for password fields

8.0.76 – 2/27/2017

·         Updated table lock timeout for Informix to be 300 seconds for all cases (both briefcase and hot mode for all DBs)

·         Added additional debug output around HTTPS connections for greeting and voice name download to indicate SSL3 or TLS 1.x style connections being used.

·         Added /ForceSSL3 and /ForceTLS command line options to force HTTPS style connections regardless of target Connection version.

8.0.75 – 11/20/2016

·         Updated HTTPS connectivity checks to handle /UseCUMI pathway properly.

8.0.74 – 10/24/2016

·         Update COBRAS Export and related sub projects to .NET 4.5 framework

·         Updated HTTPS connectivity for CUMI and CUPI functionality to handle forcing SSL3 security for versions of Connection prior to 10.0.

·         Updated CUALS HTTPS connection logic to force SSL3 connections against Connection servers older than 10.0

8.0.73 – 8/15/2016

·         Added logic for CUALS (SOAP) HTTP connections to force SSL3 to be allowed on Connection installs older than 10.0 – recent Windows updates have started forcing TLS only without this work around.

8.0.72 – 7/26/2016

·         Updated NuGet packages for several sub projects to bring them up to date

8.0.71 – 7/14/2016

·         Included missing greeting data for user and call handler templates

·         Moving some properties out of the ExternalServiceMap backup for 7.0(1) servers that didn't have the values.

·         Added video greeting support

8.0.66 – 4/28/2016

·         Updated MDB file to version 51 – expanded the Initials field in the subscriber table to be a full 255 characters long.

8.0.65 – 4/16/2016

·         Updated Chilkat and Json.net binaries and consolidated library references for all sub projects to match.

8.0.62 – 1/2/2016

·         Updated setup and scheduler binaries for Windows 8.1 pro and Windows 10 deployments

8.0.61 – 3/20/2015

·         Fixed issue with 8.6.1 exports trying to include the sttType field which wasn’t added till 8.6.2.

·         Added updated Chilkat library for the CLI library being used for fetching licensing information from remote Connection server.

8.0.58 – 3/18/2015

·         Updated Chilkat library and switched to NuGet package delivery

8.0.57- 2/20/2015

·         Fixed CSV parser error for “Invalid extension format” while using only ALIAS in the CSV.

8.0.56 – 2/19/2015

·         Adding support for COS migration from Connection backups

·         Updating Chilkat libraries to latest release for ZIP, IMAP and SMTP support

8.0.55 – 9/2/2014

·         Added support for backing up the external service subscriber mapping table – needed to restore mappings from user’s to o365/BPOS/etc… external service references.

8.0.53 – 8/5/2014

·         Added support for importing call handlers with owners that are distribution lists into Connection 10.5 and later which now supports this construction

8.0.52 – 1/22/2014

·         Updated database definition to rev 47

·         Added Users without mailboxes (admin users) to export

·         Added list of role names users are associated with to export for both subscribers and admin users

·         Added public distribution list references in hot mode backup for link resolution during restore.

8.0.50 – 12/6/2013

·         Added support for user available configuration settings being exported

8.0.49 – 11/30/2013

·         Updated scheduler libraries to handle version 2.2 of scheduler interfaces.  Changed default to level 2.0 scheduler services for all calls even if on more recent OS platforms.

·         Added SSL support for email notifications.

·         Fixed email notifications on scheduled backups – error wrapping up still-open log file caused it to never complete.

·         Updated EmptyDB MDB file definition to version 45 to accommodate 256 character long static text fields from Unity and Connection backups.  CUCul81316

8.0.47 – 10/21/2013

·         Added logic to allow pass-through of HTTP proxy details from import application when running export in Hot Mode.

8.0.46 – 10/10/2013

·         Updated logic to gather both MAC and Hostid through CLI calls also for Connection 7.0.

8.0.45 – 9/12/2013

·         Added support for /StoreGreetingsInZip option for archiving greeting stream files external from the MDB file itself in a “Stand alone” ZIP file.

8.0.40 – 7/25/2013

·         Updated maximum backups to save from 30 to 365.

8.0.37 – 5/15/2013

·         Moved the “SendPrivateMsg” backup flag to only be included in 8.6 and later.  The property was added in an ES to 8.5 and  a few sites with older 8.5 systems being migrated have experienced errors where it’s missing.

8.0.36 – 5/6/2013

·         Updated to build with newer email notification sub project.

8.0.35 – 4/18/2013

·         Removed all event logging for scheduled export runs – sites with security policies on their servers not allowing this were failing scheduled runs as a result.  The amount of data that was going into the event log was not worth keeping it in there for this.

8.0.33 - 4/12/2013

·         Updated MDB definition for directory backup to rev 42.

8.0.32 – 3/26/2013

·         Updated logic to gather both MAC and Hostid through CLI calls also for Connection 7.1.

8.0.31 – 3/22/2013

·         Added subscriber templates to output.

8.0.30 – 3/5/20013

·         Updated MAC gathering logic to use CLI calls to fetch both the MAC and the HostId (which may be the same if it’s a hardware install but will be different if it’s a virtual installation).  This is a little slower but always gets the correct value for the MAC regardless of install type.

8.0.29 – 2/12/2013

·         Updated the MDB definition for backup database to rev 40 – expanded fields in the cuc_partition and cuc_searchspace table definitions to accept larger values

8.0.27 – 1/25/2013

·         Added debug output options for access DB insertion routines that were not covered before.

8.0.25 - 12/10/2012

·         Updated extension range selection for mailbox export to restrict itself to primary extensions only to avoid non numeric characters allowed in alternate extensions.

8.0.24 – 11/9/2012

·         Updated UI to be more clear about backing up license data for versions prior to 8.0(3).

8.0.20 - 10/22/2012

·         Updated MDB to rev 39.

8.0.19 – 9/18/2012

·         Update export to include four message action items i.e. voice mail, email, fax and receipt along with a relay address for the Connection subscribers.

8.0.18 – 7/15/2012

·         Added note to interface about deleted messages being restored as read if they are included.

8.0.17 - 7/11/2012

·         Fixed a cosmetic logging error for custom greetings during hot mode migrations – the note about dependency checking errors is not necessary as custom greetings have no external dependencies.

8.0.15 - 6/11/2012

·         Updated export to include HTML notification device and device template data for the Connection 9.0 release.

8.0.14 - 6/4/2012

·         Switched database back end class to use the 3.5 or later .NET driver instead of the old ODBC driver we've been using for years.

8.0.10 – 3/1/2012

·         Updated logic for backing up user and call handler greetings such that disabled greetings that have custom recordings are included in the backup as well.

8.0.9 - 2/16/2012

·         Added option for including deleted messages in the backup

8.0.7 - 1/6/2012

·         Fixed problem with edit controls not re-enabling after a DNS resolution failure during login.

8.0.6 – 12/6/2011

·         Updated version of COBRAS export done in C# - multi threaded, redesigned, considerably improved performance, updated architecture.

1.0.94 – 10/18/2011

·         Added “ping” logic to long greeting export sequences to keep the ODBC link from being terminated on the server side when exceeding an hour with newer builds of Connection (including some 7.x ESes).

1.0.89 – 9/23/2011

·         Fixed a problem in /LimitedBackup mode where duplicate users could be added to the ObjectsToBackup table which caused unnecessary errors during import.

1.0.88 – 8/17/2011

·         Fixed logging to properly get version of remote Connection server being attached to up front.

1.0.86 – 6/29/2011

·         Updated HexUnit controls used for Unicode/UTF16 translations to version 3.0

1.0.85 – 6/1/2011

·         Opening backup option for 7.0(1) Connection versions

1.0.83 – 5/23/2011

·         Fixed an issue with importing users via CSV for limited backup option.

1.0.80 – 3/31/2011

·         Fixing problem with backups of multiple Connection servers from a single installation.

1.0.78 – 3/8/2011

·         Updated error message reporting on failed ODBC connection events at login.

1.0.76 – 11/20/2010

·         Added option to filter message exports based on how many days old they are.

1.0.70 – 10/4/2010

·         Added SMPPProvider data to the export for use in future import versions.

1.0.67 – 9/23/2010

·         Fixed a problem where first/last name fields for subscribers were not allowing the full 64 characters supported by Connection 7.x and later.

1.0.65 – 9/12/2010

·         Fixed an issue where hot mode backups were not including alternate extensions for users (both admin and user added).

1.0.62 – 9/1/2010

·         Added the CreateProxyFromCorp flag for Connection 8.5 and later systems.

1.0.59 – 8/12/2010

·         Added support for UTF8/16 strings in the progress indicator controls on form during export.

1.0.55 – 7/26/2010

·         Added custom key mapping data to the output.

1.0.54 – 7/12/2010

·         Added custom greeting output for the directory handler export

1.0.53 – 6/22/2010

1.0.51 – 4/16/2010

1.0.50 – 3/10/2010

1.0.49 – 2/26/2010

·         Added secure message export option.

1.0.47 – 12/22/2009

1.0.46 – 12/4/2009

1.0.45 – 11/13/2009

·         Adjusting message backup logic to not get messages deleted (“soft” or “hard” deleted) when backing up subscriber messages

·         Removed password from debug output log when WAV file downloads failed.

1.0.44 – 11/4/2009

1.0.40 – 10/27/2009

1.0.39 – 10/23/2009

1.0.38 – 10/20/2009

1.0.37 – 10/9/2009

1.0.36 – 9/28/2009

1.0.34 – 9/18/2009

1.0.33 – 8/19/2009

1.0.31 – 8/13/2009

1.0.28 – 8/12/2009        

1.0.26 – 8/5/2009

1.0.25 – 7/29/2009

1.0.24 – 7/24/2009

1.0.23 – 7/9/2009

1.0.22 – 6/30/2009

1.0.21 – 5/26/2009

1.0.20 – 5/14/2009

1.0.19 – 4/14/2009

1.0.18 – 4/8/2009

1.0.16 – 4/1/2009

1.0.12 – 3/11/2009

1.0.11 – 3/9/2009

1.0.8 – 3/6/2009

1.0.7 – 3/5/2009

1.0.6 – 2/27/2009

1.1.4 – 2/20/2009

Import For Connection 7.x/8.x

8.0.109 – 09/20/2021

·      Fixed issue where user is able import messages even if sender of message not present in destination server.

8.0.108 – 04/19/2021

·      Added support of COBRAS Import for Google Workspace UMS data. It enables user to perform Gsuite <-> Cnx sync after successful import.

·      Handled all mailbox quota setting scenarios properly in cobra hot mode.

8.0.107 – 03/08/2021

8.0.106 – 12/16/2020

·         Changes for PIN not working for Cobra Import from UC 12.5 version to UC 12.5

8.0.105 – 7/21/2020

·         Updated hot mode to force the auto generated guid based SMTP address created when a user is moved back to a host they were on before to revert back to alias@domain format instead.

·         Updated CLI handling to extend /SkipVerCheck to work in Hot Mode scenarios as well

8.0.103 – 10/18/2019

·         Fixed issue with Hot Mode migrations where the corporate email address value was not coming over for users.

8.0.102 – 7/7/2019

·         Updated ChilKat library binary and all component unlock codes to the 2019 version.  Includes encryption, ZIP, IMAP and other libraries used by COBRAS.

8.0.101 – 1/20/2019

·         Updated NuGet packages and rebuilt setup to match COBRAS Export libraries for hot mode launching

8.0.100 – 1/9/2019

·         Updated logic for schedule restores to allow schedule detail items with identical names when creating a new schedule.  Updating existing schedules will still not allow duplicate schedule detail items to avoid duplicates on repeated restore runs.

8.0.99 – 12/18/2018

·         Updated NuGet libraries for COBRAS Import project

·         Updated ChilKat unlock codes for all components including mail, MIME, SMTP and HTTP libraries.

8.0.98 – 12/13/2018

·         Updated timezone logic to handle missing IDs in old timezone tables properly

8.0.97 – 11/1/2018

·         Added the vw_timezone table into the backup to handle “moving” timezone ids in later versions of Connection.

·         Updated logic for timezone restore to follow the localization key instead of the timezone key which can roll in later versions

8.0.96 – 10/18/2018

·         Updated built in export binaries to accommodate hot mode for 12.5

·         Added warning for users selecting to restore 1 or more system settings from an older backup to a newer Connection install

8.0.94 – 6/11/2018

·         Rebuilt setup with updated NuGet libraries to normalize DLL versions

·         Added additional exception handling around form resizing during startup to handle systems going from single to multiple screens between runs or vice versa

8.0.92 – 5/25/2017

·         Fixed issue with conflict during restore when both users and users without mailboxes are selected vs. only one or the other.

8.0.91 – 4/24/2017

·         Added support for E164 format numbers for manual extension overrides for import of all handlers and users.

8.0.90 – 3/32/2017

·         Updated thread blocking scheme for stream restores (voice names and greetings) to handle releasing blocks from threads that did not initiate them.

·         Updated timeout settings for stream updates/restored to match the 300,000ms maximum supported by Informix

8.0.88 – 2/23/2017

·         Fixed issue selecting users by partition assignment when doing hot mode moves

·         Updated ChilKat4.5 dll in hot mode sub folder to match version used by Import and avoid conflicts.

·         Added logic to remove dashes from notification phone numbers which the stored procs no longer like.

·         Fixed issue generating import HTML report when dealing with configuration settings.

8.0.85 – 1/5/2017

·         Updated table lock timeout for Informix to be 300 seconds for all cases (both briefcase and hot mode for all DBs)

8.0.84 – 10/24/2016

·         Update COBRAS Import and related sub projects to .NET 4.5 framework

·         Updated CUALS HTTPS connection logic to force SSL3 connections against Connection servers older than 10.0

8.0.83 – 8/15/2016

·         Added logic for CUALS (SOAP) HTTP connections to force SSL3 to be allowed on Connection installs older than 10.0 – recent Windows updates have started forcing TLS only without this work around.

8.0.82 – 8/1/2016

·         Removed check for video services presence when in Hot Mode – throwing cosmetic warning that didn’t need to be there in that scenario

8.0.81 – 7/26/2016

·         Updated NuGet packages to bring them up to date for the project

·         Updated Export binaries included in the HotMode sub project so all references match

·         Added support for video greetings into the import process for recent versions of Connection.

8.0.79 – 4/16/2016

·         Updated Chilkcat libraries to match export project references

·         Added additional debug output for ZIP extraction failures/warnings to be more verbose for potential issues

·         Updated warning dialog when the MDB file being opened is not valid to remind users that they always need to open the directory backups and not the message backups directly.

8.0.77 – 2/2/2016

·         Extended lock wait time for Informix to 300ms

·         Updated alternate extension create/update logic to handle copies of the primary extension string in multiple partitions properly

8.0.73 – 1/2/2016

·         Updated setup for Windows 10 deployments

8.0.72 – 9/19/2015

·         Updated setup to support Windows 10 installations

·         Moved option to skip existing user updates such that it can be selected without messages being restore

·         Added /SkipGuiPasswordRestore option to jump over restoring GUI Passwords during import

·         Fixed a problem with mal formed message action backup data causing errors during import.

8.0.68 – 4/13/2015

·         Removed SendPrivateMsg parameter from the call handler modify stored procedure call unless the version is 8.5 or later.

·         Fixed issue with debug mode in older versions of Connection potentially falling into a recurring loop of error logging and blowing the stack

·         Added additional logging tracking pending and sent count for stream restore sequence

8.0.65 – 3/19/2015

·         Added logic to force lock clearing for DB access during hot mode migrations before starting to move messages for each user

8.0.64 – 3/10/2015

·         Fixed alias parsing logic while restoring voice messages from Unity server to Connection server.

·         Updated logic to support new SMTP format i.e. “full address” instead of older “short address” by latest version of Chilkat.

8.0.61 – 2/6/2015

·         Fixed SMS notification device restore logic – incorrect reference to SMTPAddress where RecipientAddress modified, mapping to selected SMMP service corrected.

8.0.60 – 12/8/2014

·         Added command line override to allow message check during hot mode migration to be skipped for sites having trouble with corrupted message stores during a hot mode move.  Not exposed in help and a supported option, TAC directed only.

·         Included Windows 8.1 x64 and 2012R2 x64 to the installation manifest list.

8.0.59 – 9/4/2014

·         Added support for establishing links to external message services (Outlook 365, Exchange on prem) during restore for new users.  Requires export done with version 8.0.55 or later to work correctly.

·         Added logic for external message service links to be restored during hot mode user migrations.

8.0.57 – 7/30/2014

·         Fixed issue with schedule imports from older Unity backups not being found during restore properly.

·         Added additional error checking around DB locks during greeting stream restores from Unity backups

·         Fixed issue with unnecessary error when attempting to add a MWI device using the primary extension during Unity restores.

8.0.55 – 7/5/2014

·         Fixed an issue in Hot Mode migrations where loading call handlers by CSV was not adding handlers to the selection grid correctly.

8.0.54 – 5/22/2014

·         Added support for editing new user imports to allow for leading “+” character for a changed extension

8.0.53 – 4/29/2014

·         Changed method of identifying duplicate messages during restores from Unity Connection backups.

8.0.52 – 4/4/2014

·         Fixed issue where restores into 7.1(5) were failing when updating call handlers trying to set the “send private message” flag since that feature was not added till 8.0.

·         Added new link resolution logic for hot mode moves around call handler recipients and users (both moving and not moving scenarios).

·         Added work around for restores into Connection 10.0(1) where call handler extensions are blanked out in some scenarios.  There’s an ES to fix this on Connection but providing code work around in COBRAS to handle cases where the ES is not yet applied.

8.0.49 – 2/19/2014

·         Added additional failure recovery logic in hot mode message moves to handle SMTP session being dropped out from under the move.

·         Fixed issue with “map to all” button on custom key map link resolution page.

·         Added lock mode call to both source and target server when in hot mode move mode to prevent issues with indexing changes during user removes and the like.

·         Added additional logic for moving call handlers with user recipients and/or owners for both cases where user is being moved and where they are not being moved in the same hot mode operation.

8.0.45 – 1/22/2014

·         Added roles restore from Connection 7.x and later backups.

·         Added ability to restore users without mailboxes (admin users) from Connection 7.x and later backups

·         Fixed problem with hot mode migration with both users and call handlers that referenced themselves were moved/copied at the same time, some references were not properly restored on the target.

8.0.44 – 1/7/2014

·         Adding more error handling around Unity restores where Switch (phone system) data from the backup may be damaged and no accurate – now fails over to using the phone system referenced by the subscriber template being used for restore (if any) when creating new notification devices and such that require a valid media switch Id on creation.

·         Added more range checks for illegal Unity values for retry attempts and retry intervals for notification devices during restore.

8.0.42 – 12/19/2013

·         Add TAC directed command line utility to skip the backup version check for rare cases that the target Connection server’s version string indicates an older version when that is not the case.

8.0.41 – 12/6/2013

·         Added ability to import configuration settings from Unity Connection backups

8.0.40 – 11/20/2013

·         Updated logic for creating schedule’ name for notification devices while importing data from Unity server onto Unity Connection server.

8.0.39 – 11/18/2013

·         Fixed message count totals on the main page after selection of backup database to restore

·         Added additional diag details around wizard page loading and DB calls.

·         Fixed a couple instances where tables were being queried in MDB that were not added until later rev. of the database definition.

8.0.37 – 11/7/2013

·         Fixed issue where corporate email restoration option was not working when restoring backups of Unity instead of Connection.

8.0.35 – 10/29/2013

·         Fixed user conflict check that was pulling from the vw_subscriber table when looking for alias conflicts and not catching admin users (users without mailboxes) as potential conflict sources.

·         Fixed issue where greeting wave files restored during hot mode migrations were not being cleaned up from the temporary directory properly.

·         Fixed the HTTP Proxy authentication logic – the use of the proxy was being ignored after initial login.

·         In hot mode the “is template” columns for both users and call handlers is hidden since we don’t move/copy those in hot mode.

·         Added more diagnostic logging in and around the authentication path for running down HTTP proxy authentication issue in hot mode.

8.0.32 – 10/14/2013

·         Updated logic for duplicate parameters being added to a single stored procedure call – better warning handling for tracking overlap in Unity restores vs. Connection backup restores.

·         Changed empty phone number logging from information to warning so the string will show up in the post install report output for users.

·         Updated logic for notification text based device restores where the phone number field is used for display purposes – Unity allows for any string and Connection restricts to numbers and letters only – added filtering function with information output to note this for Unity imports

8.0.31 – 9/12/2013

·         Fixed issue with restores of versions of Unity prior to 4.0(5) that did not have per user speed/volume values – for these versions those values need to default to “normal” speed and volume settings (100 and 50 respectively).

8.0.30 – 8/29/2013

·         Fixed a problem allowing duplicate messages for restores to 8.6.2 and later – the setting was being ignored and duplicate messages were being skipped.

8.0.27 – 8/22/2013

·         Fixed a problem where “first time enrollment flag” for Unity exports was not being set properly during restores to Connection.

8.0.23 – 8/6/2013

·         Fixed a problem where referral extensions in Unity backups were not being restored as alternate contact numbers (mapped to user input keys) in Connection – the incorrect column name was being referenced when pulling the data from the Unity backup.

8.0.22 – 7/30/2013

·         Fixed a problem where call handler’ greeting are not migrated while importing data Unity to Unity Connection.

8.0.21 – 7/25/2013

·         First release version of updated version of COBRAS import done in C# - multi threaded, redesigned, considerably improved performance, updated architecture.

1.2.17 – 12/11/2012

·         Updated embedded COBRAS Export for Connection to latest version with updated DLLs for deployment with hot-mode.

1.2.16 - 10/22/2012

·         updated to MDB rev 39 for support of separate "active" flag for all CUC notification device types.

1.2.14 - 10/11/2012

·         Updated the logic to force the SMTP connection to tear down and re attach every 5 messages for both briefcase and hot mode message migration scenarios - some recent security patches on the Connection platforms has the SMTP port terminating after a certain number of messages per session - for some reason the automatic session rebuild isn't happening in some cases so forcing the connection to rebuild every 5 messages solves the issue.

1.2.12 - 8/23/2012

·         Fixed a problem where some paths executing SPTMProxyAddressCreate were passing the SMTP address in as a varChar instead of a LongVarChar cast and the Informix engine rejected the parameter. 

1.2.11 – 8/10/2012

·         Added logic to enable the “UsePrimaryExtension” flag for transfer rules if the transfer string from the backup matches the primary extension of the user or handler that owns the transfer rule.  This “ties” the transfer string to changes made for the primary extension.

1.2.10 – 8/2/2012

·         Fixed a problem for Unity message backups restoring to Connection where the fully qualified SMTP address of the sender was not being set properly in the message header so messages could show up as coming as an outside caller message when they should be identified users instead.

1.2.9 - 7/12/2012

·         Updated import for Connection 9.0 release to include mapping details for HTML notification devices.

1.2.4 – 4/12/2012

·         Removed braces from locationObjectId from Unity backups when inserting licensing data into Connection 9.x.

1.2.2 – 2/16/2010

·         Updated WAV Upload.exe to version 1.0.8

1.2.1 – 2/8/2012

·         Added support for importing legacy licensing data from backups that contain it when restoring to Connection 9.0 and later for license migration scenarios.

1.1.231 – 12/6/2011

·         Added post message recording support for the upcoming 9.0 release of Connection.

1.1.229 – 11/15/2011

·         Updated logic to avoid logging errors during the distribution list membership restore routine and instead log warnings.  This avoids rolling the error count over 100 and causing a “continue?” dialog to pop.

1.1.227 – 10/21/2011

·         Added additional logic to manually map all known Windows timezones found in Unity to a close match in the Linux list of timezones used by Connection – this is not a 1 to 1 mapping and is a “best fit” attempt but is a bit nicer than just picking the first zone that matches the offset.

1.1.225 – 7/27/2011

·         Added new “/ShareLoginInfo” CLI option to have all Connecton login/PW details to be shared across all users of COBRAS Import regardless of differences in local Windows domain login names being used.

1.1.224 – 7/21/2011

·         Fixed problem with proxy email addresses not being brought over in a Connection to Connection hot mode move if they conflicted (temporarily) due to the source and target existing in the directory for a short period of time.

1.1.223 – 7/14/2011

·         Fixed an issue with calling vw_globalUser_Admin view on versions of Connection prior to it being in the data scheme.

1.1.218 – 7/3/2011

·         Fixed a problem where remote users were not assumed to be able to “see” a message recipient for reply purposes so messages from those users were left as outside callers during restore.

1.1.215 – 6/15/2011

·         Added “/PauseAfterWAVUpload” CLI command

1.1.212 – 6/10/2011

·         Fixed a problem restoring backups of Unity that contained certain UTF16 strings during restore that caused the loading of information into grids for selection during restore to freeze up.

1.1.209 – 5/21/2011

·         Updated to allow imports from Unity 4.0(3) and 4.0(4) backups.

1.1.208 – 4/18/2011

·         Updated message restore logic for imports into Connection 8.6 and later to support avoiding duplicate messages with the updated Connection MTA logic that supports this.

1.1.207 – 3/30/2011

·         Updated SMTP send logic to ALWAYS retry on any failure up to 3 times instead of only retrying on select failures.  Output is changed to log failures as warnings until after it fails 3 times at which point an error is logged – simplifies output.

1.1.202 – 3/8/2011

·         Added additional logging around WAV file uploading routines.

1.1.201 – 2/25/2011

·         Added command line option for “/DisableNotificationDevicesDuringRestore”.  This forces all active notification devices to be disabled before messages are restored and then they are re enabled when the message import for all users is complete. 

1.1.200 – 2/17/2011

·         Forced sort order for Unity messages when restoring to be from oldest to newest to preserve sort order for Single Inbox clients running against Exchange.

1.1.199 – 1/24/2011

·         Added more diagnostics and file checking around the multiple MDB file message restore scenario.

1.1.197 – 12/23/2010

·         Added support for Connection to Connection hot mode moves for version 8.5.1 ES5 and later installs (not yet released).

1.1.196 – 12/13/2010

·         Made changes in the link resolution pages of the wizard to handle some event handling issues when running on Windows 2003 via VMWare – annoying search popup dialog issues and form event issues specific to that configuration.

1.1.194 – 11/30/2010

·         Fixed a bogus error message about missing CUC_Mailstore tables.  If the backup was rev 27 it was trying to open the mailstores table which was not added till 28.

1.1.193 – 11/23/2010

·         Made changes to hot mode user move logic to force ObjectID value on the source server’s global user to match that of the target server’s user with a mailbox value to avoid post move replication issues.

1.1.186 – 11/5/2010

·         Added logic to allow for imports of “root access” Connection 2.1 server backups with warning that it’s not TAC or BU supported.

1.1.181 – 10/17/2010

·         Added logic to map references to SMMP providers during restore from Connection 7 and later backups.

1.1.177 – 9/16/2010

·         Changed temporary file logic for message construction and log file generation to force all files into the installation folder for COBRAS Import or below to avoid issues with the default temporary file locations being on a drive that is restricted for access and/or low on space.

1.1.176 – 9/12/2010

·         Fixed a problem with global user creation during a Connection 8.5 hot mode migration that resulted in two global contacts being created for a newly moved subscriber existing in the database for a period.  This eventually corrected itself but cosmetically it was undesirable.

1.1.171 – 9/1/2010

·         Added support for the CreateSMTPProxyFromCorp flag found in Connection 8.5 or later for users with mailboxes.

1.1.166 – 8/24/2010

·         Fixed a problem with PIN and GUI passwords not preserving the alternate salt values when moving them in Connection to Connection hot mode between one server and then back to the original server again.

1.1.160 – 8/7/2010

·         Changed logic for WAV File upload logging scheme to generate unique file names in a folder for every upload attempt to avoid file conflicts during load scenarios.

1.1.157 – 8/3/2010

·         Fixed a problem with message restores from Connection 1.2 backups prior to DB rev 20

1.1.155 – 7/16/2010

·         Added support for moving mail users in Connection to Connection hot mode

1.1.154 – 7/12/2010

·         Added support for Directory Handler custom greeting imports

1.1.152 – 6/7/2010

·         Added support for importing name lookup handlers from Unity and Connection backups done with rev 21 of the MDB file definition or later.

1.1.151 – 5/25/2010

1.1.149 – 5/20/2010

·         Added proxy email address restore for backups of Unity Connection 7.0 and later created with a recent version of COBRAS backup.

1.1.146 – 4/30/2010

1.1.145 – 4/23/2010

1.1.144 – 4/22/2010

1.1.143 – 4/15/2010

·         Added support for importing secure messages from new Unity exports that include them.

1.1.140 – 3/9/2010

1.1.138 – 2/25/2010

1.1.136 – 2/15/2010

·         Added secure message restore option for COBRAS Exports from Connection 7.x and later.

1.1.135 – 1/26/2010

1.1.134 – 1/21/2010

1.1.127 – 12/22/2009

1.1.126 – 12/14/2009

1.1.123 – 12/4/2009

1.1.119 - 11/24/2009

1.1.118 – 11/20/2009

1.0.117 – 11/17/2009

1.0.115 – 11/13/2009

·         Fixed a problem with the “read” status for messages being restored from a Connection 7.x and later backup not being preserved correctly on a restore.

·         Removed dialog pop up for each unresolved message recipient on the call handler selection page – replaced with a single pop up once the selected handlers are all loaded pointing the user to the issue and possible resolution.

·         Updated logging for time zone mapping from Unity 4.x mappings to not complain about “null” values which is Unity’s method of using the system timezone.

·         Updated object counts for hot mode migration for both Unity and Connection user counts to take into account the contacts representing remote users.

·         Updated subscriber conflict checking during hot mode migrations to check for future alias conflicts when the contact is “promoted” to a full subscriber.

·         Included note in user restore about skipping SMS notification devices for active devices backed up in Unity and being restored in Connection.

·         Added logic to resolve private distribution list membership information in a Unity to Connection digital networking configuration more reliably using ObjectIDs instead of alias lookups.

·         Fixed hot mode logic to handle restoring message recipients for handlers if they are moving or not.

·         Fixed a timezone mapping issue when coming from Unity versions that use “0” instead of “NULL” to mean “use default time zone”.

·         Updated report output logic to always force report even if there’s no errors or warnings to report on for consistency.

1.0.107 – 11/3/2009

1.0.103 – 10/27/2009

1.1.102 – 10/16/2009

1.1.101 – 10/13/2009

1.1.100 – 10/12/2009

1.1.99 – 10/9/2009

1.1.98 – 10/5/2009

1.1.97 – 9/30/2009

1.1.96 – 9/24/2009

1.1.94 – 9/22/2009

1.1.91 – 9/18/2009

1.1.90 – 8/19/2009

1.1.88 – 8/12/2009

1.1.87 – 8/6/2009

1.1.83 – 7/29/2009

1.1.81 – 7/24/2009

1.1.80 – 7/22/2009

1.1.77 – 7/7/2009

1.1.76 – 6/30/2009

1.1.72 – 6/17/2009

1.1.70 – 6/12/2009

1.1.69 – 6/5/2009

1.1.67 – 6/2/2009

1.1.65 – 5/26/2009

1.1.64 – 5/14/2009

1.1.63 – 5/11/2009

1.1.62 – 5/8/2009

·         Added support for more specific timezone restores from Unity exports if version 7.0.55 or later of the Unity Export tool is used.

1.1.60 – 4/29/2009

1.1.58 – 4/24/2009

1.1.56 – 4/13/2009

1.1.53 – 4/9/2009

1.1.51 – 4/3/2009

1.1.50 – 3/24/2009

1.1.48 – 3/18/2009

1.1.47 – 3/16/2009

1.1.46 – 3/11/2009

1.1.45 – 3/6/2009

1.1.43 – 3/5/2009

1.1.41 – 2/27/2009

1.1.37 – 2/18/2009

1.1.33 – 2/3/2009

1.1.30 – 1/13/2009

1.1.29 – 1/7/2009

1.1.28 – 12/23/2008

1.1.23 – 12/15/2008

1.1.22 – 12/11/2008

1.1.16 – 12/4/2008

1.1.14 – 12/2/2008

1.1.9 – 11/25/2008

1.1.8 – 11/21/2008

1.1.7 – 11/9/2008

1.1.5 – 11/5/2008

1.0.26 – 11/2/2008

1.0.24 – 10/23/2008

1.0.21 – 10/13/2008

1.0.20 – 10/12/2008

1.0.19 – 10/10/2008

1.0.17 – 9/19/2008

1.0.15 – 8/25/2008

1.0.14 7/25/2008

1.0.13 5/28/2008

1.0.11 5/5/2008

1.0.10 – 4/18/2008

1.0.9 – 4/16/2008

1.0.7 – 4/15/2008

1.0.5 – 4/9/2008

1.0.4 – 4/3/2008

 

© 2014 Cisco Systems, Inc. -- Company Confidential