INSTALLANYWHERE 8 EVALUATOR S GUIDE

Transcription

1 INSTALLANYWHERE 8 EVALUATOR S GUIDE

2 TABLE OF CONTENTS Introduction... 3 What is InstallAnywhere 8?... 3 What s New in InstallAnywhere 8?... 3 Getting Started... 5 System Requirements... 5 InstallAnywhere Concepts... 6 Obtaining InstallAnywhere Installing InstallAnywhere Using the Project Wizard Create a New Project Set Project Info Add Files Choose a Main Class Set a Classpath Build the Installer Try the Installer Test the Uninstaller Using the Advanced Designer Creating a Choice for Java Virtual Machine Choosing Custom Images Working with Collaboration Consuming a DIM in InstallAnywhere Authoring a DIM with InstallAnywhere Collaboration Summary Additional Resources Customer Feedback

3 Introduction INTRODUCTION This guide introduces evaluators and reviewers to key functionality of InstallAnywhere 8. First, we ll tell you what s new in this version of InstallAnywhere and describe some basic concepts; then we ll walk through the Project Wizard, where you ll build a complete installer in five minutes; next we'll touch on some advanced features where you ll customize your installer using the Advanced Designer; and finally we ll try out some key collaboration features from InstallAnywhere and InstallAnywhere Collaboration. NOTE: InstallAnywhere 8 is available in two editions: Enterprise and Standard. For a complete list of the features available in each edition, go to What is InstallAnywhere 8? InstallAnywhere is the solution of choice among multiplatform installation developers worldwide. It delivers the ideal combination of ease-of-use and powerful functionality for creating professional multiplatform installations in minutes. InstallAnywhere builds professional, multiplatform installers that install and configure software onto nearly every client or server platform, including Windows, Solaris, Linux, Mac OS X, HPUX, AIX, Tru64, FreeBSD, and more. InstallAnywhere was designed to install any kind of software desktop, enterprise, or multi-tiered Web services onto any platform, and to configure those applications for optimal performance. Whether creating applications written in Java, C++, PERL, or C#, or deploying EJB components or.net Web services, InstallAnywhere handles most common installation details automatically. Software innovators, like Adobe, Borland, HP, i2, IBM, Intel, Iona, Lucent, Nortel, and Sun, are just some of the software industry s leaders who depend upon InstallAnywhere for fast, powerful, and intuitive installers. In fact, all the top 25 software companies (as reported by Software Magazine) use InstallAnywhere for their multiplatform deployments. In addition to releasing InstallAnywhere 8, we are introducing InstallAnywhere Collaboration, the newest member of our Installation Collaboration family. InstallAnywhere Collaboration brings to Eclipse users application developers and installation developers the ability to collaborate throughout the development process. What s New in InstallAnywhere 8? InstallAnywhere continues to deliver the functionality developers need to build successful multiplatform installations. InstallAnywhere 8 comes with several new features and enhancements: Automatically Generate and Record Response Files InstallAnywhere 8 allows you to automatically generate response files used during silent installations. By default, these response files are recorded. Improved Accessibility InstallAnywhere 8 allows you to create Section 508 compliant installers with new accessibility improvements, including support for screen readers, high-contrast viewing, and mnemonics. 3

4 Introduction Enhanced Windows 64-bit Support InstallAnywhere 8 supports Windows 64-bit systems at runtime and allows you to target both the 64-bit and 32-bit portions of the operating system with a single installer build. Support for Collaboration InstallAnywhere 8 allows you to automate the capture and communication of installation requirements between application and installation developers with support for InstallAnywhere Collaboration. Ability to Customize Panel Size InstallAnywhere 8 includes new Installer Frame UI settings, which allow you to easily customize the size of your installer panels. FLEXnet Connect Integration InstallAnywhere 8 integrates with the FLEXnet Connect application (formerly "Update Service"), allowing you to initiate communication and notifications to your customers. You can also easily add and customize an action that automatically configures your customers' products to integrate with FLEXnet Connect and send update notifications to their customers. Support for Console Mode on Windows InstallAnywhere 8 supports using Console Mode on Windows operating systems. Display HTML Panel InstallAnywhere 8 includes a Display HTML Panel, which allows you to display HTML from an archived file or a specific URL on a panel during the installation. Enhanced Installer Return Codes In previous versions, the only error codes that were returned when the installation exited were 0 for a success, 1 for some but not all items installed, or -1 for failed. InstallAnywhere 8 returns many additional exit codes that provide more details about the reason for exiting the installer. Enhanced Progress Bar InstallAnywhere 8 allows you to reflect a more accurate installation progression on the progress bar by accounting for the progress of individual custom code actions. Service Layer Integration InstallAnywhere 8 contains a new services layer that adds a rich suite of APIs for use with custom code actions. 4

5 Getting Started GETTING STARTED System Requirements For Systems Running InstallAnywhere (Authoring Environment) 128 MB free RAM Minimum of 8-bit color depth (256 colors) Minimum 1024 x 768 resolution InstallAnywhere runs on the latest versions of these operating systems, fully updated with the most recent patches and service packs: Windows Server 2003, XP, 2000, NT Mac OS X, Mac OS X Server Solaris/SPARC Linux/Intel: Red Hat, SuSE HP-UX AIX 5.2 or higher NOTE: Language-localized versions of InstallAnywhere Enterprise Edition (for French, German and Japanese developers) are available on the Windows platform only. Installers can be built from any platform for any other platform, locale, or language. Localizations for 29 languages are included. For Target Systems (Installer Environment) 64 MB of free RAM Minimum of 8-bit color depth (256 colors) Minimum 640 X 480 screen resolution Installers run on any version of these operating systems, as long as the operating system supports Java: Windows Server XP, 2003 (Itanium 2, x86, AMD-64) Windows 2000, NT, Me, 98 Linux/Intel: Red Hat, Red Hat Enterprise Server, UnitedLinux, TurboLinux, SUSE & others Linux for PowerPC, AMD-64, and Itanium 2 Mac OS X (PPC & Intel) 5

6 Getting Started Solaris SPARC, AMD-64, Intel HP-UX (Itanium 2 & PA-RISC) Tru64, FreeBSD AIX z/os NetWare Other Unix platforms Supported Java Virtual Machines Sun: 1.3.x, 1.4.x, 1.5.x (Java 5) IBM: 1.3.x, 1.4.x, 1.5.x (Java 5) Apple: 1.3.x, 1.4.x, 1.5.x (Java 5) HP: 1.3.x, 1.4.x, 1.5.x (Java 5) The InstallAnywhere installer bundles Java 1.5 by default for all platforms. Any Java virtual machine can be bundled with an installer ensuring that the target system meets the minimum requirements for both the installers and your applications. To download these bundled VM packs, see InstallAnywhere Downloads. NOTE: InstallAnywhere installers are not supported on beta or on early access releases of Java. InstallAnywhere Concepts For many users, learning how to use InstallAnywhere is aided by an understanding of its conceptual framework. InstallAnywhere Technology Before building your first installer, it is important to understand the fundamentals behind InstallAnywhere's multiplatform installer technology. The installer may be packaged in two ways: 1. Executable installers with a native wrapper may be invoked like any other native application, either by typing their name directly onto a command-line interface, or by double-clicking their icon in a GUI environment. If you are deploying a Java application, executable installers have the advantage of being able to create LaunchAnywhere executables, which make it possible to run installed Java applications in a similar fashion. InstallAnywhere supports executable installers on Windows 98/Me/NT/2000/XP for x86, Solaris, Linux, and Mac OS X. 2. The Java-enabled option may be used to deploy onto other platforms without executable support, including OS/2, MVS, NT for Alpha, and VMS. The Java-enabled installer, rather than being a native executable, is a.jar file. Although it can run on any Java-enabled platform, Pure Java installations must be run using the traditional invocation mechanisms of the target platform. Typically this means that the deployment needs to be executed from the command line. 6

7 Getting Started In general, build executable installers for as many platforms as you are targeting. You have the option of bundling a VM with the installer, ensuring its availability for installation and application use. The bundled VM will be the VM that is used by the installer and the installed product. Alternatively, executable installers will attempt to find a suitable Virtual Machine automatically to use on the target computer. For more information on downloading VM packs to bundle with your installer, please see the Virtual Machine section. InstallAnywhere runs in two modes: the Project Wizard and the Advanced Designer. The Project Wizard creates simple, straightforward installers in minutes. In many situations, you may need to build installers that execute custom code, display license agreements, or deploy to multiple locations on the target system. Use the Advanced Designer for these purposes, as it provides greater control and flexibility in installer design. The InstallAnywhere Environment You can combine the two modes by building a simple installer in the Project Wizard and switch to the Advanced Designer in order to add custom features. By default, InstallAnywhere starts up in Project Wizard mode, but can be configured to start in the Advanced Designer. To configure InstallAnywhere to start in Advanced Designer mode 1 Choose Edit > Preferences. 2 In the InstallAnywhere Preferences dialog, set InstallAnywhere Startup to Advanced Designer. 3 Click OK. Use the Advanced Designer if you need any of the following functionality: Install multiple Install Sets (Typical Install, Minimum Install, etc.). Install multiple Java applications. Create additional shortcuts, links, or aliases beyond the one that is created by default. Execute custom code during installation. Display custom graphics for the installer splash screen. Use special actions (Execute Command, Find File, Execute Target File, etc.). Actions Actions represent the operations the installer will perform. InstallAnywhere supports an extensible action architecture that provides the ability to perform additional operations during installation, such as Installing files and folders, creating shortcuts, executing custom code during the installation process, or extracting contents from a compressed file. The most frequently used actions are Install File and Create Folder, but there are many more actions, including Create Alias, Link, Shortcut, Execute Target File or Command, and Expand Archive. Rules InstallAnywhere uses variable based Boolean rules to control most aspects of installer behavior. Rules direct the execution of platform-specific actions on the target system. 7

8 Getting Started For example, you could choose to install files that don t currently exist on an end user s hard drive, edit the Windows 98 Win32 Registry while bypassing the Windows 2000 registry, or include the addition of a license agreement and product information in Italian for users who designate Italian as their installation language. InstallAnywhere further expands the flexibility and control of your installer with the addition of rules and comparisons based upon regular expressions. Rules are accessible under the Project > Rules subtask, or in the Rules customizer for each action within the Pre-Install, Install, and Post-Install tasks. Silent and Console Mode Silent mode, or running an installer without any user interaction, supports setting target and shortcut directories and Features/Install Sets via either command-line arguments or a properties file. Console mode, available for Windows, UNIX, Linux and Mac OS X* platforms, duplicates the default GUI steps provided by InstallAnywhere and uses Standard input and output. *Console mode, on Mac OS X, requires use of a UNIX installer. LaunchAnywhere A LaunchAnywhere executable, Macrovision's Java application launcher technology, is a unique executable that is used to launch a Java application on Windows 98/Me/NT/2000/XP, Windows Server 2003, UNIX (including Solaris, Linux, HP-UX, AIX, BSD, and others), and Mac OS X platforms. LaunchAnywhere technology creates double-clickable icons on Windows and on UNIX platforms that invoke a Java application, as well as Mac OS X application bundles. On UNIX platforms without a desktop environment, end users type a simple command to launch the application. LaunchAnywhere technology sets the classpath, redirects standard out and standard error, passes in system properties and command-line parameters, and performs many other environment configuration functions. InstallAnywhere's API With InstallAnywhere s Application Programming Interface (API), software producers can write custom Java code that runs in the same Java VM as InstallAnywhere, creating custom actions and end-user panels that interact with and extend InstallAnywhere functionality. There are three major classes of custom code: Custom Code Actions that run within InstallAnywhere's action framework, alongside default InstallAnywhere actions. They may be invoked at both install and uninstall time. Custom Code Panels that run within InstallAnywhere's GUI during installation. Developers may use this mechanism to add custom panels to the Installer. Custom Code Console Actions that run within InstallAnywhere s console interface during installation. Developers may use this to add custom console elements to the Installer. Custom Code Rules are evaluated when the action they are associated with is about to be executed. Rules return a Boolean value that determines if the action will run. Localizing Installers InstallAnywhere builds installers in up to 29 different languages. If you want to generate installers for a subset of the languages included in InstallAnywhere, go to the Advanced Designer, select the Project > Locales subtask, and use the check boxes to select the desired languages. 8

9 Getting Started NOTE: The default Java VMs distributed with InstallAnywhere only support languages in the Western Language Group. In order to support the Eastern Language Group, you will need to bundle the installer with an international Java VM. Additional Java VMs, including international Java VMs, can be downloaded via or by using the Download Additional VM Packs button in the Build task of the Advanced Designer. Be sure to exit and relaunch InstallAnywhere to make any newly downloaded Java VMs available for building. InstallAnywhere Variables InstallAnywhere keeps track of dynamic values through the use of variables. Almost every dynamic value in InstallAnywhere is represented by an InstallAnywhere variable. Variables may be modified or accessed in order to affect the design or output of an installer; they can also be modified during the progress of the installer in order to change the installer's behavior. SpeedFolder SpeedFolders treat multiple items as a pointer to a particular directory (as opposed to a traditional folder, where every item inside of it is a separate action). Using a SpeedFolder dramatically increases installation speed and memory efficiency. Speedfolders always include whatever files are found inside of them when the installer is built. If files are added or removed between installer builds, the contents of the installer will reflect whatever is inside of the directory specified as a SpeedFolder. (Standard folders require you to add or remove any files that are present or absent since the last installer build, or an error will occur.) SpeedFolders work well in an automated build environment and have filters that allow inclusion or exclusion of files that meet particular naming criteria. You cannot designate individual files or folders inside of a SpeedFolder into different components. Nor is it possible to convert SpeedFolders to traditional folders and back again. (To do this, you must delete the folder of one type and replace it with the folder of another type.) You may not have multiple SpeedFolders with the same name. Install Sets Install Sets are groupings of features that make up entire installations, organized for a specific type of end user. For example, a Typical Install Set could include all of your files, and a Minimal Install Set could exclude any nonessential files, such as the Help files. Install Sets have nothing to do with any true file or folder organization, but serve to organize your installation into categories. Most installers have Typical and Minimal Install Sets. Sometimes installers have different Install Sets for each individual application inside the installer, such as My Word Processor and My Spreadsheet. You can create as many Install Sets as you would like, but you need at least one. A good starting point is to begin with the ones supplied by InstallAnywhere. Install Sets allow end users to choose which collection of features should get installed on their system. To make sure your end users can choose which Install Set gets installed, enable the Choose Install Sets panel action via the Pre-Install task in the Advanced Designer. Features Features are logical groupings of components. Feature designation arranges your components by function. Features may be hierarchical. You can create as many features as you wish, but every project needs at least one. Features are visible to the end user. Features are effective if you want to provide end users fine-grained choice in terms of what they install. For example, you might have a main application feature, a shared libraries feature, and a help feature. To make sure your end users can choose which feature gets installed, enable the Choose Install Sets panel action via the Pre-Install task in the Advanced Designer. To ensure that your end users can choose which features get uninstalled, enable the Feature Level Uninstall option in the Create Uninstaller action. The Oranization > Features subtask shows the features (functional groupings of files) in your installer. 9

10 Getting Started Components Components are groupings of files and actions, and are invisible to the end user. A component may be a group of files, registry changes, or other elements necessary for a feature to work correctly. Components are the smallest units of an installer. Advanced developers use components in complex installers to organize their resources into shared units, and to version their installation components. However, developers working with more simple installers can rely on InstallAnywhere to generate components automatically. All installers must have at least one component, and can have as many as needed. Components may belong to as many features as necessary but must belong to at least one. Although InstallAnywhere creates components automatically, it still provides the option of modifying them manually. InstallAnywhere Components subtask of the Organization task. The Components task displays the components in your installer. Components allow fine-grained control over which functionality gets installed. You could share common components between multiple installers, multiple versions of a product, or multiple products. For example, two products in a suite could have several shared components. Components may represent individual pieces of an application you want to check for in an installation. Additionally, components are versioned and each has a unique ID, so that you could search for a particular version of a component on a system to see if the latest version has been installed at a particular location. The InstallAnywhere uninstaller is also component-based, and can provide feature-level uninstallation functionality. 10

11 Getting Started Magic Folders A Magic Folder is a special location on a target computer, independent of the target operating system. InstallAnywhere can install to any Magic Folder or sub-directory of a Magic Folder. For example, "User Install Folder" ($USER_INSTALL_DIR$) resolves to the directory the end user selects as their desired installation directory when the installer is running. If a particular Magic Folder does not make sense on a target platform, actions that create files ("Install File" or "Create Alias, Link, Shortcut") will not install them. Actions that do not install files, such as "Execute Command," will run as they normally would. In the Properties section of each Install File and Create Folder action is a list where to select that item's destination, such as its Magic Folder. Obtaining InstallAnywhere 8 To download an evaluation copy of InstallAnywhere, go to Click the Download Now link for the InstallAnywhere edition you want to try, and follow the instructions to complete the download process. NOTE: InstallAnywhere is available in two editions: Enterprise and Standard. For a complete list of the features available in each edition, go to Installing InstallAnywhere 8 If you have already downloaded an installer for InstallAnywhere 8, run the installer and follow its on-screen instructions. If you have an InstallAnywhere 8 CD, place the CD into your CD-ROM drive. The CD Browser prompts you to install InstallAnywhere 8 and learn about other Macrovision products. 11

12 Using the Project Wizard USING THE PROJECT WIZARD The Project Wizard guides you through the process of creating an installer in a simple step-by-step manner. First, we'll need to start InstallAnywhere. On Windows, choose All Programs > Macrovision > InstallAnywhere 8 from the Windows Start menu. On UNIX platforms, cd to the directory where InstallAnywhere is installed and type sh. /InstallAnywhere. (Alternatively, you can invoke InstallAnywhere via the symbolic links created during the InstallAnywhere installation process.) On Mac OS X, click the InstallAnywhere icon in the Dock. InstallAnywhere 8 has two main modes: the Project Wizard and the Advanced Designer. In this section, we'll use the Project Wizard to build a basic installer. NOTE: To facilitate your evaluation, we have provided a set of sample files for your use in building an installer. These files are stored in the OfficeSuiteSourceFiles folder inside the InstallAnywhere folder. Create a New Project When InstallAnywhere starts, the first screen allows you to choose between creating a new project, opening an existing project, and quiting InstallAnywhere. 1 Click New Installer. This opens the Create New Project dialog box. 2 In the Create New Project dialog box, click Save As. The Save New Project As dialog box appears. By default the project is named My_Product, but you can assign any name you d like. 3 In the File Name text box, enter OfficeSuite and click Save. 4 In the Create New Project dialog box, click OK. The first time you run InstallAnywhere, it opens in Project Wizard mode. Set Project Info The Project Info step defines basic information about the installer, such as the product name (as displayed on the installer), the name of the installer to be produced, the name of the destination folder, and the application name. 1 Verify the information in the Project Info text boxes. Product Name: OfficeSuite Installer Name: install Install Folder Name: $PRODUCT_NAME$ Application Shortcut Name: OfficeSuite 12

13 Using the Project Wizard 2 Click Next to move to the next step in the Project Wizard. Project Info Step The values in the Product Name and Application Shortcut Name text boxes are derived from the project name. NOTE: The InstallAnywhere variable $PRODUCT_NAME$ used in the Install Folder Name text box is a way of dynamically linking the name of the installation folder to the name you provide for the product. Add Files Use Add files to add files and folders to your installation. 1 Click Add Files. The Add Files to Project dialog box appears. Browse to find the OfficeSuiteSourceFiles folder. (This folder is installed in the same folder as InstallAnywhere.) 2 Click Add All to add the ImagesAndDocs and OfficeSuite2000 folders. These files will appear in the Files to Add list. 3 Click Done. The files will appear in the File/Folder Hierarchy. 4 Click Next to move to the next step in the Project Wizard. 13

14 Using the Project Wizard Add Files Step Files from OfficeSuiteSourceFiles folder added to the project. NOTE: You can also drag and drop files directly into the installer to add files. Choose a Main Class Choose Main selects the starting class for the application. Here, you may also specify custom icons (in GIF format) for your LaunchAnywhere executable. To choose the main class 1 Click Automatically Find Main Classes. InstallAnywhere locates all main classes and adds them to the Choose Your Main Class list. 2 Select the main class. For OfficeSuite, there is only one main class. It is selected by default. Choose Main step com.acme.officesuite chosen automatically. 14

15 Using the Project Wizard To specify a custom icon for your LaunchAnywhere executable 1 Click Change. The Change button opens the Choose Icon dialog box. 2 Click Choose GIF File for the 32x32 pixel icon. The GIF files for the OfficeSuite application icons are in the ImagesAndDocs folder of the OfficeSuiteSourceFiles folder. 3 Navigate to the Image and Docs folder and choose OfficeIcon.gif. 4 Click Open to confirm and then click OK to close the Choose Icon dialog box. Choose Main step LaunchAnywhere with a custom icon for OfficeSuite. Click Next to move to the next step in the Project Wizard. NOTE: If you are not installing a Java application, skip ahead by clicking Next without specifying a main class. When the Choose a Main Class dialog box appears, click No to move to the next step. Set a Classpath Set Classpath configures a Java application classpath automatically. 1 Click Automatically Set Classpath. InstallAnywhere calculates which files need to be added to the classpath. A small CP icon appears at the bottom of those folders. 2 Click Next to move to the next step in the Project Wizard. Set Classpath step The classpath for OfficeSuite is set automatically. 15

16 Using the Project Wizard Build the Installer The platforms listed on the Build Installer step Mac OS X, Windows, AIX, HP-UX, Linux, Solaris, and Unix (all) represent installers that are double-clickable on their respective platforms. The final option, Other Java-Enabled Platforms, is a "pure" Java installer that can be invoked on any Java-enabled platform. You may also choose to build installers with an embedded Virtual Machine. Installers built without bundled VMs are smaller and download faster than installers that include a VM. The InstallAnywhere Web Install process allows end users to choose the appropriate installer for their system. To build installers for your project 1 Click the Without VM or With VM check box for the platform that matches your authoring platform plus any additional platforms for which you want to build installers. 2 Click Build. By default, InstallAnywhere places the OfficeSuite_Build_Output folder in the same location as your project file. Try the Installer Now that you've built an installer, test it by clicking Try It. TIP: Try holding down the Control key [CTRL] while your installer launches to see the debug output (Windows only). Try Installer step This step starts when the installer build is complete. 16

17 Using the Project Wizard After your installer deploys the sample application, you can verify it was properly installed by running OfficeSuite: On Windows, go to the OfficeSuiteForJava program group and choose OfficeSuite. On UNIX, cd to the directory where you installed the program and type OfficeSuite. On Mac OS X, double-click the OfficeSuite icon. Quit OfficeSuite for Java by choosing Exit from its File menu. Test the Uninstaller As a final step, ensure that the OfficeSuite uninstaller was properly deployed and works to remove the application from the target system. To test the uninstaller 1 Navigate the OfficeSuite installation folder. The OfficeSuite installation folder contains uninstallers for OfficeSuite. 2 Run Uninstall OfficeSuite. 3 Verify that OfficeSuite has been removed from your system. For further testing, you may post the installer directory to a Web server and install the software onto other platforms as well. 17

18 Using the Advanced Designer USING THE ADVANCED DESIGNER Use the Advanced Designer to assign files to different Install Sets, install multiple LaunchAnywhere executables, add custom panels to the installer, customize the installer's look and feel, and set rules to selectively install files to specific platforms. The InstallAnywhere Advanced Designer breaks down the installer creation process into discrete tasks. These tasks are listed on the left side of the screen. The Advanced Designer Installation authoring is divided into tasks and subtasks. You can enter the Advanced Designer mode from the Project Wizard process by clicking the Advanced Designer button at any point of the installer creation process. Many developers use the Project Wizard to create a basic installer and then switch to the Advanced Designer in order to customize their installer with more advanced functionality. To customize a previously built installer 1 Start InstallAnywhere and click Open Existing. 2 Locate the OfficeSuite project file, OfficeSuite.iap_xml, and click Open. 3 Click Advanced Designer to enter the Advanced Designer mode. 18

19 Using the Advanced Designer NOTE: The tasks of the Advanced Designer may be accessed in any order. Creating a Choice for Java Virtual Machine With InstallAnywhere, the end user can map the installer to a specific Java VM already located on their system. When this feature is activated, the end user can select from a list of Java VMs on their system, and choose the appropriate one. InstallAnywhere provides end users with the option of installing a Java VM if there isn t one present on their machine, or to search their computer for a compatible one. To create a choice for a Java VM 1 Select the Pre-Install task in the Advanced Designer. 2 Click Add Action. The Choose an Action dialog box appears. 3 Select the Panels tab. 4 Select Panel: Choose Java VM and click Add. The action appears in the Pre-Install Action list. 5 Click Close to hide the Choose an Action dialog box. The Choose an Action dialog Adding the Choose Java VM panel. 19

20 Using the Advanced Designer TIP: You can download additional Java VMs from Macrovision at Choosing Custom Images Some common activities in the Advanced Designer focus on customizing the images rendered during installation. Adding a Billboard Billboards are graphic images displayed during an installation, frequently used to advertise product features or complementary products. To add a billboard 1 Select the Installer UI > Billboards subtask. 2 Click Add Billboard. 3 Find the graphic called billboard1.gif located in the OfficeSuiteSourceFiles/ImagesAndDocs folder. Select this file and click Open. The Billboards subtask There is no practical limit to the number of billboards in an installation. 4 Click Preview to view the new image. This is the image that will be displayed during installation. Repeat this procedure, using billboard2.gif image in the same folder. To add more billboards, simply repeat steps 2 and 3 for each additional image. Setting a Custom Graphic for the Splash Screen The splash screen is displayed while the installer loads; it also is displayed on the HTML page of the Web installation. To set a custom graphic for the splash screen 1 Select the Installer UI > Look & Feel subtask. 2 Click the General UI Settings tab. NOTE: Click Preview on the Startup Splash Screen Image section to view the default splash screen of the installer. 3 In the Startup Splash Screen Image section, click Choose. 20

21 Using the Advanced Designer 4 Choose OfficeSplash.jpg in the OfficeSuiteSourceFiles/ImagesAndDocs folder. 5 Click Preview to confirm that the graphic has changed to the selected image. Installer UI subtask, General UI Settings tab A preview of the custom splash screen. Choosing a Specific Panel Image You can include customized graphics on each panel. To choose a specific panel image 1 Choose the Pre-Install task. 2 Select a panel action. 3 Choose Image Settings from the panel's Properties customizer. TIP: If the Image Settings tab is inactive, you can activate it by quickly selecting the Installer Panel Additions tab of the Installer IU > Look & Feel subtask. In the Type of Additions to Installer Panels section, choose Images. 21

22 Using the Advanced Designer Pre-Install task Display Message panel image settings 4 Select Specify an image (170 x 305). 5 Click Choose Image. 6 Select OfficePanel.jpg in the OfficeSuiteSourceFiles/ImageAndDocs folder and click Open. 7 Click Preview to view. 22

23 Working with Collaboration WORKING WITH COLLABORATION InstallAnywhere Collaboration is included with InstallAnywhere 8 Enterprise Edition. NOTE: Even if you are not an InstallAnywhere 8 Enterprise Edition user, you can download an evaluation version of InstallAnywhere Collaboration from InstallAnywhere Collaboration supports software development teams by enabling software application developers to collaborate with release engineers on the design, development, and deployment of their software subsystems. InstallAnywhere Collaboration is a standalone product that plugs in to Eclipse. Application developers can use InstallAnywhere Collaboration to capture installation requirements and store them in a Developer Installation Manifest (DIM) file. DIMs are named with the.dim extension and are structured in XML. Each.dim file describes the installation requirements for one subsystem of the entire software product. Because the DIMs are authored by the software developers who design the subsystems and know all of their installation requirements, they ensure that those requirements are included in the.dim file. Any DIM file whether authored with InstallAnywhere Collaboration or InstallShield Collaboration, in Eclipse or.net can be referenced by any InstallShield 11.5, InstallShield 12 or InstallAnywhere 8 project. Consuming a DIM in InstallAnywhere InstallAnywhere supports the addition and removal of DIM references. The contents of any DIM you reference in your InstallAnywhere project are included with the installers you build with that project. Adding a DIM Reference You can add DIM references to your InstallAnywhere projects on either the Install task or the Organization > DIM References subtask. To add a DIM reference in the Install task 1 Select the Install task. 2 Click Add Action. The Add Action button opens the Choose an Action dialog box. 3 In the Choose an Action dialog box, select Create DIM Reference and click Add. 23

24 Working with Collaboration Choose an Action dialog box Adding a Create DIM Reference action. 4 In the DIM Reference customizer, click Choose DIM Reference. This button opens the Add DIM Reference to Project dialog box. 5 Navigate to a DIM file. NOTE: If you installed InstallAnywhere Collaboration, you can find a valid DIM file by opening to your Eclipse directory and navigating to [Eclipse Directory]\plugins\com.installshield.collaboration.dimplugin_<version>\tutorial\OfficeSuite.dim. 6 Select a valid DIM file and click Open. Notice how InstallAnywhere fills in the DIM Reference customizer with information from the DIM file. The contents of DIMs referenced by your project are included in the installers when you build your project. Removing a DIM Reference Any DIM reference you add to your InstallAnywhere project can be removed from either the Install task or the Organization > DIM References subtask. To remove a DIM reference from the Organization > DIM References subtask 1 Click Organization > DIM References. 2 Click Remove. The Remove button removes the DIM reference from the DIM Reference List. NOTE: You can manage DIM references from either the Install task or the Organization > DIM References subtask. All changes to DIM references are mirrored in both locations. 24

25 Working with Collaboration Authoring a DIM with InstallAnywhere Collaboration DIM authoring requires Eclipse and InstallAnywhere Collaboration. Before you begin this exercise, you must first open Eclipse and activate the InstallAnywhere Collaboration perspective. In this exercise, we are going to create the OfficeSuite DIM from the OfficeSuite source files in four steps: Step 1 Create a New Project. Step 2 Specify Meta Information. Step 3 Add Contents. Step 4 Build and Run a Unit Test. Create a New Project 1 On the File menu, click New > InstallAnywhere Collaboration Project. The InstallAnywhere Collaboration Project Wizard opens. 2 In the first panel of the wizard, specify the project name and location: In the Project name text box, type DIM Tutorial as the name of this project. Click Next. The Add basic information about your project panel opens. 3 Type the following basic information about your project: Name: Type OfficeSuite. This is the name of the DIM that will be included in this project. It will contain the specification of the application to be installed, and its file name will be "OfficeSuite.dim". Description: Type Office Suite simulates a word processor. Author: Type your name. Company: Type Macrovision (or your company's name). Comments: Type any comments that you would like to be included with this DIM. They will be seen only by other software developers who open this.dim file with InstallAnywhere Collaboration. 4 Click Finish. The new DIM project opens. Take a moment to examine the following InstallAnywhere Collaboration perspective features: The Navigator view contains the project name you specified as the folder. Under that folder is a list of its files, including the.project file. The OfficeSuite.dim file is highlighted. The Navigator view showing the new project and DIM file. The General page opens in the DIM editor. This is where the general information specified in the New Project wizard is displayed and available for further editing. You will also be able to specify the meta information in this page. 25

26 Working with Collaboration If the.dim file is selected in the Navigator view, the Properties window contains its basic properties. These properties were set by Eclipse when you created the DIM, and they are display-only. The Properties window Properties of the DIM file. Specify Meta Information Now you will specify the meta information or "metadata", which are a set of properties about the DIM provided to the installation author. While the first section of the General tab displays DIM information, such as Name and UUID, that you specified in the InstallAnywhere Collaboration Project Wizard the second section displays the meta information. Meta information properties. 1 Set the Tag Value and Description properties for the Prerequisites tag name as follows: Click the blank area under Tag Value and type Java. Click the default text for the Description and change it to This DIM needs Java to run on the target machine. 2 Select the ReadMe tag name and then click Delete. You should now only see the Prerequisites tag. The next step is to add content to the DIM. Add Contents Now you will reference the files that this DIM installs when it is consumed by an installation project. 1 In the DIM editor, click the Contents tab. The left panel of the Contents tab lists the element types you can add. The right panel initially shows a detailed description of the currently selected element type. 2 On the Contents tab, right-click File System and click Add File Set. A file set is added with a default name New File Set. 26

27 Working with Collaboration Contents tab showing the new file set. 3 Right-click New File Set and click Rename. Rename this file set Images. You do not need to change any of the values of the properties of this file set. 4 Add a file to this file set: Click Add then Add File. A Select file(s) dialog box opens. Browse to the plugins/com.installshield.collaboration.dimplugin_<version>/tutorial/office-suite/images directory in the Eclipse distribution. Select all image files under this directory and click Open. The image files are added to the Images file set, and its properties appear in the Properties view with default values. TIP: You can also drag and drop the image files directly into the Eclipse interface from your file management utility. 5 On the Properties view, set the Target Location property of the Images file set to $[INSTALLDIR]/images. You are setting this property so that all the image files in this file set are installed under a directory named images. 6 Add another File Set to the File System group and rename it Classes. (See Steps 2 and 3 for instructions.) 7 This file set references the classes directory, which contains all the.class files that are part of the OfficeSuite application. Therefore, you need to add a Dynamic File Source to this file set: Click Add then Add Dynamic File Source. A Browse For Folder dialog box opens. Browse to the plugins/com.installshield.collaboration.dimplugin_<version>/tutorial/office-suite directory in the Eclipse distribution. Select the classes directory under this directory and click OK. The contents of this directory are added to the Classes file set, and its properties appear in the Properties window with default values. You do not need to change the values of the properties. Build and Run a Unit Test It is strongly recommended that you build and run a unit test of your project to ensure that your DIM files can be successfully consumed by a product installation project and ultimately installed on the target machine. 27

28 Working with Collaboration 1 Build the project. In the Navigator view, right-click OfficeSuite.dim in the DIM Tutorial project and click Build Unit Test. All of the DIMs in the project are built. The progress of the build appears in the Unit Test Console window. You will know that the build has completed when a message similar to the following appears: Total build time: X s, XXX ms Build successful 2 Run it. In the Navigator view, right-click OfficeSuite.dim in the DIM Tutorial project and select Run Unit Test. Running the OfficeSuite.dim unit test installs OfficeSuite. The installer produces the following panels: Notice advises that the installation was created with InstallAnywhere Collaboration: Introduction describes the DIMs that are being installed and the date that they were last updated. Choose Install Folder provides you with the option of changing the default installation location of the unit test. NOTE: The numbers after the underscore are generated by InstallAnywhere Collaboration, and they are different for each build of the unit test. This is to ensure that subsequent installations of rebuilt unit tests do not overwrite previous ones. Pre-installation Summary provides a summary of what will be installed. Install Complete confirms that the installation of the unit test was successful. 3 Run OfficeSuite. From the command-line, go to the directory where Office Suite has been installed and type java -cp.;images com.acme.officesuite The OfficeSuite splash screen Now you are ready to send your DIM file (and your application's source files) to the installation author so that they can be consumed by an installation project. 28

29 Summary SUMMARY InstallAnywhere 8 is the most powerful multiplatform software deployment solution available. It deploys any application to any platform. InstallAnywhere 8 combines amazing control and performance with an easy to use graphic interface. With InstallAnywhere, developers can create software installers that install perfectly every time, lowering development and support costs. For further information regarding evaluating and using InstallAnywhere 8, please see the additional resources listed below. Additional Resources There are several resources available to better familiarize yourself with InstallAnywhere 8. InstallAnywhere 8 Help Library The Help Library contains a plethora of information on InstallAnywhere 8 and is easily accessible from the Help menu in InstallAnywhere 8. The InstallAnywhere 8 Help Library is also available online. InstallAnywhere 8 Tutorials Tutorials to help you become more familiar with the InstallAnywhere 8 interface, and show you how to design your installation for globalization, are available from the InstallAnywhere 8 Help Library's DIM Tutorial topic. Knowledge Base For answers to many commonly asked questions and new information about InstallAnywhere 8, visit the Knowledge Base at InstallAnywhere Online Communities The free online InstallAnywhere community allows you to learn from other installation developers at Support A constantly updated support portal filled with answers, news, tips, and other resources for InstallAnywhere 8 users is available at Webinars Macrovision experts walk you through new features and capabilities available in InstallAnywhere 8. Webinars can be found at Downloads Obtain the latest merge modules, technology objects, white papers, product datasheets, project samples, and more from InstallAnywhere Collaboration Learn about Macrovision's newest addition to the Installation Collaboration family at Customer Feedback We invite you to test both our vision and our execution with this release. The Macrovision vision centers on meeting your needs. If there is anything we can do better, or if you need assistance, please do not hesitate to contact us at 29

30 Summary Macrovision Corporation 2830 De La Crux Boulevard, Santa Clara, CA Americas, Asia, Pacific Europe, Middle East, Africa +44 (0) Copyright 2006 Macrovision Corporation and/or Macrovision Europe Ltd. All Rights Reserved. Macrovision, InstallAnywhere, LaunchAnywhere, SpeedFolder, FLEXnet, FLEXnet Connect, and InstallShield are registered trademarks or trademarks of Macrovision Corporation in the United States of America and/or other countries. All other brand and product names mentioned herein are the trademarks and registered trademarks of their respective owners. 30