home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: SysTools / SysTools.zip / um51demo.exe / SHSINST.HLP (.txt) < prev    next >
OS/2 Help File  |  1999-10-07  |  13KB  |  342 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. General Help ΓòÉΓòÉΓòÉ
  3.  
  4. About InstallStar 
  5.  
  6. Prior to InstallStar, the install program used to install FileStar/2 and 
  7. UniMaint was GTINST by GammaTech, Inc. Although GTINST may still be used to 
  8. install the programs, you should use InstallStar for installation of either of 
  9. these programs. The compatibility of GTINST will disappear with the next major 
  10. version release. The InstallStar executable file is name 'SHSINST.EXE'. It is a 
  11. derivitive of GTINST. When compared to GTINST, InstallStar has a new user 
  12. interface as well as new capabilities to deregister the AcsAgent class and 
  13. close open windows that may interfere with a normal installation. 
  14.  
  15. If you encounter problems using InstallStar, you should try GTINST as a backup 
  16. installer. If GTINST works and InstallStar does not, please report the details 
  17. to SHS. 
  18.  
  19. Note: The old GTINST install program will not install a CSD that changes the 
  20. minor version number, i.e. v5.0 to v5.1. You must use SHSINST to install such a 
  21. CSD. 
  22.  
  23. InstallStar Help 
  24.  
  25. Please note that on some dialogs you will see (F1) included in the group box 
  26. title of the dialog. This signifies that there is more information available by 
  27. pressing the F1 key. Most dialogs do have help available by pressing F1 and the 
  28. absence of the (F1) does not necessarily indicate that there is no help 
  29. available for that dialog. 
  30.  
  31. Starting InstallStar 
  32.  
  33. InstallStar may be started from its object in the program WPS folder or the 
  34. command line. When installing a CSD, it does not require a command line 
  35. parameter like its predecessor GTINST, but still supports passing the source 
  36. path to the installable *.csd file during startup. The following command line 
  37. would start SHSINST with the source directory and file as a passed parameter; 
  38.  
  39. SHSINST X:\MyApps\UniMaint\U5xxxxxx.CSD 
  40.  
  41. If a command line parameter is not passed on startup, as would be the case when 
  42. starting from the WPS folder object, a 'Source Directory' dialog will be 
  43. displayed. Pressing the dialog 'Browse' button will display a File Dialog to 
  44. use to browse for and select the appropriate '.001' or '.CSD' file. You may 
  45. also manually enter the appropriate path\filename if its exact name and 
  46. location is known. 
  47.  
  48. The install program then determines which files to install based on the system 
  49. configuration and the content of the compressed *.001 or *.csd file. It creates 
  50. the installation files from the compressed files on the distribution diskette 
  51. or CD. 
  52.  
  53. Install Controls 
  54.  
  55. Located along the bottom of the main window are 8 pushbuttons used to control 
  56. the installation. These buttons are: 
  57.  
  58.       License 
  59.       Readme 
  60.       Install 
  61.       Uninstall 
  62.       Folder 
  63.       Help 
  64.       About 
  65.       Exit 
  66.  
  67.  To enable the installation, the License must be read first. Press the 
  68.  'License' button at the bottom left of the InstallStar window to display the 
  69.  license. Press it again (or press any other button) to hide the license. 
  70.  
  71.  The README.TXT (or README.1ST if this is a base installation) file may be read 
  72.  before installation by pressing the 'Readme' button at the bottom of the 
  73.  InstallStar window. To hide the readme file, press the 'Readme' button again 
  74.  or press any other button. The README.TXT file will be available for your 
  75.  review in the target installation directory after installation. You may review 
  76.  this file after installation with a text editor or print the file from an OS/2 
  77.  command prompt by typing: 
  78.  
  79.  TYPE README.TXT >LPT1. 
  80.  
  81.  This file generally contains information which was not available when the 
  82.  program documentation was prepared or describes the changes made in a CSD. 
  83.  
  84.  Modifying the CONFIG.SYS File 
  85.  
  86.  Install can appropriately modify the CONFIG.SYS file (it will query during 
  87.  install if it should update the file) or you may make any changes required to 
  88.  CONFIG.SYS manually. If changes are made, you must reboot the computer to 
  89.  activate those changes. Changes to the libpath, path and help statements are 
  90.  made in a UniMaint installation. A FileStar/2 installation does not require 
  91.  any changes. 
  92.  
  93.  
  94. ΓòÉΓòÉΓòÉ 2. Panel buttons ΓòÉΓòÉΓòÉ
  95.  
  96. This is the description of the main window buttons. 
  97.  
  98.  
  99. ΓòÉΓòÉΓòÉ 2.1. License ΓòÉΓòÉΓòÉ
  100.  
  101. The License pushbutton is used to toggle viewing of the software license. This 
  102. button must be pushed at least once to enable the Install and Folder 
  103. pushbuttons, which is required to start program installation. 
  104.  
  105.  
  106. ΓòÉΓòÉΓòÉ 2.2. Read Me ΓòÉΓòÉΓòÉ
  107.  
  108. The Read Me pushbutton toggles the viewing of the README.1ST file for 
  109. installation of a '001' file (base install) or the README.TXT file when 
  110. applying of a CSD. 
  111.  
  112.  
  113. ΓòÉΓòÉΓòÉ 2.3. Install ΓòÉΓòÉΓòÉ
  114.  
  115.  Pushing this button begins the installation process of the base product or 
  116.  CSD. During installation you will be prompted for: 
  117.  
  118.        The target drive and path to be used for this installation. 
  119.        The updating of the CONFIG.SYS file. 
  120.        The creation/update of the a desktop folder. 
  121.  
  122.  The installation consists of building various directories and files on your 
  123.  hard disk, updating the CONFIG.SYS file, and updating the OS/2 desktop. 
  124.  
  125.  
  126. ΓòÉΓòÉΓòÉ 2.4. Uninstall ΓòÉΓòÉΓòÉ
  127.  
  128. The Uninstall pushbutton is currently not available for its intended use. 
  129.  
  130.  
  131. ΓòÉΓòÉΓòÉ 2.5. Folder ΓòÉΓòÉΓòÉ
  132.  
  133.  Pushing this button recreates the product desktop folder. This is useful if 
  134.  your folder or program objects for the product have become damaged or "lost". 
  135.  You will be prompted for: 
  136.  
  137.        The drive and path where the product is installed. 
  138.        Permission to update the desktop folder. 
  139.  
  140.  
  141. ΓòÉΓòÉΓòÉ 2.6. Help ΓòÉΓòÉΓòÉ
  142.  
  143. About InstallStar 
  144.  
  145. Although GTINST will install the programs UniMaint and FileStar/2, you should 
  146. use the InstallStar install program for installation of either of these 
  147. programs. The compatibility of GTINST will disappear with the next major 
  148. version release. The InstallStar executable file is name 'SHSINST.EXE'. 
  149.  
  150. Starting InstallStar 
  151.  
  152. InstallStar may be started from the its desktop object in the UniTools WPS 
  153. folder or the command line. When installing a CSD, it does not require a 
  154. command line parameter like it's predecessor GTINST, but still does support 
  155. passing the source path to the installable *.csd file during startup. If this 
  156. path is not passed, as would be the case when starting from the WPS folder 
  157. object, a 'Source Directory' dialog will appear on startup and may be used to 
  158. either 'browse' for the installation file. The path/filename to the file may 
  159. also be manually entered in the dialog field. 
  160.  
  161. The following command line would start SHSINST with the source directory and 
  162. file as a passed parameter; 
  163.  
  164. SHSINST X:\MyApps\UniMaint\U5xxxxxx.CSD 
  165.  
  166. You can also start with only the program name; 
  167.  
  168. SHSINST 
  169.  
  170. This will start the install program and display a dialog to use to 'browse' for 
  171. the either the '.001' or '.CSD' files. 
  172.  
  173. The install program then determines which files to install based on the system 
  174. configuration and the content of the compressed *.001 or *.csd file. It creates 
  175. the installation files from the compressed files on the distribution diskette 
  176. or CD. 
  177.  
  178. To enable the installation, the License must be read. Press the 'License' 
  179. button at the bottom left of the NewStar window to display the license. Press 
  180. it again (or press any other button) to hide the license. 
  181.  
  182. The README.TXT (or README.1ST) file may be read before installation by pressing 
  183. the 'Readme' button at the bottom of the InstallStar window. To hide the readme 
  184. file, press the 'Readme' button again or press any other button. The README.TXT 
  185. file will be available for your review in the target installation directory 
  186. after installation. You may review this file after installation with a text 
  187. editor or print the file from an OS/2 command prompt by typing: 
  188.  
  189.    TYPE README.TXT >LPT1. 
  190.  
  191. This file generally contain information which was not available when the 
  192. program documentation was prepared or describes the changes made in a CSD. 
  193. Modifying the CONFIG.SYS File 
  194.  
  195. Install can altered the CONFIG.SYS file (it will query during install if it 
  196. should update the file) or you may make any changes required to CONFIG.SYS 
  197. manually. If changes are made, you must reboot the computer to activate those 
  198. changes. Changes to the libpath, path and help statements are made in a 
  199. UniMaint installation. A FileStar/2 installation does not require any changes. 
  200.  
  201.  
  202. ΓòÉΓòÉΓòÉ 2.7. About ΓòÉΓòÉΓòÉ
  203.  
  204. The About pushbutton displays the installation program About box. The About box 
  205. shows the program version number and where/how to contact the company for 
  206. support. 
  207.  
  208.  
  209. ΓòÉΓòÉΓòÉ 2.8. Exit ΓòÉΓòÉΓòÉ
  210.  
  211. The Exit pushbutton terminates the install program.  You may also terminate the 
  212. install program by pressing the Alt-F4 keys or the titlebar close button. 
  213.  
  214.  
  215. ΓòÉΓòÉΓòÉ 3. Source File Selection ΓòÉΓòÉΓòÉ
  216.  
  217. The Source File Selection Dialog window may be used to 'browse and select' or 
  218. enter manually the path and filename of the installation source file. These 
  219. files have an extension of '001' for original installation or 'CSD' for program 
  220. updates. 
  221.  
  222.  Pressing the Browse button actives the OS/2 File Dialog. Use it to locate the 
  223. desired file. Then double click the file or press Ok to enter the path/filename 
  224. in the entry field. 
  225.  
  226.  
  227. ΓòÉΓòÉΓòÉ 3.1. Source Entry Field ΓòÉΓòÉΓòÉ
  228.  
  229. Enter the full path and filename to the source compressed file. If this is a 
  230. base install, the file has an extension of '001'. If is a CSD, the extension 
  231. will be 'CSD'. 
  232.  
  233.  
  234. ΓòÉΓòÉΓòÉ 3.2. Browse ΓòÉΓòÉΓòÉ
  235.  
  236. The dialog Browse pushbutton is used to open the File Dialog which may then 
  237. used to select the source file. 
  238.  
  239.  
  240. ΓòÉΓòÉΓòÉ 4. Target Directory Selection ΓòÉΓòÉΓòÉ
  241.  
  242. The Target Directory Selection dialog window must be used to enter the path of 
  243. the installation target directory. 
  244.  
  245.  Pressing the Browse button actives a Select Target Directory Dialog. Use it to 
  246. select the desired target directory. Either double click a directory or press 
  247. Ok to enter the path in the entry field. 
  248.  
  249.  
  250. ΓòÉΓòÉΓòÉ 4.1. Target Entry Field ΓòÉΓòÉΓòÉ
  251.  
  252. Enter the target directory in the entry field. The target directory is the 
  253. directory that you want to install the program in. 
  254.  
  255.  
  256. ΓòÉΓòÉΓòÉ 5. Base Level Invalid ΓòÉΓòÉΓòÉ
  257.  
  258. The Base Level Invalid dialog window will appear whenever you are attempting to 
  259. install a CSD with a a major version that is different than the current major 
  260. version. The major version number is the first digit in the version number. 
  261. CSDs are not compatible between major versions. 
  262.  
  263.  
  264. ΓòÉΓòÉΓòÉ 6. Version Advisory ΓòÉΓòÉΓòÉ
  265.  
  266. The Version Advisory dialog will appear whenever you are installing a version 
  267. that is the same or older than the current version. You may elect to continue 
  268. or cancel the installation by pushing the appropriate button. 
  269.  
  270.  
  271. ΓòÉΓòÉΓòÉ 7. Config.Sys Update Query ΓòÉΓòÉΓòÉ
  272.  
  273. The Config.Sys Update dialog window is a query to determine whether the user or 
  274. the installation program will update the config.sys configuration file. 
  275.  
  276. In some situations UniMaint may require that its directory be included in the 
  277. LIBPATH, PATH and/or HELP statements. If you elect to let the install program 
  278. make the changes, the UniMaint directory path is added to the LIBPATH, PATH and 
  279. HELP statements in a UniMaint installation. You may elect to do this manually 
  280. at a later time. 
  281.  
  282.  A FileStar/2 installation does not require any changes. 
  283.  
  284.  
  285. ΓòÉΓòÉΓòÉ 8. Desktop Update Query ΓòÉΓòÉΓòÉ
  286.  
  287. If you elect to update the Desktop folder, the application folder (UniTools or 
  288. FileStar/2, as applicable) will be re-created to that of a base level 
  289. installation. 
  290.  
  291.  
  292. ΓòÉΓòÉΓòÉ 9. Security Password ΓòÉΓòÉΓòÉ
  293.  
  294. The Security Password dialog window appears whenever the installation program 
  295. has been configued to require a password. You have no control other than to 
  296. enter a valid password in the entry field. 
  297.  
  298.  
  299. ΓòÉΓòÉΓòÉ 9.1. Password Entry Field ΓòÉΓòÉΓòÉ
  300.  
  301. Enter a valid password in the entry field to continue. 
  302.  
  303.  
  304. ΓòÉΓòÉΓòÉ 10. Installation Failure ΓòÉΓòÉΓòÉ
  305.  
  306. The Installation Failure dialog window appears whenever an fatal error occurs 
  307. that will cause the installation to abort. There are three message fields in 
  308. the dialog. With some failures all three fields may contain messages relating 
  309. to the failure. The installation aborts whenever Cancel is pressed. 
  310.  
  311. If installing UniMaint and you get the error; 
  312.  
  313.       Error opening Output file X:\PATH\UNIMTAPI.DLL - OPEN FAILED 
  314.  
  315.  the file indicated (UNIMTAPI.DLL) is open and cannot be replaced while open. 
  316.  Once UniMaint is installed, this file is opened at boot time by the WPS. The 
  317.  solution is; 
  318.  
  319.        - Close any UniMaint related windows (like UniWatch or function dialogs) 
  320.       that are open. 
  321.  
  322.       - From the UniMaint directory, run ASCDEREG from the command line or 
  323.       double click the file to run it. This will de-register the ACSAGENT WPS 
  324.       class and close the file. 
  325.  
  326.       - As an alternative to running the ACSDEREG command, you may run ACSTEST 
  327.       /Z, also from a command line. This program does considerable testing on 
  328.       UniMaint and at the end of its tests, it de-registers the ASCAGENT class. 
  329.  
  330.       - Close the Error dialog and continue the installation by pressing 
  331.       'Install' again. 
  332.  
  333.  Failure to open other files in the compressed installation file may be caused 
  334.  by a corrupted file. 
  335.  
  336.  
  337. ΓòÉΓòÉΓòÉ 11. Product Information ΓòÉΓòÉΓòÉ
  338.  
  339. The InstallStar installation program will install SHS products. Currently those 
  340. products are UniMaint and FileStar/2. The about box has the InstallStar version 
  341. number shown and lists how to contact the company for technical support.  Press 
  342. the SHS icon to close the About dialog window.