Unity Advanced Settings Tool

Overview

This is a simple tool that allows users to safely edit many of the “hidden registry settings” that commonly need to be modified in the field. These are items that, for whatever reason, are not on the SA interface and require users to add/edit keys to the registry.

This tool prevents potential messy accidents by forcing specific value ranges, making sure edits aren’t applied to Unity versions that can’t handle them. There’s only a couple settings in here that are “String” values that need to be edited “free form”. The rest are all limited to a drop down list of value or are “key only” values where the mere presence of the key in the registry is sufficient.

Requirements/Special Notes

Runs with Unity version 2.4.6 or later. Keys will be visible only for those values that are legal to adjust on the locally running system

You can add you own keys (see below) however they will be overwritten if you update the tool to a later version.

Adding New Values To Database

Adding new keys to the database is easy but should only be done by folks in development or TAC since new versions of the registry edit tool will install their own MDB files which will write over any changes you might make in the field. However if you still feel the need to add key to the database, here’s what you need to do.

Start the Registry Edit tool using the command line parameter “/AddKey”. When you do this an additional menu item named “Add New Key” will appear in the menu bar at the top. Select this option and a form will appear that lets you add, delete and edit the registry key settings in the current database stored in “Settings.MDB” in the install directory.

Be careful! The tool will let you edit or delete existing key settings which you probably don’t want to do.

For each registry value you want to add to the database, fill in the values on the form. Here’s a quick run down on what each field means:

Index. This is an automatically generated unique number for each record in the database. This is a read only field, you can’t mess with it. Be aware that when keys are edited/delted this number may skip values… don’t worry about it.
Key Path. This is the registry key path. For instance “SOFTWARE\Active Voice\Doh\1.00\”. This does NOT include the registry key name itself, this is just the path to the directory where the key is stored. Yes, that last “\” is required on there. NOTE: All values are assumed to be under HKEY_LOCAL_MACHINE. If you need to set values outside of that registry branch, this tool is not for you.
Key Name. This is the name of the registry key itself that’s found at the key path above. In the rare case of a registry setting that is ONLY the key path and not a key value, you can leave this blank. There are only 1 or 2 of these types of values left so this should not be the case.
Key Type. You must select a value from the drop down list… the list includes:

“REG_SZ” – string values
“REG_DWORD” – number values
“REG_BINARY” – binary values, not used by any of these registry settings… this should never be used.
“NONE” – for cases where the presence of the key path is all that is needed and not a key with a value. As mentioned above this should be used rarely if at all any longer.

Min Value- If the key type is a number you can set it’s minimum allowable value here. String values don’t use this field.
Max Value- If the key type is a number you can set it’s maximum allowable value here. String values don’t use this field.
Step By – If the key type is a number you can set how far to step for each value added to the drop down list the user can select from. For instance if your minimum value is “0” and the maximum value is “100” and you have a step by value of “20” the drop down list of choices will be populated with “0, 20, 40, 60, 80, 100”. The user is not allowed to “free form” input into this field so they much choose one of these values. As such don’t go overboard with overly broad step-by values. On the other hand don’t dictate 10,000 items in the drop down list either… you’ll break it.
Min Unity Version – If you’re using the form to add new key values as you should this is a drop down list of all major Unity versions between 2.3 and 3.0. Some registry keys are only valid for specific versions of Unity so you can set which ones are appropriate here. If the local version of Unity the tool is being run on is outside the minimum and maximum Unity version numbers allowed the item will now show up for selection in the list.
Max Unity Version – See above.
Short Description – Short description (less than 250 characters) of the registry key change being added. This is the string that shows up in the list box on the left of the application form.
Long Description – Longer description of the behavior change that the registry key edit will evoke. This value shows up in the edit box on the right of the application form. Be sure to include examples of conversation modifications if appropriate and the like. There is no limit on the size of this field so go wild.

Obtaining Updates

To check for updates to this tool, visit http://www.CiscoUnityTools.com

Revision History

Version 1.0.156 –09/02/2009

· CSCtc23590 - Automatic Version Check functionality broken after web-site revisions

Version 1.0.155 –09/02/2009

· CSCsz93254 - Update required ES in field

Version 1.0.154 –08/11/2009

· CSCtb16913, CSCta36258 - Added Configuration settings for HTTP/S TRaP

· CSCsz93254 - Provide a way to disable sticky playback speed keys

· CSCtb13378 - Updated textual description of VMWS entries

Version 1.0.153 –06/02/2009

· CSCsz93254 Unity 7.0.2, new sticky key feature for Playback Speed is always desirab

Version 1.0.152 –05/11/2009

· Update wording from CSCsy59296

Version 1.0.151 –03/23/2009

· CSCsy59296 Create only needed Exch search folders based on COS - Add AST setting

Version 1.0.150 –03/23/2009

· Setting “Unity Inbox and Assistant – Disable Feedback link” has been removed from builds 8.x and greater. The feedback link in CPCA and SA have been eliminated - CSCsy46783

Version 1.0.149 –02/18/2009

· Added Setting “Conversation – First Time Enrollment: Require Subscribers to Record Names” back into utility. It appears to have been removed in some version after 1.0.140 or later.

Version 1.0.148 –01/08/2009

· Edited Setting “Phone Applications – Maximum Number of Concurrent Sessions” to remove upper-limit value of 24.– CSCsx02140

Version 1.0.147 –01/08/2009

· Removed Setting “Conversation – Spoken Commands” as it is no longer a first-look feature– CSCsu11675

Version 1.0.146 – 11/05/2008

· Documented that “Conversation – Exclude Receipts” does not apply to the deleted items folder – CSCsv13448

Version 1.0.145 – 10/11/2008

· Added “Notification – Always Use New Task if Delayed Duplicate” for Version 5.0(1) and higher – CSCsu95314

Version 1.0.144 – 10/08/2008

· Fix for CSCso71321

Version 1.0.143 – 07/16/2008

· Text description for entry “Conversation - Alternate Greeting Notices (Exchange Only)” edited - CSCsq31820

· Entry “Conversation - DCR SMTP Notification Enabled” added for Unity version 7.0(2)

· Entry “Conversation - DCR SMTP Notification Include URL” added for Unity version 7.0(2)

· The following entries will no longer appear on Unity 4.2(1) or greater:

System - Set which LDAP port Unity is looking for in Exchange 5.5

System - Exchange 2000/Exchange 5.5 mixed messaging: server name

System - Exchange 2000/Exchange 5.5 mixed messaging: display name

System - Exchange 2000/Exchange 5.5 mixed messaging: distinguished name

Version 1.0.142 – 06/10/2008

Modified “Networking - Enable Identified Subscriber Messaging (ISM) for AMIS, Bridge, VPIM and Trusted Internet subscribers” to write to a different registry location for Unity versions less than 5.0(1) - CSCsq58693

Version 1.0.141 – 06/01/2008

Modified “Conversation - Exclude Return Receipts (Exchange only)” to function for Unity 5.0(1).
Modified “Conversation - Exclude All Receipts (Exchange only)” to function for Unity 5.0(1).
Modified “Conversation - Alternate Greeting Notices (Exchange only) to function for Unity 5.0(1).”

Version 1.0.140 – 05/5/2008

Entry “Conversation - Exclude Return Receipts (Exchange only)” will write to Configuration table for versions 7.x and greater
Entry “Conversation - Exclude All Receipts (Exchange only)” will write to Configuration table for versions 7.x and greater
Entry “Conversation - Alternate Greeting Notices (Exchange only)” will write to Configuration table for versions 7.x and greater

Version 1.0.139 – 04/23/2008

Entry “VMWS - Allow Client Credential Caching” available for versions 7.x
Entry “VMWS - Call Timeout Seconds” available for versions 7.x
Entry “VMWS - HTTP Session Timeout Minutes” available for versions 7.x
Entry “VMWS - Maximum Number of Concurrent Requests” available for versions 7.x

Version 1.0.138 – 04/07/2008

Entry “Conversation - Exclude all recipts from voice mail stack (Exchange Only)” available for versions 7.x - CSCso60522
Entry “Conversation - Exclude return recipts from voice mail stack (Exchange Only)” available for versions 7.x - CSCso60522

Version 1.0.137 – 04/02/2008

Entry “Messsaging - 72 or more voice ports - number of MAPI sessions per Exchange server” valid for version 5.0(1) only. - CSCso53699.

Version 1.0.136 – 03/31/2008

Removed entry “Conversation - Reply To Unknown Caller” Not valid for version 7.x and greater. - CSCso41490.
Entry “Administration - Set the minimum length for subscriber-defined extensions” not valid for version 7.x and greater. - CSCso48661.

Version 1.0.135 – 2/21/2008

Added “Unity Inbox and Assistant - Disable Feedback Link” for Unity 4.2(1) ES133 and 7.0(1) and higher – CSCsm77290.

Version 1.0.134 – 2/12/2008

Removed “Networking - Set Auto Attendant Search Scope” for Unity 7.0(1) and higher – CSCsk41278.
Adding ‘Unity Assistant - Disable MediaMaster ‘ for Unity 7.0(1) and higher - CSCsk89441.

Version 1.0.133 – 1/17/2008

Removed “Administration - Subject line customization, Interview handler messages”, “Administration - Subject line customization, live record messages”, “Administration - Subject line customization, subscriber to subscriber messages” and “Administration - Subject line customization, Unknown caller messages” for Unity 7.0(1) and higher.

Version 1.0.132 – 1/11/2008

Added “Conversation - Exclude History from Replies (Domino Only)” for Unity 7.0(1) and higher.

Version 1.0.131 – 11/7/2007

Added “Conversation - Confirm Delete When Deleting a Deleted Message (Exchange only)” for Unity 4.0(5) and higher.

Version 1.0.130 – 9/25/2007

Re-Added “FirstLook” to registry key for “Conversation - Spoken Commands” - CSCsk60527. Removed for Unity 7.0(1).

Version 1.0.129 – 9/13/2007

Edited NodeName for “Conversation - Prompt for ID on Wrong Password” and enabled setting for 4.2(1) and 5.0(1). Removed text indicating Unity restart is required for “Networking - Enable Identified Subscriber Messaging (ISM) for AMIS, Bridge, VPIM and Trusted Internet subscribers”. Fixed version 7.x boundaries.

Version 1.0.128 – 8/2/2007

Added “Conversation - Prompt for ID on Wrong Password” for Unity 7.0(1). It will allow a system-wide re-prompt for password AND USER ID when the calling party ID has been identified as a Unity subscriber (and the first password attempt was invalid).

Version 1.0.127 – 7/31/2007

Added version 7.x for version boundaries for the next release of Unity.

Version 1.0.126 – 5/17/2007

Removed "Security Conversation - Enable Private and Secure Messaging" for Unity 5.0(1)

Version 1.0.125 – 5/14/2007

Updated text of Note in "Security - Configure recording format for backward compatibility with Cisco Unity 4.x servers" for Unity 5.0(1)

Version 1.0.124 – 4/26/2007

Added " Conversation - Reply-to-All Warning" for Unity 5.0(1) - CSCsi01131
Removed references to “First-Look” for “Conversation - Spoken Commands (First-Look)”

Version 1.0.123 – 4/23/2007

Added "System Conversation - ACN Follows Current Transfer Rule" for Unity 5.0(1) - CSCsi02306

Version 1.0.122 – 4/11/2007

Added "System - Enable event log entries when recordings are discarded because of shortness or beginning silence" for Unity 5.0(1) - CSCsi33025
Updated title and text of key location for “Networking - Enable Identified Subscriber Messaging (ISM) for AMIS, Bridge, VPIM and Internet subscribers”

Version 1.0.121 – 3/12/2007

Changed exclude receipts and all receipts settings to appear for Unity 5.0(1) instead of stopping at 4.2(1).
Added “Conversation - Spoken Commands (First-Look)” for Unity 5.0(1).

Version 1.0.120 – 2/13/2007

Added “Networking - Cross-server Transfer Behavior for External Subscribers” for Unity 5.0 - CSCsh56194
Added “Networking - Allow Transfer Override on Cross-server Transfer Handoff” for Unity 5.0 - CSCsd69934
Updated location of key for “Networking - Enable Identified Subscriber Messaging (ISM) for AMIS, Bridge, and VPIM subscribers” setting.

Version 1.0.119 – 1/18/2007

Updated version Unity/Connection version checking routines use at startup.
Added “Security - Configure TCP port number for incoming RPC connections for encryption/decryption” setting for Unity 5.0(1).

Version 1.0.118 – 12/28/2006

Updated description for “System – Change default location for UnityMTA directory” – CSCsb73349

Version 1.0.117 – 11/27/2006

Updated path for the Disable AD Accounts option – CSCsg82062.

Version 1.0.116 – 11/13/2006

Added Phone Applications – Maximum Number of Concurrent Sessions for the Unity 5.0(1) release

Version 1.0.115 – 10/5/2006

Updated Cisco logo
Changed max version for the “security – enable all subscribers to encrypt all messages marked private via the TUI” such that it will be available for 4.0(5) through 4.2(1) only – in 5.0 this setting is per subscriber.
Minor changes wording on a few setting after a tech pubs review
Updated for new registry location for the WavGain settings in 4.2(1) and later versions

Version 1.0.114 – 9/22/2006

Added System.MessageStoreMonitor.DominoMonitor.LogNonMonitoredSubscriberNotifications system configuration option for Unity 5.0(1).

Version 1.0.113 – 8/28/2006

Added “Security - Configure recording format for backward compatibility with Cisco Unity 4.x servers” setting for Unity 5.0(1) release.

Version 1.0.112 – 7/25/2006

Updated the “Conversation – full mailbox check feature” to include Domino as well as Exchange.

Version 1.0.111 – 6/29/2006

Removed MalEx Asynchronous settings.
Configured DCR settings to _only_ appear for 4.2(1) as the SA added these settings for the 5.0 release.
Removed subscriber send message flow options and exclude read and all receipts options for versions later than 4.2(1)

Version 1.0.108 – 5/23/2006

Added three “MALEx Asynchronous Message Move” values for the Unity 5.0 release
Updated AST to handle the full major, minor, rev, build values so it’s no longer necessary to tweak the registry when testing in beta builds.

Version 1.0.107 – 5/9/2006

Added Messaging setting for configuring MAPI sessions for systems with more than 72 ports for Unity 4.3(1) and later.
Added Messaging setting for configuring Low Fragmentation Heap option for systems with more than 72 ports for Unity 4.3(1) and later.

Version 1.0.106 – 5/5/2006

Added prefix/postpend digit options being exposed in the SA for the 4.3(1) release

Version 1.0.105 – 3/9/2006

Exposed the “Conversation – Subscriber Send Message Hang-Up Action” for 4.2(1) and later builds instead of stopping at 4.1(1).

Version1.0.104 - 2/10/2006

Added option to set system wide default for command menu entry interdigit timeout
Added options for customizing subject text for the Unity 4.2(1) release.

Version 1.0.103 – 2/8/2006

Updated “double key press time” setting for the 4.2(1) release.
Updated descriptions for other existing settings to accommodate changes in the 4.2(1) release.
Updated about box.

Version 1.0.102 – 12/30/2005

Updated to support min/max versions of 4.2(1)
Added “Conversation - Subscriber Forward Message Flow” and “Conversation—Reply to Unknown Caller” options for the 4.2 release.
Removed “Conversation – Subscriber Send Message Flow (Streamlined Addressing for Multiple Recipients)”, “Conversation—Add Dual Name Confirmation”, “Conversation—Confirm Delete When Deleting New and Saved Message” and “Conversation—Mark Messages Read Upon Hang-Up” options for the 4.2 release as they are now controlled per user.

Version 1.0.101 – 11/17/2005

Updated settings to hide system wide values that are being ported to per user options for the Unity 4.2 release.
Updated settings to hide GTM enable feature for the Unity 4.2 release. This feature is now on all the time.

Version 1.0.100 – 10/21/2005

Fixed a problem with some Boolean values being stored with a space in front of the 1 or 0 value in the SQL configuration table.

Version 1.0.99 – 8/24/2005

Updated with new settings for the Unity 4.1(1) release.

Version 1.0.98 – 4/4/2005

Changed wording on the “Conversation – set max recording time” key to make it clear that this only affects the messages recording time, not greetings.

Version 1.0.97 – 3/23/2005

Added new key “Networking – Change Interop Gateway Foreign Domain Name (Domino only)” for the 4.0(5) release.

Version 1.0.96 – 1/23/2005

Changed title of application to reflect SQL configuration settings being included now
Added and updated several setting for the Unity 4.0(5) release.

Version 1.0.95 – 9/29/2004

Added “Security - Enable all subscribers to encrypt all messages marked private via the TUI” option for 4.0(5) release.

Version 1.0.94 – 8/17/2004

Updated the “Networking – Cross Server…” setting to have a new name and an updated description for the 4.0(5) release.

Version 1.0.93 – 8/6/2004

Added “Conversation – Enable private and secure messaging” key for 4.0(5)
Added “Networking – Disable Cross- Server Incoming Processing” key for 4.0(5)
Added “Conversation – System Broadcast Max Message Size” key for 4.0(5)
Added “Conversation – System Broadcast Message Playback Order” key for 4.0(5)
Added “Unity Inbox – Set Search Scope” key for 4.0(5)

Version 1.0.91 – 6/29/2004

Added new “Conversations -- Play Receipt Reason Code” for 4.0(5)

Version 1.0.90 – 6/10/2004

Added “Networking - Change AD container that Bridge contacts are created in” option

Version 1.0.89 – 5/17/2004

Added “# to skip” option to the conversations list for Unity 4.0(4) and later

Version 1.0.88 – 4/30/2004

Fixed minor wording issue with the Domino Disable UMR setting

Version 1.0.87 – 4/9/2004

Numerous settings for the upcoming 4.0(4) release were added or edited.

Version 1.0.86 – 3/31/2004

Added “custom list” option for REG_SZ values
Added search dialog for the Add Keys window
Added “Reject Forwarded Notification DTMF Tone” value
Added “Reject Forwarded Notification Guard Time” value
Added “Set Locale ID of the MAPI profile” value
Added “Enable Identified Subscriber Messaging (ISM) for AMIS, Bridge, Internet or VPIM Subscribers” setting

Version 1.0.84 – 3/18/2004

Removed the “maximum digits” setting for the Got Mailbox branch in the conversations for 4.0(4) – this will no longer be configurable.

Version 1.0.83 – 3/11/2004

Added support for Exchange only or Domino only values in the database.
Updated text with input from Tech. Pubs on the three “exclude receipts” keys for Exchange
Updated “Confirm Delete” key description
Added new “Conversations - Set how deleted messages are deleted in bulk” key for Exchange
Added new “Conversations – Confirm delete when deleting a deleted message” for Exchange.

Version 1.0.81 – 2/25/2004

Added “Conversation - (Unity Domino only) Enable UMR Conversation” option for Unity 4.0(3) and later.
Added “Conversation – Exclude all receipts” option.

Version 1.0.79 – 1/23/2004

Added “Confirm Before Transfer” key for the system transfer conversation in Unity 4.0(4).

Version 1.0.78 – 1/21/2004

Added new setting for minimum extension length for user-defined extensions – for Unity 4.0(4) release.

Version 1.0.77 – 12/23/2003

Added “DoNotPlaySummary” flag for the Unity 4.0(3) ES 33 release

Version 1.0.76 – 12/10/2003

Added “PlayPrompt” key for cross box login feature in 4.0(4)
Added “SinglePilotNumber” key for cross box login feature in 4.0(4)
Added “TransferType” key for cross box login feature in 4.0(4)
Added “full synchronization of bridge subscribers with octel node directories” option for 4.0(3)

Version 1.0.74 – 11/18/2003

Added “EnableGTM” and “Maximum Digits” values for the new 4.0(4) “go to message” feature.
Opened up the “Enable G729” key for all versions of Unity.

Version 1.0.73 – 11/13/2003

Added new key for excluding return receipts from the Unity inbox view
Added support for SQL data in addition to registry information

Version 1.0.71 – 8/1/2003

Updated version check logic for the 4.0(3) release

Version 1.0.70

Fixed problem with key name for the minimum DTMFAccessID length for both subscribers and locations (CSCab61752).

Version 1.0.69

Edited text for the “double key press” adjustment to bring it up to date with the new default values for 4.x

Version 1.0.68

Added basic categories for the settings and sorted the list box to make things easier to find.
Updated the version check option
Added settings for the streamlined message send conversation changes for 4.0(3)
Added setting for customizing skipped new message state for 4.0(3)

Version 1.0.66

Added functionality to check for updated versions

Version 1.0.65

Added “Subscriber Send Message Hang-Up Action” and “Subscriber Send Message Flow” for 3.1(6) and 4.0(3) and later.
Removed Bridge configuration settings for Unity 4.0(3) and later.
Set the minimum location extension to be visible in all versions of Unity 2.4.5 and later

Version 1.0.64

Added new Bridge values for the 4.0(2) release

Version 1.0.63

Fixed a cosmetic issue with the “Confirm Delete” option not updating the present value after pressing set unless you moved off the key and back again.

Version 1.0.62

Fixed a problem with the path to the \conversations\address searcher\ keys missing the space between “address” and “searcher”. CSCea05765.

Version 1.0.61

Added new key for conversation option to change subscriber message addressing confirmation behavior.

Version 1.0.60

Added Bride name parsing order option
Updated setup to include shortcut to Advanced Settings Tool for all users, not just the user that installed it

Version 1.0.59

Fixed minor wording issue in the AGC settings descriptions that indicated AGC shipped disabled – this was true prior to 3.1(5) but for 3.1(5) and later it’s active by default and set to –26 dB.

Version 1.0.58

Fixed the registry paths for the Address Search and Phone Transfer options- the were referencing \Active Voice\Conversation\ instead of \Active Voice\Conversations.

Version 1.0.57

Removed the keys for fax message classes and fax extensions – those are now set through the 3^rd party fax configuration tool. Versions of Unity later than 3.1(5) will not see those keys in the advanced settings tool any longer
Updated help file

Version 1.0.56

Added three “Mixed 55/2K messaging” registry settings for version 3.1(2) and later.

Version 1.0.55

Exposed the “set minimum extension length for locations” option for Unity 4.0 and later

Version 1.0.54

Edited wording on some of the options at tech pubs’ request
Included registry key paths in some of the descriptions at QA’s request
Fixed broken registry path for the record termination warning feature

Version 1.0.52

Added three registry keys for the record termination warning feature offered in Unity 3.1(5)
Exposed the max diagnostic space value

Version 1.0.51

Cleaned up some of the descriptions on the setting options
Added support for the “almost out of record time beep” option being added for 3.1(5).

Version 1.0.50

Fixed problem where installing new version of the Advanced Settings Tool didn’t register with the Tools Depot properly
Added support for 3.1(5) and 4.0(1) versions of Unity
Change version range for the auto attendant search scope setting to include versions through 4.0
Changed wording on Optional conversation setting to have the correct INI file name
Added support for changing the UMR directory location
Change version range for changing the logging location so it’ll show up in 4.0
Added option to disable ISM
Added option to disable adding new users via the SA

Version 1.0.49

Added key for exposing hidden subscribers in AD for Unity 3.1(4) and later.

Version 1.0.48

CSCdx18794 – added “show hidden subscribers” option for Unity 3.1(4) and later in the DirSynchGlobalCatalog registry branch.

Version 1.0.46

Changed the maximum version for the “Show hidden Distribution Lists” option at 2.4.6. In 3.x all DLs are seen all the time so this setting is not relevant.

Version 1.0.45

Added support for MTAFailedPath property in the UnityMTA branch
Added localization support structure and new about box in preparation for localized versions moving forward.

Version 1.0.44

Fixed issue with database end of recordset errors popping up when you first load the tool

Version 1.0.43

Fixed setup problem where shortcut was pointing to wrong EXE
Added AGC Gain Threshold value
Added AGC Sample Size value

Version 1.0.42

Updated for support of 3.1(4)
Added key to allow hidden users to be restricted for Active Directory (by default all hidden objects are picked up by Unity filters). Part of fix for CSCdu67278

Version 1.0.40

Added AGC setting key
Added maximum recording time adjustment key
Added LDAP port key
Added support for 3.1(1), 3.1(2) and 3.1(3) in the add-keys form.
Updated help file, revamped to fit into the Tools Depot framework in Unity 3.1(3).

Version 1.0.35

First release of tool, appeared on 3.0(1) CD set.