Dell™ ChangeBASE Release Notes

Dell™ ChangeBASE
Release Notes
February 12, 2015
About ChangeBASE 6.2.2
Dell™ ChangeBASE is a leading provider of automated application compatibility analysis, remediation and
conversion.
ChangeBASE can assess and fix application compatibility issues automatically prior to migration to the latest
Microsoft platforms and virtualized package environments. It also enables you to virtualize your packages
automatically.
Features and Enhancements
Features and Enhancements
Issue ID
ChangeBASE is now integrated with the Asset Manager database.
273421
The Dependencies tab and the application grid on the Applications screen now shows
the application dependencies.
321899
Support for Windows Server 2003 R2, Windows Server 2008 R2 and Windows Server 2012 385609
on virtual machines that are used for repackaging by MSI Studio.
ChangeBASE can now import AppZero VAA packages.
388296
You can set up an alert that informs ChangeBASE users about the product license
expiry.
320774
ChangeBASE can now import .APPV files.
414097
Now you can amend the text file extensions which ChangeBASE will read during the
import operation. The file extensions can be added directly to the ChangeBASE
configuration file or in the Import section of the Product tab on the Settings screen.
414387,
352082
DaCC - Now Dependency and Conflict Checker shows .NET dependencies.
415414
DaCC - From this version, Dependency and Conflict Checker collects Assembly
References and Interop Declarations from .NET metadata and stores the information
as a part of a package import.
416650
DaCC - Now DaCC can show which source dll has the dependency or conflict.
419076
ChangeBASE 6.2.2
Release Notes
1
Resolved Issues
Internal Features and Fixes
Issue ID
Incorrect RAG is displayed when importing an MSI that was created during a
Repackaging session - the parent application remains with a grey RAG.
429278
NOTE: If upgrading from ChangeBASE version 6.2, these repackaged MSIs will need to
be deleted and re-imported in order for the correct RAG to be displayed.
Unable to import more than one MSI created by the Repackaging process with the
"Repackaged MSI already imported for this application" error.
429308
The Print Preview context menu item appears when right-clicking in the toolbar on
the Reporting screen.
307362
ChangeBASE reports do not show full issue details for Web applications.
414186
The confirmation message appears only one time when you specify a new platform
under Platform tab on the Settings screen. Then if you add another platform, there is
no confirmation message displayed.
415785
ChangeBASE cannot import large (50 MB+) web capture files.
394692
The Application Compatibility Report for a Web application incorrectly uses
Investigate Red Issues category for the Amber issues.
411139
An unhandled exception occurs when you press Highlight Issue Source Line for
DOCTYPE declaration analysis check.
411151
When an application is ready for conversion on the Convert screen, dragging a package
from the Applications to convert grid to the Prerequisites and Packages grid does not
work.
413884
When you specify an invalid entry in a text box (e.g. SQL Server text box, UNC Path
text box, numeric only text box), ChangeBASE does not show any error exclamation.
410168
ChangeBASE stops responding, and eventually crashes with a timeout error if there are
multiple WCF calls at once.
411531
Repackaging of an EXE file may fail with an error if the specified path to this file is other
than the current directory.
371390
If you clone an existing check in the Custom Checks screen, and then immediately
attempt to export it without making any changes or saving it first, you receive an
"Object reference not set to an instance of an object" error after specifying the save
location and file name. However, if you set the package type and then click Save, the
export will be completed successfully.
412894
ChangeBASE cannot import WIM images to DaCC when a folder path includes '.exe'. In
this case, you may get errors similar to the following: "FirstChanceException:
System.AggregateException: One or more errors occurred. --->
System.IO.FileNotFoundException: C:\Windows\TEMP\CB_4394221e-b805-4a32-8f2822162ea37b9f\0386ff6e-987e-439e-9f68-fcf0980480f6\setup.exe".
421366
The underscore character is not displayed in tabs that show platform names on the
Checks screen.
416090
The Platform Summary widget does not show Virtualization Technology.
416378
You may get errors in the log after running the Queries on the Reporting screen.
416704
When attempting to fix an issue in a package, the following error appears under the
417938
ChangeBASE 6.2.2
Release Notes
2
Internal Features and Fixes
Issue ID
Log tab on the Checks screen, accompanied by a red exclamation mark in the Issue
Status column: "Unable to load supporting data for fix set cd5ac56f-7d38-4a1d-a0fe68ac000abf29 at CB.Fix.ServiceImplementations.FixPackageSupportingInfo.Load() at
CB.Fix.ServiceImplementations.FixController.PostInitialise() at
CB.Fix.ApplyFixSet.Execute(Int16 dbDefn, Int32 transactionId, String fixSetId)".
When adding an imported WIM image to a build in DaCC, the error like the following
may arise: ", hexadecimal value 0x02, is an invalid character. Line 1537782, position
107".
421408
Unable to import WIM images to DaCC when the ChangeBASE service is running on 32-bit 421384
machine.
When you enable a link to an external .CSV file and then save that link on the External
screen (CSV option is selected) this may cause an exception in the ChangeBASE Service
log.
424508
Unable to select a database in DaCC if there are multiple SQL databases.
422857
ChangeBASE may crash when importing packages into a large SQL database.
421540
The Application Compatibility Report fails, and displays the following error at the top
of the screen: "Failed to execute report: Property accessor 'TotalEffortManual' on
object 'CB.Data.Shape.ParentedAggregatePlatformBundle threw the following
exception: 'Input string was not in correct format'". In this case, the Summary Report
will have empty "Effort" fields.
424958
Unable to open the CSV Export report with the following error message: "Query
[Out.Applications.WithReportingSubGroups]not found".
426777
You may get incorrect values of the CB Effort and Manual Effort fields in a web report
if this report was created on a non-English operating system and then imported on
English operating system.
406892
If your vCenter Server environment has a Datacenter contained in a Folder, any virtual
machines under that Datacenter will not work when repackaging or virtualising starts.
427745
The search feature (binoculars icon) does not work on the Reporting screen.
298421
Text fields in the SQL Server Address section under the Database tab on the Settings
screen can be changed after you initiate the connection process by clicking the Next
button.
300525,
300500
DaCC - WRP-protected resources are not show in the Protected column on the Files
tab in Dependency and Conflict Checker (DaCC).
414698
DaCC - If any optional columns are added in the right hand pane in DaCC, and DaCC is
then restarted, these columns will be lost.
410731
DaCC - When you open DaCC from the Applications screen, DaCC should open the
database that is currently active in the client. However, when there are multiple
databases defined to the service, DaCC always opens the database that was created
first, not the database that was active at the time of invoking DaCC.
416739
MSI Studio - In MSI Studio, the HKLM registry key is displayed as KKLM in the registry
Key Path field in the Edit Component dialog.
340069
MSI Studio - The Upgrade Wizard in MSI Studio adds ActionProperty instead of the
SecureCustom property to the upgrade table.
346395
MSI Studio - The Upgrade Wizard in MSI Studio adds the same ActionProperty to the
346397
ChangeBASE 6.2.2
Release Notes
3
Internal Features and Fixes
Issue ID
upgrade table for each upgrade operation.
MSI Studio - In the Files section in MSI Studio, after the application capture is
complete, the MSI of the newly created capture is listed as a file that is a part of the
application.
351942
MSI Studio - In MSI Studio, the level of a feature is changed to 0 for a Response
Transform (MST).
340088
MSI Studio - Users cannot add registry keys to a specifc component using the
components section in MSI Studio.
354801
MSI Studio - When you open an MSI file in MSI Studio, and then access the Code Page
screen from the View menu, the Confirm button is inaccessible.
419880
MSI Studio - You may get incorrect registry keys after ICE03 validation check.
341472
MSI Studio - MSI Studio creates hard cdoded paths that cause errors when applications
are imported to ChangeBASE.
355798
ChangeBASE 6.2.2
Release Notes
4
Known Issues
The following issues are known to exist at the time of this release.
Known Issues
Issue ID
Custom Checks - You may get a warning while upgrading an existing ChangeBASE
instance if you add a custom check and then delete it at any time. To resolve this
problem, follow the instructions from this knowledge base article:
https://support.software.dell.com/kb/147509.
430906
Asset Manager Integration Script - If the KeyField column does not show up as the
second column (the Status column is the first) then it is likely that the most recent
Windows Updates are not applied.
N/A - this is not a
ChangeBASE issue
For more details, refer the following Dell KB article:
http://en.community.dell.com/techcenter/applicationmanagement/changebase/changebase-api/b/weblog/archive/2015/01/13/linkingchangebase-with-asset-manager
427622
DaCC - Dependency & Conflict Checker may crash when adding optional columns to
the Applications grid.
For more details, refer https://support.software.dell.com/kb/146708.
DaCC - Dependency & Conflict Checker may not reflect all changes that were made in
ChangeBASE.
410730
For more details, see https://support.software.dell.com/kb/146710.
ChangeBASE cannot build repackaged MSIs during auto-conversion.
377350
For more details, refer https://support.software.dell.com/kb/146630.
Users are unable to see some issues for Custom Checks.
428165
For more details, see https://support.software.dell.com/kb/146633.
UAC check raises false issue in certain circumstances.
322550
Error when wrong error account used in domain environment.
342559
Clicking the Test button does not show any matching items in some circumstances
when setting up external data.
355543
External matching with CSV import: DBCS languages are not read correctly.
359325
Hard-coded File Reference Scan not identifying an issue in the IniFile and Shortcut
tables.
388263
Removal of Windows 8 as target OS in App-V 4.6SP1 can cause virtualization to fail.
385562
Missing menu options and confirmations in DaCC at low resolution.
398043
For App-V conversions, if Windows XP 64 bit OS override is specified, this is not being
reflected in the OS VALUE setting in the sprj project file.
385935
In cases where the ChangeBASE service is hosted on a server with a Cyrillic OS, and
the SQL Server is hosted on a non-Cyrillic OS reporting issues occur.
396907,
ChangeBASE 6.2.2
Release Notes
5
Known Issues
Issue ID
395871
Indexes can become fragmented when importing large numbers of packages, please
see ChangeBASE knowledge base article 135255 for SQL Server maintenance
recommendations.
SOL135255
ChangeBASE 6.2.2
Release Notes
6
System Requirements
Before installing ChangeBASE 6.2.2, ensure your system meets the following minimum requirements:
Training/POC (For
example, less than 50
packages)
Small Operation (For
example, less than
1,000 packages)
Medium
Operation
(For
example,
between
1,000 and
5,000
packages)
Large
Operation
(For
example,
more than
5,000
packages)
ChangeBASE Client
Dual core CPU, 4GB RAM
Quad core CPU, 8GB RAM
Quad CPU,
16GB RAM
Quad CPU,
16GB RAM
ChangeBASE Server
Dual core CPU, 4GB RAM
Quad core CPU, 8GB RAM
8-core CPU,
16GB RAM
16-core
CPU, 32GB
RAM
MSI Studio
MSI Studio requires Microsoft .NET 4.0 Framework to be installed.
SQL Server
As per Microsoft
recommendations for a 1GB
database
As per Microsoft
recommendations for a
20GB database
As per
Microsoft
recommend
ations for a
100GB
database
As per
Microsoft
recommend
ations for a
database
larger than
100GB
For more details about system requirements, please refer ChangeBASE User Guide.
IMPORTANT: We have added functionality in the Dependency and Conflict Checker (DaCC) that allows
users to detect .NET dependencies. We need to collect extra application data to facilitate this and as a
result it will increase the ChangeBASE database size. For customers with very large application estates
this increase could be significant.
ChangeBASE 6.2.2
Release Notes
7
Product Licensing
To activate an evaluation license
1. During the setup of ChangeBASE 6.2.2, ensure that, on the SQL Server Database screen, you select Use
Eval License before clicking Create.
2. Your database is then set up and associated with a trial license that allows you to use ChangeBASE for a
30-day evaluation period and import and assess up to 35 packages. You will also be able to fix,
repackage, virtualize, and report on, 50% of these packages.
To activate a purchased commercial license
1. During the setup of ChangeBASE 6.2.2, ensure that, on the SQL Server Database screen, you select
Enter License Details. Then enter the License Key and Site Message exactly as supplied by Dell, before
clicking Create.
2. Your new database is then set up and associated with the license that was supplied to you. To check
what exactly you are licensed for, go to your Dashboard and open up the Details on the License
Usage widget.
3. If at any time you want to renew your license, go to Settings > License Upgrade and enter your new
License Key and Site Message.
Getting Started with ChangeBASE 6.2.2
Installing ChangeBASE
To install:
1. Download and run the Dell ChangeBASE MSI (version 6.2.2) from Software Downloads available from
https://support.software.dell.com/changebase.
Upgrading ChangeBASE
Large database upgrades (in excess of 1000 applications), may take considerable time to upgrade, please be
aware of this and do not cancel the process.
Note: You do not need to uninstall previous versions before installing version 6.2.2.
To upgrade:
1. Before upgrading ChangeBASE take a backup of your database.
2. Download the Dell ChangeBASE MSI (version 6.2.2) from Software Downloads available from
https://support.software.dell.com/changebase.
2. Shut down the client(s).
ChangeBASE 6.2.2
Release Notes
8
3. If the service is logged in as a user that is not LocalSystem and also not the same as the user performing
the installation, a password prompt dialog appears during the installation.
4. If the client and service are installed on the same machine, simply double-click the file and follow the
prompts. In a multi-user environment, the patch must be installed on the service first, and then
installed on each client in turn.
5. During installation of the patch on the service, you will be notified when the ChangeBASE service is
automatically stopped or started. When installation of the patch is complete, the ChangeBASE service
will be left running.
6. Following installation on the client(s), restart the client(s) and verify that the version number displayed
on the user interface is now 6.2.2 and also that you can see all your previously imported applications in
the Applications window. The Microsoft Patch Tuesday checks from July 2013 to February 2014
(inclusive) will have been loaded for running from the Reporting module. In addition, the new and
amended checks will be displayed (refer to Checks_suffixes).
7. Following installation on the client(s), restart the client(s) and verify that the version number displayed
on the user interface is now 6.2.2 and also that you can see all your previously imported applications in
the Applications window. The Microsoft Patch Tuesday checks from July 2013 to September 2014
(inclusive) will have been loaded for running from the Reporting module. In addition, the new and
amended checks will be displayed (refer to Checks_suffixes).
IMPORTANT: If the upgrade fails, for example if there are no previously imported applications showing in
the Applications window after the upgrade, follow the instructions in Contacting Dell. In any
communication with Support, be sure to attach all the log files in the directory
%ProgramData%\ChangeBASE\Logs. You will then be supplied with an executable file and associated
instructions to enable you to complete the upgrade successfully.
IMPORTANT: Please note if you are upgrading from 6.1.1 you may have already made this change.
The fix for making repackaging work utilizing MSI Studio in a 64bit guest VM requires the updating of a
batch file. This batch file resides in the ‘Program Files\Dell\ChangeBASE\MSI Studio’ folder (or
‘Program Files (x86)\Dell\ChangeBASE\MSI Studio’ folder in a 64 bit machine) wherever MSI Studio has
been installed. However, updating the ChangeBASE installation in the host will not cause the batch file
in the guest VM to be updated.
There are four methods of updating the batch file in the guest VM outlined below and the most
appropriate method for your specific environment should be chosen:
1. Edit the custom conversion settings in the ChangeBASE host so that it copies over the updated
batch file at the start of the repackaging process:
a. Copy the msistudio.bat from file to an empty folder that the ChangeBASE Service can
access (copying just the batch file will ensure that only that file is copied over to the
guest VM, not the whole of the ‘MSI Studio’ folder from the ChangeBASE host machine)
b. In ChangeBASE
a. Navigate to the Settings, Conversion, Custom Conversion Technologies screen ii.
Select the required technology ‘MSI Studio (x64)’ iii. Uncheck the Use Preinstalled Tools.
b. Specify the folder’s UNC path where the batch file has been copied to in the
‘Tools Path (on host)’ field.
c. Save the changes
Note that this option does not require the guest VM to be updated – the updated
batch file will be copied over at the start of each repackaging process using this
technology.
ChangeBASE 6.2.2
Release Notes
9
2. Revert to an earlier snapshot in the guest VM (a snapshot that doesn’t have MSI Studio installed),
and install MSI Studio using the latest ChangeBASE MSI. A new snapshot should then be taken
and the Conversion settings updated in ChangeBASE to reflect this new snapshot name if
necessary.
3. Re-install MSI Studio using the latest ChangeBASE MSI in the existing guest VM. A new snapshot
should then be taken and the Conversion settings updated in ChangeBASE to reflect this new
snapshot name if necessary.
4. Manually copy over the batch file to the ‘Program Files (x86)\Dell\ChangeBASE\MSI Studio’
folder in the guest VM, overwriting the existing file. A new snapshot should then be taken and
the Conversion settings updated in ChangeBASE to reflect this new snapshot name if necessary.
CBVM Tools
CBVM Tools must be upgraded in any VM snapshots used by ChangeBASE. This new version provides features
which ChangeBASE 6.1 onwards requires. Please note if you are upgrading from 6.1.1 you may have already
made this change.
1. Locate to tools on the ChangeBASE server. They are found in Program
Files\Dell\ChangeBASE\Resources\CB VM Tools.
2. For each VM Snapshot used by ChangeBASE you must revert the snapshot, and copy the CBVMTools
Setup.msi to the guest to install them.
You may need to restart the VM after installation.
3. Once installation is complete, re-snapshot the VM and give it the same name as the parent snapshot.
This will remove the need to update the ChangeBASE Settings.
If you do name it the same as the parent snapshot, you must delete the parent snapshot so there is only
one snapshot with that name.
Additional Resources
Additional information is available from the user guides in the following locations:
l
https://support.software.dell.com/changebase
l
http://documents.software.dell.com/changebase
Globalization
This section contains information about installing and operating this product in non-English configurations, such
as those needed by customers outside of North America. This section does not replace the materials about
supported platforms and configurations found elsewhere in the product documentation.
This release supports any single-byte or multi-byte character set. It supports simultaneous operation with
multilingual data. This release is targeted to support operations in the following regions: North America,
Western Europe and Latin America, Central and Eastern Europe, Japan.
ChangeBASE 6.2.2
Release Notes
10
About Dell
Dell listens to customers and delivers worldwide innovative technology, business solutions and services they
trust and value. For more information, visit www.software.dell.com.
Contacting Dell
Technical support:
Online support
Product questions and sales:
(800) 306-9329
Email: [email protected]
Technical support resources
Technical support is available to customers who have purchased Dell software with a valid maintenance
contract and to customers who have trial versions. To access the Support Portal, go to
http://software.dell.com/support/.
The Support Portal provides self-help tools you can use to solve problems quickly and independently, 24 hours
a day, 365 days a year. In addition, the portal provides direct access to product support engineers through an
online Service Request system.
The site enables you to:
l
Create, update, and manage Service Requests (cases)
l
View Knowledge Base articles
l
Obtain product notifications
l
Download software. For trial software, go to Trial Downloads.
l
View how-to videos
l
Engage in community discussions
l
Chat with a support engineer
Third-party contributions
This product contains the third-party components listed below. For third-party license information, go to
http://software.dell.com/legal/license-agreements.aspx.
List of third-party contributions
Component
License or acknowledgement
ANTLR 3.3
Copyright (c) 2010 Terence Parr. All rights reserved.
Portions Copyright 2002-2010 Atsuhiko Yamanaka, JCraft,Inc.
ChangeBASE 6.2.2
Release Notes
11
Component
License or acknowledgement
All rights reserved.
Apache 2.0.54
The Apache Software License, Version 1.1 Copyright (c) 2000
The Apache Software Foundation. All rights reserved.
Avalon Doc 2.0
Copyright (c) 2007-2013, Xceed Software Inc. All rights
reserved.
Jint 0.9.2
The MIT License (MIT) Copyright (c) 2011 Sebastien Ros.
NUnit 2.4.6.0
Portions Copyright © 2002-2009 Charlie Poole or Copyright ©
2002-2004 James W. Newkirk, Michael C. Two, Alexei A.
Vorontsov or Copyright © 2000-2002 Philip A. Craig
ChangeBASE 6.2.2
Release Notes
12
© 2015 Dell
Inc.
ALL RIGHTS RESERVED.
This guide contains proprietary information protected by copyright. The software described in this guide is
furnished under a software license or nondisclosure agreement. This software may be used or copied only in
accordance with the terms of the applicable agreement. No part of this guide may be reproduced or
transmitted in any form or by any means, electronic or mechanical, including photocopying and recording for
any purpose other than the purchaser's personal use without the written permission of Dell Software Inc.
The information in this document is provided in connection with Dell Software products. No license, express
or implied, by estoppel or otherwise, to any intellectual property right is granted by this document or in
connection with the sale of Dell Software products. EXCEPT AS SET FORTH IN DELL SOFTWARE'S TERMS AND
CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR THIS PRODUCT, DELL SOFTWARE ASSUMES NO
LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS
PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL DELL BE LIABLE FOR ANY DIRECT, INDIRECT,
CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR
LOSS OF PROFITS, BUSINESS INTERRUPTION OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR INABILITY
TO USE THIS DOCUMENT, EVEN IF DELL SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Dell Software makes no representations or warranties with respect to the accuracy or completeness of the
contents of this document and reserves the right to make changes to specifications and product descriptions
at any time without notice. Dell Software does not make any commitment to update the information
contained in this document.
If you have any questions regarding your potential use of this material, contact:
Dell Software Inc.
Attn: LEGAL Dept
5 Polaris Way
Aliso Viejo, CA 92656
Refer to our web site (www.software.dell.com) for regional and international office information.
Patents
This product is protected by U.S. Patents #7,814,260; 7,913,043; 7,979,650; 8,086,782; 8,145,864; 8,171,247;
8,255,654; and 8,271,755. Protected by Japanese, E.U., French, and UK patents 1615131 and 05250687.0, and
German patent DE602004002858. Additional Patents Pending.
Trademarks
Dell and the Dell logo are trademarks of Dell Inc. and/or its affiliates. Other trademarks and trade names may
be used in this document to refer to either the entities claiming the marks and names, or their products. Dell
disclaims any proprietary interest in the marks and names of others.
Legend
CAUTION: A CAUTION icon indicates potential damage to hardware or loss of data if instructions are
not followed.
WARNING: A WARNING icon indicates a potential for property damage, personal injury, or death.
IMPORTANT NOTE, NOTE, TIP, MOBILE, or VIDEO: An information icon indicates supporting information.
ChangeBASE 6.2.2
Release Notes
13