Change Director for SQL Server

Version 2.0 build 2.0.0.235

Release Notes

August 2008


Contents

Welcome to Change Director for SQL Server

New in this Release

Resolved Issues and Enhancements

Known Issues

Upgrade and Compatibility

System Requirements

Global Operations

Getting Started

For More Information

 


Welcome to Change Director for SQL Server

Change Director for SQL Server is designed to control packaged deployment of changes to SQL Server production databases and make the database change process transparent and manageable.

The main features of the product are:

Change Director includes Change Tracker, Log Reader and Job Management components.

 

The Change Tracker component monitors Microsoft SQL Server instances and databases for changes, and generates real-time alerts and notifications that can be sent to a recipient list via email or NetSend.

 

The Log Reader component is a SQL data-auditing and data-recovery tool that analyzes the SQL Server transaction log to display information on data and object changes.

With the Log Reader, you can view:

 

The Job Management tool displays information about all SQL Server jobs or Windows Tasks on the registered servers. You can control, monitor, and manage:


New in This Release

 

New Features in Change Director for SQL Server 2.0

 

 

Updates to Change Director for SQL Server 2.0

 

Projects

 

Change Tracker

Log Reader

 

Job Manager

 


Resolved Issues and Enhancements

The following is a list of issues addressed and enhancements implemented in this release of Change Director for SQL Server.

Change Director

Feature

Resolved Issue

Change Request

General

When restarting a SQL Server while working with the Navigation tree in Change Director Console, the Create Project operation no longer results in WinException. No support bundle was generated.

CR#0215322

Localization support

Change Director accepts a valid license key.

Description of Problem:

A valid license key is not accepted during first Quest Change Director for SQL Server launch (on machines with other than English language localization).

 

Windows Vista Support

Change Tracker Agent can now be installed on SQL Server instances that are hosted on Microsoft Windows Vista.

Description of Problem:

Microsoft Windows Vista security architecture restricts access to the Program files directory, therefore Change Tracker Agent installer could not create the files needed for agent execution.

CR#0216377

Snapshots generation and Project deployment can now be scheduled on Microsoft Windows Vista.

Previously-Documented Workaround:

  1. From the Change Director installation directory, right-click TaskStarter.exe and choose Properties.

  2. Select Run this program in compatibility mode for Windows XP (Service Pack 2).

  3. Click OK.

 

Compare Projects

An OutOfMemory exception error no longer occurs when trying to compare databases which contain 10,000 or more objects.

CR#0209580

A table's DDL script now displays the extended properties of the table.

CR#0200733

An incorrect synchronization script for creating UDT from CHAR has now been corrected for non-DBO schemas.

Description of Problem:

When creating UDT for a schema which is different from DBO, the length of CHAR data types is indicated as 0, therefore the Char(0) is used regardless of what is in the source database.

CR#0214984

It is no longer possible to create a view without table.

Description of Problem:

If you choose a view, both views and tables will be synchronized.

CR#0215690

For CLR User-Defined Datatypes, extended properties were displayed in the tree, but not in DDL script. These properties are now present in synchronization script.

CR#0215751

Synchronization of Extended Properties.

If you choose to synchronize a User-Defined Aggregate with non equal status, the aggregate function is no longer created twice.

CR#0215756

Synchronization of Extended Properties.

Extended properties for User-Defined Functions are now synchronized, including their display in the browser tree.

CR#0215763

Same tables are no longer being displayed as different when the "Ignore Constraint Names" option is selected.

Description of Problem:

If you set Change Director to ignore constraint names, equal keys are not compared and not equal keys are set as added and deleted. In this case, mapping for the keys is not used.

CR#0216112

The Dependent User-Defined Functions' for CHECK constraints are now included in synchronization scripts.

CR#0199908

The Extended properties for Tables are now synchronized, as well as being displayed in the tree.

CR#0213035

The Comparison script for CREATE TABLE, where one or more columns have a DEFAULT value, is generated correctly now.

Description of Problem:

The Comparison script for tables where one or more columns have a DEFAULT value is generated incorrectly.

ST#41028

Impact Analysis

The Impact Analysis report now includes information on the impact of CLR functions.

Description of Problem:

Functions used in CHECK constraints are not recognized when creating dependencies, therefore a CHECK function may be deleted prior to the CHECK constraint. (See CR#0214184)

CR#0212042

 

Change Tracker

Feature

Resolved Issue

Change Request

General

Change Tracker's monitoring is no longer limited to only monitoring user (non-system) databases.

CR#0217957

When installing Change Tracker Agent on a SQL Server using (localhost) as a server name, Change Tracker no longer registers 2 servers within the Console: (localhost) and a server with the real server name.

CR#0204875

The Call of the sp_addapprole stored procedure now appears in real-time alerts.

CR#0172561

[create APPLICATION ROLE] and [alter APPLICATION ROLE] now appear in real-time

alerts.

CR#0178249

Real-time alerts now display names of objects where they were incorrectly displaying the name of variables instead.

CR#0182400

It is now impossible to configure or re-configure the monitoring of SQL Server instances

which are registered within the Change Tracker window by IP address.

CR#0204898

ST#35548

Change Tracker Agent

Agent can be installed normally on 64-bit server and workstation.

Note: Vista 64-bit is not supported for remote agent deploy.

ST#33854

CR#0170598

 

Change Tracker Reports

The message  "Database is already open and can only have one user at time" now appears when monitoring has stopped while the database is not online.

CR#0171520

"Alter database restores xml_sch1" command now appeared in real-time alerts.

CR#0178002

ST#34616

More details are now provided for the Operation Type in Alert Reports. For example, the Create, Alter, or Drop operation is now displayed where it used to say "Unknown" operation type.

CR#0216140

Log Reader

Feature

Resolved Issue

Change Request

General

Log Reader now supports 64-bit based SQL Servers.

CR#0206477

When reading big log files (more than 100GB), you will not no longer receive the OutOfMemory exception error message.

 

Log Reader issue with reading backups - resolved.

 

Log Reader now displays user, login, host, and application information for transactions started when the Log Reader is connected to a server only.

Log Reader now collects NT User, SQL Login, User Host, and Application information for transactions started when the Log Reader is connected to the server only.

 

 

Known Issues

The following is a list of issues known to exist at the time of Change Director for SQL Server release.

Change Director

Feature

Known Issue

Change Request

General  

It is not possible to preserve the license key when installing over the v1.x (1.2

and 1.5). A bug in the 1.x uninstaller removes licensing information. In addition,

you cannot see the existing key on the v1.x installation. You will need access to

the license key in order to run the v2.0.

 

SQL Server 2008 is not supported.

 

SQL Server Look Up cannot find SQL Server clusters.

CR#0175466

Register SQL Server: It is possible to add two identical servers. You can add a server using either its IP address or its hostname, therefore there may be duplication of registered servers when you mix these two options. It is possible to duplicate an already registered server by registering it using another type of identification.

CR#0175518

An exception error occurs when trying to view a database schema which contain 10,000 or more objects.

CR#0210616 (ST#34977)

Sometimes the error message, "A required privilege is not held by the client. Please contact your system administrator" displays when you try to create a Scheduled Deployment task on Windows 2000.

Workaround:

  1. From the Start menu, run Control Panel.

  2. Choose Administrative Tools.

  3. Run Local Security Policy.

  4. In the navigation pane, expand the Local Policies node and select User Rights Assignment.

  5. Double-click the Act as part of the operating system policy in the Policy list.

  6. In the Properties window, click Add User or group, add your system account, and click OK.

  7. Exit from the Local Security Policy tool.

  8. Log off from the system and log in again.

ST#34470

If you drop a user-defined function that uses a trigger, the trigger and its table are also dropped.

ST#35086

Deployment fails if a target database contains DDL triggers.

Workaround:

Disable DDL triggers manually before deployment.

ST#35093

The Console does not work on Vista 64-bit if the SQL Server Management Studio is started and connected to the same server.

Workaround:

Close the SQL Server Management Studio connection and then start the Change Director console.

ST#41429

You cannot save the Options for the logging level when running on Windows Vista.

Workaround:

Run the regedit.exe tool and change the registry value:

[HKEY_LOCAL_MACHINE\SOFTWARE\Quest Software\Quest Change Director for SQL Server\Console]

"Log"=dword:00000003

ST#41620

Change Director does not support databases with compatibility level less than 8.0.

 

Installer

An error appears if there is no free disk space available.

CR#0174359

Windows Tasks

By default, Windows tasks on remote Vista computers cannot be managed from Windows Server 2003, Windows XP, or Windows 2000 computers.

Workaround:

  1. Add your account to the Administrators group on the remote Windows Vista computer.

  2. If Windows Firewall is enabled:

    1. From the Start menu, select Control Panel.

    2. Click Switch to Classic View.

    3. Double-click Windows Firewall.

    4. On the Exceptions tab, select File and Printer Sharing.

  3. To enable the "Remote Registry" service, open a Command Prompt and run the following command:

net start "Remote Registry"

ST#34442

A Windows task becomes invalid after it is renamed.

Workaround:

  1. After renaming, open the task.

  2. Edit anything in the task.

  3. Click OK.

  4. Enter credentials for the task to use.

ST#33856

Compare Projects

Sometimes for triggers, stored procedures, or functions when there is a difference between the two objects being compare, Change Director displays the scripts as equal.

CR#0214451 (ST#35075)

Roles with different owners are identified as equal. The script generated by Change Director does not take into account the role's owners.

CR#0200887 (ST#34888)

Different types of Roles are not identified.

CR#0200889 (ST#34889)

Stored procedures with the FOR REPLICATION option are deployed incorrectly.

CR#0191048 (ST#34820)

An incorrect script is generated for a table with a computed column with the PERSISTED and NOT NULL options.

Description:

For SQL Server 2005, Change Director does not read the PERSISTED and NULL/NOT NULL Computed Columns options. These options are, therefore, not synchronized.

CR#0214053 (ST#35064)

After synchronization of equal databases, DDL Triggers may have different Ansi Nulls and Quoted Identifier options.

CR#0214317 (ST#35073)

Assemblies created from similar DDLs are recognized as different if they have different names.

CR#0217155 (ST#35124)

Schedule deploy step: Currently, the Console user credentials are used to create scheduled deployment windows task. The User must have rights to create a Windows task on the server where middle tier is installed.

ST#41928

The error message, "Unable to resolve column level collations" may occurred during BCP backup.

Description:

The BCP error occurs if the operating system code page or the code page that is specified in the BCP statement is not one of the following: 437, 850, 874, 932, 934, 936, 949, 950, 1250-1258.

The explanation and workaround are described here:

http://support.microsoft.com/kb/867677/en-us

ST#41798

Deployment fails with the error message, "Windows NT user or group <UserName> not found. Check the name again" if the Windows user (objects’ owner on source server) does not exist on target server.

ST#41977

A Support Bundle exception error occurs when a Primary Key in a source database has the same name as a Unique Key in a target database.

ST#35546

Rollback

An incorrect rollback script is generated for tables with dependent functions.

Description:

Change Director does not check CHECK constraints text for dependent  objects.

CR#0214184 (ST#35375)

An Incorrect rollback script is generated when there is CHECK function.

Description:

Functions used in CHECK constraints are not recognized when creating dependencies, therefore a CHECK function may be deleted prior to the CHECK constraint.

CR#0214184 (ST#35375)

Impact Analysis

An incorrect message is displayed for syntax error on the DROP TRIGGER operation.

Description:

When using a single-part name in a DROP Trigger statement, a syntax error is detected in the Impact Analysis report.

CR#0214209 (ST#35070)

Snapshot Viewer

Sometimes an exception occurs when closing Snapshot Viewer. The error may be caused by diagram drawing.

CR#0210890 (ST#34980)

Middle Tier

Middle tier configuration

The Middle tier is starting under Local System account by default.

If one of the source, target, or repository connections is using Windows authentication and the tasks are starting across the middle tier, then the connections to source, target, and repository are created under Windows account which was used to start the Change Director Middle tier (Local System by default).

Workaround:

The account can be changed in Windows snap-in Services.

 

Middle tier uninstall

Middle tier can only be un-installed manually.

 

Middle tier use

Compare Changes: Exception errors occur when the connection to middle tier is lost.

Description:

When the Middle tier is restarted while a comparison project is opened, an exception error may occur in the Console.

ST#42131

Remote Installation

The remote installation of the Middle tier to Vista is not supported

ST#41987

Change Director command line interface

Differences in comparison with default options

When using the command line interface to generate a synchronization script to compare databases, the "Script NOT NULL with constraint" option is cleared. In Change Director console, this option is selected be default.

 

Online Help

Scripting Command Line Interface Commands

The command in the description of the schedule Change Director CLI script procedure is incorrect. To schedule a script execution in the Run field of the scheduled task properties, enter the following command:

"%SystemRoot%\system32\WindowsPowerShell\v1.0\powershell.exe"  -PSConsoleFile ChangeDirectorSnapIn.psc1 -Command ". script.ps1"

where:

  • %SystemRoot% is an environment variable with the path to your system root directory (usually, C:\WINDOWS)

  • ChangeDirectorSnapIn.psc1 is a full path to a previously saved PowerShell console configuration file

  • script.ps1 is the full path to a script file.

 

Change Tracker
Change Tracker load limitations

SQL Server drops SQL Trace data into the files on target hosts. Change Tracker Agent processes the files and loads the data into the Change Director. When the load on a monitored SQL Server increases for a short period of time, files grow faster than Change Tracker is able to process them. In case of a short-term increase, Change Tracker takes over processing of accumulated data when the load returns to average. Change Tracker can processes up to 4000 statements/sec in Regular Mode (used by default) and about 500-600 statements/sec in Advanced Mode. See help file for differences between Regular Mode (previously known as Simple Mode)  and Advanced Mode.

Feature

Known Issue

Change Request

Change Tracker Agent  Installer

The installation of the Change Tracker agent on a SQL Server cluster fails.

Workaround:

Change Tracker can be installed on clustered system manually.

ST#34599

Agent Installation: The Change Tracker Agent is always installed under the C:\Program Files\...directory and cannot be changed.

From v2.0, the path to log and trace files can be changed to other custom folder.

CR#0192942

Sometimes the Remote Agent Installation fails to install Change Tracker agent.

Workaround:

  1. Copy the ChangeTracker.msi from the Change Director installation directory to the remote host where you want to install the agent.

  2. Run the installation package and follow the prompts.

CR#0215285

Manual Agent installation: When installing a Change Tracker agent on a host where two or more SQL Server instances reside, you may receive the following error if some of the instances use the same port:

10/23/06 19:37:05 Initialize: Start

10/23/06 19:37:05 Initialize: End

10/23/06 19:37:05 Install to instances: Start

10/23/06 19:37:05 'Add' mode

10/23/06 19:37:05 Install to instance [instance_name]: Start

10/23/06 19:37:05 Load database scripts

10/23/06 19:37:06 SQL Server 2000 utilities found

10/23/06 19:37:06 Check database Change Tracker

10/23/06 19:37:15 Check of database failed

10/23/06 19:37:15 Execution of isql failed with exit code: 1. Error: . Output: DB-Library: Unable to connect: SQL Server is unavailable or does not exist.  Unable to connect: SQL Server does not exist or network access denied.

Net-Library error 2: ConnectionOpen (Connect()).

10/23/06 19:37:15 Install to instance [instance_name]: Failed

10/23/06 19:37:15 Install to instances: Failed

Workaround:

Configure SQL Server instances to use different ports and reinstall the Change Tracker agent.

 

The Change Tracker agent can not be deployed remotely on Windows Vista machine due to Vista security restrictions.

Workaround:

Install Change Tracker agent manually.

ST#33851

Change Tracker Agent

Log file growth.

When installed, the Change Tracker agent writes information on Change Tracker Trace starts/stops to the SQL log and Windows event log. This may result in a large number of messages being sent to the log files. To prevent this situation, disable the 19030 and 19031 sys messages. To disable sys messages in SQL Server 2005, follow the steps below.

Workaround for SQL Server 2005:

  1. Install Hotfix Q922578 (b2153) from the Microsoft web site.

Note: You will need to restart the computer if:

  • SQL Server 2005 Analysis Services are running as a named instance and you stopped the SQL Server Browser service before applying this hotfix.

  • You exited all Analysis Services tools and all client applications before applying this hotfix.

  • You exited Microsoft Internet Information Services (IIS) before applying this hotfix.

  1. After the hotfix installation, stop SQL Server and restart it with new flag: /T3688

For example:  net start "SQL Server (INSTANCE1)" /T3688

  1. Ensure that the SQL Server was started with the correct flags:

DBCC TRACESTATUS (3688)

go

Check that Status and Global equals 1.

Trace start/stop messages will not be logged in the SQL Server error log or the Windows Event log.

SC485813-1

Changes in server parameters applied through the master..xp_instance_regwrite stored procedure do not appear in real-time alerts.

For example: Login audit level, log & data files path

CR#0172259

Sometimes the [application] does not appear in real-time alerts.

CR#0178088

An exception error occurs if virtual memory is very low.

CR#0176835

The Change Tracker agent may stop work normally if monitored server or repository server have insufficient resources.

ST#42081

The Change Tracker agent does not stop when SQL Server stops.

CR#0192319

Change Tracker Reports

SMTP notification fails when SMTP server requires authentication.

ST#35548

Change Tracker Window

Sorting of a Real-Time Alerts report for a database or server is accurate to within 1 second. If you perform several operations in 1 second, Change Tracker may display them in the wrong order.

CR#0191829

When the monitored database is renamed, Change Tracker will continue to monitor it, but the results will be not be visible at the Console and therefore the monitoring for this database cannot not be stopped at the Console.

 

Workaround:

There are two workarounds:

 

1) Run the following script on the Change Director repository:

declare @Server nvarchar(255)

declare @OldDBName nvarchar(255)

declare @NewDBName nvarchar(255)

set @Server = '<Server>'      -- Server name with renamed database

set @OldDBName = '<Old_DB_Name>'          -- Old database name

set @NewDBName = '<New_DB_Name>'        -- New database name

UPDATE

[<RepositoryName>].dbo.SW_SQLDatabase

SET

SW_SQLDatabase.DatabaseName = @NewDBName

FROM [<RepositoryName>].dbo.SW_SQLDatabase db

inner join [<RepositoryName>].dbo.SW_Servers srv ON srv.ServerId = db.serverID

WHERE

db.DataBaseName=@OldDBName

AND srv.InstanceName = @Server

 

where <RepositoryName> is the name of Change Director repository database

 

or

 

2) Change name of monitored database directly at the Change Director repository at table SW_SQLDatabase using any SQL query tool.

ST#34745,

ST#41666

Failed operations and rolled-back transactions are displayed in reports.

CR#0170115

Once you have started the installation or uninstall of the Change Tracker Agent using the Console, you cannot stop the process. If you click Cancel when installing or uninstalling Change Tracker Agent using the Console, Change Tracker closes the dialog window, but continues the operation.

CR#0194895

There is no script for encrypted functions or stored procedures in real-time alerts.

Note: This is done for security reasons.

CR#0178100

After refreshing the work area on an instance level node, Change Tracker always displays the Overview tab regardless of which tab was chosen before refreshing.

CR#0191823

In NetSend notifications on Failed Logins, international characters are displayed incorrectly.

CR#0195809

Sometimes, the agent stop responding and you will find 'COM exceptions' in the logs.

Note: Agents have an auto recovery capability that allows then to get back to work normally after COM objects failure.

ST#41988

Change Tracker service: There are no [Create APPLICATION ROLE] and [Alter APPLICATION ROLE] statements in real-time alerts

ST#34620

Change Tracker doesn't take into account Daylight Saving Time, only the native GMT time is shown.

ST#34798