________________________________________________________________ IBM OS/2 Feature Install Version 1.2.2 Package README ________________________________________________________________ The IBM OS/2 Feature Install Version 1.2.2 package provides the latest version of Feature Install (FI) and the Netscape Navigator plug-ins used for IBM Software Choice feature installations. FEATURE INSTALL VERSION 1.2 ENHANCEMENTS ________________________________________ Improvements have been incorporated into Feature Install Version 1.2.2 to better support safe and reliable installations of new Software Choice features. Feature Install has also been enhanced to make it easier to identify installed features enabling IBM service personnel to support OS/2 systems after Software Choice features have been installed. Feature Install Version 1.2.2 updates include the following: o The dependency checking capabilities of Feature Install have been greatly improved. When a Software Choice feature is installed, Feature Install is able to accurately detect whether prerequisite system components, fixes, or other Software Choice features have been installed. The search logic in Feature Install is capable of resolving conflicts and ambiguities that might arise when more than one version of a system component that matches the dependencies of a Software Choice feature is found on the target system. o The Feature Install Inventory of installed features is now stored in an ASCII file that is readable and printable. This file is named FI.INI and is located in the os2\install directory on the system boot drive. Feature Install adds entries to the file when features are installed and deletes them when they are removed. The entries in this file appear in the order in which the features were installed. The new inventory file makes it easy to identify, control, and service the changes that Software Choice features make to an OS/2 system. The inventory is maintained as a read-only file and should not be modified without assistance from IBM service personnel. o The installation support has been enhanced in Feature Install Version 1.2.2 to enable Software Choice features to update previously installed system components when a feature is installed. Appropriate file version checks are made when a system module is installed with a Software Choice feature, which results in an installation that is safe and consistent with the service policy supported by other OS/2 maintenance tools. o The installation of "locked" system files are handled by a Feature Install locked-file device driver. This enhancement to locked-file support ensures that if a Software Choice feature includes a collection of system modules, they can be installed as a unit. They are either all installed or none are installed to prevent installation failures. o An "archive" version is kept of any system modules that are updated when Software Choice features are installed. The Feature Install Inventory and its backup and archive directories contain all the information and data required so that when a feature is removed, the system can be efficiently restored to the state it was in before the feature was installed. The information is structured so that Feature Install can restore the "archived" versions when Software Choice features are removed from the system. The support for the removal of features maintains system integrity even when Software Choice features that update system modules are removed in a different order than the order in which they were installed. o A new version of the Corrective Service Facility will be included with future FixPaks that will integrate Feature Install "archive" versions of system modules into the archive and backup databases that the Corrective Service Facility maintains whenever an OS/2 FixPak is installed. The new version of the corrective Service Facility will be enabled to read the Feature Install Inventory and warn the user when the backout of a FixPak might remove dependencies of one or more Software Choice features and affect their operation. REQUIREMENTS ____________ If you have installed a previous version of the FI Toolkit on your system, uninstall the Toolkit, delete any objects you might have created with the FI Toolkit, and shut down and restart your system before installing the Feature Install Version 1.2.2 package. Netscape Navigator for OS/2 is required to use Feature Install and to install IBM Software Choice features. If you do not have Navigator installed on your system and you are installing the FI package using the FIRUN_NS.ZIP file, Navigator will be installed automatically when you install Feature Install. Navigator is also available at http://www.internet.ibm.com/browsers/netscape/warp. DIRECTORY STRUCTURE ____________________ The recommended directory structure for features downloaded from the IBM Software Choice Web site is as follows: First create a top directory with any name you choose; for example, FEATURES. Create a subdirectory named FISETUP. The FISETUP subdirectory is where you should place the Feature Install package. Create a subdirectory for each feature you download to install. For example: \FEATURES ÃÄ\FISETUP ÃÄ\FEATURE1 ÀÄ\FEATURE2 . . . NOTE: Feature Install provides prerequisite checking. If the directory structure described above is maintained and the required files are not found on the client system, Feature Install will automatically update the system with the required files. If you do not use this directory structure and the required files are not found on the client system, the client will be prompted for the location of the files when installing an IBM Software Choice feature. INSTALLING THE FEATURE INSTALL PACKAGE ______________________________________ To install the Feature Install package, do the following: 1. Change to the subdirectory containing FIRUNPKG.ZIP or FIRUN_NS.ZIP, whichever Feature Install package you are using. (The Feature Install package should be located in the FISETUP subdirectory.) 2. Use PKUNZIP2.EXE (typically located in the \IBMCOM directory) to unzip the files. Type PKUNZIP2 FIRUNPKG or PKUNZIP2 -d FIRUN_NS depending on which package you are using. NOTE: Use the -d option if you are using the Navigator package (FIRUN_NS.ZIP). When the program finishes, you are ready to install the Feature Install package. 3. In the directory where you unzipped the Feature Install package, type FISETUP. FISETUP can be run with or without the parameters listed below. For a CID installation, specify any of the parameters. /L1: Drive, path, and file name of the log file. If you do not specify a log file, a default log file named FISETUP.LOG will be created in the root of your boot drive. /B: Drive letter of the boot drive (for example, C:) If a boot drive is not specified, it will be detected automatically. /S: Source path, including drive letter, where Feature Install and the FI plug-ins are located. The source path does not have to be specified if these files are located in the same directory as the FISETUP executable. /NN Do not install the FI plug-ins and do not check if Netscape Navigator for OS/2 is installed. /H or /? View the available parameters and their function. /U Update installation software even if the version is older than the existing version. Example: fisetup /S:C: /L1:C:\err.log /U /NN 4. When the program finishes, it might prompt you to reboot your system. If so, shut down and restart your system. KNOWN PROBLEMS ______________ Under very rare circumstances, Feature Install can hold "in-use" files indefinitely (it typically closes them when an installation or uninstallation completes). These files include x:\os2\install\fi.ini, x:\os2\install\fi.bak, x:\os2\install\wpinstal.log, x:\os2\install\current.log, x:\os2\install\ibmlanlk.lst, x:\config.sys, as well as any files that were updated by a particular installation or uninstallation. If you encounter this problem, reboot the system and the files will be unlocked automatically. (Or, on systems that are configured to allow it, quit and restart the Workplace Shell). Because this happens only in rare circumstances, you should have a technician inspect the system integrity. In particular, the last installation or uninstallation might not have completed correctly. TRADEMARKS ___________ The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM OS/2 Software Choice The following terms are trademarks of other companies: Netscape Netscape Communications Corporation Other company, product, and service names, which may be denoted by a double asterisk (**), may be trademarks or service marks of others. THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. (C) Copyright IBM Corporation 1997, All rights reserved.