Home

ChangeBASE 5.3 - User Guide

1. Click Previous to enter a different user name or password If you still cannot connect to SQL try using the same credentials in SQL Server Management Studio to test them If the credentials do not work in SQL Server Management Studio you should either obtain the correct credentials or reinstall reconfigure SQL Server in accordance with 2 2 SQL Setup If you get an error when you try to connect to a database such as the error below this means that there is an issue with the configuration of SQL within ChangeBASE or that the SQL Server Service has been stopped Quest Ultimate o ChangeBASE Packages AppiD s Browse with SCCM CSV Import ChangeBASE could not connect to this database A network related or instance specific error occurred while establishing a connection to SQL Server The server was not found or was not accessible Verify that the instance name is correct and that SQL Server is configured to allow remote connections provider SQL Network Interfaces error 26 Error Locating Summary Server Instance Specified Packages Repors Rules Scanned Rules Issues Upgrades Available First of all go into the Service Control Manager and ensure that the SQL Server Service is running 51 3 Basic Configuration Quest ChangeBASE 5 3 User Guide If you are connecting remotely to your SQL database you should also ensure that the SQL Browser service is also running and that the SQL Server is se
2. Custom Action Security Scan s a Deprecated API Analysis 7 Elevated Privileges Detection gt GINA Deprecated Component Hard Coded File References Scan Install Logic Scan IPv6 Networking Scan lt lt IPv6 Strong Host Check Always Create Issue Summary Report as Text File Always Create Issue Summary Report as HTML File Always Ask OK Cancel 2 Selecting the required report group will display all the reports To add all reports in the report group to the Issue Summary click 3 Repeat this process adding as many report groups as are needed for the Issue Summary report 4 Click OK gt 117 6 Assessing Packages and Viewing Results Quest ChangeBASE 5 3 User Guide 6 7 2 Creating Individual Issue Summary Reports 1 Right click a package and select Create Issue Summary Report 7 Packages 7 Zip 4 85 x64 edition oo vt SEBO SOSBOOOSBEY V Access 97 Runtime Adobe Flash Player 9 4 Delete Adobe Flash Player 9 P Save Retrieve Reports S lt E 7 Sas b Alias SketchBook Pro 2 Open Containing Folder BitZip Powered_By_Mir View Log chrome_installer Ee Edit Msi FileZilla_3 3 5 1_win321 View History Google Chrome amp Checkin GSview il Extract Captured MSI s J amp D7_BASIC Re Import Microsoft Product Studi Add To Matching Analys
3. ccccccccseecseeccseecsuecsueessuessueseaeesseessusssaeesaees 57 OFZ INO QA ASC ENO oes i ee eee es 58 4 ChangeBASE User Interface cccccccccceec cece eeeee cee eeeeeeeneaecesesoeseeesneesonseeseenes 60 Al PACKAGES P ANC acscees Seco exteas Secessereuce reste E EE 60 42 Reports Paneke E eee EE 61 ToM Rane oen 61 AAAS E a a a OAM 61 4 41 NOW Froe WZI cial 61 AO OOO SUMMA Vere a aaa a ke eeeeadas 62 AO Reports and REPON GrOUDS szumie ARR 63 AO T OVE OW riria E eee ee eee eee eee eee ere 63 BPO Fads EXIDE aise are cena cate re cen Games a aes Menta Pe pa 64 4 0 2 Online Report Group LOaGing 2253002 ee 65 4 6 3 Offline Report Group Loading ccccsccsccsecneceeceeceececseeseeseeseseeseeseeseeseseeseeseeseeseeas 66 4 6 4 Which Report Groups Should I Add 0 cc ccccccccccccecsecsecececneceeceesecsecseeeseesesseees 66 4 6 5 Troubleshooting ossicles itch dBi aina aaa dec aaien ede tatadee 66 AO 0 1 PIGGINS Talli TO TOA case cos aren ceed a ed aceon eee 66 4 6 5 2 Inability to access Services in the Upgrade Tab ccccccccssseccccsseeeeeeeeseaneseseneeeseanes 66 Af NOUS FOTITO geya ten adentronaden sien EOE a E 67 4 7 1 AppID Maintenance aaa0aaaaaaananonnnnanannnnnnnnnnnnnnnnnnnnnnnnrnrnrnrnrnnnennnnrnnnrnrnenennnnnnnne 68 47 R EET e EEEIEE 8 PAEAN A A E A AEA A NE A E 69 AT As WUE DIC SCICCHONN a A AS 69 4 1 3 Adding AO W APPID riesis e a e EE 70 4 7 1 4 Updating or Deleting an existing App ID cccccccc
4. 214 14 Writing Custom Plugins Quest ChangeBASE 5 3 User Guide 14 Writing Custom Plugins One of the features included in ChangeBASE is the ability to create new Report Groups and new Reports e g Custom QA Checks Automatically checking for and remediating standardization QA checks can save vast amounts of time and cost in the packaging process For more details see the following topics e 14 1 Moving Reports and Re organizing Existing Plugins e 14 2 Adding Report Groups e 14 3 Adding a Report e 14 4 Adding Rules to a Report 14 1 Moving Reports and Re organizing Existing Plugins Before you start creating and updating Plugins there is a simple mechanism to re organize each Plugin within and across Report Groups In order to move a particular Plugin from one Report Group to another 1 Ensure that you have the correct privileges to update reports 2 Right click the Plugin 3 Select Move Report 4 Select the appropriate target Report Group 5 Once the ChangeBASE screen has refreshed the Plugin will have been relocated to the new Report group V Reports Best Practice Manager ail Platforms Local Machine Renistry Setting Scan v3 34 E All Platforms User Update Report T Copy of Windows 7 sia a Scan v4 18 Security Alteration t MSI Installer Integrity F vista SP1 Local M Copy Repor My Custom Report Group E Windows 7 V indo Q Expand Windows 64 bit 17 Matchin
5. 1 Introduction Quest ChangeBASE 5 3 User Guide 1 Introduction ChangeBASE is a leading provider of automated application compatibility analysis remediation and conversion Its scope continues to evolve in addition to automated analysis and remediation it can automatically convert MSI packages into virtual formats and also detect potential Web application compatibility issues by capturing and checking Web data 1 1 ChangeBASE Product Editions ChangeBASE uses a flexible licensing model and the features available in the different editions of the product are as follows Capability Browser Standard ak Pro Pro Plus Ultimate Application Discovery with Asset Manager Ongoing Application Compatibility and Management Windows 7 8 32 and 64 bit Windows Server 2003 2008 inc R2 Windows Server 2012 Office 2007 2010 2013 Windows Updates Application Virtualization Remote Desktop Services In House Packaging Standards Browser Compatibility MSI Packaging with MSI Studio SCCM Integration 11 1 Introduction Quest ChangeBASE 5 3 User Guide 1 2 Key Phases of a Migration Project Identify The first step is to identify both the managed and unmanaged packages across the enterprise Quest Workspace Asset Manager can be used to perform this step Plan Rationalize Once the packages have been identified the best practice is to rationalize packages that have similar functionality and or have multiple versions
6. Note This option only applies to the importing of Legacy Applications Location of the MSI that is created during a legacy application import Note This option only applies to the importing of Legacy Applications 87 5 Importing Packages Quest ChangeBASE 5 3 User Guide NAME PURPOSE Launch Application Where VBScripts are imported this field will automatically be populated with WScript This is the script host for running VBScript on Windows Alternative script hosts such as CScript can be specified if required Manufacturer Name of the manufacturer Note This option only applies to the importing of Legacy Applications i Name of the View to which the imported application should be View added For more information on Views see Advanced Usage in this document AppID The bulk CSV import process supports the use of an AppID column in the CSV file You can specify a semi colon separated list of AppID names in this column Then when the CSV file is imported ChangeBASE will generate the ApplDs automatically if they do not already exist Note ApplDs can be created using letters numbers spaces underscores and hypens The use of any other characters may cause the bulk import to fail An example import preview screen for a WinZip package with the group Compression is shown in step 3 below The CSV used for the import is as follows Y N ProductName ProductVersion MSI OutPut Executable File Name Com
7. n Days Previous n Weeks Previous n Months Previous Save Cancel Select Required Date Start Date 12 02 2013 End Date 12 02 2013 The End Date will be used for Executive Summary and Executive Detail Charts Both dates will be used for the Progress Summary Chart Once you have selected your filter press the Save button to apply the filter The Executive Summary screen will redisplay with the selected filter Note If a filter is applied the filter button changes to yellow 7 2 2 4 Progress Summary This section of the main Dashboard page gives a high level view of the current project status showing the journey that needs to be taken to reach the goal Progress Summary Legend Target 50 Imported Total 41 Imported Legacy 5 Assessed 39 er ov isi a x 9 o a Fixed 5 Virtualized 1 The line chart displays an historical progress view starting from when the project was created until the current day Each line gives the cumulative total value at the set dates displayed Each line is identified in the legend to the right of the chart The top item in the legend is the total number of packages that have been added since the start of the project or since Dashboard was installed The next shows the number of legacy applications imported Assessed shows the number of packages that have had Reports run against them with the total number of reports included in brackets The fo
8. Auto Logon allows you to configure the credentials needed for web applications that use Forms Authentication Before configuring Auto Logon web application URLs should be loaded onto the ChangeBASE Workbench as described above After loading one or more URLs you should be ready to configure Auto Logon 222 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide 15 2 1 Auto Logon Process Overview Drag URL of website to be captured onto ChangeBaAsE to create a web package Configure Auto Logon settings for the website Select the package and choose Import or Re import Enter logon credentials for the website Incorrect credentials entered or when prompted user canceled Website is captured by the ChangeBASE ses Capture failure packager Website is imported into the ChangeBASE database by the packager 15 2 2 Auto Logon Process Explained 1 Create the Web Package The first step in creating a Web package for Auto Logon processing is to drag a URL from a word document or browser onto the ChangeBASE Workbench The URL should point to the base page of the website you wish to capture This will create a new package item in the list identified by the URL 2 Configure Auto Logon Settings Before starting the capture and import process you must configure the Auto Logon settings that determine the pages and controls used for site authentication Further details can be found in 15 2 3 Configuring Auto Logon Settings 223
9. Clear Results https support quest com Down r 7 Auto Logon gt Configure Logon Settings Assessment Results id Adobe Acrobat 9 Pro Repackaging Configuration x oa Adobe Reader 9 1 Quest Communities Summary Virtualize from manifest iv Adobe Photoshop Elements 9 Create New Logon Settings assyst Enterprise 8 0 Expand Packages Reports Rules 54690 l Dragon NaturallySpeaking 10 o Collapse Scanned Rules 52908 _ Elements 9 Organizer Issues 78 m Upgrades Available 26 localhostisqlexpress CB JOHNTEST 15 2 6 Deleting a Group of Settings To remove a group of settings you need to select Configure Logon Settings from the right click menu and then click the Delete button on the bottom right of the settings screen shown in 15 2 4 Selecting Logon Controls 15 3 Web Crawl Settings The web crawling process can be controlled by setting the options described in 12 10 Browser Compatibility Tab Note that the default setting for the Static Web Search URL Count Threshold is 500 To allow you to control the depth of the web crawling process you must add the following XML setting to the WorkBenchSettings xml file lt WebCrawlMaxDepth gt DEPTH lt WebCrawlMaxDepth gt where DEPTH is the number of branches that the web crawler will take from the Base URL of the package For example if this was set to 2 then the import process would only look at the first page and any direct links from t
10. Connection Server localhost sqlexpress Connection PROD bnel View connection properties Progress Ready SS Script Uf Help Login name Windows authentication SQL Server authentication Mapped to certificate Mapped to asymmetric key Map to Credential Mapped Credentials Credential Provider Default database master A Default language lt default gt kd d Click the Search button and select the Active Directory user or group Select this object type Users or Groups From this location Entire Directory Enter the object names to select examples IQDL RD Change BASE Note If the user or group does not appear in the list ensure that the correct object types are being searched for In many instances groups are not enabled by default resulting in an error message that the object you are looking for cannot be found 2 Assign role based permissions to the SQL Databases as follows a Right click on the newly created user and select Properties followed by User Mapping 29 2 Installation Quest ChangeBASE 5 3 User Guide C T tpn Pope von oer enn SB Script 7 Help Users mapped to this login Map Database a master WORKDOMAIN ChangeBASE users WORKDOMAIN ChangeBASE users iv Fd Connection Server WIN SCN5EANOBSV SGLEXPRE Connection sa 3 View connection properties Progress Ready SRO GCC OF 8800
11. 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide 3 Start the Package Import With the Auto Logon settings configured start the capture process by clicking the Import link on the Packages Panel or for packages that have already been imported once right click and choose Re import Enter Logon Credentials When the capture process starts it begins by looking at the configured heartbeat page If it cannot find a match it will then prompt you for logon credentials See 15 4 The Web Application Import Process for further details You may cancel the capture when prompted for credentials In this case the import process is stopped and the package import is marked as failed Website Capturing Once site authentication is complete the capture process will collect pages and resources from the website according to any limits that have been set The data is stored locally in temporary files before the final processing stage If any errors occur or if any failure limits are hit for the capture process the import process is stopped and the package import is marked as failed Refer to 15 8 1 Problems arising from the Loading of URLs and Folders for further details Final Import Once all data has been collected it is then processed and written to the ChangeBASE database ready for assessment against ChangeBASE reports Import Completed Once all data has been written to the database the import is complete Refer to Chapter 6 Ass
12. 3 Basic Configuration Quest ChangeBASE 5 3 User Guide wE Please select a Server and Database ChangeBASE r UPDATE ChangeBASE DATABASE PROPERTIES Faded to create database Connectivity may have bean lost or you may not have sufficient privileges Please contact your database adminestrator wE Please select a Server and Database aaa ChangeBASE UPDATE ChangeBASE DATABASE PROPERTIES Connection To localhost Failed A network elated or instance specific eror occured while establishing a connection to SQL Server The server was not found or was not accessible Verify that the instance name is corect and that SQL Server is configured to allow remote connections provider Named Pipes Provider eror 40 Could not open a connection to SQL Server machine where SQL is installed 9 HSaSl ba gt o aun SA Services Local SQL Server SQLEXPRESS Stop the service Pause the service Restart the service Description Provides storage processing and controlled access of data and rapid transaction processing A Name Z Secure Socket Tunneling Protocol Service ied Security Accounts Manager o Security Center ed Server T Shell Hardware Detection co Smart Card c Smart Card Removal Policy CL SMS Agent Host CL SNMP Trap e Software Protection SPP Notification Service TE SQL Active Directory Helper Service 4 SQL Server SQLEXPRESS TE SQL Server Agent SQLEXPRESS TE SQL Se
13. Database File server Hypervisor CSC Server Dashboard lt n ss f f mE k i a ee possepenenvens OT CEC EERE sreesssene Wii PPE ET ETE Working directory Dashboard can be PC running CSC accessed by any Client Agent machine via a web browser RDP to ChangeBASE If you are using the Browser Compatibility module on its own and not as part of the Ultimate Edition refer to 1 1 ChangeBASE Product Editions you can view the setup simply as follows Web data capture PC running Client Side Capture Corporate proxy Internet 4 it CSC Proxy n f fay easaeaeaeaan EEREEENANRRRET orreennneenint ee eg meme EE ee a CSC Server NS _ ne ria UT a diduadaaa ji i APPEARED ii aereeoneneen E E COL aaanaanippinni i PPRETANNERRERE 231 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide Note As an alternative CSC SQL and ChangeBASE can all be installed on the same machine In this event IIS will be installed for you 15 6 2 System Requirements General e The Client Side Capture installation source must have been provided by Quest Support e ChangeBASE must have been installed as described in 2 Installation e ChangeBASE must have been configured as described in 3 Basic Configuration e The SQL Server hosting the ChangeBASE database should also be used to host the Client Side Capture databas
14. File Monitorinstall Folder Host Name skhyp Host Usemame HostPassword Snapshot Name Timeout Raise Prionty Setting Value Quest ChangeBASE 5 3 User Guide DESCRIPTION This is the folder on the Virtual Machine where the file monitor will be installed Ensure that the user specified has permissions to this folder If this field is left empty it will use the default path of C Program Files File Monitor The IP address or Hostname of the ESXi server The name used to log into the ESXi machine The password for the HostUsername The name of the Virtual Machine Snapshot that the repackaging process is to use This is case sensitive This is the time out value for the Virtual Machine The time is set in minutes A value of 15 the default if not set for example will mean that ChangeBASE will terminate the Virtual Machine after 15 minutes This field should be left blank It should only be used under the instruction of the ChangeBASE support team for debugging purposes This value should be set to 1 if ChangeBASE has issues reverting to the Snapshot Y W Enabled workdomain user The configuration settings are as follows 96 5 Importing Packages SETTING Type mandatory Name mandatory Enabled mandatory Name mandatory Username mandatory Password mandatory SystemFolderPath optional FileMonitorinstallFolder optional HostName mandatory Host Username m
15. General issue Summary Core App Lists Platforms Upgrade Services Security Report Costs Duplicates Browser Compatibility Add in Repackaging Options Status Dashboard version 1 0 1 13 curently installed and is enabled Uninstall Disable Registered with IIS server EU9068 Dashboard EU9068 Dashboard Executive Summary Platform 1 Platform 2 Platform 3 Platform 4 Title Windows 7 x64 with App V ToolTip Windows 7 x64 with App V E Hide this chart Report groups to include Best Practice Manager Browser Common Reports Firefox Presentation Compatibility Internet Explorer 10 Presentation Compatibility Internet Explorer 8 Presentation Compatibility Internet Explorer 9 Presentation Compatibility internet Explorer Data Analysis Tool Selection MSI Installer integrity Office 2007 Application Compatibility Office 2010 Views Virtualisation App V Virtualisation Best Practice Virtualisation Citrix XenApp hosted and MS RDS OK Apply Cancel 124 7 Dashboard Quest ChangeBASE 5 3 User Guide As an example your target environment could be Windows 7 64 bit with App V and as an alternative you could have Windows 7 64 bit without App V for applications that you are unable to sequence in App V To achieve this you could o Inthe Platfo
16. Note When a Setup exe contains an MSI this is known as a Bootstrap EXE ChangeBASE will detect bootstrap EXEs as explained in 5 3 Repackaging Overview In the above screenshot iTunesSetup72 exe is shown as a bootstrap EXE 5 6 Repackaging Troubleshooting When a legacy package fails to import check the log by right clicking on the package and selecting View Log 5 6 1 ChangeBASE is unable to revert to the Virtual Machine Snapshot Symptom When you click Import the Virtual Machine is in the paused state The Virtual Machine does not resume Action 1 Open the Options window 2 Select the Repackaging Options Tab 3 Double click the required Virtual Machine to open the Update Machine Config dialog Core App Lists Platforms Upgrade Services Security Report Costs Duplicates Browser Compatibility Add in Repackaging Options Wirtu Name wl Update Machine Config Type VMwareWorkstation Name VM J Enabled sm meena anemia Setting Type VMX CAUsers BNel Documents Vitual Machines ConvertXP ConvertXP vmx Browse Usemame Administrator eeeeeeee Password SystemFolderPath Browse FileMonitorinstallFolder SnapshotName Timeout RaisePriority Revert To SnapshotLaunchGUI OK Cancel 4 Set RevertToSnapshotLaunchGuUI to 1 5 Click OK 5 6 2 The Capture Process terminates before the Installation has completed Symptoms After clicking Import the Virtual Machi
17. Virtualisation Miware ThinApp a Windows 64 bit Reports IV Windows 7 Cx Refresh Ri _ Windows Server 2006 _ Windows Update 2013 Clear Rest Assessme Summan oe 2 Top 5lssues C ROI E Progress Summary Target Date 16 Jan 2013 Target Packages bo Reports Rules Scanned F Issues ar Apply Cancel Upgrades then you should check the lt assembly gt tags in the web config file typically found in C Program Files x86 Quest Software ChangeBASE Dashboard For example if you see a number of such tags e g lt assemblies gt lt add assembly System Data Ling Version 4 0 0 0 Culture neutral PublicKeyToken B77A5C561934E089 gt lt add assembly System Design Version 4 0 0 0 Culture neutral PublicKeyToken B03F5F7F11D50A3A gt 56 3 Basic Configuration Quest ChangeBASE 5 3 User Guide lt add assembly System Windows Forms Version 4 0 0 0 Culture neutral PublicKeyToken B77A5C561934E089 gt lt add assembly ADODB Version 7 0 3300 0 Culture neutral PublicKeyToken BO3F5F7F11D50A3A gt lt add assembly mscorlib Version 4 0 0 0 Culture neutral PublickKeyToken B77A5C561934E089 gt lt assemblies gt then remove all tags after the first one so that it becomes lt assemblies gt lt add assembly System Data Ling Version 4 0 0 0 Culture neutral PublicKeyToken B77A5C561934E089 gt lt j assemb 1es gt Note You should also ensu
18. vi Reboot the guest to make sure the settings are applied b Fora Windows 8 Virtual Machine you must make the following changes i Type secpol msc on the start screen and press Enter li Navigate to Security Settings Local Policies Security Options iii Open the policy User Account Control Run all administrators in Admin Approval Mode Set it to Disabled iv Reboot the guest to ensure that the settings are applied If you are using VMware Workstation and the networking is set to either NAT or Host only then in the Virtual Network Editor ensure that the Minimum DHCP Lease Time is set to 8 hours and 30 minutes and that the Maximum Lease Time is set to 9 hours Ensure that the firewall on the host is turned off Ensure that you can ping the host from the Virtual Machine Ensure that you can ping the guest from the machine running the ChangeBASE client 157 11 Virtualizing Packages Quest ChangeBASE 5 3 User Guide 21 Continue to the relevant section below to complete the Virtual Machine setup 11 2 2 Virtual Machine Setup Symantec Workspace Virtualization AS Install Symantec Workspace Virtualization Admin Client 6 1 SP6 SP7 Install Symantec Wise Composer Reboot the machine if prompted Ensure there are no unnecessary packages running on the Virtual Machine that may be updating files for example Windows Desktop Search Leave the machine idle for around 10 minutes This will create a better session as mo
19. 143 Quest ChangeBASE 5 3 User Guide Total Calculations 139 141 142 Transform MST 12 108 152 174 180 199 200 201 Transforms 152 174 195 200 201 212 Multiple 174 Troubleshooting 41 49 Client Side Capture 242 Dashboard 55 Fixing 153 Importing Legacy Packages 105 Plugins 66 Repackaging 105 Reports 122 SQL related 49 Virtualization 170 Web Capture 241 U UAC 91 143 144 148 157 171 183 184 205 File Headers 147 Unlicensed Number of Packages 41 Upgrade Tab 41 65 67 99 177 178 180 Upgrading ChangeBASE 36 URL Count Threshold 185 URLs Loading for Browser Compatibility 222 Use Windows Security 32 42 43 User Account Control See UAC See UAC User Interface 60 V VBScript 90 VHD Files 204 View Create 190 History 153 202 View Dependencies 195 View Log 198 Viewing Results 63 110 114 115 117 176 Views 203 Organize 192 Virtual Hardware 22 Virtual Machine Setup 186 Virtual Machines 18 21 22 91 155 169 Deployment 24 Setup 91 95 156 App V 158 App V 156 General 156 Symantec Workspace Virtualization 158 Symantec Workspace Virtualization 156 ThinAPP 160 XenAPP 156 160 Virtualization 110 111 138 141 142 155 160 171 179 181 248 Index Troubleshooting 170 Virtualization Compatibility Matrix 155 Virtualize from Manifest 169 193 Virtualize Packages 155 How to 166 Virtualize Tab Configuration 160 187 Vir
20. Click the Register button Test the connection by opening up the Dashboard via the Assessment Results menu 54 3 Basic Configuration Quest ChangeBASE 5 3 User Guide a g Refresh Results Clear Results Pome s Seta E EE SUM Mary Profile Profile Post Fixing Packages By RAG o Report Group By RAG Report By RAG Package Issue Summary Csy Export Dashboard can now be launched from any remote machine by typing the URL to the Dashboard server P chapin Dabs Eeecutet Serres ter OF Werbe Pinne Erpe hong tips eee hore Deed eee ee oe K f E re ja Breer ae let Changak le Dachboard Baecutece havesary tor S mm 7 Paer beye Toots Note You can click Unregister to break the link between the web pages and database This does not delete any Dashboard data from the database it simply makes that database unavailable to the Dashboard web pages You simply click the Register button to re establish the link 3 4 2 Dashboard related Troubleshooting 3 4 2 1 Insufficient privileges If you install Dashboard and see an error message to the effect that the account is not able to create tables then ensure that the account used to connect to ChangeBASE has sufficient privileges as shown below 59 3 Basic Configuration Quest ChangeBASE 5 3 User Guide are J Script v I Help gt General gt Server Roles gt User Mapping Users
21. Elevated Privileges Detection v1 04 GINA Deprecated Component v3 18 Hard Coded File References Scan v3 42 Refresh Results Clear Results Install Logic Scan v1 14 IP 6 Networking Scan v3 14 Packages Repors Rules IPv6 Strong Host Check v3 14 Legacy Control Panel Applet Scan v3 18 Legacy Help File Scan v3 27 Scanned Rules 1245 Issues 9 Upgrades Available 725 Microsoft Message Queue Analysis v1 06 SEE SE SSBSBSBSBSBBSBY BBS SS SSSS8Seeeae Named Pipe Hardening Analysis v3 14 For further details refer to 6 5 Viewing Results ChangeBASE 4 6 Reports and Report Groups 4 6 1 Overview Report Groups contain reports also known as Plugins which provide automated assessment for a specific technology For example the Windows 7 Report Group contains reports that assess packages for Windows 7 compatibility A report is a group of codified rules that check for a particular issue within a package or packages ChangeBASE contains over 250 000 rule sets which are grouped into reports of various categories A report may contain several rule sets the number varies according to the logic that goes into making up a particular report 63 4 ChangeBASE User Interface Quest ChangeBASE 5 3 User Guide 4 6 1 1 Example Report Group Windows 7 Report Name Active Directory GPO Settings Analysis ml ChangeBASE Ultimate 75 Quest View ChangeBASE Al Packages Packages AppiD s Portfolio Summa
22. Local Disk C c DATAPARTI D File Edit View Tools Help Organize v Open 2 PROD jgreen EU9068 500106 TRAFFIC CSCWEB 7 PROD jgreen EU9068 538301 TRAFFIC CSCWEB Date modified 03 04 2013 13 45 03 04 2013 15 00 CSCWEB File 342 KB CSCWEB File 11 KB 3 PROD JOHN GREEN WEB TEST TRAFFIC CSCWEB 03 04 2013 13 46 CSCWEB File 94 KB PROD JOHN GREEN WEB TEST TRAFFIC Date modified 03 04 2013 13 46 Date created 03 04 2013 13 46 a CSCWEB File Size 93 7 KB 3 You can now either e Load the required files into ChangeBASE by dragging them directly onto ChangeBASE Workbench Then select them and click Import on the Packages Panel Or e Import them directly into ChangeBASE by running ChangeBASE CSC Manager and then proceeding as follows a Click Uploaded Content gt Process uploaded files to bring up a dialog that allows you to select the database and files to import into ChangeBASE E Uploaded Files e Available Files denotes already processed hover the mouse to see the database name E 03 04 2013 13 45 41 C Program Files amp 86 ChangeBASE AOKCSC AOKCSCWS Transient Storage PROD jgreen EU9068 500106 TRAFFIC CSCWEB 03 04 2013 15 00 00 C Program Files amp 86 ChangeBASE AOKCSC AOKCSCW S Transient Storage PROD jgreen EU9068 538301 TRAFFIC CSCWEB 03 04 2013 13 46 54 C Program Files 86 ChangeBASE AOKCSC AOKCSCWS Transient Storage PROD JOHN GREEN WEB TE
23. Overview WinHelp E WRITING WIWNHELF FILES You can refer to this sample help projec file creation however please note that ilustrate the creation of WinHelp HLF was not designed as a comprehensive t At the time it was designed it was quite novel to have hyperlinks that when clicked on took you to another page Many of its other features have also been superseded by the functionality offered in web pages As a result the help engine has been withdrawn from Windows 7 Windows 8 Windows Server 2008 and Windows Server 2012 and an error message is shown whenever a program or document attempts to use it 8 2 3 Remediation Steps A fix is offered that installs the old WinHIp32 engine into the ProgramFiles folder and associates HLP files with it This will only work if the program tries to open the help file via its extension You should run this test on all your packages to see how widespread the issue is If there are only a few packages that rely on HLP files and those files are not crucial to the use of the software then you could consider not fixing the problem If there are many packages using HLP files and they are important then the best thing to do would be to go to this page http support microsoft com kb 917607 choose the 145 8 The Top Five Issues Explained Quest ChangeBASE 5 3 User Guide appropriate engine for your Platform and arrange for it to be merged into the Operating System by the appropriate team w
24. Please select a Server and Database ChangeBASE CREATE DATABASE Finish 7 Click Finish kil Please Selec a Server and Database ChangeBASE CREATE DATABASE The database has been successfully created Click finish to open it in ChangeBASE 8 The ChangeBASE New Project Wizard is displayed 47 3 Basic Configuration Quest ChangeBASE 5 3 User Guide 3 2 1 Renaming a Database You can rename a database by right clicking on the database name at the bottom of the screen Create Database Connect To Existing Database Rename Disconnect Properties Important After you rename the database you need to do the following 1 Navigate to the Dashboard Tab under Options 2 Click Unregister followed by Register This process associates Dashboard with the renamed database so that assessment results can be successfully viewed If these actions are not followed an error will occur when starting Dashboard 3 2 2 Multiple Databases ChangeBASE supports the use of multiple databases These may be hosted on the same SQL server or different SQL servers It may be advantageous to use multiple databases where you want to segment your packages logically For example if you are testing both desktop packages and web applications it may be helpful to create one database for the desktop packages and one for the web applications To create additional databases right click on any of the da
25. Simple percentage Remediation Simple hours effort 8 Number of Applications Simple percentage ChangeBASE Simple Hourly Cost Manual Days ChangeBASE Days Manual Days Days Saved 100 CALCULATION Number of Applications Medium percentage Remediation Medium hours effort Average Hourly Rate Number of Applications Medium percentage Remediation Medium hours effort 8 Number of Applications Medium percentage ChangeBASE Medium Hourly Cost Manual Days ChangeBASE Days Manual Days Days Saved 100 CALCULATION Number of Applications Complex percentage Remediation Complex hours effort Average Hourly Rate Number of Applications Complex percentage Remediation Complex hours effort 8 Number of Applications Complex percentage ChangeBASE Complex Hourly Cost Manual Days ChangeBASE Days Manual Days Days Saved 100 140 7 Dashboard Quest ChangeBASE 5 3 User Guide Total Calculations FIELD CALCULATION Manual Cost Sum of Manual Costs Manual Days Sum of Manual Days ChangeBASE Cost ChangeBASE Cost Total Applications ChangeBASE Days Sum of ChangeBASE Days Cost Saved Manual Cost ChangeBASE Cost Days Saved Sum of Days Saved Percent Saved Manual Cost ChangeBASE Cost 100 7 2 6 3 Virtualization Simple Calculations FIELD CALCULATION Manual Cost Number of Applications Simple percentage Virtualization Simple hours effort Average Hourly
26. Then start ChangeBASE 40 3 Basic Configuration Quest ChangeBASE 5 3 User Guide 3 1 4 Troubleshooting 3 1 4 1 License Expiry If your license expires you will see a message to this effect and will no longer be able to load Plugins or packages This is most likely to happen after a proof of concept or evaluation where the license is only active for a few days You will need to contact your Quest account manager to request that your license is extended If your installation of ChangeBASE is in an offline environment use the ChangeBASE Activation Page to re activate the license The ChangeBASE Activation Page link can be found in the following location Windows XP USERPROFILE Local Settings Application Data ChangeBASE UserData Windows Vista 7 localappdata ChangeBASE UserData and 8 Windows Server localappdata ChangeBASE UserData 2003 2008 and 2012 The license file name is AOK cbl which is also located in the above named folder If you are working online simply go into the Upgrade Tab in order to refresh your license file The license file extension will then be processed automatically 3 1 4 2 Unlicensed Number of Packages If you attempt to load more packages than the number for which you have been licensed the message of the kind shown in the example below will be displayed License Error a The licence that you are using allows a macmum of gt packages to be imported impo
27. for its use refer to 13 1 1 Save Retrieve Reports 13 2 3 Select App IDs Select App IDs allows you to organize application IDs as in 4 7 1 AppID Maintenance If you have selected a single package the option opens to the dialog shown in 4 7 1 1 Single Selection If you have selected multiple packages the option opens to the dialog shown in 4 7 1 2 Multiple Selection 13 2 4 Open Containing Folder Open Containing Folder opens the folder in which the selected package resides so that you can review the package and any associated fix Transforms 13 2 5 View Dependencies View Dependencies This option is only available when a single item is highlighted When the Dependency Viewer is opened it populates the Package Dependencies tree the uppermost tree with a list of files on which the selected package has one or more dependencies in other words those files that contain functions called by the main package The main package is displayed at the top of the tree You can drill down into the tree into ever lower levels of dependency 195 13 Advanced Usage Quest ChangeBASE 5 3 User Guide Ts Dependency Viewer tolak J Exclude Operating System Files OS Snapshot Defaut Windows 7 Snapshot Package Dependencies El 3 Acrobat fl w ACE DLL v1 2 0 1 rn w ACELITE DLL v1 2 0 1 ca w ACROBAT EXE v5 0 5 452 ca w ACRODIST EAE v5 0 0 0 Gl ACRODISTDLL DLL v5 0 5 452 w lal NNOTES DLL E y ACROIEHELPER OCX v1 0 0 1 Other Packag
28. the folder you specify must already exist 162 11 Virtualizing Packages Quest ChangeBASE 5 3 User Guide SETTING DESCRIPTION Manual Configuration Allows you to make any manual application modifications after package installation is complete but before virtualization capture completes This allows you to make any configuration changes to the software that will be stored in the virtual package 11 2 7 Advanced Settings App V 4 6 SP1 atid Advanced settings for plugin AppVWin 32 Overide Server Address E Protocol E Hostname Poort E Path Operating Systems V Overide Target Operating Systems Windows 7 32 bit Windows XP Professional 64 bit Windows 2003 Tenninal Server 32 bit Windows 2003 Terminal Server 64 bit Windows Vista 32 bit Windows Vista 64 bit Windows 2008 Terminal Server 32 bit Windows 2008 Tenninal Server 64 bit Windows 7 64 bit Windows 2008 R2 Tenninal Server 64 bit Output options Enforce Securty Descriptors Use default Compress Package Use defaut Generate MSI Packages Use default Other Settings Mount Point B Detect MSI installer path property for silent installs Feature Block 1 SETTING DESCRIPTION Override Server Address The protocol hostname and port can all be overridden Path The path field is important where the App V 4 6 infrastructure will be used for deployment Unchecked No subfolder will be added to the path of the App V package e g RISP SERVER 123 orca sf
29. 1 0 bi o Reader X 10 1 0 10 1 0 Incorporated AdbeRdr1014_en_US AcroRead msi a F _ChangeBASE msi Adobe_Photoshop_Eleme sdobe photshon Elements Photoshop Elements 2 0 2 0 Adobe Systems Inc otoshop_Elements_ 2 0 2 0 P1 1_ GLOBAL msi A sdanceainstaers Installer 6 4 ea foaptyon anton ChangeBASE msi advinstiadvinst msi F _ChangeBASE App_Repository AgilentChemStation 10 01 Agilent AgilentChemStation AgilentChemStation_00141292 msi mooo ON ENG Softphone nooo ft 0 4 GBL R1 F _ChangeBASE msiAppleMobileDeviceSupport AppleMobileDeviceSupport msi F _ChangeBASE Aspect Architect msi XP_Architect_7 1_P1 0_DEMO The icons have the following meanings ICON DESCRIPTION y No compatibility issues were identified FN An Amber issue indicates that a compatibility issue has been found which can be fixed by applying a change to the package and that a change to the program code within the application files is not required In most cases the solution set provides automated fixing for Amber issues which are indicated by the icon with a black tick within an amber circle Where automated fixing is not available a manual fix can be applied to the Windows Installer routine MSI or MST by an application packager and this is indicated by the icon with an exclamation mark within an amber triangle v A Red issue is generally one that pertains to how the code or actual program works In this case the solution set will flag Re
30. 232 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide 15 6 4 CSC Configuration 15 6 4 1 CSC Manager Manage Default Parameters 1 Run the following program as Administrator ChangeBASE CSC Manager The following dialog is displayed E Instance Name Please enter the SQL Server database instance name upon which you wish to store the ChangeBASE CSC Manager database Please note that if this is a remote database you will need to ensure the SQL Server Browser service is enabled and running that the TCP IP protocol is enabled and that the Windows Firewall ts configured to accept connections Enter a database name CSCManager W Use Windows Security to connect the CSC Manager 2 CSC needs to create a database so in the blank field specify the SQL Server instance name using the syntax shown in 3 2 Database Setup e g localhost sglexpress and below it enter the required database name 3 Choose the SQL Security mode by checking or unchecking Use Windows Security You will need to enter the SQL credentials if you uncheck it Refer to 2 2 SQL Setup 4 Click OK 5 In CSC Manager select Tools gt Manage Default Parameters 6 Check Auto Populate This Field to add the Database Template Location For example 233 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide 10 11 E Manage Default Parameters v Auto Populate This Field Database Template Location Output File Target L
31. Adobe Reader 9 1 Adobe Apps PDF Readers Adobe Photoshop Elements 9 Adobe Apps OS assyst Enterprise 8 0 Summary Dragon NaturallySpeaking 10 Packages Elements 9 Organizer Repors FileZilla YVin32 Rules Scanned Rules Issues i FrontRange Solutions Goldmine 5 5 SSeae HotDocs 2008 Professional Edition HotDocs 2008 Professional Edition Upgrades Available Hyperion Smart View for Office 3 Now you can organize your packages into categories grouping them together for whatever purpose you need 4 Right click again on the packages row and select Organize Views described in 13 1 4 Organize Views 191 13 Advanced Usage Quest ChangeBASE 5 3 User Guide 13 1 4 Organize Views Save Retneve Reports Package Selector Create View Virtualize from manifest 1 From the Organize Views window select the required View in the left hand panel r al Organise Views o amp ss Views Packages p Acrobat Adobe Acrobat 9 Pro Adobe Reader 9 1 MATPLAN B2BRAIN v 2 0 0 1 Adobe Packages Adobe Photoshop Elements 9 assyst Enterprise 3 0 Microsoft_VC80_ATL_x86 i SCCM ChangeBASE Microsoft_VC80_CRT_x86 Check Point VPN 1 SecuRemote SecureClient NGX R60 HFA2 Microsoft_VC80_MFC_x86 Cisco Systems VPN Client 4 3 01 0300 Microsoft_VC80_MFCLOC_x Dragon NaturallySpeaking 10 Microsoft_VC90_ATL_x86 ____ _ Elements 9 Organizer Microsoft_VC90_ATL_x86_x
32. App V Home ee Windows 64 bit Sy E X cut Virtualize Windows 7 H Copy path Copy Paste n Applications ae ENR Cl Refresh Results Clipboard Clear Results s j O y ea m gt Computer gt Local Disk C Assessment Results Summary sjt Computer z z j5 magicrar msi j5 QuickTime msi 5 Samsung PC Studio i5 SF_AppV_Sequenci i5 Trinket msi Packages a i Local Disk C Reports d ChangeBASE V Rules Ji inetpub Scanned Rules J Packages Issues P PerfLogs Upgrades Available Program Files 5 2 1 1 Dragging and Dropping Files onto ChangeBASE 1 Ensure that the files types to be imported are checked in the General Tab in the Options window 2 Drag and drop the file s onto the ChangeBASE Workbench 3 Once the file s appears in the Workbench then a If an application can be imported directly click on Import in the Packages Panel to load the associated package s into the database Or b If an application is to be repackaged proceed as in 5 5 The Repackaging Process 72 5 Importing Packages Quest ChangeBASE 5 3 User Guide 5 2 1 2 Dragging and Dropping Folders onto ChangeBASE 1 In order to ensure that all files types in the folder are imported uncheck all the file types in the General Tab in the Options window fiai Options xi General issue Summary Core App Lists Platforms Upgrade Services Security Report Costs Duplicates Browser Comp
33. ChangeBASE 5 3 User Guide There is a recommended process for building this list of packages and then importing them into ChangeBASE 1 2 Create a Core Application Reporting Group Refer to 12 3 Core App Lists Tab Load an Operating System image into ChangeBASE Refer to 13 3 Importing Operating System Images Right click on the Operating System and add it to the Core Application Report Group LE Lt ee ViewMaiimsi Add To Core App List gt IF Vital Busines i Add To Matching Analysis W Vital Busines Ez Create Issue Summary Report Extract Cabs From Msi Override All Issues Genes Ms eect ae Core Applications I VoltaqgeEncr The Operating System will now appear in the Core Applications Report group and needs to be set as the OS This can be done by right clicking on the Report and selecting the OS Snapshot option I J F Core App List Core Applications m CutePDF Professional 3 6 msi 74 02 vin F Dero Update Report F Engneering Pack 05 Snapshot PFI m oo Add the first Core Application to the Core Application Group Checkin Re Import Add To Core App List Core Applications Add To Matching Analysis Create Issue Summary Report Extract Cabs From Msi Override All Issues The newly added Core Application will now be listed as a report in the Core Application Group To check if any conflict exists between the applications and
34. Create Table permissions must be assigned to the tempDB system database Procedures and examples are given in 2 2 1 Assigning Permissions using SQL Server Management Studio Note Control of the individual functions within ChangeBASE is managed through the Security Tab in the ChangeBASE options and not by altering the SQL permissions Important The user who is performing the initial setup of the tables within the ChangeBASE database and upgrading them needs to be assigned the following additional permissions or alternatively they can be a Database Owner dbo Database role db_ddladmin The following database level permissions must be granted ALTER ANY ASSEMBLY ALTER ANY ASYMMETRIC KEY ALTER ANY CERTIFICATE ALTER ANY CONTRACT ALTER ANY DATABASE DDL TRIGGER ALTER ANY DATABASE EVENT NOTIFICATION ALTER ANY DATASPACE ALTER ANY FULLTEXT CATALOG ALTER ANY MESSAGE TYPE ALTER ANY REMOTE SERVICE BINDING ALTER ANY ROUTE ALTER ANY SCHEMA ALTER ANY SERVICE ALTER ANY SYMMETRIC KEY CHECKPOINT CREATE AGGREGATE CREATE DEFAULT CREATE FUNCTION CREATE PROCEDURE CREATE QUEUE CREATE RULE CREATE SYNONYM CREATE TABLE CREATE TYPE CREATE VIEW CREATE XML SCHEMA COLLECTION REFERENCES 2 2 1 Assigning Permissions using SQL Server Management Studio Unless a local Dashboard instance is being accessed on a Windows XP machine in accordance with 2 1 1 Local Database Setup in which case SQL Authentication must be used permissions ca
35. Hide 124 Plugins 64 66 114 150 154 168 188 211 217 219 See also Reports Custom 215 Matching Analysis 202 Troubleshooting 66 Portfolio Summary 62 Process Uploaded Files Option Greyed Out 243 Product Editions 11 Program Compatibility Assistant See PCA Q QVMTools 22 93 156 157 Quest ChangeBASE 5 3 User Guide R RAG 12 26 110 112 116 128 132 133 193 214 218 220 Real World Package Assess 150 Recommended Configuration 24 Multi User Installations 25 Red Amber Green See RAG See RAG Re Import 202 Remediation 140 144 145 146 148 149 Remote Database 20 21 26 Setup 19 Remote Desktop Services Deployment 24 Rename Database 48 Repackaging See also Legacy Conversion Configuration 91 101 104 199 Filters 91 99 Options 94 105 186 Overview 90 Process 101 Troubleshooting 105 REPORT Command 213 Report Group by RAG 120 Report Groups 63 66 110 180 215 Adding 215 216 Load 65 Which Ones 66 Reports 61 62 63 67 111 115 117 122 131 176 180 186 195 215 218 Adding 215 216 Adding Rules 218 by RAG 121 214 Panel 61 241 Retrieve 189 Running from the Command Line 122 Save 189 Troubleshooting 122 Requirements Remote Database Setup 21 Retrieve Reports 189 ROI 123 125 127 128 137 138 181 Calculator 125 ROI Calculation 123 137 Roll Up Fixes 152 174 S Save Reports 189 SCCM 11 60 72 75 76 77 78 79 81 82 83 84
36. Microsoft System CLR Types for SQL Server 2008 x86 10 0 x Microsoft SQL Server 2008 Shared Management Objects x86 10 0 x Note Although you will normally be connecting to SQL Server on a remote machine the above SQL server components must be installed on the client machine Note that 10 5 x versions will not work Also we specifically require the 32 bit installations even if you are running 64 bit SQL These are available for download from Microsoft from http www microsoft com en us download details aspx id 27 596 Internet connectivity recommended Virtual machines are not supported for ChangeBASE clients Dashboard Operating System Windows XP SP3 Windows 7 Windows 8 Windows Server 2003 inc R2 SP2 Windows Server 2008 inc R2 Windows Server 2012 Note For Windows XP systems you will need to have an i386 folder available or the original media as the Dashboard software will attempt to install IIS Minimum Hardware 2 5GHz dual core processor or greater 4GB RAM 50GB hard disk space 1024 x 768 display Software Requirements e IS Version 6 or later Note The installer will attempt to install and configure IIS on the machine running the Dashboard web pages See note above for XP users Microsoft NET 4 0 framework on the machine running the Dashboard web pages In order to access all Dashboard functionality a PDF reader will need to be installed on any machines tha
37. Note This option is greyed out unless Generate Transforms is unchecked in 12 1 2 Transforms PE File Extension Additions This option is used to set up additional file types e g bpl files so that their header information and APIs can be imported in This data is also used by the Best Practice WRP and Conflict Analysis Plugins to determine the issue and resulting fix 12 1 4 File Extensions automatically added during folder scans When dragging folders onto ChangeBASE or using the Browse button only the checked file extensions will be imported into ChangeBASE 12 1 5 Database Options Server Timeout mins is set to 30 minutes by default However if you have more than 5 000 packages or if you are running ChangeBASE on a system that does not meet the minimum hardware specifications it is recommended to set the option to the maximum time 90 minutes to prevent any timeout issues when running reports against large numbers of packages Connection Test Timeout secs is set to 20 seconds by default but it is recommended to set the option to the maximum time 30 seconds to give ChangeBASE sufficient chance to connect to the SQL Server database Maximum No Simultaneous Imports By default this option is set to 5 which is the maximum value and is aimed at a workstation with 4GB of RAM and a 2 2 GHz processor If you are seeing performance issues on your workstation you should consider lowering this figure SQL Server loads packages and
38. On Local Disk The Upgrade Service URL UNC is defined within the Services Tab This should not be altered unless you are specifically instructed to do so by a member of the Quest team 177 12 ChangeBASE Options Quest ChangeBASE 5 3 User Guide A proxy server can be configured in the lower section of the Services Tab Enter the details as they are configured in your browser in order to allow ChangeBASE access to the internet through the company s proxy server Q To improve import performance in a multi user environment check the option Store Working Data on Local Disk This will cache the packages in the local user profile while processing the import of the application before the files are transferred to the Working Directory 12 7 Security Tab The administrator role is associated with all the rights granted by the ChangeBASE license and this is the role that everyone uses unless security has been specifically set up in the Security Tab The minimum required to set up this security is to specify an administrator password Once you have done this then unless you go to the Security Tab and enter the administrator password you will only have Standard User rights By default these rights do not allow you to do anything you have to manually add the required functions to the Standard User role shown in the Role drop down in the top left hand corner of the screen el Options Era General Issue Summary Core App Lis
39. Package Tree View 204 EXPORT Command 213 Extract CABs from MSI 203 F File Extensions Automatically Added 175 Firefox 14 Fixing Packages 152 Troubleshooting 153 Fix it 144 146 Flexible licensing model 11 Flowchart showing Key Phases 13 Forms Authentication 222 226 229 242 G Gold Images 204 GUIApp ini 158 159 211 H Hard coded File References 143 146 Help Files 144 History View 153 202 HKEY CURRENT USER 144 HTTP Authentication 229 242 Hyper V 22 91 94 96 97 156 157 162 Hypervisor Selection 161 Hypervisors 18 21 22 IE Enhanced Security Configuration Setting 18 IIS 19 20 21 32 54 58 74 230 232 IMPORT Command 212 Import Warnings 72 89 Important Files and Folders 211 Importing Legacy Packages 90 91 101 Configuration 91 Overview 90 Troubleshooting 105 Methods 72 Operating System Images 204 Packages 71 Directly 71 Overview 71 245 Index SCCM packages programs into ChangeBASE 85 Web Application 228 Installation 17 Installing ChangeBASE 33 Internet Browsers 16 Internet Explorer 1 14 171 222 236 Internet Information Services See IIS Introduction 11 Issue Summary Reports 117 118 Create 203 K Key Phases 12 Flowchart 13 L Lease Time Maximum 157 Minimum 157 Legacy Control Panel Applets 143 148 Legacy Conversion 22 Legacy Help Files 143 144 Legacy Installers 22 62 186 Legacy Package Capture 73 74 179 L
40. Plugins more efficiently using multi threaded processing SQL Server performs more efficiently using the multithreading option available Q with Maximum number of simultaneous imports set between 3 and 5 as opposed to 1 If you would like to increase the number of simultaneous imports to be more than 5 you can set the lt NumSimultaneousThreads gt setting in the WorkBenchSettings xml file which is found in C Users UserName AppData Local ChangeBASE UserData 175 12 ChangeBASE Options Quest ChangeBASE 5 3 User Guide Remote DB Server Install Folder This option is used to redirect the database to core package files such as the SQLCompression dll which is necessary for queries to be compressed as efficiently as possible between the client and server machines 12 2 Issue Summary Tab This is covered in 6 7 Viewing Results Issue Summary 12 3 Core App Lists Tab The Core App Lists Tab is used to create a group to which packages can be added Typically it would be necessary to have a group of core packages against which to check other packages or groups of packages Enter the name of the group that you would like to create and then click Add The group name will then appear in the list box below Once you have created the group you can add packages to that group by right clicking them and selecting Add to Core App List Once you have added all the core packages the group will appear under the Reports section Select the Core A
41. Prepare the computer for creating a virtual package Description Resolution El Issues that may corrupt the package or add extraneous data 3 Package Name A Windows Defender is active Stop this before continuing Other applications are running Stop these before continuing Package previously created or updated on this computer Revert to clean state Learn more about preparing your computer lt Previous Next gt A When ChangeBASE controls the App V 5 0 sequencer you will always see the warning Other applications are running because the ChangeBASE controller application is detected by the Sequencer However any other warnings such as Windows Defender is active should be addressed by updating your Virtual Machine to resolve the issue Q Why can I not see the Virtualize Tab in the Options A Make sure you have a valid license for the ChangeBASE virtualization functionality Q Why does nothing happen when click the Virtualize button 170 11 Virtualizing Packages Quest ChangeBASE 5 3 User Guide A Ensure that the Microsoft NET Framework 4 Client Profile v4 0 30319 or later is installed on the Virtual Machine Q How do turn off UAC A Click Start and in the Search programs and files box type uac Click Change User Account Control Settings and the following dialog appears P3 User Account Control Settings mee Choose when to be notified about changes to y
42. Rate Manual Days Number of Applications Simple percentage Virtualization Simple hours effort 8 ChangeBASE Days Number of Applications Simple percentage ChangeBASE Simple Hourly Cost Days Saved Manual Days ChangeBASE Days Percent Saved Manual Days Days Saved 100 Medium Calculations FIELD CALCULATION Manual Cost Number of Applications Medium percentage Virtualization Medium hours effort Average Hourly Rate Manual Days Number of Applications Medium percentage Virtualization Medium hours effort 8 ChangeBASE Days Number of Applications Medium percentage ChangeBASE Medium Hourly Cost Days Saved Manual Days ChangeBASE Days Percent Saved Manual Days Days Saved 100 141 7 Dashboard Complex Calculations FIELD Manual Cost Manual Days ChangeBASE Days Days Saved Percent Saved Total Calculations FIELD Manual Cost Manual Days ChangeBASE Cost ChangeBASE Days Cost Saved Days Saved Percent Saved Quest ChangeBASE 5 3 User Guide CALCULATION Number of Applications Complex percentage Virtualization Complex hours effort Average Hourly Rate Number of Applications Complex percentage Virtualization Complex hours effort 8 Number of Applications Complex percentage ChangeBASE Complex Hourly Cost Manual Days ChangeBASE Days Manual Days Days Saved 100 CALCULATION Sum of Manual Costs Sum of Manual Days ChangeBASE
43. Report Results on Tab Change keeps the report results available even if you have accessed another database or closed and re opened ChangeBASE As soon as the package is closed the report results will be cleared from memory Show Checked Out Packages Only displays only the packages that the current user has currently checked out By default a user owns all packages that they have imported and therefore they are checked out in that user s profile and show the padlock icon in the Information column Identify Packages with ProductName displays packages by the value of their ProductName property rather than the filename of the package Q You can interchange the display between the filename and Package Name by using the function Ctri N Confirm Clear Results controls a warning dialog which can appear when you click Clear Results 173 12 ChangeBASE Options Quest ChangeBASE 5 3 User Guide 12 1 2 Transforms Generate Transforms should be checked to create fixes in a Transform file MST The supported way of changing a vendor supplied MSI is by generating the changes within a Transform file When you use this option it is not necessary to select Backup MSI before applying Fix because the MSI file is not modified Roll up Fixes should be selected if you would like to add the fixes to an existing Transform e g a standardization Transform that has been imported into the database If there are multiple Transforms in the database Chan
44. Reports haus ono pae an ere feeen frer 1 RED C a a OpenPlan_Professional Internet Explorer 7 8 Application Compatibility IE7 Secure Object API Analysis v1 17 Internet Explorer 8 Presentation Compatibility Internet Explorer 9 Presentation Compatibility Internet Explorer 7 8 Application Compatibility IE7 Secure Object API Analysis v1 17 Windows 8 Internet Explorer 7 8 Application Compatibility IE7 Secure Object API Analysis v1 17 Internet Explorer 8 Presentation Compatibility C a WinZip Internet Explorer 7 8 Application Compatibility IE7 Secure Object API Analysis v1 17 377 377 1508 59 59 236 Windows 8 E a E Sophos_Anti Virus Internet Explorer 7 8 Application Compatibility IE7 Secure Object API Analysis v1 17 243 243 972 Windows 8 Non Supported Drivers 32bit OS 18 48 48 6 8 5 Package Issue Summary JOE csesonattvippoaattoancrany 9 C x cangeast Paagets ChangeBASE Package Compatibility Report 13 Feb 2013 12 38 AM Package Issue Summary Compatibility Results ETCi_Service_Release AppID Group 3 Group 2 Group 4 w Internet Explorer 7 8 Application Compatibility IE7 ActiveX Pre Approved CLSID Analysis v1 14 Package Registry Level Issue CLSIDY5C42BBA4 7671 47A6 8F 12 z 3 6D0A05AC51C0 Manual Fix Manual Fix Required Package Registry Level Issue CLSIDK 7AB44A0A CFAD 4344 8FE3 0178A6A7B061 Package Registry Level Issue CLSIDY8DDE622
45. This issue occurs when the ChangeBASE packager program does not exist where indicated in the configuration file Proceed as follows 1 Locate the AOQKCSCManager exe config file typically found in C Program Files x86 ChangeBASE AOKCSC AOKCSCWS CENTRAL SERVER Open the file and modify the following line to point to the correct installation folder of ChangeBASE Workbench lt add key AOKProgramLocation value C Program Files x86 Quest Software ChangeBASE cbPkgr exe gt Note If using Windows 7 or 8 or Windows Server 2008 or 2012 then depending on your User Account Control settings you may need to run Notepad in Administrator mode to edit this file 243 Index Index A Active Directory 15 28 29 32 64 182 183 Add to Core App List 202 Add to Matching Analysis 202 Add In Tab 186 Adding Reports 216 Adding Rules Custom Plugin 218 Report 218 Advanced Usage 88 189 Analyzing Results 110 113 ApplDs 67 68 69 70 82 84 88 119 122 195 Add 70 Maintenance 68 Select 195 Application Compatibility 14 Application Remediation 127 Application Summary 123 132 133 Application Testing 127 Application Virtualization 11 127 App V 12 14 22 110 111 114 123 125 146 155 156 158 159 4 6 SP1 Advanced Settings 163 5 0 Advanced Settings 165 Sequencer 170 Balloon Tips Avoid 159 Architecture Client Side Capture 231 ASP NET 19 Assessing a Real World Package 150 Assessing Pa
46. UKB Q ae 5 S Interop IWshRuntimeLibrary dll 10 11 2010 20 21 Application extens 48 K S2 Workgroup PROD UKB W x ENE m makecert exe 22 03 2010 17 57 Application 55K hi Network ba 4 p p AOKCCControl exe Date modified 26 04 2012 14 20 Date created 26 04 2012 14 20 Application Size 160 KB 4 Run AOKCCControl exe 237 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide 5 The CSC Agent icon either appears in the system tray Bie gt or it may be hidden in the adjacent notification area The CSC Agent has a right click context menu containing relevant commands start capture Upload data to Central Server About Exit mE E kj Start capture This command causes CSC to start to monitor the incoming web traffic and store it in a local cache It should be noted that all textual content is removed from the web page before it is stored This is to ensure that users personal data is not compromised Stop capture This command causes CSC to stop monitoring and storing web traffic Upload data to Central Server This command causes CSC to upload its local cache of captured data to the computer designated as the CSC Server If Start Capture was previously active then CSC will temporarily stop monitoring web traffic prior to the cache upload and then resume web traffic monitoring following the upload About This command displays a screen with information that will b
47. a ae i z a rer ms i Agbor mhana pra I s b hse E il Ea La er ary aS le a GPL ir E ie BAS 7 a Back Ghose If you only have a limited number of packages programs to import and do not wish to change the way in which they are displayed then simply click Add to ChangeBASE and go to Importing SCCM packages programs into ChangeBASE Note If the Copy SCCM Package check box is selected the source files will be copied to the specified location and added from there rather than being accessed by ChangeBASE from the SCCM package source distribution point You would normally do this if remediation was to be performed on the packages that is to say where MST files were likely be generated If you have multiple pages of packages programs to import you should consider using the Export and Import buttons as outlined below Exporting and Manipulating filtered packages programs prior to import into ChangeBASE The Export and Import buttons allow you to export the filtered packages programs into CSV files offline add the required action flags view names and ApplDs and then import the amended CSV file content directly into ChangeBASE This saves you having to go through pages of packages programs importing a page ata time To export the filtered packages programs click the Export button in the bottom left of the dialog and create a CSV file with an appropriate name The following example shows such a file opened in Microsoft
48. addition there are Next Steps documents available for a number of the issues which are accessible through Dashboard see Chapter 7 Dashboard for more information 6 3 3 Red A Red issue is generally one that pertains to how the code or actual program works In this case ChangeBASE will flag Red issues where a package tries to use objects or functions that have been deprecated from the OS or where their use has been restricted In this case there are no changes that can be made to the install routine to fix the problem The problem needs to be dealt with at the program code level by the programmer who wrote it or by providing a more up to date driver For vendor MSIs an upgrade may be required The recommendation with packages containing Red issues is that they are tested to see if the issue is either causing it to fail to install or for a critical part of its functionality to fail It is possible that a package that contains a Red issue can be used if either the Red issue is not used in the package or if the part of the package that relies on it is not important 6 4 Analyzing Results Consider the diagram shown below This explains how packages are affected by the different technologies l Operating system Windows 7 a Architecture Server 2008 3 Hosted packages Yes KDS XenApp Hosted No 4 Package format Virtual App V etc Native MSI EXE etc When reviewing assessment results in Ch
49. be installed on local hard drive by clicking the drop down refer to 2 1 2 1 Dashboard Setup Otherwise you should select Entire feature will be unavailable 34 2 Installation Quest ChangeBASE 5 3 User Guide Custom Setup Quest Select the way you want features to be installed C h an g BASE Click the icons in the tree below to change the way features will be installed This will install IIS if necessary to Server Components add a Dashboard website for Will be installed on local hard drive Zz 98 Entire feature will be installed on local hard drive x Entire feature will be unavailable 4 Click Next and then Install ChangeBASE Click Install to begin the installation Click Back to review or change any of your installation settings Click Cancel to exit the wizard 5 Once installation is complete click Finish fs ChangeBASE Setup a Completed the ChangeBASE Setup Click the Finish button to exit the Setup Wizard ChangeBASE Cancel 35 2 Installation Quest ChangeBASE 5 3 User Guide 2 4 Upgrading ChangeBASE With this release of ChangeBASE proceed as follows 1 If you are upgrading from ChangeBASE 4 x or earlier you must obtain a new license as licenses from earlier versions will not work Back up the database refer to 2 1 8 Database Backup Requirements Ensure that all users close ChangeBASE Run the ChangeBASE 5 3 installation on one client machine i
50. by this document or in connection with the sale of Quest products EXCEPT AS SET FORTH IN QUEST S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR THIS PRODUCT QUEST 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 QUEST 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 QUEST HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES Quest 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 Quest does not make any commitment to update the information contained in this document Quest ChangeBASE Version 5 3 Last updated May 28 2013 Contents Quest ChangeBASE 5 3 User Guide Contents PDOUT THIS GUO raea a E A 10 OVENI N e 10 CONVENIONS iii a 10 T NVEFOOQUGTION gseceiocintansdevaencle a AARAA 11 T ChangeBASE Product EdIHONS aiena E A N et 11 1 2 Key Phases of a Migration Project cccccccceccecceeceeceececaeceeceeseeseeseees
51. cases depending on their complexity and quality Typically the following file types would be repackaged as MSls using a Virtual Machine e Executable installation EXE e VBScript VBS e Batch file BAT 90 5 Importing Packages Quest ChangeBASE 5 3 User Guide Bootstrap EXEs Be careful when attempting to import EXE installers into ChangeBASE as A many of them are bootstrap EXEs in that they already contain MSI packages When such an EXE is launched it extracts the MSI into a temporary folder The EXE then installs the MSI package It is always preferable to import the MSI directly into ChangeBASE rather than attempt to convert the EXE installation into an MSI ChangeBASE is designed to detect when a bootstrap EXE has been imported A low severity import warning will be displayed and the package type icon will be shown as F 5 4 Repackaging Configuration In order to be able to import legacy packages into ChangeBASE the following must be configured e 5 4 1 Virtual Machine Setup e 5 4 2 ChangeBASE Repackaging Options e 5 4 3 Repackaging Filters 5 4 1 Virtual Machine Setup ChangeBASE supports the following hypervisors e Microsoft Hyper V e VMware Workstation e VMware Server ESX vCenter Server o You may encounter errors connecting to ESX servers 5 1 and above If you do receive such errors download and install the latest VIX library from the above link o The VMware VIX library only allows conne
52. context You should check the names of the actions to ensure that they do not look like they are supposed to be making changes to settings in the user profile In a corporate environment the user performing the installation is often a user who will never be using the software so you will also need to check that there is a method for getting them applied such as an HKCU HKEY CURRENT USER keypath or an advertised shortcut combination 8 2 Legacy Help Files 8 2 1 How to Reproduce the Problem 1 Install the software on Windows 7 Windows 8 Windows Server 2008 or Windows Server 2012 2 After installation navigate to the HLP file identified by the test and double click on it You will see the error message shown below You may also be able to bring up the error by selecting F1 or by going to the help menu from within the software 144 8 The Top Five Issues Explained Quest ChangeBASE 5 3 User Guide Windows Help and Support Why can t I get Help from this program The Help for this program was created in Windows Help format which depends on a feature that isn t included in this version of Windows However you can download a program that will allow you to view Help created in the Windows Help format For more information go to the Microsoft Help and Support website 8 2 2 Explanation of the Issue The help engine that came with Windows 3 0 looked like this WinHelp Sample File Edit Bookmark Options Help
53. enter a string in the URL column and tick the Include box but not the Exact box CSC will include only URLs that start with the entered string for example http www bbc co uk weather will include only the BBC weather site and exclude everything else 235 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide If you enter a string in the URL column and tick both the Include and Exact boxes CSC will include only that exact URL for example http www bbc co uk radio4 will include only the BBC Radio 4 main page and exclude everything else 3 Click OK to save your entries and clear the dialog 15 6 5 Verify CSC Setup 15 6 5 1 Web Service To verify that Client Side Capture is correctly configured open Internet Explorer on the CSC Server and browse to http localhost AOKCSCWS ConfigService asmx The following page should appear GC Servicel Web Service Windows Internet Explorer ee x OW http localhost AOKCSCWS Peeescceees ly Favorites E Servicel Web Service T The following operations are supported For a formal definition please review the Service Description AmIRegistered e AppUpgradeFinished ConfigurationData DBConnectivityTest e DBUpgradeFinished ExportFinished GetConfiguration GetExportTriggerFileSize GetFileSizeLimit GetFilterList GetMyPollinterval 4 m Ge Local intranet Protected Mode Off fa v7 10 v Click on the DBConne
54. f Delete QVMTools Setup msi from the Virtual Machine and empty the Recycle Bin Disable the Operating System firewall Disable any third party firewall software Disable any antivirus software Disable UAC if running Windows 7 or Windows 8 Disable Windows Updates Disable Windows Search Disable Windows Defender Disable and switch off any Action Center messages Ensure that the default web browser is launched at least once on the machine and that any initial pop up queries are answered so that they do not reappear If using Windows XP or Windows 8 running in Hyper V the tasks listed below are also required a For Hyper V VMs ChangeBASE uses WMI Windows Management Instrumentation to connect to the guest VM for user authentication With Windows XP this needs to be enabled as it is disabled by default To enable remote WMI follow the steps below i Navigate to Start gt Control Panel gt Administrative Tools gt Local Security Policy li Navigate to Security Settings Local Policies Security Options i Open the policy Network Access Let Everyone permissions apply to anonymous users Set it to Enabled iv Open the policy DCOM Machine Access Restrictions Then click Edit Security Add ANONYMOUS LOGON Everyone INTERACTIVE NETWORK SYSTEM Set Allow for both Local Access and Remote Access for all the above groups v Open the policy Network Access Sharing and security model for local accounts Set it to Classic
55. greatest impact will get resolved first For further information refer to Chapter 15 Browser Compatibility 2 Installation Quest ChangeBASE 5 3 User Guide 2 Installation e 2 1 ChangeBASE System Requirements e 2 2 SQL Setup e 2 3 Installing ChangeBASE e 2 4 Upgrading ChangeBASE 2 1 ChangeBASE System Requirements Before installing ChangeBASE ensure that your system meets the minimum hardware and software requirements depending on your configuration as described in the following sub sections 2 1 1 Local Database Setup For a training course a POC Proof Of Concept installation or where there is only to be one user of ChangeBASE it is usual for all components to be installed on the same machine ChangeBASE SQL 2 Installation Quest ChangeBASE 5 3 User Guide Operating System e Windows XP SP3 e Windows Vista SP2 e Windows 7 e Windows 8 e Windows Server 2003 inc R2 SP2 e Windows Server 2008 inc R2 e Windows Server 2012 Minimum Hardware e 2 5GHz dual core processor or greater e 4GBRAM e 50GB hard disk space e 1024 x 768 display Software Requirements e Microsoft NET Framework 3 5 SP1 and 4 0 30319 or later Full Client e Microsoft Log Parser 2 2 For importing folders as packages e Hypervisors for Legacy Conversion hereafter typically referred to as Repackaging See 2 1 3 Virtual Machines Database Microsoft SQL Server 2008 inc R2 Express Standard or Enterpr
56. identified within each RAG status An HTML report that lists each checked package report group and full issue details if required within each RAG status An HTML report that lists every checked package and every report which has been run against that package The report will create a CSV file containing a row for each issue for packages which have been checked This report includes Cost Effort calculations 116 6 Assessing Packages and Viewing Results Quest ChangeBASE 5 3 User Guide 6 7 Viewing Results Issue Summary The Issue Summary reports are either text or HTML reports which show the issue details for individual packages The reports are useful for package owners or package specialists who are working on a specific package For more details about Issue Summary reports refer to the following topics e 6 7 1 Setting up Issue Summary Reports e 6 7 2 Creating Individual Issue Summary Reports e 6 7 3 Creating Bulk Issue Summary Reports 6 7 1 Setting up Issue Summary Reports 1 Open the ChangeBASE options and select the Issue Summary Tab 7 x Options General Issue Summary Core App Lists Platforms Upgrade Services Security Report Costs Duplicates Add in Repackaging Options Dashboard Other Report Group Converti Filters Windows 64 bit Windows 7 s Selected Plug ins Active Directory GPO Settings Analysis a Common Dialog Compatibility Analysis
57. ngeBASE Click the icons in the tree below to change the way features will be installed E ChangeBASE This will install IIS if necessary to add a Dashboard website for Will be installed on local hard drive 8 Entire feature will be installed on local hard drive on your XxX Entire feature will be unavailable as The Server Components comprise the Dashboard web pages running as ASP NET pages under Microsoft IIS Internet Information Services They are only required on the machine hosting Dashboard 2 Installation Quest ChangeBASE 5 3 User Guide Note If you are installing on Windows XP and the Windows XP installation media are not in the installation path then you will be prompted to supply them Please ensure that either the CD is available or the source files have been copied to a local or network location that you Can access Dashboard can be installed on any machine on which IIS is installed including a client machine provided that it meets the criteria shown in 2 1 2 2 Requirements or the machine on which the SQL Server is running Where multiple clients connect to the same database it is advisable to install Dashboard on a central machine to provide uninterrupted service refer to 2 2 2 SQL Setup for a Multi User Environment In this case the following selection should be made on each of the clients for installing just the ChangeBASE software and not the Server Components e
58. of logic checks in the currently selected reports Plugins Issues The number of issues being displayed currently Upgrades Available The number of new reports Plugins available for download These can be downloaded in the Upgrades Tab in Options 4 4 Tabs For the Packages Tab refer to 6 5 1 Packages Tab For the Reports Tab refer to 6 5 2 Reports Tab 4 4 1 New Project Wizard If you are new to ChangeBASE the New Project Wizard takes you through the entire ChangeBASE flow in steps and illustrates your progress through the flow by ticking each step as it is completed 61 4 ChangeBASE User Interface Quest ChangeBASE 5 3 User Guide laa j ChangeBASE ene view New Project Wizard In this tab we will walk you through setting up a new project If you are not online please contact support to get instructions on how to load your Report Groups ia ee Display Project Wizard when I launch ChangeBASE If you do not want to configure ChangeBASE to use Virtual Machines at this point i e if you have no legacy installers to import for repackaging check N A Not Applicable on the right of the screen Note If you do not want this wizard to be displayed when you next start ChangeBASE uncheck the box Display Wizard when I launch ChangeBASE at the bottom of the window The hyperlink on the right of each step takes you to the relevant section of the online help 4 5 Portfolio Summary The Portfolio S
59. of your Web browser s for compatibility issues Important It is highly recommended that you use an account specifically created for the purposes of testing This is to avoid a situation whereby a link is automatically followed that could cause information in a live environment to be deleted or modified Ideally this account should not have high levels of authority thus reducing the risk of accidental damage 15 1 Loading URLs URLs Uniform Resource Locators can be dropped onto the ChangeBASE Workbench directly from your browser s address bar or from any document that recognizes URLs such as Microsoft Word or WordPad Note This functionality has been removed from Internet Explorer from Version 9 upwards so if you are testing Internet Explorer compatibility it is recommended that you use a text editing tool such as those mentioned above Once a URL has been dropped onto ChangeBASE click the Import link on the Packages Panel and the URL will be spidered automatically The results are affected by the options set in the Browser Compatibility Tab In particular you should set Web Analysis Mode to Web Based Applications Only The limit of URLs that can be loaded is set in the Static Web Search Url Count Threshold field in this Tab The default limit is 500 However if you are importing large websites you are advised to keep well below this limit otherwise the performance of ChangeBASE may be adversely affected 15 2 Auto Logon
60. on wimfltr inf or wimmount inf and choose Install 13 3 5 Mounting the WIM file 1 2 It is not recommended that you place the WIM file on your desktop Place the file in a folder that can be accessed by all users To avoid other problems you should set NTFS permissions on the file to give Everyone Full Control to the WIM file Create a folder that will be mapped to the WIM contents e g C WIM This must be an empty folder Open a CMD Command Prompt with Administrative Elevated permissions Navigate to the folder containing ImageX as above Mount the WIM using the following command line ImageX MOUNT lt path to your WIM gt 1 lt path created in step 3 gt WIM files can contain multiple volumes Check the size of your mounted folder If it is too small then you may have mounted the wrong volume Return to the previous step and use a higher number 2 3 4 etc in the third command line argument 13 3 6 Loading into ChangeBASE 1 Drag and drop the folder representing the mounted WIM file onto ChangeBASE while holding SHIFT this ensures that it does not seek out MSIs in the sub folders You may be prompted to load the Microsoft Log Parser at this point Whilst this is required for some ChangeBASE functions it is not necessary for WIM file loading so you can choose to install it when asked or just select Continue Right click on the folder in ChangeBASE and change its setting to Repackaging gt Source Cap
61. pie charts in the bottom left hand corner and Platform 4 is represented by the pie charts in the bottom right hand corner The pie charts display compatibility results according to RAG status For each group of charts the left hand chart Before displays details prior to any Amber applications issues being fixed and the right hand chart titled After shows what the state of the applications would be if Automated Fixing was to be applied Along the top of each section is the title name that was set up in the Dashboard Options screen Next to the title is a link to return to the Executive Summary screen It is possible to drill down to a detailed view of application status simply by clicking on either chart in any section This is discussed in the next section 7 2 4 Application Summary The Application Summary screen shows a list of applications and their current status for the selected Chart group The column on the left shows an icon for the overall status of each package against your chosen target Platform e g 133 7 Dashboard Quest ChangeBASE 5 3 User Guide A PP Executive Summary Executive Detail Application Status For Windows 7 x64 with App V ee eL Po asf e Pavlov F _ChangeBASE msi 7Zip 7z920 x64 msi bao fos adobe stems ne fraretangeeaseimetndabe Arahat 5 05 a F _ChangeBASE msi Adobe Reader 7 0 Adobe e Adobe Reader 7 0 Adobe Systems Inc Reader TO me m Adobe Systems F _ChangeBASE _App_Repository 10
62. prior to the issue for example if running a report specify which report against which package Support may also request a copy of the MSI s in question in order to identify the issue lf ChangeBASE does not load subsequently try to delete the WorkBenchSettings xml file refer to 13 5 Important Files and Folders and to re establish the connections to your databases 109 6 Assessing Packages and Viewing Results Quest ChangeBASE 5 3 User Guide 6 Assessing Packages and Viewing Results e 6 1 Choosing the Right Report Groups e 6 2 Assessing Packages e 6 3 RAG Status Red Amber amp Green e 6 4 Analyzing Results e 6 5 Viewing Results ChangeBASE e 6 6 Viewing Results Assessment Results e 6 7 Viewing Results Issue Summary 6 1 Choosing the Right Report Groups As an example answer the four questions below about the target environment to which you are going to migrate this will determine which report groups to select QUESTION ANSWER CHANGEBASE REPORT GROUP Operating System Windows 7 Windows Windows Server 2008 Server 2008 inc R2 Architecture 32 bit Windows 32 bit 64 bit Windows 64 bit Hosted Packages Yes Virtualization Citrix XenApp hosted and MS RDS No No report group needed Package Format Virtual Virtualization App V Virtualization VMware ThinApp Virtualization Symantec Workstation Virtualization Virtualization Citrix XenApp streamed Native No report group needed 11
63. shown below Auction Server id Package i Program Name ViewName Appii F Valid actions A Add to Change BASE A Aesel imported flag Vadhange ViewName k Recet default ViewName only ag F AppiDs can be entered inte the aporoeriate column Mulige Apmis tan be entered seperated by a semicoton App 1 OMNOMOE install testi 1 OMNOOOM fh Fhe 1 1OMMODOO FileZilla Server 3 41 test Phase iServer i OMKES HijackThis Phi 1 Phase L0estktog 1 OVD insiEd Phage 1 Phase 1 Develoament 1OMNODOOD Install ONC DEMOLAB AU rit ALinit 2 5 5 1 OMNOOOOD Uninstall NUnit 1 OOo BT Note If you are adding multiple AppIDs as shown above then you must not add spaces between them although actual AppID names can contain spaces Multiple AppIDs must be separated by semi colons The import process will create new ApplDs as required 5 2 3 5 Adding the packages programs to ChangeBASE If you have exported a CSV file as in the previous section then after editing the file you should 1 Save the file as a CSV file 2 Go back to the SCCM interface in ChangeBASE 3 Select the correct SCCM server if there is more than one and go back to the initial package program view nd ChangeBlASE SCCM Interfere SODH Canara Mtl sT Hane F armor i e e Pegs hes Sah peice Command Lire Ser Fie i Fisi Proe Fin Zia Cie 4435 Fle Dis Gleni EE FiDi 5 9 er up ee SULA a i Fi ily Frai Aingily Server ET ER Hes Sewer EXE Hindis Serseri 9 al ee EMANAT Trei Hbre Hifas This EH Hi beci Tha u
64. to install CSC if relevant in order to provide an uninterrupted service The Dashboard and CSC IIS servers require access to the ChangeBASE SQL database This can be achieved by using either of the following methods e Windows authentication which is the recommended method refer to 2 2 2 1 SQL Setup using Windows Authentication Or e SQL Security refer to 2 2 2 2 SQL Setup using a SQL Login 2 2 2 1 SQL Setup using Windows Authentication 1 Add the name of the machine hosting Dashboard to the Active Directory group created in 2 2 1 Assigning Permissions using SQL Server Management Studio this machine is PC01 in the following example ChangeBASE Users Properties x General Members Member Of Managed By local net Users local net Users local net Users local nets 2 Follow the procedure in 3 2 Database Setup and 15 6 4 CSC Configuration and ensure that Use Windows Security is checked when connecting to the database 2 2 2 2 SQL Setup using a SQL Login 1 Ensure that you have set up a SQL login on the database with the permissions assigned in 2 2 1 Assigning Permissions using SQL Server Management Studio 2 Follow the procedure in 3 2 Database Setup and 15 6 4 CSC Configuration and ensure that Use Windows Security is unchecked when connecting to the database 32 2 Installation 2 3 Installing ChangeBASE 2 3 1 Pre Installation Quest ChangeBASE 5 3 User Guide Ensure that you have
65. top of the screen Note You must have Javascript enabled in order for these operations to work 6 8 7 Running Reports from the Command Line All of these reports can also be run from the command line Refer to 13 6 Command Line Invocation of ChangeBASE Functions As an example to run the Profile report against the first ChangeBASE database you would use the following command line cbExec EXPORT WBDB1 X1 C temp report1 html 6 9 Troubleshooting If the Assessment Results option drop down in the Reports panel is disabled so that you cannot run reports verify in the Security Tab within the Options menu that the Add Package option is Enabled for your user role e g tl Options General Issue Summary Core App Lists Platforms Upgrade Services Security Report Costs Duplicates Browser Compatibility Add in Repackaging Options Dashboard Virtualize nA Role Admin User Database Maintainer Delete Package Delete Report Edit MSI Package Orca Edit MSI Package MSIStudio Edit Plugins Plugin Editor Extract Cab Files Fix Pack ee PROD jgreen Copy Issue To Clipboard Load Web Site ClearCheckous Allow SFT Files Virtualisation Streams Multiple Database Support Add OS Snapshot Reimport Package J A SSS SS QS QS SS SSS SS BS Report View VReady it Cancel 122 7 Dashboard Quest ChangeBASE 5 3 User Guide 7 Dashboard 7 1 Wha
66. you find that Plugins fail to run then you may have the wrong version of Plugins for the version of ChangeBASE that you are running Ensure that you always have the latest version of the software and that you have the latest Plugins loaded You should also ensure that the Manually Add Reports and Plugins setting within the Security Tab is checked for your user role CS Options General Issue Summary Core App Lists Platforms Upgrade Services Security Report Costs Duplicates Browser Gi 4 Role Standard User Function Add DB Updates Add Middleware Add Package Add Package To vvatch List Add Package to Core App List Administrator Rights Allow Additional Package Wiews xPYM BBAOCKEA BC Administrator Transtorm Application Directory Structur Convert ft Lacal Clear Checkouts Convert t Remote OF Apply Cancel 4 7 AppID Feature This feature provides you with the ability to represent your applications in the exact manner in which they are intended to be deployed For example some applications such as MS Office are comprised of multiple packages e g MS Office incorporates MS Word MS Excel MS Outlook and MS Powerpoint amongst others The AppID feature allows you to report on the individual packages but also show them as a single overall application The feature also allows you to represent applications in accordance with your own internal naming conventions 67 4 ChangeBASE
67. you see the following dialog lati Edit an App ID Mobile Apps you can either edit the name as required and click Update or else click Delete when you will be asked for confirmation that the AppID is to be removed from all packages 70 5 Importing Packages Quest ChangeBASE 5 3 User Guide 5 Importing Packages 5 1 Importing Packages Overview ChangeBASE lt mull Virtual machine Packages can be imported into ChangeBASE in one of two ways 1 A large number of installation formats can be imported directly by ChangeBASE using the methods described in 5 2 Import Methods 2 The other legacy formats shown should be imported via a Virtual Machine refer to the sections starting with 5 3 Repackaging Overview Note Installation EXEs e g setup exe must be repackaged that is to say imported via a Virtual Machine for assessment However Microsoft updates supplied as EXEs may be imported into ChangeBASE directly 71 5 Importing Packages Quest ChangeBASE 5 3 User Guide 5 2 Import Methods There are four methods of importing packages regardless of format e 95 2 1 Drag and Drop e 95 2 2 Browse Dialog e 5 2 3 Browse with SCCM e 5 2 4 CSV Import For details on import packages issues please refer to 5 2 5 Import Warnings 9 2 1 Drag and Drop eeeeuewee Quest S e OCE ChangeBASE Professional Packages Packages Browse _ d V Reports Import EA p F Virtualisation
68. your current license with the one downloaded Your old licence will no longer be valid and can be discarded DO NOT navigate away from the page before the upload has completed or the upload will be terminated File Name Choose File No file chosen Submit When prompted browse to the temporary AOK cbl file on the external media double click the AOK cbl file and click Submit When prompted to download the new file save the new AOK cbl back to the external media overwriting the temporary copy already there Take the external media back to the machine running ChangeBASE and copy the new AOK cbl from the external media onto the machine overwriting the file already there Start ChangeBASE It will pick up the license file downloaded from the server and then ask for the name of the SQL server 3 1 3 Swapping Licenses ChangeBASE can only use one license at any one time Where there is a requirement to switch licenses the following process should be followed ey o gt Close ChangeBASE Browse to the UserData folder specified in 3 1 4 1 License Expiry Rename the AOK cbl file Start ChangeBASE You will be prompted for a new license code Enter this and activate it online or browse to the offline license file ChangeBASE will then start and load the previously set up databases To swap back to the original license close ChangeBASE rename AOK cbl then rename the original license file back to AOK cbl
69. 0 6 Assessing Packages and Viewing Results Quest ChangeBASE 5 3 User Guide Examples e You have a client who wants to move to Windows 7 x64 and would like to virtualize their packages with App V Report groups o Windows 7 o Windows 64 bit o Virtualization App V e You want to host packages on a Windows 2008 R2 Terminal Server and for delivery as native installers MSI amp Legacy Report groups o Windows Server 2008 o Windows 64 bit o Virtualization Citrix XenApp hosted and MS RDS 6 2 Assessing Packages Once the appropriate report groups have been imported and the packages have been imported the automated assessment can begin 1 Check the appropriate report groups 2 Check the packages which require assessment i eg E Darp dj Lael Baers 8 Fama hermiman Compete Firar I orie 8 purder geal nere gee i eae o PFARA A lols Ciri ergy Fated gered M PG eg A hae ee Me pee bee ee ee RD Tiare 2 Bite eed Ed irn TH A Lirie T Big Oa i h eel falas Me A ere lief heiii H C A as Be 6 0 eee BeEspeseseeeeeee se Fi Pn MA aE EELELLELELELET ELELE i Ea ma pa ba ma ba ka ba ba pa pi a ES BJS epee Tapi TAE 3 Click the Assess button in the Packages panel refer to 4 1 Packages Panel The assessment progress is shown in the lower left hand side of the screen with a message Running Selected Reports and with a status bar in the lower right h
70. 04 13 3 Importing Operating System IMAGES ccccccecceeceecececeeceesuesueceeceeceseesueceeeesaeeas 204 13 3 1 Gold IMageS 00 ccc ccc cccaccseneeneececcuccuccucaesensessussuccueusneesuesuececcussusensessussuccecauceusanees 204 T3022 LINN AUONS E EEEE EEEE DE a 204 13 3 3 Alternatives to WIM PICS 0 cc cccccccccccccccsecseneenessuccuccuccuccuceusensessucsenesessessussucseces 204 13 3 4 Installing the WIM Driver PICS ccc ccccccccccecceccecseeseeseeseeeceeseesecseeseseeseeseeseeseees 205 13 3 0 Moun uing ANG WIM TUG lt 3 25502 cacna cng 0552 2a aaaa daa Aad dadesnaea nan scan anae eee eee encase me dawedacecees 205 13 3 6 Loading into CHANGEBA SE sissies ic soce soos ee ie 205 VDA CAS CORE ADDIICATION CaN sscencceccea cs casc acco E cece EREA AREA 206 13 4 1 Core Application Scan RUIOS ccccccccccneeneesuccuccuccecceceuseesessussuccecsnessessuseeees 208 13 4 2 Understanding the CAS Rules 00 cccccccccceccecceccecceeseeececeeseeceeseeseesesaeseesesaeeas 209 13 4 3 Core Application Rules Se ttinS ccccccccccccecceccecsececeeceeceesecseesessesesenesseeas 210 13 5 Important Files and FPOMGCKS 55 ost sk oo essed edad cere aes 211 13 6 Command Line Invocation of ChangeBASE Functions cccccecc eee eeceeeeeeeeeeees 212 POCO ODE OE ea E A E E esaa ene 212 PO 111 gk R TE A E NEO 212 120 S LIOTREPORT S soror EE ERE RE R Ree 213 13 0 4 LISTPACKAGES 23a EE ae ERE EE AEAEE EAA ENET EEEN 213 Conten
71. 05 14 Preloader cbMsiConverterBase Establish Preloader 13 05 14 Preloader Initialised Start A Preloader 13 05 14 Scanning Table msi_Validation 247 Row s Load MSI Tables 13 05 14 Scanning Table msiAction 0 Row s Load MSI Tables 13 05 14 Scanning Table msiActionText 70 Row s Load MSI Tables 13 05 14 Scanning Table msiAdminExecuteSequence 13 Row s Load MSI Tables 13 05 14 Scanning Table msiAdminUISequence 14 Row s Load MSI Tables 13 05 14 Scanning Table msiAdvtExecuteSequence 20 Row s Load MSI Tables 13 05 14 Scanning Table msiAdvtUISequence 0 Row s Load MSI Tables 13 05 14 Scanning Table msiAokUriMap 0 Row s Load MSI Tables 13 05 14 Scanning Table msiAppId 0 Row s Load MSI Tables 13 05 14 Scanning Table msiAppSearch 0 Row s Load MSI Tables 13 05 14 Scanning Table msiBBControl 0 Row s Load MSI Tables 13 05 14 Scanning Table msiBillboard 0 Row s Load MSI Tables 13 05 14 Scanning Table msiBindImage 0 Row s Load MSI Tables 13 05 14 Scanning Table msiCCPSearch 0 Row s Load MSI Tables 13 05 14 Scanning Table msiCheckBox 2 Row s Load MSI Tables 13 05 14 Scanning Table msiClass 0 Row s Load MSI Tables 13 05 14 Scanning Table msiComboBox 0 Row s Load MSI Tables 13 05 14 Scanning Table msiCompLocator 0 Row s Load MSI Tables 13 05 14 Scanning Table msiComplus 0 Row s Load MSI Tables Show All z Close e ShowAN O ey Show Error
72. 09 6 Assessing Packages and Viewing Results ccceeeeeeeeeeeeeeeeeeeeeeeeeeeneneeees 110 6 1 Choosing the Right Report Group 0 ccc ccc cecc ees eee eee eee eee eee eseeseeaeseeseeseeseeaeeeeegees 110 O 2 ASSESSING Packages eei E E Eapen 111 6 3 RAG Status Red Amber amp Green nssensssnnenrnnnrnnnnrnrrrrrnrrrnnrrnnrrnnrrnnrrrrrrnnrr narr rnrr nnne 112 SRSA RE E ere eee EE A E AE 112 OS AOO e e EEE ETEA AERA A 112 Go ES 210 E R EEA E AA EEIT TT A A ees 113 OAPAMA ZINN RESUS r a 113 6 5 Viewing Results ChangeBASEL cccccccccecceeceeceeceececaeceecueseesueseeaeseeseeseeseeseeseeaees 114 69 ie Fackade S TaD rE aa ence eee eee ce eae 114 6 9 2 Reports TaD oe e e eee aan aa aaa aa Ea DET aE aaa aia ae a iaia aaa aaa aa aaia aiai 115 6 6 Viewing Results Assessment Results ccc ceccec cece ece eee eeeeceeseeseeeeeeeeeeaeeaeeeeenees 115 6 7 Viewing Results Issue SUMMMALY cccccecceeceeceeceececeeceeceesueseeseeceeeesaeseeseeseesesaees 117 6 7 1 Setting UP Issue Summary REPOSTS ccccccceccecceccecceesecsecececeeseeseesesaesneseeseees 117 6 7 2 Creating Individual lssue Summary REPOSTS ccccccccecsececsececneceeseeseeseeseesess 118 6 7 3 Creating Bulk Issue Summary REPOSTS ccccccscceccecceccecceeseenecneseceeseeseeseeaess 118 6 8 Summary Report Examples showing ADppIDS ccccccccececeeee eee eeeeeeeseeseeaeeaeeaees 119 OT PI OO sca sacaa arc sas
73. 1 2 Reboot the machine if prompted 3 Open a command prompt as administrator and run the following command C Program Files VMware VMware ThinApp Snapshot exe C Start Snapshot 4 When the Snapshot has been taken close the command prompt 5 Ensure that there are no unnecessary packages running on the Virtual Machine that may be updating files for example Windows Desktop Search 6 Leave the machine idle for around 10 minutes This will create a better session as most of the locks will be cleared by that point 7 Snapshot the Virtual Machine whilst it is running 8 Shut down the Virtual Machine Start Shutdown or just power it off 11 2 6 ChangeBASE Configuration 1 Open the ChangeBASE options and change to the Virtualize Tab a Options General Issue Summary Core App Lists Platforms Upgrade Services Security Report Costs Duplicates Browser Compatibility Add In Repackaging Options Dashboard Virtualize 4 Virtualization settings Virtualization Technology Appv v Version 46 SP1 Windows 7 64 Bit v Apply Package Naming Mask Example Filename f FILENAME F Manufacturer m MANUFACTURER IM Product Name 9n PRODUCT NAME N Product Version v 2 Select the relevant item in the Virtualization Technology dropdown 160 11 Virtualizing Packages Quest ChangeBASE 5 3 User Gu
74. 16 24 Start Load 53183c5b 77b7 46b0 aef6 6f3eeb7c77 1f Package Loader Identify load type 39860 11 16 24 Convert It Load Type Local Package Loader Identify load type 39860 11 16 24 Preloader chMsiConverterBase Establish Preloader 39752 11 16 25 Preloader Initialised Start A Preloader 39924 11 16 39 Scanning Table msi_Validation 423 Row s Load MSI Tables 45792 11 16 40 Scanning Table msiAction 0 Row s Load MSI Tables 45896 11 16 40 Scanning Table msiActionText 62 Row s Load MSI Tables 45920 11 16 40 Scanning Table msiAdminExecuteSequence 8 Row s Load MSI Tables 45944 11 16 40 Scanning Table msiAdminUISequence 10 Row s Load MSI Tables 45948 11 16 40 Scanning Table msiAdvtExecuteSequence 14 Row s Load MSI Tables 45960 11 16 40 Scanning Table msiAdvtUISequence 0 Row s Load MSI Tables 45964 L Show Errors Only The log can be filtered by clicking Show Error Only Review the error to assess whether further investigation is required 5 3 Repackaging Overview File formats that cannot be read directly by ChangeBASE must be repackaged In this scenario a pre configured Virtual Machine will be controlled by ChangeBASE The software being imported will be installed on the Virtual Machine while ChangeBASE monitors the changes which occur during the installation These changes will be used to create an MSI The MSIs produced as part of this process are suitable for installation in most
75. 3 User Guide 2 Click the Dashboard Tab wa Options a General issue Summary Core App Lists Platforms Upgrade Services Security Report Costs Duplicates Browser Compatibility Add in Repackaging Options Status Dashboard version 1 0 1 9 curently installed and is enabled Uninstall Disable Registered with IIS server REMFY8YGV1 Dashboard REMFY8YGV1 Dashboard Executive Summary Platform 1 Platform 2 Platform 3 Platform 4 Title Executive Summary ToolTip Windows 7 x64 with App V Report groups to include Office 2010 V Virtualisation App V Virtualisation Citrix XenApp hosted and MS RDS V Windows 64 bit V Windows 7 Windows 8 TopSissues ROI Progress Summary Target Date 27 Nov 2012 Target Packages 0 3 From this screen there are a variety of options that can be configured e Executive Summary and Platform Groups The Executive Summary is displayed on the Dashboard home screen whilst the Platform Groups are displayed on the Executive Details page refer to 7 2 3 Executive Detail You can do the following Set up titles for each pie chart Set up tool tips for each pie chart Select which report groups will be included in the Executive Summary and Platform Groups Platform Groups can also be excluded from Dashboard by checking Hide this chart aa Options ES
76. 4 12 ChangeBASE Options Quest ChangeBASE 5 3 User Guide 12 10 Browser Compatibility Tab tli Options es General Issue Summary Core App Lists Platforms Upgrade Services Security Report Costs Duplicates Browser Compatibility Add in Repackaging Options Dashboard Virtualize Static Web Search Url Count Threshold 500 Static Web Search Time Limit minutes Domain Filter Url domain amp associated sub domains hd Web Analysis Mode Web Based Applications Only v OK Apply Cancel Static Web Search Url Count Threshold Controls how many URLs will be clicked by the web crawler The default limit is 500 However if you are importing large websites you are advised to keep well below this limit otherwise the performance of ChangeBASE may be adversely affected Static Web Search Time Limit minutes Controls how long the web crawler will spend capturing web data on each website Domain Filter e Url domain amp associated sub domains Unlimited web crawling throughout the URL domain and sub domains e Url sub domain only Limited to the URL sub domain No sub domains of the URL will be crawled For example only http www bbc co uk will be crawled not links going to http www bbc co uk news Web Analysis Mode e Always Analyze ChangeBASE will import web based content from every loaded item MSI files OS image CSS files HTML files This
77. 5 Amber Report UAC File Header Analysis 0 Red 1 Amber Package Overrides Return to Application Status Back to top of Report At the end of each section there is a Back to top of Report link that will reposition the report back to the top When selecting a multi package report from the Application Settings screen by clicking on the Reporting Group column title there will be an extra section at the top listing all the Packages in the report This gives the ability to go directly to an individual package by clicking on the link for example 136 7 Dashboard Quest ChangeBASE 5 3 User Guide Return to Application Status Packages Acrobat Adobe Reader 7 0 advinst msi Codebook for AutoCAD _ 2004 _7 2_P1 1_Global msi EASE 4 0_ICE64 msi_ 128162935948750000_msi Hummingbird Exceed Mapinfo_Professional_7 5_P1 0 GLOBAL msi Nokia_PC_Suite msi Nuance PDF Professional 5 msi Reuters Messaging 7 Samsung PC Studio PC Sync_msi WINZIP112 MSl Wix35_msi Note also that there is an extra link back to the top of each Package at the bottom of each section of this report Return to Application Status Back to top of Report Back to top of Package At the top right of the report there is a Print icon which opens a new Tab or page and displays a more printer friendly version of the Report This can then be printed using the browser s printing capability The printer friendly version removes all the links 7 2 6 ROI Calculation D
78. 55 11 1 Virtualization Compatibility Matri srren etd ice seee ceeds 155 TEZ CONMNOQUEATIOMN sects A Lt ah NDS MS oa tae ots 156 11 2 1 Virtual Machine Setup General cccccccccccecceccecceeseesetececeeseeseesesseseeseeseeseeas 156 11 2 2 Virtual Machine Setup Symantec Workspace Virtualization ccccccccceeeee 158 11 2 3 Virtual Machine Setup Microsoft App V and App V 4 6 SP1 ccccccccceeeeeee 158 11 2 3 1 Avoid Balloon Tips by resetting the Screen Resolution or disabling the Tips 159 11 2 4 Virtual Machine Setup Citrix XenApp Streaming Profiler 6 5 ccccccc0000 160 11 2 5 Virtual Machine Setup VMware ThinApp 1 c1cccccececceececseeecneseeseeseeseseeees 160 11 2 6 ChangeBASE Configuration cccccccccccccecceccecsecceesecsecseceeseeseeseeseeseseeseeseeseras 160 11 2 7 Advanced Settings App V 4 6 SP1 ccccccccecceccsccscecceceesensessussuccscceceuseesenseces 163 11 2 8 Advanced Settings App V 5 0 cisccr vec cecete ces vues edeeeitebe ped eel abeneidame ees eiiaetnces 165 Loc OW LO Nua P ACKAGCS fcce sete aden ccen cncceccune cc EEEE EEEE de me dese EATER 166 11 3 1 Package Virtualization One virtual package per MSI ccccccccceccecseeseeeeees 166 11 3 2 Package Virtualization One virtual package from multiple MSIS 166 11 3 3 Package Virtualization Virtualizing EXEs and manual configuration 167 11 3 4 Package Virtualization Using a Manifest file
79. 85 86 93 Database Name 77 Options 77 Package Folder 77 Package ID 77 Package Language 77 247 Index Package Manufacturer 77 Package Name 77 Package Version 77 Server Name 77 Security Tab 178 180 Select ApplDs 195 sequences xml 211 Server Components 19 20 34 54 Server Timeout 175 Shared Dependencies Rollup 197 Simple Calculations 138 140 141 Snapshot 97 99 105 158 160 162 170 175 179 198 204 206 Software Requirements Local Database Setup 18 21 232 Source Capture 73 74 179 205 Source Folders Loading for Browser Compatibility 230 Space Requirements Database 24 SQL Enterprise 18 21 26 42 SQL Express 21 42 SQL Permissions 27 SQL Security 27 28 32 43 233 SQL Server 18 20 21 23 24 26 33 43 44 49 51 52 79 175 187 232 233 64 bit 24 Authentication 28 Management Studio 27 52 SQL Setup 17 26 32 42 43 51 57 58 Dashboard 31 Multi User Environment 20 SQL Standard 42 SQLCompression dll 176 SQL related Troubleshooting 49 Stored Procedures 27 Execute 27 Summary Report Examples 119 Swapping Licenses 40 SWV 12 14 symantec Wise Composer 22 158 Symantec Workspace Virtualization 22 155 156 158 See SWV System Requirements 17 T Target Date 131 Target Environment 110 Target Packages 131 tempDB 27 31 Terminal Services Deployment 24 ThinApp 12 14 22 110 155 156 160 171 Top 5 Issues 123 125 127 128 Top Five Issues
80. A 1BB0 11D0 81C3 0080C7A2EF7D Package Registry Level Issue CLSIDK8DDE622F 1BB0 11D0 81C3 0080C7A2EF7D Package Registry Level Issue CLSIDKCF94998B 9B83 47E0 A463 944A41422CBB Manual Fix Manual Fix Required Package Registry Level Issue CLSIDKF199F8A2 029B 4E07 9983 23173CBE582F DEP NX Compatibility Analysis v1 06 IE7 Deprecated API Analysis v1 19 IE7 Deprecated Feature Analysis v1 11 IE7 Secure Object API Analysis v1 17 Manual Fix Manual Fix Required Manual Fix Manual Fix Required Manual Fix Manual Fix Required Manual Fix Manual Fix Required tm Internet Explorer 8 Presentation Compatibility Application Protocol Detection Analysis v1 10 Case Sensitivity Analysis v1 06 Character Encoding Alias Analysis v1 09 Code Page Detection Analysis v1 16 Deprecated Functions Analysis v1 15 ECMA Script Support Analysis v1 10 ECMA Script Support Analysis JSON v1 03 File Name Restriction Analysis v1 07 IE8 Deprecated Protocol Analysis v1 09 larra Ar A smir ined NE 121 6 Assessing Packages and Viewing Results Quest ChangeBASE 5 3 User Guide 6 8 6 AppID Expand and Collapse All of the reports shown above allow you to click on an AppID heading to toggle the visibility of the packages reports report groups belonging to that AppID You can also toggle the visibility of all packages reports report groups belong to all AppIDs by clicking on the Show AIll Hide All labels at the
81. Adobe_Acrobat_5 05_All_ ENG_V3 0 Adobe_Acrobat_5 05_All_ENG_V3 0 msi advinst 6 4 Caphyon G Quest AOK Advanced Course Lab Sample Packages advinstiadvinst msi Codebook_for_AutoCAD_2004_7 2_P1 1_Global 1 0 Talon Systems G Quest AOK Advanced Course Lab Sample Packages Codebook_for_AutoCAD_2004_7 2_P1 1_Global Codebook_for_AutoCAD_2004_7 2_P1 1_Global msi EASE 4 0_ICE64 msi_ 128162935948750000 i Renkus Heinz Inc G Quest AOK Advanced Course Lab Sample Packages EASE 4 0_ICE64 msi_ 128162935948750000 EASE 4 0_ICE64 msi_ 128162935948750000 msi Hummingbird Exceed Hummingbird G Quest AOK Advanced Course Lab Sample Packages Hummingbird Ltd Exceed Hummingbird Exceed msi Mapinfo_Professional_7 5_P1 0_GLOBAL i Mapinfo G Quest AOK Advanced Course Lab Sample Packages Mapinfo_Professional_7 5_P1 0_GLOBAL Mapinfo_Professional_7 5_P1 0_GLOBAL msi Nokia_PC_Suite 6 86 9 0 Nokia G Quest AOK Advanced Course Lab Sample Packages Nokia_PC_Suite Nokia_PC_Suite msi Nuance PDF Professional 5 5 00 3285 Nuance G Quest AOK Advanced Course Lab Sample Packages Nuance PDF Professional Communications 5 Nuance PDF Professional 5 msi Inc Samsung PC Studio PC Sync 21 00 003 Samsung G Quest AOK Advanced Course Lab Sample Packages Samsung PC Studio PC Sync Samsung PC Studio PC Sync msi WINZIP 112 11 2 8094 WinZip G Quest AOK Advanced Course Lab Sample Packages WINZIP112 WINZIP112 MSI Computing S
82. Backups and Restores of the repackaging filters are possible using the Create Backup and Restore Backup buttons 5 4 4 Template msi When repackaging ChangeBASE creates an MSI based on a default MSI template If you prefer to apply your own standards you can supply your own MSI template To do so copy your MSI template as template msi to the Program Files folder Quest Software ChangeBASE AddIn 5 5 The Repackaging Process Using any of the methods described in 5 2 Import Methods drag and drop import the legacy installers so that each appears as a yellow folder icon on the Workbench For each application to be repackaged proceed as follows 1 Right click on the application and select Repackaging Configuration Delete Save Retrieve Reports Select App IDs Open Containing Folder Virtualize from manifest Expand Collapse The following configuration settings are displayed 101 5 Importing Packages gi Repackaging Configuration Executable Filename F _ChangeBASE exeleBookstudiol Setup exe Command Line Arguments Support Files None Other files in folder and sub folders Target Virtual Machine Machine Name A Spec c haned Machine Properties Name Value Quest ChangeBASE 5 3 User Guide Auto Complete Enabled i Manufacturer e Studio Tools Product Name eBook Studio Product Version 512 2 Edit these settings as needed It is strongly recommended that you always update the ProductName
83. C anena asd ses ee aaa seen gate eee phe ae Ren Gee esa geass 24 2 1 7 Deployment to Remote Desktop Services Terminal Services 1cccccscseeneeeees 24 2 1 8 Database Backup REQUITEIMENUS ccccccccsecseceeceececcecseeseeseseeneeseeseeseeaeeaeseeseeseees 25 2 1 9 Recommended Configuration for Multi User Installations ccccccccccceecneeeeeees 25 ZRII FROCUIFCINICIIG areae e dian cate A N tensa E A tenes een REA 25 Z TIZA TOCCSS ODI ZAU OM sz aaa E aed hod E AA 26 2A US SIO eaa REEE EREEREER SEEE EERE REEE eE E EEE 26 2 2 1 Assigning Permissions using SQL Server Management Studlo 0 000 27 2 2 2 SQL Setup for a Multi User ENvirOnMent cccccccccseccecceecnecsecceeceecsessessecneeneess 31 2 2 2 1 SQL Setup using Windows AUth NtiCatiONn ccccccseseecsneeecsaneeeesaneeessneeessanenessaaeseees 32 22 22 SQL Setup using a SQL LOGIN sirri vec ttesscaeddcoreta vies e a aa E a 32 2 3 InStalling CNanGG BASE csrrssn a ee eee eee 33 cl POPS CA AU ON eiin carts carats sae A samme sen sane aa eeiaesaauaaaaaceesemnacseacavecsaacneaacrea 33 Ze MVS UAW AG OUD so sone iss cra Gass ss ee Se cra Suse Sn ures es Pes me ncaa cach coat enct ae sheesh eecnceneemeees 33 ZA VIO GN AGING CIN SPE saa a Lato 36 3 Basi CONTIGUEALION sasae RE EAER 37 3 rhicensno CDUOMS mymp a a ETa ARA TETA AER 37 Contents Quest ChangeBASE 5 3 User Guide 3 1 FOI LAC OWNS C9 ssiri aiani dat estates eu AEEA EAEE pia 37 3 1 2 Offl
84. CAB This Fix type adds a specified merge module to the target MSI One example of a Plugin that employs this Fix type is the Windows Help File Platform Integrity Plugin 5 ISOLATECONEFLICT This Fix type is used by the Core Application Scan CAS and is used to generate a specially formatted XML file and Manifest to deliver the required COM registry information and Side by Side Assembly SxS information to fully isolate a conflict COM object in a target MSI Installer package RAG Status The RAG status field derived from Red Amber and Green is used to denote what type and severity of errors should be raised with the matching rule data Green is used for informational results Amber for non critical generally Fixable issues and Red is employed to signify packages that will experience serious functionality and compatibility issues on the target Platform RuleSource This optional text field is used to describe the source from which the rules originate For example certain Platform Integrity rule sets are derived from Microsoft documentation and other Plugin rule and data sets are derived from customer data Value Set This area is the heart of the Plugin and contains the raw rule data required to report and Fix package issues within ChangeBASE This section will become active once you have selected a table i e the File table from the Target Table drop down box and at least one column from the Target Columns drop down box and added it
85. Check each database and associate it with the required permissions in the Database role membership panel As a minimum you must have db_datareader and db_datawriter selected Close the Properties window and collapse the Security tree 3 Assign Execute Permissions to each database as follows a b Click the New Query button at the top of the screen Select the required ChangeBASE or CSC database from the drop down menu below the New Query button e g FAN File Edt View Query Debug Tools Window Community Help rego amp oF i tug emo A iad FM ADIT SS ee A Object Explorer Comect 9 He Y OG amp yh localhost eqlexprest SQL Server 10 50 1617 PROC bra ay Databases a Gy Synem Databases a g AQKCSCManager a O Database Diagrams a Qa Tables m G Vaa E LJ Synonyms m Ly Prograrmemnabelity aJ O Sentit Broker Important It is vital that the correct database is selected before you proceed 30 2 Installation Quest ChangeBASE 5 3 User Guide c Assign permissions to the selected database using the following command grant execute to lt Database User gt e g PROD QDL RD ChangeBASE in the above example Important The lt Database User gt Is case sensitive and the double quotes are mandatory Note For Windows Authentication the domain PROD in the above example needs to be specified d Click Execute on the toolbar e Either repeat from step 3a for the next datab
86. Cost Total Applications Sum of ChangeBASE Days Manual Cost ChangeBASE Cost Sum of Days Saved Manual Cost ChangeBASE Cost 100 142 8 The Top Five Issues Explained Quest ChangeBASE 5 3 User Guide 8 The Top Five Issues Explained ChangeBASE includes Next Steps documentation for a number of the reports These can be accessed via the drill down reports in Dashboard refer to 7 2 2 2 Top 5 Issues The Next Steps documents for the top five identified issues are shown below e 8 1 Custom Action Security e 8 2 Legacy Help Files e 8 3 Hard coded File References e 8 4 UAC File Headers e 8 5 Legacy Control Panel Applets 8 1 Custom Action Security 1 Ensure that User Account Control UAC is enabled 2 Run the installation 3 The install will have either failed with an error message or else silently The following message is typical for a related installation error ie ClarityActivex Installer Information Error 1904 Module C Program Files Clarity Systems ClarityActivex CPMActivex ocx failed to register HRESULT 214 72204 73 Contact your support personnel 4 lf you received no error message then you should check the following e Start by looking at the name of the custom action in the ChangeBASE error message e lf it is related to uninstallation attempt to remove the software e If it is related to rollback then you should try installing again and selecting Cancel just before it complete
87. Delete Package Delete Report Edit MSI Package Orca Edit Plugins Plugin Editor Extract Cab Files Fix Package Load Web Site Quest ChangeBASE 5 3 User Guide DESCRIPTION Allows a package to be added as a Middleware check whereby the Files and Registry keys within the package will be verified within the other packages Allows the import of WIM images or SOE capture files Allows packages to be dragged and dropped or imported via the Packages gt Browse option Allows users to right click packages within the Packages section and add them to any Core App List that has been previously created via Options gt Core App Lists Allows the creation of Views Enables support for the importing of App V SFT files for reporting purposes Enables the use of the right click Repackaging gt Legacy Package Capture option Refer to 5 2 1 2 Dragging and Dropping Folders onto ChangeBASE Enables the use of the right click Repackaging gt Source Capture option Refer to 5 2 1 2 Dragging and Dropping Folders onto ChangeBASE Copies the Issue description so that it can be pasted into a report or other document Enables users to create a Core Apps Group within the Options menu add packages to the Group and run the Core App Scan and any associated Fixing Allows users to generate the underlying structure of a Readme file as well as utilize the Readme function from the right click of a package Enables users to creat
88. E 5 3 User Guide 13 2 19 Expand Collapse The Expand and Collapse options are used to expand or collapse the package tree view At this level expanding the tree shows details of the reports that generated Amber or Red warnings 13 3 Importing Operating System Images ChangeBASE supports the conflict analysis of packages against one another as well as against the Operating System Image In order to test your packages against an Operating system Snapshot you can load Operating System images into ChangeBASE via SOE capture files generated by Wise Package Studio or most commonly via WIM Windows Imaging Format images WIM files are the modern standard for storing and manipulating Operating System images prior to deployment The ChangeBASE supports importing WIM files so that the contents can be examined Once the WIM has been loaded into ChangeBASE you can use it as part of the Core Application Scan functionality to test for conflicts with packages 13 3 1 Gold Images Loading Operating Systems into ChangeBASE takes a very long time as information has to be read from tens of thousands of files It is highly recommended that the Operating System and the absolute minimum of core packages are included in the Operating System Any package that you intend to load and manage separately should be added to ChangeBASE separately and not included in the WIM 13 3 2 Limitations Images larger than 5Gb or containing more than 100 000 files
89. E 5 3 User Guide CALCULATION Number of Applications Medium percentage Testing Medium hours effort Average Hourly Rate Number of Applications Medium percentage Testing Medium hours effort 8 Number of Applications Medium percentage ChangeBASE Medium Hourly Cost Manual Days ChangeBASE Days Manual Days Days Saved 100 CALCULATION Number of Applications Complex percentage Testing Complex hours effort Average Hourly Rate Number of Applications Complex percentage Testing Complex hours effort 8 Number of Applications Complex percentage ChangeBASE Complex Hourly Cost Manual Days ChangeBASE Days Manual Days Days Saved 100 CALCULATION Sum of Manual Costs Sum of Manual Days ChangeBASE Cost Total Applications Sum of ChangeBASE Days Manual Cost ChangeBASE Cost Sum of Days Saved Manual Cost ChangeBASE Cost 100 139 7 Dashboard 7 2 6 2 Remediation Simple Calculations FIELD Manual Cost Manual Days ChangeBASE Days Days Saved Percent Saved Medium Calculations FIELD Manual Cost Manual Days ChangeBASE Days Days Saved Percent Saved Complex Calculations FIELD Manual Cost Manual Days ChangeBASE Days Days Saved Percent Saved Quest ChangeBASE 5 3 User Guide CALCULATION Number of Applications Simple percentage Remediation Simple hours effort Average Hourly Rate Number of Applications
90. E 5 3 User Guide e Auto Fix for Virtual Platforms o Evaluate packages for compatibility issues with target virtual platforms and repair them in just a few simple steps e Automate Corporate Packaging Standards o Test for issues related to in house and packaging MSI standards and apply automated fixes to ensure compliance Develop and customize QA checks and related remedies in order to achieve significant time and cost savings compared to manual checking e Package Virtualization o Automatically virtualize your packages Save time avoid errors and meet demand more quickly than with manual conversions 1 3 3 Automate amp Accelerate Compatibility Testing for Internet Browsers Many packages which are used to handle daily business tasks are web based or accessed via a browser When it is time to upgrade to a new browser compatibility issues may prevent a package s content or interface from being displayed correctly or at worst prevent a package from working at all ChangeBASE s unique automated solution provides a quick easy and cost saving alternative to the manual compatibility testing of web packages and websites whether on the internet or on an intranet or extranet With the extensive range of automated compatibility checks included you can ensure that your browser upgrade is deployed without incident or unnecessary burden on IT resources The detailed reports help you to prioritize remediation so that issues with the
91. Excel with the top row emboldened and the column widths adjusted accordingly 82 5 Importing Packages Quest ChangeBASE 5 3 User Guide B H 2 Q i J Action Server Id Package Id Program Name iewName AppiD Manufacturer Package Name Version nguage Package Source Path Command Line Valid actions A Add to ChangeBASE R Reset imported flag V change ViewName X Reset default ViewName only applies prior to running ChangeBASE import or a combination E G RA means reset and add AppiDs can be entered into the appropriate column Multiple AppiDs can be entered separate a h QMXOO00E Install ase 1 QMXDEMOLAB NUnit NUnit 2 5 5 QMXDEMOLAB NUnit NUnit 2 5 5 QMXDEMOLAB NUnit NUNnitBAT 5 2 2 QMXDEMOLAB 1 QMX0000C msipro You can mark selected packages to be processed upon import by including the relevant processing code against each package in the Action column There are four available processing codes Add the package program to ChangeBASE The package is not imported just added which is for example the equivalent of dragging an MSI onto ChangeBASE you would still have to select the package and click Import in ChangeBASE to process it Normally if an SCCM package program has already been added to ChangeBASE it cannot be re added unless the Import flag is reset thereby preventing the accidental reprocessing of packages that have already been added Adding the R code resets this Import flag and allows the SCCM to re add
92. I optional Quest ChangeBASE 5 3 User Guide DESCRIPTION This is the time out value for the Virtual Machine The time is set in minutes A value of 15 the default if not set for example will mean that ChangeBASE will terminate the Virtual Machine after 15 minutes This field should be left blank It should only be used under the instruction of the ChangeBASE support team for debugging purposes This value should be set to 1 if ChangeBASE has issues reverting to the Snapshot Checkpoint 5 4 2 3 VMware Workstation 9 td Update Machine Config Type VMwareWorkstation Name XP32 Workstation 9 Setting Type WMX Usemame Fassword SystemFolderPath File MonitorinstallFolder Snapshot Name Timeout RaisePrionty Revert To SnapshotLauncha Ul V Enabled TE JE CAUser CETDocumentsWitual Machines XPF IAP 32 vi Browse a The configuration settings are as follows SETTING Type mandatory Name mandatory Enabled mandatory VMX mandatory DESCRIPTION VMwareWorkstation A unique name for this configuration Allows you to enable or disable the Virtual Machine For VMware Workstation the field is for the path to the Virtual Machine s VMX file e g E VM XPx86_VMware XPx86_VMware vmx Quotes are not needed even if spaces exist in the path These settings can be found in the configuration settings of your Virtual Machine The VM Configuration Tab is located on the VMwareServer Contr
93. IB DLL contained in Acrobat When the Exclude Operating System Files option is checked Operating System files such as KERNELL32 DLL for example are excluded from the results thus greatly reducing and simplifying the data returned This filter works by loading an Operating System Snapshot such as a SOE file and simply excluding all of the files contained within it from the result sets You can choose your own Snapshot by selecting it from the Operating System Snapshot dropdown list Context Menu options are available such that you can right click on a package within the middle and bottom tree and select View Dependencies to open a new Dependency Viewer window for that package 13 2 6 View Log View Log displays the path and the name of the MSI file that is being imported and or fixed It shows the version of the database against which the import or fixes are being run and then shows a step by step log of all importing fixing actions that take place against the package 198 13 Advanced Usage Quest ChangeBASE 5 3 User Guide ul Package Log C Users jgreen Downloads Adobe Captivate 5 5 payloads Microsoft_VC80_MFCLOC_x86 Microsoft_VC80_MFCLOC_x86 msi Create o E Time Details 13 05 14 Preloader cbMsiConverterBase Establish Preloader 13 05 14 Start Load dbfb8392 9e5b 428 1 b14a d40a81ic2bee Package Loader Identify load type 13 05 14 Convert It Load Type Local Package Loader Identify load type 13
94. L From here you can use the browser s printing capability to print the report 135 7 Dashboard Quest ChangeBASE 5 3 User Guide 7 2 5 Package Overview Report The Package Overview Report presents a web based report of the Package details Unlike previous screens this displays the details in a scrolling report format This allows you to see more details in the view rather than having to show the information on multiple pages Navigation through the report can be done either by scrolling the report or by use of the in page links These are highlighted by the blue or purple underlined text You can return to the Application Status page at any time by pressing the Return to Application Status links throughout the report At the top of each package header is the Package Contents This tabbed list provides an easy way of going directly to a section of the report Once clicked the Report will reposition itself at the location of that section ChangeBASE Dashboard Package Overview Report Package Summary of Adobe Reader 7 0 against Windows 7 x64 with natively installed applications Return to Application Status Date 24 Feb 2012 Adobe Reader 7 0 Package Contents Package Details Property Information Transforms Convert amp Import Details Low severity issues High severity issues Package History Package Status RAG Summary Package Status RAG Summary By Report Group Windows 7 Report Custom Action Security Scan 0 Red
95. L stored procedures or hard coded values and properties This is the exception as most Plugins will access the Rules section of the database for at least part of any reporting or remediation process The Rules section is available from the Rules Tab displayed when editing Report metadata The Rules Tab is intended to provide an intuitive User Interface UI to the ChangeBASE database while mimicking some of the functionality and database structures of the MSI Installer database To make full use of the Rules Tab included within the Report Generator you should be familiar with the MSI Installer table structures and database schema 218 14 Writing Custom Plugins Quest ChangeBASE 5 3 User Guide aii Update GINA Deprec poke Details Rules Messages Target Columns Target Table APINames msiFile Fix Type Empty RAG Status Red Rule Source Value Set APIName WheActivate UserShell WheDisconnect Notify Wh DisplayLockedNotice WheDisplay SAS Notice WheDisplay Status Message WheGetConsole SwitchCredentials Wheset Status Message Whelnitialize WhelsLockOk WhelsLogotfOk WhkLoggedOnSAs WheLoggedOutSAS x p p Target Table The Target Table drop down box contains a list of all imported tables that are available to query within the database For example to view or add rules that pertain to the APINames table such as Filenames select the APIName option from this box Target Column
96. M This enables you to browse for packages and programs that are located in a SCCM server or database 60 4 ChangeBASE User Interface Quest ChangeBASE 5 3 User Guide Import This imports packages and offline Plugins into the database to allow automated assessment CSV Import This is a more automated way to load packages You prepare a CSV file from a supplied template and provide the details of the packages in this file ChangeBASE will read the CSV file and load all of the listed packages Assess This assesses the packages against the selected report groups Fix This creates fixes for packages where automated fixing is available Virtualize This converts MSI packages to a Virtual format 4 2 Reports Panel Refresh Results This is used to refresh the results tree Clear Results This is used to clear any reporting results from the ChangeBASE interface Assessment Results This allows you to access the HTML reports showing assessment results You can access several different reports to analyze the status of the packaging project It is also possible to export the results to CSV format for customized reports and data filtering 4 3 Summary Panel Packages The number of packages currently imported into the database Reports The number of reports Plugins currently imported into the database Rules The total number of logic checks within all reports Plugins imported into the current database Scanned Rules The number
97. Monitorinstall Folder HostName ESA 1svr home Host Usemame user HostPassword Sarees Snapshot Name Timeout Raise Pronty Revert To Snapshot LaunchG Note You need to install the latest VIX libraries refer to 5 4 1 Virtual Machine Setup You should also note that you cannot connect from a machine on which you have already used VMware Workstation The configuration settings are as follows SETTING DESCRIPTION Type VMWareServer ESX mandatory Name A unique name for this configuration mandatory Enabled Allows you to enable or disable the Virtual Machine mandatory VMX The name of the Virtual Machine on the ESXi server mandatory Username The username for the Virtual Machine mandatory Password The password for the Virtual Machine mandatory SystemFolderPath This allows you to specify a non standard path to the Windows optional system folder This field can be left empty if the Virtual Machine s system folder is already the default of C Windows System32 95 5 Importing Packages SETTING FileMonitorInstallFolder optional HostName mandatory Host Username mandatory Host Password mandatory SnapshotName mandatory TimeOut optional RaisePriority optional RevertT oSnapshot LaunchGuUI optional 5 4 2 2 Hyper V wE Update Machine Config Type Hyper V Name Hyper V on SVR2012 Setting Type Name APSA Usemame VMuser Password System FolderPath
98. Quest ChangeBASE 5 3 User Guide E QUEST SOFTWARE 2013 Quest Software 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 Quest Software Inc If you have any questions regarding your potential use of this material contact Quest Software World Headquarters LEGAL Dept 5 Polaris Way Aliso Viejo CA 92656 www quest com Email legal quest com Refer to our Web site www quest com for regional and international office information TRADEMARKS Quest Quest Software and the Quest Software logo are trademarks and registered trademarks of Quest Software Inc For a complete list of Quest Software s trademarks please see http www quest com legal trademark information aspx Other trademarks and registered trademarks are property of their respective owners DISCLAIMER The information in this document is provided in connection with Quest products No license express or implied by estoppel or otherwise to any intellectual property right is granted
99. ST TRAFFIC CSCWEB m Select ChangeBASE Database Take backup localhost sqlexpress CB JOHNTEST X Delete after import Canca If the Process uploaded files option is greyed out refer to 15 8 3 Process Uploaded Files option greyed out Select the required ChangeBASE database from the drop down list Check the files that you wish to import into ChangeBASE 240 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide If you wish the files to be backed up prior to import check the Take backup box If you wish the files to be removed following import check the Delete after import box d Click OK e The files are imported into ChangeBASE Workbench Note Depending on the size of the imported files this may take some time You will be informed once processing is complete f If you have the ChangeBASE Workbench open click Refresh Results in the Reports Panel and the files will appear in the Packages tree of the Portfolio Summary If ChangeBASE is not running open it and the files will be displayed as available for reporting 15 7 Importing and Assessing Web Files against Browser Plugins Once web files has been successfully imported into ChangeBASE then 1 Goto the Reports tree refer to 4 5 Portfolio Summary and select the reports for the relevant browser version for example Internet 10 Presentation Compatibility reports Click Assess on the Packages Panel Following the assessm
100. Server 2008 2012 Windows Server 2008 2012 Windows Server 2008 2012 Windows Server 2008 2012 Windows Server 2008 2012 Windows Server 2008 2012 Non Supported Drivers 32 bit Quest ChangeBASE 5 3 User Guide PLUGIN FIXING EFFORT HOURS OS Non Accessible Registry Settings Analysis Portable Device Driver Update Analysis session 0 Isolation Analysis TCP IP WFP IPX SPX Scan UAC File Header Analysis Windows File Library Feature Analysis Active Directory GPO Settings Analysis Common Dialog Compatibility Analysis Custom Action Security Scan Deprecated API Analysis GINA Deprecated Component Hard Coded File References scan Install Logic Scan IPv6 Networking Scan IPv6 Strong Host Check Legacy Control Panel Applet scan Legacy Help File Scan Microsoft Message Queue Analysis Named Pipe Hardening Analysis Nested Install Scan 1 0 5 0 5 0 01 0 01 0 01 NO NO 0 01 0 01 183 12 ChangeBASE Options REPORT GROUP Quest ChangeBASE 5 3 User Guide PLUGIN FIXING EFFORT HOURS Windows Server 2008 2012 Windows Server 2008 2012 Windows Server 2008 2012 Windows Server 2008 2012 Windows Server 2008 2012 Windows Server 2008 2012 Windows Server 2008 2012 Windows Server 2008 2012 NETDDE Deprecated Component Scan Non Supported Drivers Server and 64 bit OS Non Accessible Registry Settings Analysis Portable Device Driver Updat
101. Server 0 9 41 QMX00007 failed Eror accessing source file QMXDEMOLAB CS SoftwarePackages FileZilla Server 0 9 41 filezilla_server 0_9 Failed to access required files 1 of 1 completed 0 successful 1 failed ok On completion successful or otherwise you can copy the contents of the progress list to the clipboard by clicking the Copy button in the bottom right of the screen This copied information can then be pasted into another application such as Notepad or Microsoft Word After the packages programs have been added to ChangeBASE they must be imported in the same way as packages programs added in other ways i e a If an application can be imported directly click on Import in the Packages Panel to load the associated package s into the database Or b If an application is to be repackaged proceed as in 5 5 The Repackaging Process 85 5 Importing Packages Quest ChangeBASE 5 3 User Guide Once an SCCM package has been imported it will appear automatically under the ChangeBASE SCCM view grouped according to the SCCM Options e g f wud ChangeBASE ove ChangeBASE Lo e e Ultimate For internal use by the ChangeBASE Test Team only es Reports New Project Wizard Packages a a AppiD s Browse with SCCM V Reports Impo V Packages CSV Import sccm QMXDEMOLAB HiJackThis 7 HiJackThis c temp QMXDEMOLAB QMX00006 hijac OMXDEMOLAB New Rel
102. This approach means that only the latest versions of software are being submitted to the migration project Once the number of packages has been defined the amount of project resources can also be planned Import The list of packages collated during the rationalization phase should be imported into ChangeBASE in order to test compatibility with the target environment Assess The packages should be assessed against the required specific target environment checks Armed with the compatibility results packages can undergo another round of rationalization to ensure that effort is only spent on packages that will work in the target environment Incompatible packages should be upgraded redeveloped or delivered to you through an alternative method such as the Quest vWorkspace solution Using the assessment results the project resource schedule can now also be tweaked as a better understanding will exist of the complexity of the packages requiring migration Fix ChangeBASE assesses packages according to a Red Amber Green RAG system refer to 1 2 1 Flowchart showing the Key Phases ChangeBASE can automatically remediate most identified Amber issues by means of MST Transform files The underlying packages and installations are never modified directly ChangeBASE can also fix compatibility issues through the use of additional files such as Manifests and runtimes to allow packages to run correctly on the new Platform By using Transform files subse
103. User Interface Quest ChangeBASE 5 3 User Guide The AppID s column in the main package tree shows the AppIDs that have been assigned to packages separated by commas where there is more than one AppID associated with a package al ChangeBASE Ultimate x U D E amp Fiwcommet views Virtualisation App 8 Windows 64 bit i Hoag Windows 7 uv ackages F Adobe Acrobat 9 Pro You can order packages according to those that are associated with AppIDs by clicking the AppID s column header 4 7 1 AppID Maintenance To add new AppliDs to one or more packages or to maintain the existing IDs for one or more packages 1 Highlight the required package s hold down the lt Shift gt key to highlight a range of packages or the lt Ctrl gt key to make individual selections 2 Right click to access the context menu 3 Click Select App IDs m ChangeBASE totas aannam Quest Ultimate lere ChangeBASE Reports New Project Wizard E Views Virtualisation App V Window s 64 bit Windows 7 kages Adobe Acrobat 9 Pro S Delete Sgar anan Goad E o 8800ga assyst Enterprise 8 0 Dragon NaturallySpeaking 10 Elements 9 Organizer FileZilla Y in32 FrontRange Solutions Goldmine 5 5 HotDocs 2008 Professional Edition HotDocs 2008 Professional Edition Hyperion Smart View for Office InstEd 1 5 13 24 Log Parser 2 2 Save Retrieve Reports Select App IDs Che
104. VM Export Folder Quest ChangeBASE 5 3 User Guide DESCRIPTION If Hyper V is selected click Connect to open the connection properties window Then enter the NetBIOS name not localhost and not the FQDN Fully Qualified Domain Name of the server If you are running ChangeBASE on the Hyper V host or if ChangeBASE is on the same domain as the Hyper V host then you will not need to enter user credentials me Hyper V conmection properties Server inp Otherwise enter these when connecting remotely a8 Hyper V connection properties r E ey Sener skhyp Lsemame wokda ls If VMware Server ESX is selected enter the server name FQDN or IP address but not localhost followed by a username and password atid VMWare Serer ESX Centre connection properties Server ES 51svr Usemame user Once you are connected to the hypervisor a drop down list will be shown containing all the Virtual Machines registered with that hypervisor Select the required Virtual Machine The Snapshot that should be used for the sequencing This is the username for the Virtual Machine This is the password for the Virtual Machine Forces the Virtual Machine to be powered off when the conversion is complete The location on the host machine where the virtual packages should be created You should use a different folder for each of the virtual package formats to ensure that different packages are not copied into the same folder Additionally
105. and ProductVersion as these will be displayed in ChangeBASE SETTING Executable Filename Command Line Arguments Support Files DESCRIPTION This field will be populated automatically with the path to the installer file Specify any command line arguments This could enable a silent installation or some other installation setting ChangeBASE will attempt to determine these values automatically for certain EXE installers None Only the Executable Filename will be copied to the Virtual Machine Other files in folder and subfolders All files and subfolders in the same folder as the Executable Filename will be copied to the Virtual Machine 102 5 Importing Packages SETTING Auto Complete Enabled Target Virtual Machine Properties 3 If needed click the Advanced button ake Advanced Settings Msi Copy Filename Intermediate CAP Filename Launch Application Unrestricted Capture Quest ChangeBASE 5 3 User Guide DESCRIPTION With this option checked ChangeBASE will attempt to click on the buttons on the installation dialogs Next Finish etc to allow the installation to progress unattended Considerations e This option should only be enabled where a default installation is desired Where a custom installation is required i e where non default options will be selected during the installation Auto Complete should not be enabled and the import of the package will require
106. and select the database name To create a new database enter the required name Space characters can be used if desired Click Next Please select a Server and Database gaga ChangeBASE CREATE DATABASE Database Name Test Database 5 Now the Working Directory must be defined See 2 1 4 Working Directory for more information a Where a single client connects to the database a local Working Directory would be used so click the Browse button and locate it A typical path would be C ChangeBASE Working Test Database Then click Next 45 3 Basic Configuration Quest ChangeBASE 5 3 User Guide ai Please select a Server and Database ChangeBASE CREATE DATABASE Please specify a working directory for this database C Change BASE Working Test Database E Specify UNC Path b Where multiple clients connect to the same database a shared folder accessible through a UNC path is advisable In this event check the Specify UNC Path option and type in the UNC path to the Working Directory for example server01 ChangeBASE Working Test Database Then click Next gil Please select a Server and Database ChangeBASE CREATE DATABASE Please specify a working directory for this database Wserver1 Change BASE working Test Database Specify UNC Path Previous 46 3 Basic Configuration Quest ChangeBASE 5 3 User Guide 6 If anew database was specified at step 4 the database is created
107. and side of the screen The time taken to run the reports is based on the size and number of packages and on the complexity of the reports to be run 111 6 Assessing Packages and Viewing Results Quest ChangeBASE 5 3 User Guide Once the reports have been run an overview of the results is shown in the Portfolio Summary section as shown below v Packages te odin all IW Reuters Messaging 7 pI te W Acrobat ie oH ue H ha X a Ti oe W Adobe_Photoshop_Elements iy f H T Advanced Installer 6 4 id a TL z aap Sop W Apple Mobile Device Support W ChangeBase b P W iy ms Fal Codebook for Atoc AD 2004 iy f H W EASE T HOD Standalone v8 aati a H 7 le EL E ue 4 MW Hummingbird Exceed W JavatTht 6 Update 30 iy f HF W Microsoft Office Live Meeting 2007 a Lj W MapInfo Professional p te ly l HF W Windows Messenger 5 1 DB29585 a ce W MSXML 6 0 Parser Li W Nokia PE Suite oad odin are W W Nuance POF Professional 5 E ta F F F F le HE le l H W Samsung PC Studio PC Syne S BEE FREER ERRREERRBREEEE Th fir h hy ys ys ly l l l h l l l l i W SFT Encoder Enterprise Edition Trial iy f H Vvindes ip T winzip 11 2 Aii a ly l H Ce Ca CE CE CE CE Ca Ce CE Ee CE EE CE EEPE EE CE Ci Cp CH EH W Aspect Architect The issue
108. andatory Host Password mandatory SnapshotName mandatory Quest ChangeBASE 5 3 User Guide DESCRIPTION Hyper V A unique name for this configuration Allows you to enable or disable the Virtual Machine The exact name of the Virtual Machine that the repackaging process is to use as it appears in Hyper V Manager The username for the Virtual Machine The password for the Virtual Machine This allows you to specify a non standard path to the Windows system folder This field can be left empty if the Virtual Machine s system folder is already the default of C Windows System3z2 This is the folder on the Virtual Machine where the file monitor will be installed Ensure that the user specified has permissions to this folder If this field is left empty it will use the default path of C Program Files File Monitor The NetBIOS name for the Hyper V host not localhost e g mii Update Machine Config Type Hyper V Name Cbasexp Setting Type Name Usemame Password System FolderPath File MonitorinstallFolder Host Name Host Usemame Host Password OK Cancel Note Using a full DNS name or IP address is likely to result in failure The name used to log into the Hyper V Server The password for the Host Username The Snapshot Checkpoint name as it appears in Hyper V Manager oT 5 Importing Packages SETTING TimeOut optional RaisePriority optional RevertT oSnapshot LaunchGuU
109. angeBASE View History Checkin Re Import Add To Matching Analysis Create Issue Summary Report Extract Cabs From Msi Override All Issues Specify Overrides Views gement Apps gement Apps i is i is i ie i Bulk Issue Summary Expand Collapse Selecting the top option in the sub menu results in the behavior described in 13 2 8 2 Right clicking a Transform and selecting the bottom option results in the behavior described in 13 2 8 1 Right clicking a package without Transforms 201 13 Advanced Usage Quest ChangeBASE 5 3 User Guide 13 2 9 View History View History displays the import fix history showing who imported the selected package as well as any fixes that have been applied with accompanying timestamps e g wd Package History C Users jgreen Documents Training RealPlayer msi Package History Date Description 8 Import 12 02 2013 12 45 Imported Successfully green E Fix 13 03 2013 12 32 Applying fixes jgreen E lssue 13 03 2013 12 32 UAC File Header Issue muninst exe 2 Matches File Description ProductName E Issue 13 03 2013 12 32 UAC File Header Issue setup exe 5 Matches FileDescrption Filename IntemalName lssue 13 03 2013 12 32 Hard coded path reference found in Registry table C E lssue 13 03 2013 12 32 Hard coded path reference found in Registry table C EJ Issue 13 03 2013 12 32 File Table Data realplay HLP W Re import 13 03 2013 12 32 Imported Success
110. angeBASE it is always advisable to start with the Operating System and then work your way through the issues until you reach the package format There would be no benefit in fixing virtualization issues when the package was not compatible with the Operating System The above diagram explains how these different technologies are in fact dependent on each other It is a common misconception that virtualizing a package resolves any compatibility issues with the Operating System This is not the case Package virtualization is not a compatibility solution 113 6 Assessing Packages and Viewing Results Quest ChangeBASE 5 3 User Guide For example Virtualisation App Entrypoint Analysis EESE Cec Yio ap pe Mon Supported Drivers Streamed iF Mon Supported System Startup Settings shell Extension Detection Windows Service Detection Windows 64 bit 32 bit MameSpace Detection Mon Supported Drivers Server and 64bit 0 Window s 7 Install Logic Scan Mon Supported Drivers 32bit 05 Here we should initially analyze the Window 7 and Windows 64 bit issues If these can be resolved or overridden then we can progress to the App V issues 6 5 Viewing Results ChangeBASE Viewing the assessment results in ChangeBASE is quick and easy and a good place to start once the automated assessment is complete 6 5 1 Packages Tab The Packages Tab displays each package as an individual entity Where issues are ide
111. anifest file and adding it to the package To manually remediate this issue an application engineer would have to create an XML security manifest for each file identified as having a UAC issue Packages Status Package ISScript10 Msi RealPlayer Intranet Click Next Steps and refer to Chapter 8 The Top Five Issues Explained 7 2 2 3 Filtering In the upper right of the Executive Summary is a filter button 129 7 Dashboard Quest ChangeBASE 5 3 User Guide Clicking this will display a small window which allows you to filter the details being displayed in the Executive Summary Progress Summary and the Executive Detail charts If Views have been set up in ChangeBASE then a specific View may be selected so that only the packages that are linked to that View will be part of the Chart details Set Required Filter For Dashboard View Adobe Packages v O No Date View Filter No Date Filter D Specific Date s D n Days Previous O n Weeks Previous n Months Previous l Save l Cancel In addition to selecting a View you can also select from the options below No Date Filter These allow you to filter according to a date which can be a specific date or a number of days weeks or months previous to the current date 130 7 Dashboard Quest ChangeBASE 5 3 User Guide Set Required Filter For Dashboard View Adobe Packages v No Date View Filter No Date Filter Specific Date s
112. aptured web data will be created This defaults to the Output File Target Location set above Modify it as required 234 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide E Manage Web Service Configuration i Database connection string Data Source sqlexpress Initial Catalog ADKCSC Manager User Id CBLogin P Test Falder to store uploaded files you MUST ensure IIS has pemission to write to this folder C Program Files amp 86 ChangeBASE ADKCSC VADKCSCW S Transient Storage Cancel_ 12 Click OK 15 6 4 2 Manage Filters This option allows you to prevent data from particular URLs from being captured by blacklisting them and or to ensure that data from particular URLs is included by whitelisting them 1 Select Tools gt Manage Filters to open the associated dialog E Manage Filters Un bbe co uk 2 Enter URLs as follows If you enter a string in the URL column and do not check either the Include or Exact box then CSC will blacklist any URL that starts with the entered string for example http www bbc co uk news without any additional filters will exclude the entire BBC news website If you enter a string in the URL column and tick the Exact box CSC will exclude any URL that is an exact match for the entered string for example http www bbc co uk news 10284448 ticker sjson will exclude only the BBC News ticker feed and not the wider BBC If you
113. are created if necessary refer to 2 1 4 Working Directory 4 Ensure that you have a ChangeBASE license 5 Download ChangeBASE from https support quest com 2 3 2 Installation 1 Run the ChangeBASE installation MSI Local Administrative privileges are required and click Next 33 2 Installation Quest ChangeBASE 5 3 User Guide fg ChangeBASE Setup la to the ChangeBASE Setup izard The Setup Wizard will install ChangeBASE on your computer Click Next to continue or Cancel to exit the Setup Wizard ChangeBASE fe ChangeBASE Setup End User License Agreement Quest Please read the following license agreement carefully C h a ng e BASE a PLEASE READ THIS AGREEMENT CAREFULLY BEFORE USING THIS PRODUCT BY DOWNLOADING INSTALLING OR USING THIS PRODUCT YOU INDICATE im ACCEPTANCE OF AND AGREE TO THE TERMS AND CONDITIONS OF THIS AGREEMENT FOR ORDERS PLACED OUTSIDE THE UNITED STATES AND CANADA PLEASE SEE WiVW QUEST COM LICENSEAGREEMENTS FOR THE APPLICABLE LOCALIZED VERSION OF YOUR AGREEMENT IF YOU DO NOT AGREE TO THE TERMS AND CONDITIONS OF THIS AGREEMENT OR THE LOCALIZED AGREEMENT DO NOT DOWNLOAD INSTALL OR USE THIS PRODUCT NEITHER THIS AGREEMENT NOR THE LOCALIZED AGREEMENT SHALL SUPERSEDE ANY OTHER SIGNED AGREEMENT BETWEEN YOU AND QUEST THAT EXPRESSLY GOVERNS THE ORDER FOR THIS PRODUCT 3 If you require the Dashboard to be hosted on this client you should change the Server Components feature to Will
114. are not supported by ChangeBASE A If you attempt to load images larger than these recommended limits the loading will run for many hours and is likely to fail prior to completion 13 3 3 Alternatives to WIM files Microsoft VHD files can be mounted on Windows 7 with Disk Management Console by entering diskmgmt msc in the Run box and going to Action gt Attach VHD On Windows XP you will need to download and run VHDMount Download Virtual Server 2005 and follow the installation and mounting instructions VMware vmdk images can be mounted with a free tool available here http www vmware com download eula diskmount_ws_v55 html There are a range of tools available for mounting ISO files such as http www slysoft com en virtual clonedrive html and http www daemon tools cc eng products dtLite 204 13 Advanced Usage Quest ChangeBASE 5 3 User Guide Once you have the image mounted follow the instructions in 13 3 6 Loading into ChangeBASE 13 3 4 Installing the WIM Driver files 1 6 Download the Windows AIK Automated Installation Kit from here http www microsoft com downloads en details aspx FamilyID 696dd665 9f76 4177 a811 39c26d3b3b34 Install waikx86 msi or waikAMD64 msi depending on your Platform Navigate to the folder C Program Files Windows AIK tools Choose the correct folder for your CPU type x86 or AMD64 Locate the ImageX tool in the same folder as wimfltr inf or wimmount inf Right click
115. as an MSI then the process will be disrupted and information will be lost This will cause the application repackaging to fail The best way to proceed with applications like this is to manually proceed the application through the installation process within the Virtual Machine and then decline the reboot when the installer requests one You may encounter some application installers that demand a reboot operation without even prompting for one These are quite rare but again this will disrupt the repackaging process 5 6 5 1 Stop Reboots with Windows XP A small program that can detect and abort these reboot attempts has been supplied as part of the ChangeBASE repackaging software but it is only recommended for use with Windows XP You need to start this program manually inside the Virtual Machine while the application under conversion is being installed The program is called StopReboot exe and can be found in the program files File Monitor directory on the Virtual Machine Either create a shortcut to this program or use Windows Explorer to view this directory and double click on the program to start it 108 5 Importing Packages Quest ChangeBASE 5 3 User Guide 5 6 6 Abnormal End to Session If your session ends unexpectedly please take a screenshot and log the error via the self service portal at https support quest com You may be asked to supply in addition to the screenshot a detailed report on the actions taken
116. ase or move to step 4 4 Assign Create Table permissions to the tempDB system database as follows a Click the New Query button at the top of the screen b Select the tempDB database from the drop down menu below the New Query button e g File Ed View Query Debug Tock Window Community Help Dy Ga hed 4 ee t ee gt Soils AA Connect By Bi 2 Lib bet thot egherpeees SOL Server EN PROD Emel Lj Databases p O System Databases e ig AOKCSC Manager ig Bare Lat E Demme a Lg Castebere Diagrams p O Table A O Wea e E ia WL Fegan c Assign permissions to the database using the following command grant CREATE TABLE to lt Database User gt e g PROD QDL RD ChangeBASE in the above example Important The lt Database User gt Is case sensitive and the double quotes are mandatory Note For Windows authentication the domain PROD in the above example needs to be specified d Click Execute on the toolbar 2 2 2 SQL Setup for a Multi User Environment When installing ChangeBASE in a multi user environment it is desirable to install Dashboard in one central location and CSC if relevant in another central location 31 2 Installation Quest ChangeBASE 5 3 User Guide This method of installation will allow users who do not have ChangeBASE installed to view the reporting results in Dashboard Q It is advisable to have a dedicated machine on which to install Dashboard and another on which
117. ate a better session as most of the locks will be cleared by that point Take a Snapshot of the Virtual Machine whilst it is running Shut down the Virtual Machine Start Shutdown or just power it off By default a temporary App V package will be created on your Virtual Machine s desktop in a new folder This can be overridden by adding a line into the GUIApp ini file as follows a Open your GUIApp ini Y localappdata ChangeBASE UserData in a text editor 158 11 Virtualizing Packages Quest ChangeBASE 5 3 User Guide b Using the table below navigate to the correct section in your GUIApp ini file Note There may be legacy section names in the file Section names are case sensitive Windows XP x86 App VWinXP86 Windows 7 AppVWin764 If you are using Windows 7 x64 for virtualization locate the App VWin764 section and add the following key PackagePath lt path in guest to create package gt Where lt path in guest to create package gt is a valid location in the guest Virtual Machine where you want the App V sequencer to create the output virtual package ChangeBASE will now use this path in the guest Virtual Machine to copy out the virtualized package to the export folder on the host 11 2 3 1 Avoid Balloon Tips by resetting the Screen Resolution or disabling the Tips When App V 4 6 SP1 is running on the Virtual Machine balloon tips can be displayed in the notification area Because the virtualizatio
118. ated on a network share being copied to the local machine then click Source Capture this will result in ChangeBASE scanning the folder picking up all the files analyzing them and attempting to construct an MSI e the application to be imported is to be repackaged select Repackaging Configuration and proceed as in 5 5 The Repackaging Process T3 5 Importing Packages Quest ChangeBASE 5 3 User Guide Note For the IIS Folder option refer to 15 5 Loading Source Folders for Web Data Capture 5 If the application can be imported directly click on Import in the Packages Panel to load the associated package into the database Note If you are using Legacy Package Capture then Convert it Local must be set for your user in the Security Tab in the Options window If you are using Source Capture then Convert it Source Capture must be set for your user in the Security Tab in the Options window Refer to 12 7 Security Tab 5 2 2 Browse Dialog 1 Click Browse in the Packages Panel refer to 4 1 Packages Panel DSa tonnan a OO e E Select a repository base folder 2 Click Browse button in the Browse dialog and locate the folder containing the packages you want to import Assyst FrontR angeS olutons HotDocs Hyperion MATPLAN B2BRAIN Er E e e ratais 32am InstEd 1 5 13 24 msi Select Package Transforms a 27 of 27 packages in the current folder selected _ Ready 3 ChangeBASE s
119. atibilty Add in Repackaging Options Dashboard Virtualize Report Options File Extensions automatically added during folder scans Retain Report Results On Tab Change Show Checked Out Packages Only File Extension Identify Packages With Product Name F Z Confirm Clear Results 7 Transforms Generate Transforms 7i Roll up Fixes Suppress Transform Validation Errors Auto Select Single Transforms Package Import Fix Backup MSI Before Applying Fix Database Options Jf AS a Import Non Core MSI Tables Server Timeout mins 30 4 Import COM Snapshot Data male 3 Connection Test Timeout Secs F Checkout Packages Automatically Maximum No Simultaneous Imports 55 Remote DB Server Install Folder PE File Extension Additions OK Apr Cancel 2 Drag and drop the folder onto ChangeBASE 3 Once the folder appears in the Workbench right click on it to display the following menu Delete Save Retrieve Reports Select App IDs Open Containing Folder Repackaging Repackaging Configuration Virtualize from manifest Expand Collapse 4 lf you dragged the folder onto ChangeBASE because e the application to be imported is locally installed but its source files are no longer available then click Legacy Package Capture this will result in ChangeBASE attempting to find any associated registry keys shortcuts and shared files e the application works by a folder loc
120. base Tab in the Workbench then clicking Properties Enter the server name and then click Next as prompted until the Working Directory screen appears tid Please select a Server and Database ChangeBASE UPDATE DATABASE PROPERTIES Please specify a working directory for this database CACB Working DB1 F Specify UNC Path Previous 13 6 Command Line Invocation of ChangeBASE Functions The command set listed below can be invoked using cbExec exe This executable must reside in the ChangeBASE install directory One or more databases must have already been registered to the machine through the product s UI prior to using this tool Simple examples are provided for each command 13 6 1 DBLIST This returns a list of logical and physical database names registered with ChangeBASE from the executing machine A logical name is required for other commands listed below Example cbExec DBLIST 13 6 2 IMPORT This imports a package into a specified database The full path of the package must be specified after the logical database name One or more Transforms can be appended as further arguments Examples cbExec IMPORT WBDB1 C Packages BARCODE00030853 msi 212 13 Advanced Usage Quest ChangeBASE 5 3 User Guide cbExec IMPORT WBDB1 C Packages ABACUS MSI C Packages ABACUST_US mst 13 6 3 LISTREPORTS This lists reports in a specified database returning a list of report identifiers and associated report na
121. bit File Analysis i 0 5 181 12 ChangeBASE Options Quest ChangeBASE 5 3 User Guide Windows 64 bit 32 bit NameSpace Detection i 0 5 Windows 64 bit 64 bit Registry Reflection 0 5 Deprecated APIs Windows 64 bit DirectX Video Acceleration API 0 5 Analysis Windows 64 bit Non Supported Drivers Server 1 and 64 bit OS Windows 64 bit Non Supported VDM Functions 0 5 and Registry Settings Analysis 64 bit Windows 64 bit PAE and AWE API Analysis SS 0 5 Windows 64 bit Windows 16 bit Deprecated 0 5 API Analysis Windows 7 8 Active Directory GPO Settings Y 0 01 Analysis Windows 7 8 Common Dialog Compatibility 1 Analysis Windows 7 8 Hard Coded File References 0 01 Scan Windows 7 8 Install Logic Scan 0 01 Windows 7 8 IPv6 Networking Scan oS 2 Windows 7 8 IPv6 Strong Host Check a 2 Windows 7 8 Legacy Control Panel Applet 0 01 scan Windows 7 8 Legacy Help File Scan 0 01 Windows 7 8 Microsoft Message Queue 1 Analysis Windows 7 8 Named Pipe Hardening Analysis Windows 7 8 Nested Install Scan 0 01 1 Windows 7 8 NETDDE Deprecated Component Scan 182 12 ChangeBASE Options REPORT GROUP Windows 7 8 Windows 7 8 Windows 7 8 Windows 7 8 Windows 7 8 Windows 7 8 Windows 7 8 Windows Server 2008 2012 Windows Server 2008 2012 Windows Server 2008 2012 Windows Server 2008 2012 Windows Server 2008 2012 Windows Server 2008 2012 Windows Server 2008 2012 Windows Server 2008 2012 Windows
122. ble for the web data capture database to be created by the ChangeBASE CSC Manager refer to 15 6 4 CSC Configuration In both cases the account which connects to SQL Server whether via Windows authentication or SQL security must have the dbcreator server role g Login Properties CBLogin o eS Selecta page E z S a H _ General z Soit UE Hep L Server Roles User Mapping Server role is used to grant server wide security privileges to a user A Securables Status dela bulkadmin J diskadmin Connection Server localhost sqlexpress Connection PROD bnel View connection erties Progress Ready ok cac 26 2 Installation Quest ChangeBASE 5 3 User Guide This will be sufficient for the initial database setup and the day to day running of ChangeBASE and Client Side Capture CSC However where it is necessary for a DBA Database Administrator to create the database the following must be observed e The collation setting Latint_General_CS AS must be used for ChangeBASE and the setting Latin1_General_Cl_AS must be used for CSC e The SQL database user s must be set up with the following permissions Database role db_datareader Basic database level permissions must be granted Database role db_datawriter Basic database level permissions must be granted Stored EXECUTE Permissions must be granted to execute stored procedures procedures in the database tempdb Create TABLE
123. cans the folder and subfolders for any files with the selected extensions these are configured in Options gt General 4 The total number of files located in the folder structure is displayed in the first row of the Auto Selected column 74 5 Importing Packages Quest ChangeBASE 5 3 User Guide 5 The right hand panel lists all located files in the folder structure Transforms for a specific MSI are listed at the base of the right hand panel Note By selecting different folders in the left hand panel you can filter the results to show just the files in the selected folder 6 Check the files to be imported and then click OK 7 After a brief delay the selected files are then displayed as pre loader items in ChangeBASE uel ChangeBASE oS ChangeBASE Ultimate Packages Browse i Browse with SCCM J ISScript10 Msi Import 7 msxmi6 msi CSV Import Z msxmi6 msi Assess Z maxml6 msi Note You can remove any pre loader items by right clicking and choosing Delete Note If you want to relocate a package at any time in your file structure right click the package and select Open Containing Folder 8 Ifan application is to be repackaged proceed as in 5 5 The Repackaging Process However where pre loader items can be imported directly click on Import in the Packages Panel to load the associated package s into the database While the packages are loading progress bars are displayed ne
124. captured applications are launched if FB1 Capture capture is enabled This option allows you to manually launch the applications they require instead of all applications being launched You must have access to the VM to be able to use this feature 165 11 Virtualizing Packages Quest ChangeBASE 5 3 User Guide 11 3 How to Virtualize Packages Preparation for all scenarios 1 Import the packages s into ChangeBASE 2 Assess the packages s for compatibility with the virtualization technology and the target Operating System optional 3 Where necessary fix or override any compatibility issues optional ChangeBASE will not prevent the virtualization of packages with Amber or Red issues but some issues may prevent the application from virtualizing successfully Scenarios e 11 3 1 Package Virtualization One virtual package per MSI e 11 3 2 Package Virtualization One virtual package from multiple MSIs e 11 3 3 Package Virtualization Virtualizing EXEs and manual configuration 11 3 1 Package Virtualization One virtual package per MSI This is the most commonly used scenario for package virtualization ChangeBASE will attempt to create a virtual package for each checked MSI 1 Check the MSI packages s to be virtualized 2 Click the Virtualize button a If only one MSI has been checked the virtualization process will begin using the selected virtualization technology b If more than one MSI has been checked the f
125. ccccccccccccccsecnecneceeceeneesesseees 169 11 4 Performance Issues and Optimization cc ccc ccc ccc cec eee eee eee eeeeceeceeeeeaeeaeeaeaeeaeeaeees 170 11 5 Troubleshooting Virtualizing PACKAGES cccccceccecece eee eeeeceeceeseeeeeaeeaeeaeeeesesaeees 170 12 CnanGeBASE Options vccscpccccoecccascsecesscazacacicas neusecansdecenep cans seasensatessesseeascecessecs 173 AZ CSCC Fall leclO veceeeoracenerencusnectuee anes ses Goan A a aa AE AEE 173 12 1 1 Report OPtIONS ccccccccecceeseececcuccucceccucusensessussuecuccenessussuececcucsusensessessussucseses 173 12 12 A VANS I OWNS ede cists cade nce sacacarse Sata caesin da tn dacw sais ia tase deta ote Ga 174 t2 ka Package IMHOF IX fe ae ane are Pe ee Ae eee Ae ie ee a eee 174 12 1 4 File Extensions automatically added during folder SCANS 1cccccscneeneeeees 175 12t WALA D ASO CO OU ONS rire En voce sears eae ese E arenas ange then EERE 175 12 2 ISSUCSUMMANY AD sie hho hte hl a 176 123 COSADP OSIS Ta eee see eee es 176 TZA PATOS LA lemme ere Pee eae ee ee ee ee ee ee ee mee ee 176 tao Upgrade Ia sc ccterencreroneeece EE A 177 120 SOIC SNA 5 ies este ad eo a ich tb esc as ewe as ia etd sca eae eine SR 177 WE SO CUNY MO ea rt ata cor anescan oan eee A O ee 178 TO RODO GH 9 S gt eee eee Sn ee Sec eee eee eee 180 12 8 1 Recommended Cost and Effort Valu cccccccccccccsecceccecceeseesesneseeseeseeseeseees 181 1220 Duplicates AD xceccccesssec ceccienet te
126. cccccccscccececcecsecseeseeseceseeceeseeseeseeaeseeseesesaesaeseeseeseeaeenens 133 7 2 5 Package Overview REPDOMT ccccccececcscceccecucseseesussuccucceccuseesensucauseusensessessueeaes 136 PA OROrFCaCUAUON BY 2 2 oirr ET eee 137 1 2 On OSUNO ents Ge aurea EA eer eee Meena 138 7 202 AROTNC OlAU OM 20552228 n atec2ens oe kt taba yates 20 12 e ai a a 8 Et e ea EEE yet aes onteze Seve 140 A2 Outs VIRUN TO See ne em ae ea A ma eee 141 8 The Top Five Issues Explained ccccccececee cece cece ee eeeeeeceeeensnensneneneneeeeeeeenenes 143 SV OUSO ACON SOC UN ices es eset EE E 143 8 1 1 Explanation Of the ISSUC cccccccccccececnecnececeececcecceeseesessesseseesesseseseeseeseesesaeeas 143 8 1 2 Remediation Steps hnaricicccscitic sei caeieetiecenosehestiassiestiactreembesthnesseceeeeeceesceczescacectees 144 9 2 Legacy Hep al S cm eet a at een ene ce a PNR Pe DID veo i a 144 8 2 1 How to Reproduce the Problem ccccccccecnecceccecceccececneseesessussuccuccucesessusauees 144 8 22 EXplanauon OF AC S SUC ssa ook oss sacs ses sees Se eee ee Se eee eee ce eet 145 6 2 3 Remediation SICDS sigs decease ce EE 145 8 3 Hard coded File References csc ace ace coe ne se soe cae ca ce nd ca cece ce cx neve aed du ssasu ea eaasseesanene 146 8 3 1 How to Reproduce the Problem cccccccccccecceccecceeseeeceseeceesecseesessesesesesaeees 146 8 3 2 Explanation Of the ISSUC cccccccsccsececnecneceeceececsecseeseesessesseseese
127. ccsseeceneeecseseceeesnseessaesesasessneesenenees 70 5 Importing Packages sssssssnnennnnnnnrnnrnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nnmnnn 71 5 1 Importing Packages Overview n nanannnsnnnnnnnrnrnrnrrnrnrnrnrnenrrrrnrnrnrnrnrnrnenerrrnrnrnrnenenr 71 522 MPO MEINOGS aa des soese sea bee seek EEEE EEE EEEE teeter cee 72 g2 BD g2 10 ahd D OD perenne ee hen Rene nen ee ee ne Ae ne ne ee err eee ee errr ee eer ees 72 5 2 1 1 Dragging and Dropping Files onto ChangeBASE sccccssseeeeeneeeeeeneeessaeeessaeeeees 72 Contents Quest ChangeBASE 5 3 User Guide 5 2 1 2 Dragging and Dropping Folders onto ChangeBASE ssccccsseeeessneseeeanseesenesessanes 13 D122 DIOWSE DIJO orriak osc aca ay acl ee es wee ee me ees aa ae cee ceeds 14 9 23 BIOWSE WIT SCCM rarere enone 15 S23 hk Mam IIA OO eae ciate luna ean ceihea a a a a a asd esalgdlect 76 L LOC OM OPON S a a a E me a E nT a ea 77 5 2 3 3 Configuring a NEW server database ccccccseeeccnsescecsevecccsusccnscsuecsaussensuasssnauesensens 79 5 2 3 4 VIEWING PACKAGES and PLOGFAIMS ccsccccsescccneeccneeecaesessusesseeseaesesaesessaeessaesesaesesanaes 81 5 2 3 5 Adding the packages programs to ChangeBASE c ssccccssseecessseeeeeneeeseaeeeseaeeeees 84 5 2 3 6 Importing SCCM packages programs into ChangeBASE cccccseccsseeeeeneeeeseeesanees 85 924 OPS IMPO eRe ene nce eee ee eee ee en een eRe Re AAS 87 TTT WANIG Sweats eae eee acy e
128. cense for the Browser Compatibility module as part of the Ultimate edition refer to 1 1 ChangeBASE Product Editions then you should also consider the above setup integrated with Client Side Capture shown in 15 6 1 CSC Architecture 2 1 9 1 Requirements File Server e As per 2 1 4 Working Directory Database e Windows Server 2008 R2 25 2 Installation Quest ChangeBASE 5 3 User Guide e Virtual OS supported e SQL Server 2008 Standard or Enterprise e Quad core or greater CPU e 16GB or greater RAM e Multiple DBs can be per SQL instance or across multiple SQL instances e 8GB database space per 400 packages imported e Max packages per DB 5000 Dashboard e As per 2 1 2 2 Requirements for Remote Database Setup 2 1 9 2 Process Optimization With the above setup multiple users can remediate applications in ChangeBASE provided that e applications are imported from UNC paths on the LAN e the import of applications is split between clients to optimize import timing importing applications requires a large amount of processing by clients Note Within ChangeBASE RAG assessment results can only be viewed by the user who ran them However Dashboard can be used by multiple users simultaneously to view assessment results 2 2 SQL Setup It is preferable for the packages database to be created by the ChangeBASE application refer to 3 2 Database Setup If you are also using Client Side Capture setup it is likewise advisa
129. changes to application settings This feature is not available with XenApp Streaming conversions The configuration period can be set The default is 10 seconds ChangeBASE will prompt you with the following dialog on the Virtual Machine when it is ready for the manual configuration Please click Stop Timer if you wish to make any application configuration changes Pause Timer Auto exit in 14 seconds Bit Clicking Pause Timer will stop the countdown timer and the manual configuration changes can be made Clicking Exit will prompt ChangeBASE to finalize the virtual package This allows you to browse the file system for EXE or MSI file Any EXE MSI files added in this way will be installed on the Virtual Machine before the virtual package creation begins This option is useful when you have a prerequisite which is not installed on your Virtual Machine but which is required for the installation of the application being virtualized even though it may not actually be required within the virtual application itself 168 11 Virtualizing Packages SETTING Up Down Remove Package path Arguments Detect Manual install Use Converted MSI Is it a Pre requisite Copy all source media Save Manifest Quest ChangeBASE 5 3 User Guide DESCRIPTION This allows you to change the order in which the applications are installed on the Virtual Machine or remove applications from the sequence Displa
130. chart configured in the Options gt Dashboard section of ChangeBASE Note It is possible to drill down to a detailed view of the results simply by clicking on either chart Refer to the 7 2 3 Executive Detail topic later in this document 1 2 2 2 Top 5 Issues An alternative to the ROI section in the Executive Summary is the Top 5 Issues chart This is configured in the Dashboard Options screen This chart shown in the top right corner of the Dashboard Executive Summary screen shows a bar chart of the top 5 most common issues identified from all packages assessed 128 7 Dashboard Quest ChangeBASE 5 3 User Guide Custom Action SECUNTY CEN 2 ChangeBASE Dashboard Issue Detail Report UAC File Header Analysis Detail Reporting Group Windows 7 Next Steps Next Steps RAG Status Amber Packages 2 This AOK Plugin analyses each loaded and selected application to ensure that each respective file s descriptive text and comment information does not contain the text setup patch update or install User Account Control UAC s security settings will generate a Security Prompt if an application is executed with these properties which may result in unexpected application behaviour If these issues are not resolved programs may fail to start or users will be presented with dialogs requesting Windows passwords that they may not have There is an automated fix available for this issue this is achieved by creating a security m
131. ckages 110 111 Assessment Results 54 58 61 110 115 122 Assigning Permissions using SQL Server Management Studio 27 32 Auto Logon Loading URLs 222 Process Overview 223 Settings 224 Auto Fix 15 16 Automated Installation Kit See Windows AIK B Balloon Tips Avoid 159 Quest ChangeBASE 5 3 User Guide BAT 22 87 90 Best Way Forward 54 132 Bootstrap EXEs 91 105 Browse Packages 60 74 75 174 179 SCCM 60 75 Browser Compatibility 11 14 24 25 185 222 228 230 Browser Compatibility Tab 24 185 186 Bulk Issue Summary 203 Reports 118 BulkCSVImport 88 C CAS 206 208 219 220 Rules 208 Settings 210 Understanding 209 Check in 202 Citrix Xenapp See XenAPP Citrix XenApp See XenApp Client Side Capture 25 26 27 230 232 236 237 Agent 237 Architecture 231 Assessment of Web Files 241 Blacklist 235 Configuration 233 Installation 232 Loading Data from Server 239 Manage Filters 235 Server 232 System Requirements 232 Troubleshooting 242 Using from Client 238 Verify Setup 236 Collapse Package Tree View 204 Command Line Invocation 212 Compatibility Matrix Virtualization 155 Complex Calculations 139 140 142 Configuration Recommended 24 Connection Test Timeout 175 Core App List 176 179 Core Application Scan See CAS Cost and Effort Values 181 Create Table 27 Create View 190 Creating Report Groups 215 216 244 Index C
132. ckin Re Import Add To Matching Analysis Specify Overrides Views Bulk Issue Summary Expand Collapse IITIN SaaS i C Wsers j C Wsers j C Wsers j C Wsers j C Wsers j C Wsers j C Wsers j C Wsers j C Wsers j C Wsers j 1G MATPLAN B2BRAIN v 2 0 0 7 DB29281 C Users j Window s 64 bit a icrosoft_VC80_ATL_x86 icrosoft_ C80_CRT_x86 licrosoft_ C80_MFC_x86 licrosoft_ C80_MFCLOC_x86 icrosoft_V C90_ATL_x86 licrosoft_V C90_ATL_x86_x64 ft_ C90_CRT_x86 icrosoft_V C90_CRT_x66_x64 icrosoft_ C90_MFC_x86 icrosoft_VC90_MFC_x86_x64 icrosoft_ C90_MFCLOC_x86 Orca C Wsers j o 00g 000g E SLLLS Overtime Tracking System 398A Window s 64 bit E ChangeBASE t pgr BARRED IBEREE SE PPPLPPP PELLE localhost sqlexpress CB JOHNTEST The maintenance screen is then shown in one of two modes 68 4 ChangeBASE User Interface Quest ChangeBASE 5 3 User Guide e Single Selection A single package was selected from the context menu e Multiple Selection Multiple packages were selected from the context menu 4 7 1 1 Single Selection 4 7 1 2 Multiple Selection Both dialogs show the package s selected in the main interface followed by any AppIDs that have been selected for the package s in the left hand Available IDs panel and any ApplDs that are available for selection in the right hand Selected IDs panel The difference between the dialogs i
133. ctions to one type of provider per process This means that you can only configure ChangeBASE to use either Workstation or Server based Virtual Machines not both o If you are running ChangeBASE on a machine which does not have VMware Workstation installed and you wish to connect to an ESX vCenter server then you will need to install the VIX SDK http www vmware com support developer vix api Once the Virtual Machine has been built as per the requirements in 2 1 3 Virtual Machines the user account inside the Virtual Machine should be assigned administration rights In addition if Windows 7 is running on the Virtual Machine to be used for the repackaging 1 Ensure that the User Account Control UAC Settings are switched off as follows a Click on the Windows Start button and type UAC into the Search programs and files box and press Return You should see the following screen 91 5 Importing Packages User Account Control Settings gt o Choose when to be notified about changes to your computer Tell me more about User Account Control settings Always notify Never notify me when Programs try to install software or make changes to my computer I make changes to Windows settings Not recommended Choose this only if you need to use programs that are not certified for Windows 7 because they do not support User Account Control Never notify b Drag the slider control down to Never noti
134. ctivityTest link and then click Invoke You should see the following hitp localhost AOKCSCWS ConfigService asmx DBConnectivityTest Windows Interne lt 2s Jo E http localhost AOKC x I5 Bing P qip Favorites E http localhost AOKCSCWS ConfigService asmx lt xml version 1 0 encoding utf 8 gt lt string xmins http changebase com gt 0 clients registered lt string gt Internet Protected Mode On 236 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide Note The number of clients registered could be higher than 0 if you have previously set up Client Side Capture 15 6 5 2 CSC Agent The next step is to verify that the CSC Agent can be launched on the CSC Server You would not normally run the agent on the CSC Server but this test verifies that the Agent is set up correctly 1 Click Start type run and press Return 2 Type lt ComputerName gt aokcsc_client e g Run ype the name of a program folder document or Internet resource and Windows will open it for you Open VEUS068 aokcsc_client P This task will be created with administrative privileges Cancel 3 Click OK to open the shared folder containing the CSC Agent files e g J 9 2 gt Network EU9068 aokcsc_client v Search aokcsc_client File Edit View Tools Help Organize v E Open Burn New folder fcz Gil di imag
135. d folder Output Type HTML amp MHT Text Use MSI Filename Use Productname By default the name of the Readme will be taken from the ProductName Property rather than the actual filename It is generally more useful however to choose the MSI FileName value instead 6 8 Summary Report Examples showing AppIDs 6 8 1 Profile ac CIDE civsespnastavappoasiLoanchang 2 C x E changenase Pronie ChangeBASE Package Compatibility Report 13 Feb 2013 12 36 AM Profile Show All Packages Hide All Packages Bs sei sg2 272 5 Sim eens8 3 g 5 eae Sag 32 23 2 g22 23 323 22 gt AppiD Package a o BF ff OpenPlan_Professional e Relux_Vision 0 E Splot 6 0 SS I 8 2 BPA CommonAutomation WinZip o o TE OCH ETCi_Service_Release 00 0 te Sophos_Anti Virus a 0 2 WinZip 0 0 SS E E E EE ETCi_Service_Release 0 O0 Nero a a a SSN 5 ETCi_Service_Release A e E Sophos_Anti Virus S 0 E 119 6 Assessing Packages and Viewing Results Quest ChangeBASE 5 3 User Guide 6 8 2 Packages by RAG JE ngeBASE Packages B aaa ChangeBASE Package Compatibility Report 13 Feb 2013 12 37 AM Packages By RAG Show All Packages Hide All Packages status A PPID Package ise Effort Cost 1 RED Neen es 8 1732 MEN OpenPlan_Professional Splot 27 108 27 Relux_Vision 1508 SE EH MEE 59 SS ET EE ang Anti Virus 992 59 E E EE EZ Nero SS EA So
136. d issues where a package tries to use objects or functions that have been deprecated from the Operating System or where their use has been restricted In this case there are no changes that can be made to the install routine to fix the problem The problem needs to be dealt with at the program code level by the programmer that wrote it or by providing a more up to date version For vendor MSls an upgrade may be required The recommendation with applications containing Red issues is that they are tested to see if the issue is either causing it to fail to install or for a critical part of its functionality to fail It is possible that an application that contains a Red issue can be used if either the Red issue Is not used in the application or if the part of the application that relies on it is not important 134 7 Dashboard Quest ChangeBASE 5 3 User Guide ICON DESCRIPTION 9 Not all reports in the target report groups have been run against this package Therefore it is not possible to assign a final status to the package The above information can be displayed on screen by clicking the Info button in the top right hand corner of the page After the overall package status are the package details package name version manufacturer and the full path and filename It is possible to drill down to the package overview screen by clicking on the package name For more details on this screen refer to 7 2 5 Package Overview Report This report
137. d path reference found in Registry table C Hard coded path reference found in Registry table C Hard coded path reference found in Registry table C This AOK Plugin will analyse each loaded and selected application package for text based references to hard coded file or folder names This Plugin will scan all of the loaded application package s MSI Installer tables e g Registry and Custom Action tables for these text based references and will raise an AMBER issue if any are found Following the AOK layered approach to application compatibility each application must comply with the target operating system middleware and security requirements When migrating applications to new platforms legacy information e g file and folder paths may no longer be appropriate or even available Thus an application package with hard coded references to legacy configuration details may appear to install correctly but may not behave as expected An automated fix for this issue is available through the AOK Workbench Updates are automati Replace with Installer pr N wo ERE R SERSERSHGSGSS RREREERREREN 4E by Oy ly hy sh OOO WBOXSVR 114 6 Assessing Packages and Viewing Results Quest ChangeBASE 5 3 User Guide 6 5 2 Reports Tab The Reports Tab displays the assessment results sorted by the report groups and associated Plugins This allows you to identify quickly which packages have issues that were f
138. dentials SCCM User Password User Id administrator Password Venfy Password V Remember Password When defining an SCCM system to ChangeBASE you can configure access via the SCCM server in one of two ways e Using WMI e Connecting directly to the SCCM database In the case of WMI the server is the name of the SCCM server and the database is the SCCM Database name as shown in SCCM The SCCM credentials are also required In the case of direct Microsoft SQL Server database access the server is the name of the SCCM Server and the database server If your database server is different from the SCCM server or has a non default instance you can enter the database server instance of the SQL server in the Database server input box For direct database access either SQL Login credentials User Password Security or Windows Integrated Security can be used 19 5 Importing Packages Quest ChangeBASE 5 3 User Guide SCCM Server Properties Server Access Access SCCM via WMI Access SCCM Database SCCM Server Name QMXDEMOLAB Database Server f diferent from SCCM 192 168 100 128 Database SMS_QMxX Secunty Credentials 6 Integrated Security User Password Security User Id Password Venfy Password W Remember Password You can also choose whether to have the system remember the password in which case the system stores it in an encrypted format or not in which case the system will re prompt you for the passw
139. derlying issue with the package and you can assume that it is not the current live and installable release and therefore not a suitable candidate for reporting and fixing e Does the package have all of its required files For example external or internal CAB files and or uncompressed source files To verify this try to install the application If the installation does not complete due to missing files you need to go back to the live deployment source and copy the complete source media e Is the Plugin working correctly for this package There may be a peculiarity in the package that is not allowing the fixing script to run correctly 10 1 1 Multi User Issues Settings within ChangeBASE Options may revert to the default where there are workstations connecting to the ChangeBASE database that are set up with different configurations of the software Packages may not run or fix correctly if they are loaded from common shares and are therefore not accessible to other users 154 11 Virtualizing Packages Quest ChangeBASE 5 3 User Guide 11 Virtualizing Packages In ChangeBASE an MSI package or EXE can be directly converted into a virtual package in accordance with 11 1 Virtualization Compatibility Matrix The supported package virtualization technologies are e Microsoft App V 4 6 SP1 and 5 0 e VMware ThinApp 4 6 e Symantec Workspace Virtualization 6 1 e Citrix XenApp Streaming Profile 6 5 Packages are virtualized on Virtual Mac
140. e Analysis session 0 Isolation Analysis TCP IP WFP IPX SPX Scan UAC File Header Analysis Windows File Library Feature Analysis 12 9 Duplicates Tab P aaa Options Check for Duplicate Packages package MSI File Name Package Code Eg Using the options below you can choose to prevent duplicate packages being loaded into ChangeBASE To enable these checks select the boxnext to the value s you wish to validate When selecting multiple values the package will only be rejected if ALL the values match an existing package For example selecting just the Product Name value will prevent packages being loaded where the Product Name matches an existing package irrespective of the other values However selecting Product Name and Product Version will only prevent the package being loaded if BOTH values match an existing package NB a package will always be checked for a duplicate path AND file name and will not be loaded if they match an existing ChangeBASE5_1_0_6 msi Product Code CEE7FB0B FB67 4908 9CFD 287291E6B5F2 Product Name ChangeBASE Product Version 5 1 0 Manufacturer Quest Sofware Upgrade Code DDF4283A E7A5 4A3F 9D57 6DEFC6AE9CBF BB1CA801 7B26 409A 87C9 3BA31AC905BD This Tab allows you to prevent duplicate MSI packages from being imported based on the file name and six MSI properties We recommend that you select the Product Code Product Name and Product Version 18
141. e Refer to 2 2 SQL Setup A machine must have been designated for the CSC Server role This can be the same machine as the one used for SQL Server and or ChangeBASE or a separate machine The machine requirements are as follows Client CSC Server Operating System Operating System e Windows XP SP3 e Windows Vista SP2 e Windows 7 e Windows 8 e Windows Server 2003 inc R2 SP2 e Windows Server 2008 inc R2 e Windows Server 2012 Minimum Hardware e 2 5GHz dual core processor or greater e 4GB RAM e 50GB hard disk space e 1024 x 768 display Software Requirements e Microsoft NET Framework 3 5 SP1 and 4 0 30319 or later Full Client Internet connectivity required 15 6 3 CSC Installation e Windows XP SP3 e Windows 7 e Windows 8 e Windows Server 2003 inc R2 e Windows Server 2008 inc R2 e Windows Server 2012 Note For Windows XP systems you will need to have an i386 folder available or the original media as the CSC installer will attempt to install IIS Minimum Hardware e 2 5GHz dual core processor or greater e 4GB RAM e 50GB hard disk space e 1024 x 768 display Software Requirements e The installer will attempt to install and configure IIS on the CSC Server see note above for XP users e Microsoft NET Framework 3 5 SP1 and 4 0 30319 or later Full Client Important Ensure that you have already installed ChangeBASE Run CSClinstaller_v1 9a msi and accept all the defaults
142. e Manifest file you have saved Clicking OK will virtualize with the chosen Manifest file Clicking Edit will use the chosen Manifest file and then take you to the Manual sequence configuration dialog 169 11 Virtualizing Packages Quest ChangeBASE 5 3 User Guide 11 4 Performance Issues and Optimization Create a separate output folder for each virtualization tool and ensure that there are no duplicate packages in the output folders Should you notice unusual growth in disk space utilization you can safely delete the contents of the Packages folder within the Working Directory and any folders directly in the Working Directory that are denoted with a GUID If you have the Import COM Snapshot Data box checked in the General Tab under Options this will slow down the loading and reloading of packages due to the increase in the amount of processing required when extracting all of the COM information for self registering files Uncheck this option unless it is specifically required to re extract COM information Keep the number of Virtual Machine Snapshots to a minimum as the Virtual Machine disks can easily become fragmented If you have accrued a large number of Snapshots delete all previous unnecessary Snapshots and run the VMware defragmentation tool 11 5 Troubleshooting Virtualizing Packages Q Why does the App V 5 0 Sequencer show warnings as follows Application Virtualizatio Se wl Prepare Computer PENEN sess
143. e NetBIOS over TCP IP Net Provides Telephony API TAPI support for progra Startup Type Manual Automatic Automatic D Automatic Automatic Manual Manual Automatic D Manual Automatic D Manual Automatic Automatic Automatic Automatic Automatic Manual Manual Manual Manual Automatic Manual Automatic Automatic Manual then ensure that the SQLServer service is running for the appropriate instance on the Log On As Local Service Local System Local Service Local System Local System Local Service Local System Local System Local Service Network Service Local Service Network Service Network Service Network Service Local Service Local System Local Service Local System Local System Local System Local System Local System Local System Local Service Network Service 3 Basic Configuration Quest ChangeBASE 5 3 User Guide If it is running and the database creation fails again try using a different method of entering the Server Name e g localhost ComputerName IP Address 3 3 2 Failure to connect to a Database If incorrect credentials were supplied the following kind of error will be displayed MGM Please select a Server and Database e aas ChangeBASE UPDATE Change BASE DATABASE PROPERTIES Cannection To localhost sqlegress Faded Retry Login failed for user userid The user is not sssociated with a trusted SOL Server parrietb r
144. e Registry Settings Analysis v3 24 4 6 2 Online Report Group Loading It is highly recommended that ChangeBASE is used from an online client This will ensure that the latest reports are available for download and that any report updates typically released on a monthly basis are also immediately available Your ChangeBASE license dictates which report groups are available for download These can be accessed by clicking on the Options button in ChangeBASE then changing to the Upgrade Tab The report groups you are entitled to download are displayed Best Practice Manager ConvertlT Fitters MSI Installer Integrity Office 2007 Application Compatibility Office 2010 Virtualisation App Virtualisation Best Practice Virtualisation Citrix XenApp hosted and MS RDS 4 reports available DAAE Virtualisation Citrix XenApp streamed Virtualisation Symantec Workspace Virtualization Virtualisation YMware ThinApp Windows 64 bit Windows Server 2008 Windows Update 2003 Windows Update 2004 Windows Update 2005 Windows Update 2006 Windows Update 2007 HOOBAABAAGaL Ignore Import When Window Closes Check for upgrades automatically Show Ignored Upgrades Cancel To download a report group check the associated box It is also possible to download individual Plugins by expanding the report group and checking the r
145. e a new database and rename an existing database Allows users to remove a package from the database permanently Allows users to remove a report from the database permanently Enables users to right click and open the package in Orca Allows users to create and update Plugins and create report groups This option allows users to extract all the files from internal and external CAB files This is necessary for Dependency Scan API Call Extract and File Header Analysis Allows packages to be fixed using the configuration settings in the Options menu Allows the import of URLs websites and CSCWEB files 179 12 ChangeBASE Options SETTING Manually Add Reports or Plugins offline Multiple Database Support Print Report Reimport Package Reportit View Transform Application Directory Structure to MSI Use the Dashboard Tab in the Options Screen VReady it Quest ChangeBASE 5 3 User Guide DESCRIPTION Allows CBP ChangeBASE Plugin files to be dragged and dropped onto ChangeBASE and loaded Allows the support of multiple databases Allows users to print the reports available in the Results section of the Reports view Allows users to re import packages that already reside in the database Allows users to view the assessment results on the Reports Tab refer to 6 5 2 Reports Tab This setting allows ChangeBASE to scan and import the files dependencies and registry keys based on the contents of t
146. e useful in the event of a support requirement Exit Quits the package If you are running CSC from the CSC Server then you can simply select the CSC Agent options described above as required If you are running CSC from a client proceed to 15 6 6 Using CSC from a Client 15 6 6 Using CSC from a Client 1 Unless you have all the relevant filters set up for you refer to 15 6 4 2 Manage Filters ensure that all other websites apart from the one that you wish to capture are shut down Repeat steps 1 to 4 of the previous section 238 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide 3 Right click the CSC Agent that is either now running in the system tray or is hidden in the adjacent notification area EE oe 4 Select Start capture from the context menu If the following kind of prompt appears ii Windows Security Alert Windows Firewall has blocked some features of AOK Client Capture Application on all public and private networks Name AOK Client Capture Application Mee Publisher ChangeBASE ltd Path Vwin 64 aokcsc_cient aokcccontrol exe Allow AOK Client Capture Application to communicate on these networks C Public networks such as those in airports and coffee shops not recommended because these networks often have litte or no security What are the risks of allowing a program through a firewall then check the Private networks box and click Allow access 5 When you are
147. ead only The package itself or the entire package folder may be set to read only Ensure that you have the correct permissions to 153 10 Fixing Packages Quest ChangeBASE 5 3 User Guide write to the folder and to make changes to the MSI by creating a backup of the MSI saving it into the same folder and then editing it and saving the changes e Package no longer accessible The package may have been renamed or moved or the network connection required to access the package may no longer be available e Package in incorrect format The package may be an MSM renamed as an MSI or in a format that does not have the minimum MSI tables required for it to run as an installation file Check the package format in MSI Studio or Orca and if in doubt try to install the package If you cannot install it then you should not be running it through ChangeBASE You should gather the current live instance of the package from its Deployment Source location e Are the Plugin and hotfix versions up to date Your Plugin versions may not be in line with the version of ChangeBASE or the hotfix version that you are using Ensure that you have the latest version of the software and that you have all of the latest versions of the Plugins downloaded from the Upgrade Server If you work in offline mode request your latest Plugin pack from your ChangeBASE contact support e Can you open the package in MSI Studio and or Orca and or Wise If not then there is an un
148. ee ete been ee meen 89 5 3 Repackaging OVEIVICW scidsseen stenoses Rotter eee 90 54 Repackaging COnmmlguravlon ccc 2scess ie cs a cee ei ciecsnc addin eeleageelete ees 91 94 1 Vnua Mache SCD erinan ees 91 5 4 2 ChangeBASE Repackaging OPtion cccccccccececceeseeecneceecueceeseeseeseeseseeseeseeaess 94 5 4 2 1 ESXi 5 1 VMware SOrves cccccsssccccscseccnscscccsnsccnsseccsauscensuueesnaseessaussensaesssauesessaes 95 S422 FVP Veren o a a a e a a a tase neds aca uetns 96 94 29 VMWN E VWWOIKStAUOIND orir E a alesis Stee a eee ous aes 98 9 4 3 Repackaging FINCIS derre e a T E ieuckeesieetaceceseeeeeeeesiaetee 99 944 Femplate TST aE EAR A EEEE EEEE EER S 101 9 9 Ine Repackaging FrocoSS sssr E EEEE 101 5 6 Repackaging Tro bleshootin geis a ee EES 105 5 6 1 ChangeBASE is unable to revert to the Virtual Machine Snapshot 105 5 6 2 The Capture Process terminates before the Installation has completed 105 5 6 3 The Repackaging Process results in an MSI with no FIle S ccccccceceee nen eeee 106 5 6 4 The Package fails tO IPOS t ccccccccsccnecneceececceccecseeseesecseseesseseeseseseesseseesesaeeas 106 5 6 5 Reboots during REPACKAGING cscccecnecneceeceececsecceeseesesseseseesecseeseseeseesecseeseeas 108 5 6 5 1 Stop Reboots with Windows XP ccscsccseseccsenccessenensesenencceseneusenenecsenenenensenensesens 108 3 0 0 ADNOM al ENO TO SESSION assesses has aa shanties ahaa E ses es cnet 1
149. eeseeseeseeaesaees 12 1 2 1 Flowchart showing the Key Phases c1cccccecseccecceccecceceseesessessussucceccesausussuceaes 13 Ti 2 PSSESSINGNE CAD GADWINGS orrena aiaa ene gees EE EEE EE E E E TEE 14 1S VY Ghange BASE Visse a a 14 1 3 1 Fast Automated Migration to Windows 7 Windows 8 Microsoft Office 2010 Microsoft Office 2013 and Virtualized Package Environments cccccceeeececeeeeeees 14 1 3 2 Features and Benefits 2 eee eee 15 1 3 3 Automate amp Accelerate Compatibility Testing for Internet Browsers 16 2 mMsStalati N acna a a i neneeeneneueaever 17 2 1 ChangeBASE System ReEquireMents cccccccccecceeceeceeceececeeceecueceeseeceeeesueseeseeeesaees 17 Zk OCA ata ase SOUP is wae eieaa crate e cates EA eae atemaeaasuaceesmeacssaaeen 17 2 Vs REMO DAlAD ASC CUD assas ors ere as a ar oes asa ads nd weds ek asdedeaciat 19 Z TZ paspor d SC WI sachets are aces seated A a teaeeeness tanta Naeaieiet nica 19 2 1 2 2 Requirements for Remote Database Setup ccccccccccsccccsecccseeceseeeeeeesesesessnseseneeees 21 2 Fo VINE IVI GIGIMING Shiai ik ia a R EEA 22 2 14 WOrKiIng Dreco aii Rec haeah voc AAA aa be 23 2 1 5 Recommended Configuration for Optimal Performance 1ccccceeeeceeneeeeeeees 24 2 1 6 Deployment to Virtual MACHINGS c ccc cccsccccceeceececsecseeseeseseseeseeseeseesesaeneeseeseees 24 is BLS 14 eee ee a Te Sn ON ee een Tne ee SO ey Te 24 2 F012 IIATAD AS
150. egacy installers are configured This is covered in detail in 5 4 1 Virtual Machine Setup 12 13 Dashboard This is covered in 3 4 Configuring and Enabling the Dashboard Components for the ChangeBASE Database s 186 12 ChangeBASE Options Quest ChangeBASE 5 3 User Guide 12 14 Virtualize This is covered in 11 2 6 ChangeBASE Configuration 12 15 Other Tab The Background Wallpaper option within the Other Tab enables the selection of a jpg or gif file as the background wallpaper for the ChangeBASE interface If you wish to revert to the default image select the Use Default check box The Excel Culture setting no longer applies In the Database Management section Auto Index Management should be checked to allow the database to be indexed on an ongoing basis without any further related maintenance being required It rebuilds the indexes following package import but is only really necessary when importing many packages simultaneously SQL Compression is required to stream data on slower networks You will first of all need to install ChangeBASE on the SQL Server machine to enable SQL compression ChangeBASE will then automatically stream data between the clients and the server in 50kb chunks to ease the flow of data and prevent the freezing of the package 12 16 Changing the Text Based Configuration File Threshold Text based configuration files are read when packages are imported This includes files with the following ex
151. en Seinen iene eae ere Ree 184 12 10 Browser Compatibility Tab Sigs peice ee eee es ec aad 185 IZ TACO Nr Daen aE 186 12 12 Repackaging Options Tab sristi a 186 TZS BaS 11 31 012 E aE E te emer Sitar mee er ine ht none rer Renee 186 eA VIA Z ee ee CE eer TET Zee ee 187 ZO ONC I a Doi eeaeee ieira 187 12 16 Changing the Text Based Configuration File Threshold ccccccecseeeeee eee eees 187 TS Advanced WU SAG Co eri E E E a E 189 13 1 Packages Tree Context Men entte E EEEE ahi 189 Contents Quest ChangeBASE 5 3 User Guide 13 1 1 Save Retrieve Reports 0 0 cccccccccccsecsececeeceeceeceeseeseeseesenseseeseesesseseseeseesessesaeeas 189 13 1 2 Package Selector ccccscccenecccccucceccuccucsuseesessussuccuccuceusussucceccucusensessessassueseees 190 13 1 3 Create VICQW ccccccccsecseseeseececcucceccuceuseeseesuesuecuccecusseesuececcususensessussuccecaususanees 190 13 1 4 Organize VICW Scie scbivindsnsatisealnnleahihalnehviesbiseaisxbakhalesauasindeen dee iene te lee Gecedi ta teauilant 192 E3215 Virt alze Trom Manio ST ssa la aa EE AAAA AE EEEE EE 193 LOE Pa Nan EEE E EE E 194 PO 1 el COAPSE enea 194 13 2 Package Level Context Menu cccccccccecceeceeceeceeceececeecaecuecuecueseceeseesaeseeseeeeeaeeas 194 T2 T DEl n ET ded 195 13 2 2 Save Retrieve Repotts 1cccccccccccccececseneesessussuccucceccunusensessucauseusessessussuseeees 195 13 23 O 21 7 TAPP IDS airi ETEA en ene ee 195 13 2 4 Open Contai
152. ent of your website switch from the Packages to the Reports tab for an immediate view of the results of your compatibility tests for example Ultimate i Quest ChangeBASE Reports Packages wee Name V Reports i Attributes Array Analysis v1 00 J Children Array Analysis v1 00 SS V Conditional Comments Analysis v1 01 lJ Deprecated Fitters Analysis v1 00 Deprecated Video Analysis v1 00 HTC Analysis v1 01 Refresh Results 7 sourcelndex Property Analysis v1 01 Clear Results T YML Analysis v1 01 ith l J XML Data Islands Analysis v1 00 SSSeaae 15 8 Troubleshooting Web Capture 15 8 1 Problems arising from the Loading of URLs and Folders 1 Examine the ChangeBASE log refer to 13 2 6 View Log to see whether any of the following limits or checks have resulted in errors 241 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide Description Limits Retries Allowed Failed Forms Authentication Incorrect credentials were entered or the login page Logins could not be reached Failed HTTP Authentication Login Incorrect credentials were entered for HTTP authentication Failed Heartbeat URL Check The URL of the heartbeat page could not be reached Failed Heartbeat Unique String The Unique string configured by the user could not be Check found on the heartbeat page Failed Download A download failed to complete successfully e g due to network failure Successful Fo
153. equired Plugins 65 4 ChangeBASE User Interface Quest ChangeBASE 5 3 User Guide When you click OK ChangeBASE will download the report groups and Plugins By default the report groups will automatically be loaded into the database Quest Best Practices recommend that you select all reports that are pertinent to the assessment that you would like to run 4 6 3 Offline Report Group Loading Where it is not possible to connect to the ChangeBASE server reports can be loaded offline To be able to do this you should request a set of offline report groups from Quest Support These will be supplied as a set of CBP ChangeBASE Plugin files To load offline Plugins simply drag and drop the folder that contains the CBP files onto ChangeBASE then click Import Note When working offline you will not receive any notification when Plugins are updated and updated Plugins will have to be requested as offline Plugins and then manually imported into ChangeBASE 4 6 4 Which Report Groups Should Add For advice on which report groups to download and use refer to 6 1 Choosing the Right Report Groups 4 6 5 Troubleshooting 4 6 5 1 Plugins failing to load If Plugins fail to load online then you should verity your web connection and retry the Plugin downloads The best approach for this is to click on Refresh Results check to see if the Plugins have already been loaded into the report group and if not click the Import b
154. er of hours expected to fix the simple migration of an application This is the number of hours expected to fix the moderately complex migration of an application This is the number of hours expected to fix the complex migration of an application This is the number of hours expected to prepare a simple application for virtualization This is the number of hours expected to prepare a moderately complex application for virtualization This is the number of hours expected to prepare a complex application for virtualization This is the top level page of the Dashboard and is split into three sections the Executive Summary Pie Charts Return on Investment ROI Calculator OR Top 5 Issues and the Progress Summary 127 7 Dashboard Quest ChangeBASE 5 3 User Guide Database 2 ET Executive Summary Click on either chart to drill down Progress Summary Legend Target 50 Imported Total 41 Imported Legacy 4 Assessed 39 Packages Fixed 4 Virtualized 1 11 Nov 7 2 2 1 Pie Charts This section of the screen has two pie charts showing the before and after view of the application estate The pie charts are split by RAG status for the combined view of the applications The left hand chart before displays details prior to any amber applications being fixed The right hand chart after combines the fixed Amber applications with the Green status applications This chart reflects the Executive Summary
155. er your username password and or any other details required for authentication and click OK If you click Cancel the import process is halted 4 To avoid confusion between sites using HTTP Authentication and Forms Authentication the Auto Logon configuration screen will block any requests for HTTP authentication and display the following message 229 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide HTTP Authentication e This page requires HTTP Authentication Challenge Response You l may not need to Configure Auto Logon settings for this site if this ts the only way of logging in Credentials will be asked for automatically during the Import process if HTTP Authentication is requested by the site In this situation it is recommended that you do not configure Auto Logon settings for sites that only require this type of authentication because the logon screen will automatically be displayed for HTTP authentication However if the site requires both types of authentication then you will need to configure the Auto Logon settings 15 5 Loading Source Folders for Web Data Capture Source folders can be dropped onto the ChangeBASE Workbench directly from Windows Explorer as explained in 5 2 1 2 Dragging and Dropping Folders onto ChangeBASE The results are affected by the options set in the Browser Compatibility Tab In particular you should set Web Analysis Mode to Always Analyze Once a particular folder containin
156. es Dependent On ACROFAS DLL All Packages That Install ACROFX32 DLL Adobe Reader 7 0 msi v7 0 0 i Adohe Aroha 505 Al ENG van Adobe Acrobat 3 00 All CNG Va A green tick is displayed to the left of a tree node whenever ChangeBASE detects that the corresponding file is actually installed by the package On the other hand if a file is listed as a dependency but is not installed by the package the item is greyed out and an exclamation mark is displayed When you click on one of the nodes of the Package Dependencies tree a list of other packages that also have dependencies on the selected component is displayed in the second tree and a list of other packages that install the selected component is displayed in the bottom tree These are considered to be Shared Dependencies 196 13 Advanced Usage Quest ChangeBASE 5 3 User Guide Ts Dependency Viewer Exclude Operating System Files 0S Snapshot Default Windows 7 Snapshot Package Dependencies El Acrobat fl a i H a ACEUTE DLL w1 2 0 1 EH w ACROBAT EXE w5 0 5 452 i i J L ACRODIST EXE v5 0 0 0 al ACRODISTDOLL DLL v5 0 5 452 EI w ACROFX32 DLL Lai NNOTES DLL Hl 2 ACROIEHELPER OCX v1 0 0 1 Other Packages Dependent On ACE DLL v1 2 0 1 Adobe Reader 0 msi v7 0 0 Adobe Photoshop Hlements_ 0 2 0_P1 1_GLOBAL msi v2 0 2 0 All Packages That Install ACE DLL v1 2 0 1 r Adobe_Photoshop_EFlements_2 0 2 0_P1 1_GLOBAL msi v2 0 2 0 Adobe Reader 7 0 msi v7 0 0 ie pon oe Ame
157. es T Name Date modified Type Size vm pc08 eii C AOKCCControl application 10 04 2012 10 32 ClickOnce Applica 2K orca E AOKCCControl exe 26 04 2012 14 20 Application 160 K JM ukbprnw02 AE J oe 7 AOKCCControl exe config 03 04 2013 08 57 CONFIG File 4K p s _ AOKCCControl exe manifest 10 04 2012 10 32 MANIFEST File 9K AOKCCControl XmlSerializers dll 10 04 2012 10 32 Application extens 72K amp aokGen dll 05 05 2011 00 22 Application extens 40 K Libraries En cal 2 AOKTraffic mdb 14 03 2011 16 03 Microsoft Access 208 K Documents g P i CBCommon dll 25 10 2010 23 27 Application extens 2 589 K a Music 3 E x E CSCLite exe 04 03 2012 16 14 Application 176 K t Pictures k POIA z D 7 CSCLite exe config 03 04 2013 08 57 CONFIG File 2K f Videos 3 REE 2 __ CSCLite pdb 04 03 2012 16 14 PDB File 98 K S CSCLite XmlSerializers dll 04 03 2012 16 14 Application extens 72 K J Computer e ne i i FiddlerCore dll 10 08 2010 21 52 Application extens 217 K amp Local Disk C i CE _ FiddlerCore pdb 10 08 2010 21 52 PDB File 322 K ca DATAPARTI D ee eee X aoe Rie Home UKL H FiddlerCore xml 10 08 2010 21 52 XML Document 194 K ohn Green prod quest corp Home Hie F S HtmlAgilityPack dll 10 11 2010 20 21 Application extens 132 K amp programs PROD UKB P z ee eee ICSharpCode SharpZipLib DLL 12 08 2010 10 14 Application extens 140 K amp products PROD
158. essing Packages and Viewing Results for help on understanding the results of the capture and import process 15 2 3 Configuring Auto Logon Settings The Auto Logon feature allows you to define a group of URL and control settings for a package You can create new settings for a project by right clicking on a URL in the Workbench and selecting one of the following options Auto Logon gt Configure Logon Settings This option will open the selected settings Selection is indicated with a check box against the settings name If no selection has been made for this package then a new group of settings will be created Auto Logon gt Create New Logon Settings This option will always create a new group of settings and if configuration is successfully completed these settings will be marked as selected against the package 224 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide HELG V Packages Browse Browse with SCCM Import CSV Import ASSESS Fix Virtualize Refresh Results Clear Results Assessment Results F W W W W a m FileZilla_3 5 3_win32 setup exe HTML Help Workshop Delete http Avy thetrainline c E Save Retrieve Reports Select App IDs https support quest con _ on lt Open Containing Folder Adobe Acrobat 9 Pro Auto Logon b Adobe Reader 9 1 Repackaging Configuration Adobe Photoshop Eleme https commons quest c Virtualize from manifest ass
159. etail The ROI Calculation details can be seen when you drill down from the main Dashboard screen Click on either of the ROI Bar charts and the screen shown in the example below will be displayed ChangeBASE ROI Calculator Manual process vs Automation Product Cost a ChangeBASE Professional Select Currency Manual v Automated Application Compatibility Total Application Portfolio Manual Number Of Desktops Estimate Complexity Percentage ChangeBASE Savings Days Application Testing Cost Days Cost Days Saved Saved Saved _ Medium _ Medium Complex Average Rate Hourly APAC Application Testing Hours Per Package Application Remediation Hours Per Package App Complexity SLA s og Simple Simple a Simple 45 ol Complex Application Remediation n i Simple 6 000 10 Medium 36 000 60 Complex 22 500 38 Virtualisation testing Remediation and Sequencing Simple 9 000 15 Medium __ 54 000 90 Complex 375 38 137 7 Dashboard Quest ChangeBASE 5 3 User Guide The ROI details screen is also used to show the setup details which were explained in 7 2 1 1 ROI Setup The grid on the right displays the ROI Calculations Manual ChangeBAse savings Days OH Application Testing Cost Days Cost Days Saved saved Saved _ Simple G 0 gl _ Medium 27 000 45 0 4 _ Complex 18 000 30 2 Application Remed
160. file with the same name to the same loca tion The file is not COM file it doesn t register but is a PE Portable Executable file and the version is the older The file is also installed by Com ponents that have different ComponentID s Manifestation When the conflicting application uninstalls it may remove this file if the file is not marked as permanent Application resources with the same keypath should have the same ComponentID 209 13 Advanced Usage Quest ChangeBASE 5 3 User Guide Next Steps Apply the automated fix in ChangeBASE but take note The automated fix in ChangeBASE will synchronise the Component IDs Be careful applying this fix if the component is part of a mergemodule Best Practices dictate that mergemodule contents are not changed You also want to test the applications together as there is a version difference to ensure that functionality is backward compatible The version difference is only likely to cause an issue in less than 1 of all applications Application Virtualisation can be used if the applications are incompatible 13 4 3 Core Application Rules Settings w Core App Scan Rule Filters CutePDF Professional 3 6 msi Packages OS Snapshot Files Registry Other Settings Cancel Restore Defaults Include issues relating to Merge Module components Include issues relating to HACR Registry Hive The Settings Tab contains additional filters that can be ap
161. fully green Save As OK Note This package history is cumulative during the time that the package resides in the database 13 2 10 Checkin Checkin checks the package back in so that any user can run fixes against the package Note When a package is checked out only the user who has the package checked out can run fixes all other users can only run assessments 13 2 11 Re Import Re import allows the re import of a file or web application Note This is run automatically every time that fixing is undertaken 13 2 12 Add to Core App List Add to Core App List adds the package to the group that has been created in the Core App Lists Tab under Options Note This option will only appear if you have created at least one Core App List 13 2 13 Add to Matching Analysis Add to Matching Analysis can be used with any package type that installs a type of software considered to be middleware that might possibly clash with other packages Packages can then be checked against the Matching Analysis Plugin 202 13 Advanced Usage Quest ChangeBASE 5 3 User Guide 13 2 14 Create Issue Summary Report Create Issue Summary Report runs a set of reports on an individual package as defined in Options gt Issue Summary 13 2 15 Extract CABs from MSI Extract CABs from MSI is used to extract internal CAB files from an MSI 13 2 16 Overrides Override All Issues Specify Overrides View Update Overrides are all p
162. fy and click OK 2 Disable the Program Compatibility Assistant PCA as follows a Click the Windows Start button and select Control Panel b Double click Administrative Tools c Double click Services to display the available Services d Scroll down and select Program Compatibility Assistant Service e Right click and select Stop File Action View Help e9 MlGcis Bm gt aun w Services Local Program Compatibility Assistant Name Description Status Startup Type Service G Parental Controls This service Manual Stop the service ia Peer Name a hinges Start Manual Restart the service i Peer Networking Grouping Stop Manual Gh Peer Networking Identity Manag ee Manual oe GA Performance Counter DLL Host Manual s sarm provides support for the A ee ote Manual Program Compatibility Assistant h Plug and Play Restart Automatic PCA PCA monitors programs h PnP X IP Bus Enumerator All Tasks x Manual installed and run by the user and Ci PNRP Machine Name Publicatio Manual ae n a ed Ss Portable Device Enumerator Serv Refresh Manual PCA will not function properly Sh Power P Automatic Z Print Spooler Automatic amp Problem Reports and Solutions Manual 4 Program Compatibility Assistant gt c iu gt sciv Automatic i Protected Storage Provides pr Manual koi Quality Windows Audio Video Expe Quality Win Manual amp Remote Access Auto Connection Creates aco Manual Extended A S
163. g Analysis Collapse ome j You will need to create your target Report Group first before you can move a Plugin into it 215 14 Writing Custom Plugins Quest ChangeBASE 5 3 User Guide 14 2 Adding Report Groups To add a new Report Group 1 Select the Root Report tree element within ChangeBASE 2 Right click and select Add Report Group Portfolio Summary il r fy Re ports View Report Templates Add Report Group E ConvertlT Fiters Open Containing Folder Expand Collapse E Matching Analysis EE MSI Installer Integrity E My Custom Report Gro 14 3 Adding a Report You may have already added a new Report Group or you may choose to add a Plugin to an existing Report Group To add a new Report 1 Ensure that you have the correct privileges to update and create reports 2 Select desired Report Group in the Report tree element within ChangeBASE 3 Right click and select Add Report Reports New Project Wizard Name AppiD s Portfolio Summary V Reports H v Bes j V Browser Common Reports Add Report 7 Activex Control Analysis v1 01 Delete M Alt Attribute Analysis v1 10 Expand W Browser Version Checking Analysis v1 Collapse Once you have selected this option the Report Generator is launched aid Add Report Best Practice Manager Eg Details Rules Messages Name Description Support URL Mo
164. g web data has been dropped onto the Workbench proceed as follows 1 Right click the folder in the ChangeBASE window 2 Select Repackaging gt IIS Folder 3 Click the Import link on the left hand side of the ChangeBASE screen and the source folders will be processed the results are dependent on the options set in the Browser Compatibility Tab refer to 12 10 Browser Compatibility Tab 15 6 Client Side Capture CSC The options described previously are suitable for static web data However for the capture of more dynamic web pages e g your corporate Intranet site it is advisable to use Client Side Capture Note Data generated by scripts within the web pages such as data generated via Ajax is not captured Important Client Side Capture CSC requires additional setup and needs to be integrated with third party systems e g the corporate proxy server so you should seek guidance from Quest Professional Services You should use a test environment Within this environment it is advisable that wherever possible you install the version of the browser to which you wish to migrate This will avoid the accumulation of minor browser compatibility issues e g W3C and CSS standards issues and give you a clear view of any major issues Before starting you need to set Web Analysis Mode in the Browser Compatibility Tab to Always Analyze 230 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide 15 6 1 CSC Architecture
165. geBASE automatically chooses the first Transform in the sequence into which to roll the fixes Suppress Transform Validation Errors should be checked when importing generic standardization Transforms which may not conform to Windows Installer s Transform error and validation handling For example if you cannot load a Transform in Orca without going into Tools and Options and unchecking the error and validation flags you will need to select Suppress Transform Validation Errors This option is on by default Auto Select Single Transforms When MSI files are either dragged onto ChangeBASE or selected through the Browse dialog this option controls whether single Transform files which are in the same folder as the MSI are automatically selected to be imported with the MSI Where Multiple Transform files are present in the same folder as an MSI they will not be selected for import by default If you need to select multiple Transforms to be imported you should use the Browse dialog as shown in 5 2 2 Browse Dialog Where multiple MSIs exist in a folder with one or more Transforms the following dialog will appear wid ChangeBASE p fm Auto select single transforms has been enabled and one or more folders contained multiple msi packages along with transtom files The transtorns in these folders could not be added CChangeBbASE Packages TestPackages Conven tLegacyinstalleiincorrectExt Transforms which have been ignored TotalPlant
166. hat page 15 4 The Web Application Import Process The Web application import process is initiated through the ChangeBASE Workbench via either the Import link on the Packages Panel or the Re import option on the context menu for the package 228 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide Once an import has started the Packager process will begin to crawl the web pages and resources hosted under the package URL If Auto Logon settings have been configured for this package then the first step will be website validation using Forms Authentication wa Enter Auto Logon Details for Quest Communities Login URL httpicommunities questcomindexjspa The site that you are importing has been configured for Auto Logon Please enter the credentials for Quest Communities in the Value column below and press OK to proceed Name login usemame login password ann Start Date be Enter your username password and or any other details required for authentication and click OK If you click Cancel the import process is halted 15 4 1 HTTP Authentication During an import if a page or area of the web site being crawled is protected by HTTP Authentication then the following dialog will be shown wE Enter HTTP Logon Details Login URL http localhost Corp The Downoad page that you are importing has requested HTTP authentication Piease enter the credentials below and press OF fo proceed Username Do Password cn Ent
167. he Application Folder If this security setting is disabled the folder dragged onto ChangeBASE will simply be analyzed for any recognized file formats such as MSI MSM MST WSI WSE and will then be imported directly into the database If no such file format is found nothing will be imported into the database Gives you access to the Dashboard Tab so that you can configure Dashboard Allows users to virtualize packages 12 8 Report Costs Tab i Options General Issue Summary Core App Lists Platforms Upgrade Services Security Report Costs Duplicates Add in Repackaging Options Dashboard Other Common Dialog Compatibility Analysis Custom Action Security Scan Deprecated API Analysis Elevated Privileges Detection GINA Deprecated Component Hard Coded File References Scan Install Logic Scan IPv6 Networking Scan IPv6 Strong Host Check Legacy Control Panel Applet Scan Legacy Help File Scan Microsoft Message Queue Analysis Named Pipe Hardening Analysis Nested Install Scan NETDDE Deprecated Component Scan Non Supported Drivers 32bit OS Non Accessible Registry Settings Analysis The Report Costs Tab allows you to select a Report Group from the drop down of Report Groups to which your license entitles you You can then enter a cost associated 180 12 ChangeBASE Options Quest ChangeBASE 5 3 User Guide with the manual Fixing of each issue and the effort associated with it in eithe
168. hed during the creation of Feature Block 1 By default all captured applications are launched if FB1 capture is enabled This option allows you to manually launch the applications they require instead of all applications being launched You must have access to the VM to be able to use this feature 164 11 Virtualizing Packages Quest ChangeBASE 5 3 User Guide 11 2 8 Advanced Settings App V 5 0 atid Advanced settings for plugin AppVWin 32 Operating Systems Overide Target Operating Systems Windows 7 64 bit Windows 2008 R2 Teminal Server 64 bit Windows 32 bit Windows 64 bit Windows 2012 Remote Desktop Server 64 bit Other Settings Primary Virtual Application Directory C Primary VirtualApplication Directory Detect MSI installer path property for silent installs E Feature Block 1 SETTING DESCRIPTION Operating Systems The default Operating System can be overridden Primary Virtual Application sets the Primary Virtual Application Directory in which the Directory package should be installed to Detect MSI installer path Detects the public property in the MSI which would override property for silent installs the default install path for the package If not set then the package will install into its default location Feature Block 1 Enables the creation of Feature Block 1 during conversion All package shortcuts are launched during the creation of Feature Block 1 Manual Feature Block 1 By default all
169. hines The Virtual Machine requirements are as per 2 1 3 Virtual Machines 11 1 Virtualization Compatibility Matrix The table below covers the compatibility of the above listed technologies with the 32 bit and 64 bit versions of both Windows XP and 7 with regard to the virtualization of MSI and EXE files on a Virtual Machine Virtualization Conversion Compatible with Compatible with Compatible with Compatible with Technology Type Windows XP 32 bit Windows XP 64 bit on Windows 7 32 bit Windows 7 64 bit on Virtual Machine Virtual Machine on Virtual on Virtual Machine Machine Microsoft App V MSI to Virtual Microsoft App V EXE to Virtual VMware MSI to EXE ThinAPP VMware EXE to ThinAPP Virtual Symantec MSI to Workspace Virtual Virtualization 155 11 Virtualizing Packages Quest ChangeBASE 5 3 User Guide Virtualization Conversion Compatible with Compatible with Compatible with Compatible with Technology Type Windows XP 32 bit Windows XP 64 bit on Windows 7 32 bit Windows 7 64 bit on Virtual Machine Virtual Machine on Virtual on Virtual Machine Machine Symantec Workspace Virtualization Citrix XenApp MSI to Streaming Profile Virtual Citrix XenApp Streaming Profile For more details about virtualization see the following topics 11 2 Configuration e 11 2 1 Virtual Machine Setup General e 11 2 2 Virtual Machine Setup Symantec Workspace Virtualization e 11 2 3 Virtual Machine Setup Microsof
170. his must be a valid formatted URL This button will load the Login URL into the browser window as in the example in 15 2 4 Selecting Logon Controls It is disabled while the page is being loaded The Heartbeat URL should be set to a page that can be reached by the import process once it has been authenticated against the site To allow the crawler to distinguish heartbeat pages from pages that can be accessible by guests before they are authenticated a unique string can be configured here This unique string could be for example the full name of the user shown following logon The string should not be shown by the website prior to authentication of the import process as this may give a false positive Note The heartbeat string will be matched against the HTML source for the heartbeat page It is therefore important to ensure that the string which is visible on the page is also searchable in the page source Otherwise it will not be possible for the Auto Logon crawler to match the heartbeat page To check the page source you can right click on the browser window and click View Source To check that the unique string is searchable simply search for the unique string in this text Once a request to navigate to a page has been initiated through the Refresh button this box shows the status of the browser The navigation process can be stopped by clicking the Stop button L3 to the right of the status box This window shows the cu
171. hortcut properties for VMware and view the Application compatibility Tab Ensure that Run As Administrator is not set Right click on View Log and read the log file to look for issues e g tid Package Log C Users jgreen Documents Training FrontRangeSolutions FrontRangeSolutions Goldmine 5 5 FrontRangeSolutionsGoldmine5 5 m 3 Preloader cbMsiConverterBase Establish Preloader Start Load de76a06a bd71 47e9 b6dd a8ef2a49f7c5 Package Loader Identify load type Convert It Load Type Local Package Loader Identify load type Preloader cbMsiConverterBase Establish Preloader Preloader Initialised Start A Preloader Scanning Table msi_Validation 553 Row s Load MSI Tables Scanning Table msiAction 0 Row s Load MSI Tables Scanning Table msiActionText 70 Row s Load MSI Tables Scanning Table msiAdminExecuteSequence 9 Row s Load MSI Tables Scanning Table msiAdminUISequence 10 Row s Load MSI Tables Scanning Table msiAdvtExecuteSequence 16 Row s Load MSI Tables Scanning Table msiAdvtUISequence 0 Row s Load MSI Tables Scanning Table msiAokUrlMap 0 Row s Load MSI Tables Scanning Table msiAppId 0 Row s Load MSI Tables Scanning Table msiAppSearch 0 Row s Load MSI Tables Scanning Table msiBBControl 0 Row s Load MSI Tables Scanning Table msiBillboard 0 Row s Load MSI Tables Scanning Table msiBindImage 0 Row s Load MSI Tables Scan
172. i12 mst MSis which have been pre imported TotalPlantii2 Copy msi TotalPlanti12 msi Open Log File 12 1 3 Package Import Fix Backup MSI Before Applying Fix This option should be used for repackaged MSIs whereby the fixing is being applied directly to the MSI file It is always advisable to back up the MSI before applying the fix in case it is necessary to revert to the previous version This is also helpful if you need to perform a package comparison to verify which changes have been made during the fix process 174 12 ChangeBASE Options Quest ChangeBASE 5 3 User Guide Import Non Core MSI Tables This option is used to import any non standard Windows Installer tables that may be required for later analysis For example InstallShield packages have a number of proprietary tables such as those that handle XML files which could be imported and have custom QA checks run against them Import COM Snapshot Data extracts the COM information Class IDs ProglDs and Type Libraries for all self registering files within the MSI package being imported Checkout Packages Automatically This option checks the package out to the user who imports the package Create external cabinets This option is used to force the generation of external CAB files when fixing MSIs directly By default the build type is followed in order to establish how to create the fix files e g if the build is uncompressed the fix files will also be uncompressed
173. iation _ Simple 6 000 10 _ Medium 36 000 60 Complex 29500 Virtualisation testing Remediation and Sequencing Simple 15 Medium a 90 TIO PO _ Complex 375 164 375 It breaks the calculations down into three main sections Testing Remediation and Virtualization The sections are further broken down into Simple Medium and Complex and these are calculated for both manual costs and number of days Note Virtualization calculations are only calculated when the ChangeBASE Professional Professional Plus or Ultimate version is selected refer to 1 1 ChangeBASE Product Editions 7 2 6 1 Testing Simple Calculations FIELD CALCULATION Manual Cost Number of Applications Simple percentage Testing Simple hours effort Average Hourly Rate Manual Days Number of Applications Simple percentage Testing Simple hours effort 8 ChangeBASE Days Number of Applications Simple percentage ChangeBASE Simple Hourly Cost Days Saved Manual Days ChangeBASE Days Percent Saved Manual Days Days Saved 100 138 7 Dashboard Medium Calculations FIELD Manual Cost Manual Days ChangeBASE Days Days Saved Percent Saved Complex Calculations FIELD Manual Cost Manual Days ChangeBASE Days Days Saved Percent Saved Total Calculations FIELD Manual Cost Manual Days ChangeBASE Cost ChangeBASE Days Cost Saved Days Saved Percent Saved Quest ChangeBAS
174. ic Server V New Relic Server Monitor V OMXDEMOLAB OWS3270Plus V GvvS3270 PLUS IBM Phase 1 c temp QMXDEMOLAB QMX00011 newrg c temp QMXDEMOLABIOQMX00010 qws3 Note For changes to views made in an export file refer to the V and X seitings When SCCM packages are successfully imported into ChangeBASE the SCCM interface dialog will indicate this by displaying Imported under the Status column and the time of the import under the Imported column ad ChangeBaSt SCCM Itertace OOM Conaire Manufacturer Prya Taa CELAR GMN Fi m GUD ABM Fikes Tim kose Fieis Server 034 EFE i GUSDPMOLARGME Packages Pkg Tamd Mog Fijac Thag mponei 2012 11 12 1254 y Gey SOOM Pecuage source fee te tha following locator aiee paring mig Change EASE Liga thee option where the SUCM faijan wall be updated wth ary ii ties produced by Change BASE ups Yr Y a ciep Ca C If such packages need to be re imported for example after they have been deleted from ChangeBASE for some reason you will have to reset the import status by doing one of the following e Use the R flag in an amended export file refer to the R setting e Select the required package s right click and select Selected Item Reset Import Status Or 86 5 Importing Packages Quest ChangeBASE 5 3 User Guide e Check the required package s right click and select Checked Items Reset Import Status 5 2 4 CSV Import Applications can be im
175. icense Activation 39 211 License Expiry 41 License File 25 39 40 41 211 License Server 38 Licenses Swapping 40 Licensing 37 Flexible model 11 Offline 39 Online 37 LISTPACKAGES Command 213 LISTREPORTS Command 213 Loading Source Folders for Browser Compatibility 230 Loading URLs Auto Logon Process Overview 223 Settings 224 Auto Logon 222 Loading URLs for Browser Compatibility 222 Local Database 17 Setup 17 Log View 198 Manifest File 148 149 169 193 Manifests 12 148 220 Maximum Lease Time 157 Maximum No Simultaneous Imports 175 Quest ChangeBASE 5 3 User Guide Medium Calculations 139 140 141 Microsoft Office 14 15 93 2010 14 2013 14 Microsoft SQL Server 2008 18 21 44 Microsoft NET Framework 18 21 22 156 158 171 232 Middleware 93 179 217 Minimum DHCP Lease Time 157 Minimum Hardware Local Database Setup 18 MSI 11 14 16 22 24 25 33 61 64 75 78 83 87 90 91 103 104 105 106 107 108 109 111 112 119 134 146 152 153 154 155 156 161 164 165 166 167 168 169 174 175 179 180 184 185 187 198 199 200 213 218 220 Edit 200 Edit with MSI Studio 199 200 201 Edit with Orca 199 Extract CABs 203 Studio 153 MSI Studio 199 200 MSM 154 180 Multiple Databases 48 Multiple Transforms 174 Multi User Environment 31 Multi User Installations 25 Requirements 25 Optimization 26 Multi User Setup 23 N Netw
176. ide 3 Next select the OS and Architecture of the VM that will be used to virtualize applications 4 Select Apply Package Naming Mask if you want to define a standardized naming convention for the folder and virtual package filename The package naming mask can use the Manufacturer name Product Name Product Version and the MSI filename excluding the extension Click Configure Set the following options according to your environment td Virtualization AppV on Windows 7 64 bit VMWare Workstation Snapshot Name App V SP 1 VM User name ChangeBASE VM Password nero Power OF VM F Export Folder CAChange BASE App V Output Manual Configuration Timeout 10 seconds Each field that needs to be configured is explained below SETTING DESCRIPTION Hypervisor Selection C lmages Change BASE Win 64S5eq Win amp 645eq vr Browse lf VMware Workstation is selected click Browse and a text box will open to allow you to choose the location of the VMX file This is the Virtual Machine that should be used for conversions oe Libres h Du e Wet proses ob ATES hra bce p daa E hpb Dressed d Derloeded ir de hom d eels Documents library E Tt het ma AH 1era da Fort ke Gobet Help de mg d inf Fae emn Riepma WPi ma Select the required VMX file and click Open E Fie eran 161 11 Virtualizing Packages SETTING Snapshot Name VM Username VM Password Power Off
177. ile that can either be embedded inside the file or be a separate file as shown by red exe manifest in the screenshot at step 3 above The Manifest contains instructions on how the program is to be run and includes a setting for elevation The Elevated Privileges Detection test looks for Manifest files forcing elevation whereas this test looks for the keywords in file properties When the program is run the UAC prompt is shown allowing you to enter an administrator s credentials If they are entered then the program will run with those rights and be able to change settings that will affect all users Selecting No to the UAC prompt does not run the program with the user s credentials but it cancels the running of the program 8 4 3 Remediation Steps When you click the button to fix the issues a Manifest file will be created if one does not already exist and the executable will be forced to run with the launching user s credentials The main consequence of removing the elevation is that the program will be unable to make global changes affecting other users of the computer and if it tries to do so then it may crash or exhibit unusual behavior However this is often preferable to handing out the administrator password Executable files with embedded internal Manifests are not automatically fixed as there is a much higher risk involved in modifying an executable directly and so it is not something we currently want to automate You could
178. ileZilla _3 3 5 1 _wind2 s O m Reuters Messaging 7 Expand Collapse C Windows repack log CAWindows wingxs Install Temp CAM User Documents Farh C Documents and Settings e Application Data Microsoft Crypto s C Program Files amp 86 Common Files Install Shield Driver CA Users E App Data Local Microsoft Windows Game Egplorer Game Statistics TAMUser AAA App Data Local Microsoft Windows Temporary Intemet Files CAUsen A AppData Roaming Microsofti Windows Network Shortcuts CAMUsen W AA Documents Scanned Documents C MDocuments and Settings A Application Datat Microsoft Address Book CADocuments and Settings All Users Application Data Microsoft Crypto TCAAUsers AAA App Data Roaming Microsoft Microsoft Windows Libraries CAMUsen W AJ AppData Roaming Microsoft Microsoft Windows Recent C Documents and Settings SAA Application Data Microsoft credentials CAFrogamData Micrsoft Windows Caches CMUser Local Settings Application Data Identities Windows Repack be lov This interface allows the existing Files and Registry Keys that are being excluded to be modified Note It is possible to use both regular expressions and exact paths Import If an existing exclusion list needs to be added to ChangeBASE use the Import button INI and Excel files can be imported 100 5 Importing Packages Quest ChangeBASE 5 3 User Guide Backup Restore
179. import there will be changes made to the file system and registry by both the installation routine and by other processes which are not related to the installation routine The changes made by other processes are known as noise It is important that this noise is not captured by ChangeBASE so filters have been developed which define files folders registry that can safely be ignored during an import The filters can be downloaded from the Upgrade Tab on the Options screen Select the report group called ConvertlT Filters and click OK If you work in an offline environment and are unable to download the filters via the Upgrade Tab please contact Quest support enclosing a screenshot of your license details available on the Help About screen in ChangeBASE and these filters will be supplied as a CBP file In most cases the default values in the filters will not need modifying However if you notice that unwanted noise is being captured in the MSIs that ChangeBASE produces you can modify the repackaging filters To do so expand the ConvertlT Filters report group right click on Basic Filters then click Edit Repackaging Filters 99 5 Importing Packages Quest ChangeBASE 5 3 User Guide 10 Convert Fitters H E Core App List Ben Edit Repackaging filters packaging C Templates Update Report 0 Windows 7 Create Plug in Packages Delete DERGE Mowe Report iW ConvertiT Filters Basic F Copy Report E F
180. indows Control Panel ttem CPL ok Publisher Software Location C Windows System32 Cpl cpl Open the control panel using recommended settings This control panel works correctly What settings are applied Choosing Open the control panel using recommended settings will prompt a standard user for a password Choosing This control panel works correctly runs it using Windows file and registry virtualization causing it to run differently than it would on XP 8 5 2 Explanation of the Issue Control panel files do not get elevated on Windows 7 Windows 8 Windows Server 2008 and Windows Server 2012 so the Program Compatibility Dialog appears because the presumption is that they need elevating Open the control panel using recommended settings in an enterprise environment will not be very useful as the users will not have the administrator password This control panel works correctly will allow users to appear to change settings for which they do not have permissions Settings that the control panel attempts to write to HKEY LOCAL MACHINE in the registry will be redirected inside the user profile so that the setting will appear to be applied even if the particular user has no write access to the key in the registry As well as changing the intent of the permissions this may not work or they are to be read by a service Services run in a different account and will not be able to access the keys So in the scenario of migrat
181. ine License ich atic sos sices Sco ciwe aca sa oi ee ee esc cesad a 39 3 1 3 Swapping LICCISES ccccccccaecseceeneesecsuccucceccuseusessussuesecceceesuesuccecauceusensessusseceaees 40 3 1 4 Troubleshooting ARN en T ETE ETE E 41 el el PICCNSC EXPY raar nc a A N AE a ae N 41 3 1 4 2 Unlicensed Number Of Pa CKaQes cccsssccccseeecceneeeeeneseeesaeeessneeessaneeessauesessaenessanes 41 SABIE ee a 6 amet ieee a Rte ee eee 42 32 kkRenamNng lt 1 AI AO AS Ceci arts rer tart eae EEE bream ERREA AA 48 32 2 Malpie LD ARQ AS SS era as Soa oo ns csr E toasts og esac waves een einen wien cece 48 3 2 3 Creating a New Database if your SQL Server is centrally managed by a DBA 49 3 3 SQL related Troubleshooting icc cs cc cece secede idea catacedateeese 49 3 3 1 Failure to create a Database cccccccccccccccaeceeneesessucceccucceceesessussuceuseesessussusseees 49 3 3 2 Failure to connect to a Database ccccccccaccseneeneececcecceccuceesensessussuceseussussecseees 51 3 4 Configuring and enabling the Dashboard Components for the ChangeBASE DABAS O Co ee ee en ee er er nee ee ee nn meee en cen eer neers 53 3 4 1 Registering the Dashboard Web Application with the IIS Servetr c00000 54 3 4 2 Dashboard related Troubleshooting ccccccccecceccecsecseeseeecneceesecseesecsesueseeseeseees 55 342 1 INSUTIGIONE DIVIICGCS errre a E NE 55 3422 DOD ENO aote a A e aaa a a e a n 56 3 4 2 3 Windows Authentication related EsrrOrs
182. ing from XP to a later version of Windows the Operating System offers two choices neither of which is suitable 8 5 3 Remediation Steps Select all issues as suggested in the software and fix them It will add an XML Manifest file that will force it to work in the same way as it did on XP There are no problems associated with always fixing all issues 149 9 Assessing a Real World Package Quest ChangeBASE 5 3 User Guide 9 Assessing a Real World Package Bentley View 8 1 is compatible with Windows 7 according to Microsoft ChangeBASE however shows this package as Red for Windows 7 Why It s made up of around 2000 files ChangeBASE reports that one file is missing as part of the import process Low Severity Import Warning This is unlikely to have an impact on the compatibility assessment results The first Plugin with an issue is reporting a missing INF file LIP xs I Ley UT WE ri a l ET WE Le RL ee Old Kernel Mode Driver file found with no corresponding INF File ProgramFiles Bentley iWwiew Volviey indsysiasneededipointoals ix fLib all Old Kernel Mode Driver tile found with no corresponding IMF File ProgramFiles Bentley wiew vE Wew undisysiasneededipointoalsvibxmi2 dll Old Kernel Mode Driver tile found with no corresponding INF File ProgramFiles Bentley Wiew Yoiviev und ysiasn eded pointoals canitc mit all Old Kernel Mode Driver tile found with no corresponding INF File ProgramFiles Bentley Wiew Yoiview u
183. is Opera 9 23 E Create Issue Summary Report Orca Extract Cabs From Msi Sas QuickTimelnstaller Override All Issues SkypeSetupFull Specify Overrides EJ j w wn w i N oa o SmartFTP Client Repackaging Configuration SQL Server Query Ana Bulk Issue Summary WinZip 11 2 E Expand Collapse 999999 S9S SSS SSS OD BEEBE SHSSoBBBBBHTBEBB 2 Once the reports have been run against the package you will be asked which format should be used HTML or text The report will then be opened 6 7 3 Creating Bulk Issue Summary Reports 1 Select multiple packages by using either the CTRL or SHIFT keys Right click the last selected package and click Bulk Issue Summary J Packages iv 7 Zip 4 65 x64 edition V Access 97 Runtime Adobe Flash Player 9 Activex Delete Save Retrieve Reports S Alias SketchBook Pro 2 0 amp Checkin Re Import 2 Add To Matching Analysis E E chrome_installer FileZilla_3 3 5 1_win32 setup Specify Overrides Expand Collapse Opera 9 23 Orca QuickTimelnstaller W iv iM a w T W 2 Choose where the reports should be created and the report format and then click Start 118 6 Assessing Packages and Viewing Results Quest ChangeBASE 5 3 User Guide a Create Issue Summyek Pe Save output to package folders Save output to specifie
184. is the advised setting if you are Loading Source Folders for Web Data Capture and or Using Client Side Capture CSC e Web Based Applications Only ChangeBASE will import web content only for websites and web applications This is the advised setting if you are Loading URLs e Disabled No web content is imported 185 12 ChangeBASE Options Quest ChangeBASE 5 3 User Guide 12 11 Add In Tab The Add In Tab allows you to launch other tools from within ChangeBASE Click Add to display the following dialog Exe Path V Enabled Context Menu Options Menu Text Packages Reports T Multiple Selections Use Master ox canci Description Enter a description of the Add In that you would like to include e g the tool or package name Type ContextMenu Exe Path Browse to the path of the EXE that you would like to launch In the example below the InstEdit EXE file has been used Enabled This option is always selected by default but should be deselected if you would like to temporarily disable the Add In Menu Text This is the text that will be displayed in ChangeBASE Packages Enable this right click option on packages Reports Enable this right click option on reports Multiple Selections Allow multiple selections Use Master Use the original file from the source rather than the file in the Working Directory 12 12 Repackaging Options Tab Here the Virtual Machines used for importing l
185. ise Internet Connectivity Recommended It is highly recommended that an internet connection is available when using ChangeBASE as the licensing model software updates and Plugins are dependent on this If this is not possible please contact Quest Software to discuss alternative methods Dashboard viewed in Windows Server Environments When viewing Dashboard pages in Windows Server 2012 the Desktop Experience Windows feature must be enabled and the IE Enhanced Security Configuration IEESC setting must be turned off When viewing Dashboard pages in Windows Server 2003 and 2008 including R2 the IEESC setting must be turned off 2 Installation Quest ChangeBASE 5 3 User Guide 2 1 2 Remote Database Setup In the event that more than one user connects to the same database the ChangeBASE client software may be installed on each of the workstations and the database hosted ona central machine Database Dashboard i nai A Quest SQL IIS ChangeBASE Server Components i P lt Ma Quest 2S Quest ChangeBASE ChangeBASE Dashboard can be Client Client accessed by any machine via a web browser 2 1 2 1 Dashboard Setup Dashboard is installed as part of the ChangeBASE installation by the Server Components feature via the drop down option Will be installed on local hard drive 15 ChangeBASE Setup Lo ea Custom Setup Quest Select the way you want features to be installed Cha
186. isted in these libraries and when a new version is released where the functionality is fixed they don t function any more 2 DLL Stomping Different installers have the ability to replace libraries on the file system with older versions Software vendors often wrote their own installers that ignored versioning rules as a consequence Windows Installer handles these correctly and will only be able to update any library if it has a newer version With Windows 7 comes the additional security of Windows Resource Protection which means that the Operating System will prevent certain files and registry keys from being replaced if they are not installed with the trusted installer 3 Incorrect COM Registration In COM the registry is often used to determine the underlying resource that should be used If the COM information in the registry is overwritten it could result in an incorrect resource being loaded which could cause the application to fail 4 Shared in memory modules This only applies to 16bit resources 32 bit and 64 bit resources can be loaded into the memory simultaneously apart from when they are in the same folder when memory mapping will occur Other issues that we want to know about e INI Files being overwritten e Registry Values being replaced e ODBC settings being over written e File Associations being replaced e Files and Registry keys that will be removed during uninstallation 206 13 Advanced Usage Quest
187. ithin your organization 8 3 Hard coded File References 8 3 1 How to Reproduce the Problem Install the software in your target environment and run through the test plan provided by the users checking the original requirements documentation that is associated with the package When you test it there will either be parts of the software that malfunction or settings that are not valid 8 3 2 Explanation of the Issue Whether virtualizing moving to a 64 bit Operating Systems or upgrading from XP to Windows 7 there are paths that have changed For example e App V packages are installed to Q instead of C Program Files e 32 bit software is installed to C Program Files x86 instead of C Program Files on 64 bit Windows e Windows 7 s user settings are stored in C Users instead of C Documents and Settings on Windows XP The majority of paths inside an installation package are tied to properties and variables so that when they are deployed in a different environment from the one for which they were designed and tested everything still works 8 3 3 Remediation Steps In all cases it is safe to select all issues followed by Fix It Where a path has been hard coded to a drive other than C ChangeBASE will replace the root with a property called CBDriveRoot where is the drive letter leaving you to check that it will still be installed to the same mapped drive in the new environment If it has changed then all you need
188. izing EXEs and manual configuration In some scenarios it will be necessary to virtualize packages where the installation source is an EXE file You also may want to override the default settings when creating a single virtual package from multiple packages These settings are configured in the Sequence Configuration dialog There are three ways to access this dialog 1 Check multiple MSI packages click Virtualize then click Manually configure 2 Check an EXE package or packages with or without other MSIs being checked and click Virtualize 3 Check any number of packages by holding down the Shift key and click Virtualize D Apps Sample Todd 7z 7z920 x64 msi Sequence Name Test Virtual App D Apps Sample Todd ACDsee_9 0 ACDsee msi ple Todd AdbeRdr1 ne en_US AcroRead_ msi Default Arguments qn Plugin AppV on Windows 7 64 bit Detect MSI Install Path Property AppV only Manual post install application configuration seconds E Test Virtual App AppVWin764 dll g 2920x64 msi E AcroRead msi i AcroRead_FixesApplied mst Package details Package path D Apps Sample Todd 7z 7z920 64 msi Arguments an INSTALLDIR installpath Manual install allow manual installation of package during sequencing Use Converted MSI ls a Prerequisite install this package before capture starts Copy all source media copy all files located in the package path Save manifest OK 167 11 Virtualizing Package
189. lagged by a specific report wa ChangeBASE pe Tas ChangeBASE a Packages Report N Name D E Ficomment seag V Reports V virtualisation App V Windows 64 bit V 16 bit File Analysis v1 02 Acrobat Refresh Results Non supported 16 bit file found C Program Files x86 4dobe Acrobat 5 0 DistillriXtras adist5 alll Clear Results EASE cemecmantts HOD Standalone v8 VY 32 bit NameSpace Detection v1 00 iv 64 bit Registry Reflection Deprecated APIs v1 01 v DirectX Video Acceleration API Analysis v1 04 v Non Supported Drivers Server and 64bit OS v3 31 i Non Supported YDM Functions and Registry Settings Analysis 64 bit v1 00 iv PAE and AVVE API Analysis v3 27 Summary Packages Reports Rules tS Scanned Rules Sasa Issues Upgrades Available iY Windows 16 bit Deprecated API Analysis v3 30 V Windows 7 sqlexpress Test Database 6 6 Viewing Results Assessment Results The Assessment Results drop down menu in the Reports panel gives access to a number of built in reports The reports are generated by checking the packages to be included in the reports then clicking Assessment Reports and the report name Note that the report will only include the checked packages Refresh Results Clear Results Assessment Results Summary Profile Profile Post Fixing Packages By RAG Report Group By RAG Report By RAG Package Issue Summary Csv Export Dashb
190. list of SCCM servers are as follows e New To configure a new server database Refer to 5 2 3 3 Configuring a new server database e Properties To display details of an existing server database 76 5 Importing Packages Quest ChangeBASE 5 3 User Guide e Delete To remove a server database from the ChangeBASE system A This will also remove all data associated with that server database excluding any packages already imported e Packages Refresh To extract information from the packages programs within the selected SCCM server database This information is retrieved using the Refresh button The Packages button displays the packages programs found during the refresh process At this point the packages programs have not been loaded into ChangeBASE 5 2 3 2 SCCM Options The SCCM options dialog will appear if you click the Options button from the main dialog SCCM Options View Name Format OSHA SHG Sample SeomServer Quest ChangeBASE 5 1 EN US The View Name Format consists of substitution values as shown below plus constants The Sample field shows what the resulting format will look like when processed Substituions values 0 Scem Server Name 1 Scem Database Name 2 Scom Package folder 3 Manufacturer 4 Package name 5 Version 6 Language 7 Package source folder 8 Scem Package ID Search Distribution Points as well as package source 7 Loader Support ean The options allow yo
191. lx FileZilla Win32 Microsoft_VC90_CRT_x86 __ FrontRange Solutions Goldmine 5 5 Microsoft_VC90_CRT_x86_x gt HotDocs 2008 Professional Edition Microsoft_VC90_MFC_x86 _ HotDocs 2008 Professional Edition Microsoft_VC90_MFC_x86_x Hyperion Smart View for Office Microsoft_VC90_MFCLOC_x InstEd 1 5 13 24 Orca Log Parser 2 2 Overtime Tracking System 4 m b V Display Product Name OK Cancel 2 Choose the packages to be added to the View by selecting them in the right hand window 3 Click asl The packages will be added to the Packages panel 4 You can add Sub Views to further organize your packages by right clicking on a View and selecting Add Sub Item For example you might want to set up a Workflow View with various Sub Views e _ wait Organise Views Sa oe x Views Packages Marketing Adobe_Acrobat_5 05_All ENG V3 0 msi 70078S rmsetup msi Quest Workspace ChangeBASE 5 SCCM Adobe Reader 7 0 msi i Text Adobe_Photoshop_Elements_2 0 2 0_P1 1_GLOBAL msi Workflow BO XI Rich Client XX R01 B02 msi 5 1 Discovery Broker Tec msi i a honed ClarityActiveXComponent msi EASE 4 0_ICE64 msi_ 1281629359438750000 msi 4 UAT lt EROOM 742 XX R05 B01 msi __ FTPVoyagerBatch bat gt FTPVoyagerSetup exe InstEd 1 5 13 24 msi InstEd 1 5 15 26 msi Orca v3 1 3790 0000DesktopShortcut Msi Proof msi 4 WW j E Display Product Na
192. mand Line Arguments Support Files Y N AutoComplete Folder Launch Application Manufacturer View AppID D ChangeBase InstallableApps WinZip msi N N WinZip 0 Compression Winzip A sample file for the CSV import is provided as part of the ChangeBASE installation and is named BulkCSVimport csv This will be located in folder C Program Files x86 Quest Software ChangeBASE Once the import file has been configured applications can be imported into ChangeBASE 1 Click CSV Import Browse Browse with SCCM CSV Import lt ASS5655 Virtualize 88 5 Importing Packages Quest ChangeBASE 5 3 User Guide 2 Click Browse and select the CSV file that has been configured for import If the first line of the file contains header information as is the case with the provided sample file ensure that the Has Header Row box is checked ml CSV Package Import Import File C ChangeBASE CB_CSV_Import csv Has Header Row 3 ChangeBASE will read the CSV file If all the parameters for an application are configured correctly a green check will appear in the Valid column If there are errors look in the Reason column fix any issues and repeat this procedure from step 1 P w CSV Package Import o EJ Product Produ Aut Support Arguments Nome Versior Manufacturer View App ID s Complete Pies Vaid Loaded Eror Reason D AChangeBase lnstallableApps WinZip 0 Compression E E Statu
193. manual intervention to choose the correct options e Some installer dialogs contain buttons which cannot be programmatically detected and clicked Java based installations for example For these installations it will be necessary to manually click on the dialog buttons to progress the installation Allows an application to be converted on any available Virtual Machine or a specific Virtual Machine Specify any custom MSI properties that should be added to the MSI produced by ChangeBASE The default properties that will be pre populated are Manufacturer ProductName and ProductVersion ne 103 5 Importing Packages Quest ChangeBASE 5 3 User Guide SETTING DESCRIPTION MSI Copy Filename In cases where the MSI package produced by ChangeBASE is required for installation the MSI Copy Filename field should be edited with a path and filename by clicking the folder button This file will be created when ChangeBASE converts the legacy installer into MSI format Intermediate CAP This option allows a CAP file to be used However in most cases it Filename is no longer used Launch Application Where VBScripts are imported this field will automatically be populated with WScript This is the script host for running VBscript on Windows Alternative script hosts such as CScript can be specified if required Unrestricted Capture This option forces ChangeBASE to monitor all processes on the Virtual Machine and not just the proce
194. mapped to this login Securables Map Database User Default Schema c 7 AOKCSCManager CBLogin dbo aa Demo E lETesting F master F model F msdb F POC E tempdb s Database role membership for AOKCSCManager Connection db_accessadmin Server F db_backupoperator localhost sqlexpress V db_datareader Connection v db_datawriter PROD bnel Fea b ddad ee i F db_denydatareader 3 View connection properties F db_denydatawriter F db_owner Progress E db_securityadmin 7 public Ready Eee 3 4 2 2 999 Error If you see the following error message inostics _ Options x P General Issue Summary Core App Lists Platforms Upgrade Services Security Report Costs Duplicates Add In Repackaging Options Dashboard virtualize Other Status Dashboard version 1 0 1 10 currently installed and is enabled Uninstall Disable Not registered with IIS server CMDS2189 Dashboard Refresh Executive Summar y Platform 1 Platform 2 Piattorm 3 Plat m x Browse wi a Title Executive Summary CSV Impo f Register request failed 999 Report groups to include A There was a problem trying to connect to the web server C MSI Installer Integrity CMDS2189 Dashboard Please ensure the you have the correct T Office 2007 Application Compatibility name for the server and that that it has been started Virtualisation Citrix XenApp hosted and MS RDS
195. me OK Cancel 192 13 Advanced Usage Quest ChangeBASE 5 3 User Guide These Sub Views are then displayed as follows when you select the Workflow View Fm Fe V Packages j i Workflow 4 Discovery IW Adobe _Acrokat_5 05_All ENG 3 0 mei Fil 2 Assesamnen Fal Adobe Reader 7 0 msi MF 3 Packaging lear Results m Adobe Photoshop Elements_2 0 2 0_P1 1_ GLOBAL msi Assessment Results j E 4 UAT 5 Clicking OK will return you to ChangeBASE where you can now filter the packages using the Views filter shown in step 3 Views and Sub Views are shown in Green 6 After running reports the total RAG status is shown on the View s row Note You can link a View to a report group so that when the applications associated with that that View have the characteristics that you specified in the report group they are grouped together on the interface To set a report link right click on the required View and select Set Report Link w Organise Views Views Packages assyst Enterprise 3 0 Dragon NaturallySpeaking 10 Rename Add Sub Item Import Set Report Link 13 1 5 Virtualize from Manifest This option allows you to virtualize packages by selecting a Manifest in XML format Refer to 11 3 4 Package Virtualization Using a Manifest file 193 13 Advanced Usage Quest ChangeBASE 5 3 User Guide 13 1 6 Expand This option expands the list
196. mes A report identifier is required by the REPORT command Example cbExec LISTREPORTS WBDB1 13 6 4 LISTPACKAGES This lists packages in a specified database returning a list of package identifiers and associated package file names Package identifiers are required to define a set of explicit packages against which to run the report Example cbExec LISTPACKAGES WBDB1 13 6 5 REPORT This run a report in a specified database A report can be executed against all packages in a database or against an explicitly defined set of packages Example cbExec REPORT WBDB1 2698da37 ef2f 4303 ad8c 7c 73a120191f cbExec Fc temp PkgList dat REPORT WBDB1 2698da37 ef2f 4303 ad8c 7c73a120191f The first example runs the specified report against all packages within WBDB1 The second example runs the specified report against the list of package identifiers within PkgList dat This is a list of identifiers from LISTPACKAGES Each identifier is listed on a new line 13 6 6 EXPORT Export from a specified database Example cbExec EXPORT WBDB1 X6 C temp test csv This exports one of the in built ChangeBASE reports to a specified file The X argument indicates which report is to be exported The table below lists identifiers for each report Summary Profile Profile Postfix 13 Advanced Usage Quest ChangeBASE 5 3 User Guide Packages By RAG Reports By RAG CSV Package Issue Summary Raw XML
197. met all the system requirements 2 If running SQL Server and ChangeBASE on separate machines The SQL Server Browser service must be running and set to Automatic in the machine where SQL is installed Both SQL Browser Service and SQL Server must be allowed through your firewall The TCP IP protocol must be enabled Both TCP IP and SQL Server Browser can be configured in SQL Server Configuration Manager wm Sql Server Confiquration Manager File Action A SQL Server Configuration Manager Local F SOL Server Services i SOL Server Network Configuration 32bit gt a SQL Native Client 10 0 Configuration 32bit gt H SQL Server Network Configuration gt a SOL Native Client 10 0 Configuration View Help aw Sql Server Configuration Manager File Action es Ales a SQL Server Configuration Manager Local F SOL Server Services H SQL Server Network Configuration 34bit gt a SQL Native Client 10 0 Configuration 32bit 3 SQL Server Network Configuration He Protocols for SQLEXPRESS gt a SQL Native Client 10 0 Configuration View Help Name State Fr SOL Server SQLEXPRESS Running Fim SQL Server Agent SQLEXPRESS Stopped D SQL Server Browser Running Status Enabled Disabled Frotocol Name Y Shared Memory y Named Pipes LLS Enabled VIA Disabled Start Mode Automatic Other Boot Automatic 3 Ensure that the Working Directory location has been considered and a sh
198. modify the internal Manifest manually by downloading a tool from htip www resedit net which can be used to modify the Manifest There is a guide on how to do it here http csi windows com toolkit 240 great pe editor for internal manifests As an alternative you could use the ACT from Microsoft and create a shim Whichever technique you use you will need to set the execution level to asInvoker 8 5 Legacy Control Panel Applets 8 5 1 How to Reproduce the Problem This rule is important because there are differences in behavior in the way that control panels will work on Windows XP and subsequent versions of Windows Before you test the software on Windows 7 Windows 8 Windows Server 2008 or Windows Server 2012 you should in order to be able to tell the difference familiarize yourself with the way that the control panel was previously working on Windows XP in a standard user s account When you run the control panel in the later version of Windows you will observe the following e Settings that were unable to be changed on XP will be able to be changed by closing and reopening the control panel 148 8 The Top Five Issues Explained Quest ChangeBASE 5 3 User Guide e Once the control panel is closed you will receive a Program Compatibility Assistant prompt e g s Program Compatibility Assistant Did this control panel item work correctly If it didn t try using settings that are compatible with this version of W
199. n be assigned for either Windows or SQL Security 27 2 Installation Quest ChangeBASE 5 3 User Guide Windows Security SQL Server Active Directory SQL Login PROD ChangeBASE Users User mapping to CB1 db datareader db datawriter SQL command on CB1 Grant Execute to PROD ChangeBASE Users ws Database CB1 SQL Security Domain PROD SQL Server SQL Login ChangeBASE Users User mapping to CB1 db datareader db datawriter SQLcommand on CB1 Grant Execute to ChangeBASE Users 9 Database CB1 The detailed procedure encompassing both methods is as follows 1 Create a new login as follows a Expand the Security folder of the SQL Server b Right click on Logins and select New Login l aangal CP Canas Lina Chica ee re JEME J File dt View Debug Tools Window Commundy Help New Query D Gs a F Object Explorer Conect Y o T Ea i localhost glenpress SOL Serri 10 50 1617 PROD brel Databsses tart Powershell Repoets Refresh c If SQL Security is being used select SQL Server Authentication and go to step 2 If Windows Security is being used you need to create a new login for an Active Directory based user or group Therefore select Windows Authentication and then go to step 1d 28 2 Installation Quest ChangeBASE 5 3 User Guide g Login New Select a page A General _ Server Roles User Mapping LAA Securables LA Status
200. n process works in App V by using key clicks the appearance of these tooltips could upset the key click process causing the virtualization process to fail You can avoid this situation in either of two ways Or Set the screen resolution of the Virtual Machine to 1024x768 Change the registry so that tooltips are disabled on the Virtual Machine There are two reg files included in the ChangeBASE installation Disable Balloon Tips XP or Vista reg and Disable Notifications Win7 reg Both files can be found in C Program Files x86 Quest Software VReady AppV Disable Balloon tips reg files zip or wherever ChangeBASE is installed Simply unzip the reg file that is relevant to your Virtual Machine s operating system and install it 159 11 Virtualizing Packages Quest ChangeBASE 5 3 User Guide 11 2 4 Virtual Machine Setup Citrix XenApp Streaming Profiler 6 5 1 Install Citrix Streaming Profiler 6 5 2 Reboot the machine if prompted 3 Ensure there are no unnecessary packages running on the Virtual Machine that may be updating files for example Windows Desktop Search 4 Leave the machine idle for around 10 minutes This will create a better session as most of the locks will be cleared by that point 5 Snapshot the Virtual Machine whilst it is running 6 Shut down the Virtual Machine Start gt Shut down or just power it off 11 2 5 Virtual Machine Setup VMware ThinApp 1 Install VMware ThinApp 4 6
201. n you performed WorkBenchSettings xml which is used to store all the settings configured within the ChangBASE Options The other main folder is the Working Directory which is defined during the initial creation of a database refer to 2 1 4 Working Directory and is typically located on a network share so that all users of the solution set have access to the centrally shared information There is always one Working Directory per database Each Working Directory contains the following sub folders The HTML folder which is no longer used The Logs folder which is used to store output from virtualization The MSIXML folder which is no longer used The Packages folder which contains cached MSIs and MSTs that have been imported into the database The Plugin folder which contains Plugins that are generated using the Report Generator This functionality is only available with the Plugin editor The PluginSource folder which is the location for any files to be added by a Plugin It is a local cache for Plugins The Workfiles folder which is a temporary staging area for system use The WebTmp folder which is only utilized when importing web data The XMLData folder which contains a cache of files used by ChangeBASE such as the latest viewed CSV and HTML reports 211 13 Advanced Usage Quest ChangeBASE 5 3 User Guide j You can check the location of the Working Directory for a database by right clicking the associated data
202. ndler TdsParserStz System Data qlClient Sql InternalConnectionTds CompleteLogin Boolean enlistOK 35 System Data SqlClient Sql InternalConnectionTds AttemptoneLogin ServeriInfo serverInfo String newPassword Boolean ignoreSniOpenTimeout TimeoutTimer timeout Sqlcc System Dats SqiClient Sq InternalconnectionTds LoginNoFailover ServerInfo serverInfo String mewPassword Boolean redirectedUserInstance SqlConnection owningdbjec System Data Sq1iClient SqliInternalConnectionTds OpenLoginEnlist SqiConnection owningObject TimeoutTimer timeout SqlConnectionString connectionOptions String newt System Data SqIClient q liInternalConnectionTds ctor DbConnectionPoolidentity identity SqiConnectionString connectionOptions Object providerInfo String newPassr System Data qlClient q lConnectionF actory CreateConnection DbConnectionOptions options Object poolGroupProviderInfo DbConnectionPool pool DbConnection owningtc System Data Provi derBase DObConnectionFactory CreatePoo edConnection DbConnection owningConnection DbConnectionPool pool DbConnectionOptions options 33 System Data Provi derBase ObConnectionPoo CreateObject DbConnection owningObject 524 System Data ProviderBase ObConnectionPool UserCreateRequest ObConnection owningObject 66 System Data ProviderBase DbConnectionPool GetConnection ObConnection owningobject 479 ofa fon Teal E Local intranet Protected Mode Off Fa 10 4 then this indicates that yo
203. ndsysiasn eded pointoals SMLib all This is the folder belonging to those files Program Files Gentley View imalsys tas needed pointools File Edit View Favorites Tools Help Address Program Files Bentley view mdlsysasneeded pointools A 3 AAA cw dll Base dll Lib all iQOpen dll ixFLib ll lib lt ral2 ll 4 a YF FF A A AB POD Writer dll Pointoolsvo PeeReader scanifc mt dil scannermod SMLib dll pointools cat As shown by ChangeBASE in order to install driver files with a CAT file you also need an INF file There is a missing file Looking at the name of the folder buried deep in the Bentley folder structure it is called as needed which might indicate that it is not used very often It is possible that this deals with an area of functionality that is so rarely used that it slipped by the Microsoft testing lab and past Bentley s QA The other Plugin with an issue has found some API calls 150 9 Assessing a Real World Package Quest ChangeBASE 5 3 User Guide Windows 64 bit Call reference to a Deprecated API AT File bentleydgn dill SP allocateuserphysicalpages Call reference to a Deprecated API CAT File bentleydgnidll SP freeuserphysicalpages Call reference to a Deprecated API MAT File bentleydgnidll SP mapuserphysicalpages This file bentleydgn dll has three references to functions that cannot be called on 64 bit Windows ChangeBASE is unable to see whe
204. ne starts the capture but no content is captured 1 Create a batch file in the same folder as the installer file 2 The first line of the batch file should call the installer file e g setup exe 105 5 Importing Packages Quest ChangeBASE 5 3 User Guide 3 The second line should contain the word pause This will pause the conversion process once the installer has completed install bat Notepad re el E File Edit Format View Help setup exe pause 4 Drag the bat file onto ChangeBASE 5 Click Import 6 Monitor the Virtual Machine as ChangeBASE imports the installer 5 6 3 The Repackaging Process results in an MSI with no Files Symptoms When you view the MSI created by ChangeBASE the File table is empty 1 Ensure that the installer does install files It is possible that the installer is launching a process which is not part of the same process tree This prevents ChangeBASE from capturing any installed files 2 Create a batch file as shown in 5 6 2 The Capture Process terminates before the Installation has completed 5 6 4 The Package fails to Import Symptoms A red X is displayed when you attempt to import the package e g Filezilla VWin32 Tl C Users joreen D j iiias High Severity Import Warning HotDocs 2008 Professional Edition Failed to find file dunzip32 dll ease ri click View see errors HotDocs 2008 Professional Edition Please right click and View Log to see all error La
205. neous section and ensure that Launching packages and unsafe files is enabled 171 11 Virtualizing Packages Quest ChangeBASE 5 3 User Guide Enable E Prompt _ Indude local directory path when uploading files to a server Disable Enable Enable not secure Prompt recommended _ Launching applications and unsafe files not secure Disable Enable not secure Prompt recommended _ Launching programs and files in an IFRAME S Disable I Brakle fret eos 4 I Takes effect after you restart Internet Explorer Reset custom settings 172 12 ChangeBASE Options Quest ChangeBASE 5 3 User Guide 12 ChangeBASE Options 12 1 General Tab i Options rs Report Options File Extensions automatically added during folder scans Retain Report Results On Tab Change Show Checked Out Packages Only File Extension Confirm Clear Results DCAP d Transforms EXE v 7 Generate Transforms VBS Roll up Fixes BAT Suppress Transform Validation Errors CMD Z Auto Select Single Transforms INF Package Importv Fix OSI J Backup MSI Before Applying Fix Database Options Import Non Core MSI Tables ee ay ae 30 2 Import COM Snapshot Data Connection Test Timeout Secs 205 CheckoutPackages Automatically Maximum No Simultaneous Imports 5 Remote DB Server Install Folder PE File Extension Additions OK PF Cancel 12 1 1 Report Options Retain
206. ng a Package without Transforms Where there are no Transforms involved you will simply see Edit MSI with MSI Studio for ChangeBASE as a right click option Selecting the option loads the selected package into MSI Studio for example Fr MSI Studio for ChangeBASE RealPlayer Intranet o mean File Edit Tables Validation Tools View Window Help er X sp B GHG GBF e 2 Project Details a j Product Details gt Add Remove Programs Upgrades Application Requirements 8 0 Installation Properties i Project Organization Files And Registry Default Directory C Program Files amp 86 Real gt Files Registry Merge Modules Upgrade Code 12DF2F79 FD03 482D A107 72186 Permissions V Path Variables General Information Shortcuts and Other Items RealPlayer Intranet Manufacturer lt Enter Product Manufacturer Here gt Product Code F0C62754 15FF 46C8 A764 305F 1k ap Shortcuts Title z T INI Files ODBC Subject Real Player E3 Environment Variables Service Management a File Extensions 7 COM Advertsing Dialogs And Actions Dialogs Dialog Sequencing 7 33 Event Sequencing 7 Custom Actions Tables View HH _InstallValidate H Required HJ Sequence HH _Validation HH Action Text H AdminExecute Sequence Author Package Code 557D163C 7494 4F42 AD6D 87B1 Create If you save the MSI Studio project the timestamp of the MSI file cha
207. ng into ChangeBASE Use the option where the SCCM folders will be updated with any fix files produced by ChangeBASE Also ensure that you have specified browsed to the required location in the box immediately below the field By default only those packages programs that are advertised and can be imported into ChangeBASE are shown This can be modified by right clicking and selecting the Show Unadvertised Programs and or Show Unsupported Types menu items You can alter the column width and order at the top of the dialog The last settings are saved for the next time You can limit the number of packages programs shown at a time by clicking the lt number gt per page drop down This can be switched to Unlimited if required You can also click a column header to display the column sort and filter dialog allowing you to sort a column ascending or descending or to filter the items shown by the values in that column P H i 941 Select Al Ca J MS kage E mM OK Cancel 81 5 Importing Packages Quest ChangeBASE 5 3 User Guide When a filter or sort is selected the down arrow on the column header will change color to show that a filter sort is in place on that column In the example below the Manufacturer column has been filtered only to only show packages programs by certain manufacturers ie ChangeBASE SCCM Interface f SC Catena P CMD GOL a bagr LH FEREKA W Bipra hean a mera mis Cha AE Lee ae BF Sere See
208. nges so that when you Close MSI Studio for ChangeBASE the package will be seen in ChangeBASE as out of date A red icon is therefore displayed in the Package out of date column RealPlayer_RolledupFixes mst If you select Re import from the right click menu the red icon will disappear once the file has been re imported 13 2 8 2 Right clicking a Transform You will see Edit MST with MSI Studio for ChangeBASE as a right click option Selecting the option opens MSI Studio for ChangeBASE and loads the MST along with the MSI to which the MST belongs If you save the MSI Studio project the MST s timestamp changes so that when you close MSI Studio for ChangeBASE the MST will be seen in ChangeBASE as out of date A red icon is therefore displayed in the Package out of date column 200 13 Advanced Usage Quest ChangeBASE 5 3 User Guide RealPlayer Intranet v j5 amp f bai This is not propagated up to the package level so if the package is collapsed so that the Transform is not displayed the package will not show as being out of date The same would be true if you had saved the changes as a new Transform 13 2 8 3 Right clicking a package that has Transforms You will see Edit MSI with MSI Studio for ChangeBASE as a non selectable option that provides a sub menu e g Delete Save Retrieve Reports Select App IDs Open Containing Folder View Dependencies View Log Edit MSI with MSI Studio for Ch
209. ning Folderf ccccccccccccseceeneenessuccucceccuccucuseesessucsensesessessessueseces 195 13 2 5 View DODONCeNniGlOS 1ccccceccecccccecceccucesensussussuccucceccunsusensucaucauseesessussessucceees 195 PO VEW By a er A IO A A oe ee eC To 198 13 2 7 Edit MSI with OF CE aaa osivcc sees sen oslo stedeneretecinst scenes ielen edad ed ex olen ealexe wi edionsiovaddeesieensibendoeds 199 13 2 8 Edit MSI with MSI Studio for ChangeBASE cccccccccecececececnecneseeneeseeeeees 199 13 2 8 1 Right clicking a Package without Transforms cccccseeeecseeeeeeaneeessneeessaneeeseaeeenes 200 13 2 86 2 Right clicking a Transtorn nesretne e E a 200 13 2 8 3 Right clicking a package that has Transforms c ccccccsecccseeccsnecceseecssesesseeseeeeeeaes 201 13 29 View HISO ane ee ee ee a a eee ene a eee eee 202 13 210 Gg 2 c n een ee eee e TN aa a na EE 202 Led VRC INO OU sticks ieeretsitje sin ila E Eana TETRA EAEAN EENE AERE n ee 202 13 2 12 Add to Core App LiSt aan ee 202 2 SAGO COV AUCITIING PAIN IY SUS esses AEE ieee ERRE EREEREER EEEE E EEE 202 13 2 14 Create lssue Summary REPOST ccccccceenecseccecceccuccuceuseesessussucceccecussesseeeeees 203 ZII EXTIC CABS TOM MO lerri EEEE E E TOOTE EEEE TEE 203 T2 N OVA dOS raa ee ee 203 To 2I A VOWS rena aa 203 t32 10 PUK AS SUC SUMMA Verea E e aa aa a a aiaiai 203 13 2 19 Expand Collapse cccccccccnecceccsccsccuccuceusensessuesucceccuccunausecseccuceusensessassussecseees 2
210. ning Table msiCCPSearch 0 Row s Load MSI Tables Scanning Table msiCheckBox 1 Row s Load MSI Tables Scanning Table msiClass 2 Row s Load MSI Tables Scanning Table msiComboBox 1 Row s Load MSI Tables Scanning Table msiCompLocator 12 Row s Load MSI Tables Scanning Table msiComplus 0 Row s Load MSI Tables Show All z Save As Go to the point at which the package failed to load and trace back the previous steps to establish the cause Most of the messages will be self explanatory However the following bullet points may help Is it a duplicate Any duplicate packages will be marked as such when you hover over the red cross icon in the Issues column This information is stored in the log file Is software on the Virtual Machine causing issues If the log file shows that the import process repeatedly fails at the same point for different packages and ChangeBASE has already created the MSI then the issue is likely to be caused by 107 5 Importing Packages Quest ChangeBASE 5 3 User Guide a package killing the process This can be caused by anti virus software or packages such as VMSphere on the host machine e Are there any VIX errors VIX is used by ChangeBASE to interact with the Virtual Machine If the ChangeBASE log file contains VIX errors then the following may help with troubleshooting http www vmware com support developer vix api vix1 7_reference errors errorsList h
211. ning below these recommendations then you should consider increasing the Server Timeout setting in Options gt General to give the conversion process more time to complete the maximum available setting is 90 minutes Space requirements for the database are 8GB per 400 packages 18GB per 1000 Additionally twice the space taken up by the portfolio on disk must be allowed for the working package that ChangeBASE keeps in its cache e g a 200GB package portfolio would require an allowance of 400GB If you have the Always Analyze option checked for Web Analysis Mode in the Browser Compatibility Tab under Options then ChangeBASE will import web based content from every loaded item MSI files OS image CSS files HTML files This is the recommended setting if you are Loading Source Folders for Web Data Capture and or Using Client Side Capture CSC The recommended setting if you are Loading URLs is Web Based Applications Only so that web content is imported only for websites and web applications If you are not using the Browser Compatibility module you should set Web Analysis Mode to Disabled 2 1 6 Deployment to Virtual Machines 2 1 6 1 Client Whilst it is technically possible to install ChangeBASE inside a Virtual Machine and achieve full functionality this is not supported due to the intensive processing required 2 1 6 2 Database Where sufficient resources are available SQL Server may be installed in a virtual environme
212. nstall correctly However the workstation user environment or application may not behave as expected Fix Logic if Fix available An automated fix for this issue is available through ChangeBASE Updates are automatically generated that correctly set the target package s registry configuration 64 4 ChangeBASE User Interface Quest ChangeBASE 5 3 User Guide iM Windows 7 Active Di ectory GPO Settings Analysis v3 30 s i r bce EES tale pee tee te Fal Common Dialog Compatibility Analysis v1 OB gaia This ChangeBASE Plugin analyses each loaded and selected W Custom Action Security Scan v3 18 application package for registry entries that peasy corresponding registry settings included in the Windows Vista Windows 7 V Deprecated API Analysis v3 27 standard Active Directory AD Group Policy Objects GPOs This WW Elevated Privileges Detection v1 04 bead raisean fico ate these registry settings are i GMA Deprecated Component v3 16 Fal Hard Coded File References Scan v3 42 J Install Logic Scan v1 12 FJ Interactive Service Scan v1 00 Fal IPv6 Networking Scan v3 14 Fj IPv6 Strong Host Check v3 14 Fal Legacy Control Panel Applet Scan v3 17 FJ Legacy Help File Scan w3 25 Fi Microsoft Message Queue Analysis v1 06 Al Mamed Fipe Hardening Analysis v3 14 Fal Nested Install Scan v3 14 Fal METODE Deprecated Component Scan v3 17 Mon Supported Drivers 32bit O53 v3 31 Fj Mon Sccessibl
213. nt 2 1 Deployment to Remote Desktop Services Terminal Services ChangeBASE is not supported in a Remote Desktop Services or Terminal Services environment 24 2 Installation Quest ChangeBASE 5 3 User Guide 2 1 8 Database Backup Requirements e tis recommended that the database is installed on a centrally managed server e Daily incremental backups should be taken and a full weekly backup should be taken of all the databases Working Directories saved XMLs and Excel reports AOK cbl and WorkBenchSettings xml should also be backed up on a weekly basis refer to 13 5 Important Files and Folders for their location e The file server or folder where the source files are stored should also be incrementally backed up daily with a full back up on a weekly basis The term source files is used to describe the MSI files or other installation types along with all source files required for the installation The source files are required for the complete dependency analysis of the installation packages to analyze API calls dependent files and file header analysis 2 1 9 Recommended Configuration for Multi User Installations File server Database Dashboard Hypervisor Working l directory ChangeBASE Server Components uest Quest Change BASE ChangeBASE Dashboard can be Client Client accessed by any machine via a web 4 RDP to ChangeBASE browser client over WAN Se connection Important If you have a li
214. nt FOE Al CAW UFO A raa h GE Adobe Acrobat 3 00 All CNG Vo ULmsi v3 03 You will notice that the item at the bottom tree is greyed out This is to indicate that it is the main package displayed at the top of the Package Dependencies tree When you click on the topmost node of the Package Dependencies tree the Dependency Viewer iterates through all of the dependencies of the main package and checks to see which other packages share one or more of these dependencies The results are then displayed in the second tree showing both the shared component and the package name This is known as Shared Dependencies Rollup 197 13 Advanced Usage Quest ChangeBASE 5 3 User Guide Ts Dependency Viewer lo E Exclude Operating System Files OS Snapshot Defaut Windows 7 Snapshot Package Dependencies l ACE DLL v1 2 0 1 yg ACELITE DLL v1 2 0 1 ACROBAT EXE v5 0 5 452 E l ACRODIST EXE v5 0 0 0 a e ACRODISTDLL DLL v5 0 5 452 w ACROFXS2 DLL Eel Lal NNOTES DLL w ACROIEHELPER OCX v1 0 0 1 Packages Sharing One Or More Dependencies With Acrobat AcroRd32 dil Imports ACE DLL contained in Acrobat AcroRd32 dll Imports AGM DLL contained in Acrobat AcroRd32 dll Imports BIB DLL contained in Acrobat AcroRd32 dll Imports COOLTYPE DLL contained in Acrobat OnlineServices dil Imports BIB DLL contained in Acrobat SVGCore DLL Imports ACE DLL contained in Acrobat SVGCore DLL Imports AGM DLL contained in Acrobat SVGCore DLL Imports B
215. nter a different user name or password Please select a Server and Database ChangeBASE CREATE DATABASE Connection To localhost SQLExpress Failed Login failed for user Change BASEUser T If the database server cannot be found the following will be displayed Click Previous to enter a different server instance name Please select a Server and Database gaa ChangeBASE CREATE DATABASE Connection To localhost SQLExpress Failed A networktelated or instance specific eror occured while establishing a connection to SQL Server The server was not found or was not accessible Venty that the instance name is comect and that SQL Server is configured to allow remote connections provider SQL Network Interfaces eror 26 Eror Locating Server Instance Specified If the following requirements have not been met from those listed in 2 1 2 2 Requirements for Remote Database Setup e Microsoft System CLR Types for SQL Server 2008 x86 10 0 x e Microsoft SQL Server 2008 Shared Management Objects x86 10 0 x then you will receive the following error 44 3 Basic Configuration Quest ChangeBASE 5 3 User Guide HE Please select a Server and Database ChangeBASE UPDATE ChangeBASE DATABASE PROPERTIES Fated io create database Connectivity may have been lost or you may not have sufficien privileges Plaase contact your database administrator To connect to an existing database click the drop down list
216. ntified you can expand the package to display the report group then Plugin then issue details wl ChangeBASE a Quest ee ChangeBASE Packages Reports New Project wizard N Packages x D E Ficomment Portfolio Summary x D o E FO Browse P V Reports Assess V Packages Fix V Reuters Messaging 7 v 3 WVBOXSVR t Virtualize Virtualisation App V i 2 Reports Refresh Results Clear Results Assessment Results Summary Packages Reports Rules Scanned Rules Issues Upgrades Available Ready 180 32421 7635 487 638 DCOM Analysis iV Hard coded path reference found in Registry table C iV Hard coded path reference found in Registry table C iV Hard coded path reference found in Registry table C iV Hard coded path reference found in Registry table C iV Hard coded path reference found in Registry table C V Hard coded path reference found in Registry table CA iV Hard coded path reference found in Registry table C V Hard coded path reference found in Registry table C 7 Hard coded path reference found in Registry table C T Windows 7 Windows Resource Protection Scan M Windows 7 7 Acrobat 7 Adobe_Photoshop_Elements 7 Advanced Installer 6 4 iV Apple Mobile Device Support 7 ChangeBASE V Codebook for AutoCAD 2004 V EASE i HOD Standalone v8 Z Hard coded path reference found in Registry table C Hard code
217. oard 115 6 Assessing Packages and Viewing Results Quest ChangeBASE 5 3 User Guide REPORT ISSUE INTENDED AUDIENCE DESCRIPTION DETAILS Summary Profile Profile Post Fixing Packages By RAG Report Group By RAG Report By RAG Package Issue Sammary CSV Export Optional Project Coordinator Program Manager Project Coordinator Program Manager Project Coordinator Program Manager Project Coordinator Program Manager Project Coordinator Program Manager Package Specialist Package Specialist Package Specialist An HTML report that provides a summary of the number of checked packages the number of reports run etc then a breakdown of each report group showing the number of issues identified This report also includes a description of Red Amber and Green status flags This report includes Cost Effort calculations An HTML report that simply displays the current RAG status for each checked package for each report group Useful when compared to the Profile Post Fixing report An HTML report that simply displays the RAG status for each checked package for each report group if all automated fixing were to be applied Useful when compared to the Profile report An HTML report that lists all Red packages Amber packages and Green packages where the package has been checked An HTML report that lists each checked package and report group where issues have been
218. ocation C Program Files 86 ChangeBASE AQKCSC Output File Target Extension CSCWEB Initial Poll Interval Initial Pall Unit 1 Minutes ki File Size Limit to Trigger Export 0 MB cance where EU9068 in the above example is your lt computer name gt The CSC Agent AOQKCCControl exe uses an Access database to store a local copy of the captured data prior to uploading it to the CSC Server The Agent obtains a fresh empty copy of this database from the location specified in the Database Template Location field every time it starts Therefore this is a mandatory field Ensure that the Output File Target Location is set appropriately This is the destination of the uploaded files refer to 15 6 5 2 CSC Agent Note The extension has to remain as CSCWEB Change the Initial Poll Interval and Initial Poll Unit as required For example set them to 2 and Hours respectively for a registered client to contact the CSC Server at two hourly intervals At the bottom of the dialog you can also set the size of file in MB at which the creation of an output file will be triggered Click OK If you wish to use a non default connection string to enable the web service to connect to the CSC database or a non default storage location for uploaded data select Tools gt Manage Web Service Configuration The Folder to store uploaded files path shows the location where the CSCWEB files containing the c
219. of packages completely or by View 13 1 7 Collapse This option collapses the Packages tree 13 2 Package Level Context Menu There are a number of different options available when you select a package that has been imported into the database and then right click to display the associated context menu Save Retrieve Reports Select App IDs Open Containing Folder View Dependencies View Log Edit MSI with MSI Studio for ChangeBASE View History Checkin Re Impeort Add To Matching Analysis Create Issue Summary Report Extract Cabs From Msi Override All Issues Specify Overrides Views Bulk Issue Summary Expand Collapse Note Except where specified you are able to select the above options for multiple packages In order to utilize this capability you can either multi select a range of adjacent packages using SHIFT Select mouse click or you can select non adjacent packages using the Ctrl Select mouse click option In both cases you should right click on the final package in the selection to see the drop down menu You will then have the multi select options that are available for your particular license 194 13 Advanced Usage Quest ChangeBASE 5 3 User Guide 13 2 1 Delete Delete is used to remove the package from the database Note The physical package will still reside in its source folder 13 2 2 Save Retrieve Reports Save Retrieve Reports opens to the sub menu Save new results group
220. ol Panel interface 98 5 Importing Packages SETTING Username mandatory Password mandatory SystemFolderPath optional FileMonitorInstallFolder optional SnapshotName mandatory TimeOut optional RaisePriority optional RevertT oSnapshot LaunchGuUI optional Quest ChangeBASE 5 3 User Guide DESCRIPTION The username for the Virtual Machine The password for the Virtual Machine This allows you to specify a non standard path to the Windows system folder This field can be left empty if the Virtual Machine s system folder is C Windows System32 This is the folder on the Virtual Machine where the file monitor will be installed Ensure that the user specified has permissions to this folder If this field is left empty it will use the path C Program Files File Monitor The name of the Virtual Machine Snapshot that the repackaging process is to use This is case sensitive This is the time out value for the Virtual machine The time is set in minutes A value of 15 the default if not set for example will mean that ChangeBASE will terminate the Virtual Machine after 15 minutes This field should be left blank It should only be used under the instruction of the ChangeBASE support team for debugging purposes This value should be set to 1 if ChangeBASE has issues reverting to the Snapshot 9 4 3 Repackaging Filters When the Virtual Machine is monitored by ChangeBASE during an
221. ollowing dialog will appear You have selected multiple MSI packages to sequence Would you like to create multiple sequences one for each package selected create a single sequence containing all of the selected packages or manually configure sequencing options Multiple sequences Single sequence Manually configure c Click Multiple sequences d For each MSI a virtual package will be created in the Export Folder 11 3 2 Package Virtualization One virtual package from multiple MSlIs This section covers the scenario where a virtual package containing multiple MSIs is required An example of where this may be required is where an application and its middleware are supplied as two MSI packages A single virtual package may be required containing both the middleware and the application 1 Check the MSI packages s to be virtualized 166 11 Virtualizing Packages Quest ChangeBASE 5 3 User Guide 2 Click the Virtualize button The following dialog will appear You have selected multiple MSI packages to sequence Would you like to create multiple sequences one for each package selected create a single sequence containing all of the selected packages or manually configure sequencing options Multiple sequences Single sequence Manually configure 3 Click Single sequence 4 A single virtual package containing all the checked MSIs will be created in the Export Folder 11 3 3 Package Virtualization Virtual
222. or Operating System select the applications Core Applications and or OS in the Core Application Group and select the application against which results should be shown 207 13 Advanced Usage Quest ChangeBASE 5 3 User Guide 13 4 1 Core Application Scan Rules The types of conflicts that ChangeBASE can identify are configurable through the CAS Filters option To edit the Rules that should apply right click any of the applications that are shown in the Core Applications Report Group and select CAS Filters E Core App List Core Applications Update Report ra B i 05 Snapshot ES Delet Engineering F aaa MerckCusto Copy Report J CAS Filters Office 2010 You will then be presented with a screen where the rules that should apply can be selected Fiz wel Core App Scan Rule Filters CutePDF Professional 3 6 msi ane Faiaoe OS Sue Files Registry Other Settings Cancel Rule ID Restore Defaults 434e UOEI07 E SU ugen g uauodwos pajqeug Jap o U0 SI3 A pajqeug Jaman UO0ISI A pajqeug Yyoeyy uolssa A V lt S Y y Yo iv Yo iv Vv vo Vv iv Vv of SI SS sisi The radio buttons at the top of the screen are used to set which rules should be changed either packages or the Operating System An Operating System behaves differently than applications as it does not have any components with component IDs The m
223. ord each time it is required e g during a refresh After entering the necessary data you can click the Test button to verify whether or not the data has been entered correctly If successful a dialog such as that shown below will be displayed Ei 7 Successfully connected to SCCM site QMX Demo Lab site code QMX E version 4 00 6487 2000 OR 80 5 Importing Packages Quest ChangeBASE 5 3 User Guide 5 2 3 4 Viewing packages and programs After the server has been defined and a refresh performed you can view the packages available on the SCCM server by clicking the Packages button The retrieved packages will be shown like this d ChangeBASE SCCM Interface fat SOCH Caini foal T hae F Ge e Lataa Pegs Tea Satin Hyeri Damma Lii re rer ae Fia Tila Proa PaM 355 Fis Dis Chant EE Fle 2illa 15 an ipm TEMITA Ga Fie ily Propst Fig tly ers IA ER Helis berwer EAE Hindis Sera a ee TEMATA Oi Treed bess Hek The EN Hilak The MIE Hiri Pama SCM O Fa Eel 1513H EH Habi E5 et ES 1 5 13 oe oe Tie beh hga AH lat xe Cope SOCH Fick burii flesh bo the delice een baia importing nit CherseGASE Uline hii apari phere ha S00 ters wi be petted w my Po iea pred by Charge EASE Tere d old peop merlin urine are becker hgn Pet eck Co Note If you wish to back up the SDDM source files prior to the import into ChangeBASE ensure that the following field is checked Copy SCCM Package source files to the following location before importi
224. ore packages installed e g Microsoft Office Middleware installed e g Microsoft NET Java runtime Oracle client Antivirus auto updates turned off Any synchronization elements turned off e g Offline folders Windows Defender service disabled Deployment services like SCCM stopped Windows Update services turned off Where an individual application requires dependencies middleware this should be installed on the Virtual Machine Log on with a user account which has a password set blank passwords are not supported It is recommended that a local account be used If using NAT in the Virtual Machine ensure that the DHCP lease is set to at least 7 hours Ensure that any firewall is switched off Install QVMTools a Inside the Virtual Machine copy the QVMTools Setup msi installer which is located in C Program Files x86 Quest Software VReady on the machine running ChangeBASE to the guest Run QVMTools Setup msi to start the installation process QVMTools will automatically launch once installation is complete You will now find QVMTools running in the system tray Double click it or right click and select View Log to open the log You can also exit QVMTools if required Ensure that the QVMTools log window is closed if you opened it Delete QVMTools Setup msi from the Virtual Machine 93 5 Importing Packages Quest ChangeBASE 5 3 User Guide 6 If you are using Windows XP VMs running in H
225. ork Address Translation 93 157 New Project Wizard 61 O Offline License 39 Online License 37 Open Containing Folder 195 Operating System Images Importing 204 Optimization Virtualization 170 Options 23 24 36 48 53 54 58 60 61 65 66 67 72 73 74 77 78 86 94 99 105 106 108 122 123 125 128 131 133 154 157 168 170 171 174 179 180 202 203 211 Options Window 173 Add In Tab 186 Browser Compatibility Tab 185 Core App Lists Tab 176 Dashboard Tab 186 Duplicates Tab 184 General Tab 173 Database Options 175 246 Index File Extensions Automatically Added 175 Package Import Fix 174 Report Options 173 Transforms 174 Issue Summary Tab 176 Other Tab 187 Platforms Tab 176 Repackaging Options Tab 186 Report Costs Tab 180 Security Tab 178 Services Tab 177 Upgrade Tab 177 Virtualize Tab 187 Orca 199 Organize Views 192 Other Tab 187 Overrides 203 P Package Dependencies Tree 195 Package Issue Summary 121 214 Package Overview Report 123 135 136 Package Selector 190 Package Virtualization 16 22 169 193 EXEs and Manual Configuration 166 167 One Package from Multiple MSIs 166 One Package per MSI 166 Packages by RAG 120 214 Context Menu 194 Delete 195 Importing 71 Panel 60 72 74 75 85 89 104 111 192 222 224 228 241 Tree Context Menu 189 PCA 92 Performance Issues Virtualization 170 Pie Charts 127 128 Platform Groups 124
226. ort Costs Duplicates Browser Compatibilty Add in Repackaging Options Dashboard virtualize J gt Status Dashboard is not installed in this database OK App Cancel After this the Tab will show the version of Dashboard installed aul Options General Issue Summary Core App Lists Platforms Upgrade Services Security Report Costs Duplicates Browser Compatibiity Add in Repackaging Options Dashboard Virtualize Status Dashboard version 1 0 1 13 currently installed and is enabled Uninstall Disable _ Not registered with IIS server EUS9068 Dashboard Executive Summary Platform 1 Platform 2 Platform 3 Platform 4 Title Executive Summary ToolTip Windows 7 x64 with App V Report groups to include V Virtualisation App V V Windows 64 bit W Windows 7 TopSissues ROI Progress Summary Target Date 07 Mar 2013 Target Packages 0 OK Apply Cancel 53 3 Basic Configuration Quest ChangeBASE 5 3 User Guide Note The four Platform tabs enable you to prioritize the Dashboard Migration Groups so that a priority matrix can be used in Best Way Forward reporting refer to 7 2 1 Configuring Dashboard for your Target Environment and 7 2 2 5 Best Way Forward The Status panel shows whether or not e the Dashboard is currently installed in the database e the Dashboa
227. ost relevant rules to identify conflicts will be selected by default but if desired additional rules can be enabled to troubleshoot specific applications The tabs at the top indicate which set of rules are currently being displayed In the above screenshot for example the File Rules are displayed Let s use BPF16 BPF18 as an example This will show an issue if the filenames between two applications are the same but the file versions are different Other characteristics of the file are as follows e It s a PE File Portable Executable like an EXE e It s nota COM File i e it does not register COM information e The install location matches e The ComponentID that installs the Component is different 208 13 Advanced Usage Quest ChangeBASE 5 3 User Guide BPF 16 Best Practise File Issue 16 will display an issue if the file version is older than that of the Core Application BPF 17 will display an issue if the file version is newer than the one added to the Core Applications and BPF 18 will display an issue if the file version is the same as the one added to the Core Applications 13 4 2 Understanding the CAS Rules For a full detailed list and next step information for each check see the Next Steps folder INnc Program Files x86 Quest Software ChangeBASE Dashboard on x64 bit platforms or c Program Files Quest Software ChangeBASE Dashboard on x86 platforms e g BPF16 The Rule The conflicting application installs a
228. our computer User Account Control helps prevent potentially harmful programs from making changes to your computer Tell me e about User Account Control settings Never notify me when Programs try to install software or make changes to my computer e I make changes to Windows settings Not recommended Choose this only if you need to use programs that are not certified for Windows 7 CJ because they do not support User Account Control Cena Drag the slider to the position shown and click OK You will need to reboot your PC Virtual Machine for the change to take effect On Windows 8 you will need to carry out the following additional steps 1 Type secpol msc on the start screen and press Enter Navigate to Security Settings Local Policies Security Options Open the policy User Account Control Run all administrators in Admin Approval Mode Set it to Disabled 4 Reboot to ensure that the settings are applied Q Why does ChangeBASE not start my Virtual Machine A Check your Virtual Machine settings in the Virtualize Tab Check the path to the VMX file and the VM username and password Q Why does ChangeBASE not do anything after starting my Virtual Machine A Check your Virtual Machine settings in the Virtualization Tab Q Why does my conversion to ThinApp fail A Check the Internet Explorer settings on the Virtual Machine Select the Security Tab click on Custom Level go to the Miscella
229. ow the Potential with Auto fixing The Platform colors in the charts indicate the order of preference the preferred Platform is the darkest green whilst the least preferred is the lightest shade of green Executive Summary Pie Charts Potential with auto fixing Column Charts You can drill down to the Application Summary Screen by clicking on a Platform slice or column This is not available for the Incompatible slices columns 132 7 Dashboard Quest ChangeBASE 5 3 User Guide 7 2 3 Executive Detail If you drill down from the Executive Summary page using the pie charts the Executive Detail page is displayed Up to four sets of charts can be displayed on this page as defined in 3 4 Configuring and enabling the Dashboard Components for the ChangeBASE Database s Executive Summary Windows 7 x64 with App V Windows 7 x64 with natively installed applications Current Potential with auto fixing Current Potential with auto fixing 47 XenApp 6 RDS with App V XenApp 6 RDS with natively installed applications Current Potential with auto fixing Current Potential with auto fixing 42 50 Each of the four sections has two pie charts showing the before and after view of the package grouping The pie chart s groupings are defined on the Dashboard Options screen Platform 1 is the first group of pie charts on this screen Platform 2 is reflected by the charts on the top right Platform 3 is represented by the
230. p process 125 7 Dashboard 7 Executive Summary Quest ChangeBASE 5 3 User Guide ChangeBASE ROI Calculator Manual process vs Automation Product Cost ChangeBASE Professional mz Manual v Automated Application Compatibility Per Desktop Simple Medium Complex Average Rate Hourly EMEA NAMR APAC Application Testing Hours Per Package Application Virtualisation Hours Per Package App Complexity SLA s Simple Medium Complex FIELD Total application portfolio Number of Desktops Estimated complexity Simple Medium Complex Average Rate Hourly EMEA NAMR Currency Manual ChangeBASE Savings Days Saved Application Testing Cost Days Cost Days Saved Saved _ Simple 4 500 8 o0 Medium 27 000 45 Complex 18 000 30 Application Remediation ae _ Simple 6 000 10 Medium 36 000 60 Complex 22 500 38 Virtualisation testing Remediation and Sequencing Simple 9 000 15 Medium 54 000 90 Complex 375 38 177 375 315 100 DESCRIPTION This is the total number of applications expected to be migrated over the duration of the project It will be used to calculate both manual and automated costs and effort This is used to calculate the ChangeBASE costs This is the estimated percentage of applications that are expected to be easy to migrate It is u
231. phos_Anti Virus a A OpenPlan_Professional Splot S m Relux_Vision SS E E BPA CommonAutomation y WinZip SS EE a EE ETCi_Service_Release Sophos_Anti Virus 5 a WinZip 24 SE E ET ETCi_Service_Release Nero 6 8 3 Report Group by RAG Oe ChangeBASE Report Gro x aaa ChangeBASE Package Compatibility Report 13 Feb 2013 12 37 AM Report Group By RAG Show All Report Groups Hide All Report Groups AppID Report Group Issues Cost Effort 1 RED aaa a OpenPlan_Professional Internet Explorer 7 8 Application Compatibility 29 29 116 Splot Internet Explorer 7 8 Application Compatibility 27 27 108 Relux_Vision Internet Explorer 7 8 Application Compatibility 377 377 1508 E Ce ss ae ea WinZip Internet Explorer 7 8 Application Compatibility 59 59 236 a _Anti Virus Internet Explorer 7 8 Application Compatibility 243 243 972 Windows 8 19 19 20 WinZip Internet Explorer 7 8 Application Compatibility 59 59 236 m A A E Nero Internet Explorer 7 8 Application Compatibility 747 747 2988 o e EE Internet Explorer 7 8 Application Compatibility 243 ert a F502 204 OpenPlan_Professional Internet Explorer 7 8 Application Compatibility 50 100 200 Internet Explorer 8 daum eae 3 120 6 Assessing Packages and Viewing Results Quest ChangeBASE 5 3 User Guide 6 8 4 Report by RAG Kae ChangeBASE Package Compatibility Report 13 Feb 2013 12 37 AM Report By RAG Show All Reports Hide All
232. plied to filter out items that are deemed unimportant For example Merge Modules are commonly used inside an application to avoid conflicts Older versions of MergeModules could conflict with later versions of MergeModules simply because the MergeModules have files that are different versions MergeModules would be backwards compatible 99 9 of the time Therefore if your application estate produces a large number of conflicts because of different file versions results can be filtered out by unchecking Include issues relating to Merge Module components 210 13 Advanced Usage Quest ChangeBASE 5 3 User Guide 13 5 Important Files and Folders The ChangeBASE license and settings files are stored within the user s profile in a folder called ChangeBASE Windows XP USERPROFILE Local Settings Application Data ChangeBASE Windows Vista 7 and 8 localappdata ChangeBASE Windows Server 2003 localappdata ChangeBASE 2008 and 2012 The most significant sub folder in this location is the UserData folder which contains the following AOK cbl which is the ChangeBASE license file that governs your entitlement to the modules that you have purchased ChangeBASE Activation Page which is a web link to the page where you can submit a license for activation or re activation GUIApp ini which is the configuration file for automated application virtualization sequences xml which contains the information about the last virtualizatio
233. ploying a package to the target environment for accurate and informed decisions on timeframes and costs o Automatically assess package suitability for target environments to prioritize packages for relicensing replacement and testing o Include non standard or legacy packages to test your entire inventory of packages for compatibility issues e Microsoft Office Dependency Testing o Highlight potential issues for packages that will be integrated with Office 2007 2010 2013 Identify dependencies on earlier versions of Microsoft Office that may create issues and cause those packages to fail Ensure that application packages are compliant with Active Directory policies e Auto Fix Compatibility Issues o Resolve application compatibility issues prior to deployment with minimal manual effort to avoid repeated assessment cycles and to substantially accelerate package delivery Reduce post migration support issues e Ongoing Management o Take advantage of the latest Windows updates and patches through periodic automated re evaluation of your package estate Reduce security risks and deployment times by completing patch impact assessments within minutes o Introduce changes quickly easily and reliably with the highest degree of confidence e Virtual Compatibility Assessment o Determine which packages you can virtualize within seconds and track for middleware dependencies saving days of testing time 1 Introduction Quest ChangeBAS
234. ported using the CSV Import option This method applies to both packages that can be imported directly and legacy applications EXE VBS BAT The CSV file header should have the following fields NAME Executable File Name Command Line Arguments Support Files Y N AutoComplete Y N ProductName ProductVersion MSI Output Folder PURPOSE Path to the MSI EXE VBS or BAT installation file For more information on importing legacy apps refer to 5 3 Repackaging Overview Examples e F AppRepository Mapper mapper msi e D ChangeBASE Packages divxinstaller exe Installation options or MST for application Examples e silent e TRANSFORMS C ChangeBASE Packages Msi Store 2 AdbeRdr930 en _US FIXES35 mst N Only the Executable Filename will be copied to the Virtual Machine Y All files and subfolders in the same folder as the Executable Filename will be copied to the Virtual Machine Note This option only applies to Repackaging With this option checked ChangeBASE will attempt to click on the buttons on the installation dialogs Next Finish etc to allow the installation to progress unattended Note This option only applies to the importing of Legacy Applications Specifies the product name that will be displayed in the ChangeBASE Workbench Note This option only applies to the importing of Legacy Applications Specifies the product version that will be displayed in the ChangeBASE Workbench
235. pps group in the Reports section and then in the Packages section select the packages that you would like to run against the core applications 12 4 Platforms Tab The Platforms Tab is used to set the target Dashboard Platforms refer to 7 2 1 Configuring Dashboard for your Target Environment Only features components and custom actions relevant to the Platform selected will be taken into consideration when results are displayed All other features components and custom actions will be excluded from being displayed as results It is advisable to check the option marked Filter reporting issues within the j context of the selected Platform so that the issues are only shown for that Operating System 176 12 ChangeBASE Options Quest ChangeBASE 5 3 User Guide Selected Platform Currently Windows 8 NB Platform filtering is currently only available on a WiFi me y EAR subset of the ChangeBASE reporting suite For a full Filter reporting issues within the context of selected platform list of supported reports please see the website and latest product news 12 5 Upgrade Tab This Tab is described in 4 6 2 Online Report Group Loading 12 6 Services Tab URUUNC http www aokserver comwAOKUpgrade Upgrade asmx Proxy Credentials Use Proxy Bypass For Local Serves Auto Detect IE Settings Server Address PortNo 80 UserlD Domain Use Automatic Config Script Address Working Data Store Working Data
236. quent upgrades or patches can still be applied while allowing you to maintain support for the particular packages Virtualize ChangeBASE can automatically create a virtualized package in a number of formats including Microsofts App V Symantec Workspace Virtualization SWV VMware s ThinApp and Citrix s XenApp Streaming Profile UAT The fixed package is now ready for User Acceptance Testing UAT Package owners can test in the target environment Deploy The package and fixes are deployed to the target environment Manage Patches that are released from Microsoft are made available on the ChangeBASE Platform shortly after each patch Tuesday the second Tuesday of every month These are available in a reporting group which can be used to assess the impact against the package in your portfolio 1 Introduction Quest ChangeBASE 5 3 User Guide 1 2 1 Flowchart showing the Key Phases The key phases in the previous section can be visualized as follows Import ee Uncheck all file types in Options Package Drag file or source parent folder type onto CB Drag folder onto CB MSI MST Right click item Repackaging gt Source capture l l I I l l l l I l l l l I l l l l l I l I l Click Import I I l I l l l l I l I l l l l l l l l l 4 l l l l l l Drag MSI or Edit parent folder Repackaging onto CB Configu
237. r Narre John Smath Email Address john smuith tadcaster co uk Authorisation Code HLPOOOO001 Create Offine License License File Browse Proy Settings Cear Options cc cok cna C Users Nigel 4ppData Local ChangeBASE UserData 4Ok cbl has been created Please activate this license by uploading it to http wew aokserver com AOKT estUpgrade ActrvateOfflineLicense aspx This can also be located by using the shortcut found in your user profile folder Press OK to open the license folder Cancel to eat ChangeBASE 5 Inthe Explorer window that opens copy the AOK cbl and AOK Activation Page URL files to external media e g a USB drive Leave the Explorer window open for later use 39 3 Basic Configuration Quest ChangeBASE 5 3 User Guide 6 T 10 11 Take the external media to a machine that has internet access Double click the Activation Page URL on the external media CO wwwaokserver com AOKUpgrade ActivateOfflineLicense asp WW ae LA aga Quest ChangeBASE ChangeBASE Offline Licence activation This page allows you to submit a ChangeBASE licence for reactivation Ensure ChangeBASE is not running then browse to your aok cbl file which is located in your ChangeBASE User Profile folder and submit it here This is typically in your LocalAppData ChangeBASE UserData Folder You will be prompted to save a sucessfully activated licence Replace
238. r minutes or hours but you must stick to the same measurement throughout This is an invaluable tool for the accurate measurement of the ROI You can use this as a basis for a business case to buy the ChangeBASE solution set or use further solution set modules 12 8 1 Recommended Cost and Effort Values From experience the following are the values that have been found to be the most accurate Virtualization App V Active Setup Detection 1 Virtualization App V Package Size Limit oe 0 Virtualization App V COM Analysis a 0 5 Virtualization App V DCOM Analysis Lo 0 5 Virtualization App V Entrypoint Analysis 2 Virtualization App V Hard Coded File References Y 0 01 scan Virtualization App V Inaccessible Control Panel Y 0 1 Detection Virtualization App V Microsoft Office and Internet 1 Explorer Add in detection Virtualization App V Multi Line Registry Analysis Ss 0 5 Virtualization App V Non Supported Drivers 1 Streamed Virtualization App V Non Supported DSN Settings SS 1 Virtualization App V Non Supported ODBC Drivers i 1 Virtualization App V Non Supported Services 1 Installation Virtualization App V Non Supported System Startup Y 0 01 Settings Virtualization App V Shell Extension Detection 0 5 Virtualization App V Virtualization Local Host Check 1 Virtualization App V Windows Service Detection i 1 Virtualization App V Windows 7 Windows n a Resource Protection Scan Windows 64 bit 16
239. ration Extract MSI s from TEMP Bootstrap EXE Review Import warnings warnings Yes No Yes No Check report Click Assess groups for e a a a n a a aD aD aD OD OD OD OD OD OD ee am chosen platform Are the No Red issues Consider Red different iuen ara platform or drivers newer version Amber issues j Y Fix Auto fix Manual fix Override Amber issues Override Red issue s If the source is MSI Check packages to be Click Virtualize virtualized 13 1 Introduction Quest ChangeBASE 5 3 User Guide 1 2 2 Assessment Capabilities ChangeBASE provides automated application compatibility testing and fixing where appropriate for the following e Windows 7 32 bit and 64 bit e Windows 8 32 bit and 64 bit e Windows Server 2003 including R2 32 bit and 64 bit e Windows Server 2008 including R2 32 bit and 64 bit e Windows Server 2012 e Microsoft Office 2010 and 2013 dependencies e Windows and Office Updates e Inter package and OS conflict management e MSI Installer Integrity ICEs Internal Consistency Evaluators checking and fixing e Microsoft App V VMware ThinApp Citrix XenApp and Symantec SWV e Custom Report Authoring Checking for adherence to Company Standards and Packaging Best Practices e Browser Compatibility features allow the automated testing of websites intranets extranets web po
240. rd processes are enabled e the database is registered with the Dashboard web pages Note When new versions of Dashboard are installed the Dashboard Tab may show that an upgrade option is available This upgrade should be run at the earliest opportunity As long as the Dashboard remains installed and enabled for the database Dashboard data will be captured into the Dashboard tables in the database If necessary the capture process can be stopped by clicking the Disable button It can then be restarted by clicking Enable Note Any package imports or reports run during the period when Dashboard data capture is disabled will not be imported into Dashboard You can also uninstall Dashboard which will remove all Dashboard data from the database 3 4 1 Registering the Dashboard Web Application with the IIS Server After installing Dashboard you need to register the application with the IIS Server as follows 1 Inthe Options gt Dashboard gt Status panel validate that the URL shows the hostname of the machine where IIS and the Dashboard Server Components have been installed without any http prefix or any page suffix e g lt myServer gt Dashboard For a standalone system the URL will simply be lt machine name gt Dashboard Important For a standalone system you will need to have installed Server Components during the ChangeBASE installation refer to 2 3 2 Installation Otherwise Dashboard registration will fail 2
241. re Info URL Report Template Custom 7 Report Proc GetNext Sequence x Fix Proc GetNext Sequence x Merge Module Browse Effort 1 Cost 1 Version No 1 _ 00 User Defined Rule Summary Table Columns FixType RAG Rules 216 14 Writing Custom Plugins Quest ChangeBASE 5 3 User Guide There are a number of key fields that are critical to the successful completion of the Plugin generation process including Name This is the name used to display the Plugin within ChangeBASE Description This is a text field that includes the Plugin s descriptive text that should follow the structure below 1 2 3 4 Brief overview of the Plugin logic Sample rule Items and the potential risk of leaving the issue within the package A description of the Fixing logic where applicable Source of the rules and remediation logic Support URL The support URL is the web reference that links to either the Plugin topic or corporate support page More Info URL This is the web link or URL that contains further information on the problem the Plugin or the remediation logic for issues raised Report Template The Report Template drop down is used to select a template containing the required logic to run the required reports Report Template Custom Pattem Scan One Dimensional Result Set Two Dimensional Result Set All Table Scan Custom There are a number of existing templates Pattern Scan scans
242. re that the correct database name appears throughout the web config file 3 4 2 3 Windows Authentication related Errors If you see the following kind of error message S Login failed for user PROD CORCBPSWO1 Windows Internet Explorer http corcbpsw01 Dashboard 7Db PSEPLUS SA e x bE P w Favortes 53 S suggested Sites Web Sice Gallery Logn Failed for user PRODICORCBPSWOLE a id D 5 mA Pager Safety Toob Server Error in Dashboard Application Login failed for user PROD CORCBPSWO1 Description An unhandled exception occurred during the execution of the current web request Please review the stack trace for more information about the error and where t originated in the code Exception Details System Data Sq pClent SolException Login failed for user PRODICORCEPS01 F Source Error An unhandled exception was generated during the execution of the current web request Information regarding the origin and location of the exception can be identified using the exception stack trace below Stack Trace SqlException 0x80131904 Login failed for user PROD CORCBPSWO1S System Data Sq Client Sq lInternalConnection OnError SqlException exception Boolean breakConnection 5050282 System Data SqiClient TdsParser ThrowexceptionAndwarning 234 System Data SqlClient TdsParser Run RunBehavior runBehavior SqlConmand cmdHandler SqiDataReader dataStream BulkCopySimpleResultSet bulkCopyHa
243. ready to stop importing data from the website that is running right click on the CSC Agent then click Stop capture 6 Right click on the CSC Agent and then click Upload data to Central Server After the upload the following dialog is displayed ChangeBASE Client Side Capture 15 6 7 Loading the Data from the CSC Server to ChangeBASE The uploaded client data will have been collated into files with a CSCWEB suffix in the Output File Target Location that was set in 15 6 4 1 CSC Manager Manage Default Parameters Typically this location is C Program Files x86 ChangeBASE AOKCSC AOKCSCWS TransientStorage Proceed as follows 239 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide 1 Log onto the CSC Server and locate at the above location the files that you wish to be imported into ChangeBASE 2 Verify by the date stamp the files that you want to import Important If required you can rename the files to something more meaningful as these are the names that will be used in ChangeBASE Workbench GO gt Computer gt Local Disk C Program Files x86 ChangeBASE AOKCSC AOKCSCWS TransientStorage 4 Search TransientStorage p a Ft Favorites W Desktop ig Downloads Recent Places di UserData d images I vm p08 J orca 1 ukbprnw02 J DB1 P 54 dd TransientStorage i My Received Files 4 Libraries Documents d Music t Pictures iz Videos s jM Computer amp
244. reating Reports 215 CSC See Client Side Capture CSV Import 61 72 87 88 Custom Action Security 143 Custom Plugins Adding Rules 218 Creating 215 D Dashboard 18 19 20 21 26 31 32 34 36 48 53 54 55 56 58 113 123 124 125 127 128 131 133 137 143 209 232 Configuration for Target Environment 123 Filtering 129 Options 186 Progress Summary 131 Register with IIS Server 54 Setup 19 SQL Setup 31 Troubleshooting 55 Unregister 48 55 59 Database Backup Requirements 25 Rename 48 Database Options 175 176 177 178 180 Database Setup 20 21 26 32 42 233 Local 17 Remote 19 Databases Create Additional 48 Multiple 48 db datareader 27 30 db datawriter 27 30 db ddladmin 27 36 DBA 27 49 dbcreator 26 DBLIST Command 212 dbo 27 36 dbowner 49 Default Cost and Effort Values 181 Delete Packages 195 Dependencies View 195 Deployment to Remote Desktop Services 24 Deployment to Terminal Services 24 Deployment to Virtual Machines 24 Depth of Web Crawl 228 Direct Import 71 Dragging and Dropping Files onto ChangeBASE 72 Dragging and Dropping Folders onto ChangeBASE 73 179 230 E ESX 22 91 95 162 Quest ChangeBASE 5 3 User Guide EXE 22 87 90 91 102 104 155 156 167 168 169 186 199 Execute Stored Procedures 27 Executive Detail 123 124 128 130 133 Executive Summary 124 125 127 128 129 130 132 133 Expand
245. rm 1 Group select Windows 7 64 bit and App V o Inthe Platform 2 Group select Windows 7 and 64 bit e Top 5 Issues and ROI At the bottom of the screen choose whether the Top 5 Issues or ROI box is to be displayed To save the changes without closing the Options window click the Apply button To save the changes and close the window click the OK button 7 2 1 1 ROI Setup If the Executive Summary page has been configured to include the ROI section and not the Top 5 Issues section there are additional options that can be configured to tailor the ROI to your environment The ROI calculator is installed with zero pricing values so these will need to be added before the calculator can be used effectively 1 Open your browser and load the Dashboard 2 Click anywhere on the ROI section in the upper right corner This will open the ROI Calculator page Click Edit in the upper right corner to change these settings Firstly select the currency you wish the calculator to use Next change the ChangeBASE product type refer to 1 1 ChangeBASE Product Editions and enter the cost per desktop value in the currency you have chosen Click Save to save your changes Next you need to set up the details to calculate the manual costs Enter the appropriate details for each row and then click Save A short description of each field is mentioned below The grid on the right is explained in 7 2 6 ROI Calculation Detail as it is not part of the setu
246. rms Authentication Login Successful HTTP Authentication Login Successful Heartbeat Check Successful Download A successful download of a queued URL User Skipped Page User requested to cancel authentication when prompted Crawler Skipped Page The crawler decided to skip a page due to it being outside of the relevant domain or due to it having an excluded MIME type Downloading Skipped Page When downloading it may be necessary to skip a page if its MIME type is excluded Downloads are also skipped if a page returns HTTP Status 204 No Content 2 If none of the above appear in the log but the log does not otherwise give you any indications as to any problems you might be encountering then you should relay the contents of the log to Quest Professional Services 15 8 2 Problems arising from the use of CSC If you have any issues while using CSC then you should proceed as follows 242 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide 1 Go to 3temp AOK and open the AOK folder This holds the Access database files referred to in 15 6 4 1 CSC Manager Manage Default Parameters It also holds any log files Examine the log files and take any remedial actions indicated If the log files do not give you any indications as to the problems you might be encountering then you should relay the contents of the log files to Quest Professional Services 15 8 3 Process Uploaded Files option greyed out
247. rompts that allow the management of the manual overrides of Red or Amber conditions If you have not yet selected this feature for a package the first two prompts will be seen otherwise it will be the third one You can either override all issues for a package thus making it Green or specify individual overrides e g etl sue Overrides LS Description of all overrides for this package Ovenide Report Group Name 7 Overide Report Name Filter All Platforms Local Browser Common Reports All Platforms User ConvertlT Filters COM Self Registrati Firefox Presentation Compati Non Supported Re Intemet Explorer 10 Present Vista SP1 Local M Intemet Explorer 9 Presentat Windows 8 and Wi Intemet Explorer Data Analy Override ALLissues for this package OK Clear Cancel j The Override icon A is displayed against all packages that have overrides set against them 13 2 17 Views This option will appear if you have created any views so that you can add this package to them 13 2 18 Bulk Issue Summary In addition to 13 2 14 Create Issue Summary Report you also have the option to select multiple packages and then select Bulk Issue Summary in order to report on all the selected packages simultaneously Firstly select the packages on which you need to report by holding down the Ctrl key as you click them then right click and select Bulk Issue Summary 203 13 Advanced Usage Quest ChangeBAS
248. rrently loaded logon page It is used to show you that the logon page has been successfully located and loaded and is also used to select the logon controls in the next step 15 2 4 Selecting Logon Controls To be able to log onto a website using the URL specified the Auto Logon feature needs to Know which controls should be used to initiate a Forms Authentication request When the login page is loaded into the browser window a list of the available controls for the page is loaded into the Available Controls box on the bottom right of the screen 226 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide a w Configure Logon Settings xs Package Base URL http communities quest com indexjspa Auto Logon Description Quest Communities Logon URL http communities quest com indexjspa Heartbeat URL http communities quest com peopleAtmera View approvals Heartbeat Unique Text Welcome Todd Browser Status Page Loaded E3 Welcome Guest Login Register es t Quest Software F is now a part of Dell a Solutions Products Download Buy Support About Quest Communities i fi Home u Facebook ad Twitter ey History t Browse ANNOUNCEMENT Already hold a Quest com account If yes go ahead and log in If new Show Details Artinns Selected Logon Controls Available Controls ba You have completed the settings for this Package p g 9 OK Cancel Choose a minimum of the following controls from the li
249. rtals and web packages for compatibility with Internet Explorer 8 9 and 10 and Firefox 1 3 Why ChangeBASE Please note that depending on the license type you purchased not all functions described may be available to you Refer to 1 1 ChangeBASE Product Editions If in doubt contact your Sales representative 1 3 1 Fast Automated Migration to Windows 7 Windows 8 Microsoft Office 2010 Microsoft Office 2013 and Virtualized Package Environments Application compatibility issues present the biggest hurdle to achieving timely and complete migrations to Windows 7 Windows 8 Microsoft Office 2010 Microsoft Office 2013 and virtualized package environments It is a huge challenge to find out which packages may be incompatible with these business critical platforms and why Since these platforms differ significantly and their deployments all require considerable investment of time and money it is essential to test compatibility between the packages and platforms even prior to purchase 1 Introduction Quest ChangeBASE 5 3 User Guide Discover Applications Remediate ChangeBASE can assess and fix application compatibility issues automatically prior to migration to the latest Microsoft platforms and virtualized package environments The appropriate editions of ChangeBASE also enable you to virtualize your packages automatically 1 3 2 Features and Benefits e Compatibility Assessment o Identify compatibility issues before de
250. rting these packages would exceed that linn You should then apply for an increase in package count Once the increase has been approved you will receive a new AOK cbl license file via e mail which you should then copy into USERPROFILE Local Settings Application Data ChangeBASE UserData so that you overwrite the previous file lf you are working online simply go into the Upgrade Tab in order to refresh your license file The license file extension will then be processed automatically 41 3 Basic Configuration Quest ChangeBASE 5 3 User Guide 3 2 Database Setup Once you have successfully added your license the database connection wizard will appear You can either connect to an existing database or create a new database weld Please select a Server and Database ChangeBASE CREATE DATABASE Server Name User name Password W Use Windows Security Previous Note If your setup follows 2 2 2 1 SQL Setup using Windows Authentication leave Use Windows Security checked If it follows 2 2 2 2 SQL Setup using a SQL Login then leave the box unchecked The Server Name syntax is as follows SQL EDITION SYNTAX EXAMPLES SQL Standard or SQL SERVER HOSTNAME sqlserver0Ol emlenpiice ana 192 168 0 100 LZ ea oA Localhost Valid where SQL is installed locally Note If SQL Server is set up using an instance name then this also needs to be specified for example sqlserver0l1 lt your instance gt SQL Expre
251. rver Browser ZE SQL Server VSS Writer ZE SSDP Discovery ed Storage Service amp Superfetch Ck SwitchBoard lt 4 System Event Notification Service Ci Tablet PC Input Service E Task Scheduler TE TCP IP NetBIOS Helper e Telephony Description Provides support for the Secure Socket Tunneling P The startup of this service signals other services tha The WSCSVC Windows Security Center service m Supports file print and named pipe sharing over t Provides notifications for AutoPlay hardware events Manages access to smart cards read by this compu Allows the system to be configured to lock the user Provides change and configuration services for co Receives trap messages generated by local or remo Enables the download installation and enforcemen Provides Software Licensing activation and notifica Enables integration with Active Directories Provides storage processing and controlled access Executes jobs monitors SQL Server fires alerts and Provides SQL Server connection information to clie Provides the interface to backup restore Microsoft Discovers networked devices and services that use t Enforces group policy for storage devices Maintains and improves system performance overt Monitors system events and notifies subscribers to Enables Tablet PC pen and ink functionality Enables a user to configure and schedule automate Provides support for th
252. ry V Reports ConvertlT Filters Reports Refresh Results Clear Results _ Virtualisation App Windows 64 bit Assessment Results Summary a v Windows 7 Packages The grey cog icon indicates that automated fixing is available for a report Issue Description This ChangeBASE Plugin analyses each imported and selected application package for registry entries that match the corresponding registry settings included in the Windows Vista and Windows 7 standard Active Directory AD Group Policy Objects GPOs This Plugin will raise an Amber issue if these registry settings are detected in an application package Impact of leaving the issue in the package Windows Vista Windows 7 8 Windows server 2003 2008 inc R2 and Windows Server 2012 include a number of deployment and configuration settings that are used to manage the installation and use of packages on the target workstation Platform and server environment Group Policy tools use Administrative template files to populate policy settings in the user interface These settings allow administrators to manage registry based policy settings for both the local machine and user components As Microsoft periodically updates and adds to these Group Policy settings it is not advisable that an application package MSI contains these selected registry keys If these settings are inadvertently included in an application package the application will appear to i
253. s e Other names may indicate the area of the software on which you should concentrate your testing 8 1 1 Explanation of the Issue Custom actions allow the install author to extend the capabilities of Windows Installer by inserting custom code One of the settings available to the author is the ability to run the custom action with either the current user s rights or with system rights Most authoring 143 8 The Top Five Issues Explained Quest ChangeBASE 5 3 User Guide tools have the default set to run with the user s rights and some do not even offer the ability to run as the system user In any case when they were being run on Windows XP as you needed to be an administrative user to install the software in the first place the install author found that it made no difference as to which account they set the custom action to run in However when UAC is enabled in Windows 7 Windows 8 Windows Server 2008 and Windows Server 2012 the account under which custom actions run does have an effect namely e Those actions set to run with user privileges are only allowed to make changes to the current user s profile e Those actions set to run with system privileges can make global changes ChangeBASE identifies the custom actions that are set to run with the user s rights 8 1 2 Remediation Steps Selecting the issue in ChangeBASE followed by Fix It will change the custom action so that it runs in the system rather than the user
254. s SETTING Add Package s Remove Package Sequence Name New Default Arguments Plugin Detect MSI Install Path Property App V only Manual post install application configuration seconds Add Prerequisite Quest ChangeBASE 5 3 User Guide DESCRIPTION Add MSI or EXE to the virtual package Remove MSI or EXE from the list of packages to be virtualized This name will be used for the name of the virtual package created in the Export Folder Options Virtualize Create a new Sequence container for a set of packages which will be converted into a single virtual package It is possible to create multiple Sequences The default command line switch for MSI based packages This can be overridden for individual packages using the Arguments field This drop down list contains all of the configured Virtual Machines For each sequence you can set which Plugin you wish to use for the currently selected sequence This option only applies to App V which requires that the package is installed into a particular path When this option is checked the property which overrides the install path in the MSI is detected and used as an argument If you check this box ChangeBASE will pause the virtualization process after all the packages have been installed This allows you to make additional changes on the Virtual Machine before the virtual package is finalized This could include creating shortcuts or making
255. s 1 valid item 1 already loaded or waiting to load E Show Valid Candidates Only 4 Click Commit This will load the applications into the ChangeBASE Workbench 5 If an application can be imported directly click on Import in the Packages Panel to load the associated package s into the database If an application is to be repackaged proceed as in 5 5 The Repackaging Process 5 2 5 Import Warnings Packages F Acrobat When ChangeBASE imports packages any issues are indicated in the Import Warnings column 89 5 Importing Packages Quest ChangeBASE 5 3 User Guide SEVERITY ICON COLOR TYPICAL REASON COMMENTS Low Green MSI schema issue Unlikely to have an impact on the compatibility assessment results High File missing Depending on which files are missing this could have an impact on the compatibility assessment results View the log to assess how extensive this issue is Where import issues have been flagged you should double click the import warning icon to view the log file and assess the cause of the import warnings Time Details Memory 11 16 23 Log for WBEOXSVR e_drive Training USB Lab Sample Packages HODStandalonev 02 HOD Standalone v msi 33680 11 16 24 Started at 30 04 2012 11 16 33836 11 16 24 Database Version Was 5 0 0 02 39788 11 16 24 HSMM SM MMMM MMS SS SM SS SS SM SM SS SS MM MS SS MM RS SSS DAE D DAE ME 39788 11 16 24 Preloader chMsiConverterBase Establish Preloader 39788 11
256. s Hik Teh Pa SOC MAI AICO ha bi 15 19 24 EH Fabi MS beet E11 icici tay haere lat ae Cog 0 Pick urii Mea bo ae dds lames balam peeing nis Chere SE Ue Hii r agaon nhm e SOC Md sets wibe updated w sty ta ties peduced by amga ESE Pere d g i prha Gin Ma p ak te a ana r ei ee Eg pot wk _Ooen_ 4 Click Import Select the amended CSV file 6 The interface reads and validates the file and assuming that everything is valid performs the actions specified 7 Go to Importing SCCM packages programs into ChangeBASE 84 5 Importing Packages Quest ChangeBASE 5 3 User Guide 5 2 3 6 Importing SCCM packages programs into ChangeBASE When packages programs are added to ChangeBASE from the SCCM interface a dialog is displayed showing the success or failure of the process Success would result in a dialog like this a2 SCCM Interface Progress HiJackThis HijackThis QMX00006 completed Adding to ChangeBASE Committing to ChangeBASE database Added to ChangeBASE InstEd InstEd QMX00009 completed Adding to ChangeBASE Committing to ChangeBASE database Added to ChangeBASE 2 of 2 completed 2 successful 0 failed A failure dialog shows the reason for the failure For example the named program file may not have been found or you may not have access to the necessary network shares on the SCCM Server distribution points to access the files fe a SCCM Interface Progress m FileZilla Server FileZilla
257. s The Target Columns drop down box is used to select which columns will be analyzed once a table has been selected For example selecting the APINames table will present the columns for FileName and APIName Selecting and adding one of these columns to the text box below will include these columns in all subsequent checks for this Plugin When editing an existing report some tables will be highlighted in red This color coded highlighting is intended as a hint for all tables that contain matching entries FixType The FixType drop down box is an essential part of the rules and specifies on a rule level which remediation option will be engaged if the Fix button is selected for a particular issue The main Fix is GENCLEAN which is composed of one of the following types of Fix procedure 1 GENCLEAN This Fix type removes any errant entries safely and completely 2 GUIDSYNC This Fix type is used by the Core Application Scan CAS and when appropriately matched with a specified type of CAS report will 219 14 Writing Custom Plugins Quest ChangeBASE 5 3 User Guide automatically synchronize the Component IDs of two components residing in separate application packages MSIs 3 ADDMANIFEST This Fix type is used by reports that require automated Fixes to create security Manifests for targeted files within an application package One example of a Plugin that uses this Fix is the Control Panel Applet Platform Integrity Scan 4 ADDMM
258. s 242 15 8 3 Process Uploaded Files option greyed OUl cccccccceccecececececeeseeseeseeseees 243 BEN CRS Nees ics A A nad eect oan A vam eos atone E E E EE E EE E E 244 AbDout Quest Software NCO siis a aa aaa 250 Contacting the Quest ChangeBASE Community ccc cccceccees eee eee eee eseeeeeseeaeeaeeeees 250 Contacting Quest SOMWare ssn sien E eens eee eee eee 250 Contacting QUESI SUP DONE sscsxccsecxsesasecsaesesecs EEEE EITE 250 About This Guide Quest ChangeBASE 5 3 User Guide About This Guide Overview This guide contains the information required to configure and use Quest ChangeBASE hereafter referred to simply as ChangeBASE and now an integral part of Dell s Software offering It is intended for network administrators consultants analysts and any other IT professionals using the product Conventions In order to help you get the most out of this guide we have used specific formatting conventions ELEMENT CONVENTION Bolded text Interface elements that appear in Quest products such as menus and commands Italic text Used for comments Blue text Indicates a cross reference or hyperlink j Used to highlight additional information pertinent to the process being described Used to provide Best Practice information A Used to highlight processes that should be performed with care A plus sign between two keystrokes means that you must press them at the same time
259. s E E ems eae Sune EL N 119 Contents Quest ChangeBASE 5 3 User Guide 6 8 2 PACKAGES DY RAG ccccccccsccsscsenenseesuccuccuccuccusensessussuecuccensesussuececaususessessassusseees 120 6 8 3 Report Group DY RAG uu ec eccsccecceccecseccecseeaeeneceeceeceeseeseesesseseeseesessesseneseeseesesseeas 120 OOA TCO Ay ads args eves acer eens ass anwar eacaananaaasentecececedaeeseteeecececccecececetice 121 6 8 5 Package Issue SUININALPY 1cccccccceccecceccsccecuneesessussuccucceccusenseceucaucsusensessussusseees 121 6 8 6 AppID Expand and Collapse vias ssa riuis aes eae Metts aaa aa eamnemenaeee 122 6 8 7 Running Reports from the Command LINC cccccccccecececseccecnecnecneceeceeseeseeaess 122 6 9 PTOUDIESNOOUNG Suxuasesaevatne ate nlenads RE Baus iad ia Saad E ed Set teed ch 122 7 Dashboal eicrgecss co to retreats ents eesteen a a a Ai 123 PN A ae SB elo ay ole rs 6 hia eee ene ee E ere nee eee erent 123 FeZ SING DAS DOAN Aeee ER REENA EEEE NEEE EEEREN ENEE 123 7 2 1 Configuring Dashboard for your Target Environment ccccccceeceeceeceeseeseeees 123 TPAD TROVE RS OUD aarne A E S 125 TZ Executive SUMMalY missierek enese nena eae He ae askin idee aR E San E aE a aa aa 127 PARP CIA n A E eT Pa One ee 128 V222 TOD OISSUCS mena n E ee Gene EE eee 128 Prr ONN G as a E E E E E 129 keL A POgesS Sumay oia a T 131 Lee BES VV QV OW AIO asee a E eee 132 Te EXO CUIV CS D Gla iasa e e e e ea a Ra 133 7 2 4 Application SUIMIM ALY cccc
260. s Server 2012 press the Windows key Q then type cha The ChangeBASE shortcut will then appear under Programs There are two licensing options when you first launch ChangeBASE Online or Offline 3 1 1 Online License It is strongly recommended that you launch ChangeBASE in an online environment so that you can automatically download the latest Plugins from the Quest Server If you are online at the time of first launching the product all you need to do is enter your details in the following format 37 3 Basic Configuration Quest ChangeBASE 5 3 User Guide aul ChangeBASE License Setup Please enter the details required below in full so that we can activate your license Customer Name My Name Email Address my emaill address com Authorisation Code 12345678 License File _ Prony Setings _Gear__ Options lt lt Caneel lf a proxy server is used for internet access then you should enter its details in the Proxy Settings dialog W Use Proxy Bypass For Local Servers Auto Detect IE Settings Server Address myproxyserver Pot No 38080 UserlD user Fwd sseeeeee Domain prodl 0K cancel Clicking OK on the License Setup dialog will trigger ChangeBASE to connect to the authorization server to validate the authorization code and the software will proceed to the database connection wizard If you experience issues validating your license online consider the following e Verify that you can acce
261. s and Warnings Show Errors Only Ate Tr cr Management Apps v ris i3 A C Use Some of the logging is used by ChangeBASE internally to recognize how the fixes are being applied Most of the logging however shows the SQL statements used to remediate the issues previously reported All logging details are also stored in the database Importantly you have the option to save this log as a file which is often needed for cases where support is needed Note also the drop down box at the bottom which allows you to display errors only 13 2 7 Edit MSI with Orca If you have Orca installed not SuperOrca or anything similar then Edit MSI with Orca opens the MSI in the Orca editing tool 13 2 8 Edit MSI with MSI Studio for ChangeBASE Edit MSI with MSI Studio for ChangeBASE opens the MSI in the MSI Studio editing tool This option is only available if all of the following conditions are met e your ChangeBASE license entitles you to use MSI Studio e you have right clicked against a single not multiple package e the selected package is one of the following o anatively imported MSI o a Transform file o an EXE where you have specified a filename in the MSI Copy Filename field in the Advanced Settings of the Repackaging Configuration refer to 5 5 The Repackaging Process 199 13 Advanced Usage Quest ChangeBASE 5 3 User Guide What you see will depend on which of the following actions you have taken 13 2 8 1 Right clicki
262. s are presented in a RAG Red Amber Green format for each package Where Amber or Red issues are present the number of issues is shown within the Amber Red box Where no compatibility issues are identified a Green tick is displayed See the 6 3 RAG Status Red Amber amp Green topic for a detailed definition of each status 6 3 RAG Status Red Amber amp Green The issues are presented in a RAG Red Amber Green format for each package as follows e 6 3 1 Green e 6 3 2 Amber e 6 3 3 Red 6 3 1 Green Green means that no compatibility issues were identified Those packages can proceed directly to User Acceptance Testing UAT then to the deployment phase 6 3 2 Amber Where ChangeBASE flags an Amber issue this indicates that a compatibility issue has been found which can be fixed by applying a change to the package and that a change to the program code within the package files is not required These account for the majority of issues In most cases automated fixing is provided for Amber issues which are indicated by the cog icon Where automated fixing is not available a manual fix can be applied to the Windows Installer routine MSI or MST by an application packager 112 6 Assessing Packages and Viewing Results Quest ChangeBASE 5 3 User Guide ChangeBASE provides information on how a manual fix can be achieved in a text panel which is displayed when the adjacent More Info column magnifying glass icon is clicked In
263. s run against a package a log file will be generated This log file can be viewed by right clicking the package and selecting View Log The log file contains the SQL statements used to fix the package so that the fixes can be verified Note MSI Studio or Orca can also be used to verify that the fixes have been applied successfully All log files are stored against a package within the Package History details which can also be viewed by right clicking the package and selecting View History Delete Save Retrieve Reports Select App IDs Open Containing Folder View Dependencies View Log Edit MSI with MSI Studio for ChangeBASE View History Checkin Re Impeort Add To Matching Analysis Create Issue Summary Report Extract Cabs From Msi Override All Issues Specify Overrides Views Bulk Issue Summary Expand Collapse 10 1 Troubleshooting If a package fails to be fixed then carry out the following checks e Check the Log File If the error message relates to a CAB or media file check that the media file actually exists in the specified location See Does the package have all of its required files below in this topic e Package in use Check that the package is not in use or opened by a package editing tool such as AdminStudio or Wise Package Studio or open it in MSI Studio or Orca It may be accessed by an editing tool on a Virtual Machine or RDP session so ensure that this is not the case e Package or folder set as r
264. s that the selections in the Single Selection dialog apply only to the single package shown whereas the selections in the Multiple Selection 69 4 ChangeBASE User Interface Quest ChangeBASE 5 3 User Guide dialog apply to all the packages shown thereby allowing you to assign unassign AppIDs quickly across the entire range of selected packages Move IDs as required using the central arrow keys gt Selects a single AppID for the package s shown by moving it from Available IDs to Selected IDs gt gt Selects all AppIDs for the package s shown by moving them from Available IDs to Selected IDs lt _ Deselects a single AppID for the package s shown by moving it from Selected IDs to Available IDs lt lt Deselects all ApplDs for the package s shown by moving them from Selected IDs to Available IDs To save all changes click OK 4 7 1 3 Adding a new AppID You can add a new AppID to the list of Available IDs by clicking on the Add button above this list When you see the following dialog wa Add anew App ID ID Ladd create a new ApplD by entering a name and clicking Add The AppID can be created using letters numbers spaces underscores and hypens You can add duplicate names but you will be asked for confirmation before proceeding 4 7 1 4 Updating or Deleting an existing App ID You can double click an ApplID in either the list of Available IDs or the list of Selected IDs in order to modify or remove it When
265. sed to work out the number of applications that are limited in complexity This is the estimated percentage of applications that have a medium degree of complexity in migrating to the new environment It is used to work out the number of moderately complex applications This is the estimated percentage of applications that are the hardest to migrate to the new environment It is used to calculate the number of applications with high complexity This is the estimated hourly cost of migrating an application in the EMEA region It is used to work out the average hourly rate This is the estimated hourly cost of migrating an application in the NAMR region It is used to work out the average hourly rate 126 7 Dashboard FIELD APAC Application Testing hours per package Simple Medium Complex Application Remediation hours per package Simple Medium Complex Application Virtualization hours per package Simple Medium Complex 7 2 2 Executive Summary Quest ChangeBASE 5 3 User Guide DESCRIPTION This is the estimated hourly cost of migrating an application in the APAC region It is used to work out the average hourly rate This is the number of hours expected to test the simple migration of an application This is the number of hours expected to test the moderately complex migration of an application This is the number of hours expected to test the complex migration of an application This is the numb
266. shows details about the package including all the Reporting Groups against which the package has been assessed The next columns show the status of the package for each reporting group within the chart group Again it is possible to drill down to the package overview screen by clicking on the icon The subsequent report displays information about the package at the Reporting Group level It is also possible to drill down to the package overview screen by clicking on the Reporting group column title This will display details of each group that has been reported against for the selected reporting group The page details can be shown in a more printer friendly view by clicking the Print icon which will open a new Tab or browser window depending on the browser settings and display all packages with a white background for example ChangeBASE Dashboard Application Status Report Application Status For Windows 7 x64 with natively installed applications Date 24 Feb 2012 p Package Title Package Manufacturer Package FileName Windows Windows Version 64 bit 700785 rmsetup 7 0 0 785 Reuters America G Quest OK Advanced Course Lab Sample Packages 700785 rmsetup 700785 v rmsetup msi Adobe Reader 7 0 7 0 0 Adobe Systems G Quest AOK Advanced Course Lab Sample Packages Adobe Reader 7 0 Adobe v Incorporated Reader 7 0 msi Adobe_Acrobat_5 05_All_ENG_V3 0 5 05 Adobe G Quest AOK Advanced Course Lab Sample w Packages
267. soft NET Framework 3 5 SP1 Full e VMware Tools for a VMware based VM e Hyper V Integration Services for a Microsoft Hyper V based VM e QVMTools Package Virtualization Hypervisors As per Repackaging Operating System e Windows XP SP3 or later 32 bit e Windows 7 32 bit x86 and 64 bit e Windows Vista is not supported Virtual Hardware As per Repackaging Software installed on Virtual Machine e Microsoft NET Framework 3 5 SP1 Full e VMware Tools only if using a VMware based VM e Hyper V Integration Services for a Microsoft Hyper V based VM e App V Sequencer 4 6 SP1 5 0 also requires Microsoft NET Framework 4 0 Full and Windows 7 SP1 and or e Citrix XenApp Streaming 6 5 0 also requires Microsoft NET Framework 4 0 Full Client and or e ThinApp Setup Capture 4 6 1 and or e Symantec Workspace Virtualization Admin Client 6 1 e Symantec Wise Composer e QVMTools 22 2 Installation 2 1 4 Working Directory Quest ChangeBASE 5 3 User Guide ChangeBASE uses a Working Directory to store copies of all packages which are imported into the database The Working Directory is also used to store log files report files and temporary files The following should be considered when deciding where the Working Directory will be located e The Working Directory must be accessible by both the SQL Server and all ChangeBASE clients e The Working Directory must have enough space to store a copy of ever
268. ss SQL SERVER HOSTNAME sqlserver01 SQLEXPRESS OR IP SQL INSTANCE sqiserver01 lt your instance gt 192 166 0 100 SOLEXPRESS 127 0 0 1 SQLEXPRESS localhost SQLEXPRESS SOLEXPRESS Valid where SQL is installed locally 42 3 Basic Configuration Quest ChangeBASE 5 3 User Guide If you want to know the name of your SQL Server instance open the Services window and select SQL Server for example File Action View Help 9 GIG habu m aun toid Services Local A SQL Server SQLEXPRESS Name Description Status Startup Type Log On As amp Security Center The WSCSVC Win Started Automatic D Local Service e a Si Server Supports Ge pat Started Aatonialit Local System TATE wha cena SA Shell Hardware Detection Provides notificati Started Automatic Local System nome ed Smart Card Manages access t Manual Local Service St Smart Card Removal Policy Allows the system Manual Local System eae processing and Sa SMS Agent Host Provides change a Started Automatic D Local System controlled access of data and rapid Sh SNMP Trap Receives trap mes Manual Local Service transaction processing 4 Software Protection Enables the downl Automatic D Network Service ed SPP Notification Service Provides Software Manual Local Service amp SQL Active Directory Helper Service Enables integratio Automatic Network Service 3 SQL Server SQLEXPRESS Provides storage Automatic Ne
269. ss the following URL in a web browser on the machine running ChangeBASE http www aokserver com AOKUpgrade Upgrade asmx If you can this shows that the machine has internet connectivity and can access the ChangeBASE license server e Try checking unchecking the Use Proxy option in the Proxy Settings dialog e Double check that all the proxy server details are correct e Try adding or removing the Domain name in the Proxy Settings dialog If you are still unable to validate your authorization code online you will need to use an Offline License 38 3 Basic Configuration Quest ChangeBASE 5 3 User Guide 3 1 2 Offline License If the system where you wish to install ChangeBASE has no internet access or you have problems with authentication via the proxy server the following procedure will allow you to activate a valid license However you will need at least one computer with internet access and more importantly one that can see our activation server in the UK Some corporate firewalls proxies have been known to block access if they have not encountered the site before 1 Start ChangeBASE 2 When prompted for License Setup information enter the following details Customer Name Email Address Authorization Code as supplied by Quest Licensing team 3 Click the Create Offline License button mid ChangeBASE License Setup 8 Please enter the details requeed below m full so that we can adnate your license Custonve
270. ss tree from the installation executable This should be used where importing an EXE based installation results in an MSI with missing files or other items It is recommended that this option is selected if you want to capture settings manually outside of the installation process 4 Click Save in Repackaging Configuration Once you ready to import the configured applications click Import in the Packages Panel ChangeBASE begins importing the legacy packages Where multiple Virtual Machines have been configured multiple legacy packages will be imported simultaneously Tip By hovering the mouse pointer over the package in ChangeBASE you can monitor progress more closely Note The capture process works by monitoring the installer process for the duration that the legacy file runs If you need to capture additional configuration settings or installers then refer to the use of a batch file in 5 6 2 The Capture Process Terminates Before the Installation has Completed Once the packages have completed importing they will display as in the following example gt Sia Si var Ss A Fusion Cheats help ogee ac 0 uk Tunes Setup 2 exe Orca v3 1 3730 0000 Msi Testiveb Wr Se WANTI T2 MS nipis sne SFX Zip Sett Extrector winzip 54 si By a a amp 3 amp F amp E amp p amp iy amp J amp ey amp Ge amp Wood Mackenze Pathiringer Sid 104 5 Importing Packages Quest ChangeBASE 5 3 User Guide
271. ssesaesseseeseesesaeeas 146 8 3 3 Remediation Steps ccccccccccccecceccecceeceeseceeceseeseesecseeseesesseseeseeaesaesseseeseeseeseeaeees 146 ola RAN Oa File 212 10 Ko Siaa a T E ee eee ee 147 8 4 1 How to Reproduce the Problem ccccccccecnecseccecccccecceceesensussussucceccucausessueeeees 147 8 4 2 Explanation of the SSUe aseo sree eae ear Reads ae Toba PeasahaToaeeerneonaminntenecets 147 pA o IRCIMEGIAON SLO O 2eik ciel eas iss eas a ea saa is aia a a ea a ENA 148 9 9 Legacy Control Panel ADDIClS pea ata alle alee toed ued ad ee 148 8 5 1 How to Reproduce the Problem cccccccccccecceccecceeseeecneseeceeseeseeseesesesaeseeaeeas 148 8 5 2 Explanation of the ASSUC i o scdccaincatecesecetewerereszacthiednretinvetsieiecatleiesesveavebedsbabsbensvene 149 8 5 3 Remediation Steps xrrsisehceciceis cco enaitnnccien nee ncpnecmnaueanctenateemaecnectie ted sta dsdntatedstateteeete 149 9 Assessing a Real World Package ccccccceceeeeeneeeeeeeceeneeseeeeenenseseeeneneesoeens 150 10 FiIxmMo PACK AGC S oi rae ecces teresa eserceren cae ue eae antisera dais exed cue deeviat utente evinwepeannneaans 152 Contents Quest ChangeBASE 5 3 User Guide TW TRO CSS SOO UN Ghee centres ame seisepece ames ana uameseieaumu renee eeeceeeeccmeeceeeececeaeueeeccecceeseeat eee 153 10 1 1 Multi User ISSUES ccccccccccecsecceccecceccucusunsessussucceccunessussucceccuceuseesessassusseceeees 154 11 VIFTUANIZING PACKAGES ccion a E 1
272. st before clicking OK e A text input box used to enter a username or email address e A text input or password box to enter the user s password e A button or link Submit clicked by the user in order to initiate the login request 4 To make the process easier for you it is possible to click on the control to be selected in the browser window and if the control does not already exist in the list of Available Controls the newly selected control will move to the top of the Available Controls list To move a control between the Selected and Available Controls click the adjacent arrow The logon credentials will be entered when the web application is imported 227 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide 15 2 5 Selecting an Existing Group of Settings Once you have defined a group of settings it is saved under its Auto Logon Description on the right click menu Simply select Configure Logon Settings if you wish to modify the settings Quest Ultimate 2 fee ChangeBASE Ven o es Reports New Project Wizard Y x D E Ficommen Browse Portfolio Summary Browse with SCCM V Reports Import V Packages CSV Import J FileZilla_3 5 3_win32 setup exe ASSESS HTML Help Workshop z l Delete http iq prod quest corp p Save Retrieve Reports Select App IDs Virtualize Reports N http iww thetrainiine com J https commons quest comidocs wa lt Open Containing Folder
273. st of the locks will be cleared by that point Snapshot the Virtual Machine whilst it is running Shut down the Virtual Machine Start Shutdown or just power it off 11 2 3 Virtual Machine Setup Microsoft App V and App V 4 6 SP1 1 6 T Shut down the Virtual Machine and add a new hard disk Start up the Virtual Machine and create a new partition Assign this partition the drive letter you will use for the mount point in the sequenced packages Install App V 4 6 SP1 or 5 0 Sequencer The 5 0 Sequencer requires the prior installation of Microsoft NET Framework 4 0 Full and PowerShell 3 0 The latter is included in Windows Management Framework 3 0 which can be downloaded from http www microsoft com en us download details aspx id 34595 Ensure that you install ALL Windows Updates including those for Net Framework Note You may need to reboot and check for additional updates multiple times Failure to do so will result in the inability of the automatic clicker to click on the required controls in the App V Sequencer A The option to launch the Sequencer is checked by default in the installer and you need to ensure that you uncheck this so that the Sequencer is not launched automatically on the Virtual Machine after install Ensure that there are no unnecessary applications running on the Virtual Machine that may be updating files for example Windows Desktop Search Leave the machine idle for around 10 minutes This will cre
274. t 5 Test the connection by opening up the Dashboard via the Assessment Results menu as in 3 4 1 Registering the Dashboard Web Application with the IIS Server Services Security Report Costs Duplicates Addn Conversion Options Dashboard k i 3 4 2 4 No Database Error If you see the following error when you select Dashboard from the ChangeBASE Workbench Error No DB ChangeBASE Dashboard Settings The Admin screen has been moved to Dashboard Options within ChangeBASE Workbench this probably indicates that either e ChangeBASE Workbench has been updated without Dashboard being updated In this case go to Options gt Dashboard gt Status and click the Upgrade button if it is available 58 3 Basic Configuration Quest ChangeBASE 5 3 User Guide ChangeBASE has been updated without the previous version of ChangeBASE being completely uninstalled Referring to 3 4 1 Registering the Dashboard Web Application with the IIS Server you simply need to click Unregister and then click Register again to re establish the link between the web pages and database 59 4 ChangeBASE User Interface Quest ChangeBASE 5 3 User Guide 4 ChangeBASE User Interface The following is an example of the Workbench for a user running the Ultimate Edition of ChangeBASE refer to 1 1 ChangeBASE Product Editions wi ChangeBASE olo xs Quest ChangeBASE Reports New Project Wizard Ultimate ist FovCommen
275. t Checked blank path A subfolder will be added to the App V package path The subfolder name will be set to be the same as the package name e g RTSP BENHOST 123 orca orca sft Checked set path to Source Two subfolders will be added e g RTSP BENHOST 123 Source orca orca sft 163 11 Virtualizing Packages SETTING Operating Systems Enforce Security Descriptors Generate MSI Packages Compress Package Mount Point Detect MSI installer path property for silent installs Feature Block 1 Manual Feature Block 1 Capture Quest ChangeBASE 5 3 User Guide DESCRIPTION The default Operating System can be overridden Use default Uses the setting from the sequencer on the Virtual Machine Yes Turns on Enforce Security Descriptors No Turns off Enforce Security Descriptors Use default Uses the setting from the sequencer on the Virtual Machine Yes Turns on Generate MSI Packages No Turns off Generate MSI Packages Use default Uses the setting from the sequencer on the Virtual Machine Yes Turns package compression on No Turns package compression off Sets the mount point in the App V package to the selected drive letter Detects the public property in the MSI that would override the default install path for the package If not set then the package will install into its default location Enables the creation of Feature Block 1 during conversion All package shortcuts are launc
276. t Browse ae Browse with SCCM V Reports Import V Best Practice Manager CSV Import Browser Common Reports ASSESS V Internet Explorer 10 Presentation Compatibility MSI Installer Integrity V Office 2010 Virtualize Reports a V Windows 8 Refresh Results gt Windows Server 2012 Clear Results E Windows Update 2013 Assessment Results g V Packages J AcroPro msi Summary MV CyberLink Packages Repors mi Rules ePublisher Express Projects Browser Common Reports Scanned Rules i FileZilla Y in32 Issues Upgrades Available e If you wish to hide the left hand panels click L4 in the top right of the screen You can then click L to toggle them on again e There are many references in the guide to the Options window To access this click L in the top right of the screen The various tabs that are available are fully described in 12 ChangeBASE Options e For the latest news on ChangeBASE click LAJ in the top right of the screen e For help on ChangeBASE either press F1 or click the down arrow to the right of and select Help For the version of ChangeBASE that you are running click the same down arrow and click About 4 1 Packages Panel Browse This is an alternative to the drag and drop functionality It enables you to browse to a folder then scan that folder and subfolders for packages which can be imported into ChangeBASE Browse with SCC
277. t App V e 11 2 4 Virtual Machine Setup Citrix XenApp Streaming Profiler 6 5 e 11 2 5 Virtual Machine Setup VMware ThinApp e 11 2 6 ChangeBASE Configuration e 11 2 7 Advanced Settings App V 4 6 SP1 e 11 2 8 Advanced Settings App V 5 0 11 2 1 Virtual Machine Setup General 1 Create a Virtual Machine with at least 1GB of RAM 2 Install the required Operating System on the Virtual Machine 3 Install all the core packages and middleware on the Virtual Machine not essential but recommended 4 Install Microsoft NET Framework 3 5 SP1 Full for Windows 7 and 8 this must have been installed using turn Windows features on or off in the Control Panel 5 Install VMware Tools for VMware based Virtual Machines or Hyper V Integration Services for Microsoft Hyper V based Virtual Machines 6 Install the latest QVMTools a Inside the Virtual Machine copy the QVMTools Setup msi installer which is located in ProgramFiles Quest Software VReady on the machine running ChangeBASE to the guest b Run QVMTools Setup msi to start the installation process c QVMTools will automatically launch once installation is complete 156 11 Virtualizing Packages Quest ChangeBASE 5 3 User Guide 10 11 12 13 14 15 16 17 18 19 20 d You will now find QVMTools running in the system tray Double click it or right click View Log to open the log e Ensure that the QVMTools log window is closed if you opened it
278. t connect to it The latest version of Adobe Reader is recommended Database Operating System e Windows XP SP3 e Windows Vista SP2 e Windows 7 e Windows 8 e Windows Server 2003 inc R2 SP2 e Windows Server 2008 inc R2 e Windows Server 2012 e 64 bit OS preferred Recommended Hardware e Intel i7 or other fast quad core processor e 16GB RAM e f using an external HDD the minimum requirement is eSATA e Disk space dependent on package count 5GB per 400 packages Database e Microsoft SQL Server 2008 inc R2 Express Standard or Enterprise e SQL Server Browser service set to Automatic e TCP IP protocol enabled in database The server may run SQL Server Express but due to its 1 GB of RAM usage restrictions as well as its database size limits it is recommended that SQL Express is used for no more than 600 packages 21 2 Installation 2 1 3 Virtual Machines Quest ChangeBASE 5 3 User Guide Virtual machines are utilized by ChangeBASE for the repackaging of legacy installers EXE VBS BAT into MSI and for the conversion of MSI EXE into virtual formats Repackaging EXE BAT VBS Hypervisors e Microsoft Hyper V e VMware Workstation 9 e VMware Server 2 x e ESX Server 5 1 Operating System e Windows XP SP3 or later 32 bit e Windows 7 32 bit e Windows Vista is not supported Virtual Hardware At least 1GB of RAM Software installed on Virtual Machine e Micro
279. t g The most basic reason for a failure to import is that you may have exceeded your licensed number of packages If you have received the error message shown in 3 1 4 2 Unlicensed Number of Packages then proceed according to the instructions given there Otherwise there are various other checks that you can carry out e Are Security settings preventing package load Verify in the Security Tab within the Options window that the Add Package option is Enabled for your user role e g 106 5 Importing Packages Quest ChangeBASE 5 3 User Guide tl Options sz General issue Summary Core App Lists Platforms Upgrade Services Security Report Costs Duplicates Browser Compatibility Add in Repackaging Options Dashboard Virtualize Role Standard User Function Add Middleware Manually Add Reports or Plugins offline Add Package to Core App List Allow Additional Package Views Transform Application Directory Structur Convert It Local C tits Captu onve ource Capture PROD green Core App Lists Scan Create Readme Clear Checkouts Use the Dashboard Tab in the Options S Database Maintainer Delete Package Delete Report Edit MSI Package Orca Edit MSI Package MSIStudio Edit Plugins Plugin Editor ok Apply Cancel Ensure that both ChangeBASE and VMware are running in the same user context Above all right click on the s
280. t is Dashboard Dashboard is a reporting module that focuses on three different areas e Advanced Application Reporting which is used to view applications compatibility results per target Platform understand which technologies are impacting on applications compatibility and contains detailed remediation steps for each issue identified e Return On Investment ROI Calculator which allows for an ROI to be calculated based on manual versus automated remediation OR The Top 5 Issues chart which shows a bar chart of the top 5 most common issues identified from all packages assessed e Progress Summary Report which tracks and charts the amount of applications imported assessed converted and fixed 7 2 Using Dashboard For more details on how to use Dashboard refer to the following topics e 7 2 1 Configuring Dashboard for your Target Environment e 7 2 2 Executive Summary e 7 2 3 Executive Detail e 7 2 4 Application Summary e 7 2 5 Package Overview Report e 7 2 6 ROI Calculation Detail 7 2 1 Configuring Dashboard for your Target Environment The following target platforms are pre configured e Windows 7 64 bit e Windows 7 64 bit with App V e XenApp 6 Hosted MS RDS e XenApp 6 Hosted MS RDS with App V This section describes how Dashboard can be configured to suit your target environment Configuring your target platforms 1 Open ChangeBASE and click the Options button La 123 7 Dashboard Quest ChangeBASE 5
281. t up to accept TCP IP connections this is configured in the SQL Server Configuration Manager Important You should ensure that both SQL Browser Service and SQL Server are allowed through your firewall In the SQL Server Configuration Manager you should also ensure that the VIA Virtual Interface Adapter is switched off a Sql Server Configuration Manager File Action View Help e A B i3 G S SQL Server Configuration Manager Local Name are Enabled E SQL Server Services l y Shared Memory 1 Enabled p aa apa Se TCP IP 2 Enabled a nem z doa Y Named Pipes 3 Enabled 4 SQL Native Client 10 0 Configuration y VIA Disabled a Client Protocols Aliases If you need to troubleshoot this issue further try to install SQL Server Management Studio and check that you can connect to the database using the same credentials 52 3 Basic Configuration Quest ChangeBASE 5 3 User Guide 3 4 Configuring and enabling the Dashboard Components for the ChangeBASE Database s After ChangeBASE has been installed it can optionally be configured to integrate with the Dashboard website To do this start ChangeBASE and go to the Options screen and select the Dashboard Tab Initially this will show that the Dashboard is not installed To install it simply click the Install button tl Options E3 General Issue Summary Core App Lists Platforms Upgrade Services Security Rep
282. t will uninstall the previous version Launch ChangeBASE 5 3 Comply with the resultant prompt to upgrade the database You will only need to do this once If the installation is satisfactory upgrade the other client machines to ChangeBASE 5 3 On any one of the client machines using Dashboard go to Options gt Dashboard gt Status and click the Upgrade button otherwise you may see the error detailed in 3 4 2 4 No Database Error Click the Upgrade button the first time that you select Browse with SCCM If you are using Virtual Machines for virtualization upgrade QVMTools within those Virtual Machines refer to 5 4 1 Virtual Machine Setup and then take a new snapshot Click the Upgrade Tab to get the latest Plugins It is important prior to the first upgrade that if you are not a Database Owner dbo you have the SQL permissions assigned in 2 2 SQL Setup most notably db_ddladmin All ChangeBASE clients connecting to a database must have the same version number 36 3 Basic Configuration Quest ChangeBASE 5 3 User Guide 3 Basic Configuration 3 1 Licensing Options Launch ChangeBASE from the Start menu shortcut ChangeBASE wE ChangeBASE di Documentation di Games di Maintenance Microsoft SQL Server 2008 Microsoft SQL Server 2008 R2 di Oracle VM VirtualBox Guest Additions 4 Back In Windows 7 press the Windows key on your keyboard then type cha On Windows 8 or Window
283. tabase tabs and click Create Database I Mapinfo Professiorj Windows Messeng Connect To Existing Database Rename Disconnect Properties 48 3 Basic Configuration Quest ChangeBASE 5 3 User Guide 3 2 3 Creating a New Database if your SQL Server is centrally managed by a DBA If your SQL Server machine is centrally managed by a DBA Database Administrator and you do not have the privileges to create a new database on the server then the person responsible for creating the new database from SQL Server needs to have dbowner rights The only non standard configuration setting when creating the new database is the collation type which needs to be changed to Latin1_ General_CS_AS All other settings can remain as default r _ J Database Properties Training Select a page B Script 7 Help ChangeBASEDEMO ChangeBASE DEMO 12 07 2011 11 29 16 5331 75 MB umber OT Users Connection Server localhost sqlexpress Connection ChangeBASEDEMO ChangeBAS Once a successful connection has been established to the database server you will be asked to supply a name for the new database Enter a suitable name and click Next 3 3 SQL related Troubleshooting 3 3 1 Failure to create a Database If you have been through all the steps in 3 2 Database Setup and the creation of a database still fails for example you are still receiving either of the following kinds of error 49
284. tandard Log On As Local Service Local Service Local Service Local Service Local Service Local Service Local Syste Local Syste Local Service Local Syste Local Syste Local Syste Local Syste Local Syste Local Syste Local Service Local Syste Law Pause service Proaram Comnatihility Assistant Service on ocal Comnuter f Right click and selecting Properties g Change the Startup type to Disabled Quest ChangeBASE 5 3 User Guide 92 5 Importing Packages Quest ChangeBASE 5 3 User Guide Program Compatibility Assistant Service Properties Local Compu General Log On Recovery Dependencies Service name Display name Program Compatibility Assistant Service Description This service provides support for the Program Compatibility Assistant PCA PCA monitors Path to executable C Windows system3 svchost exe k LocalSystemNetwork Restricted Startup type Automatic Help me configure service startup options Service status Started Stop Pause You can specify the start parameters that apply when you start the service from here Other general configuration requirements are as follows 1 The build should mimic that of a packaging build that is to say sa 7oa0 0D C
285. te saved report groups you no longer require 13 1 2 Package Selector This option is used to select only the packages containing the types of issue that you choose All other packages will be deselected For example if you only want to select packages that contain non supported drivers for Windows 7 choose the option shown below o Package Selector Select Report Group Name Select Report Name a ox Windows 7 D Hard Coded File References Scan v3 42 UAC File Header Analysis v1 05 Windows 7 Windows Resource Protection Scan v4 17 Legacy Help File Scan v3 25 Install Logic Scan v1 12 Custom Action Securty Scan v3 14 Legacy Control Panel Applet Scan v3 1 GINA Deprecated Component v3 16 Select Green Packages 13 1 3 Create View Use the Create View option on the Packages tree right click menu to create Views or Groups for your packages You may use the Views to organize your packages by Business Unit Package Type or any other kind of logical structure 190 13 Advanced Usage Quest ChangeBASE 5 3 User Guide 1 First of all you are asked to give a name to the View at Add View 2 When you click OK you will see that your View has been added to the View list in ChangeBASE dadak AN Ultimate Reports New Project Wizard Reports Adobe Acrobat 9 Pro Refresh Results Clear Results Assessment Results
286. tensions INI CONFIG XML BAT CMD VBS By default there is a threshold of 5000 bytes on these files However you can change this by adding a line to localappdata ChangeBASE UserData WorkBenchSettings xml For example to change the threshold to 50000 bytes you can add the line highlighted below 187 12 ChangeBASE Options Quest ChangeBASE 5 3 User Guide AU LULU LOL CU yo QULLA UTN RU LL UMpec UcLiavacupyuc I DULL lt LettPanelCollapsed gt False lt LettPanelCollapsed gt lt MSTStudioPath gt C Program Files x86 Quest Software ChangeBASE MSIStudio MS lt SccmSupportedTypes__ gt MSI MST MSI CMD EXE VBS CMD BAT lt SccmSupportedTypes lt SccmReload gt N lt SccmReload gt lt Sccem 6 gt 0 185 1 163 2 190 3 75 4 89 5 196 6 73 9 183 7 71 8 111 lt Sccm gt lt Sccm_ 1 gt lt Sccm_ 1 gt lt VirtualMachine__3 gt HyperV N N Name XP1 Username administrator Password lt c46 gt 30 lt c4d6 gt lt CSVImport__ gt C Program Files x86 Quest Software ChangeBASE BulkCSVImport Note The value is in bytes Note Until the ChangeBASE Plugins are updated you will need to write a custom Plugin to run checks on this data it is stored in the table toblmsiTextBasedFileData Refer to Chapter 14 Writing Custom Plugins 188 13 Advanced Usage Quest ChangeBASE 5 3 User Guide 13 Advanced Usage 13 1 Packages Tree Context Menu There are a number of different options available that allow you to organi
287. the package to ChangeBASE Note This flag only resets the SCCM interface If the package already exists within ChangeBASE another copy is simply added the original is not removed Changes the SCCM view name for the package By default when SCCM packages are added to ChangeBASE and then imported they appear as sub views that is to say sub entries of the main SCCM View within ChangeBASE The sub view name is constructed according to the customer s settings e g the name might include the manufacturer and package name or the package language By using the V code you can specify your own custom sub view name for example a project name and or phase Note The custom view name will only be applied when the package is imported into ChangeBASE not when the SCCM interface adds it to ChangeBASE Once the package has been imported the view name will not change unless the package is deleted and re added or re imported If the customer had previously applied a custom view name they can reset it to the default view name using the X option Note The view name will not change back until the package is deleted and either re added or re imported Note The above flags can be combined with the exception of the V and X options which are mutually exclusive 83 5 Importing Packages Quest ChangeBASE 5 3 User Guide An example of setting three packages to be added to ChangeBASE with associated view names and ApplDs is
288. the required table s within the database for packages that contain the particular pattern that you have entered without needing to enter wildcard symbols For example if you look in the FileName column of the File table for the string xla the Pattern scan will return all instances of xla files within the packages selected Two Dimensional Result Set contains two columns or two dimensions of data such as a FileName and Version a Registry key and Value a Property and Value or INIFile name and Section This report or result type is typically used to capture information on lists of filenames or registry keys and is employed in the Middleware reports One Dimensional Result Set contains one column or one dimension of data such as a FileName a Registry key a Property or INIFile name This report or result type is typically used to capture information on lists of filenames or registry keys All Table Scan scans all of the primary tables within the database for packages using Report Proc prGenScan_RA 1 Custom allows you to select from either one of the empty stored procedures such as prGenDummy results to create a report from scratch or to leverage one of ChangeBASE s existing report templates which can be extended to include custom logic 217 14 Writing Custom Plugins Quest ChangeBASE 5 3 User Guide Report Proc Most typically used in conjunction with the Custom Report Template to select an individ
289. ther or not they are used on 64 bit Windows It can only detect their presence The recommendation is that this package should be run through User Acceptance Testing to validate that no issues are found when using the software 151 10 Fixing Packages Quest ChangeBASE 5 3 User Guide 10 Fixing Packages Where fixing is available as indicated by the presence of the cog icon in the Fixes Available column check the box associated with the issue to be fixed This will activate the Fix function in the packages view of ChangeBASE Run the Fix function against one or several fixable issues Note It is generally recommended that you apply fixes to packages using Transform MST files To specify your MST requirements select the General Tab el Options acm Report Options File Extensions automatically added during folder scans Retain Report Results On Tab Change Show Checked Out Packages Only File Extension a 7 Identify Packages With Product Name Confirm ClearResults DCAP s Transforms EXE Vv Generate Transforms VBS Roll up Fixes BAT Suppress Transform Validation Errors CMD Z Auto Select Single Transforms INF Package Importv Fix osl Backup MSI Before Applying Fix Database Options Import Non Core MSI Tables Siarer Thionia 30 Import COM Snapshot Data Connection Test Timeout Secs 20 Checkout Packages Automatically Maximum No Simultaneous Imports 54 Remote DB Server Install Folder PE File E
290. tion easier ined end aaa ae aes dni ese ceke eee eatece eee 229 15 5 Loading Source Folders for Web Data Capture cccceccecseeseceeeeeceeseeseeaeeeeees 230 19 6 Client Side Capture CSC severance ete eerie csc nies ae eee 230 19 0 T COG AV CHILC CLIC ats sos sth accion A os EA E A 231 10 6 2 System IREQUIFCIMEMIS censire eae ee ee 232 1909 CSC fay 2 1 2 6 9 mere tere aerate ert et ete eee ee 232 15 6 4 CSC Configuratio ab eiivecetactccadeoatece tested se ere Mack eaaa aaaea hania a ari web ati we kabel 233 15 6 4 1 CSC Manager Manage Default Parameters ccccccseeeceeneeeeeeneneseanenessaeeeees 233 19 0 4 2 Manage FINES iu eA TEA a E A TEES 235 190 9 Vey CSC CLO e a iada adadad iniaiaiai iaia 236 O0 aT Web SCI VIC Cass Scie ee a a E N eel in eae isaee 236 19 60932 CSC AG CIM anor ana a A cae ode E 237 15 6 6 Using CSC from a Client aaa0aaanananannnnanannnnnnnnnnnnnrnnnnnnnnnnrnrnrnrnrnrnennnnrnrnrnrnne 238 15 6 7 Loading the Data from the CSC Server to ChangeBASE ccccccecseceeeeees 239 15 7 Importing and Assessing Web Files against Browser PIUQINS cccceeeeeeeees 241 15 8 Troubleshooting Web Capture ecto int sw ate acest cad sande ease esesseinendaaweesntc ue sexceeecaceersecs 241 15 8 1 Problems arising from the Loading of URLs and FolderS ccccccceecneeneees 241 15 8 2 Problems arising from the use Of CSC ccccccccccsecseneenecsuccsccecceceesessessussecseee
291. tml If the log file does not allow you to locate the problem then make the following checks e Verify that the application installs on your current version of Windows e Verify that the application has access to its required files e g external Cabinet Files CABs e Verify that the application loads into Orca and or MSI Studio and or WISE Installshield and apply the associated MST file If you are unable to do this in Orca you can suppress the Transform validation flags and errors in the Options menu within Orca If the package loads now that the validation flags and errors are switched off then you should be able to check Suppress Transform Validation Errors within the General Tab in Options in ChangeBASE to load the MSI with the MST If the MSI and MST combination still do not load try the MSI on its own e Check the MSI Media table entries in MSI Studio or Orca Invalid sequences duplicate CAB names and other invalid MSI entries can all cause ChangeBASE to fail to load If a Transform is being applied remember to apply the Transform in MSI Studio or Orca too Invalid media table directives may cause ChangeBASE to fail during load It is recommended that you obtain the correct source media to resolve this issue 9 6 5 Reboots during Repackaging Some application installers request that a Windows reboot is performed to complete the installation process If a machine reboots while ChangeBASE is monitoring an installer for repackaging
292. to do is to update the value in the Property table of the MSI and all instances of its use throughout the rest of the package will reflect its new assignment 146 8 The Top Five Issues Explained Quest ChangeBASE 5 3 User Guide 8 4 UAC File Headers 8 4 1 How to Reproduce the Problem 1 Install the software 2 Find the program identified by the test 3 You will notice that the icon is overlaid with a yellow and blue shield 6G Prog Elevate O ConsoleAp Co nsoleAp plication_hi plication_re ghestAvaila guireAdmn ble 4 When you run the program you will see a User Account Control prompt looking like this Program name ConsoleApplcation_require Admn exe Verified publisher Unknown File ongin Hard dive on this computer To continue type an administrator password and then click Yes TheAdministrator sl Show details Note Unless your users are all going to have the administrator password you will need to suppress this dialog 8 4 2 Explanation of the Issue Windows looks inside the properties of portable executable files to see if they contain certain keywords such as setup update etc If it finds them it sets the shield icon to indicate that the program will need to be run with elevated privileges 147 8 The Top Five Issues Explained Quest ChangeBASE 5 3 User Guide Other files can contain Manifests that can force the program to require elevation A Manifest is a settings f
293. to the text box below using the Add button i n Update All Platforms Local Machine File Setting Scan Best Pr Details Rules Target Columns Target Tabie Sequence Fix Type SQLStream RAG Status Amber Fix Data pritemLevelCleanup Rule Source Microsoft Value Set _dataoracleclientperfcounters_shared12_neutral h _dataoracleclientperfcounters_shared12_neutral ini _dataperfcounters h _dataperfcounters ini _dataperfcounters_shared12_neutral h _dataperfcounters_shared12_neutral ini _default pif _delis ini 220 14 Writing Custom Plugins Quest ChangeBASE 5 3 User Guide Note You are free to type individual values or cut and paste from text sources such as Notepad or Excel When adding data for more than one column it is advisable to cut and paste from Excel g The Paste button will only become enabled when the following conditions have been met e There are matching elements in the Paste buffer For example single dimension checks will expect a single column while two column checks will require two columns of text data e A target table has been selected e Atleast one target column has been selected and added appropriately e Once this has been accomplished you see your rule data appear in the Value Set section of the Report Generator 221 15 Browser Compatibility Quest ChangeBASE 5 3 User Guide 15 Browser Compatibility This chapter covers the testing
294. ts Platforms Upgrade Services Security Report Costs Duplicates Browser Compatibility Add in Repackaging Options Dashboard Virtualize A E Role Admin User v Add Package Manually Add Reports or Plugins ofin E E Add Package to Core App List Allow Additional Package Views Transform Application Directory Structur Convert It Local Convert It Source Capture z PROD igreen Core App Lists Scan Create Readme Clear Checkouts Use the Dashboard Tab in the Options S Database Maintainer Delete Package Delete Report Edit MSI Package Orca Edit MSI Package MSIStudio ZS SS Seg S S Ss Edit Plugins Plugin Editor OK pr Cancel The Role drop down allows you to select either the Admin User or the Standard User role and then apply the required permissions to each role In addition to permission settings the administrator can also clear the packages checked out against a given user or multiple users Simply select the required user role and then click the Clear Checkouts button 178 12 ChangeBASE Options SETTING Add Middleware Add OS Snapshot Add Package Add Package to Core App List Allow Additional Package Views Allow SFT Files Virtualization Streams to be imported Convert it Local Convert it Source Capture Copy Issue to Clipboard Core App Lists Scan Create Readme Database Maintainer
295. ts Quest ChangeBASE 5 3 User Guide RCH ONO REPOR Gere a Cone erent Pe ee ee Se en wa ee Pe ee eRe Eee een eee ae 213 URC OWM OM xt rag OR eter erste ete teers eee etree eee etree ee ee een eather erent ere rere reer 213 14 Writng C stom PIUIGING sisetece dese cecs ie cee anaa a aeae aini 215 14 1 Moving Reports and Re organizing Existing PIUQINS cccccceeceeceeceeeeeeeeneeaeees 215 Z Adding INC DON Groups rare ee eae oe aaa 216 dF See AT Bor2 a mettre te erp ort nn en rt ne 216 14 4 Adding Rules to a Report ccccceccecceccecseceeceeseeseeceececaeeeceesueausaecueseesansaeseeseeaeeas 218 15 Browser Compatibility sisses A NAKRAR 222 erko adino OR ES AAAS 222 TZ AUO LO ON iran oe hc ene EE RERE REES ENER ee 222 15 2 1 Auto Logon Process OVEIVICW ccccsccseneeneesuccuccucceccecsesessessussuececcuceusssuseeees 223 15 2 2 Auto LOGON Pr cess Explained serren arean E TEE TEE E E EEEa 223 192 3 CONNGQUENG AUTO LOOON SClINOS 2 ck ska 224 19 2 4 Selecting LOGON CONntHOlS reroror cece ee a E EREE 226 15 2 5 Selecting an Existing Group Of Se ttinGS cccccccccececcecceeseeseeaeeesseseeseeseeeeeas 228 15 2 6 Deleting a Group Of Settings ccccccccccseceeneeseccecceccucceneuseesessussucceccuceesusseeeeees 228 193 WeDGE Iw SENGS ranan ns eter eed vem EE ARA 228 15 4 The Web Application Import Process cccccccccecc ees eee eee eeeeeeeseeseeseeaeeaeeeeaeeaeeaeees 228 15 4 1 HTTP Authentica
296. tualized Package Environments 14 VIX 91 95 108 VMware 1 12 14 22 91 95 98 107 110 155 156 157 160 161 162 170 204 Server 22 162 Tools 22 156 Workstation 22 24 98 157 161 W Web Analysis Mode 24 185 222 230 Web Application Importing 228 Web Capture Troubleshooting 241 Web Crawling 185 228 229 Settings 228 WIM 179 204 205 Alternatives 204 Driver Files 205 File Loading into ChangeBASE 205 Mounting 205 Windows 32 bit 11 14 22 155 Quest ChangeBASE 5 3 User Guide Windows 64 bit 11 14 21 22 110 111 114 123 125 146 151 155 Windows 7 1 11 14 18 21 22 37 63 64 91 110 111 123 125 146 150 153 155 156 157 159 190 204 206 232 Windows 8 11 14 18 21 37 157 171 232 Windows AIK 205 Windows Authentication 28 31 32 42 57 Errors 57 Windows Defender 93 157 170 Windows Imaging Format See WIM Windows Security 27 Windows Server 2003 11 14 18 21 41 64 211 232 Windows Server 2008 11 14 18 21 41 64 110 111 211 232 Windows Server 2012 14 18 21 37 64 232 Windows Vista 22 41 64 211 Windows XP 18 20 21 22 41 94 108 144 146 148 155 157 159 204 211 232 WorkBenchSettings xml 25 109 175 187 211 228 Working Directory 23 25 33 45 66 170 186 211 212 Writing Custom Plugins 215 X XenApp 12 14 22 110 111 123 155 156 160 168 249 About Quest Software Inc Q
297. ture OS Snap If you do not see this option contact your ChangeBASE representative If you have UAC enabled then you must close ChangeBASE and reopen it as an Elevated Administrator Click Import 205 13 Advanced Usage Quest ChangeBASE 5 3 User Guide 6 When it has loaded right click on the package and add it to a Core Application Group 7 Locate the Core Application and set it as an Operating System Snapshot 13 4 CAS Core Application Scan The CAS Core Application Scan is a reporting structure supported by ChangeBASE which allows you to quickly and easily create a group of packages that can check for package level conflicts with other selected and imported application packages The CAS is intended to check a number of application packages against a core list of application packages that are already imported into the database What is Conflict Management Conflict Management is a method of addressing issues where applications conflict with one another and the Operating System There are a number of problems that are encountered especially if a number of applications are installed and uninstalled on a system Common issues 1 Incompatible Versions A particular version of a library may be incompatible with an older or newer version There have been many rules put in place to prevent these situations but this can still occur particularly with older applications Many applications relied on the bugs that ex
298. twork Service SQL Server Agent SQLEXPRESS Executes jobs mo Automatic Network Service amp SQL Server Browser Provides SQL Serv Automatic Network Service SQL Server VSS Writer Provides the interf Automatic Local System TE SSDP Discovery Discovers network Manual Local Service T Storage Service Enforces group po Manual Local System Superfetch Maintains and im Manual Local System ci SwitchBoard Manual Local System C System Event Notification Service Monitors system e Started Automatic Local System tei Tablet PC Input Service Enables Tablet PC Manual Local System amp Task Scheduler Enables a user to c Started Automatic Local System The instance name is given in brackets SQLEXPRESS in the above example Proceed as follows 1 Enter the Server Name in accordance with the above notes 2 If SQL Server has been configured to use SQL Security as in 2 2 3 2 SQL Setup using a SQL Login uncheck Use Windows Security and enter the SQL username and password 3 Click Next and the SQL connection will be tested aaa ChangeBASE CREATE DATABASE Connection to sqlexpress completed successfully Oick Nest to continue 43 3 Basic Configuration Quest ChangeBASE 5 3 User Guide If a successful connection has been established to the database server click Next and move to step 4 If incorrect credentials were supplied for the database server the following will be displayed Click Previous to e
299. u are using Windows authentication but that the name of the machine hosting ChangeBASE has not been added to the group with the requisite SQL permissions refer to 2 2 3 1 SQL Setup using Windows Authentication Complete the following steps 1 Add the name of the machine to the group If you still receive an error proceed to the next step 57 3 Basic Configuration Quest ChangeBASE 5 3 User Guide 2 Have a SQL login set up in accordance with 2 2 3 2 SQL Setup using a SQL Login 3 Disconnect and then reconnect to the Database in the ChangeBASE Workbench using the new SQL login just re entering the properties is not good enough you must disconnect al Please select a Server and Database E ChangeBASE CONNECT TO DATABASE ServerName EU8825 SQLEXPRESS X E User name Password F Use Windows Security ard EU8825 SQLEXPRESS CBTest Create Database Connect To Existing Database D Rename Disconnect Properties 4 Re register the Dashboard to the IIS Server this will tell the IIS Server to connect to this database using the new Workbench connection wd Options General issue Summary Core App Lists Platforms Upgrade Status Dashboard version 1 0 0 currently installed and is enabled Uninstall Disable Not registered with IIS server localhost Dashboard f a aan ee al e spite a a gradem sana no A a T ae R
300. u to specify the following e The format of the SCCM view grouping string e Whether the SCCM interface should search Distribution Points as well as package source if it cannot access or find the required files in the package source e When Loader Support is enabled licensable option e Fixed exclusion filters which will hide packages programs as necessary The SCCM view grouping string is used to group SCCM packages under the SCCM view within ChangeBASE after such packages are imported to ChangeBASE This string can contain a combination of literal values and data extracted from SCCM The available data for inclusion is as follows SCCM Server name SCCM Database name SCCM Package Folder SCCM Package Manufacturer SCCM Package Name SCCM Package Version SCCM Package Language Package Source Folder SCCM Package ID T 5 Importing Packages Quest ChangeBASE 5 3 User Guide When entering the format string an example of the group name is shown below the input If the format string entered is invalid an error message will be shown and you will not be able to save the format Loader Support should only be checked if you use an indirect method i e via a loader exe file to locate MSI files where each MSI is accessed via a loader ini file Then when the SCCM interface encounters a loader exe it processes the loader ini and adds the appropriate MSI or EXE rather than the loader exe The fixed exclusions can be entered b
301. ual report whose logic most closely meets the requirements Fix Proc This drop down box allows the selection of specified types of remediation or Fix logic The most common Fix type is GENCLEAN which safely removes any entries that have been reported upon Merge Module This mechanism for reporting on entries that are contained in a Merge Module is no longer in use Version No This field is vital to ensure that a Plugin is updated with the later version being automatically downloaded the previous version being deleted and then the later updated version being installed For this process to function correctly each Plugin has to be correctly and incrementally versioned Effort and Cost These fields are used to pre configure the amount of effort in hours or minutes and the cost associated with fixing the issue manually This information is used in conjunction with the Reports Tab to show the savings made by Fixing issues using the solution set Rule Summary This section provides an overview of the rules their target tables and the RAG status for each grouping A sample looks like the following Rule Summary Table Columns Fre Type FileName SQLStream 14 4 Adding Rules to a Report Once you have created the Report description fields determined which reporting and Fix logic will be employed you will generally need to add data to the Plugin There are exceptions to this as some Plugins rely solely on business logic in SQ
302. uest ChangeBASE 5 3 User Guide About Quest Software Inc Established in 1987 Quest Software Nasdaq QSFT provides simple and innovative IT management solutions that enable more than 100 000 global customers to save time and money across physical and virtual environments Quest products solve complex IT challenges ranging from database management data protection identity and access management monitoring user workspace management to Windows management For more information visit www quest com Contacting the Quest ChangeBASE Community For the latest hotfixes release notes and patch news and the opportunity to become generally involved in the development of ChangeBASE go to http communities quest com community changebase Contacting Quest Software Email info quest com Mail Quest Software Inc World Headquarters 5 Polaris Way Aliso Viejo CA 92656 USA Website www quest com Refer to our Website for regional and international office information Contacting Quest Support Quest Support is available to customers who have a trial version of a Quest product or who have purchased a Quest product and have a valid maintenance contract Quest Support provides unlimited 24x7 access to our Support Portal at www quest com support From our Support Portal you can do the following e Retrieve thousands of solutions from our online Knowledge Base e Download the latest releases and service packs e Create update and revie
303. ummary has two fully expandable and collapsible trees Packages this is used on the Packages Tab to show the imported packages and files and the results of their assessments Reports this is used on the Packages Tab to show the loaded report groups and reports and on the Reports Tab to show the latest assessment results by report group and report 62 4 ChangeBASE User Interface Quest ChangeBASE 5 3 User Guide Ultimate faee ChangeBASE Reports New Project Wizard N x y D E amp Fovcomment gt Browse Browse with SCCM nport ConvertiT Fitters CSV Import Basic Filters v1 02 ASSESS I Firefox Presentation Compatibility Fix Virtualisation App V ee Windows 64 bit Windows 7 SOC Reports uv Refresh Results 7 Packages Clear Results Windows Server 2012 Windows Server 2012 Legacy File Reference Adobe Acrobat 9 Pro Adobe Reader 9 1 Adobe Apps PDF Re Adobe Photoshop Elements 9 Adobe Apps Windows 7 Oo Assessment Result OOO Utta at Summary Packages Reports Rules Scanned Rules 1245 Issues 9 o eaa assyst Enterprise 8 0 Dragon NaturallySpeaking 10 10 oO Elements 9 Organizer Upgrades Available 725 FileZilla VVin32 Windows 7 Active Directory GPO Settings Analysis v3 31 SK b Common Dialog Compatibility Analysis v1 06 Custom Action Security Scan v3 18 Adobe Photoshop Elements 9 Deprecated API Analysis v3 29
304. urth line indicates the number of packages that have been fixed The final line identifies the number of packages that have been converted into a virtual format Target Date and Target Packages which can be set up in the Dashboard Options screen are used for the Progress Summary chart They are represented on the chart by pink dashed lines The Target Date is a vertical line with the date in a white background 131 7 Dashboard Quest ChangeBASE 5 3 User Guide box The Target Packages are represented by a diagonal line starting at zero from the left and finishing with the Target amount on the right Note that both lines are not drawn to scale because where the target values are large this could reduce the progress values to flat lines at the base of the chart 7 2 2 5 Best Way Forward The Best Way Forward page groups packages to preferred platforms where each Platform has one or more report groups Packages that are Red or Amber are moved to the next suitable Platform If the RAG Status is Red or Amber for all Platforms then it will be assigned to an Incompatible group To view the Best Way Forward page click the Best Way Forward button in the top right corner of the Executive Summary page The Best Way Forward page displays a series of pie and column charts The charts on the left display the original values from when the details were first assessed the middle charts show the current state and the charts on the right sh
305. utton to reload the Plugins If a Plugin fails to load after several attempts 3 then contact Support with the following e Ascreenshot of the error message when the cursor is on the red cross e A zipped copy of the log folder which is located in the database Working Directory 4 6 5 2 Inability to access Services in the Upgrade Tab Intermittent internet connectivity can prevent the Plugins from being downloaded from the Upgrade server so you should retry the load process after a few minutes If access is still unavailable then you should check whether you have proxy settings as these can prevent you from being able to access the Upgrade Services To verify the settings 1 Configure them via the Services Tab in the Options menu 2 Click OK to save your changes 66 4 ChangeBASE User Interface Quest ChangeBASE 5 3 User Guide 3 Close the Options window 4 Re open the window and go to the Upgrade Tab 5 If you still cannot access the services in the Upgrade Tab open a web browser and enter the following URL http www aokserver com AOKUpgrade Upgrade asmx If the web page from the URL above is not displayed then either your internet connection is down or your firewall is blocking access 6 If the web page is accessible and proxy configuration details have been configured correctly visit any web page which is not cached for example Google News so that the proxy server can authenticate the logged on user If
306. w Support cases View the Global Support Guide for a detailed explanation of support programs online services contact information policies and procedures The guide is available at www quest com support 250
307. xt to them Hovering over a progress bar brings up a tooltip with more detailed progress information for example wf Applications of magicrar mel J QuickTime msi J Sareung PC Studio PC Syne mel J SF_Apo Sequencing m i DCE ARDE 2737514ACFDEE Trinket mz i Overall progress is shown in the status bar at the bottom of the window for example localhostisqlexpress CB JOHNTEST Importing Selected Items 3 of 4 completed A T v5 3 0 Stop Loading pa 5 2 3 Browse with SCCM The SCCM System Center Configuration Manager Interface is invoked by clicking Browse with SCCM in the Packages panel refer to 4 1 Packages Panel This will enable you to browse for packages contained in your SCCM database 75 5 Importing Packages Quest ChangeBASE 5 3 User Guide Refresh Results Clear Results AssessmentResuls Summary Packages Reports Rules scanned Rules Issues Upgrades Available Note ChangeBASE is compatible with SCCM 2007 and with SCCM 2012 for basic package program support 5 2 3 1 Main Dialog Once you click the link the ChangeBASE SCCM Interface dialog is displayed SCCM ernan SODH Sewer OME MOLAB GME Dph QHEDEMOLAR SMS DMX TEH Seve SEMAN DC Git The initial screen shows the version of the SCCM interface installed if any plus any upgrades available and allows you to set the SCCM interface options This screen also lists the SCCM servers databases The buttons beneath the
308. xtension Additions e Recommended option to add fixes to a new or existing MST Deselect Backup MSI before applying Fix and select the Generate Transforms check box and the Roll up Fixes check box if you would like the Fixes to be wrapped up into the standardization Transform Where multiple Transforms have been applied the Fixes are always rolled up into the first Transform in the sequence e Add fixes to a new MST MSI with standardization Vendor MSI Deselect Backup MSI before applying Fix and select the Generate Transforms check box e Add fixes directly to the MSI Select Backup MSI before applying Fix and deselect the Generate Transforms check box e Update the MSI and create a fix MST for the original MSI If in doubt deselect Backup MSI before applying Fix and select the Generate Transforms check box and the Roll up Fixes check box This can safely be used for all types of installation 152 10 Fixing Packages Quest ChangeBASE 5 3 User Guide The fixing scripts running in the background will use SQL statements to update the Repackaged MSI or the MST for the vendor MSI There are 3 types of fix available e SQL statements to resolve the issues within the MSI file e The removal of files or registry keys which should not be included as part of the installation package e The inclusion of a Manifest or runtime element to allow the package to run e g for Control Panel Applet support on Windows 7 When fixing i
309. y package imported into ChangeBASE with several additional GB for other working files e To improve import performance in a multi user environment check the option Store Working Data on Local Disk on the Options gt Services Tab This will cache the packages in the local user profile while processing the import of the application before the files are transferred to the Working Directory Local Databases DB1 DB2 DB3 e Scenario Only one ChangeBASE client accessing local database e Unique Working Directory for each database e For DB1 the Working Directory is Cr CB Working DBI Computer g 58D_0S C di CB Working dJi DBI Ji DE do DB3 Remote Databases DEB DBZ DBS scenario Multiple ChangeBASE clients accessing databases remotely Shared folder on central server contains working directories UNC path used to define Working Directory For DB1 the Working Directory is PCO7 CB Working DB1 aje p07 a CB Working Wi DeL di J DB Alternatively each client maps the same drive letter to the shared folder and this path is used 23 2 Installation Quest ChangeBASE 5 3 User Guide 2 1 5 Recommended Configuration for Optimal Performance For optimal performance it is recommended that e lf you are using VMware Workstation you use 64 bit Windows for the host machine e f you are using 64 bit Windows for the SQL Server machine you use 64 bit SQL Server If you are run
310. y clicking the Exclusions button on the Options dialog This will result in the Exclusions dialog being displayed where you can view add edit or remove exclusions SCCM Exclusions This dialog lists the default exclusion fiters applied to the SCCM data The match sting can contain wildcards using the asterisk character e g Uninstall Column Match Program Name Uninstall Program Name ka Uninstall Exclusions filters will exclude any package program that matches any filter For example if an exclusion filter is set up for the Program Name with a Match value of Uninstall then all programs with a name starting Uninstall will not be displayed Exclusion filters can be set up against the following fields SCCM Program Name SCCM Package Language SCCM Package Manufacturer SCCM Package Version SCCM Program Command Line Program Type as determined by the ChangeBASE SCCM Addin SCCM Package Name SCCM Container Note Exclusion filters hide entries by default However these can be overridden on the package program list by right clicking in the list and selecting Show Excluded Items from the context menu 78 5 Importing Packages Quest ChangeBASE 5 3 User Guide 5 2 3 3 Configuring a new server database The following is displayed when you click the New button SCCM Server Properties Server Access Access SCCM via WMI Access SCCM Database SCCM Server Name QMADEMOLAB Database Mx Secunty Cre
311. yper V the following tasks are also required For Hyper V VMs ChangeBASE uses WMI to connect to the guest VM for user authentication With Windows XP this needs to be enabled as it is disabled by default To enable remote WMI follow the steps below a Navigate to Start gt Control Panel gt Administrative Tools gt Local Security Policy Navigate to Security Local Policies Security Options Network Access Let Everyone permissions apply to anonymous users Set to Enabled d DCOM Machine Access Restrictions Add Anonymous Everyone Interactive Network System with full rights options set e Network Access Sharing and security model for local accounts Set to Classic f Reboot the guest to make sure the settings are applied 7 Take a Snapshot of the Virtual Machine while it is logged on 8 Make a note of the Snapshot name and ensure that no other Snapshots exist with the same name 5 4 2 ChangeBASE Repackaging Options Open the ChangeBASE options and select the Repackaging Options Tab Up to five Virtual Machines can be added Click Add to set up a Virtual Machine The types that you can set up are as follows 94 5 Importing Packages Quest ChangeBASE 5 3 User Guide 5 4 2 1 ESXi 5 1 VMware Server at Update Machine Config Type VMwareServer ESX Name XP32 on ESXi 5 1 W Enabled Setting Type Setting Value VMX AP 32 Usemame VMuser Password peopeees System FolderPath Browse File
312. ys the path of the selected package The arguments to use when installing the package Attempts to detect the silent install arguments for the selected package If checked then the arguments for the currently selected package are not used You must manually install the package within the Virtual Machine If the currently selected package is an EXE based installer and the package has been repackaged within ChangeBASE then you can check this option to use the generated MSI If this option is checked then the package will be installed as a prerequisite that is to say before capture begins If the package you wish to capture has source files which are external to the installer then checking this option will copy all files in the folder in which the package resides Be careful when checking this option if your packages are all contained within the same folder as this could result in ChangeBASE copying a large set of files to the Virtual Machine unnecessarily Clicking this will allow you to save the currently defined sequence configuration to an XML Manifest file for use with the Virtualize from Manifest option 11 3 4 Package Virtualization Using a Manifest file To virtualize from a Manifest file you have saved in the Manual sequence configuration dialog simply right click on the Packages node in ChangeBASE and select Virtualize from Manifest The following dialog will appear Manitest Click Browse to choose th
313. yst Enterprise 8 0 Dragon NaturallySpeakin v Expand Configure Logon Settings Create New Logon Settings Collapse Elements 9 Organizer FileZilla VWin32 FrontRange Solutions Goldmine 5 5 _ HotDocs 2008 Professional Edition v Packages Reports Rules Scanned Rules Issues Upgrades Available Ef v5 3 0 http communities quest comindexjspa E Package Base URL Auto Logon Description Logon URL Heartbeat URL Heartbeat Unique Text This page allows you to configure Auto Logon settings for this package please enter a name for these logon settings and then fillin the URL of the logon page for this package Pressing the refresh button will show the logon page of this package and once this has been done you must then select the user name password and logon button from that page and press OK 225 15 Browser Compatibility SETTING Package Base URL Auto Logon Description Logon URL Refresh Button Heartbeat URL Heartbeat Unique String Browser Status The Browser Window Quest ChangeBASE 5 3 User Guide DESCRIPTION The Auto Logon crawler should start searching for pages at this address following authentication This is a descriptive name which can be used to identify this group of settings It must contain only alphanumeric characters spaces hyphens and underscores The logon URL should be the location of the web page where you can authenticate against the site using Forms Authentication T
314. z ChangeBASE Setup a ex Custom Setup Quest Select the way you want features to be installed ChangeBASE Click the icons in the tree below to change the way features will be installed E ChangeBASE This will install IIS if necessary to add a Dashboard website for viewing and generating reports This feature requires OKB on your hard drive Reset oks C e Jet cancel When running in a multi user environment as shown in the diagram in 2 1 2 Remote Database Setup the Server Components require access to the database accessed by the clients with Dashboard making a SQL connection to the database used by ChangeBASE For full details of Dashboard configuration following ChangeBASE installation refer to 3 4 Configuring and enabling the Dashboard Components for the ChangeBASE Database s 20 2 Installation Quest ChangeBASE 5 3 User Guide 2 1 2 2 Requirements for Remote Database Setup Client Operating System Windows XP SP3 Windows Vista SP2 Windows 7 Windows 8 Windows Server 2003 inc R2 SP2 Windows Server 2008 inc R2 Windows Server 2012 Minimum Hardware 2 5GHz dual core processor or greater 4GB RAM 50GB hard disk space 1024 x 768 display Software Requirements Hypervisors for Repackaging See 2 1 3 Virtual Machines Microsoft NET Framework 3 5 SP1 and 4 0 30319 or later Full Client Microsoft Log Parser 2 2 For importing folders as packages
315. ze and modify the way in which you view your packages These options are available in a context menu when you right click the Packages tree 7 Save Retrieve Reports E Adobe Acrobat 9 Pro ave Retrieve Repo Package Selector J Adobe Reader 9 1 are ears M Adobe Photoshop Elements 9 Create View E assyst Enterprise 6 0 Organise Views iW Dragon NaturallySpeaking 10 Virtualize from manifest al Elements 9 Organizer Expand MW FileZilla Wind Collapse 13 1 1 Save Retrieve Reports E Adobe Acrobat 9 Pro Save Retrieve Reports iW Adobe Reader 9 1 Package Selector MW Adobe Photoshop Elements Create Wie assyst Enterprise 3 0 Organise Views Dragon MaturallySpeaking 1 Virtualize from manifest W Elements 9 Organizer FileZilla Wina a Ex pa nd collapse This option allows you to save the current set of report results for subsequent retrieval Saved results are not affected by the Clear Results command To use this select the Save new results group option as shown above 189 13 Advanced Usage Quest ChangeBASE 5 3 User Guide Choose a name for the group atid Save Results Group Enter a name for your report group Packages tested in May Once you have saved this group it will become available from the same option in the future unless you choose the Manage Results groups option which will appear after you have created at least one saved report group This option will allow you to dele

ChangeBASE 5.3 - User Guide

Contents

Download Pdf Manuals

Related Search

Related Contents