home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / netdor4.zip / NDWINST / READMEW.1ST < prev    next >
Text File  |  1996-04-04  |  25KB  |  661 lines
  1.  
  2. *************************************************************************
  3. *           Welcome to NetDoor for Windows release 1.0                  *
  4. *************************************************************************
  5.  
  6. *************************************************************************
  7. * This level of code is equivalent to NetDoor CSD level IP20073         *
  8. *************************************************************************
  9.  
  10. This file includes all the requirements to set up a NetDoor client
  11. workstation, and describes how to install NetDoor on a client workstation
  12. and how to remove the NetDoor installation from a client workstation.
  13.  
  14. ==================================
  15. Hardware and Software Requirements
  16. ==================================
  17.  
  18. NetDoor supports Windows Version 3.1 clients running on systems with an
  19. 80286 (*) or more advanced processor.
  20. At least a 15 MHz processor speed is recommended.
  21. At run time NetDoor requires less than 3MB of disk space on the client
  22. and imposes no special memory requirements. At installation time
  23. 4MB of free disk space are required.
  24.  
  25. The only special hardware required is a network adapter.
  26. A Token Ring 16/4 adapter or Token Ring Bus Master adapter is recommended;
  27. the Token Ring/A adapter can also be used if 4MB token ring service is
  28. available.
  29.  
  30. The minimum hardware requirements for a client include:
  31.  
  32.  -  80286 processor (*)
  33.  -  3MB hard disk space
  34.  -  4MB random access memory for Windows 3.1
  35.  -  Any adapter supported by DOS LAN Requester 3.0
  36.  
  37. The minimum software requirements for a client include:
  38.  
  39.   -  DOS 4.0 or higher
  40.   -  Windows Version 3.1
  41.   -  LAN Server 3.0 DOS Requester (minimum service level IPX7045),,
  42.      or LAN Server 4.0 DOS Services (with APAR IC08906).
  43.  
  44. (*) Installing on 80286 requires special considerations. See the
  45.     section 'Special considerations to Install on 80286' at the
  46.     bottom of this file.
  47.  
  48. =============================
  49. NetDoor Installation Overview
  50. =============================
  51.  
  52. You can use one of three methods to install NetDoor.
  53. This section provides an overview of these methods and the requirements
  54. for each.
  55.  
  56. The three methods are:
  57.  -  Installing from the product diskettes
  58.  -  Installing from a code server
  59.  -  Installing using a software distribution manager product
  60.  
  61. The second and third methods are for remote installations.
  62.  
  63.  
  64.   Installing from Diskettes
  65.   -------------------------
  66.  
  67. This is the most commonly used method.
  68. It requires you to insert the diskettes as instructed.
  69.  
  70. This method can be either interactive or noninteractive:
  71.  
  72.  -  In interactive mode the installation requires you to
  73.     answer questions as prompted.
  74.  -  In noninteractive mode the installation is driven by a
  75.     response file, which contains the answers to all of the questions
  76.     that the installation needs.
  77.     This file can be generated in advance on any computer by your NetDoor
  78.     administrator.
  79.     With the response file you need to be present only to initiate the
  80.     installation, insert diskettes, and restart your workstation
  81.     when the installation is complete; no questions are
  82.     asked while the installation is running.
  83.  
  84. Upon completion of the installation, a group icon labeled
  85. 'NetDoor', and a group icon labeled 'NetDoor StartUp'
  86. are added to the desktop of your workstation.
  87. For more information about this method of installation, read
  88. 'Installing NetDoor from Product Diskettes.'
  89.  
  90.  
  91.  
  92.   Installing from a Code Server
  93.   -----------------------------
  94.  
  95. You can use this method only if you have access to a
  96. 'code server.'
  97.  
  98. A code server is a workstation that contains the NetDoor
  99. diskette image to be used during the installation.
  100. The diskette image must be loaded on the code server to a predefined
  101. directory structure by the NetDoor administrator.
  102. Diskettes are not required at your workstation to perform the
  103. installation.
  104.  
  105. This method can be either interactive or noninteractive.
  106.  
  107.  -  In interactive mode the installation works just as it
  108.     would if you were installing from diskette: it asks questions
  109.     which must be answered before the installation can begin.
  110.  -  In noninteractive mode the installation is driven by a
  111.     response file, which contains the answers to all of the questions
  112.     that the installation needs.
  113.     This file can be generated in advance on any computer by your NetDoor
  114.     administrator.
  115.     With the response file you need to be present only to initiate the
  116.     installation and restart your workstation
  117.     when the installation is complete; no questions are
  118.     asked while the installation is running.
  119.  
  120. Upon completion of the installation, a group icon labeled
  121. 'NetDoor,' and a group icon labeled 'NetDoor StartUp'
  122. are added to the desktop of your workstation.
  123. For more information about this method of installation, read
  124. 'Installing NetDoor from a Code Server.'
  125.  
  126.  
  127.  
  128.  
  129.     Installing Using a Software Distribution Manager Product
  130.     --------------------------------------------------------
  131.  
  132. This method refers to installation initiated from a
  133. remote system without requiring that anyone be at the system
  134. being installed.
  135.  
  136. NetDoor complies with IBM's configuration, installation, and distribution
  137. (CID) architecture, which provides for unattended, remote installation
  138. of programs and applications.
  139.  
  140. The installation is started by a program known as a software
  141. distribution manager, such as NetView* Distribution Manager/2.
  142.  
  143. For more information about this type of installation,
  144. ask your NetDoor administrator.
  145.  
  146. For installations on 80286 processors see the section 'Special
  147. considerations to Install on 80286' at the bottom of this file.
  148.  
  149.  
  150. ================
  151. Before You Begin
  152. ================
  153.  
  154. Before you install NetDoor, ensure that:
  155.  
  156.  -  The system has the required hardware as described
  157.     in 'Client Requirements.'
  158.  -  The operating system and network software are installed
  159.     at the correct service levels (see 'Client Requirements').
  160.     The NetDoor installation program does not allow installation
  161.     to proceed if the required levels are not installed.
  162.  -  You have the following information, which can be obtained from
  163.     your NetDoor administrator:
  164.  
  165.     User ID          This is the name you specify when you log on
  166.                      the NetDoor network.
  167.                      LAN Server controls access to network resources
  168.                      with user ID and passwords.
  169.     Password         This is the secret word you specify when
  170.                      you log on the NetDoor network.
  171.                      LAN Server controls access to network resources
  172.                      with user ID and passwords.
  173.     NetDoor domains  These are the NetDoor domains that
  174.                      Open NetDoor will assume as default
  175.                      values to connect to the network.
  176.  
  177.  -  Verify that both the operating system and the network software
  178.     are functional.
  179.     The NetDoor installation cannot complete successfully if
  180.     the operating system or the network software is not running properly.
  181.     If problems occur, correct them before attempting to install
  182.     NetDoor.
  183.  
  184.  
  185.  
  186. =========================================
  187. Installing NetDoor from Product Diskettes
  188. =========================================
  189.  
  190. This section discusses the steps necessary to install NetDoor from
  191. the product diskettes. In this section, 'A:' stands for
  192. the diskette drive from which NetDoor is being installed.
  193.  
  194. To install a NetDoor client from diskette, you need the first NetDoor
  195. installation diskette.
  196. If you know the preliminary information, start the installation as
  197. follows:
  198.  
  199.  1. Place NetDoor installation diskette number 1 in your diskette drive.
  200.  2. If Windows is already started, follow these steps:
  201.  
  202.      a. Switch to the Program Manager (or File Manager) window by
  203.         clicking on it or by using Task list.
  204.      b. From the 'File' pull-down menu, click on the
  205.         'Run' command. The 'Run' dialog box appears.
  206.      c. In the 'Command line' box, type the command:
  207.  
  208.         A:\INSTALL
  209.  
  210.         The section 'Using the Install Command' describes the parameters
  211.         you can specify.
  212.  
  213.     If Windows is not started yet, from the MS-DOS** prompt type the
  214.     command:
  215.  
  216.     WIN A:\INSTALL
  217.  
  218.     The section 'Using the Install Command' describes the parameters
  219.     you can specify.
  220.  
  221.  3. Click on the 'OK' button or press Enter.
  222.  
  223.  4. Read the panels and answer the questions that appear.
  224.     You can view on-line help for every panel by clicking on the
  225.     'Help' button or by pressing the F1 key.
  226.  
  227.  5. When the installation is complete, a message is displayed
  228.     with the installation return code.
  229.     If the installation was not successful, see the installation log
  230.     files.
  231.  
  232.     If you did not specify the /L1 and L3 parameters when you entered the
  233.     INSTALL command, see the default log file stored in the file
  234.     x:\WINDOWS\NETDOOR.LOG, where x:\WINDOWS is the drive
  235.     and the directory in which you installed Windows.
  236.     Otherwise, see the log files you specified with the /L1 and /L3
  237.     parameters.
  238.  
  239.  6. Exit the installation program by clicking on 'Exit.'
  240.  
  241.  7. Customize your installation as described in 'Customizing Your
  242.     Installation.'
  243.  
  244.  8. Shut down and restart your computer to make the changes effective:
  245.  
  246.      a. From the 'File' pull-down menu, select the 'Exit' command.
  247.      b. When the MS-DOS command prompt is displayed, press Ctrl+Alt+Del.
  248.  
  249.     The 'NetDoor' icon and the 'NetDoor StartUp' icon are added to your
  250.     desktop.
  251.  
  252.     If you are installing in interactive mode, the answers you entered
  253.     to all of the questions that the installation asked you are stored
  254.     in the x:\WINDOWS\COUINSTW.RSP response file, where x:\WINDOWS
  255.     is the drive and path in which you installed Windows.
  256.  
  257. NOTE:
  258. After you restart your workstation, select the 'READ ME'
  259. icon from the NetDoor group icon on your desktop to read the latest
  260. information and news about NetDoor.
  261.  
  262. To start working with the NetDoor product, see the on-line NetDoor
  263. User's Guide for Windows.
  264.  
  265.  
  266.  
  267. =====================================
  268. Installing NetDoor from a Code Server
  269. =====================================
  270.  
  271. You may need to contact your NetDoor administrator before
  272. installing a NetDoor client to find out the following information:
  273.  
  274.  -  Alias name where the diskette image is stored.
  275.     You need read and execute access to this alias on the code server.
  276.  -  Server name.
  277.  -  The fully qualified path name of the response file
  278.     (if you are installing NetDoor noninteractively).
  279.  -  Note that, on 80286, due to the use of conventional memory
  280.     done by Windows, the installation from a code server might
  281.     not be possible. See the section "Special considerations
  282.     to install on a 80286" for details.
  283.  
  284. If you know this information, start the installation as follows:
  285.  
  286.  1. From an MS-DOS prompt, access the network (if not accessed),
  287.     by typing:
  288.  
  289.     NET START
  290.  
  291.     NOTE: This command is optional. The network is automatically
  292.           accessed when you execute the next step.
  293.  
  294.  2. Access the alias directory, by typing:
  295.  
  296.     NET USE devicename \\servername\aliasdir
  297.  
  298.  3. If Windows is not started yet, type:
  299.  
  300.           WIN 'devicename':\INSTALL
  301.  
  302.     where 'devicename' is the drive you specified.
  303.  
  304.     If Windows is already started, follow these steps:
  305.  
  306.      a. Switch to the Program Manager (or File Manager) window by
  307.         clicking on it or by using Task list.
  308.      b. From the 'File' pull-down menu, click on the 'Run' command.
  309.         The 'Run' dialog box appears.
  310.      c. In the 'Command line' box, type the command:
  311.  
  312.         'devicename':\INSTALL
  313.  
  314.         where 'devicename' is the drive you specified.
  315.  
  316.     The NetDoor installation log file is stored in the file
  317.     x:\WINDOWS\NETDOOR.LOG where 'x:\WINDOWS' is the drive and path
  318.     in which you installed Windows.
  319.     To specify a different log file, see 'Using the Install Command'.
  320.     It describes all the parameters you can specify with the INSTALL
  321.     command.
  322.  
  323.  4. Click on the 'OK' button or press Enter.
  324.  
  325.  5. Read the panels and answer the questions that appear.
  326.     You can view on-line help for every panel by clicking on the
  327.     'Help' button or by pressing the F1 key.
  328.  
  329.  6. When the installation is complete, a message is displayed
  330.     with the installation return code.
  331.     If the installation was not successful, see the installation log
  332.     files you specified with the /L1 and /L3 parameters.
  333.  
  334.  7. Customize your installation as described in 'Customizing Your
  335.     Installation'.
  336.  
  337.  8. Exit the installation program by clicking on 'Exit'.
  338.  
  339.  9. Shut down and restart your computer to make the changes effective:
  340.  
  341.      a. From the 'File' pull-down menu, select the 'Exit' command.
  342.      b. When the MS-DOS command prompt is displayed, press Ctrl+Alt+Del.
  343.  
  344.     The 'NetDoor' icon and the 'NetDoor StartUp' icon are added
  345.     to your desktop.
  346.  
  347.     If you are installing in interactive mode, the answers you entered
  348.     to all of the questions that the installation asked you are stored
  349.     in the x:\WINDOWS\COUINSTW.RSP response file, where x:\WINDOWS
  350.     is the drive and path where you installed Windows.
  351.  
  352. NOTE:
  353. After you restart your workstation, select the 'READ ME'
  354. icon from the NetDoor group icon on your desktop, to read the latest
  355. information and news about NetDoor.
  356.  
  357. To start working with the NetDoor product, see the on-line
  358. NetDoor User's Guide for Windows.
  359.  
  360.  
  361.  
  362.  
  363. ========================================
  364. Installing NetDoor Using a Response File
  365. ========================================
  366.  
  367. You can install NetDoor using a response file if you are
  368. installing from either product diskettes or a code server.
  369.  
  370. If you are installing from the product diskettes, you only need to
  371. initiate the installation and to insert diskettes when required.
  372. If you are installing from a code server, you only need to initiate the
  373. installation procedure.
  374. The response file, prepared by the NetDoor administrator, contains
  375. all the keywords or installation variables that are needed by the
  376. NetDoor installation processing.
  377.  
  378. To use a response file, the file must be available on a disk or
  379. on an attached network alias before you begin installation.
  380. NetDoor provides a sample response file, on the client installation
  381. diskette number 1, in the 'a:\COUWINSTW.RSP' file, where 'a:' is
  382. your diskette drive.
  383.  
  384. Follow the instructions in 'Installing NetDoor from Product Diskettes' or
  385. 'Installing NetDoor from a Code Server,' but when you start the
  386. installation program, add the parameters to specify the path and
  387. name of the response file.
  388.  
  389. For example, if you are installing a system from remote drive Z
  390. and you have a response file SYSTEM1.RSP on a diskette in drive A,
  391. type the command:
  392.  
  393. Z:\INSTALL /A:I /C:Z:\NETDOOR.ICF /R:A:\SYSTEM1.RSP /X /L1:C:\NETD.LOG
  394.  
  395. The installation messages are recorded in the NETD.LOG file on your C
  396. disk.
  397.  
  398.  
  399.  
  400. =========================
  401. Using the Install Command
  402. =========================
  403.  
  404. Use 'install' to install NetDoor from the product diskettes
  405. or from a code server.
  406.  
  407. The syntax of the 'install' command is:
  408.  
  409.  >>-install -+-----------------------------------------+--+---------------+--->
  410.              !                                         !  !               !
  411.              +--/A:I--/C:catalog--/R:responsefile--/X--+  +--/L1:logfile--+
  412.  
  413.  >-----------+-------------------+---+-------------------+------------------><
  414.              !                   !   !                   !
  415.              +--/L2:historyfile--+   +--/L3:netdlogfile--+
  416.  
  417.  
  418. where:
  419.  
  420.   /A              The action you want to perform:
  421.                       I     Install
  422.                       D     Delete
  423.  
  424.                   When you specify this parameter the main window of the
  425.                   installation is not displayed.
  426.                   If you do not use it, the installation starts normally
  427.                   with all windows displayed.
  428.  
  429.   /C:catalog      Specifies the location of the catalog file NETDOOR.ICF.
  430.                   you must specify the drive name and directory location
  431.                   of the catalog file. For example:
  432.  
  433.                      /C:A:\NETDOOR.ICF
  434.  
  435.                   if you are installing from diskette, or:
  436.  
  437.                      /C:devicename:\NETDOOR.ICF
  438.  
  439.                   if you are installing from a code server, and
  440.                   'devicename' is the drive you used to access the
  441.                   NetDoor image on the code server.
  442.   /R:responsefile The drive, path, and file name of the specific
  443.                   response file. An example is:
  444.  
  445.                      /R:D:\XYZ\RESPONSE.DAT
  446.  
  447.                   NetDoor provides a response file, on the client
  448.                   installation diskette number 1, in the COUWINSTW.RSP
  449.                   file.
  450.  
  451.   /X              Specifies that the action is noninteractive.
  452.                   If you do not specify information needed for the action
  453.                   to complete, an error occurs.  When you specify this
  454.                   option, no progress indication is shown and all error
  455.                   messages are logged in the default log file.
  456.                   If you do not specify this option, you are prompted
  457.                   for any information that the installation requires.
  458.  
  459.   /L1:logfile     The full path name of the file that contains all the
  460.                   installation messages.
  461.                   This file is a good source for problem determination.
  462.  
  463.   /L2:history_log The drive, path, and file name of the history log file
  464.                   that contains all the installation log messages.
  465.                   This file contains a record of everything the
  466.                   installation process does and is a source for problem
  467.                   determination.
  468.                   If you do not specify this parameter, no history
  469.                   log is maintained.
  470.   /L3:netdlogfile The full path name of the file that contains all the
  471.                   NetDoor installation messages.
  472.                   If you do not specify the /L3: parameter, the
  473.                   default log file is x:\WINDOWS\NETDOOR.LOG, where
  474.                   x:\WINDOWS is the drive and the directory in which
  475.                   you installed Windows.
  476.  
  477. Invoking the 'install' command without specifying any parameter,
  478. you start an interactive installation.
  479.  
  480.  
  481.  
  482.  
  483. =============================
  484. Customizing Your Installation
  485. =============================
  486.  
  487. DOS Lan Requester 3.0
  488. ---------------------
  489.  
  490. The NetDoor installation procedure checks if the
  491. DOS Lan Requester 3.0 is properly installed and customized.
  492. If needed, it sets some parameters in the DOSLAN.INI as follows:
  493.  
  494.  -  /NVS:7
  495.  -  /NMS:7
  496.  -  /NDB:3
  497.  -  /API
  498.  
  499. The NVS parameter must be greater than or equal to the largest number of
  500. servers in any domain where you are defined.
  501. NetDoor sets this parameter to seven.
  502. Increase it if you have access to a domain with more than seven servers.
  503.  
  504. The NMS parameter value must be at least equal to the NVS value.
  505.  
  506. The old INI file is saved as DOSLAN.COU in the same directory.
  507.  
  508.  
  509. DOS Lan Services 4.0
  510. --------------------
  511.  
  512. No check or setting is performed by NetDoor installation procedure
  513. on DLS 4.0 customization.
  514.  
  515.  
  516.  
  517. =========================
  518. Installation Return Codes
  519. =========================
  520.  
  521. The following table lists the return codes you may have installing
  522. the NetDoor program. A brief description for each message is also
  523. provided. More details could be found in the NetDoor installation
  524. log file.
  525.  
  526.    -----------------------------------------------------------------------
  527.    RC                           Description
  528.    -----------------------------------------------------------------------
  529.  
  530.    00 00                        Successful program termination
  531.                                 Reboot and do not invoke again
  532.  
  533.    08 00                        Data resource not found
  534.  
  535.    08 04                        Data resource access denied because
  536.                                 already in use
  537.  
  538.    08 08                        Data resource access denied because
  539.                                 missing authorization
  540.  
  541.    08 12                        Data path not found
  542.  
  543.    08 16                        Product not configured
  544.  
  545.    12 00                        Storage medium exception (I/O error)
  546.  
  547.    12 04                        Device not ready
  548.  
  549.    12 08                        Not enough disk space
  550.  
  551.    16 00                        Incorrect program invocation
  552.  
  553.    16 04                        Unexpected condition
  554.  
  555.    FE 00                        Successful program termination.
  556.                                 Reboot and do not invoke again
  557.  
  558.    FE 04                        Successful program termination but
  559.                                 warning messages logged.
  560.                                 Reboot and do not invoke again
  561.  
  562.    FE 08                        Successful program termination but
  563.                                 error messages logged.
  564.                                 Reboot and do not invoke again
  565.  
  566.    FE 12                        Successful program termination but
  567.                                 severe error messages logged.
  568.                                 Reboot and do not invoke again
  569.  
  570.    FF xx                        Successful program termination
  571.                                 warning messages logged.
  572.                                 Reboot with callback.
  573.  
  574.  
  575.  
  576.  
  577.  
  578. =================================
  579. Removing the NetDoor Installation
  580. =================================
  581.  
  582. You can remove the &prod installation using the product diskettes,
  583. or a code server.
  584.  
  585. Using Diskettes
  586. ---------------
  587. To remove the installation using diskettes, perform the steps
  588. described in the section "Installing NetDoor from Product diskettes",
  589. but when you start the installation program, add the parameter /A:D
  590. as in the following example:
  591.  
  592.         A:\INSTALL /A:D
  593.  
  594. where 'A:' is your diskette drive. The removal procedure creates a log
  595. file. To specify the name of the log file, type, instead of the previous
  596. command:
  597.  
  598.       A:INSTALL /A:D /L1:logfile
  599.  
  600. where logfile is in the form drive:\path\filename.
  601.  
  602.  
  603. Using a Code Server
  604. -------------------
  605. To remove the installation using a code server, perform the steps
  606. described in the section :hdref refid=code.,
  607. but when you start the installation program, add the parameter /A:D
  608. as in the following example:
  609.  
  610.         x:\INSTALL /A:D
  611.  
  612. where 'x' is the drive you specified to access the directory
  613. on the code server.
  614. The deinstallation procedure creates a log file.
  615. To specify the name of the log file, type,
  616. instead of the previous command:
  617.  
  618.       x:INSTALL /A:D /L1:logfile
  619.  
  620. where logfile is in the form drive:\path\filename.
  621.  
  622.  
  623.  
  624. ==========================================
  625. Special considerations to Install on 80286
  626. ==========================================
  627.  
  628. Due to the large use of conventional memory done by Windows on 80286,
  629. in general, before running the NetDoor installation procedure on this
  630. processor, you should ensure that no other programs are running.
  631. In particular we recommend not to start the DOS LAN Services
  632. program.
  633.  
  634. A failing installation due to lack of memory can be evidenced by
  635. returning a General Protection Fault (GPF) in the EPFINST module.
  636. The NetDoor installation will end with the EPFIE187 message
  637. indicating a return code of 0006 in the L1 log file.
  638. This means that the system does not have enough memory
  639. to complete the installation.
  640.  
  641. If this happens the following considerations can applied:
  642.  
  643. - In general, an interactive installation uses less memory than
  644.   an installation with response file.
  645.  
  646. - If you want to perform an installation with response file you can
  647.   reduce to the minimum the parameter list for the INSTALL command
  648.   (default values are available for the other parameters), i.e.
  649.   use the following command:
  650.     A:\INSTALL /A:I /R:A:\SYSTEM1.RSP /X /L1:C:\NETD.LOG
  651.   where A:\SYSTEM1.RSP is your customized response file.
  652.  
  653. - If the problem persists check if any program is holding the
  654.   DOS conventional memory by issuing the DOS command 'MEM /D'.
  655.  
  656. In addition to the above, if you are installing using a Software
  657. Distribution Manager product (such as NetView DM/2), you
  658. must first run the NetDoor installation program and then the
  659. NETCIDRC program, that is on the installation diskette number 1.
  660.  
  661.