home *** CD-ROM | disk | FTP | other *** search
This is a demo version of Software Installer for OS/2. You will be able to perform all of the steps to create a diskette/CD-ROM installation for your product, except it will be a non-working installation. This demo version has the following functions disabled: -- Installing of files -- Running of exits -- Modifying a CONFIG.SYS -- Installing from a host Additionally, a catalog file name must end in ".ICF", and a package file name must end in ".PKG". To get more information (including distributors), call 800-IBM-CARY or 919-469-7061 (outside the U.S.). Direct technical questions to: -- CompuServe: GO OS2DF2 (section 8) -- OS/2 BBS on IBM Talklink: INSTALL2 FORUM Press the Continue button below to start the installation or the Exit button on the right to exit. GETTING STARTED WITH SOFTWARE INSTALLER V1.2.1b FOR OS/2 ________________________________________________________ DOCUMENTATION __________________________________________ o READ.ME This text file describes features of Software Installer and requirements for using. There are also instructions for installing Software Installer on your workstation. o Software Installer Reference This program item in the Software Installer group is a hypertexted, online document that describes in detail how to enable your products for installation. After installing Software Installer as described in this READ.ME, open the Software Installer Reference and select the Step-by-Step Instructions for Using Software Installer section in the Using Software Installer chapter. o EPFIPGR.EPS This binary file is an encapsulated PostScript(**) formatted file of the online Software Installer Reference. You can print a hardcopy version of the reference by sending this file to a printer compatible with the PostScript driver used in formatting it. Because this file is formatted from the same source containing the online control fields, you will see some extraneous superscripts. INTRODUCING SOFTWARE INSTALLER FOR OS/2 _______________________________________ Software Installer, Version 1.2.1b, for OS/2(*) is a programming tool that helps you automate the installation process for applications you develop. You can use Software Installer to provide your users with an easy and consistent way to install and maintain workstation applications you develop for the OS/2 environment. Software Installer provides services for installing, updating, restoring, and deleting the workstation parts of products that you distribute on diskette or initially install from a host system. With Software Installer you can install software on an individual workstation, a LAN connected to the workstation, or a combination of both. You can create a standard installation procedure that runs on multiple workstations, without requiring input from your users. SUPPORTED DRIVE ENVIRONMENTS: Software Installer supports installation from the following drive environments: o CD-ROM o Diskette o Local Area Network (LAN) SUPPORTED HOST ENVIRONMENTS: Software Installer supports installation from the following host environments: o Multiple Virtual Storage (MVS) o Operating System/400(*) (OS/400 (*)) with IBM PC Support/400(*) o Virtual Machine (VM) o Virtual Storage Extended (VSE/ESA)(*) Version 1.3.0 MAJOR FUNCTIONS: o Provides CID enabled installations. o Provides multi-threaded execution. You can install one product while using another. o Compresses your product files using Software Installation utility or your own. o Decompresses compressed files during installation using Software Installer's utility or your own. o Maintenance functions include: - Updates an installed product for corrective service or the next release of a product - Restores a previous release of a product - Deletes a product from the user's workstation o Runs exits supplied by Software Installer during installation that can: - Set environment variables - Modify the user's CONFIG.SYS file - Add and delete information from the OS2.INI file or an application's own INI file - Create, register, deregister, and delete Workplace Shell(*) objects o Runs user-supplied exits. o Provides non-interactive installation of a product. o Allows the user to selectively install components of a multiple-component product. o Allows up to 20 directories for installation destinations. o Provides for the following tailoring of the initial installation screen: - Display up to 100 bitmaps - Animate the bitmaps - Display an optional information window that is useful for displaying a READ.ME file o Replaces product files that are in use. o Installs from diskette without installing Software Installer. o Provides a utility for renaming Software Installer files that you redistribute with your product. o Provides a utility for creating diskettes for your distribution. o Provides context sensitive, tailorable help. OPERATING ENVIRONMENT _____________________ MACHINE REQUIREMENTS o A personal computer running OS/2 Version 2.0 or 2.1. NOTE: For more information on the OS/2 Version 2.0 machine requirements, refer to the IBM OS/2 Version 2.0 Information and Planning Guide (G326-0160). o 2 MB of hard disk space above that required by OS/2. o .5 MB of memory above that required by OS/2. o 2-button mouse or other pointing device. PROGRAM REQUIREMENTS o IBM Operating System/2(*) (OS/2) Version 2.0 or 2.1 operating system. ServicePak XR06055 is recommended. NOTE: Without the ServicePak, your installation will not return the appropriate results from user exits even though the exit completes correctly. Also, Workplace Shell objects created during an installation will not use the specified icon. o IBM Developer's Toolkit for OS/2 Version 2.0. NOTES: 1. If the resource compiler (RC.EXE) is shipped with your version of OS/2, then the Developer's Toolkit for OS/2 is only required if you are changing the on-line help (see below); you can then disregard any notices about requiring the Developer's Toolkit for OS/2 during the rename process (ISREN.CMD). 2. Your end users do not need to have the Developer's Toolkit for OS/2 their systems to install your products. o To install from an AS/400 host system, you need IBM PC Support/400 (Program Number 5738-PC1) Version 2 Release 2. o To install from a VM, MVS, or VSE host system, you need IBM Extended Services for OS/2 2.0 with Communications Manager installed. GETTING SERVICE FOR SOFTWARE INSTALLER ______________________________________ GETTING HELP We are ready to help you with your Software Installer questions. You can contact us through one of the following: o IBM OS/2 BBS TALKLINK: INSTALL2 CFORUM For information about Talklink registration and access, call 1-800-547-1283. (Note: For IBM internal customers, this is INSTALL2 CFORUM on IBMPC.) o COMPUSERVE: GO OS2DF2 (Section 8, Installer & DA/2) For information about CompuServe registration and access, call 1-800-848-8199 rep. #239. o FAX: (919) 469-7423 SUBMITTING PRODUCT DEFECT REPORTS If you believe you have found a product defect, call our IBM Central Service 24 hours a day, 7 days a week, at 1-800-237-5511. Please have your customer number ready; if you do not have a customer number use 1111112. Identify yourself as a Software Installer for OS/2 (alias "SI") user. The Software Installer Support Group responds on a call-back basis Monday through Friday, normal work days only, between the hours of 8:00 a.m. and 5:00 p.m. (Eastern time). Outside the United States or Puerto Rico, fax a problem report to 1-919-469-6994. Please write in English and fax a printed copy of the softcopy problem report form provided with the product. INSTALLING SOFTWARE INSTALLER _____________________________ This section contains information that you will need to: o Install Software Installer from a diskette drive o Set up Software Installer for installation from a LAN server o Run Software Installer from a LAN o Access the online documentation INSTALLING SOFTWARE INSTALLER FROM A DISKETTE DRIVE To install Software Installer from a diskette drive: 1. Insert the first disk into a diskette drive (in this example the A drive is used). 2. Type the following on the OS/2 command line: A:\INSTALL 3. Press Enter. 4. Follow the on-screen prompts. SETTING UP FOR INSTALLATION FROM A LAN SERVER If you have purchased multiple licenses of Software Installer, you might want to consider placing it on a LAN server for easier access. To do this, perform the following steps: 1. Create a directory on the LAN server to store the Software Installer files. For example: mkdir J:\INSTALL2 2. Copy each Software Installer diskette into this directory. You can do this using the OS/2 XCOPY command. For example: xcopy a:* J:\INSTALL2 /S 3. Repeat step 2 for each diskette. 4. Give all licensed users access to the LAN drive you copied the diskettes to (in this example, the J drive). After performing these steps, users with access to the LAN drive can access the alias drive\directory and install Software Installer by typing: INSTALL Your LAN users are now ready to use Software Installer. RUNNING SOFTWARE INSTALLER FROM A LOCAL AREA NETWORK If the Software Installer is installed on a LAN drive that you have read access to, you do not have to install Software Installer on your workstation. If you prefer, you can run it from the LAN. To do this: 1. Ask your LAN administrator to give you access to the LAN drive/directory. Also, ask for the LAN drive\directory's alias. 2. Access the alias drive\directory. 3. Type the following on the OS/2 command line: EPFIDLDS You are now ready to use Software Installer. NOTE: If errors occur with multiple users, the LAN administrator can increase the server resources such as MAXOPENS, MAXSESSOPENS, and MAXSHARES. ACCESSING THE ONLINE DOCUMENTATION When you install the Software Installer, you can have the online Software Installer Reference document automatically installed by selecting the ONLINE DOCUMENTATION component from the Install-directories window. You can access the document from either the Workplace Shell or from the OS/2 command line. To access the Software Installer Reference from the Workplace Shell, double-click on the Software Installer Reference object in the Software Installer folder. To access the Software Installer Reference from the OS/2 command line, do the following: 1. Change to the directory where the online Software Installer Reference is installed. The default directory name used is C:\IBB\BOOK. 2. Type the following on the OS/2 command line: VIEW EPFIPGR.INF 3. Press Enter. You will see the Contents window. 4. Double-click on the topic you want to view. A good place to start is the USING SOFTWARE INSTALLER topic. CHANGING THE ONLINE HELP (EPFIHPLB.HLP) The source file for the the online help is provided so that you can customize it for your product's users. EPFIHPLB.HLP is the online help that can be viewed on the workstation while using Software Installer. The source help file for Software Installer is EPFIHLIB.ITL. This file is also in the C:\IBB\BOOK\SOURCE subdirectory. You can change the text in this file. After changing the text, you must recompile this ITL file to obtain the HLP file. The compiler, IPFC.EXE, is part of the Developer's Toolkit for OS/2. Follow these steps to change the online help: 1. Modify EPFIHLIB.ITL using your favorite editor. NOTE: DO NOT change the resource IDs (res=nnnn) that identify the help panels. These resource IDs associate the help panels with the product's source code. DO NOT add or delete help panels or their resource IDs. 2. Run IPFC.EXE on EPFIHLIB.ITL. IPFC EPFIHLIB.ITL >EPFIHLIB.ERR 3. Check the compile messages and statistics in EPFIHLIB.ERR. 4. If you have errors in the EPFIHLIB.ERR, make corrections to EPFIHLIB.ITL and repeat steps 1 and 2. 5. After compiling your revised EPFIHLIB.ITL to produce an EPFIHLIB.HLP file, rename EPFIHLIB.HLP to EPFIHPLB.HLP. 6. Place EPFIHPLB.HLP into the C:\IBB\BIN subdirectory. NOTE: Copying your new EPFIHPLB.HLP to the C:\IBB\BIN directory will overwrite the EPFIHPLB.HLP that was originally installed. You may want to make a backup copy of the original HLP file before copying your new version to the C:\IBB\BIN subdirectory. --------------- (*) Trademark of the IBM Corporation in the United States and other countries. (**) Trademark of Adobe Systems Incorporated. ---------------- Fixes for this PTF: 1. APAR PN43830 Diskette Generator now dynamically loads the HLLAPI DLL. 2. APAR PN43300 Correct the option string for binary transfers from VSE/ESA host to PC. 3. APAR PN45267 Monocase directories used in user exits. 4. APAR PN45265 Deferred processing .CMD (EPFIDEFI.CMD) now generated correctly. 5. APAR PN45405 Spaces in command line parameters now handled correctly. 6. PMR 5X420 Documentation corrected for what value is returned by the EPFISOURCE installation variable. 7. PMR 5X492 Diskette Generator now recognizes the ADDCONFIG, UPDATECONFIG, and OPTIONS entry types. 8. PMR 5X544 The step-by-step instructions corrected for host installation. 9. PMR 5X792 Documentation corrected for CD-ROM installation. 10. PMR 3X990 Selectable clear of host screen. 
