Академический Документы
Профессиональный Документы
Культура Документы
" For information about purchasing this training manual and to learn about other training materials, please visit http://www.flexerasoftware.com.
This chapter describes the typical steps relevant to preparing for the application migration process. Before you begin the repackaging process, it is strongly recommended that you perform the following tasks. Table 2-1 Steps to Prepare for an Application Migration Step Defining the Storage Structure Setting Up Your Testing Image Description Define the Application Migration storage directory structure. Define your standard images for the development and the test machines. Define an Installation Flow and Options document, and an Acceptance Test document. Copy Repackager and OS Snapshot to a shared network location. Open the Global Exclusions Editor and edit the global exclusion lists.
ADS-1000-TG00
43
You would then create subdirectories to store the repackaged installation while it is under development, while it is being tested, and when it is completed. It is suggested that subdirectories for a project be named something similar to the following. Table 2-2 Suggested Project Subdirectories Subdirectory
\1_LegacyInstallation
Description This directory should contain a copy of the original legacy installation program media. This directory will store the .inc file (and other Repackager output) containing the changes captured by Repackager after running the legacy installation on the standard image. This directory will store the InstallShield Editor project (.ism file) generated from the .inc file. You may want to create subdirectories in this folder to store different versions of the .ism project at different stages of the cleanup process. This directory stores the completed Windows Installer package. This directory might contain an Installation Flow and Options outline, any acceptance-testing documentation, and corporate-standards documents, as well as any repackaging notes (any concerns with file versions, dates, or times, and so forth). Typical application migration documentation is described in the following sections.
\2_RepackagerAndSourceFiles
\3_ProjectFiles
\4_CompletedMSI \5_Documentation
Tip It can be useful to place the storage-structure directories on a shared network drive, instead of on the local system.
44
ADS-1000-TG00
The following figure shows a typical directory structure, for an application called SampleApp.
Development Environment
The development system has AdminStudio installed on it, and is the system on which you will perform application migration tasks such as editing and building Windows Installer packages.
ADS-1000-TG00
45
Testing Environment
As described in Running Repackager on a Clean Machine, you can run the AdminStudio repackaging tool on a test machine over the network. The test machine is a machine with an easily restorable standard operating system image on which you will perform repackaging, create operating system snapshots, and test installation packages. When setting up your testing environment, follow these best practices: Standard imageA standard image is the base casean operating system image without any end-user changes. It is the minimum possible configuration that all of your end users will have. Any applications that are not common to all of your end users should not be included on the standard image. Repackage on a clean imageIdeally, you will repackage on a clean image. A clean image is a standard image (a machine with only the operating system and its service packs installed, with no applications) plus items such as Internet Explorer and the Microsoft .NET Frameworkbecause they are closely tied to the operating system. Using a clean image for packaging ensures that all necessary files are picked up through repackaging because they will not already exist. Test in end-users environmentYou should test in an environment similar to the one that your end users will have because the results of the repackaging process may differ, depending on what is already installed on their machines. This is one of the best ways to ensure that your repackaged installation is robust and behaves predictably on all your end users machines. Create clean image for each OS targetYou need to create a clean image for each operating system that you intend to target. Ideally, you should repackage for each operating system and then combine the differences in one installation (using component conditions, described in Chapter 6, Using InstallShield Editor, to install different files on different operating systems). As described in Chapter 10, Application Management, you will also typically want to create an OS snapshot for each operating system you want to target. Do not install AdminStudio on standard imageThe standard image should not have AdminStudio installed on it unless your end users will also have it (which is unlikely). As described later in this chapter, Repackager can be run remotely or standalone, separate from the rest of the application. Using VMware When RepackagingInstead of using multiple machines for repackaging, it can be useful to perform repackaging using virtual-machine software such as VMware. Repackager provides a VMware Repackaging Wizard.
46
ADS-1000-TG00
Overview of Documentation
Documentation plays a critical role in the success of an application migration project. This section explains the types of documentation required.
ADS-1000-TG00
47
Testing Guidelines
After you have the installation instructions, you need to develop testing guidelines, which provide a detailed description of the application test procedures. Usually, the packaging team will also define standard tests that are performed on all migrated applications. These tests may include items such as: Validation Conflict analysis Installation/uninstallation Functionality smoke tests
Additionally, this task will require cooperation with your liaisons to define use cases and/or other instructions to test full product functionality.
Project documentation should be stored in the Documentation (or 5_Documentation) subdirectory of your project's storage structure.
Note To assist your organization with organizing and managing your software packaging and deployment process, AdminStudio offers AdminStudio Workflow Manager (described in Appendix D, Workflow Manager, Report Center, and Job Manager), a scalable Web-based application management system that gives you control over your software package management process. Workflow Manager enables your organization to work together to quickly prepare software for deployment while ensuring best practices are always followed.
48
ADS-1000-TG00
This step ensures that you know how to respond to each dialog box displayed during the legacy installation. Recording the input will ultimately save time when you run the legacy installation during repackaging. It also ensures that the installation is performed and thus captured correctly during repackaging, and makes the process more efficient. All input information should be verified and any prompt for which there is no input must cause the legacy installation to be rejected for repackaging. For example, if a serial number is required during an installation and the application owner has not provided it, the application repackaging cannot be completed. Therefore, the installation would have to be rejected for repackaging. Ideally, this document should include screen captures (press Alt+Print Screen while the dialog box is on the screen, and then paste the bitmap into a word processing document) or notes for each dialog box in the legacy installation. Thus, all input information will be thought out and any issues clarified before starting Repackager. The Installation Flow and Options document can also contain pre-installation and post-installation steps, such as a requirement that an application be launched immediately after installation. This type of additional information is dependent on the application being repackaged.
Note Appendix B, Sample Installation Flow and Options Template, contains a sample Installation Flow and Options document.
ADS-1000-TG00
49
Other Documentation
An application migration project will usually include other documentation, including the following: Table 2-3 Application Migration Project Documentation List Document Corporate Standards Description Corporate standards for product installation directories, such as:
C:\Program Files\CompanyName\ProductName
Shortcut Standards
Standards for shortcut locations (such as a Product Name folder inside the All Programs folder of the Start menu). Standards for the Add or Remove Programs support-information settings (such as providing a customized internal help-desk telephone number).
Whether installations will be performed silently, or with a full user interface, or at some intermediate level. Documentation of server locations for the finished installation packages. Documentation of the intended distribution method (Active Directory, SMS, Marimba, and so forth). Definition of different roles and responsibilities in the application-migration process.
Note This manual occasionally refers to an application owner, a sophisticated user of an application who can verify that it functions correctly.
Guidelines for status reports. Application owner contact information (for questions, returns, and escalations).
50
ADS-1000-TG00
Important AdminStudio (including Repackager) must be activated to use this method. In trial (evaluation) mode, you cannot launch Repackager and Repackaging Wizard remotely. The procedure for installing Remote Repackager on a clean machine is fully documented in the Repackager Installation Guide. The following major steps are included:
Task:
To install Remote Repackager on a clean machine: 1. 2. 3. On the machine where AdminStudio is installed, share the Repackager directory (which is a subfolder of the AdminStudio installation directory) and the AdminStudio Shared directory. On the clean machine, map a network drive to those shared folders on the AdminStudio machine. On the clean machine, open the following directory and launch the Remote Repackager installation:
C:\Program Files\AdminStudio\10.0\Repackager\Remote Repackager\setup.exe
This installation creates desktop shortcuts on the clean machine to launch Repackager and the Repackaging Wizard.
ADS-1000-TG00
51
4.
On the clean machine, launch the Repackaging Wizard by clicking the desktop shortcut.
Important Because you are running Repackager remotely, the online help topics cannot be viewed. However, you can view a version of AdminStudio Help Library online at: http://helpnet.flexerasoftware.com
Important When installing Standalone Repackager, you are prompted to enter a valid, activated serial number. You cannot install Standalone Repackager in trial (evaluation) mode. The procedure for installing Standalone Repackager is fully documented in the Repackager Installation Guide. The following major steps are included:
Task:
To install Standalone Repackager: 1. Open the AdminStudio installation CD and locate the standalone Repackager installation in the Tools directory:
\Tools\StandaloneRepackager.exe
2. 3. 4. 5.
Copy StandaloneRepackager.exe to the clean machine. Launch the setup. The Welcome Panel opens. Proceed through the installation, and enter a your serial number when prompted. When installation is complete, you can launch the Repackaging Wizard or Repackager using the desktop or Start menu shortcuts.
52
ADS-1000-TG00
In practice, you will open the Shared Exclusions file and save any changes back to the shared directory from which you run Repackager.
About Exclusions
The Files, INI Files, and Registry tabs of the Exclusions Editor contain lists of data that should never be included in a repackaged installation. The Exclusions Editor can be open in one of two ways: From within the Repackager interfaceYou first open a project in Repackager, and then select Properties on the Project menu. On the Exclusions tab of the Project Properties dialog box, you select an exclusions file to edit and then click Edit to open the Exclusions Editor. See Opening the Exclusions Editor from Within the Repackager Interface. From outside of RepackagerYou can open the Exclusions Editor by locating and executing the following file:
C:\Program Files\AdminStudio\10.0\Repackager\AnalysisOptions.exe
ADS-1000-TG00
53
The Files tab of the Exclusions Editor opens without an exclusions file open. See Opening the Exclusions Editor Outside of Repackager.
Figure 2-2: Files Tab of the Exclusions Editor The default exclusion list contains, for example, the following entries: Any files written to the target systems Temp folder, Temporary Internet Files folder, Recent folder, History folder, Recycle Bin, or browser Cookies folder. Values written to many Windows Explorer registry keys, such as recent-documents lists, performance-related data, menu-order information, and so forth. Transient data such as font caches, Task Scheduler results, and hardware-status information. Uninstallation log files and registry data created by popular legacy installation-development systems (such as the various versions of InstallShield Professional). This data is omitted because Windows Installer creates its own uninstallation information. Files related to Repackager.
Narrowing the analysis options (as appropriate) can speed up the repackaging process. If you make any changes to a settings file, you can select Save from the File menu to save it in the open file, or select Save As on the File menu to save the settings in a new file.
54
ADS-1000-TG00
Task:
To open the Exclusions Editor from within the Repackager interface: 1. 2. 3. Open a project in Repackager. On the Project menu, select Properties. The Project Properties dialog box opens. Open the Exclusions tab. You are prompted to edit the exclusions file stored in the AdminStudio Shared location or to select a custom exclusions file.
4.
On the Exclusions tab, do one of the following: To edit the default exclusions file, select Use settings from the shared location and click Edit. To edit a custom exclusions file, select Use settings from a custom file, browse to the file you want to open (if it is not listed), and click Edit.
ADS-1000-TG00
55
The Files tab of the Exclusions Editor opens, with the appropriate exclusions file open.
5. 6.
Make edits to the file. Save your edits and close the Exclusions Editor by clicking OK.
56
ADS-1000-TG00
Task:
To open the Exclusions Editor from outside of Repackager: 1. Launch the Exclusions Editor by locating and executing the following file:
C:\Program Files\AdminStudio\10.0\Repackager\AnalysisOptions.exe
The Files tab of the Exclusions Editor opens without an exclusions file open.
ADS-1000-TG00
57
2.
Perform one of the following to open an exclusions file: Shared ExclusionsTo edit the shared exclusions file, on the Files menu, point to Open and click Shared Exclusions. The exclusions in the shared exclusions file are now listed on the Files tab.
Custom ExclusionsTo create a new custom exclusions file, on the Files menu, click New. A default set of exclusions is listed.
3. 4. 5.
Make edits to the open exclusions file. Save the file by selecting Save on the File menu. If you were creating a custom exclusions file, specify a name and location for this exclusions file and click Save.
58
ADS-1000-TG00
Task:
To display the Global Exclusions Editor icon in the Tools panel: 1. 2. Open the AdminStudio Tools tab. Right-click in the Tools panel and select Add Tool from the context menu. The Welcome panel of the Add Tool Wizard opens.
ADS-1000-TG00
59
3.
4.
5. 6.
In the Name in Tools Gallery field, type Exclusions Editor. Leave the Command Line Argument, Working Directory, Comments, and HTML Explanation File fields empty and click Next. The Command-Line Configurations panel opens.
60
ADS-1000-TG00
7.
Click Finish. The Exclusions Editor icon is now displayed in the Tools Gallery.
Note When you open the Exclusions Editor by clicking its icon on the Tools tab, the Files tab of the Exclusions Editor opens without an exclusions file open. Follow the instructions in Opening the Exclusions Editor Outside of Repackager to open either the shared exclusions file or a custom exclusions file.
Summary
In this chapter, you have seen the basic steps to perform in order to prepare for the application-migration process. These steps include: Creating a project storage directory structure. Defining a standard image. Creating project documentation. Copying the Repackager directory to a shared network location.
In the next chapter, Creating Workflow Templates and Projects, you will learn about AdminStudio workflows, which are hierarchical checklists of application migration steps to perform.
ADS-1000-TG00
61
62
ADS-1000-TG00