home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / tstngn.zip / DISK1.ZIP / qainst.inf (.txt) < prev    next >
OS/2 Help File  |  1995-03-02  |  88KB  |  345 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4. Test Engine/2 and Quality Assurance Manager/2 are supplied with the same 
  5. installation program that permits you to selectively install different 
  6. components of the package. The following possibilities exist: 
  7.  
  8.      o Install Test Engine/2 program 
  9.      o Install Programming tools 
  10.      o Install Quality Assurance Manager/2 base program 
  11.      o Install Quality Assurance Manager/2 report generator 
  12.      o Install Quality Assurance Manager/2 administration tools 
  13.      o Install Quality Assurance Manager/2 review management 
  14.      o Remove all components that were previously installed 
  15.      o Install the database for Quality Assurance Manager/2 
  16.      o Catalogue a remote database for Quality Assurance Manager/2 
  17.      o Catalogue a remote database server 
  18.      o Drop a pre-existing local database 
  19.  
  20.  Combinations of these installations are possible. However, you cannot both 
  21.  install program items and remove them and you cannot catalogue and install the 
  22.  database locally. 
  23.  
  24.  Note: 
  25.  You can only remove components if they have been previously installed using 
  26.  the installation program. 
  27.  
  28.  The installation program also allows you to create a response file for the 
  29.  selections you have made. This file can then be used for automatic 
  30.  installation with no user intervention. 
  31.  
  32.  Note: 
  33.  You can prepare as many response files as you want for different types of work 
  34.  station. 
  35.  
  36.  Installation may be carried out directly from the diskettes or over a network. 
  37.  
  38.  Note: 
  39.  If you have only purchased Test Engine/2, Those parts of the installation 
  40.  program relating to Quality Assurance Manager/2 will be disabled. 
  41.  
  42.  
  43. ΓòÉΓòÉΓòÉ 2. Installing from diskettes ΓòÉΓòÉΓòÉ
  44.  
  45. To install from diskettes, follow these steps: 
  46.  
  47.       1. Insert Diskette 1 (Install) into the diskette drive. 
  48.  
  49.       2. Type A:\INSTALL at a command prompt. The program will copy files onto 
  50.          your work station and start the installation program where A is the 
  51.          diskette drive letter. 
  52.  
  53.       3. Select the options you wish to install using the pages from the 
  54.          notebook. 
  55.  
  56.       4. Select the Install menu item to start the installation. 
  57.  
  58.       5. When the installation is complete, reboot the work station for changes 
  59.          in your configuration to take effect. 
  60.  
  61.  
  62. ΓòÉΓòÉΓòÉ 3. Installing from a Local Area Network ΓòÉΓòÉΓòÉ
  63.  
  64. The installation program may be run from a network directory. The installation 
  65. program will be copied to the local work station in the same way as when 
  66. installing from the diskettes. Before installing from the LAN, all the files 
  67. from the diskettes must be copied onto the server and the path to the 
  68. installation files must be known to the users. 
  69.  
  70. Once the files are present on the server, the procedure for installation is the 
  71. same as installing from diskettes: 
  72.  
  73.       1. Type X:\PATH\INSTALL at a command prompt. The program will copy files 
  74.          onto your work station and start the installation program 
  75.  
  76.          where 
  77.          X is the remote drive letter 
  78.          PATH is the path on that drive to the install files. 
  79.  
  80.       2. Select the options you wish to install using the pages from the 
  81.          notebook. 
  82.  
  83.       3. Select the Install menu item to start the installation. 
  84.  
  85.       4. When the installation is complete, reboot the work station for changes 
  86.          in your configuration to take effect. 
  87.  
  88.  
  89. ΓòÉΓòÉΓòÉ 4. Creating a Response File ΓòÉΓòÉΓòÉ
  90.  
  91. Response files will normally be used when installing over the LAN. These files 
  92. are created using the installation program and ensure that all the 
  93. installations on a LAN are compatible. 
  94.  
  95.       1. If you have already installed Test Engine/2 or Quality Assurance 
  96.          Manager/2 on your work station. 
  97.  
  98.           Type QAINST at a command prompt. 
  99.  
  100.         If you have not yet installed Test Engine/2 or Quality Assurance 
  101.         Manager/2 on your work station. 
  102.  
  103.           Type X:\PATH\INSTALL at a command prompt. 
  104.           The program will copy the necessary files onto your work station and 
  105.           start the installation program 
  106.  
  107.           where 
  108.           X is the remote drive letter 
  109.           PATH is the path on that drive to the install files. 
  110.  
  111.       2. Select the options you wish to install using the pages from the 
  112.          notebook. 
  113.  
  114.       3. Select the Create response file menu item. You will be asked for a 
  115.          file name (default extension RSP). 
  116.  
  117.       4. Enter the required file name and ensure that the file is in the same 
  118.          directory as the installation files. 
  119.  
  120.       5. The installation program will then create the required response file. 
  121.  
  122.  
  123. ΓòÉΓòÉΓòÉ 5. Installing with a response file ΓòÉΓòÉΓòÉ
  124.  
  125. To install Test Engine/2 or Quality Assurance Manager/2 using a response file: 
  126.  
  127.       1. Type X:\PATH\INSTALL respose_file_name at a command prompt. The 
  128.          program will copy files onto your work station and start the 
  129.          installation program 
  130.  
  131.          where 
  132.          X is the remote drive letter 
  133.          PATH is the path on that drive to the install files 
  134.          response_file_name is the name of the response file. 
  135.  
  136.  Warning: 
  137.  
  138.  The response file name MUST NOT INCLUDE THE PATH to the file. 
  139.  The response file MUST be in the same location as the install files. 
  140.  
  141.  When the installation is complete, reboot the work station for changes in your 
  142.  configuration to take effect. 
  143.  
  144.  Warning: 
  145.  
  146.  When installing with a response file, the installation is automatic and the 
  147.  user is given no opportunity to change the settings for the installation. 
  148.  
  149.  
  150. ΓòÉΓòÉΓòÉ 6. New files installed ΓòÉΓòÉΓòÉ
  151.  
  152. The new installation program will install itself into the OS2\INSTALL directory 
  153. and create a new folder on the desktop containing the program and book objects. 
  154.  
  155. The installation program also installs the runtime DLL for WATCOM VX-REXX 
  156. version 2.1c. If there is a previous of VX-REXX present on the work station, 
  157. vrobj.dll is replaced. This will not adversely effect the performance of a 
  158. previous VX-REXX version. If VX-REXX is not present, this DLL will be installed 
  159. in the System DLL directory. 
  160.  
  161. If any error occurs during the installation process, details can be seen by 
  162. viewing the file \os2\install\qainst.err. 
  163.  
  164. Warning: 
  165.  
  166. DO NOT DELETE ANY FILES NAMED QAINST.* FROM THE OS2\INSTALL DIRECTORY. 
  167.  
  168.  
  169. ΓòÉΓòÉΓòÉ 7. Installation Program ΓòÉΓòÉΓòÉ
  170.  
  171. The installation program is composed of a notebook containing three pages and a 
  172. menu. Each page allows you to determine specific aspects of your installation. 
  173.  
  174. If you do not view all the pages in the notebook, a warning is displayed. You 
  175. should always view all the pages to ensure that your installation will be 
  176. correct. 
  177.  
  178. During the installation phase a progress dialog is displayed (see the progress 
  179. dialog). 
  180.  
  181. Figure: Progress Dialog 
  182.  
  183. Figure: Install program menu 
  184.  
  185.  
  186. ΓòÉΓòÉΓòÉ 7.1. Program installation ΓòÉΓòÉΓòÉ
  187.  
  188. The first page of the notebook is shown below. Here you can choose which 
  189. program elements to install. Select the items you wish to install by checking 
  190. or unchecking the boxes. 
  191.  
  192. Figure: Program installation page 
  193.  
  194.  
  195. ΓòÉΓòÉΓòÉ 7.2. System configuration ΓòÉΓòÉΓòÉ
  196.  
  197. This page of the notebook gives you the option to control how the installation 
  198. program updates the desktop and the system files and where you want the 
  199. components of the programs installed. 
  200.  
  201. Note:  It is recommended that you allow the installation program to update the 
  202. CONFIG.SYS file for you. If not, you will have to add all the paths described 
  203. below to the CONFIG.SYS by hand. The installation program will always check to 
  204. ensure that duplicate paths do not exist. 
  205.  
  206. Folder 
  207. You may move the folder that the installation program creates, or its contents, 
  208. to another location after installation. However, if you move the contents then 
  209. the remove function cannot destroy the program objects automatically and you 
  210. will have to delete them manually. 
  211.  
  212. Source path 
  213. Do not modify the source path unless you are sure that the given path is 
  214. correct. When the install program is called as specified above, the system sets 
  215. this path and it will be correct. If you wish to install from somewhere else, 
  216. do not forget to add the trailing backslash to the path. 
  217.  
  218. Run files 
  219. This specifies the path where executable and command files will be stored. This 
  220. path will be added to the SET PATH= statement in the CONFIG.SYS file if you 
  221. allow update of the system configuration. 
  222.  
  223. Figure: System configuration page 
  224.  
  225. Lib files 
  226. This specifies where the *.lib files will be stored. This path will be added to 
  227. the SET LIB= statement in the CONFIG.SYS file if you allow update of the system 
  228. configuration. 
  229.  
  230. H files 
  231. This specifies where the header files will be stored. This path will be added 
  232. to the SET INCLUDE= statement in the CONFIG.SYS file if you allow update of the 
  233. system configuration. 
  234.  
  235. Help files 
  236. This specifies where the on-line help files will be stored. This path will be 
  237. added to the SET HELP= statement in the CONFIG.SYS file if you allow update of 
  238. the system configuration. 
  239.  
  240. Books 
  241. This specifies where the on-line books will be stored. This path will be added 
  242. to the SET BOOKSHELF= statement in the CONFIG.SYS file if you allow update of 
  243. the system configuration. 
  244.  
  245. DLL files 
  246. This specifies where the Dynamic Link Libraries will be stored. This path will 
  247. be added to the LIBPATH= statement in the CONFIG.SYS file if you allow update 
  248. of the system configuration. 
  249.  
  250. INI files 
  251. This specifies where the profiles and other data files will be stored. This 
  252. path will be added to the SET TSTNGEN= statement in the CONFIG.SYS file if you 
  253. allow update of the system configuration. 
  254.  
  255.  
  256. ΓòÉΓòÉΓòÉ 7.3. Database installation ΓòÉΓòÉΓòÉ
  257.  
  258. The third page of the dialog is used for installing the Quality Assurance 
  259. Manager/2 database. There are two mutually exclusive options: 
  260.  
  261.      o Install the database locally 
  262.      o Catalogue a remote database 
  263.  
  264.  In the second case you are also given the opportunity of cataloguing the 
  265.  remote database server. 
  266.  
  267.  Note:  You can only catalogue a remote database server that communicates via 
  268.  Net BIOS. APPN and APPC nodes will have to be catalogued using the Database 
  269.  Manager. 
  270.  
  271.  Usually you will use the install program to install the database locally on a 
  272.  database server and all other nodes will catalogue the database and the 
  273.  server. 
  274.  
  275.  Figure: Database installation page 
  276.  
  277.  Local database 
  278.  The install program gives you the option of creating or dropping a local 
  279.  database. The database name is a constant and cannot be changed. You can also 
  280.  choose which local drive the database will be installed on. 
  281.  
  282.  Note:  Only local drives are made available for installing the database as 
  283.  sharing of a remote database by standalone DB2 stations will lead to 
  284.  inconsistencies in the data. 
  285.  
  286.  Warning: 
  287.  
  288.  If you drop an existing database, all the data will be lost. Back up your 
  289.  database before dropping. 
  290.  
  291.  Remote Database 
  292.  The remote database name is a constant and cannot be changed. 
  293.  The DB server drop down combo box contains a list of the catalogued servers 
  294.  for the work station. If you select an existing server, the Catalog Node check 
  295.  box will be disabled. If you enter a new name, this server will be catalogued 
  296.  on your work station. 
  297.  
  298.  
  299. ΓòÉΓòÉΓòÉ 8. Notes for users upgrading from a previous beta version ΓòÉΓòÉΓòÉ
  300.  
  301. The following sections supply information important for clients upgrading from 
  302. a previous beta version of Test Engine/2 
  303.  
  304. Installation 
  305.  
  306. Previous beta versions of Test Engine/2 were not supplied with the same 
  307. installation program and the previous installation will not be recognised by 
  308. qainst.exe 
  309.  
  310. Note:  It is recommended that users delete any previous version manually using 
  311. the xdel program before installing this version. 
  312.  
  313. Script files 
  314.  
  315. This production version of Test Engine/2 requires a modification of any old 
  316. script files as these must now contain commands (see Test Engine/2 Programming 
  317. Reference). To automate this, a command file is included on the diskettes that 
  318. will insert the necessary modifications into your existing scripts. You MUST 
  319. run all your scripts through this program before using them with the new Test 
  320. Engine/2. 
  321.  
  322. To run the modification program type the following at a command prompt: 
  323.  
  324.      SPTMOD <script_file> 
  325.  
  326.      or drag the script file object onto the SPTMOD icon. 
  327.  
  328.  If you have many scripts it would be a good idea to create a batch file to 
  329.  convert them. 
  330.  
  331.  Example 
  332.  
  333.   /** REXX batch for converting scripts with the same extension ***/
  334.  
  335.   if RxFuncQuery( 'SysFileTree') <> 0 then
  336.       call RxFuncAdd 'SysFileTree', 'REXXUTIL', 'SysFileTree'
  337.  
  338.   call SysFileTree 'C:\*.spt', 'file.', 'FSO'
  339.  
  340.   do i = 1 to file.0
  341.       address cmd 'sptmod' file.i
  342.   end
  343.  
  344.   exit
  345.