home *** CD-ROM | disk | FTP | other *** search
/ Microsoftware Monthly 19…2 Programming Power Tools / MASO9512.ISO / readme / laninst.txt < prev    next >
Encoding:
Text File  |  1995-10-24  |  15.7 KB  |  510 lines
  1. How to Install VisualAge and IBM Smalltalk from a LAN Server
  2. ____________________________________________________________
  3.  
  4.  
  5. If you have a license to install VisualAge or IBM Smalltalk on
  6. several workstations, you can install it without using this CD.
  7.  
  8. Follow these steps:
  9.  
  10.   o From CD Showcase, select the product you want to install, go
  11.     to the Install page, and press the 'Copy' button.  Fill in
  12.     the target directory to where you want to copy the product.
  13.  
  14.   o Switch to the directory where you copied the product
  15.   o Install VisualAge or IBM Smalltalk by typing 'install' at the
  16.     command prompt and pressing Enter.
  17.  
  18.  
  19. How to Create a Response File
  20. _____________________________
  21.  
  22. Response files are used to provide data that is normally entered
  23. manually when VisualAge or IBM Smalltalk is installed.  Each
  24. product provides its own sample response file tailored to its
  25. product configuration.  In the top level directory of each product,
  26. there will be a sample response file with the extension '.RSP'.
  27.  
  28. NOTE: A problem was discovered with the VisualAge and IBM 
  29. Smalltalk response files which may cause components listed
  30. in the response file to not be installed.  In order to fix this error,
  31. edit the package file being installed.  Search for the COMPONENT
  32. entries, and make sure there are no trailing blanks in the NAME=
  33. statement.  After saving these changes, the install should run
  34. correctly.
  35.  
  36. Response File Format and Keywords
  37.  
  38. This product supports the following keywords:
  39.  
  40. CFGUPDATE (required)
  41. Specifies whether the CONFIG.SYS file is automatically updated.
  42. Valid values for this keyword are:
  43.  
  44.          AUTO             Automatically updates CONFIG.SYS (default)
  45.          MANUAL           Does not update CONFIG.SYS
  46.  
  47.  
  48. COMP
  49. Specifies the unique name of a component of the product for which
  50. passed information applies. There can be a maximum of 100
  51. components. The COMP value must match the NAME keyword of the
  52. COMPONENT entry in the package file. NOTE: Do not use quotes
  53. around the component name, even when the name is more than one
  54. word with blanks between words.
  55.  
  56.  
  57. DELETEBACKUP (required)
  58. Specifies whether to delete only the backup versions of the
  59. product or to delete the entire product.
  60. Valid values for this keyword are YES and NO.
  61. It is required because an existing
  62. dialog requests this information in the attended mode.
  63.  
  64. If an unattended delete is attempted
  65. and the DELETEBACKUP is not present in the response file, the
  66. deletion fails with an EPFIE212 error.
  67.  
  68.  
  69. FILE (conditionally required)
  70. Provides the new default path for the file directory.
  71. This keyword is used only for installation processing.
  72.  
  73. This FILE value is used in place of the FILE keyword of the PATH
  74. entry in the package file. This keyword is required if you have
  75. specified a FILE keyword in the PATH entry.
  76.  
  77.  
  78. OVERWRITE (required)
  79. Specifies whether to automatically overwrite files during
  80. installation.  Valid values for this keyword are YES and NO.
  81. This keyword is required for unattended processing.
  82.  
  83.  
  84. SAVEBACKUP (required)
  85. Specifies whether to save a backup version of the product when it
  86. is updated.  Valid values for this keyword are YES and NO. It is
  87. required for unattended processing because an existing dialog
  88. requests this information in the attended mode.
  89.  
  90.  
  91. ABTAIXSERVER (optional)
  92. Specifies whether the server for a VisualAge or IBM Smalltalk
  93. client is an AIX server or an OS/2 or Windows server.  Valid
  94. values are YES and NO.  If not specified, the default is NO.
  95.  
  96.  
  97. ABTSERVERDIR (optional)
  98. For an OS/2 server, specifies the drive and path where the
  99. VisualAge or IBM Smalltalk server is installed, as accessed by
  100. the installing client.  Defaults to S:\VISUALAG.
  101.  
  102. For an AIX server, this parameter is ignored, since the only valid
  103. value is /usr/visualage.
  104.  
  105.  
  106. ABTIPADDR (required when ABTAIXSERVER=YES)
  107. For an AIX server, specifies the host name or IP address of the
  108. server.
  109.  
  110. For an OS/2 server, this parameter is ignored.
  111.  
  112.  
  113. Response File Details
  114. ___________________________
  115.  
  116. A response file is a flat ASCII file that consists of a series of
  117. lines separated by newline sequences (0x0A, 0x0D, or a
  118. combination of these two sequences).
  119.  
  120. Each line in a response file has a maximum line length of 255 bytes.
  121.  
  122. A response file has two kinds of lines:
  123.  
  124.  Comment lines:  which contain only white space characters
  125.                  or have either an asterisk (*) or a semicolon (;)
  126.                  as the first nonwhite space character on the line.
  127.  Response lines: which are used by Software Installer
  128.                  to determine the options and configurations to
  129.                  install on the target system.
  130.  
  131. Response lines have the following syntax:
  132.  
  133. keyword = value
  134.  
  135. -  Keywords cannot contain imbedded spaces.
  136. -  Keywords are not case-sensitive.
  137. -  You can group keywords together
  138.      in value lists using the following syntax:
  139.  
  140. keyword = (
  141.            keyword1 = value
  142.            keyword2 = value
  143.            .
  144.            .
  145.            keywordn = value
  146.           )
  147.  
  148.  
  149. Using Command Line Parameters
  150. _____________________________
  151.  
  152. If no parameters are specified when the executable file is
  153. started, the installation is attended. To install in an
  154. unattended mode, the /X parameter must be used. Unattended
  155. includes what is sometimes referred to as lightly attended. In
  156. the lightly attended mode, someone might have to start an
  157. executable file or insert diskettes.  Each product directory
  158. includes sample command files for unattended installaton and
  159. deletion of the product.  Look at CIDINST.CMD or .BAT and
  160. CIDDLT.CMD or .BAT.  BEFORE USING THESE COMMAND FILES, YOU MUST
  161. EDIT THEM AND SPECIFY FULL PATHS FOR THE /L1, /L2, AND /R:
  162. PARAMETERS.
  163.  
  164. If the value of any of the parameters contains spaces,
  165. use double quotes to enclose the value.
  166.  
  167. Values can be upper or lower case.
  168. Parameters can be in any order.
  169.  
  170. <command> /A:<action>
  171.           /C:<catalog file name>
  172.           /G:<include path>
  173.           /L:<xpos,ypos>
  174.           /L1:<error log>
  175.           /L2:<history log>
  176.           /L3:<log file>
  177.           /L4:<log file>
  178.           /L5:<log file>
  179.           /O:<originating system>
  180.           /P:<product name>
  181.           /R:<response file>
  182.           /S:<source location>
  183.           /T:<install target directory>
  184.           /TU:<update CONFIG.SYS directory>
  185.           /X  <interactive_flag>
  186.  
  187.  
  188. The /A, /C, and /P parameters are required for an installation
  189. that is started with the EPFINSTS command.
  190. If the action is an install or an update, the /O is also required.
  191.  
  192. The /A, /C, /L, /O, /P, /R, and /S parameters override default values
  193. built into the product install.
  194.  
  195. Note: The drive/directory/filename path is required for all log
  196. parameters specified with the INSTALL.EXE or EPFIDLDS.EXE
  197. commands. The directories for log files must exist before
  198. starting the commands.
  199.  
  200.  
  201. Parameter Definitions
  202. _______________________
  203.  
  204. The command prompt parameters supported by these
  205. products are:
  206.  
  207. /A:<action>
  208.  
  209. Specifies the action of the EPFINSTS.EXE. If you use this
  210. parameter, the main window of the installation is not displayed.
  211. If you do not use this parameter, the installation starts
  212. normally with all windows displayed. Valid values for this
  213. parameter are:
  214.  
  215.      'D'  For delete
  216.      'I'  For install
  217.      'R'  For restore
  218.      'U'  For update
  219.  
  220. The installation program sets the EPFIACTION installation
  221. variable to the action.
  222.  
  223.  
  224. /L1:<error log>
  225.  
  226. Specifies the drive, path, and file name of the error log file.
  227. The installation program sets the EPFIERRORLOG installation
  228. variable to the name of the error log.
  229.  
  230. The drive/directory/filename path is required.
  231. The directory for the log file must already exist.
  232.  
  233. All lines logged to the error file are prefixed with a time
  234. stamp. The time stamp has the following format:
  235.  
  236.      YYYY-MM-DD HH:mm:SS:cc
  237.  
  238. Where:
  239.  
  240.  YYYY is the year.
  241.  MM   is the month.
  242.  DD   is the day.
  243.  HH   is the hour.
  244.  mm   is the minute.
  245.  SS   is the second.
  246.  cc   is the hundredth of a second.
  247.  
  248. The date and time separators are the current user-defined
  249. settings in the Country object of the System Settings folder. The
  250. default separators are the hyphen and the colon, respectively.
  251.  
  252. Example of using the /L1 parameter to create ERROR.LOG file in
  253. the C:\ABC\ directory:
  254.  
  255.    /L1:C:\ABC\ERROR.LOG
  256.  
  257.  
  258. /L2:<history log>
  259.  
  260. Specifies the drive, path, and file name of the history log file.
  261. The installation program sets the EPFIHISTORYLOG installation
  262. variable to the name of the history log.
  263.  
  264. The drive/directory/filename path is required.
  265. The directory for the log file must already exist.
  266.  
  267. If this parameter is not specified, no history log is maintained.
  268.  
  269. All lines logged to the history file are prefixed with a time
  270. stamp. The time stamp has the following format:
  271.  
  272. YYYY-MM-DD HH:mm:SS:cc
  273.  
  274. Where:
  275.  
  276.  YYYY is the year.
  277.  MM   is the month.
  278.  DD   is the day.
  279.  HH   is the hour.
  280.  mm   is the minute.
  281.  SS   is the second.
  282.  cc   is the hundredth of a second.
  283.  
  284. The date and time separators are the current user-defined
  285. settings in the Country object of the System Settings folder. The
  286. default separators  are the hyphen and the colon, respectively.
  287. Example of using the /L2 parameter to create HISTORY.LOG file in
  288. the C:\ABC\ directory:
  289.  
  290.    /L2:C:\ABC\HISTORY.LOG
  291.  
  292.  
  293. /P:<product name>
  294.  
  295. Provides the name of the product for the specified action.
  296.  
  297. If you do not use this parameter, the installation
  298. comes up normally with all windows displayed.
  299.  
  300. The <product name> should match the value of the NAME keyword of
  301. the PACKAGE entry in the catalog file. If your product name
  302. string includes any spaces, use double quotes around the string.
  303. For example:
  304.  
  305.    /p:"product name with spaces"
  306.  
  307. The installation program sets the EPFIPRODUCT installation
  308. variable to the name of the product.
  309.  
  310.  
  311. /R:<response file>
  312.  
  313. Specifies the drive, path, and file name
  314. of the specific response file.
  315.  
  316. The following search order is used to find the response files.
  317.  
  318.   1. The fully-qualified file specification
  319.  
  320.   2. The current directory.
  321.  
  322.         The current directory is the temporary directory
  323.         where epfinsts.exe is running. The response file
  324.         can be placed in the current directory by packing
  325.         it in INSTALL.IN_.
  326.  
  327.   3.The file name together with the /G: invocation parameter
  328.  
  329.   4.Each directory in the PATH environment variable
  330.  
  331.   5.Each directory in the DPATH environment variable
  332.  
  333. The installation program sets the EPFIRESPFILE installation
  334. variable to the response file.
  335.  
  336. Example:
  337.  
  338.    /R:L:\XYZ\RESPONSE.DAT
  339.  
  340.  
  341. /S:<source_location>
  342.  
  343. Specifies the drive and path that contains the source files to
  344. install. The installation program sets the EPFISOURCEDIR
  345. installation variable to the source_location. Specifying this
  346. parameter overrides the value of the HOSTLOC keyword in the
  347. product's catalog file PACKAGE entry. If this parameter is not
  348. specified, the value of the HOSTLOC keyword is not overridden.
  349.  
  350. Example:
  351.  
  352.    /S:L:\XYZ
  353.  
  354.  
  355. /T:<install target directory>
  356.  
  357. Specifies the drive and path where the product files are
  358. installed. This parameter only affects the value of the FILE
  359. directory (directory corresponding to the FILELABEL keyword). If
  360. this parameter is specified, it overrides the FILE paths that are
  361. specified in the response files and the package files. The
  362. installation program sets the EPFITARGETDIR installation variable
  363. to the install target directory.
  364.  
  365. Example:
  366.  
  367.  
  368.    /T:C:\IBB
  369.  
  370.  
  371. /TU:<update target CONFIG.SYS directory>
  372.  
  373. Specifies the drive and path of the target CONFIG.SYS to be
  374. updated. The installation program sets the EPFITARGETCNF
  375. installation variable to the update CONFIG.SYS target directory.
  376. If this parameter is not specified, the CONFIG.SYS files are
  377. updated as specified in the product's package file.
  378.  
  379. Example:
  380.  
  381.    /TU:C:\
  382.  
  383.  
  384. /X
  385.  
  386. Specifies that the action is unattended. If you do not specify
  387. all of the information needed for the action to complete, an
  388. error occurs. When you specify the /X option, no progress
  389. indication is shown and all error messages are logged to the
  390. error file you specified using the /L1 parameter.
  391.  
  392. If you do not specify this option, the user is prompted for any
  393. information that the EPFINSTS.EXE needs to complete the action.
  394. In this attended mode of action, progress indication is shown and
  395. error messages are displayed to the user in secondary windows.
  396. The  installation program sets the EPFINONINTERACT installation
  397. variable to YES if the /X parameter is specified.
  398.  
  399.  
  400. Unsupported parameters
  401. _________________________
  402.  
  403. The following parameters are available on the Install command,
  404. but they are not supported for these products.
  405.  
  406. /C:<catalog file name>
  407.  
  408. Specifies the name and location of the catalog file that
  409. you want to be opened automatically.
  410.  
  411. If the catalog file is located on a host session, the host
  412. session ID must precede the catalog file name.  If the catalog
  413. file is located on a drive, a drive and directory must precede
  414. the catalog file name. The installation program sets the
  415. EPFICATALOG installation variable to the name of the catalog
  416. file.
  417.  
  418. The following examples show how to use
  419. this parameter for each installation source.
  420.  
  421.     For Drive:  /C:A:\DISK1.ICF
  422.     For MVS:    /C:B:EPF.V1R2M0.SEPFBENU(EPFICAT)
  423.     For VM:     /C:"B:EPFICAT ENUEPF12 *"
  424.     For VSE:    /C:B:LIB.SUBLIB.MEMBERNAME.MEMBERTYPE
  425.  
  426. If only the host session ID is specified, for example, B:, the
  427. Open catalog window is displayed with B: as the default session
  428. or drive.
  429.  
  430.  
  431. /G:<include path>
  432.  
  433. Specifies the drive and directory of the general response files
  434. that are included by the specific response file. The installation
  435. program sets the EPFIGENRESPDIR installation variable to the
  436. included path. Example:
  437.  
  438.    /G:L:\XYZ
  439.  
  440.  
  441. /L:<xpos,ypos>
  442.  
  443. Specifies the initial horizontal and vertical coordinates of the
  444. initial installation window on the Workplace Shell relative to
  445. the lower-left corner of the screen. If this parameter is
  446. specified, all previously saved default positions are overridden.
  447. The installation program sets the EPFIWNDCOORDS installation
  448. variable to the coordinates of the Installation and Maintenance
  449. window.
  450.  
  451.  
  452. /L3:  /L4:  /L5:<log files>
  453.  
  454. Each of these parameters specifies a drive, path, and file name
  455. of a log file. They are saved in installation variables
  456. EPFIL3LOG, EPFIL4LOG, and EPFIL5LOG for your use.
  457.  
  458. The drive/directory/filename path is required.
  459. The directories for the log files must already exist.
  460.  
  461. /O:<originating system>
  462.  
  463. Specifies the originating system of the installation.
  464. Valid values are:
  465.  
  466.     DRIVE
  467.     MVS
  468.     VM
  469.     VSE
  470.  
  471. The installation program sets the EPFISOURCE installation
  472. variable to one of these values.
  473.  
  474.  
  475. Return Codes from VisualAge or IBM Smalltalk to a Controller
  476. ____________________________________________________________
  477.  
  478. VisualAge and IBM Smalltalk returns the following return codes to
  479. a software distribution manager (SDM):
  480.  
  481.   o Successful installation.
  482.  
  483.         00 00    No messages were logged.
  484.  
  485.   o Successful installation.
  486.  
  487.     The workstation operating system will be restarted.
  488.     Do not call Software Installer again.
  489.  
  490.          FE 00      No messages.
  491.          FE 04      Warning messages were logged.
  492.          FE 08      Error messages were logged.
  493.          FE 12      Severe error messages were logged.
  494.  
  495.   o Successful installation.
  496.  
  497.     Restarting the workstation operating system occurs.
  498.     Start the installation again. Change yy to the code your
  499.     product uses and define its meaning.
  500.  
  501.          FF yy      yy can vary from 00 to FF.
  502.  
  503.   o Unexpected condition encountered during installation.
  504.  
  505.          16 00      Incorrect invocation of installation program
  506.          16 04      Messages were logged.
  507.  
  508. All return codes are two-byte hexadecimal values.
  509.  
  510.