home *** CD-ROM | disk | FTP | other *** search
/ DOS Wares / doswares.zip / doswares / UTILS / TOOLS / PI45.ZIP / MANUAL.DOC < prev    next >
Encoding:
Text File  |  1992-04-16  |  56.6 KB  |  1,280 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                      Program Installer Professional
  16.                              Version 4.5
  17.                         Official Release (04/92)
  18.  
  19.                      Copyright (C) 1990, 1991, 1992
  20.                           The DataWorks, Inc.
  21.                          2115 University Blvd.
  22.                              P.O. Box 20962
  23.                        Tuscaloosa, Alabama 35401
  24.                              (205) 345-2848
  25.                       
  26.                       (800) 992-6698 (orders only)
  27.                       
  28.                           (205) 345-5655 (Fax)
  29.                      
  30.                      (205) 507-0015 (BBS, HST 14.4)
  31.  
  32.  
  33.                               User's Manual
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                              Disclaimer
  57.  
  58.  
  59.      The DataWorks, Inc. makes no warranties or claims to the fitness of this
  60. program. The user of this program, makes use of this program accepting any
  61. and/or all responsibilities for the actions of this program.
  62.  
  63.      Though we at DataWorks have taken every measure possible to insure that
  64. the program will/does function properly and will not cause any loss or
  65. contamination to your data, we cannot accept responsibility for unexpected
  66. bugs or other problems with the program that could result in the loss of or
  67. contamination of your data.
  68.  
  69.      If you do experience problems (bugs!) with the program, we would like to
  70. know, and ask that you contact DataWorks directly, or through our support BBS.
  71.  
  72.  
  73.  
  74.                               Acknowledgements
  75.  
  76.      Special thanks to Bob Ainsbury (TechnoJock Software) for the best online
  77.      phone support ever.
  78.  
  79.      Kim Kokkenen, President of and Developer for TurboPower Software, for
  80.      a fine selection of toolkits and great technical support.
  81.  
  82.      Borland International for a superior product and great support staff.
  83.  
  84.      Barry Weck, co-developer of Program Installer.
  85.  
  86.      The staff at DataWorks, Inc. for putting up with us programmers!<G>
  87.  
  88.  
  89.  
  90.      ■ Borland is a registered trademark of Borland International
  91.      ■ Turbo Pascal is a registered trademark of Borland International
  92.      ■ Async Professional is a registered trademark of
  93.        TurboPower Software
  94.      ■ TechnoJock's Turbo Toolkit is a registered trademark of
  95.        TechnoJock Software.
  96.      ■ PKZip/PKUnZip are registered trademarks of PKWare, Inc.
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.                               Introduction
  112.  
  113.      Program Installer is simply that - a program installer. It has been used
  114. by DataWorks, Inc. in some of our own third party applications as a generic
  115. installation utility.
  116.  
  117.      Program Installer is designed for programmers/ 3rd. party developers. You
  118. can use it to facilitate the installation of a program you have written for
  119. either a client or for some vertical market. Program Installer doesn't care
  120. about what you have written or whether or not you want the program(s) you have
  121. written installed into a particular directory on the client/customer's hard
  122. drive.
  123.  
  124.      Program Installer can read files from either the A: or B: floppy diskette
  125. drive, and allows the end-user to specify the hard drive letter (C: through Z:)
  126. and/or subdirectory(s) into which your programs should be copied. All you, as
  127. a programmer/distributor, need to do is follow the simple setup instructions of
  128. Program Installer, and then let Program Installer do the rest for you (and
  129. your client/customers)!
  130.  
  131.      Program Installer not only copies files from the diskettes you setup for
  132. distribution, it can also handle subdirectories you may need created (nested)
  133. on the end-user's (client's) harddrive, and also provides for updating the
  134. end-user's AUTOEXEC.BAT and CONFIG.SYS files dynamically - all this totally
  135. transparent to the end-user.
  136.  
  137.      Also, Program Installer provides options that allow you a limited amount
  138. of license protection for your application. Even data encryption has been
  139. implemented (beginning with version 3.0) so you can be assured that your
  140. programs/data cannot be installed (or just copied) without the use of Program
  141. Installer.
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.                                FEATURES!
  167.  
  168.  
  169.         ■ The ability to configure Program Installer for each
  170.           product you want to use it with. By "configure" we
  171.           mean you can specify the number of times INSTALL can
  172.           be executed, whether or not the installation is to be
  173.           protected, if the installation process is to be protected,
  174.           you can use encryption on the files to be installed.
  175.           And this configuration can be changed time and time again!!!
  176.  
  177.           Best of all, you can also have Program Installer replace
  178.           every/all occurrences of The DataWorks, Inc. copyright
  179.           messages with anything you want to appear in its menus/
  180.           screens.
  181.  
  182.         ■ The incorporation of the .LZH compression method, providing
  183.           the ability to compress your application on the distribution
  184.           diskette(s) (beginning with v4.0beta).
  185.  
  186.         ■ Seamless interface. Program Installer is written in
  187.           Borland's <tm> Turbo Pascal 6.0 using Turbo TechnoJock's <tm>
  188.           TTT5 ToolKit, and Async Professional <tm> by TurboPower Software.
  189.           The code has been tested thoroughly for bugs and performs fast,
  190.           efficient, and with a professional appearance. We feel this is
  191.           important because the first impression of your product is its
  192.           installation process and first impressions can definitely be
  193.           long lasting.
  194.  
  195.         ■ Easy setup. Program Installer takes only minutes to
  196.           completely configure for your use.
  197.  
  198.         ■ Free technical support from 7:00 A.M. to 7:00 P.M.
  199.           central standard time (USA).
  200.  
  201.  
  202.                TECHNICAL SUPPORT (Registered Users Only!)
  203.  
  204.           Support is provided in all of the following ways:
  205.  
  206.                Direct voice contact: (205) 345-2848
  207.  
  208.                24 hours a day by:
  209.  
  210.                     CompuServe ID#: 71321,3422
  211.  
  212.                     DataWorks BBS! (205) 507-0015
  213.  
  214.                     Or Dev-Net (ShareDev conference)
  215.                     on a local technical BBS in your
  216.                     area, who is echoing the Dev-Net
  217.                     QWK mail compatible netmail conferences.
  218.                     
  219.  
  220.  
  221.  
  222.      IMPORTANT NOTICE FOR TEST DRIVE (Non-registered) VERSION/USERS
  223.  
  224.      If you have not registered your copy of Program Installer, some of
  225. the following features will not work because they are disabled in the
  226. TEST DRIVE release of all copies of Program Installer. Prior to version 4.0beta,
  227. we totally disabled almost all of the advanced features of the program until
  228. the user registered the program. With the release of 4.0beta and later versions,
  229. we are allowing for all features to be available except for the following:
  230.  
  231.         ■ You will not be able to remove any of the hard-coded
  232.           "Copywrite (C)" information lines out of the program
  233.           and replace them with your own.
  234.  
  235.         ■ Although you will be able to actually work with all the
  236.           features of the program, and even create your distribution
  237.           diskettes, Program Installer's main INSTALL.EXE program
  238.           will not install the distribution diskettes on any system.
  239.           Hence, you will not be able to see how the program works
  240.           from the end-user's stand-point, until you register the
  241.           program.
  242.  
  243.      We effected these disabilities this way because this will allow you,
  244. the distributor/developer to preview all of the program's features/options,
  245. and review the integrity/performance of the program all the way to the point
  246. of actually creating your distribution diskettes. However, the INSTALL.EXE is
  247. disabled when it comes to the point of actually installing anything off of
  248. any of the distribution disks until you register the program and receive the
  249. REGISTER.KEY file, necessary to enable all the features of the program.
  250.  
  251.                          NOTICE!!!   NOTICE!!!
  252.  
  253.      We at DataWorks, Inc. know that Program Installer is a high-quality,
  254. commercial product. However, instead of releasing Program Installer at
  255. $199.95 or higher, to compete with other comparable commercial products,
  256. we're releasing it via the BBS community for a very modest fee. Because of this
  257. we MUST disable the program, forcing users to pay for its use. There are a
  258. number of ways available for registering the program and obtaining a
  259. REGISTER.KEY file. See the REGISTER.DOC file for details. Our main reason for
  260. distributing the program this way, and at such a price is because we know
  261. that many, many developers out there don't want to spend $200.00 and up
  262. to use an installation utility only once! Also, for distributors/developers
  263. that DO have several products they want to use the installation utility for,
  264. we're providing an excellent product at an excellent price! By doing this,
  265. we hope to make every user of Program Installer happy!!!
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.                         SETUP AND CONFIGURATION
  278.  
  279.  
  280.      When you first receive Program Installer it needs to be configured for use
  281. with your application(s). This is accomplished easily!
  282.  
  283.      Program Installer's main program - INSTALL.EXE - is the only program that
  284. you'll ever use. This may seem a bit confusing, but the program modifies itself
  285. each time you configure it for your software and distribution. This means that
  286. once you configure it for use with say, a product you're selling that you don't
  287. care about copy protection for, and it has only 4 disks, that you're not locked
  288. into THAT configuration, period. Program Installer is designed to be configured
  289. again, and again. So, whether you're wanting to use it for only one application
  290. you're marketing/distributing, or with many different applications, it's quite
  291. easy to configure it for each application! Best of all, you only have to buy
  292. one copy of the program to do all this! No royalties, no nothing.
  293.  
  294.  
  295.          
  296.                       REPLACING OUR COPYRIGHT LINES
  297.  
  298.      The first thing most users want to do is get rid of DataWorks' copyright
  299. information that appears throughout the program. To do this, make sure you are
  300. in the directory that INSTALL.EXE is in. Then type
  301.  
  302.         INSTALL LICENSEE - and press <Enter>.
  303.  
  304.      Program Installer will look for your REGISTER.KEY file in the same
  305. directory you are executing the INSTALL.EXE file in. (NOTE: If you have NOT
  306. registered your copy of Program Installer, you will not have this file!) If
  307. Program Installer finds the REGISTER.KEY file, then it proceeds and allows
  308. you to continue.
  309.  
  310.      The screen that appears is simple. You're prompted to enter the name -
  311. however you want it! - that you want to appear instead of the DataWorks, Inc.
  312. copyright information that appears throughout the program.
  313.  
  314. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  315. ░╔═════════════════════════════════════════════════════════════════════════╗░
  316. ░║ ······································································  ║░
  317. ░╚═════════════════════════════════════════════════════════════════════════╝░
  318. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  319.  Figure 1
  320.  
  321.  
  322.      After you enter the name (or complete line of information) and press
  323. <Enter> (or <RETURN> on some machines) you will be prompted to verify that the
  324. data you entered is, in fact, what you want to use in place of the DataWorks,
  325. Inc. copyright information.
  326.  
  327.  
  328.  
  329.  
  330.  
  331.         ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  332.         ░░╔═══════════════════════════════════════════╗░░
  333.         ░░║              You entered...               ║░░
  334.         ░░║ Copyright (C) 1991 - The DataWorks, Inc.  ║░░
  335.         ░░║                                           ║░░
  336.         ░░║               Accept  Redo                ║░░
  337.         ░░╚═══════════════════════════════════════════╝░░
  338.         ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  339.          Figure 2
  340.         
  341.  
  342.      If you <Accept> the line, the INSTALL.EXE modifies itself so that the line
  343. you just entered appears from then on, each time you run the program, where
  344. the end-user would otherwise see the DataWorks, Inc. copyright information.
  345.  
  346.      Next you will be returned to the DOS environment, at which point you will
  347. have to type INSTALL again if you wanted to run the program to check and see
  348. that your line has been properly inserted.
  349.  
  350.      Now, the next step is to configure Program Installer for a few other
  351. options that really make up the program's strength.
  352.  
  353.      These configuration steps/options can be changed for any/all applications
  354. you may want to use Program Installer with.
  355.      
  356.  
  357.      To configure Program Installer you type
  358.  
  359.         INSTALL LICSETUP <Enter>
  360.  
  361.      The following screen will appear:
  362.  
  363. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  364. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  365. ░░░░░░░░░░░░░░░░░░░░░░░░░░▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀░░░░░░░░░░░░░░░░░░░░░░░░░░
  366. ░░░░░░░░░░░░░░░░░░░░░░░░░█ Program Installer Setup  ░░░░░░░░░░░░░░░░░░░░░░░░░░
  367. ░░░░░░░░░░░░░░░░░░░░░░░░░█        Main Menu         ░░░░░░░░░░░░░░░░░░░░░░░░░░
  368. ░░░░░░░░░░░░░░░░░░░░░░░░░█──────────────────────────░░░░░░░░░░░░░░░░░░░░░░░░░░
  369. ░░░░░░░░░░░░░░░░░░░░░░░░░█                          ░░░░░░░░░░░░░░░░░░░░░░░░░░
  370. ░░░░░░░░░░░░░░░░░░░░░░░░░█     1    Setup Disks     ░░░░░░░░░░░░░░░░░░░░░░░░░░
  371. ░░░░░░░░░░░░░░░░░░░░░░░░░█     2    Exit            ░░░░░░░░░░░░░░░░░░░░░░░░░░
  372. ░░░░░░░░░░░░░░░░░░░░░░░░░█                          ░░░░░░░░░░░░░░░░░░░░░░░░░░
  373. ░░░░░░░░░░░░░░░░░░░░░░░░░█████████████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  374. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  375. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  376. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  377. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  378. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  379.        Copyright (C) 1990..1992 The DataWorks, Inc.   All Rights Reserved.
  380. ------------------------------------------------------------------------------
  381.  Figure #3
  382.  
  383.  
  384.  
  385.  
  386.      From this menu choose option #1 (Setup Disks) and press <Enter>.
  387. The following screen should appear (NOTE: The directories you may see on
  388. the left side of the screen may be different, but the screen layout the
  389. same):
  390.  
  391. ╔═════════════════╣ C:\ ╠══════════════════╗╔═══════════════════  3:39:16 p.m. ╗
  392. ║      Name    │   Size  │  Date  │  Time  ║║ Selected Files for Archiving     ║
  393. ║──────────────────────────────────────────║║──────────────────────────────────║
  394. ║  AM          │SUB-DIR│ 1-18-92│ 1:39p    ║║                                  ║
  395. ║  APRO        │SUB-DIR│12-22-91│10:07a    ║║                                  ║
  396. ║  ART         │SUB-DIR│ 1-15-92│ 2:04p    ║║                                  ║
  397. ║  CHATBOX     │SUB-DIR│12-22-91│ 9:40a    ║║                                  ║
  398. ║  CPUP        │SUB-DIR│12-27-91│ 9:57a    ║║                                  ║
  399. ║  CUP         │SUB-DIR│12-27-91│ 9:57a    ║║                                  ║
  400. ║  DV          │SUB-DIR│12-22-91│ 9:40a    ║║                                  ║
  401. ║  DWORKS      │SUB-DIR│12-22-91│10:09a    ║║                                  ║
  402. ║  EZTAPE      │SUB-DIR│12-22-91│ 9:22a    ║║                                  ║
  403. ║  FAST        │SUB-DIR│12-22-91│10:25a    ║║                                  ║
  404. ║  NEWSWORK    │SUB-DIR│ 1-04-92│ 5:42a    ║║                                  ║
  405. ║  NWLITE      │SUB-DIR│ 1-03-92│ 7:08p    ║║                                  ║
  406. ║  OFFLINE     │SUB-DIR│12-22-91│ 9:40a    ║║                                  ║
  407. ╠══════════════════════════════════════════╝╚══════════════════════════════════╣
  408. ║ Select files or directories to archive                                       ║
  409. ╠══════════════════════════════════════════════════════════════════════════════╣
  410. ║            File Style: Just Compression;  Floppy Disk Size: 360 k            ║
  411. ║                               PI Directory: C:\                              ║
  412. ╠══════════════════════════════════════════════════════════════════════════════╣
  413. ║ <+, -, Space> Mark/Unmark files               <Alt-D> New Drive              ║
  414. ║ <Tab> Archive List      <Alt-S> Options       <F10> Archive       <Esc> Quit ║
  415. ╚══════════════════════════════════════════════════════════════════════════════╝
  416. --------------------------------------------------------------------------------
  417.  Figure #4
  418.  
  419.  
  420.     Before we get involved with this screen, let's configure Program Installer
  421. first, and then we'll come back to this screen.
  422.  
  423.  
  424.     At this time, press <Alt-S> (hold down the Alt key on your keyboard, and
  425. then press the 'S' character). You should see the following screen:
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440. ╔═══════════════════════ Program Installer Preferences ════════════════════════╗
  441. ║                                                                              ║
  442. ║ ╔═════════ Archive File Options ══════════╗  ┌── Maximum Disk Size ───┐      ║
  443. ║ ║ ( )   Just Encryption                   ║  │ ( )   360 k            │      ║
  444. ║ ║ (*)   Just Compression                  ║  │ ( )   720 k            │      ║
  445. ║ ║ ( )   Both Encryption and Compression   ║  │ (*)   1.2 meg          │      ║
  446. ║ ║                                         ║  │ ( )   1.4 meg          │      ║
  447. ║ ╚═════════════════════════════════════════╝  └────────────────────────┘      ║
  448. ║                                                                              ║
  449. ║ ┌────────────────── Autoexec.bat and Congig.sys Options ───────────────────┐ ║
  450. ║ │ [X]  Update AUTOEXEC.BAT with user defined information?                  │ ║
  451. ║ │ [ ]  Update CONFIG.SYS with user defined information?                    │ ║
  452. ║ └──────────────────────────────────────────────────────────────────────────┘ ║
  453. ║   Allowed installations (1 to 255; Enter 0 for unlimited): 0··               ║
  454. ║                                                                              ║
  455. ║ ┌─────────────────────────── AUTOEXEC.BAT info. ───────────────────────────┐ ║
  456. ║ │ path %PATH%;Mypat······················································· │ ║
  457. ║ │ ········································································ │ ║
  458. ║ │ ········································································ │ ║
  459. ║ ├──────────────────────────── CONFIG.SYS Info. ────────────────────────────┤ ║
  460. ║ │ ········································································ │ ║
  461. ║ │ ········································································ │ ║
  462. ║ │ ········································································ │ ║
  463. ║ └──────────────────────────────────────────────────────────────────────────┘ ║
  464.  <Ctrl-Enter> Save Setup   <Tab, Enter, Shift-Tab> Change fields   <Esc> Cancel
  465.  -------------------------------------------------------------------------------
  466.   Figure #5
  467.  
  468.  
  469.      This is where the real configuration is done for your application's
  470. distribution. In the 'Archive File Options' box (upper left box in the screen),
  471. you'll notice that the default is 'Just Compression'. Most users of Program
  472. Installer don't really need the 'Encryption' feature, and just use the
  473. 'Compression' feature when setting up their disks.
  474.  
  475.      'Just Encryption' - If you choose this option then the files that
  476. Program Installer prepares for your distribution diskettes will not be
  477. compressed. This will require more floppies for your software/application.
  478. However, it will still protect your interests some, because the INSTALL
  479. program will be the only way these prepared DISK1.X, DISK2.X, etc. (for how-
  480. ever many disks are required for your application) files cannot be unpacked
  481. (not uncompressed - like DOS's BACKUP program, INSTALL determines how many
  482. of the files selected, when grouped, best fit on each floppy, depending on the
  483. size of the floppy disk you are using. It creates one DISKx file for each
  484. disk, and each of these DISKx files contains files that make up your
  485. application. So, though your files are not compressed, they are still
  486. packed, or "combined" into one file for each distribution diskette) and
  487. copied onto the end-user's hard drive without using INSTALL to do so. To
  488. further protect your interests, the packed ("combined") file is also
  489. encrypted so even if the best of hackers could figure out how to unpack our
  490. formats, they would first have to figure out how to decrypt the file!
  491.  
  492.  
  493.  
  494.  
  495.      You would choose 'Just Encryption' if you did not want to use compression
  496. on your files, and if you wanted to speed up the process of preparing your
  497. disk(s) for distribution.
  498.  
  499.      'Just Compression' - The default mode, using 'Just Compression', the
  500. INSTALL program goes through all of the files within a given directory that
  501. you have selected for use in your application and compresses each file. This
  502. is done before the packing of the DISKx files that will be placed on each
  503. distribution diskette.
  504.  
  505.      We use the .LZH compression technique from TurboPower Software's
  506. Async Professional <tm> toolkit. This technique is as good as most any other
  507. on the market today. However, it is not as fast as others (like PkZip <tm>).
  508. Depending on the number and size of the files you have selected for your
  509. application (we'll get into how to do this when we return to working with
  510. the screen in Figure #5), this could take some time. On one beta site, we
  511. selected a subdirectory with over 436 files in it, totalling some 8.7
  512. megabytes in uncompressed form. It took just over 30 minutes for Program
  513. Installer to complete the compression of all the files, and prepare the four
  514. DISKx files. We elected to use Encryption and Compression for this test,
  515. really putting the program through its paces. It performed quite well.
  516. Although, it took this long to create the DISKx files for distribution,
  517. when installing your application, Program Installer takes only minutes,
  518. depending on the speed of the end-user's hard drive. The installation
  519. and extraction of the DISKx files takes only a few minutes compared to the
  520. time it takes the program to create these files initially. We really
  521. cannot explain in simple terms why this is so.
  522.  
  523.      'Both Encryption and Compression' - Select this option to encrypt the
  524. compressed DISKx files you are setting up for distribution. Here again,
  525. the encryption is just an added feature/measure to help protect your
  526. interests.
  527.  
  528.      Once you have selected which of these three features to use, press
  529. the <TAB> key on your keyboard and you will jump to the 'Maximum Disk Size'
  530. window. Notice that the boarder around the window you are in is a double-line
  531. boarder, and the other windows have single-line boarders around them. This
  532. is one way you can quickly determine which window you are currently in.
  533.  
  534.      Here, using the <Up> or <Down> cursor keys again, you
  535. specify which size floppy diskette you are using for your distribution
  536. disks. The only thing Program Installer won't take care of for you, is
  537. the formatting of these floppy diskettes. You must make sure, that when
  538. Program Installer prompts you for a floppy disk, no matter which size you
  539. elect to use, the floppy must be formatted before Program Installer can
  540. place any files on it. And the floppy must be complete blank, with not even
  541. the system boot files on it (except for the very first - INSTALL - diskette).
  542.  
  543.      Next, press the <TAB> key again, and you will go to the 'Autoexec.bat
  544. and Config.sys Options' window. Here you can specify 1, 2, or all 3 of 3
  545. available options.
  546.  
  547.  
  548.  ■■■ NOTICE - SEE UPDATE INFO ON THIS AT THE END OF THIS DOC ■■■
  549.  
  550.      'Update AUTOEXEC.BAT with installation path?' - If you press the
  551. <Space-Bar> while the cursor is on this option, you will see an 'X' appear
  552. between the brackets. This options tells Program Installer to update the end-
  553. user's AUTOEXEC.BAT file PATH command line with the path (complete drive,
  554. subdirectory name, etc.) that the user specified for installing your
  555. application (later in this document, we'll cover that actual installation
  556. procedure that the end-user performs and how it operates). This is specified
  557. at the time the user installs (runs INSTALL) your application. Leave this
  558. option blank (default) if you do NOT want the installed subdirectory of your
  559. application's path included in the end-user's system's PATH statement.
  560.  
  561.      'Update AUTOEXEC.BAT with SET= 'VARIABLES'?' - This option is provided
  562. for developers of applications like those done with CLIPPER. Here, the
  563. end-user would have to update their own AUTOEXEC.BAT file with a
  564.  
  565.         SET variablename = \APPLICATION DIRECTORY
  566.  
  567. for CLIPPER to properly find itself during runtime. Other applications may
  568. use environment variables as well, and may need environment SET variables
  569. added to the AUTOEXEC.BAT file. Program Installer allows you to define up to
  570. three (3) such variables (see the '"Set" Variables' window, next).
  571.  
  572.      'Update CONFIG.SYS with user defined information?' - Like the SET= VARIABLES
  573. option, this option will allow you to define up to three (3) lines of
  574. information that will be appended to the end-user's CONFIG.SYS file. Like with
  575. the SET= VARIABLES option, this may be necessary for some applications. Quite
  576. often, many DOS installation programs and other applications do not set
  577. parameters in a CONFIG.SYS file like the FCBS= or the STACKS= parameters.
  578. However, your application may need these set a specific way. You can define
  579. the line, exactly as it must appear, and up to three (3) of these lines,
  580. in the 'CONFIG.SYS Info' window.
  581.  
  582.      Press <TAB> again and the cursor goes to the 'Allowed installations
  583. (1 to 255; Enter 0 for unlimited):' field. This is provided as an added measure,
  584. again, to help protect your interests. You can set this to say, 2, and then
  585. INSTALL will only allow itself to be run twice for this configuration. Now,
  586. if the user begins the INSTALL process and aborts, that doesn't count. Only
  587. if they complete a successful installation will it count. So, if you only
  588. want your application to be able to be installed once or twice, set this to
  589. 1 or 2, respectively. Of course, this doesn't stop them from making disk copies
  590. of your application initially, but it is a deterent!
  591.  
  592.  
  593.      Program Installer keeps a log of everything it does for your given
  594. configurations. It creates a directory called #_PI.DIR, in the directory/
  595. path you specify (or off of the root of C:\ as it defaults for) and in this
  596. directory it maintains its log file, and also uses this directory to build
  597. or compress the disk files that are to be prepared for your distribution
  598. disks. So, if you just leave the default, or change it to a drive letter
  599.  
  600.  
  601.  
  602. of your choice, but don't specify a subdirectory, just a root directory,
  603. you will find the #_PI.DIR subdirectory created off of the root directory
  604. after you have completed setting up a set of distribution diskettes. In
  605. this subdirectory you will also find a PI_x.LOG file, where x is the
  606. number of the log. Program Installer looks for the existence of a log file
  607. in its work directory before beginning. If, for example, you run Program
  608. Installer for the first time, it creates the PI_0.LOG file in the work
  609. directory (#_PI.DIR in this case). Now, if you don't delete the log file/
  610. work directory, the next time you run Program Installer, if you use the
  611. same work directory, it will see the PI_0.LOG file, and name the next one
  612. PI_1.LOG, and so on.
  613.  
  614.      Pressing <TAB> from here, you go to the '"Set" Variables' window. Here
  615. is where you can define environment variables that you want inserted into the
  616. end-user's AUTOEXEC.BAT file. NOTE: In this window you type only the name
  617. of the environment variable, and nothing else. Program Installer knows how
  618. to handle the rest of the syntax. For example, if you need the line
  619.  
  620.                 SET MYPATH=directoryname/path
  621.  
  622. all you need to type here is 'MYPATH' in this window. Program Installer will
  623. set it equal to the subdirectory that your application gets installed into.
  624. This is determined by the INSTALL program at runtime, when the end-user is
  625. actually installing your application. So, if you need this to be a GIVEN sub-
  626. directory, be sure to include the subdirectory name in your documentation to
  627. the end-user.
  628.  
  629.      NOTE: Any variable you need defined will only be set to the installation path
  630. and this is hard coded for now. We're working on incorporating a more flexible
  631. option that'll allow you to actually type in the complete SET= statement
  632. yourself, hence allowing you to point to perhaps your own TEMP subdirectory,
  633. or some other work directory, other than the primary installation sub-
  634. directory. This feature should be available in one of the minor 4.x updates
  635. that'll be posted in the next month or two.
  636.  
  637.      Press <TAB> once more and you'll move to the 'CONFIG.SYS Info' window.
  638. Here you can add up to three (3) additional lines for parameter definitions
  639. in the end-user's CONFIG.SYS file. Something like
  640.  
  641.         FCBS=16,32
  642.  
  643. or
  644.  
  645.         STACKS=0,0
  646.  
  647. or whatever you may need to be sure has been set in the CONFIG.SYS. NOTE: If
  648. you do define something here that may already be defined in the end-user's
  649. CONFIG.SYS file, Program Installer will detect this, and then determine if
  650. the end-user's system is configured equal to, or greater than your specks.
  651. This applies to things like FILES= or BUFFERS=. If you type these into this
  652. window now as, for example, FILES=30 and BUFFERS=25 (on two separate lines in
  653. this window, of course), then Program Installer will first check to see if
  654.  
  655.  
  656.  
  657. these parameters are not already defined in the CONFIG.SYS. If they are not,
  658. your lines will be inserted. If these two parameters are already defined,
  659. however, the values of your lines will be compared with the values already
  660. in the CONFIG.SYS file. If yours are greater, in this case, your lines
  661. will be written into the file, and theirs will be removed.
  662.  
  663.      A case that the greater does NOT replace what is already in the
  664. CONFIG.SYS file is with the STACKS= parameter. If you define this
  665. parameter in this window, and if it already exists in the end-user's
  666. CONFIG.SYS file, then yours will be written to the file anyway! Also,
  667. if you enter the SHELL= statement in this window, Program Installer WILL
  668. compare the environment space indicated with the /E: /P switches, and if
  669. you are allocating more space than may already be allocated, then your
  670. line will replace whatever may already be in the CONFIG.SYS file.
  671. If there is not a SHELL= statement in the CONFIG.SYS file, then of
  672. course, your line will be inserted. However, if you are, for example,
  673. allocating 256K of environment space, when there is already 512K of
  674. environment space allocated, then your line will be ignored.
  675.  
  676.      There are a lot of caveats, we know, that we will try and
  677. enhance/dress-up as we gradually update the program. For now, we
  678. hope these configuration options are adequate.
  679.  
  680.      Once you have set all of your options in this screen, you can save
  681. this setup by pressing <Ctrl-Enter> (hold down the CONTROL/Ctrl key and
  682. pressing ENTER). If you need to edit your setup, use the <TAB> key to
  683. navigate the screen and make any necessary changes. To abort altogether
  684. you can press <Esc> to abort.
  685.  
  686.      Once you save your options, you are returned to the work screen,
  687. as previously shown in Figure #5. You should see a screen similar to the
  688. following:
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712. ╔═════════════════╣ C:\ ╠══════════════════╗╔═══════════════════ 1:01:34 a.m. ═╗
  713. ║      Name    │   Size  │  Date  │  Time  ║║ Selected Files for Archiving     ║
  714. ║──────────────────────────────────────────║║──────────────────────────────────║
  715. ║  AM          │SUB-DIR│ 1-18-92│ 1:39p    ║║                                  ║
  716. ║  APRO        │SUB-DIR│12-22-91│10:07a    ║║                                  ║
  717. ║  ART         │SUB-DIR│ 1-15-92│ 2:04p    ║║                                  ║
  718. ║  CHATBOX     │SUB-DIR│12-22-91│ 9:40a    ║║                                  ║
  719. ║  CPUP        │SUB-DIR│12-27-91│ 9:57a    ║║                                  ║
  720. ║  CUP         │SUB-DIR│12-27-91│ 9:57a    ║║                                  ║
  721. ║  DV          │SUB-DIR│12-22-91│ 9:40a    ║║                                  ║
  722. ║  DWORKS      │SUB-DIR│12-22-91│10:09a    ║║                                  ║
  723. ║  EZTAPE      │SUB-DIR│12-22-91│ 9:22a    ║║                                  ║
  724. ║  FAST        │SUB-DIR│12-22-91│10:25a    ║║                                  ║
  725. ║  NEWSWORK    │SUB-DIR│ 1-04-92│ 5:42a    ║║                                  ║
  726. ║  NWLITE      │SUB-DIR│ 1-03-92│ 7:08p    ║║                                  ║
  727. ║  OFFLINE     │SUB-DIR│12-22-91│ 9:40a    ║║                                  ║
  728. ╠══════════════════════════════════════════╝╚══════════════════════════════════╣
  729. ║ Select files or directories to archive                                       ║
  730. ╠══════════════════════════════════════════════════════════════════════════════╣
  731. ║    File Style: Both Encryption and Compression; Floppy Disk Size: 1.2 meg    ║
  732. ║                               PI Directory: C:\                              ║
  733. ╠══════════════════════════════════════════════════════════════════════════════╣
  734. ║ <+, -, Space> Mark/Unmark files               <Alt-D> New Drive              ║
  735. ║ <Tab> Archive List      <Alt-S> Options       <F10> Archive       <Esc> Quit ║
  736. ╚══════════════════════════════════════════════════════════════════════════════╝
  737. --------------------------------------------------------------------------------
  738.  Figure #6
  739.  
  740.  
  741.      From this work screen we will instruct Program Installer as to the files
  742. that make up your entire application. What we've done here is pretty straight
  743. forward. However, before we get into using this screen to build the
  744. distribution diskettes, let's briefly go over the menu options at the bottom
  745. of the screen in Figure #6.
  746.  
  747.      <+, -, Space> Means that you can use the PLUS and MINUS keys on your
  748. ten-key key pad (this is on the right side of the keyboard on 101 or newer
  749. enhanced keyboards) to mark or unmark individual files for packing. If you
  750. do not have an enhanced keyboard, with the ten-key keypad on the right side,
  751. you can use the <Space-Bar> if/when you need to flag a specific group of files,
  752. flagging each one individually.
  753.  
  754.      The <Space-Bar> is better suited for flagging an entire subdirectory
  755. for packing. Let's say all of your application resides in one subdirectory.
  756. Just scroll to that subdirectory and press the <Space-Bar>. You'll see a
  757. √ check mark appear to the left of the directory name, and the specifications
  758. for that flagged directory appear on the right side of the work screen. This
  759. shows what is selected for Program Installer to either compress/encrypt or both
  760. for your distribution diskettes.
  761.  
  762.      The <+> and <-> keys are better suited for selecting a group of files that
  763. reside in a common directory, with say, the same file extension, or something
  764.  
  765.  
  766.  
  767. similar to each file name. For example, if my application is a database system,
  768. and all of the database files must be initialized (already exist) for the
  769. main program to work, then I may want to initialize them now, then select
  770. just the .DBF and .NDX files for packing. If all of these files reside in a
  771. subdirectory where other files reside with a different suffix, I can use the
  772. <+> key to flag just these files.
  773.  
  774.      When you press either the <+> or <-> keys (on the key-pad now!), you
  775. will see a small box appear in the center of the work screen. In the box
  776. the prompt is defaulted for the DOS wildcard '*.*'. Here I could change
  777. this to *.DBF first, then press <Enter>. Then press the <+> key again
  778. and change it to *.NDX. This would select my group of files out of the
  779. many files that could also be residing in the same subdirectory.
  780.  
  781.      Pressing the <+> key prompts you for files/wildcard combinations to
  782. select for packing, and the <-> key prompts you for files to deselect
  783. from your setup work screen.
  784.  
  785.      Likewise, if you have pressed the <Space-Bar> while on a subdirectory
  786. name and have selected it for packing, pressing the <Space-Bar> on that
  787. same subdirectory name again, will deselect all those files for packing.
  788.  
  789.      Let's walk through a cenario here, pretending to build a set of
  790. distribution disks for our product. To make this easy though, lets go
  791. further and pretend that the DOS subdirectory on your hard drive is the
  792. application's installed subdirectory.
  793.  
  794.      If this were the case, simply make sure that all of the files necessary
  795. to the application are installed in this subdirectory. (Mine is called
  796. \PUBLIC\V5.00, but yours may be \DOS or any other name - Just use whatever
  797. subdirectory your DOS system files are installed in.)
  798.  
  799.      In my case, my DOS system files are in a subdirectory that is nested off
  800. of my root directory. To navigate through subdirectories with the work screen,
  801. use the <Up> and <Down> cursor keys to move your cursor, then press <Enter>
  802. when on a subdirectory name that you would like to enter. When you ARE
  803. in a subdirectory, you will see the drive and path that you are in in the
  804. center of the top-left column of the work screen. Also, you will notice that
  805. the very top/first entry in the subdirectory is now not a subdirectory or
  806. file name, but two (2) dots '..' instead. This indicates that you ARE in a
  807. subdirectory, and to get out of the subdirectory, you place the cursor on
  808. these two dots and press enter. This will take you back to the previous
  809. path level. If you were nested down several subdirectories, you would
  810. simply repeat this for each level, until you back all the way out to the
  811. root directory.
  812.  
  813.      Once inside my \PUBLIC subdirectory, I press the <Space-Bar> when the
  814. cursor is on my V5.00 subdirectory. The screen looks like the following:
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822. ╔══════════════╣ C:\PUBLIC\ ╠══════════════╗╔═══════════════════ 1:54:30 a.m. ═╗
  823. ║      Name    │   Size  │  Date  │  Time  ║║ Selected Files for Archiving     ║
  824. ║──────────────────────────────────────────║║──────────────────────────────────║
  825. ║  ..          │ UP--DIR │12-22-91│ 9:25a  ║║C:\PUBLIC\V5.00\*.*               ║
  826. ║  DOSU        │ SUB-DIR │12-22-91│ 9:25a  ║║                                  ║
  827. ║√ V5.00       │ SUB-DIR │12-22-91│ 9:26a  ║║                                  ║
  828. ║  bw       exe│   117456│ 7-29-91│ 1:52p  ║║                                  ║
  829. ║  bwback   ovr│    39598│ 7-29-91│ 1:52p  ║║                                  ║
  830. ║              │         │        │        ║║                                  ║
  831. ║              │         │        │        ║║                                  ║
  832. ║              │         │        │        ║║                                  ║
  833. ║              │         │        │        ║║                                  ║
  834. ║              │         │        │        ║║                                  ║
  835. ║              │         │        │        ║║                                  ║
  836. ║              │         │        │        ║║                                  ║
  837. ║              │         │        │        ║║                                  ║
  838. ╠══════════════════════════════════════════╝╚══════════════════════════════════╣
  839. ║ Select files or directories to archive                                       ║
  840. ╠══════════════════════════════════════════════════════════════════════════════╣
  841. ║    File Style: Both Encryption and Compression; Floppy Disk Size: 1.2 meg    ║
  842. ║                               PI Directory: C:\                              ║
  843. ╠══════════════════════════════════════════════════════════════════════════════╣
  844. ║ <+, -, Space> Mark/Unmark files               <Alt-D> New Drive              ║
  845. ║ <Tab> Archive List      <Alt-S> Options       <F10> Archive       <Esc> Quit ║
  846. ╚══════════════════════════════════════════════════════════════════════════════╝
  847. --------------------------------------------------------------------------------
  848.  Figure #7
  849.  
  850.  
  851.      By pressing the <Space-Bar> while on a subdirectories's name, you are
  852. instructing Program Installer to flag ALL of the files in that subdirectory
  853. for packing. That is why you see the \PUBLIC\V5.00\*.* setting in the right
  854. column of the work screen in Figure #7 above. Now, if this were all I needed
  855. to install my application, I could press the <F10> key now, and Program
  856. Installer will begin its work, prompting me as needed for blank floppies, or
  857. to press any key to continue, as it worked to build the distribution disks
  858. for my application. However, let's make it more difficult. Let's say I don't
  859. want ANY of the .COM files out of this directory included in the packing! At
  860. this point I would press <Enter> while my cursor was on the V5.00 subdirectory,
  861. then press the <-> key and replace the default wildcard with *.COM, and press
  862. <Enter>. The screen looks like the following:
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877. ╔═══════════╣ C:\PUBLIC\V5.00\ ╠═══════════╗╔═══════════════════ 2:04:32 a.m. ═╗
  878. ║      Name    │   Size  │  Date  │  Time  ║║ Selected Files for Archiving     ║
  879. ║──────────────────────────────────────────║║──────────────────────────────────║
  880. ║  ..          │ UP--DIR │12-22-91│ 9:26a  ║║C:\PUBLIC\V5.00\*.BAS             ║
  881. ║√ gorilla  bas│    29434│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.CPI             ║
  882. ║√ money    bas│    46225│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.EXE             ║
  883. ║√ nibbles  bas│    24103│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.GRB             ║
  884. ║√ remline  bas│    12314│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.HLP             ║
  885. ║  assign   com│     6399│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.INI             ║
  886. ║  command  com│    47845│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.LST             ║
  887. ║  diskcomp com│    10652│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.PRO             ║
  888. ║  diskcopy com│    11793│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.SYS             ║
  889. ║  doskey   com│     5883│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.TXT             ║
  890. ║  dosshell com│     4623│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.VID             ║
  891. ║  edit     com│      413│ 4-09-91│ 5:00a  ║║                                  ║
  892. ║  format   com│    32911│ 4-09-91│ 5:00a  ║║                                  ║
  893. ╠══════════════════════════════════════════╝╚══════════════════════════════════╣
  894. ║ Select files or directories to archive                                       ║
  895. ╠══════════════════════════════════════════════════════════════════════════════╣
  896. ║    File Style: Both Encryption and Compression; Floppy Disk Size: 1.2 meg    ║
  897. ║                               PI Directory: C:\                              ║
  898. ╠══════════════════════════════════════════════════════════════════════════════╣
  899. ║ <+, -, Space> Mark/Unmark files               <Alt-D> New Drive              ║
  900. ║ <Tab> Archive List      <Alt-S> Options       <F10> Archive       <Esc> Quit ║
  901. ╚══════════════════════════════════════════════════════════════════════════════╝
  902. --------------------------------------------------------------------------------
  903.  Figure #8
  904.  
  905.  
  906.      As you can see, the .COM files have now been deselected (the √ check
  907. mark removed from the left of the filename), and on the right side you now
  908. see a more descritive listing showing what we are going to pack. These
  909. as WE know, are all of the files, except those that end in .COM, out of my
  910. \PUBLIC\V5.00 subdirectory.
  911.  
  912.      Now, to begin the process that will build my distribution diskettes, I
  913. simply press the <F10> key.
  914.  
  915.      What follows, after you press the <F10> key is the compression part, if
  916. you chose to use 'Compression' in your setup. After the compression is done,
  917. Program Installer begins the packing process, packing a number of files into
  918. one (1) or more DISKx files. I have chosen Compression and Encryption in my
  919. setup and now Program Installer is 'Freezing' all of my files. This is the
  920. term used in LZH that tells you the file is being compressed. Once this is
  921. done I see a listing of file names scroll by as Program Installer is packing
  922. as many of the compressed files into DISK1.LZX. If not all of the files will
  923. fit on one (1) 1.2 megabyte 5 1/4" floppy, Program Installer goes on to
  924. packing the DISK2.LZX file for my System Disk 2 (distribution diskette).
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.      Once all of the compressing and packing is done, I then see the
  933. DISK1 and DISK2.LZX files being encrypted. After this, I am instructed that
  934. my setup will need three completely blank foppy diskettes. The first floppy is
  935. the INSTALL program. Also, if I have any README.DOC or other such files,
  936. Program Installer will install them from this first INSTALL diskette for me
  937. when the end-user runs INSTALL. The next two floppies are the DISK1.LZX and
  938. DISK2.LZX.
  939.  
  940.      The .LZX is Program Installer's way of knowing that this is not only
  941. a compressed, but also an encrypted diskette. We use three types of
  942. file suffix names (extensions):
  943.  
  944.         .X      This extension is used for 'Encryption Only'.
  945.         .LZH    This extension is used for 'Compression Only'.
  946.         .LZX    This extension is used for 'Encryption & Compression'.
  947.  
  948.      These file extensions are added to the DISKx file for each distribution
  949. floppy diskette. The actual files that you select for distribution have
  950. nothing to do with our own file extensions.
  951.  
  952.      Finally, one additional option in the Options Menu of the work screen
  953. in Figure #8 is <Alt-D>. Pressing <Alt-D> allows you to select a different
  954. hard drive to work with for selecting (tagging) files for packing for your
  955. distribution diskettes.
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.                  WRAPPING UP THE CONFIGURATION OPTIONS
  989.  
  990.  
  991.      That just about covers it from start to finish, insofar as the
  992. configuration options are concerned.
  993.  
  994.      You will want to work with the configuration options to become
  995. even more familiar with Program Installer's nice, built-in, setup screens.
  996. After you have configured and distributed a couple of products, you will
  997. find Program Installer quite easy and fast to work with.
  998.  
  999.      If you need any help at all, we offer various levels of technical
  1000. support. Next we're going to briefly cover the actual INSTALL program
  1001. from the end-user's standpoint.
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.                       INSTALLING YOUR APPLICATION
  1043.                        The End-User's Perspective
  1044.  
  1045.      The following documentation is provide to help you, the Developer, or
  1046. Distributor with some ideas on how to document your own manual, insofar as
  1047. covering the installation procedure. You are free to reproduce or use any of
  1048. the following, in any form or fashion, in any/all of your own documentation
  1049. for your own applications.
  1050.  
  1051.  
  1052.                               INSTALLATION
  1053.  
  1054.      To install your application, simply place the INSTALL system diskette
  1055. in either the 'A' or 'B' drive. Next, change to that drive and type INSTALL.
  1056.  
  1057.      This example will assume that you are using the 'A' drive, but if you
  1058. are using the 'B' drive, simply replace any reference to 'A' in the following,
  1059. with 'B'.
  1060.  
  1061.      To change to the 'A' drive, from the DOS prompt you type
  1062.  
  1063.         A: <Enter> - <Enter> means to press the enter / return key
  1064.                       on your keyboard.
  1065.  
  1066. Then type INSTALL and press <Enter> again. You should see the following screen:
  1067.  
  1068.  
  1069.  
  1070. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1071. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1072. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1073. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1074. ░░░░░░░░░░░░░░░░▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀░░░░░░░░░░░░░░░░░
  1075. ░░░░░░░░░░░░░░░█    Program Installer - Main Menu    ░░░░░░░░░░░░░░░░░
  1076. ░░░░░░░░░░░░░░░█─────────────────────────────────────░░░░░░░░░░░░░░░░░
  1077. ░░░░░░░░░░░░░░░█                                     ░░░░░░░░░░░░░░░░░
  1078. ░░░░░░░░░░░░░░░█     1    Install Program Disk(s)    ░░░░░░░░░░░░░░░░░
  1079. ░░░░░░░░░░░░░░░█     2    Exit Install Program       ░░░░░░░░░░░░░░░░░
  1080. ░░░░░░░░░░░░░░░█                                     ░░░░░░░░░░░░░░░░░
  1081. ░░░░░░░░░░░░░░░████████████████████████████████████░░░░░░░░░░░░░░░░░░░
  1082. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1083. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1084. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1085. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1086. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1087. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1088.   Copyright (C) 1990..1992 The DataWorks, Inc.   All Rights Reserved.
  1089. ______________________________________________________________________
  1090.  Figure #9
  1091.  
  1092.      At this point you want to choose option 1) Install Program Disk(s).
  1093. This will bring up the next screen, where you will be prompted to enter the
  1094. source drive you are using. The source drive is the floppy drive that you
  1095. inserted the INSTALL diskette in.
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101. ░░░░░░░░░░░░░░░░░┌───────────────────────────────────────────┐░░░░░░░░░░░░░░░░░░
  1102. ░░░░░░░░░░░░░░░░░│      Program Installer Version 4.5        │░░░░░░░░░░░░░░░░░░
  1103. ░░░░░░░░░░░░░░░░░└───────────────────────────────────────────┘░░░░░░░░░░░░░░░░░░
  1104. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1105. ░░┌─────────────────────────────────────────────────────────────────────────┐░░░
  1106. ░░│    Copyright (C) 1990..1992 The DataWorks, Inc.   All Rights Reserved.  │░░░
  1107. ░░└─────────────────────────────────────────────────────────────────────────┘░░░
  1108. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1109. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1110. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1111. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1112. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1113. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1114. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1115. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1116. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1117. ░░░░░░░░░░╔════════════════════════════════════════════════════╗░░░░░░░░░░░░░░░░
  1118. ░░░░░░░░░░║ Enter the SOURCE drive to use:  A                  ║░░░░░░░░░░░░░░░░
  1119. ░░░░░░░░░░╚════════════════════════════════════════════════════╝░░░░░░░░░░░░░░░░
  1120. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1121. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1122. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1123. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1124. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1125. [Enter] - Select    [Esc] - Quit                                             
  1126. ________________________________________________________________________________
  1127.  Figure #10
  1128.  
  1129.  
  1130.      Here you can either press <Enter> to accept the default drive, or enter B
  1131. to replace the default of A, and then press <Enter>.
  1132.  
  1133.      Next you will see the same screen, except you are being prompted to enter
  1134. the destination directory to install the application into. Program Installer
  1135. already has a default directory built in, and you can just press <Enter> to
  1136. accept the default of 'C:\', or replace the C:\ with the proper drive letter
  1137. of your choosing.
  1138.  
  1139.                      NOTE TO DEVELOPER/DISTRIBUTOR
  1140.  
  1141.      When you configure Program Installer, and then from the work screen,
  1142. select the subdirectory(s) to pack your program disk(s) from, Program Installer
  1143. retains that subdirectory(s) name and will install back into that same
  1144. directory(s) on the end-user's system. This is important to note, as you
  1145. need to be sure that you have your application set up exactly as it will need
  1146. to be on the end-user's system when it installs. Hence the end-user really
  1147. only needs to press <Enter> at the default prompt of C:\ for the destination
  1148. directory to install into, unless they are installing onto a different
  1149. hard drive.
  1150.  
  1151.     If you need to, feel free to call our technical support for more information
  1152. on how Program Installer works in this regard.
  1153.                   END OF NOTE TO DEVELOPER/DISTRIBUTOR
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.            SPECIAL NOTE ON AUTOEXEC.BAT and CONFIG.SYS FILES
  1160.  
  1161.  
  1162.      The install program may need to modify some variables in your AUTOEXEC.BAT
  1163. file, and parameters in your CONFIG.SYS file.
  1164.  
  1165.      Depending on your application, INSTALL may need to add this program's
  1166. subdirectory to your PATH statement, may need to SET variable names for your
  1167. DOS environment so it can find itself or work space it may need, and it may
  1168. need to check and/or add parameters like FILES= and/or BUFFERS= statements
  1169. to your CONFIG.SYS file. However, you will want to check these files after
  1170. INSTALL has completed installation, and be sure INSTALL placed the following,
  1171. or verified that the following already exists in these two files.
  1172.  
  1173.         for AUTOEXEC.BAT
  1174.                         SET=
  1175.                         SET=
  1176.                         SET=
  1177.                         PATH=
  1178.  
  1179.         for CONFIG.SYS
  1180.                         FILES=
  1181.                         BUFFERS=
  1182.                         STACK=
  1183.                         FCBS=
  1184.  
  1185.                     NOTE TO DEVELOPERS/DISTRIBUTORS
  1186.  
  1187.      The above is simply provided to help you with your documentation. Only
  1188. YOU know how your application should be installed, and what parameters/variables
  1189. may need to be set in the AUTOEXEC.BAT or CONFIG.SYS files. I've provided this
  1190. brief documentation for you to give you some ideas on how to conclude the
  1191. installation part of your application's documentation. What you actually place
  1192. here, if anything, depends entirely on your needs, and configuration.
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.                               WRAPPING UP
  1218.  
  1219.  
  1220.      At this point, we at DataWorks hope that this documentation is enough
  1221. for you to not only use Program Installer for your application, but to use
  1222. it to its fullest extents for all of your applications, however many you
  1223. may have. Also, we hope we have provided enough information concerning the
  1224. installation process so that you can easily and quickly write up the installation
  1225. documentation part of your manual/documentation for your application.
  1226.  
  1227.      The DataWorks, Inc. is a software development corporation. We are NOT a
  1228. software distribution company in the commercial sense. We do a lot of 3rd
  1229. party development, but on a much larger scale than this. We are not technical
  1230. writers (those who write the fancy user's manuals, etc.). We simply know how
  1231. to produce professional, high-quality software. At the same time, though, some
  1232. of us get the opportunity to produce a small, simple application like
  1233. Program Installer, and we hope you like it - in spite of how brief this
  1234. manual may be!
  1235.  
  1236.      And remember, Technical Support is only a phone call away, or a message
  1237. away on our Tech Support BBS (DataWorks BBS!), or CompuServe.
  1238.  
  1239.  
  1240. 04/92
  1241.  
  1242.         With the official release of Program Installer 4.5 there are
  1243. several subtle changes to the setup screens.
  1244.  
  1245. FEATURES
  1246.  
  1247.         With version 4.5 you can now create and compress an application
  1248. that you only need one diskette for, and Program Installer will attempt
  1249. to place this application on the first diskette, if it will fit. If the
  1250. application will not fit, Program Installer will place as much of the
  1251. application on the first disk as possible and then prompt for however
  1252. many disks are needed from that point on.
  1253.  
  1254.         Program Installer now allows you, the programmer, to also type
  1255. in full/complete lines that will be inserted into or appended into the
  1256. end-user's AUTOEXEC.BAT file. Previously you could only declare SET
  1257. variables to be inserted into the AUTOEXEC.BAT file.
  1258.  
  1259.      *** IMPORTANT ***       *** IMPORTANT ***       *** IMPORTANT ***
  1260.  
  1261.  
  1262.         Up to version 4.0, when the end-user was running INSTALL,
  1263. Program Installer, during the installation process, prompted the user
  1264. for the destination directory. With this release, Program Installer
  1265. assumes that the directory structure you built your installation
  1266. diskettes from is the same that you want to install to. If not, then you
  1267. will need to reconfigure, place all of the distribution files in the
  1268. directory structure the way you want the final product to turn out after
  1269. installation, and then re-build your distribution diskette(s).
  1270.  
  1271. 03/92
  1272.  
  1273.         We also fixed the problem that occurred when you declared say,
  1274. FILES=60 to be inserted into the CONFIG.SYS file. Program Installer 4.5
  1275. DOES properly determine if anything you are wanting to insert into the
  1276. CONFIG.SYS file is going to degrade the current configuration of the
  1277. CONFIG.SYS file, and if so, it won't insert your declarations.
  1278.  
  1279.  
  1280.