home *** CD-ROM | disk | FTP | other *** search
/ Network Support Encyclopedia 96-1 / novell-nsepro-1996-1-cd2.iso / download / netware / migrat.exe / IBMMIG.DOC < prev    next >
Text File  |  1990-10-26  |  160KB  |  4,486 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.          I B M   O P E R A T I N G   S Y S T E M / 2
  23.  
  24.          L A N   S E R V E R   V E R S I O N   1 . 3
  25.  
  26.          D O M A I N   C O N T R O L   D A T A B A S E
  27.  
  28.          M I G R A T I O N   H A N D B O O K
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.         
  56.  
  57.  
  58.  
  59.  
  60.  
  61.          SPECIAL NOTICES
  62.  
  63.          References in this publication to IBM products, programs
  64.          or services do not imply that IBM intends to make these
  65.          available in all countries in which IBM operates.  Any
  66.          reference to an IBM product, program, or service is not
  67.          intended to state or imply that only IBM's product,
  68.          program, or service may be used.  Any functionally
  69.          equivalent product, program, or service that does not
  70.          infringe any of IBM's intellectual property rights or
  71.          other legally protectible rights may be used instead of
  72.          the IBM product, program, or service.  Evaluation and
  73.          verification of operation in conjunction with other
  74.          products, programs, or services, except those expressly
  75.          designated by IBM, are the user's responsibility.
  76.  
  77.          IBM may have patents or pending patent applications
  78.          covering subject matter in this document.  The
  79.          furnishing of this document does not give you any
  80.          license to these patents.  You can send license
  81.          inquiries, in writing, to the IBM Director of Commercial
  82.          Relations, IBM Corporation, Purchase, NY 10577.
  83.  
  84.          The following terms, denoted by an asterisk (*) in this
  85.          publication, are trademarks of the IBM corporation in
  86.          the United States and/or other countries:
  87.  
  88.          IBM
  89.  
  90.          Operating System/2
  91.  
  92.          OS/2
  93.  
  94.          The following paragraph does not apply to the United
  95.          Kingdom or any country where such provisions are
  96.          inconsistent with local law.
  97.  
  98.          INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES
  99.          THIS INFORMATION "AS IS" WITHOUT WARRANTY OF ANY KIND,
  100.          EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED
  101.          TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY OR
  102.          FITNESS FOR A PARTICULAR PURPOSE.
  103.  
  104.          Some states do not allow disclaimer of express or
  105.          implied warranties in certain transactions; therefore,
  106.          this statement may not apply to you.
  107.  
  108.  
  109.  
  110.  
  111.                                     ii
  112.          
  113.  
  114.  
  115.  
  116.  
  117.  
  118.          This information could include technical inaccuracies
  119.          or typographical errors.  Changes are periodically made
  120.          to the information herein; these changes will be
  121.          incorporated in new editions of the information.  IBM
  122.          may make improvements and/or changes in the product(s)
  123.          and/or the program(s) described in this information at
  124.          any time.
  125.  
  126.          Requests for copies of this information and for
  127.          technical information about IBM products should be made
  128.          to your IBM Authorized Dealer or your IBM Marketing
  129.          Representative.
  130.  
  131.          (C) Copyright International Business Machines
  132.          Corporation 1990.  All rights reserved.
  133.  
  134.          Note to US Government Users:  Documentation and
  135.          programs related to restricted rights.  Use,
  136.          duplication or disclosure is subject to restrictions
  137.          set forth in GSA ADP Schedule Contract with IBM Corp.
  138.  
  139.  
  140.  
  141.  
  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.  
  167.                                    iii
  168.          
  169.  
  170.  
  171.  
  172.  
  173.  
  174.          CONTENTS
  175.  
  176.          ABOUT THIS BOOK ...................................  vii
  177.              BEFORE YOU BEGIN ..............................  vii
  178.              WHO SHOULD USE THIS BOOK ...................... viii
  179.              HOW THIS BOOK IS STRUCTURED ................... viii
  180.                  ORGANIZATION .............................. viii
  181.                  CONVENTIONS ...............................   ix
  182.                  RELATED PUBLICATIONS ......................    x
  183.  
  184.  
  185.  
  186.          CHAPTER 1. INTRODUCTION TO THE MIGRATION PROCESS... 1-1
  187.              MIGRATION CONTENTS ............................ 1-4
  188.              CONSIDERATIONS ................................ 1-5
  189.              THE MIGRATION PROCESS ......................... 1-7
  190.              ERROR HANDLING ................................ 1-8
  191.  
  192.  
  193.          CHAPTER 2. MIGRATING AN ENTIRE PCLP 1.3 DOMAIN
  194.                   AT ONE TIME .............................. 2-1
  195.              PREPARING THE NETWORK AND USER COMMUNITY ...... 2-3
  196.              PLANNING FOR THE EXPORT PHASE ................. 2-3
  197.              EXPORTING THE DOMAIN DEFINITIONS TO A
  198.                   TEMPORARY DCDB FILE ...................... 2-4
  199.              PLANNING FOR THE IMPORT PHASE ................. 2-6
  200.              IMPORTING THE DOMAIN DEFINITIONS TO THE
  201.                   DESTINATION DOMAIN ....................... 2-8
  202.              COMPLETING THE MIGRATION ...................... 2-10
  203.  
  204.  
  205.          CHAPTER 3. MIGRATING A PCLP 1.3 DOMAIN IN STAGES .. 3-1
  206.              PREPARING THE NETWORK AND USER COMMUNITY ...... 3-3
  207.              PLANNING FOR THE EXPORT PHASE ................. 3-3
  208.              EXPORTING THE DOMAIN DEFINITIONS TO A
  209.                   TEMPORARY DCDB FILE ...................... 3-5
  210.              PLANNING FOR THE IMPORT PHASE ................. 3-7
  211.              IMPORTING THE DOMAIN DEFINITIONS TO THE
  212.                   DESTINATION DOMAIN ....................... 3-8
  213.              SETTING UP THE INTERMEDIATE ENVIRONMENT ....... 3-10
  214.              COMPLETING THE MIGRATION ...................... 3-13
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.                                  iv
  226.          
  227.  
  228.  
  229.  
  230.  
  231.  
  232.          CHAPTER 4. MIGRATING AN ENTIRE LAN SERVER 1.0
  233.                   DOMAIN AT ONE TIME ....................... 4-1
  234.              PREPARING THE NETWORK AND USER COMMUNITY ...... 4-3
  235.              PLANNING FOR THE EXPORT PHASE ................. 4-3
  236.              EXPORTING THE DOMAIN DEFINITIONS TO A
  237.                   TEMPORARY DCDB FILE ...................... 4-5
  238.              PLANNING FOR THE IMPORT PHASE ................. 4-7
  239.              IMPORTING THE DOMAIN DEFINITIONS TO THE
  240.                   DESTINATION DOMAIN ....................... 4-9
  241.              COMPLETING THE MIGRATION ...................... 4-11
  242.  
  243.  
  244.          CHAPTER 5. MIGRATING A LAN SERVER 1.0 DOMAIN
  245.                   IN STAGES ................................ 5-1
  246.              PREPARING THE NETWORK AND USER COMMUNITY ...... 5-3
  247.              PLANNING FOR THE EXPORT PHASE ................. 5-3
  248.              EXPORTING THE DOMAIN DEFINITIONS TO A
  249.                   TEMPORARY DCDB FILE ...................... 5-6
  250.              PLANNING FOR THE IMPORT PHASE ................. 5-8
  251.              IMPORTING THE DOMAIN DEFINITIONS TO THE
  252.                   DESTINATION DOMAIN ....................... 5-9
  253.              SETTING UP THE INTERMEDIATE ENVIRONMENT ....... 5-11
  254.              COMPLETING THE MIGRATION ...................... 5-15
  255.  
  256.  
  257.          APPENDIX.  ERROR MESSAGES AND ERROR RECOVERY ...... A-1
  258.              PCLP 1.3 EXPORT ERRORS ........................ A-1
  259.              LAN SERVER 1.0 EXPORT ERRORS .................. A-1
  260.              IMPORT ERRORS ................................. A-2
  261.                   USER ERRORS .............................. A-2
  262.                   PROGRAM CODE ERRORS .......................A-7
  263.                   WARNING MESSAGES ......................... A-10
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.                                   v
  283.          
  284.  
  285.  
  286.  
  287.  
  288.  
  289.          FIGURES
  290.  
  291.          2-1.   AN ENTIRE PCLP 1.3 DOMAIN MIGRATED
  292.                 TO LAN SERVER 1.3 ALL AT ONE TIME.........2-2
  293.          3-1.   A PCLP DOMAIN MIGRATED TO LAN
  294.                 SERVER 1.3 OVER TIME IN STAGES............3-2
  295.          4-1.   LAN SERVER 1.0 DOMAIN MIGRATED TO
  296.                 LAN SERVER 1.3 DOMAIN ALL AT ONE TIME.....4-2
  297.          5-1.   LAN SERVER 1.0 DOMAIN MIGRATED TO
  298.                 LAN SERVER 1.3 OVER TIME IN STAGES........5-2
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.                                    vi
  340.          
  341.  
  342.  
  343.  
  344.  
  345.  
  346.          ABOUT THIS BOOK
  347.  
  348.          This handbook describes the tasks required to migrate
  349.          from current IBM* Local Area Network Server environments
  350.          (PC LAN Program 1.3 and IBM Operating System/2* LAN
  351.          Server 1.0) to an IBM Operating System/2 LAN Server 1.3
  352.          environment.
  353.  
  354.          NOTE:  If you are upgrading from OS/2* LAN Server 1.2,
  355.                 refer to OPERATING SYSTEM/2 LOCAL AREA NETWORK
  356.                 SERVER VERSION 1.3 GETTING STARTED to proceed with
  357.                 normal installation.  You do not reinitialize the
  358.                 domain control database (DCDB).  There is no need
  359.                 to use the Migration Utility when upgrading from
  360.                 OS/2 LAN Server 1.2.
  361.  
  362.          A Migration Utility is used to move the domain
  363.          definitions from the current environment to the DCDB
  364.          in the new environment while preserving the integrity
  365.          and consistency of the data.  Migration tasks for each
  366.          type of domain (DOS and OS/2) are listed in scenarios
  367.          for migrating the entire domain at one time or migrating
  368.          the domain in stages over a period of time.
  369.  
  370.  
  371.          BEFORE YOU BEGIN
  372.  
  373.          You should be familiar with the Operating System/2
  374.          program to use this handbook.  During the migration, you
  375.          will need to refer to IBM OPERATING SYSTEM/2 LOCAL AREA
  376.          NETWORK SERVER VERSION 1.3 GETTING STARTED and the IBM
  377.          OPERATING SYSTEM/2 LOCAL AREA NETWORK SERVER VERSION 1.3
  378.          NETWORK ADMINISTRATOR'S GUIDE in order to accomplish the
  379.          required tasks.  You will also need to be familiar with a
  380.          text editor or word processor in order to edit and work
  381.          with various files.
  382.  
  383.          If you are not familiar with the OS/2 program, see
  384.          "RELATED PUBLICATIONS" on page x in this handbook
  385.          for a list of books from which you can get the
  386.          information you need.
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.                                   vii
  396.          
  397.  
  398.  
  399.  
  400.  
  401.          WHO SHOULD USE THIS BOOK
  402.  
  403.          This handbook assists the network administrator or
  404.          person responsible for release-to-release migration of
  405.          LAN environments in the following tasks:
  406.  
  407.          - Planning and preparing the network for migration
  408.  
  409.          - Migrating to the OS/2 LAN Server 1.3 environment
  410.  
  411.          - Restoring and creating the LAN resources not affected
  412.            by the migration.
  413.  
  414.  
  415.          HOW THIS BOOK IS STRUCTURED
  416.  
  417.          This handbook is designed to acquaint you with the
  418.          migration process and to describe the tasks and
  419.          procedures required to complete the migration of your
  420.          environment to a LAN Server 1.3 environment.
  421.  
  422.  
  423.          ORGANIZATION
  424.  
  425.          This handbook is organized as follows:
  426.  
  427.          - CHAPTER 1, "INTRODUCTION TO THE MIGRATION PROCESS,"
  428.            introduces and briefly describes the migration
  429.            software.
  430.  
  431.          - CHAPTER 2, "MIGRATING AN ENTIRE PCLP 1.3 DOMAIN AT ONE
  432.            TIME," describes the tasks required to migrate from a
  433.            PCLP 1.3 domain to a LAN Server 1.3 domain all at one
  434.            time.
  435.  
  436.          - CHAPTER 3, "MIGRATING A PCLP 1.3 DOMAIN IN STAGES,"
  437.            describes the tasks required to migrate from a PCLP
  438.            1.3 domain to a LAN Server 1.3 domain in stages
  439.            (migrating the servers first, followed by the
  440.            requesters) over an unspecified period of time.
  441.  
  442.          - CHAPTER 4, "MIGRATING AN ENTIRE LAN SERVER 1.0 DOMAIN
  443.            AT ONE TIME," describes the tasks required to migrate
  444.            from a LAN Server 1.0 domain to a LAN Server 1.3 domain
  445.            all at one time.
  446.  
  447.  
  448.  
  449.  
  450.  
  451.                                   viii
  452.          
  453.  
  454.  
  455.  
  456.  
  457.  
  458.          - CHAPTER 5, "MIGRATING A LAN SERVER 1.0 DOMAIN IN
  459.            STAGES," describes the tasks required to migrate from
  460.            a LAN Server 1.0 domain to a LAN Server 1.3 domain in
  461.            stages (migrating the servers first, followed by the
  462.            requesters) over an unspecified period of time.
  463.  
  464.          - APPENDIX, "ERROR MESSAGES AND ERROR RECOVERY," lists
  465.            error messages that can be received during the Export
  466.            and Import phases of the migration and the appropriate
  467.            actions for recovery.
  468.  
  469.  
  470.          CONVENTIONS
  471.  
  472.          This handbook uses the following terminology conventions
  473.          unless otherwise noted:
  474.  
  475.          - PCLP 1.3 refers to PC LAN Program Version 1.3.
  476.  
  477.          - LAN Server 1.0 refers to IBM Operating System/2 Local
  478.            Area Network Server Version 1.0.
  479.  
  480.          - LAN Server 1.3 refers to IBM Operating System/2 Local
  481.            Area Network Server Version 1.3.
  482.  
  483.          - LAN Requester refers to the LAN Requester component of
  484.            IBM Operating System/2 Extended Edition Version 1.3.
  485.  
  486.          - OS/2 EE 1.3 and the OS/2 program refer to IBM
  487.            Operating System/2 Extended Edition Version 1.3.
  488.  
  489.          - DOS refers to IBM DOS 3.3 or 4.01.
  490.  
  491.          - DOS LAN Requester refers to the component of the
  492.            OS/2 LAN Server 1.3 program that enables users at
  493.            DOS workstations to be members of an OS/2 local
  494.            area network.
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.                                   ix
  508.          
  509.  
  510.  
  511.  
  512.  
  513.  
  514.          RELATED PUBLICATIONS
  515.  
  516.          The following is a list of related publications.  For
  517.          information about ordering these publications, contact
  518.          your IBM authorized dealer or IBM marketing
  519.          representative.
  520.  
  521.          - IBM OPERATING SYSTEM/2 LOCAL AREA NETWORK SERVER
  522.            VERSION 1.3 GETTING STARTED
  523.  
  524.          - IBM OPERATING SYSTEM/2 LOCAL AREA NETWORK SERVER
  525.            VERSION 1.3 NETWORK ADMINISTRATOR'S GUIDE
  526.  
  527.          - IBM OPERATING SYSTEM/2 LOCAL AREA NETWORK SERVER
  528.            VERSION 1.3 USER'S GUIDE
  529.  
  530.          - IBM OPERATING SYSTEM/2 LOCAL AREA NETWORK SERVER
  531.            VERSION 1.3 DOS LAN REQUESTER USER'S GUIDE
  532.  
  533.          - IBM OPERATING SYSTEM/2 LOCAL AREA NETWORK SERVER
  534.            VERSION 1.3 COMMANDS REFERENCE
  535.  
  536.          - IBM OPERATING SYSTEM/2 EXTENDED EDITION VERSION 1.3
  537.            GETTING STARTED
  538.  
  539.          - IBM OPERATING SYSTEM/2 EXTENDED EDITION VERSION 1.3
  540.            USER'S GUIDE, VOLUME 1:  BASE OPERATING SYSTEM
  541.  
  542.          - IBM PC LOCAL AREA NETWORK PROGRAM VERSION 1.3
  543.            REFERENCE
  544.  
  545.          - IBM OPERATING SYSTEM/2 SERVER INSTALLATION AND
  546.            CONFIGURATION GUIDELINES
  547.  
  548.          - IBM OPERATING SYSTEM/2 INFORMATION AND PLANNING
  549.            GUIDE.
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.                                   x
  564.          
  565.  
  566.  
  567.  
  568.  
  569.  
  570.          CHAPTER 1.  INTRODUCTION TO THE MIGRATION PROCESS
  571.  
  572.          The migration process moves the domain definitions from
  573.          a LAN Server 1.0 or PCLP 1.3 domain to a LAN Server 1.3
  574.          domain while preserving the integrity and consistency of
  575.          the data.
  576.  
  577.          NOTE:  If you are upgrading from OS/2 LAN Server 1.2,
  578.                 refer to OPERATING SYSTEM/2 LOCAL AREA NETWORK
  579.                 SERVER VERSION 1.3 GETTING STARTED to proceed with
  580.                 normal installation.  You do not need to
  581.                 reinitialize the domain control database (DCDB).
  582.                 There is no need to use the Migration Utility
  583.                 when upgrading from OS/2 LAN Server 1.2.
  584.  
  585.          The domain definitions are stored in a DCDB in the LAN
  586.          Server 1.0 and 1.3 environments and in directories in
  587.          the PCLP 1.3 environment.  Throughout these
  588.          instructions, the domain definitions in all cases are
  589.          referred to as the DCDB.
  590.  
  591.          The DCDB contains information such as user IDs and
  592.          passwords, logon assignments, application selector
  593.          information, group information, and resources to be
  594.          shared as defined by the network administrator.  Each
  595.          resource that is subject to access control must be defined
  596.          by an access control profile for that resource.  The LAN
  597.          Server 1.3 access control profile for a resource resides
  598.          on the same server as the physical resource (unlike
  599.          LAN Server 1.0, where the profiles resided on the domain
  600.          controller only).
  601.  
  602.          A domain can be migrated at one time or in stages over a
  603.          period of time.  The resources in the destination domain
  604.          can be the same or different from those in the source
  605.          domain.  The DCDB migration can occur on the same or
  606.          different physical networks.
  607.  
  608.          The migration process uses the Domain Control Database
  609.          Migration Utility to process the data related to the
  610.          user, group, and resource definitions.  The Migration
  611.          Utility uses DCDB Export and DCDB Import functions to
  612.          move and process the domain definitions from the current
  613.          domain to the new one. The Export function is contained
  614.          on the Migration Utility diskette.  The network
  615.          administrator runs the Export function on the source
  616.          (PCLP 1.3 or LAN Server 1.0) domain controller.  The
  617.  
  618.  
  619.                                  1-1
  620.          
  621.  
  622.  
  623.  
  624.  
  625.  
  626.          import function is contained within the OS/2 LAN
  627.          Server program itself.  The network administrator
  628.          runs the Import function on the destination (LAN
  629.          Server 1.3) domain controller.
  630.  
  631.          The Export function uses a mapping component to map the
  632.          attributes of the LAN objects (for example, users,
  633.          groups, and access profiles) from the source DCDB format
  634.          to the destination DCDB format.  The exported attributes
  635.          are written to a temporary DCDB file.
  636.  
  637.          After OS/2 EE 1.3 and LAN Server 1.3 are installed, the
  638.          Import function is used to import the information from
  639.          the temporary file into the LAN Server 1.3 DCDB and the
  640.          OS/2 EE 1.3 User Profile Management (UPM) database.
  641.          Only the definitions of the LAN objects and access
  642.          control profiles are migrated.  The resources themselves
  643.          are not migrated.  The network administrator and network
  644.          users must manually move physical resources, such as
  645.          software applications and user files, from the source
  646.          domain to the destination domain.
  647.  
  648.          If a critical error occurs during migration, the process
  649.          stops.  The network administrator can check the history
  650.          file generated by the utility to find out which
  651.          operations have been completed and where the error
  652.          occurred.  After correcting the error (by editing the
  653.          temporary file or changing the LAN Server 1.3 DCDB), the
  654.          network administrator can decide whether to continue the
  655.          migration from the point at which the error occurred or
  656.          to start the process from the beginning.  A noncritical
  657.          error, such as a duplicate resource not being migrated
  658.          or a resource not being shared, that occurs during the
  659.          migration is also logged in the history file.  The
  660.          network administrator can review and correct noncritical
  661.          errors at any time.  See "ERROR HANDLING" on page 1-8
  662.          for more information.
  663.  
  664.          NOTES:
  665.  
  666.          1. The migration scenarios describe migration to
  667.             a LAN Server 1.3 domain containing only the
  668.             default LAN definitions.  If this is not the
  669.             case, then prior to importing, check for
  670.             duplicate information between the temporary
  671.             DCDB file and the existing LAN Server 1.3
  672.             DCDB.  If duplicates are found, make the
  673.  
  674.  
  675.                                  1-2
  676.          
  677.  
  678.  
  679.  
  680.  
  681.  
  682.             appropriate changes either to the temporary
  683.             DCDB file or to the LAN Server 1.3 DCDB.
  684.  
  685.             When the Import function is executed, existing
  686.             entries in the LAN Server 1.3 DCDB are preserved
  687.             if conflicts (such as duplicate entries) arise
  688.             with imported entries.  For example, if the
  689.             temporary DCDB file contains a resource ID that is
  690.             identical to an ID already residing on the
  691.             destination domain, the ID on the destination domain
  692.             is retained.
  693.  
  694.             The exception to this happens when the temporary DCDB
  695.             file contains a duplicate server and resource
  696.             combination, such as a printer that uses the same
  697.             server and same port as the printer that is already
  698.             assigned to the destination domain.  In this case,
  699.             the migration stops and the network administrator
  700.             must decide which resource to keep.
  701.  
  702.          2. The network administrator must verify that the
  703.             country information is the same in the source and
  704.             destination domains (the code page, country code,
  705.             and keyboard parameters in the CONFIG.SYS file).
  706.  
  707.          3. If the DCDB is too large to fit on one diskette, the
  708.             Export and Import functions support multiple diskettes.
  709.             During the Export phase, the network administrator is
  710.             prompted for additional formatted diskettes and a new
  711.             temporary file name for each additional diskette.  The
  712.             temporary file names should be unique and in sequential
  713.             order (for example, DCDB1.TMP, DCDB2.TMP, and DCDB3.TMP).
  714.             The Import function does not prompt for additional
  715.             diskettes.  The network administrator must use the
  716.             Import function to process each diskette in the same
  717.             sequential order in which it was created.  The Import
  718.             phase is complete when all diskettes have been
  719.             processed.
  720.  
  721.          4. Certain text editors may insert tab characters in
  722.             the files that you edit.  Verify that the TAB option
  723.             is set to OFF for the editor you are using.  The
  724.             OS/2 System Editor does not add tab characters.
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.                                  1-3
  732.          
  733.  
  734.  
  735.  
  736.  
  737.  
  738.          MIGRATION CONTENTS
  739.  
  740.          The following domain definitions are migrated:
  741.  
  742.          - Machine definitions (excluding requesters)
  743.  
  744.          - Files alias definitions (including directory
  745.            structures)
  746.  
  747.          - Printer alias definitions (including queues)
  748.  
  749.          - Serial device alias definitions (including queues and
  750.            external resources)
  751.  
  752.          - Public application definitions (excluding working
  753.            directories)
  754.  
  755.            -- Application files assignments
  756.            -- Application printer assignments
  757.            -- Application serial device assignments.
  758.  
  759.          - User definitions
  760.  
  761.            -- Logon file assignments
  762.            -- Logon printer assignments
  763.            -- Logon serial device assignments
  764.            -- Application selector list.
  765.  
  766.          - Groups definitions
  767.  
  768.          - Access control profiles.
  769.  
  770.          These definitions (their attributes and values) are
  771.          exported into a temporary DCDB file in the order shown.
  772.          This temporary DCDB file can be edited to change or add
  773.          values as necessary before importing the domain
  774.          definitions to the new LAN Server 1.3 DCDB.  However,
  775.          the order of the definitions in the temporary DCDB
  776.          should not be changed.  See the appendix that lists
  777.          values for domain definitions in IBM OPERATING SYSTEM/2
  778.          LOCAL AREA NETWORK SERVER VERSION 1.3 GETTING STARTED.
  779.  
  780.          The requester definitions and image files for remote IPL
  781.          are not migrated by this utility.  Remote IPL support
  782.          can be installed using the LAN Server 1.3 install
  783.          program.  New DOS LAN Requester IPL images can be built
  784.          using the LAN Server 1.3 full-screen interface.  See IBM
  785.          OPERATING SYSTEM/2 LOCAL AREA NETWORK SERVER VERSION 1.3
  786.  
  787.                                  1-4
  788.          
  789.  
  790.  
  791.  
  792.  
  793.  
  794.          GETTING STARTED and the IBM OPERATING SYSTEM/2 LOCAL
  795.          AREA NETWORK SERVER VERSION 1.3 NETWORK ADMINISTRATOR'S
  796.          GUIDE for more information.
  797.  
  798.          The global access list used in LAN Server 1.0 is not
  799.          used in LAN Server 1.3.  Therefore, the global access
  800.          list is not migrated.
  801.  
  802.          Only the definition of the user's home directory is
  803.          migrated.  The files in the home directory should be
  804.          backed up before starting the migration.  After the
  805.          migration is completed, the backed-up files can be
  806.          restored.
  807.  
  808.          DOS and OS/2 users are all migrated to the IBM LAN
  809.          Server 1.3 domain, which does not distinguish between
  810.          DOS and OS/2 users.
  811.  
  812.  
  813.          CONSIDERATIONS
  814.  
  815.          Names used in LAN Server 1.3 must contain from 1 to 8
  816.          characters.  The first character cannot be numeric.  The
  817.          last character cannot be the dollar sign ($) character.
  818.          An error occurs if the name does not follow naming
  819.          conventions.
  820.  
  821.          Because original user passwords cannot be decrypted,
  822.          the Migration Utility randomly sets a new password for
  823.          each migrated user in the destination domain.  The new
  824.          passwords are contained in the \IBMLAN\NETPROG\DCDBPSWD.DAT
  825.          file located on the destination domain controller.  The
  826.          network administrator must notify users of their new
  827.          passwords so they can log on to the destination domain.
  828.  
  829.          If the number of servers in the destination domain does
  830.          not match the number of servers in the source domain,
  831.          the network administrator should make the appropriate
  832.          adjustments.
  833.  
  834.          PCLP 1.3 and LAN Server 1.0 directories and files without
  835.          access control profiles were given maximum access
  836.          permissions.  This changed in LAN Server 1.2 and higher
  837.          to denying access to directories and files without an
  838.          access control profile.
  839.  
  840.  
  841.  
  842.  
  843.                                    1-5
  844.          
  845.  
  846.  
  847.  
  848.  
  849.  
  850.          What this means is that PCLP 1.3 or LAN Server 1.0
  851.          applications could have had access to a resource without
  852.          an access control profile.  The same applications
  853.          running under LAN Server 1.2 and higher will be denied
  854.          access to resources without an access control profile.
  855.          Thus, an application that accesses resources with no
  856.          access control profile specified may not run properly
  857.          after migration.
  858.  
  859.          To prevent this, the Import phase will create a profile
  860.          with all permissions except the "P" permission for the
  861.          root.  This allows access to all files and directories
  862.          on the drive that do not have an access control profile.
  863.          To take advantage of the expanded access control
  864.          provisions in LAN Server 1.2 and higher, the network
  865.          administrator should create the appropriate access
  866.          control profiles throughout the directory structures and
  867.          then update or delete the access control profile at the
  868.          root.  In addition, the network administrator should
  869.          assure that access control profiles exist for resources
  870.          that are shared using NET SHARE commands.
  871.  
  872.          Releases prior to LAN Server 1.2 required that the
  873.          domain name and the server (machine) name be the same
  874.          for the domain controller.  LAN Server 1.2 and higher
  875.          require that the domain name and server (machine) names
  876.          be unique.  For this reason, you will have to change
  877.          either the domain name or the server (machine) name on
  878.          the domain controller when you install LAN Server 1.2 or
  879.          higher.
  880.  
  881.          1.  If the domain name is selected to be changed, it
  882.              will be changed during installation of LAN Server
  883.              and LAN Requester 1.2 or higher.  Changing the domain
  884.              name requires changes to any batch (.BAT) or command
  885.              (.CMD) files containing instruction using the domain
  886.              name.
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.                                     1-6
  900.          
  901.  
  902.  
  903.  
  904.  
  905.  
  906.          2.  If the server (machine) name is selected to be
  907.              changed, it will be changed during the installation
  908.              of LAN Server and LAN Requester 1.2 or higher.
  909.              Changing the server name also requires making global
  910.              changes in the migration export temporary file to
  911.              reflect the new server name(s).  Other areas that may
  912.              require server name changes could be batch (.BAT) or
  913.              command (.CMD) files containing instructions using
  914.              the server (machine) name.
  915.  
  916.          If servers or shared resources are added for the new
  917.          domain, the network administrator can define additional
  918.          resources after the migration has been completed.  If
  919.          there are servers or resources that will be eliminated
  920.          from the destination domain, the network administrator
  921.          should change the definitions of aliases or possible
  922.          user logon assignments before running the Export
  923.          function.  It is also possible to change the resource
  924.          assignments by editing the temporary DCDB file (created
  925.          during the Export process) prior to starting the Import
  926.          phase.
  927.  
  928.          Before starting the migration, the network administrator
  929.          should manually back up the source DCDB using a series
  930.          of XCOPY commands or (for LAN Server 1.0 only) the
  931.          DCDBBACK Utility.  The Migration Utility does not
  932.          perform this function.  It is important to have a copy
  933.          of the original DCDB if there are errors or system
  934.          failure during the migration.  The steps for backing up
  935.          the DCDB are described in the migration chapter for each
  936.          environment.
  937.  
  938.          To verify the domain definitions, the network
  939.          administrator should print the definitions before and
  940.          after the migration process and compare both sets.  The
  941.          Migration Utility does not perform this function.
  942.  
  943.  
  944.          THE MIGRATION PROCESS
  945.  
  946.          The migration tasks are described in the following
  947.          phases:
  948.  
  949.          - Preparing the network and user community, which
  950.            involves such tasks as upgrading hardware if necessary
  951.            and informing network users about the migration
  952.            schedule.
  953.  
  954.  
  955.                                     1-7
  956.          
  957.  
  958.  
  959.  
  960.  
  961.  
  962.          - Planning for the Export phase, which involves such
  963.            tasks as printing the existing domain definitions for
  964.            later comparisions and creating a backup copy of the
  965.            existing domain definitions on diskette, as well as
  966.            reviewing and documenting the current access
  967.            permissions for each network resource.
  968.  
  969.          - Exporting the source domain definitions to a temporary
  970.            file.
  971.  
  972.          - Planning for the Import phase, which involves
  973.            preparing the new domain controller (installing the
  974.            appropriate software) and modifying the temporary DCDB
  975.            file for the new environment as required.
  976.  
  977.          - Importing the domain definitions from the temporary
  978.            file to the destination DCDB.
  979.  
  980.          - In staged migration only, creating an intermediate
  981.            environment to continue providing resources to the
  982.            network.
  983.  
  984.          - Completing the migration, which involves such tasks as
  985.            restoring resources that have not been migrated and
  986.            upgrading the requesters in the domain.
  987.  
  988.          All servers in the source domain must be started in
  989.          order to export the DCDB.  All servers in the
  990.          destination domain must be started in order to import
  991.          the DCDB.
  992.  
  993.          NOTE:  During the actual migration, no other users or
  994.                 administrators should be logged on to the domain,
  995.                 since this could interfere with the process.  It
  996.                 is especially important that other network
  997.                 administrators do not modify any domain
  998.                 definitions in the databases while the migration
  999.                 is taking place.
  1000.  
  1001.  
  1002.          ERROR HANDLING
  1003.  
  1004.          If the migration process encounters an error, an error
  1005.          message is displayed at the workstation and logged in a
  1006.          history file (\PCLP13XS\NET1_30\PCLP13MU.HST for
  1007.          exporting from PCLP 1.3 or \IBMLAN\NETPROG\LS10MU.HST
  1008.          for exporting from LAN Server 1.0).  The history file
  1009.  
  1010.  
  1011.                                       1-8
  1012.          
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.          \IBMLAN\NETPROG\LS12MU.HST is created each time the
  1019.          Import function is used on the LAN Server 1.3 domain.
  1020.  
  1021.          The history file contains chronological data about the
  1022.          migration in the form of activity and error entries.
  1023.          Each activity that is performed by a component during
  1024.          the migration process is contained in a record.  Each
  1025.          error entry is also contained in a record.  Both the
  1026.          activity and error entries are logged in the history
  1027.          file.
  1028.  
  1029.          If an error occurs during the Export phase, the network
  1030.          administrator should check the history file, find and
  1031.          correct the error, and start the migration from the
  1032.          beginning.
  1033.  
  1034.          If an error occurs during the Import phase and the
  1035.          error can be traced to an entry in the history file,
  1036.          the network administrator can correct the error in the
  1037.          temporary file and start the migration from the point at
  1038.          which the error occurred.
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.                                     1-9
  1068.          
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.          CHAPTER 2.  MIGRATING AN ENTIRE PCLP 1.3 DOMAIN AT ONE TIME
  1075.  
  1076.          This chapter describes the tasks required to migrate
  1077.          from a PCLP 1.3 domain (servers and requesters) to a LAN
  1078.          Server 1.3 environment all at one time.
  1079.  
  1080.          The following figure shows the typical migration
  1081.          scenario for this environment.
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.                                  2-1
  1124.         
  1125.         Original PC LAN                         Final LAN Server 1.3
  1126.        Program 1.3 Domain                              Domain
  1127.          (Domain IBMDC)                           (Domain IBM13DOM)
  1128.  
  1129.            ╔════╗                                      ╔════╗
  1130.            ║    ║    by download service               ║    ║
  1131.           ┌╚════╝┐║ --------------------------------->┌╚════╝┐║
  1132.           └──────┘╣                                   └──────┘╣
  1133.            PC13_W ║                                    DOS_LR ║
  1134.                   ║                                           ║
  1135.                   ║ ╔════╗                                    ║ ╔════╗
  1136.                   ║ ║RIPL║   by RIPL image                    ║ ║RIPL║
  1137.                   ║┌╚════╝┐ --------------------------------->║┌╚════╝┐
  1138.                   ╠└──────┘     create feature                ╠└──────┘
  1139.            ╔════╗ ║ PC13_W                             ╔════╗ ║ DOS_LR
  1140.            ║    ║ ║                                    ║    ║ ║
  1141.           ┌╚════╝┐║                                   ┌╚════╝┐║
  1142.           └──────┘╣       by diskette                 └──────┘╣
  1143.            PC13_W ║ -------------------------------->  DOS_LR ║
  1144.                   ║          installation                     ║
  1145.                   ║                                           ║
  1146.                   ║                                           ║
  1147.                   ║ ╔════╗                                    ║ ╔════╗
  1148.                   ║ ║    ║     by diskette                    ║ ║    ║
  1149.                   ║┌╚════╝┐ --------------------------------> ║┌╚════╝┐
  1150.                   ╠└──────┘       installation                ╠└──────┘
  1151.                   ║ PC13_W                                    ║ EE13_LR
  1152.           ╔════╗  ║                                   ╔════╗  ║
  1153.           ║    ║  ║                                   ║    ║  ║
  1154.         ┌─╚════╝─┐║            by diskette          ┌─╚════╝─┐║
  1155.         │ADSERV01│║-------------------------------->│ADSERV01│║
  1156.         └────────┘╣               installation      └────────┘╣
  1157.          PC13_AS  ║                                  LS13_AS  ║
  1158.                   ║  ╔════╗                                   ║  ╔════╗
  1159.                   ║  ║    ║                                   ║  ║    ║
  1160.                   ║┌─╚════╝─┐                                 ║┌─╚════╝─┐
  1161.                   ║│ IBMDC  │     by diskette                 ║│ IBMDC  │
  1162.                   ╠└────────┘ ------------------------------->╠└────────┘
  1163.                     PC13_DC          installation               LS13_DC
  1164.  
  1165.                        ==> ==> ==> ==> ==> ==> ==> ==> ==>
  1166.                                  Migration Path
  1167.         Legend:
  1168.         PC13_W  =  PC LAN Program 1.3 Workstation
  1169.         PC13_AS =  PC LAN Program 1.3 Additional Server
  1170.         PC13_DC =  PC LAN Program 1.3 Domain Controller
  1171.          DOS_LR =  DOS LAN Requester
  1172.         EE13_LR =  OS/2 Extended Edition 1.3 LAN Requester
  1173.         LS13_DC =  OS/2 LAN Server 1.3 Domain Controller
  1174.         LS13_AS =  OS/2 LAN Server 1.3 Additional Server
  1175.            RIPL =  Remote IPL workstation
  1176.  
  1177.          FIGURE 2-1. AN ENTIRE PCLP 1.3 DOMAIN MIGRATED TO LAN
  1178.                      SERVER 1.3 ALL AT ONE TIME
  1179.                                  2-2
  1180.          
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.          PREPARING THE NETWORK AND USER COMMUNITY
  1187.  
  1188.          The migration from a PCLP 1.3 environment to a LAN
  1189.          Server 1.3 environment can require a hardware upgrade
  1190.          for the servers.  For information about system, memory,
  1191.          and fixed-disk space requirements, see the IBM OPERATING
  1192.          SYSTEM/2 INFORMATION AND PLANNING GUIDE and the OS/2 LAN
  1193.          Server Version 1.3 slipcase cover.
  1194.  
  1195.          It is recommended that you notify system users about
  1196.          the upgrade to the new product release.  Include the
  1197.          following information in this notification:
  1198.  
  1199.          - Tell users about the schedule (when their workstation
  1200.            will be migrated).
  1201.  
  1202.          - Tell users to back up their home filesets before the
  1203.            migration and to restore the filesets after the
  1204.            migration has been completed (unless the network
  1205.            administrator is going to do this).
  1206.  
  1207.          - Tell users that private applications (that exist on
  1208.            the user's workstation only) will not be migrated.
  1209.            Explain that these applications must be added to their
  1210.            application selectors after the migration has been
  1211.            completed.
  1212.  
  1213.          - Tell users to get their new password from the network
  1214.            administrator after the migration has been completed.
  1215.  
  1216.  
  1217.          PLANNING FOR THE EXPORT PHASE
  1218.  
  1219.          Before you export the domain definitions to the
  1220.          temporary file, complete the following steps:
  1221.  
  1222.          1. Print the current LAN domain definitions by doing the
  1223.             following:
  1224.  
  1225.             a. Log on as an administrator to the source domain
  1226.                controller.
  1227.  
  1228.             b. Verify that no other users or administrators are
  1229.                logged on and accessing the DCDB.
  1230.  
  1231.             c. Select "PCLP" from the APPLICATION SELECTOR menu.
  1232.  
  1233.             d. Select "PRINTDDF" from the PCLP FUNCTIONS menu.
  1234.  
  1235.                                  2-3
  1236.          
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.          2. Create a backup copy of the current LAN domain
  1243.             definitions by using the following sequence of DOS
  1244.             XCOPY commands:
  1245.  
  1246.             XCOPY C:\PCLPUSER          A:\PCLPUSER          /S /E
  1247.             XCOPY C:\APPS              A:\APPS              /S /E
  1248.             XCOPY C:\PCLP13XS\USER.MDL A:\PCLP13XS\USER.MDL /S /E
  1249.             XCOPY C:\PCLP13XS\FILESETS A:\PCLP13XS\FILESETS /S /E
  1250.             XCOPY C:\PCLP13XS\PRINTERS A:\PCLP13XS\PRINTERS /S /E
  1251.             XCOPY C:\PCLP13XS\LISTS    A:\PCLP13XS\LISTS    /S /E
  1252.             XCOPY C:\PCLP13XS\BATCH    A:\PCLP13XS\BATCH    /S /E
  1253.  
  1254.             NOTE: This process may require more than one formatted
  1255.                   diskette.  If an XCOPY command requires more
  1256.                   than one diskette, you should use the BACKUP
  1257.                   command.  See your DOS documentation for
  1258.                   information about this command.
  1259.  
  1260.  
  1261.          EXPORTING THE DOMAIN DEFINITIONS TO A TEMPORARY DCDB FILE
  1262.  
  1263.          To export the domain definitions to a temporary DCDB file,
  1264.          complete the following steps at the source domain controller:
  1265.  
  1266.          1. Insert the Migration Utility diskette into the A:
  1267.             drive.
  1268.  
  1269.          2. Copy the following files to the C:\PCLP13XS\NET1_30
  1270.             directory (this syntax assumes you are installing
  1271.             from the A:\> prompt at the command line):
  1272.  
  1273.             A:\>copy A:\PCLP13MU.FMT C:\PCLP13XS\NET1_30
  1274.             A:\>copy A:\PCLP13MU.MSG C:\PCLP13XS\NET1_30
  1275.             A:\>copy A:\PCLPEXPO.EXE C:\PCLP13XS\NET1_30
  1276.  
  1277.             The PCLP13MU.FMT format file is used to generate the
  1278.             temporary DCDB file.  The PCLP13MU.MSG message file
  1279.             logs the activities (or messages) in the history
  1280.             file and displays prompts to the user at the
  1281.             workstation.  The PCLPEXPO.EXE file contains the
  1282.             executable Export program for PCLP 1.3.
  1283.  
  1284.          3. Remove the Migration Utility diskette from the A:
  1285.             drive.
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.                                  2-4
  1292.          
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.          4. Start all PCLP 1.3 servers (the domain controller
  1299.             and additional servers) in the domain.
  1300.  
  1301.          5. Log on as an administrator to the domain controller.
  1302.  
  1303.             NOTE:  You may have to change the NET START
  1304.                    parameter to make additional memory available
  1305.                    to enable you to log on to the domain
  1306.                    controller.
  1307.  
  1308.          6. Select "DOS".
  1309.  
  1310.          7. Make C:\PCLP13XS\NET1_30 the current directory.
  1311.  
  1312.          8. Enter the following to invoke the Export function:
  1313.  
  1314.             PCLPEXPO path
  1315.  
  1316.             where the path parameter specifies the full path
  1317.             and file name of the temporary DCDB file you want to
  1318.             create during the Export phase.  The path can include
  1319.             the drive letter.  For example, to create the temporary
  1320.             DCDB export file DCDB.TMP on the A: drive, enter the
  1321.             following:
  1322.  
  1323.             PCLPEXPO A:DCDB.TMP
  1324.  
  1325.             In the command, PCLPEXPO calls the executable Export
  1326.             program (PCLPEXPO.EXE), which starts the Export
  1327.             function.  The Export function reads each attribute
  1328.             for the LAN objects defined in the PCLP 1.3 source
  1329.             domain and maps each attribute to the corresponding
  1330.             attribute in the LAN Server 1.3 DCDB format.  The
  1331.             Export function then writes the attribute to a
  1332.             temporary DCDB file that can be edited by the network
  1333.             administrator as necessary.
  1334.  
  1335.             The following message is displayed when the Export
  1336.             function completes:
  1337.  
  1338.             Program completed successfully.
  1339.  
  1340.          9. If you have remote IPL machine definitions, do the
  1341.             following:
  1342.  
  1343.             a.  Enter the following to copy the RPL.MAP file to
  1344.                 a new diskette:
  1345.  
  1346.                 COPY C:\PCLP13XS\IMAGES\RPL.MAP A:
  1347.                                  2-5
  1348.          
  1349.  
  1350.  
  1351.  
  1352.  
  1353.          b. If the remote IPL server name has changed, edit the
  1354.             DCDB.TMP files and the RPL.MAP file to reflect the
  1355.             new server name.  Ensure that no extra characters
  1356.             or blank lines are added to the files.
  1357.  
  1358.          NOTES:
  1359.  
  1360.          1. If the DCDB being exported is larger than one
  1361.             diskette, the function prompts for another formatted
  1362.             diskette and a new file name.  The file names on the
  1363.             multiple diskettes should be in sequential order.
  1364.  
  1365.          2. If an error occurs, see APPENDIX, "ERROR MESSAGES
  1366.             AND ERROR RECOVERY," for information about how to
  1367.             continue.
  1368.  
  1369.          3. The C:\PCLP13XS\NET1_30\PCLP13MU.HST history file is
  1370.             created each time the Export function is invoked.
  1371.  
  1372.  
  1373.          PLANNING FOR THE IMPORT PHASE
  1374.  
  1375.          Before you import the domain definitions to the new DCDB,
  1376.          complete the following steps:
  1377.  
  1378.          1. Install the OS/2 EE 1.3 and LAN Server 1.3 programs
  1379.             on the workstation that has been designated as the
  1380.             new (destination) domain controller and the workstations
  1381.             designated as the additional servers.
  1382.  
  1383.  
  1384.          2. Verify that the source server (machine) name for the
  1385.             domain controller in the temporary DCDB file is the
  1386.             same as the server (machine) name for the domain
  1387.             controller in the destination domain.  If the names
  1388.             are not the same, edit the temporary file globally
  1389.             replacing the PCLP 1.3 domain controller server
  1390.             (machine) name with the LAN Server 1.3 domain
  1391.             controller server (machine) name.  Also, verify
  1392.             that all names of additional servers in the temporary
  1393.             file match the names of their counterpart servers in
  1394.             the destination domain.  If they are not the same,
  1395.             edit the temporary file and globally replace the PCLP
  1396.             server names with the new LAN Server 1.3 server
  1397.             (machine) names.
  1398.  
  1399.          3. Edit the temporary DCDB file to change all devices
  1400.             (such as LPT1) to queues (such as LPT1Q) in the
  1401.             PRINTER ALIASES section.
  1402.  
  1403.                                  2-6
  1404.          
  1405.  
  1406.  
  1407.  
  1408.             NOTE:
  1409.  
  1410.                If you print the temporary DCDB file after the
  1411.                Export phase completes, the DCDB prints in
  1412.                columnar form; however, the DCDB that is displayed
  1413.                on your workstation (if you are using the OS/2
  1414.                System Editor) is not.  To display the DCDB on your
  1415.                workstation exactly as it is printed out, you must
  1416.                change the font setting on the System Editor.
  1417.                Do the following:
  1418.  
  1419.                1. Select "Option" from the System Editor pull-down.
  1420.                2. Select "Set fonts" from the Option pull-down.
  1421.                3. Select "HELV font" from the Fonts panel.
  1422.  
  1423.  
  1424.          4. Define and start all LAN Server 1.3 servers.
  1425.  
  1426.          5. Log on as an administrator to the domain controller.
  1427.  
  1428.          6. Create a Print Manager spooler queue for each
  1429.             printer to be migrated.  See the IBM OPERATING
  1430.             SYSTEM/2 EXTENDED EDITION VERSION 1.3 USER'S
  1431.             GUIDE, VOLUME 1: BASE OPERATING SYSTEM for
  1432.             information about creating spooler queues.
  1433.  
  1434.          NOTES:
  1435.  
  1436.          1. A redirected drive cannot be used to import
  1437.             access control profiles.  For example, if the source
  1438.             domain has resources on Server 1 on the D: drive and
  1439.             the destination domain Server 1 does not have a
  1440.             physical D: drive, the temporary file must be edited
  1441.             to change the drive designation for all resources on
  1442.             Server 1 from the D: drive to the C: drive.
  1443.  
  1444.          2. The X: drive is reserved to perform the Import function.
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.                                  2-7
  1460.          
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.          IMPORTING THE DOMAIN DEFINITIONS TO THE DESTINATION DOMAIN
  1467.  
  1468.          To import the domain definitions to the new DCDB on the
  1469.          destination domain, complete the following steps at
  1470.          the destination domain controller:
  1471.  
  1472.          1. Invoke the Import function of the Migration Utility
  1473.             using the following command:
  1474.  
  1475.             LS12IMPO path
  1476.  
  1477.             where the path parameter specifies the full path
  1478.             and file name of the temporary DCDB file (created
  1479.             during the Export phase).  The path can include the
  1480.             drive letter.  For example, to invoke the Import
  1481.             function with the temporary DCDB export file DCDB.TMP
  1482.             located on the A: drive, enter the following:
  1483.  
  1484.             LS12IMPO A:DCDB.TMP
  1485.  
  1486.             In the command, LS12IMPO calls the Import function
  1487.             (which is part of the LAN Server 1.3 product and does
  1488.             not require installation).  The Import function reads
  1489.             the attributes of each LAN object from the temporary
  1490.             DCDB file in order, and writes these attributes to
  1491.             the new DCDB in the destination domain.  A message is
  1492.             displayed on the workstation for each object definition
  1493.             that is successfully written to the new DCDB.
  1494.  
  1495.             If the Import function encounters a duplicate server
  1496.             and path or server and spooler queue combination, or
  1497.             cannot process an attribute, a message that indicates
  1498.             the error is displayed and the function stops.  The
  1499.             error message is also logged in the
  1500.             \IBMLAN\NETPROG\LS12MU.HST file (which also contains
  1501.             entries for all migration activities performed).
  1502.             After you correct the error, edit the temporary DCDB
  1503.             file to correct the attribute in this file as well,
  1504.             and then start the Import function again using the
  1505.             LS12IMPO command described previously.
  1506.  
  1507.             NOTES:
  1508.  
  1509.             a. Duplicate user, group, or resource information is
  1510.                ignored by the Import function (the process does
  1511.                not stop).  However, warning messages that indicate
  1512.                the duplicate information are displayed on the
  1513.                workstation and logged in the history file.
  1514.  
  1515.                                  2-8
  1516.          
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.             b. If you are at the C: prompt and want to print
  1523.                the LS12MU.HST file to locate the error, enter
  1524.                the following command:  TYPE LS12MU.HST > PRN
  1525.  
  1526.             Before the Import function completes, it also
  1527.             generates the \IBMLAN\NETPROG\DCDBPSWD.DAT password
  1528.             file.  This file contains new passwords for users
  1529.             that are migrated to the new LAN Server 1.3 domain.
  1530.  
  1531.             When the Import function completes, the following
  1532.             message is displayed:
  1533.  
  1534.             Program completed successfully.
  1535.  
  1536.             NOTE:  If multiple diskettes were used to export the
  1537.                    domain definitions, you must run the Import
  1538.                    function on each diskette. (You will not be
  1539.                    prompted to insert multiple diskettes.)
  1540.                    Be sure to process the diskettes in the
  1541.                    sequential order in which they were created.
  1542.                    The Import function is actually complete after
  1543.                    the last diskette has been processed.
  1544.  
  1545.             If the Import function does not complete successfully,
  1546.             look through the LS12MU.HST history file to find the
  1547.             error.  If you correct an error, you must rename the
  1548.             history file to preserve its entries before starting
  1549.             the Import function again.
  1550.  
  1551.          2. Secure the \IBMLAN\NETPROG\DCDBPSWD.DAT password
  1552.             file that was generated by the Import function.
  1553.  
  1554.          3. Migrate the resources from the PCLP domain
  1555.             controller to the LAN Server 1.3 domain controller.
  1556.             This includes printers, serial devices, files, and
  1557.             applications.
  1558.  
  1559.          4. Migrate the contents of the users' home directories
  1560.             on the PCLP domain controller to the LAN Server 1.3
  1561.             domain controller.
  1562.  
  1563.          5. If you have remote IPL machine definitions, copy the
  1564.             RPL.MAP file to the appropriate subdirectory:
  1565.  
  1566.             COPY A:RPL.MAP  C:\IBMLAN\DCDB\IMAGES
  1567.  
  1568.  
  1569.  
  1570.  
  1571.                                  2-9
  1572.          
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.          COMPLETING THE MIGRATION
  1579.  
  1580.          Complete the migration with the following steps:
  1581.  
  1582.          1. Print the imported LAN domain definitions and verify
  1583.             the migrated definitions by doing the following:
  1584.  
  1585.             a. Log on as an administrator to the domain
  1586.                controller.
  1587.  
  1588.             b. Select "Definitions" from the main menu.
  1589.  
  1590.             c. Select "Print the domain definition" from the
  1591.                Definitions pull-down.
  1592.  
  1593.             d. Select the default printer (or the printer that
  1594.                applies to you) from the Device Name column on the
  1595.                Print Domain Definition panel.
  1596.  
  1597.          2. Issue new passwords for the user IDs that require a
  1598.             password from the \IBMLAN\NETPROG\DCDBPSWD.DAT file
  1599.             that was generated during the Import function.
  1600.  
  1601.          3. If you have remote IPL images that were migrated, do the
  1602.             following:
  1603.  
  1604.             - If standard image names were migrated, use the LAN
  1605.               Server 1.3 full-screen interface to select and make
  1606.               each standard image used in the RPL.MAP file.
  1607.  
  1608.             - If nonstandard images were migrated, the network
  1609.               administrator must create and make each nonstandard
  1610.               image.  See the IBM OPERATING SYSTEM/2 LOCAL AREA
  1611.               NETWORK SERVER VERSION 1.3 NETWORK ADMINISTRATOR'S
  1612.               GUIDE for more information.
  1613.  
  1614.          4. For the requesters in the domain:
  1615.  
  1616.             a. Create DOS LAN Requester IPL images and machine
  1617.                definitions to replace the PCLP 1.3 Requester IPL
  1618.                images and definitions if remote IPL machines will
  1619.                continue to be supported.  See the IBM OPERATING
  1620.                SYSTEM/2 LOCAL AREA NETWORK SERVER VERSION 1.3
  1621.                NETWORK ADMINISTRATOR'S GUIDE for information
  1622.                about how to create these images.
  1623.  
  1624.  
  1625.  
  1626.  
  1627.                                  2-10
  1628.          
  1629.  
  1630.  
  1631.  
  1632.  
  1633.             b. Install the appropriate operating system on the
  1634.                workstations.
  1635.  
  1636.                If the workstation will be an OS/2 requester,
  1637.                verify that the workstation is appropriately
  1638.                configured (memory and fixed-disk space) and
  1639.                install the OS/2 EE 1.3 program.  See IBM
  1640.                OPERATING SYSTEM/2 EXTENDED EDITION VERSION 1.3
  1641.                GETTING STARTED for installation information.
  1642.  
  1643.                If the workstation will be a DOS requester,
  1644.                install DOS 3.3 or 4.01, the PC LAN Support
  1645.                Program, and the IBM DOS LAN Requester program.
  1646.                See IBM OPERATING SYSTEM/2 LOCAL AREA NETWORK
  1647.                SERVER VERSION 1.3 GETTING STARTED for
  1648.                installation information.
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.                                     2-11
  1684.          
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.          CHAPTER 3.  MIGRATING A PCLP 1.3 DOMAIN IN STAGES
  1691.  
  1692.          This chapter describes the tasks required to migrate
  1693.          from a PCLP 1.3 domain to a LAN Server 1.3 environment
  1694.          over time, in stages.
  1695.  
  1696.          During this staged migration, the network administrator
  1697.          must install and configure an additional system as the
  1698.          new LAN Server 1.3 domain controller.  While the network
  1699.          administrator is migrating the domain definitions and
  1700.          existing resources from the PCLP domain to this
  1701.          additional system (which will serve as the LAN Server
  1702.          1.3 domain controller) and setting up the new
  1703.          environment, the existing PCLP 1.3 domain controller is
  1704.          still providing logon service to users.
  1705.  
  1706.          It is important to note that once a server is migrated,
  1707.          users whose home filesets are on that server cannot log
  1708.          on to the domain until the migration has been completed.
  1709.  
  1710.          To provide the required access to the LAN Server 1.3
  1711.          resources from the PCLP 1.3 requesters, the network
  1712.          administrator should define appropriate access control
  1713.          privileges to the GUEST user ID in the LAN Server 1.3
  1714.          domain.  After all PCLP 1.3 requesters have been
  1715.          upgraded to OS/2 EE 1.3 requesters or DOS LAN
  1716.          Requesters, the access privileges assigned to the GUEST
  1717.          user ID should be reviewed and modified as required.
  1718.          See the IBM OPERATING SYSTEM/2 LOCAL AREA NETWORK SERVER
  1719.          VERSION 1.3 NETWORK ADMINISTRATOR'S GUIDE for
  1720.          information about how to assign the access control
  1721.          privileges to the GUEST user ID.
  1722.  
  1723.          NOTE:  Using the GUEST user ID in this situation not only
  1724.                 allows users at PCLP 1.3 requesters to access LAN
  1725.                 Server 1.3 resources; it also allows any user ID
  1726.                 not defined in the LAN Server 1.3 domain to also
  1727.                 access the LAN Server 1.3 resources.
  1728.  
  1729.          The following figure shows the typical migration
  1730.          scenario for this environment.
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.                                  3-1
  1740.          
  1741.  Original PC LAN                                    Final LAN Server 1.3
  1742. Program 1.3 Domain         Intermediate Stage               Domain
  1743.  (Domain IBMDC)            (Domains IBMDC             (Domain IBM13DOM)
  1744.                                 and IBM13DOM)
  1745.  
  1746.     ╔════╗                     ╔════╗                    ╔════╗
  1747.     ║RIPL║                     ║RIPL║                    ║RIPL║
  1748.    ┌╚════╝┐║                  ┌╚════╝┐║                 ┌╚════╝┐║
  1749.    └──────┘╣                  └──────┘╣                 └──────┘╣
  1750.     PC13_W ║ ╔════╗            DOS_LR ║ ╔════╗           DOS_LR ║ ╔════╗
  1751.            ║ ║    ║                   ║ ║    ║                  ║ ║    ║
  1752.            ║┌╚════╝┐                  ║┌╚════╝┐                 ║┌╚════╝┐
  1753.     ╔════╗ ╠└──────┘           ╔════╗ ╠└──────┘          ╔════╗ ╠└──────┘
  1754.     ║    ║ ║ PC13_W            ║    ║ ║ PC13_W           ║    ║ ║ DOS_LR
  1755.    ┌╚════╝┐║                  ┌╚════╝┐║                 ┌╚════╝┐║
  1756.    └──────┘╣                  └──────┘╣                 └──────┘╣
  1757.     PC13_W ║ ╔════╗            DOS_LR ║ ╔════╗           DOS_LR ║ ╔════╗
  1758.            ║ ║    ║                   ║ ║    ║                  ║ ║    ║
  1759.            ║┌╚════╝┐                  ║┌╚════╝┐                 ║┌╚════╝┐
  1760.    ╔════╗  ╠└──────┘          ╔════╗  ╠└──────┘         ╔════╗  ╠└──────┘
  1761.    ║    ║  ║ PC13_W           ║    ║  ║ PC13_W          ║    ║  ║ EE13_LR
  1762.  ┌─╚════╝─┐║                ┌─╚════╝─┐║               ┌─╚════╝─┐║
  1763.  │ADSERV01│║                │ADSERV01│║               │ADSERV01│║
  1764.  └────────┘╣                └────────┘╣               └────────┘╣
  1765.   PC13_AS  ║  ╔════╗         LS13_AS  ║  ╔════╗        LS13_AS  ║
  1766.            ║  ║    ║                  ║  ║    ║                 ║
  1767.            ║┌─╚════╝─┐                ║┌─╚════╝─┐               ║
  1768.            ║│ IBMDC  │                ║│ IBMDC  │               ║
  1769.            ╠└────────┘                ╠└────────┘               ╠
  1770.            ║ PC13_DC                  ║  PC13_DC                ║
  1771.            ║                          ║(PCLP Logon              ║
  1772.            ║                  ╔════╗  ║ Services  )     ╔════╗  ║
  1773.            ║                  ║    ║  ║                 ║    ║  ║
  1774.            ║                ┌─╚════╝─┐║               ┌─╚════╝─┐║
  1775.            ║                │ LS13DC │╣               │ LS13DC │╣
  1776.            ║                └────────┘║               └────────┘║
  1777.                              LS13_DC                   LS13_DC
  1778.                         (External Resources)     (Complete Control)
  1779.  
  1780.                   ==> ==> ==> ==> ==> ==> ==> ==> ==> ==> ==>
  1781.                                  Migration Path
  1782.  
  1783.         Legend:
  1784.         PC13_W  =  PC LAN Program 1.3 Workstation
  1785.         PC13_AS =  PC LAN Program 1.3 Additional Server
  1786.         PC13_DC =  PC LAN Program 1.3 Domain Controller
  1787.          DOS_LR =  DOS LAN Requester
  1788.         EE13_LR =  OS/2 Extended Edition 1.3 LAN Requester
  1789.         LS13_DC =  OS/2 LAN Server 1.3 Domain Controller
  1790.         LS13_AS =  OS/2 LAN Server 1.3 Additional Server
  1791.            RIPL =  Remote IPL workstation.
  1792.  
  1793.          FIGURE 3-1. A PCLP 1.3 DOMAIN MIGRATED TO LAN SERVER 1.3
  1794.                      OVER TIME IN STAGES
  1795.                                  3-2
  1796.          
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.          PREPARING THE NETWORK AND USER COMMUNITY
  1803.  
  1804.          The migration from a PCLP 1.3 environment to a LAN
  1805.          Server 1.3 environment can require a hardware upgrade
  1806.          for the servers.  For information about system, memory,
  1807.          and fixed-disk space requirements, see the IBM OPERATING
  1808.          SYSTEM/2 INFORMATION AND PLANNING GUIDE and the OS/2 LAN
  1809.          Server Version 1.3 slipcase cover.
  1810.  
  1811.          It is recommended that you notify system users about
  1812.          the upgrade to the new product release.  Include the
  1813.          following information in this notification:
  1814.  
  1815.          - Tell users about the schedule (when their
  1816.            workstation will be migrated).
  1817.  
  1818.          - Tell users to back up their home filesets before the
  1819.            migration and to restore the filesets after the
  1820.            migration has been completed (unless the network
  1821.            administrator is going to do this).
  1822.  
  1823.          - Tell users that private applications (that exist on
  1824.            the user's workstation only) will not be migrated.
  1825.            Explain that these applications must be added to their
  1826.            application selectors when the migration has been
  1827.            completed.
  1828.  
  1829.          - Tell users to get their new password from the network
  1830.            administrator after the migration has been completed.
  1831.  
  1832.  
  1833.          PLANNING FOR THE EXPORT PHASE
  1834.  
  1835.          Before you export the domain definitions to the
  1836.          temporary file, complete the following steps:
  1837.  
  1838.          1. Connect an additional system that will serve as the
  1839.             new LAN Server 1.3 domain controller to the current
  1840.             network.  See the documentation that came with your
  1841.             network adapter for connection information.
  1842.  
  1843.          2. Install and configure the new system as the LAN
  1844.             Server 1.3 domain controller.  See IBM OPERATING
  1845.             SYSTEM/2 LOCAL AREA NETWORK SERVER VERSION 1.3
  1846.             GETTING STARTED for information about installing
  1847.             this system.
  1848.  
  1849.  
  1850.  
  1851.                                  3-3
  1852.          
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.             NOTE:  In these instructions, the LAN Server 1.3
  1859.                    domain name is referred to in examples as
  1860.                    IBM13DOM and the server name for the domain
  1861.                    controller is referred to as LS13DC.
  1862.  
  1863.          3. On the existing (source) domain controller, print the
  1864.             current LAN domain definitions by doing the following:
  1865.  
  1866.             a. Log on as an administrator to the domain
  1867.                controller.
  1868.  
  1869.             b. Verify that no other users or administrators are
  1870.                logged on and accessing the DCDB.
  1871.  
  1872.             c. Select "PCLP" from the APPLICATION SELECTOR menu.
  1873.  
  1874.             d. Select "PRINTDDF" from the PCLP FUNCTIONS menu.
  1875.  
  1876.          4. Also on the existing domain controller, create a
  1877.             backup copy of the current LAN domain definitions
  1878.             by using the following sequence of DOS XCOPY commands:
  1879.  
  1880.             XCOPY C:\PCLPUSER          A:\PCLPUSER          /S /E
  1881.             XCOPY C:\APPS              A:\APPS              /S /E
  1882.             XCOPY C:\PCLP13XS\USER.MDL A:\PCLP13XS\USER.MDL /S /E
  1883.             XCOPY C:\PCLP13XS\FILESETS A:\PCLP13XS\FILESETS /S /E
  1884.             XCOPY C:\PCLP13XS\PRINTERS A:\PCLP13XS\PRINTERS /S /E
  1885.             XCOPY C:\PCLP13XS\LISTS    A:\PCLP13XS\LISTS    /S /E
  1886.             XCOPY C:\PCLP13XS\BATCH    A:\PCLP13XS\BATCH    /S /E
  1887.  
  1888.             NOTE: This process may require more than one formatted
  1889.                   diskette.  If an XCOPY command requires more
  1890.                   than one diskette, you should use the BACKUP
  1891.                   command.  See your DOS documentation for
  1892.                   information about this command.
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.                                  3-4
  1908.          
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.          EXPORTING THE DOMAIN DEFINITIONS TO A TEMPORARY DCDB FILE
  1915.  
  1916.          To export the domain definitions to a temporary DCDB file,
  1917.          complete the following steps at the source domain controller:
  1918.  
  1919.          1. Insert the Migration Utility diskette into the A:
  1920.             drive.
  1921.  
  1922.          2. Copy the following files to the C:\PCLP13XS\NET1_30
  1923.             directory (this syntax assumes you are installing from
  1924.             the A:\> prompt at the command line):
  1925.  
  1926.             A:\>copy A:\PCLP13MU.FMT C:\PCLP13XS\NET1_30
  1927.             A:\>copy A:\PCLP13MU.MSG C:\PCLP13XS\NET1_30
  1928.             A:\>copy A:\PCLPEXPO.EXE C:\PCLP13XS\NET1_30
  1929.  
  1930.             The PCLP13MU.FMT format file is used to generate the
  1931.             temporary DCDB file.  The PCLP13MU.MSG message file
  1932.             logs the activities (or messages) in the history file
  1933.             and displays prompts to the user at the workstation.
  1934.             The PCLPEXPO.EXE file contains the executable Export
  1935.             program for PCLP 1.3.
  1936.  
  1937.          3. Remove the Migration Utility diskette from the
  1938.             A: drive.
  1939.  
  1940.          4. Start all PCLP 1.3 servers (the domain controller and
  1941.             additional servers) in the domain.
  1942.  
  1943.          5. Log on as an administrator to the domain controller.
  1944.  
  1945.          6. Make C:\PCLP13XS\NET1_30 the current directory.
  1946.  
  1947.          7. Enter the following to invoke the Export function:
  1948.  
  1949.             PCLPEXPO path
  1950.  
  1951.             where the path parameter specifies the full path
  1952.             and file name of the temporary DCDB file you want to
  1953.             create during the Export phase.  The path can include
  1954.             the drive letter.  For example, to create the
  1955.             temporary DCDB export file DCDB.TMP on the A: drive,
  1956.             enter the following:
  1957.  
  1958.             PCLPEXPO A:DCDB.TMP
  1959.  
  1960.  
  1961.  
  1962.  
  1963.                                  3-5
  1964.          
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.             In the command, PCLPEXPO calls the executable Export
  1971.             program (PCLPEXPO.EXE), which starts the Export
  1972.             function.  The Export function reads each attribute
  1973.             for the LAN objects defined in the PCLP 1.3 source
  1974.             domain and maps the attribute to the corresponding
  1975.             attribute in the LAN Server 1.3 DCDB format.  The
  1976.             Export function then writes the attribute to a
  1977.             temporary DCDB file that can be edited by the network
  1978.             administrator as necessary.
  1979.  
  1980.             The following message is displayed when the Export
  1981.             function completes:
  1982.  
  1983.             Program completed successfully.
  1984.  
  1985.          8. If you have remote IPL machine definitions, do the
  1986.             following:
  1987.  
  1988.             a. Enter the following to copy the RPL.MAP file to
  1989.                a new diskette:
  1990.  
  1991.                COPY C:\PCLP13XS\IMAGES\RPL.MAP  A:
  1992.  
  1993.             b. If the remote IPL server name has changed, edit
  1994.                the DCDB.TMP files and the RPL.MAP file to
  1995.                reflect the new server name.  Ensure that no extra
  1996.                characters or blank lines are added to the files.
  1997.  
  1998.          NOTES:
  1999.  
  2000.          1. If the DCDB being exported is larger than one
  2001.             diskette, the function prompts for another formatted
  2002.             diskette and a new file name.  The file names on the
  2003.             multiple diskettes should be in sequential order.
  2004.  
  2005.          2. If an error occurs, see APPENDIX, "ERROR MESSAGES
  2006.             AND ERROR RECOVERY," for information about how to
  2007.             continue.
  2008.  
  2009.          3. The C:\PCLP13XS\NET1_30\PCLP13MU.HST history file is
  2010.             created each time the Export function is invoked.
  2011.  
  2012.  
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.                                  3-6
  2020.          
  2021.  
  2022.  
  2023.  
  2024.  
  2025.          PLANNING FOR THE IMPORT PHASE
  2026.  
  2027.          Before you import the domain definitions to the new DCDB,
  2028.          complete the following steps:
  2029.  
  2030.          1. Install the OS/2 EE 1.3 and LAN Server 1.3 programs
  2031.             on the workstation that has been designated as the
  2032.             new (destination) domain controller and the workstations
  2033.             designated as the additional servers.
  2034.  
  2035.          2. Edit the temporary DCDB file to change the following:
  2036.  
  2037.             a. All occurrences of the server name IBMDC to LS13DC.
  2038.             b. All devices (such as LPT1) to queues (such as
  2039.                LPT1Q) in the PRINTER ALIASES section.
  2040.  
  2041.          NOTES:
  2042.  
  2043.             a. Verify that the server (machine) names in the
  2044.                temporary file are the same names that are in the
  2045.                destination domain.  If they are not the same,
  2046.                edit the temporary file and globally replace the
  2047.                PCLP server (machine) names with the new LAN Server
  2048.                1.3 server (machine) names.
  2049.  
  2050.             b. If you print the temporary DCDB file after the
  2051.                Export phase completes, the DCDB prints in
  2052.                columnar form; however, the DCDB that is displayed
  2053.                on your workstation (if you are using the OS/2
  2054.                System Editor) is not.  To display the DCDB on your
  2055.                workstation exactly as it is printed out, you must
  2056.                change the font setting on the System Editor.
  2057.                Do the following:
  2058.  
  2059.                1. Select "Option" from the System Editor pull-down.
  2060.                2. Select "Set fonts" from the Option pull-down.
  2061.                3. Select "HELV font" from the Fonts panel.
  2062.  
  2063.          3. Define and start all LAN Server 1.3 servers.
  2064.  
  2065.          4. Log on as an administrator to the domain controller.
  2066.  
  2067.          5. Create a Print Manager spooler queue for each
  2068.             printer to be migrated.  See IBM OPERATING SYSTEM/2
  2069.             EXTENDED EDITION VERSION 1.3 USER'S GUIDE, VOLUME 1:
  2070.             BASE OPERATING SYSTEM for information about creating
  2071.             spooler queues.
  2072.  
  2073.  
  2074.  
  2075.                                  3-7
  2076.          
  2077.  
  2078.  
  2079.  
  2080.          NOTES:
  2081.  
  2082.          1. A redirected drive cannot be used to import
  2083.             access control profiles.  For example, if the source
  2084.             domain has resources on Server 1 on the D: drive and
  2085.             the destination domain Server 1 does not have a
  2086.             physical D: drive, the temporary file must be edited
  2087.             to change the drive designation for all resources on
  2088.             Server 1 from the D: drive to the C: drive.
  2089.  
  2090.          2. The X: drive is reserved to perform the Import function.
  2091.  
  2092.          IMPORTING THE DOMAIN DEFINITIONS TO THE DESTINATION DOMAIN
  2093.  
  2094.          To import the domain definitions to the DCDB on the
  2095.          destination domain, complete the following steps at
  2096.          the destination domain controller:
  2097.  
  2098.          1. Invoke the Import function of the Migration Utility
  2099.             using the following command:
  2100.  
  2101.             LS12IMPO path
  2102.  
  2103.             where the path parameter specifies the full path
  2104.             and file name of the temporary DCDB file (created
  2105.             during the Export phase).  The path can include the
  2106.             drive letter.  For example, to invoke the Import
  2107.             function with the temporary DCDB export file DCDB.TMP
  2108.             located on the A: drive, enter the following:
  2109.  
  2110.             LS12IMPO A:DCDB.TMP
  2111.  
  2112.             In the command, LS12IMPO calls the Import function
  2113.             (which is part of the LAN Server 1.3 product and does
  2114.             not require installation).  The Import function reads
  2115.             the attributes of each LAN object from the temporary
  2116.             DCDB file in order and writes these attributes to
  2117.             the new DCDB in the destination domain.  A message is
  2118.             displayed on the workstation for each object definition
  2119.             that is successfully written to the new DCDB.
  2120.  
  2121.             If the Import function encounters a duplicate server
  2122.             and path or server and spooler queue combination, or
  2123.             cannot process an attribute, a message that indicates
  2124.             the error is displayed and the function stops.  The
  2125.             error message is also logged in the
  2126.             \IBMLAN\NETPROG\LS12MU.HST file (which also contains
  2127.             entries for all migration activities performed).
  2128.             After you correct the error, edit the temporary DCDB
  2129.  
  2130.  
  2131.                                  3-8
  2132.          
  2133.  
  2134.  
  2135.  
  2136.  
  2137.             file to correct the attribute in this file as well,
  2138.             and then start the Import function again using the
  2139.             LS12IMPO command described previously.
  2140.  
  2141.             NOTES:
  2142.  
  2143.             a. Duplicate user, group, or resource information is
  2144.                ignored by the Import function (the process does
  2145.                not stop).  However, warning messages that indicate
  2146.                the duplicate information are displayed on the
  2147.                workstation and logged in the history file.
  2148.  
  2149.             b. If you are at the C: prompt and want to print
  2150.                the LS12MU.HST file to locate the error, enter
  2151.                the following command:  TYPE LS12MU.HST > PRN
  2152.  
  2153.             Before the Import function completes, it also
  2154.             generates the \IBMLAN\NETPROG\DCDBPSWD.DAT password
  2155.             file.  This file contains new passwords for users
  2156.             that are migrated to the new LAN Server 1.3 domain.
  2157.  
  2158.             When the Import function completes, the following
  2159.             message is displayed:
  2160.  
  2161.             Program completed successfully.
  2162.  
  2163.             NOTE:  If multiple diskettes were used to export the
  2164.                    domain definitions, you must run the Import
  2165.                    function on each diskette. (You will not be
  2166.                    prompted to insert multiple diskettes.)
  2167.                    Be sure to process the diskettes in the same
  2168.                    sequential order in which they were created.
  2169.                    The Import function is actually complete after
  2170.                    the last diskette has been processed.
  2171.  
  2172.             If the Import function does not complete successfully,
  2173.             look through the LS12MU.HST history file to find the
  2174.             error.  If you correct an error, you must rename the
  2175.             history file to preserve its entries before starting
  2176.             the Import function again.
  2177.  
  2178.          2. Secure the \IBMLAN\NETPROG\DCDBPSWD.DAT password file
  2179.             that was generated by the Import function.
  2180.  
  2181.          3. Migrate the resources from the PCLP domain controller
  2182.             to the LAN Server 1.3 domain controller.  This
  2183.             includes printers, serial devices, files, and
  2184.             applications.
  2185.  
  2186.  
  2187.                                  3-9
  2188.          
  2189.  
  2190.  
  2191.  
  2192.  
  2193.          4. Migrate the contents of the users' home directories
  2194.             on the PCLP domain controller to the LAN Server 1.3
  2195.             domain controller.
  2196.  
  2197.          5. If you have remote IPL machine definitions, copy the
  2198.             RPL.MAP file to the appropriate subdirectory:
  2199.  
  2200.             COPY A:RPL.MAP  C:\IBMLAN\DCDB\IMAGES
  2201.  
  2202.          SETTING UP THE INTERMEDIATE ENVIRONMENT
  2203.  
  2204.          Set up the intermediate environment (see Figure 3-1)
  2205.          with the following steps:
  2206.  
  2207.          1. Print the imported LAN domain definitions and verify
  2208.             the migrated definitions by doing the following:
  2209.  
  2210.             a. Log on as an administrator to the domain
  2211.                controller.
  2212.  
  2213.             b. Select "Definitions" from the main menu.
  2214.  
  2215.             c. Select "Print the domain definition" from the
  2216.                Definitions pull-down.
  2217.  
  2218.             d. Select the default printer (or the printer that
  2219.                applies to you) from the Device Name column on
  2220.                the Print Domain Definition panel.
  2221.  
  2222.          2. Create new external resource definitions to access
  2223.             the current resources after they are migrated to the
  2224.             LAN Server 1.3 domain.
  2225.  
  2226.             For example, on an existing PCLP 1.3 domain controller
  2227.             called IBMDC, the directory C:\PAYROLL\PAY89 is shared
  2228.             with the network name PAY (with the definition
  2229.             NET SHARE PAY=C:\PAYROLL\PAY89), and has the
  2230.             following NET USE definition:
  2231.  
  2232.             NET USE E: \\IBMDC\PAY
  2233.  
  2234.             To access the PAY resource after it is migrated to
  2235.             the new LAN Server 1.3 domain controller (LS13DC),
  2236.             change the NET USE definition to the following:
  2237.  
  2238.             NET USE E: \\LS13DC\PAY
  2239.  
  2240.  
  2241.  
  2242.  
  2243.                                  3-10
  2244.          
  2245.  
  2246.  
  2247.  
  2248.  
  2249.             If the names of additional servers are maintained
  2250.             when installing LAN Server 1.3, no changes to NET USE
  2251.             resource definitions are required for the files
  2252.             resources on the additional server.  For example, the
  2253.             network name PAY has the following NET USE definition
  2254.             on an additional server called ADSERV01:
  2255.  
  2256.             NET USE E: \\ADSERV01\PAY
  2257.  
  2258.             If the additional server name was maintained
  2259.             (ADSERV01), the NET USE definition is still valid.
  2260.  
  2261.             Since PCLP shares printer ports (such as LPT1 and
  2262.             LPT2), the network administrator must create printer
  2263.             queues for the printer resources to be shared in the
  2264.             LAN Server 1.3 environment.  For example, a printer
  2265.             is defined on the existing PCLP 1.3 domain controller
  2266.             to be shared with the following NET SHARE and NET USE
  2267.             definitions:
  2268.  
  2269.             NET SHARE PRINT1 = LPT2
  2270.             NET USE LPT3 \\IBMDC\PRINT1
  2271.  
  2272.             In the LAN Server 1.3 environment, the NET SHARE and
  2273.             NET USE definitions are as follows:
  2274.  
  2275.             NET SHARE LPT2Q /PRINT
  2276.             NET USE LPT3 \\LS13DC\LPT2Q
  2277.  
  2278.             LPT2Q is the queue name created with the Print
  2279.             Manager for the migrated printer that is attached to
  2280.             the LPT1 port on server LS13DC.
  2281.  
  2282.          3. Give the GUEST user ID access permission to those
  2283.             network resources required by users at PCLP
  2284.             workstations.
  2285.  
  2286.          4. Verify that all user logon assignments (NET USE
  2287.             definitions) have been updated as required.
  2288.  
  2289.          5. Issue the new passwords for the user IDs that require
  2290.             a password from the \IBMLAN\NETPROG\DCDBPSWD.DAT
  2291.             file that was generated during the Import phase.
  2292.  
  2293.          6. If you have remote IPL images that were migrated, do the
  2294.             following:
  2295.  
  2296.             - If standard image names were migrated, use the LAN
  2297.               Server full-screen interface to select and make
  2298.               each standard image used in the RPL.MAP file.
  2299.                                  3-11
  2300.          
  2301.  
  2302.  
  2303.  
  2304.  
  2305.             - If nonstandard images were migrated, the network
  2306.               administrator must create and make each nonstandard
  2307.               image.  See the IBM OPERATING SYSTEM/2 LOCAL AREA
  2308.               NETWORK SERVER VERSION 1.3 NETWORK ADMINISTRATOR'S
  2309.               GUIDE for more information.
  2310.  
  2311.          7. For the requesters in the domain:
  2312.  
  2313.             a. Create DOS LAN Requester IPL images to replace the
  2314.                PCLP 1.3 Requester IPL images if remote IPL
  2315.                machines will continue to be supported.  See
  2316.                the IBM OPERATING SYSTEM/2 LOCAL AREA NETWORK
  2317.                SERVER VERSION 1.3 NETWORK ADMINISTRATOR'S GUIDE
  2318.                for information about how to create these images.
  2319.  
  2320.             b. Install the appropriate operating system on the
  2321.                requesters.
  2322.  
  2323.                If the workstation will be an OS/2 requester,
  2324.                verify that the workstation is appropriately
  2325.                configured (memory and fixed-disk space), and
  2326.                install the OS/2 EE 1.3 program.  See IBM
  2327.                OPERATING SYSTEM/2 EXTENDED EDITION VERSION 1.3
  2328.                GETTING STARTED for installation information.
  2329.  
  2330.                If the workstation will be a DOS LAN Requester,
  2331.                install DOS 3.3 or 4.01, the PC LAN Support
  2332.                Program, and the IBM DOS LAN Requester program.
  2333.                See IBM OPERATING SYSTEM/2 LOCAL AREA NETWORK
  2334.                SERVER VERSION 1.3 GETTING STARTED for
  2335.                installation information.
  2336.  
  2337.          In summary, the intermediate environment has now been
  2338.          created.  Users at PCLP 1.3 workstations continue to
  2339.          log on at the PCLP domain controller.  Users at DOS
  2340.          LAN Requesters or EE 1.3 Requesters log on to the new
  2341.          LAN Server 1.3 domain.  The PCLP users have access to
  2342.          the network resources on the LAN Server 1.3 domain
  2343.          controller to which the GUEST user ID has been given
  2344.          access permission.
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.                                  3-12
  2356.          
  2357.  
  2358.  
  2359.  
  2360.  
  2361.          COMPLETING THE MIGRATION
  2362.  
  2363.          Complete the migration with the following steps:
  2364.  
  2365.          1. Upgrade the PCLP workstations to OS/2 EE 1.3
  2366.             requesters or DOS LAN Requesters.
  2367.  
  2368.          2. Review the GUEST user ID account.  Revise as
  2369.             necessary to restrict the access permissions.
  2370.  
  2371.          The PCLP 1.3 domain controller is no longer needed to
  2372.          provide logon service.  This workstation can now be
  2373.          reconfigured as an additional server or requester as
  2374.          required by your network.  See the IBM OPERATING
  2375.          SYSTEM/2 INFORMATION AND PLANNING GUIDE and the LAN
  2376.          Server 1.3 slipcase cover for server memory,
  2377.          fixed-disk, and minimum system requirements.
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.  
  2386.  
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.                                    3-13
  2412.          
  2413.  
  2414.  
  2415.  
  2416.  
  2417.          CHAPTER 4.  MIGRATING AN ENTIRE LAN SERVER 1.0 DOMAIN AT
  2418.                      ONE TIME
  2419.  
  2420.          This chapter describes the tasks required to migrate
  2421.          from a LAN Server 1.0 environment to a LAN Server 1.3
  2422.          environment all at one time.
  2423.  
  2424.          The following figure shows the typical migration
  2425.          scenario for this environment.
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451.  
  2452.  
  2453.  
  2454.  
  2455.  
  2456.  
  2457.  
  2458.  
  2459.  
  2460.  
  2461.  
  2462.  
  2463.  
  2464.  
  2465.  
  2466.  
  2467.                                  4-1
  2468.        
  2469.        Original LAN Server 1.0 Domain           Final LAN Server 1.3 Domain
  2470.          (Domain IBMDC)                             (Domain IBM13DOM)
  2471.  
  2472.            ╔════╗                                      ╔════╗
  2473.            ║    ║    by download service               ║    ║
  2474.           ┌╚════╝┐║ --------------------------------->┌╚════╝┐║
  2475.           └──────┘╣                                   └──────┘╣
  2476.            PC13_W ║                                    DOS_LR ║
  2477.                   ║                                           ║
  2478.                   ║ ╔════╗                                    ║ ╔════╗
  2479.                   ║ ║RIPL║   by RIPL image                    ║ ║RIPL║
  2480.                   ║┌╚════╝┐ --------------------------------->║┌╚════╝┐
  2481.                   ╠└──────┘     create feature                ╠└──────┘
  2482.            ╔════╗ ║ PC13_W                             ╔════╗ ║ DOS_LR
  2483.            ║    ║ ║                                    ║    ║ ║
  2484.           ┌╚════╝┐║                                   ┌╚════╝┐║
  2485.           └──────┘╣       by diskette                 └──────┘╣
  2486.            PC13_W ║ -------------------------------->  DOS_LR ║
  2487.                   ║          installation                     ║
  2488.                   ║                                           ║
  2489.                   ║                                           ║
  2490.                   ║ ╔════╗                                    ║ ╔════╗
  2491.                   ║ ║    ║     by diskette                    ║ ║    ║
  2492.                   ║┌╚════╝┐ --------------------------------> ║┌╚════╝┐
  2493.                   ╠└──────┘       installation                ╠└──────┘
  2494.                   ║ EE11_LR                                   ║ EE13_LR
  2495.           ╔════╗  ║                                   ╔════╗  ║
  2496.           ║    ║  ║                                   ║    ║  ║
  2497.         ┌─╚════╝─┐║            by diskette          ┌─╚════╝─┐║
  2498.         │ADSERV01│║-------------------------------->│ADSERV01│║
  2499.         └────────┘╣               installation      └────────┘╣
  2500.          LS10_AS  ║                                  LS13_AS  ║
  2501.                   ║  ╔════╗                                   ║  ╔════╗
  2502.                   ║  ║    ║                                   ║  ║    ║
  2503.                   ║┌─╚════╝─┐                                 ║┌─╚════╝─┐
  2504.                   ║│ IBMDC  │     by diskette                 ║│ IBMDC  │
  2505.                   ╠└────────┘ ------------------------------->╠└────────┘
  2506.                     LS10_DC          installation               LS13_DC
  2507.  
  2508.                        ==> ==> ==> ==> ==> ==> ==> ==> ==>
  2509.                                  Migration Path
  2510.         Legend:
  2511.         PC13_W  =  PC LAN Program 1.3 Workstation
  2512.         EE11_LR =  OS/2 Extended Edition 1.1 LAN Requester
  2513.         LS10_AS =  OS/2 LAN Server 1.0 Additional Server
  2514.         LS10_DC =  OS/2 LAN Server 1.0 Domain Controller
  2515.          DOS_LR =  DOS LAN Requester
  2516.         EE13_LR =  OS/2 Extended Edition 1.3 LAN Requester
  2517.         LS13_DC =  OS/2 LAN Server 1.3 Domain Controller
  2518.         LS13_AS =  OS/2 LAN Server 1.3 Additional Server
  2519.            RIPL =  Remote IPL workstation.
  2520.  
  2521.         FIGURE 4-2. LAN SERVER 1.0 DOMAIN MIGRATED TO LAN SERVER
  2522.                     1.3 DOMAIN ALL AT ONE TIME
  2523.                                  4-2
  2524.        
  2525.  
  2526.  
  2527.  
  2528.  
  2529.  
  2530.          PREPARING THE NETWORK AND USER COMMUNITY
  2531.  
  2532.          The migration from a LAN Server 1.0 environment to a LAN
  2533.          Server 1.3 environment can require a hardware upgrade of
  2534.          the servers.  For information about system, memory, and
  2535.          fixed-disk space requirements, see the IBM OPERATING
  2536.          SYSTEM/2 INFORMATION AND PLANNING GUIDE and the OS/2 LAN
  2537.          Server Version 1.3 slipcase cover.
  2538.  
  2539.          It is recommended that you notify system users about
  2540.          the upgrade to the new product release.  Include the
  2541.          following information in this notification:
  2542.  
  2543.          - Tell users about the schedule (when their workstation
  2544.            will be migrated).
  2545.  
  2546.          - Tell users to back up their home directories before
  2547.            the migration and to restore the directories after
  2548.            the migration has been completed (unless the network
  2549.            administrator is going to do this).
  2550.  
  2551.          - Tell users that private applications (that exist on
  2552.            the user's workstation only) will not be migrated.
  2553.            Explain that these applications must be backed up to
  2554.            diskette and copied back onto their workstations when
  2555.            the migration has been completed if the partition has
  2556.            been formatted.
  2557.  
  2558.          - Tell users to get their new password from the network
  2559.            administrator after the migration has been completed.
  2560.  
  2561.  
  2562.          PLANNING FOR THE EXPORT PHASE
  2563.  
  2564.          Before you export the domain definitions to the temporary
  2565.          file, complete the following steps:
  2566.  
  2567.          1. Print the current LAN domain definitions by doing the
  2568.             following:
  2569.  
  2570.              a. Log on as an administrator to the domain
  2571.                 controller.
  2572.  
  2573.              b. Verify that no other users or administrators are
  2574.                 logged on and accessing the DCDB.
  2575.  
  2576.  
  2577.  
  2578.  
  2579.                                  4-3
  2580.          
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.              c. Select "Definitions" from the main menu.
  2587.  
  2588.              d. Select "Print the domain definition" from the
  2589.                 Definitions pull-down.
  2590.  
  2591.              e. Select the default printer (or the printer that
  2592.                 applies to you) from the Printer Selection panel,
  2593.                 and select Enter.
  2594.  
  2595.          2. Create a backup copy of the current DCDB using one of
  2596.             the following methods:
  2597.  
  2598.             - For an environment with a domain controller and an
  2599.               additional server, you can use the DCDBBACK function.
  2600.               From the command line, enter the following:
  2601.  
  2602.               DCDBBACK servername /W:n /S:n /D:n
  2603.  
  2604.               The parameters in this command are as follows:
  2605.  
  2606.               servername    Identifies the name of the backup
  2607.                             (additional) server.
  2608.  
  2609.               /W:n          Specifies the drive to be used as the
  2610.                             temporarily redirected drive on the
  2611.                             same machine.  The drive specified
  2612.                             cannot be a drive that has been
  2613.                             redirected already.  The E: drive is
  2614.                             the default drive.
  2615.  
  2616.               /S:n          Specifies the drive in which the LAN
  2617.                             programs on the source machine are
  2618.                             stored.  The C: drive is the default
  2619.                             drive.
  2620.  
  2621.               /D:n          Specifies the drive in which the LAN
  2622.                             programs on the destination machine are
  2623.                             stored.  The C: drive is the default
  2624.                             drive.
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.                                  4-4
  2636.          
  2637.  
  2638.  
  2639.  
  2640.  
  2641.             - Issue the following sequence of XCOPY/COPY commands:
  2642.  
  2643.             XCOPY d:\IBMLAN\DCDB\USERS    A:\IBMLAN\DCDB\USERS    /S /E
  2644.             XCOPY d:\IBMLAN\DCDB\DEVICES  A:\IBMLAN\DCDB\DEVICES  /S /E
  2645.             XCOPY d:\IBMLAN\DCDB\PRINTERS A:\IBMLAN\DCDB\PRINTERS /S /E
  2646.             XCOPY d:\IBMLAN\DCDB\APPS     A:\IBMLAN\DCDB\APPS     /S /E
  2647.             XCOPY d:\IBMLAN\DCDB\FILES    A:\IBMLAN\DCDB\FILES    /S /E
  2648.             XCOPY d:\IBMLAN\DCDB\DATA     A:\IBMLAN\DCDB\DATA     /S /E
  2649.             COPY  d:\IBMLAN\NETPROG\*.TXT A:\IBMLAN\NETPROG\*.TXT
  2650.             COPY  d:\IBMLAN\NETPROG\R???PANH.LIB A:\IBMLAN\NETPROG\
  2651.             COPY  d:\IBMLAN\NETPROG\ROI1PANA.LIB A:\IBMLAN\NETPROG\
  2652.             XCOPY d:\PCLPUSER             A:\PCLPUSER             /S /E
  2653.             XCOPY d:\IBMLAN\USERS         A:\IBMLAN\USERS         /S /E
  2654.  
  2655.             NOTES:
  2656.               a. d: specifies the drive on which LAN Server 1.0
  2657.                  is installed.
  2658.  
  2659.               b. This process may require more than one formatted
  2660.                  diskette.
  2661.  
  2662.          3. Delete any access control profiles that are out of
  2663.             date or are no longer required.
  2664.  
  2665.          4. Create any profiles that will be needed by LAN Server
  2666.             1.3.  See "CONSIDERATIONS" on page 1-5 for more
  2667.             information.
  2668.  
  2669.          5. Document all access permissions for each network
  2670.             resource.
  2671.  
  2672.          6. If a global access list (the file \IBMLAN\IBMLAN.GLB)
  2673.             was used on the source domain controller, print the
  2674.             list or copy it to a diskette for future reference.
  2675.  
  2676.  
  2677.          EXPORTING THE DOMAIN DEFINITIONS TO A TEMPORARY FILE
  2678.  
  2679.          To export the domain definitions to a temporary DCDB file,
  2680.          complete the following steps at the source domain controller:
  2681.  
  2682.          1. Insert the Migration Utility diskette into the
  2683.             A: drive.
  2684.  
  2685.          2. Copy the following files to the \IBMLAN\NETPROG
  2686.             directory:
  2687.  
  2688.             COPY A:\LS10MU.FMT   d:\IBMLAN\NETPROG
  2689.             COPY A:\LS10MU.MSG   d:\IBMLAN\NETPROG
  2690.             COPY A:\LS10EXPO.EXE d:\IBMLAN\NETPROG
  2691.  
  2692.                                  4-5
  2693.          
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.             NOTE:  d: is the drive on which LAN Server 1.0
  2700.                    is installed.
  2701.  
  2702.             The LS10MU.FMT format file is used to generate the
  2703.             temporary DCDB file.  The LS10MU.MSG message file
  2704.             logs the activities (or messages) in the history file
  2705.             and displays prompts to the user at the workstation.
  2706.             The LS10EXPO.EXE file contains the executable Export
  2707.             program for LAN Server 1.0.
  2708.  
  2709.          3. Remove the Migration Utility diskette from the
  2710.             A: drive.
  2711.  
  2712.          4. Start all LAN Server 1.0 servers (the domain
  2713.             controller and additional servers) in the domain.
  2714.  
  2715.          5. Log on as an administrator to the domain controller.
  2716.  
  2717.          6. Make \IBMLAN\NETPROG the current directory.
  2718.  
  2719.          7. Enter the following to invoke the Export function:
  2720.  
  2721.             LS10EXPO path
  2722.  
  2723.             where the path parameter specifies the full path
  2724.             and file name of the temporary DCDB file that you want
  2725.             to create during the Export phase).  The path can
  2726.             include the drive letter.  For example, to create the
  2727.             temporary DCDB export file DCDB.TMP on the A: drive,
  2728.             enter the following:
  2729.  
  2730.             LS10EXPO A:DCDB.TMP
  2731.  
  2732.             In the command, LS10EXPO calls the executable Export
  2733.             program (LS10EXPO.EXE), which starts the Export
  2734.             function.  The Export function reads each attribute
  2735.             for the LAN objects defined in the LAN Server 1.0
  2736.             source domain and maps the attribute to the
  2737.             corresponding attribute in the LAN Server 1.3 DCDB
  2738.             format.  The Export function then writes the
  2739.             attribute to a temporary DCDB file that can be edited
  2740.             by the network administrator as necessary.
  2741.  
  2742.             The following message is displayed when the Export
  2743.             function completes:
  2744.  
  2745.             Program completed successfully.
  2746.  
  2747.  
  2748.                                  4-6
  2749.          
  2750.  
  2751.  
  2752.          8. If you have remote IPL machine definitions, do the
  2753.             following:
  2754.  
  2755.             a. Enter the following to copy the RPL.MAP file to
  2756.                a new diskette:
  2757.  
  2758.                COPY C:\IBMLAN\DCDB\IMAGES\RPL.MAP  A:
  2759.  
  2760.             b. If the remote IPL server name has changed, edit
  2761.                the DCDB.TMP files and the RPL.MAP file to
  2762.                reflect the new server name.  Ensure that no
  2763.                extra characters or blank lines are added to
  2764.                the files.
  2765.  
  2766.          NOTES:
  2767.  
  2768.          1. If the DCDB being exported is larger than one
  2769.             diskette, the function prompts for another formatted
  2770.             diskette and a new file name.  The file names on the
  2771.             multiple diskettes should be in sequential order.
  2772.  
  2773.          2. If an error occurs, see APPENDIX, "ERROR MESSAGES
  2774.             AND ERROR RECOVERY," for information about how to
  2775.             continue.
  2776.  
  2777.          3. The C:\IBMLAN\NETPROG\LS10MU.HST history file is
  2778.             created each time the Export function is invoked.
  2779.  
  2780.  
  2781.          PLANNING FOR THE IMPORT PHASE
  2782.  
  2783.          Before you import the domain definitions to the new DCDB,
  2784.          complete the following steps:
  2785.  
  2786.          1. Install the OS/2 EE 1.3 and LAN Server 1.3 programs
  2787.             on the workstation that has been designated as the
  2788.             new (destination) domain controller and the workstations
  2789.             designated as the additional servers.
  2790.  
  2791.          2. Verify that the source server (machine) name for the
  2792.             domain controller in the temporary DCDB file is the same
  2793.             as the server (machine) name for the domain controller
  2794.             in the destination domain.  If the names are not the
  2795.             same, edit the temporary file globally replacing the
  2796.             LAN Server 1.0 domain controller server (machine)
  2797.             name with the LAN Server 1.3 domain controller server
  2798.             (machine) name.  Also, verify that all names of
  2799.             additional servers in the temporary file match the names
  2800.             of their counterpart servers in the destination domain.
  2801.             If they are not the same, edit the temporary file and
  2802.             globally replace the LAN Server 1.0 server (machine)
  2803.             names with the new LAN Server 1.3 server (machine)
  2804.             names.
  2805.                                  4-7
  2806.          
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.          NOTE: If you print the temporary DCDB file after the
  2813.                Export phase completes, the DCDB prints in
  2814.                columnar form; however, the DCDB that is displayed
  2815.                on your workstation (if you are using the OS/2
  2816.                System Editor) is not.  To display the DCDB on your
  2817.                workstation exactly as it is printed out, you must
  2818.                change the font setting on the System Editor.
  2819.                Do the following:
  2820.  
  2821.                1. Select "Option" from the System Editor pull-down.
  2822.                2. Select "Set fonts" from the Option pull-down.
  2823.                3. Select "HELV font" from the Fonts panel.
  2824.  
  2825.          3. Define and start all LAN Server 1.3 servers.
  2826.  
  2827.          4. Log on as an administrator to the domain controller.
  2828.  
  2829.          5. Create a Print Manager spooler queue for each
  2830.             printer to be migrated.  See the IBM OPERATING
  2831.             SYSTEM/2 EXTENDED EDITION VERSION 1.3 USER'S GUIDE,
  2832.             VOLUME 1: BASE OPERATING SYSTEM for information
  2833.             about creating spooler queues.
  2834.  
  2835.          NOTES:
  2836.  
  2837.          1. A redirected drive cannot be used to import
  2838.             access control profiles.  For example, if the source
  2839.             domain has resources on Server 1 on the D: drive and
  2840.             the destination domain Server 1 does not have a
  2841.             physical D: drive, the temporary file must be edited
  2842.             to change the drive designation for all resources on
  2843.             Server 1 from the D: drive to the C: drive.
  2844.  
  2845.          2. The X: drive is reserved to perform the Import function.
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.                                  4-8
  2862.          
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.          IMPORTING THE DOMAIN DEFINITIONS TO THE DESTINATION DOMAIN
  2869.  
  2870.          To import the domain definitions to the DCDB on the
  2871.          destination domain, complete the following steps at
  2872.          the destination domain controller:
  2873.  
  2874.          1. Invoke the Import function of the Migration Utility
  2875.             using the following command:
  2876.  
  2877.             LS12IMPO path
  2878.  
  2879.             where the path parameter specifies the full path
  2880.             and file name of the temporary DCDB file (created
  2881.             during the Export phase).  The path can include the
  2882.             the drive letter.  For example, to invoke the Import
  2883.             function with the temporary DCDB export file DCDB.TMP
  2884.             located on the A: drive, enter the following:
  2885.  
  2886.             LS12IMPO A:DCDB.TMP
  2887.  
  2888.             In the command, LS12IMPO calls the Import function
  2889.             (which is part of the LAN Server 1.3 product and does
  2890.             not require installation).  The Import function reads
  2891.             the attributes of each LAN object from the temporary
  2892.             DCDB file in order and writes these attributes to
  2893.             the new DCDB in the destination domain.  A message is
  2894.             displayed on the workstation for each object definition
  2895.             that is successfully written to the new DCDB.
  2896.  
  2897.             If the Import function encounters a duplicate server
  2898.             and path or server and spooler queue combination, or
  2899.             cannot process an attribute, a message that indicates
  2900.             the error is displayed and the function stops.  The
  2901.             error message is also logged in the
  2902.             \IBMLAN\NETPROG\LS12MU.HST file (which also contains
  2903.             entries for all migration activities performed).
  2904.             After you correct the error, edit the temporary DCDB
  2905.             file to correct the attribute in this file as well,
  2906.             and then start the Import function again using the
  2907.             LS12IMPO command described previously.
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913.  
  2914.  
  2915.  
  2916.  
  2917.                                  4-9
  2918.          
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.             NOTES:
  2925.  
  2926.             a. Duplicate user, group, or resource information is
  2927.                ignored by the Import function (the process does
  2928.                not stop).  However, warning messages that indicate
  2929.                the duplicate information are displayed on the
  2930.                workstation and logged in the history file.
  2931.  
  2932.             b. If you are at the C: prompt and want to print
  2933.                the LS12MU.HST file to locate the error, enter
  2934.                the following command:  TYPE LS12MU.HST > PRN
  2935.  
  2936.             Before the Import function completes, it also
  2937.             generates the \IBMLAN\NETPROG\DCDBPSWD.DAT password
  2938.             file.  This file contains new passwords for users
  2939.             that are migrated to the new LAN Server 1.3 domain.
  2940.  
  2941.             When the Import function completes, the following
  2942.             message is displayed:
  2943.  
  2944.             Program completed successfully.
  2945.  
  2946.             NOTE:  If multiple diskettes were used to export the
  2947.                    domain definitions, you must run the Import
  2948.                    function on each diskette. (You will not be
  2949.                    prompted to insert multiple diskettes.)
  2950.                    Be sure to process the diskettes in the same
  2951.                    sequential order in which they were created.
  2952.                    The Import function is actually complete after
  2953.                    the last diskette has been processed.
  2954.  
  2955.             If the Import function does not complete successfully,
  2956.             look through the LS12MU.HST history file to find the
  2957.             error.  If you correct an error, you must rename the
  2958.             history file to preserve its entries before starting
  2959.             the Import function again.
  2960.  
  2961.          2. Secure the \IBMLAN\NETPROG\DCDBPSWD.DAT password
  2962.             file that was generated by the Import function.
  2963.  
  2964.          3. If access control profiles that were defined by the
  2965.             users have been imported, check the destination DCDB
  2966.             to make sure the profiles have been imported correctly.
  2967.  
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.                                  4-10
  2974.          
  2975.  
  2976.  
  2977.  
  2978.  
  2979.  
  2980.             NOTE:  If a printer or serial device does not have
  2981.                    an access control profile, the Migration
  2982.                    Utility (during the Import phase) adds a
  2983.                    default access control profile that grants
  2984.                    access to the printer or serial device for
  2985.                    all users.
  2986.  
  2987.          4. Migrate the resources from the LAN Server 1.0 domain
  2988.             controller to the LAN Server 1.3 domain controller.
  2989.             This includes printers, serial devices, files, and
  2990.             applications.
  2991.  
  2992.          5. Migrate the contents of the users' home directories
  2993.             on the LAN Server 1.0 domain controller to the LAN
  2994.             Server 1.3 domain controller.
  2995.  
  2996.          6. If a global access list was used on the source
  2997.             domain, check to see if you need to create or modify
  2998.             the access control profiles for the resources on
  2999.             that list.
  3000.  
  3001.             NOTE: LAN Server 1.3 does not use global access
  3002.                   lists.  In addition, LAN Server 1.3 grants
  3003.                   access to resources only as specified in the
  3004.                   access control profiles.  Access is denied to
  3005.                   any resource that does not have an access
  3006.                   control profile.
  3007.  
  3008.          7. If you have remote IPL machine definitions, copy the
  3009.             RPL.MAP file to the appropriate subdirectory:
  3010.  
  3011.             COPY A:RPL.MAP  C:\IBMLAN\DCDB\IMAGES
  3012.  
  3013.  
  3014.          COMPLETING THE MIGRATION
  3015.  
  3016.          Complete the migration with the following steps:
  3017.  
  3018.          1. Print the imported LAN domain definitions and verify
  3019.             the migrated definitions by doing the following:
  3020.  
  3021.             a. Log on as an administrator to the domain
  3022.                controller.
  3023.  
  3024.             b. Select "Definitions" from the main menu.
  3025.  
  3026.             c. Select "Print the domain definition" from
  3027.                the Definitions pull-down.
  3028.  
  3029.                                  4-11
  3030.          
  3031.  
  3032.  
  3033.  
  3034.  
  3035.             d. Select the default printer (or the printer that
  3036.                applies to you) from the Device Name column on the
  3037.                Print Domain Definition panel.
  3038.  
  3039.          2. Issue new passwords for the user IDs that require
  3040.             a password from the \IBMLAN\NETPROG\DCDBPSWD.DAT file
  3041.             that was created during the Import function.
  3042.  
  3043.          3. If you have remote IPL images that were migrated, do
  3044.             the following:
  3045.  
  3046.             - If standard image names were migrated, use the LAN
  3047.               Server 1.3 full-screen interface to select and make
  3048.               each standard image used in the RPL.MAP file.
  3049.  
  3050.             - If nonstandard images were migrated, the network
  3051.               administrator must create and make each nonstandard
  3052.               image.  See the IBM OPERATING SYSTEM/2 LOCAL AREA
  3053.               NETWORK SERVER VERSION 1.3 NETWORK ADMINISTRATOR'S
  3054.               GUIDE for more information.
  3055.  
  3056.          4. For the requesters in the domain:
  3057.  
  3058.             a. Create DOS LAN Requester IPL images to replace the
  3059.                PCLP 1.3 Requester IPL images if remote IPL
  3060.                machines will continue to be supported.  See
  3061.                the IBM OPERATING SYSTEM/2 LOCAL AREA NETWORK
  3062.                SERVER VERSION 1.3 NETWORK ADMINISTRATOR'S GUIDE
  3063.                for information about how to create these images.
  3064.  
  3065.             b. Install the appropriate operating system on the
  3066.                requesters.
  3067.  
  3068.                If the workstation will be an OS/2 requester,
  3069.                verify that the workstation is appropriately
  3070.                configured (memory and fixed-disk space), and
  3071.                install the OS/2 EE 1.3 program.  See IBM
  3072.                OPERATING SYSTEM/2 EXTENDED EDITION VERSION 1.3
  3073.                GETTING STARTED for installation information.
  3074.  
  3075.                If the workstation will be a DOS requester,
  3076.                install DOS 3.3 or 4.01, the PC LAN Support
  3077.                Program, and the IBM DOS LAN Requester program.
  3078.                See IBM OPERATING SYSTEM/2 LOCAL AREA NETWORK
  3079.                SERVER VERSION 1.3 GETTING STARTED for
  3080.                installation information.
  3081.  
  3082.  
  3083.  
  3084.  
  3085.                                  4-12
  3086.          
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.          CHAPTER 5.  MIGRATING A LAN SERVER 1.0 DOMAIN IN STAGES
  3093.  
  3094.          This chapter describes the tasks required to migrate
  3095.          from a LAN Server 1.0 domain to a LAN Server 1.3
  3096.          environment over time, in stages.
  3097.  
  3098.          During this staged migration, the network administrator
  3099.          must install and configure an additional system as the
  3100.          new LAN Server 1.3 domain controller.  While the network
  3101.          administrator is migrating the domain definitions and
  3102.          existing resources from the LAN Server 1.0 domain to this
  3103.          additional system (which will serve as the LAN Server
  3104.          1.3 domain controller) and setting up the new
  3105.          environment, the existing LAN Server 1.0 domain
  3106.          controller is still providing logon service to users.
  3107.  
  3108.          It is important to note that once a server is migrated,
  3109.          users whose home filesets are on that server cannot log
  3110.          on to the domain until the migration has been completed.
  3111.  
  3112.          If there are PCLP 1.3 requesters in the LAN Server 1.0
  3113.          domain, the network administrator should define
  3114.          appropriate access control privileges to the GUEST user
  3115.          ID in order to provide the required access to the LAN
  3116.          Server 1.3 resources from the requesters.  After all
  3117.          PCLP 1.3 requesters have been upgraded to OS/2 EE 1.3
  3118.          requesters or DOS LAN Requesters, the access privileges
  3119.          assigned to the GUEST user ID should be reviewed and
  3120.          modified as required.  See the IBM OPERATING SYSTEM/2
  3121.          LOCAL AREA NETWORK SERVER VERSION 1.3 NETWORK
  3122.          ADMINISTRATOR'S GUIDE for information about how to
  3123.          assign the access control privileges to the GUEST user
  3124.          ID.
  3125.  
  3126.          NOTE:  Using the GUEST user ID in this situation not only
  3127.                 allows users at PCLP 1.3 requesters to access LAN
  3128.                 Server 1.3 resources; it also allows any user ID
  3129.                 not defined in the LAN Server 1.3 domain to also
  3130.                 access the LAN Server 1.3 resources.
  3131.  
  3132.          The following figure shows the typical migration
  3133.          scenario for this environment.
  3134.  
  3135.  
  3136.  
  3137.  
  3138.  
  3139.  
  3140.  
  3141.                                  5-1
  3142.          
  3143. Original LAN Server 1.0                             Final LAN Server 1.3
  3144.       Domain               Intermediate Stage               Domain
  3145.   (Domain IBMDC)            (Domains IBMDC            (Domain IBM13DOM)
  3146.                                 and IBM13DOM)
  3147.  
  3148.     ╔════╗                     ╔════╗                    ╔════╗
  3149.     ║RIPL║                     ║RIPL║                    ║RIPL║
  3150.    ┌╚════╝┐║                  ┌╚════╝┐║                 ┌╚════╝┐║
  3151.    └──────┘╣                  └──────┘╣                 └──────┘╣
  3152.     PC13_W ║ ╔════╗            DOS_LR ║ ╔════╗           DOS_LR ║ ╔════╗
  3153.            ║ ║    ║                   ║ ║    ║                  ║ ║    ║
  3154.            ║┌╚════╝┐                  ║┌╚════╝┐                 ║┌╚════╝┐
  3155.     ╔════╗ ╠└──────┘           ╔════╗ ╠└──────┘          ╔════╗ ╠└──────┘
  3156.     ║    ║ ║ PC13_W            ║    ║ ║ PC13_W           ║    ║ ║ DOS_LR
  3157.    ┌╚════╝┐║                  ┌╚════╝┐║                 ┌╚════╝┐║
  3158.    └──────┘╣                  └──────┘╣                 └──────┘╣
  3159.    EE11_LR ║ ╔════╗           EE13_LR ║ ╔════╗          EE13_LR ║ ╔════╗
  3160.            ║ ║    ║                   ║ ║    ║                  ║ ║    ║
  3161.            ║┌╚════╝┐                  ║┌╚════╝┐                 ║┌╚════╝┐
  3162.    ╔════╗  ╠└──────┘          ╔════╗  ╠└──────┘         ╔════╗  ╠└──────┘
  3163.    ║    ║  ║ EE11_LR          ║    ║  ║ EE11_LR         ║    ║  ║ EE13_LR
  3164.  ┌─╚════╝─┐║                ┌─╚════╝─┐║               ┌─╚════╝─┐║
  3165.  │ADSERV01│║                │ADSERV01│║               │ADSERV01│║
  3166.  └────────┘╣                └────────┘╣               └────────┘╣
  3167.   LS10_AS  ║  ╔════╗         LS13_AS  ║  ╔════╗        LS13_AS  ║
  3168.            ║  ║    ║                  ║  ║    ║                 ║
  3169.            ║┌─╚════╝─┐                ║┌─╚════╝─┐               ║
  3170.            ║│ IBMDC  │                ║│ IBMDC  │               ║
  3171.            ╠└────────┘                ╠└────────┘               ╠
  3172.            ║ LS10_DC                  ║  LS10_DC                ║
  3173.            ║                          ║(EE 1.1 and              ║
  3174.            ║                  ╔════╗  ║ PCLP Logon      ╔════╗  ║
  3175.            ║                  ║    ║  ║ Services  )     ║    ║  ║
  3176.            ║                ┌─╚════╝─┐║               ┌─╚════╝─┐║
  3177.            ║                │ LS13DC │╣               │ LS13DC │╣
  3178.            ║                └────────┘║               └────────┘║
  3179.                              LS13_DC                   LS13_DC
  3180.                        (External Resources)       (Complete Control)
  3181.  
  3182.                   ==> ==> ==> ==> ==> ==> ==> ==> ==> ==> ==>
  3183.                                  Migration Path
  3184.         Legend:
  3185.         PC13_W  =  PC LAN Program 1.3 Workstation
  3186.         EE11_LR =  OS/2 Extended Edition 1.1 LAN Requester
  3187.         LS10_AS =  OS/2 LAN Server 1.0 Additional Server
  3188.         LS10_DC =  OS/2 LAN Server 1.0 Domain Controller
  3189.          DOS_LR =  DOS LAN Requester
  3190.         EE13_LR =  OS/2 Extended Edition 1.3 LAN Requester
  3191.         LS13_DC =  OS/2 LAN Server 1.3 Domain Controller
  3192.         LS13_AS =  OS/2 LAN Server 1.3 Additional Server
  3193.            RIPL =  Remote IPL workstation.
  3194.  
  3195.         FIGURE 5-1. LAN SERVER 1.0 DOMAIN MIGRATED TO LAN
  3196.                     SERVER 1.3 OVER TIME IN STAGES
  3197.                                  5-2
  3198.          
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.          PREPARING THE NETWORK AND USER COMMUNITY
  3205.  
  3206.          The migration to a LAN Server 1.3 environment from a LAN
  3207.          Server 1.0 environment can require a hardware upgrade of
  3208.          the servers.  For information about system, memory, and
  3209.          fixed-disk space requirements, see the IBM OPERATING
  3210.          SYSTEM/2 INFORMATION AND PLANNING GUIDE and the IBM OS/2
  3211.          LAN Server Version 1.3 slipcase cover.
  3212.  
  3213.          It is recommended that you notify system users about
  3214.          the upgrade to the new product release.  Include the
  3215.          following information in this notification:
  3216.  
  3217.          - Tell users about the schedule (when their workstation
  3218.            will be migrated).
  3219.  
  3220.          - Tell users to back up their home directories before
  3221.            the migration and to restore the directories after the
  3222.            the migration has been completed (unless the network
  3223.            administrator is going to do this).
  3224.  
  3225.          - Tell users that private applications (that exist on
  3226.            the user's workstation only) will not be migrated.
  3227.            Explain that these applications must be backed up to
  3228.            diskette and copied back onto their workstations
  3229.            when the migration has been completed if the
  3230.            partition has been formatted.
  3231.  
  3232.          - Tell users to get their new password from the network
  3233.            administrator after the migration has been completed.
  3234.  
  3235.  
  3236.          PLANNING FOR THE EXPORT PHASE
  3237.  
  3238.          Before you export the domain definitions to the
  3239.          temporary file, complete the following steps:
  3240.  
  3241.          1. Connect an additional system that will serve as the
  3242.             new LAN Server 1.3 domain controller to the current
  3243.             network.  See the documentation that came with your
  3244.             network adapter for connection information.
  3245.  
  3246.  
  3247.  
  3248.  
  3249.  
  3250.  
  3251.  
  3252.  
  3253.                                  5-3
  3254.          
  3255.  
  3256.  
  3257.  
  3258.  
  3259.  
  3260.          2. Install and configure the new system as the LAN
  3261.             Server 1.3 domain controller.  See IBM OPERATING
  3262.             SYSTEM/2 LOCAL AREA NETWORK SERVER VERSION 1.3
  3263.             GETTING STARTED for information about installing
  3264.             this system.
  3265.  
  3266.             NOTE:  In these instructions, the LAN Server 1.3
  3267.                    domain name is referred to in examples as
  3268.                    IBM13DOM and the server name for the domain
  3269.                    controller is referred to as LS13DC.
  3270.  
  3271.          3. On the existing (source) domain controller, print the
  3272.             current LAN domain definitions by doing the following:
  3273.  
  3274.             a. Log on as an administrator to the source domain
  3275.                controller.
  3276.  
  3277.             b. Verify that no other users or administrators are
  3278.                logged on and accessing the DCDB.
  3279.  
  3280.             c. Select "Definitions" from the main menu.
  3281.  
  3282.             d. Select "Print the domain definition" from the
  3283.                Definitions pull-down.
  3284.  
  3285.             e. Select the default printer (or the printer that
  3286.                applies to you) from the Printer Selection panel,
  3287.                and select Enter.
  3288.  
  3289.          4. Create a backup copy of the current LAN DCDB using
  3290.             one of the following methods:
  3291.  
  3292.             - For an environment with a domain controller and an
  3293.               additional server, you can use the DCDBBACK function.
  3294.               From the command line, enter the following:
  3295.  
  3296.               DCDBBACK servername /W:n /S:n /D:n
  3297.  
  3298.               The parameters in this command are as follows:
  3299.  
  3300.               servername    Identifies the name of the backup
  3301.                             (additional) server.
  3302.  
  3303.  
  3304.  
  3305.  
  3306.  
  3307.  
  3308.  
  3309.                                  5-4
  3310.          
  3311.  
  3312.  
  3313.               /W:n          Specifies the drive to be used as the
  3314.                             temporarily redirected drive on the
  3315.                             same machine.  The drive specified
  3316.                             cannot be a drive that has been
  3317.                             redirected already.  The E: drive is
  3318.                             the default drive.
  3319.  
  3320.               /S:n          Specifies the drive in which the LAN
  3321.                             programs on the source machine are
  3322.                             stored.  The C: drive is the default
  3323.                             drive.
  3324.  
  3325.               /D:n          Specifies the drive in which the LAN
  3326.                             programs on the destination machine are
  3327.                             stored.  The C: drive is the default
  3328.                             drive.
  3329.  
  3330.             - Issue the following sequence of XCOPY/COPY commands:
  3331.  
  3332.             XCOPY d:\IBMLAN\DCDB\USERS    A:\IBMLAN\DCDB\USERS    /S /E
  3333.             XCOPY d:\IBMLAN\DCDB\DEVICES  A:\IBMLAN\DCDB\DEVICES  /S /E
  3334.             XCOPY d:\IBMLAN\DCDB\PRINTERS A:\IBMLAN\DCDB\PRINTERS /S /E
  3335.             XCOPY d:\IBMLAN\DCDB\APPS     A:\IBMLAN\DCDB\APPS     /S /E
  3336.             XCOPY d:\IBMLAN\DCDB\FILES    A:\IBMLAN\DCDB\FILES    /S /E
  3337.             XCOPY d:\IBMLAN\DCDB\DATA     A:\IBMLAN\DCDB\DATA     /S /E
  3338.             COPY  d:\IBMLAN\NETPROG\*.TXT A:\IBMLAN\NETPROG\*.TXT
  3339.             COPY  d:\IBMLAN\NETPROG\R???PANH.LIB A:\IBMLAN\NETPROG\
  3340.             COPY  d:\IBMLAN\NETPROG\ROI1PANA.LIB A:\IBMLAN\NETPROG\
  3341.             XCOPY d:\PCLPUSER             A:\PCLPUSER             /S /E
  3342.             XCOPY d:\IBMLAN\USERS         A:\IBMLAN\USERS         /S /E
  3343.  
  3344.          NOTES:
  3345.  
  3346.             a. d: specifies the drive on which LAN Server 1.0
  3347.                is installed.
  3348.  
  3349.             b. This process may require more than one formatted
  3350.                 diskette.
  3351.  
  3352.          5. Delete any access control profiles that are out of
  3353.             date or are no longer required.
  3354.  
  3355.          6. If necessary, create profiles for migrated resources
  3356.             that do not have access control profiles.
  3357.  
  3358.          7. Document all access permissions for each network
  3359.             resource.
  3360.  
  3361.          8. If a global access list (the file \IBMLAN\IBMLAN.GLB)
  3362.             was used on the source domain controller, print the
  3363.             list or copy it to a diskette for future reference.
  3364.  
  3365.                                  5-5
  3366.          
  3367.  
  3368.  
  3369.  
  3370.  
  3371.  
  3372.          EXPORTING THE DOMAIN DEFINITIONS TO A TEMPORARY FILE
  3373.  
  3374.          To export the domain definitions to a temporary DCDB
  3375.          file, do the following at the source domain controller:
  3376.  
  3377.          1. Insert the Migration Utility diskette into the
  3378.             A: drive.
  3379.  
  3380.          2. Copy the following files to the \IBMLAN\NETPROG
  3381.             directory:
  3382.  
  3383.             copy A:\LS10MU.FMT   d:\IBMLAN\NETPROG
  3384.             copy A:\LS10MU.MSG   d:\IBMLAN\NETPROG
  3385.             copy A:\LS10EXPO.EXE d:\IBMLAN\NETPROG
  3386.  
  3387.             NOTE:  d: is the drive on which LAN Server 1.0
  3388.                    is installed.
  3389.  
  3390.             The LS10MU.FMT format file is used to generate the
  3391.             temporary DCDB file.  The LS10MU.MSG message file
  3392.             logs the activities (or messages) in the history file
  3393.             and displays prompts to the user at the workstation.
  3394.             The LS10EXPO.EXE file contains the executable Export
  3395.             program for LAN Server 1.0.
  3396.  
  3397.          3. Remove the Migration Utility diskette from the
  3398.             A: drive.
  3399.  
  3400.          4. Start all LAN Server 1.0 servers (the domain
  3401.             controller and additional servers) in the domain.
  3402.  
  3403.          5. Log on as an administrator to the domain controller.
  3404.  
  3405.          6. Make \IBMLAN\NETPROG the current directory.
  3406.  
  3407.  
  3408.          7. Enter the following to invoke the Export function:
  3409.  
  3410.             LS10EXPO path
  3411.  
  3412.             where the path parameter specifies the full path
  3413.             and file name of the temporary DCDB file you want to
  3414.             create during the Export phase.  The path can include
  3415.             the drive letter.  For example, to create the temporary
  3416.             DCDB export file DCDB.TMP on the A: drive, enter the
  3417.             following:
  3418.  
  3419.             LS10EXPO A:DCDB.TMP
  3420.  
  3421.                                  5-6
  3422.          
  3423.  
  3424.  
  3425.  
  3426.  
  3427.  
  3428.             In the command, LS10EXPO calls the executable Export
  3429.             program (LS10EXPO.EXE), which starts the Export
  3430.             function.  The Export function reads each attribute
  3431.             for the LAN objects defined in the LAN Server 1.0
  3432.             source domain and maps the attribute to the
  3433.             corresponding attribute in the LAN Server 1.3 DCDB
  3434.             format.  The Export function then writes the
  3435.             attribute to a temporary DCDB file that can be edited
  3436.             by the network administrator as necessary.
  3437.  
  3438.             The following message is displayed when the Export
  3439.             function completes:
  3440.  
  3441.             Program completed successfully.
  3442.  
  3443.          8. If you have remote IPL machine definitions, do the
  3444.             following:
  3445.  
  3446.             a. Enter the following to copy the RPL.MAP file to
  3447.                a new diskette.
  3448.  
  3449.                COPY C:\IBMLAN\DCDB\IMAGES\RPL.MAP  A:
  3450.  
  3451.             b. If the remote IPL server name has changed, edit
  3452.                the DCDB.TMP files and the RPL.MAP file to
  3453.                reflect the new server name.  Ensure that no extra
  3454.                characters or blank lines are added to the files.
  3455.  
  3456.          NOTES:
  3457.  
  3458.          1. If the DCDB being exported is larger than one
  3459.             diskette, the function prompts for another formatted
  3460.             diskette and a new file name.  The file names on the
  3461.             multiple diskettes should be in sequential order.
  3462.  
  3463.          2. If an error occurs, see APPENDIX, "ERROR MESSAGES
  3464.             AND ERROR RECOVERY," for information about how to
  3465.             continue.
  3466.  
  3467.          3. The C:\IBMLAN\NETPROG\LS10MU.HST history file is
  3468.             created each time the Export function is invoked.
  3469.  
  3470.  
  3471.  
  3472.  
  3473.  
  3474.  
  3475.  
  3476.  
  3477.                                  5-7
  3478.          
  3479.  
  3480.  
  3481.           PLANNING FOR THE IMPORT PHASE
  3482.  
  3483.           Before you import the domain definitions to the new DCDB,
  3484.           complete the following steps:
  3485.  
  3486.           1. Edit the temporary DCDB file to change all
  3487.              occurrences of the server name IBMDC to LS13DC.
  3488.  
  3489.           NOTES:
  3490.  
  3491.              a. Verify that the server (machine) names in the
  3492.                 temporary file are the same names that are in the
  3493.                 destination domain.  If they are not the same,
  3494.                 edit the temporary file and replace the LAN Server
  3495.                 1.0 server (machine) names with the new LAN Server
  3496.                 1.3 server (machine) names.
  3497.  
  3498.              b. If you print the temporary DCDB file after the
  3499.                 Export phase completes, the DCDB prints in
  3500.                 columnar form; however, the DCDB that is displayed
  3501.                 on your workstation (if you are using the OS/2
  3502.                 System Editor) is not.  To display the DCDB on your
  3503.                 workstation exactly as it is printed out, you must
  3504.                 change the font setting on the System Editor.
  3505.                 Do the following:
  3506.  
  3507.                 1. Select "Option" from the System Editor
  3508.                    pull-down.
  3509.                 2. Select "Set fonts" from the Option pull-down.
  3510.                 3. Select "HELV font" from the Fonts panel.
  3511.  
  3512.          2. Install the OS/2 EE 1.3 and LAN Server 1.3 programs
  3513.             on the workstation that has been designated as the
  3514.             new (destination) domain controller and the workstations
  3515.             designated as the additional servers.
  3516.  
  3517.          3. Define and start all LAN Server 1.3 servers.
  3518.  
  3519.          4. Log on as an administrator to the domain controller.
  3520.  
  3521.          5. Create a Print Manager spooler queue for each
  3522.             printer to be migrated.  See the IBM OPERATING
  3523.             SYSTEM/2 EXTENDED EDITION VERSION 1.3 USER'S GUIDE,
  3524.             VOLUME 1: BASE OPERATING SYSTEM for information
  3525.             about creating spooler queues.
  3526.  
  3527.          NOTES:
  3528.  
  3529.          1. A redirected drive cannot be used to import
  3530.             access control profiles.  For example, if the source
  3531.             domain has resources on Server 1 on the D: drive and
  3532.  
  3533.                                  5-8
  3534.          
  3535.  
  3536.  
  3537.  
  3538.  
  3539.             the destination domain Server 1 does not have a
  3540.             physical D: drive, the temporary file must be edited
  3541.             to change the drive designation for all resources on
  3542.             Server 1 from the D: drive to the C: drive.
  3543.  
  3544.          2. The X: drive is reserved to perform the Import function.
  3545.  
  3546.  
  3547.          IMPORTING THE DOMAIN DEFINITIONS TO THE DESTINATION DOMAIN
  3548.  
  3549.          To import the domain definitions to the new DCDB on the
  3550.          destination domain, complete the following steps at
  3551.          the destination domain controller:
  3552.  
  3553.          1. Invoke the Import function of the Migration Utility
  3554.             using the following command:
  3555.  
  3556.             LS12IMPO path
  3557.  
  3558.             where the path parameter specifies the full path
  3559.             and file name of the temporary DCDB file (created
  3560.             during the Export phase).  The path can include the
  3561.             the drive letter.  For example, to invoke the Import
  3562.             function with the temporary DCDB export file DCDB.TMP
  3563.             located on the A: drive, enter the following:
  3564.  
  3565.             LS12IMPO A:DCDB.TMP
  3566.  
  3567.             In the command, LS12IMPO calls the Import function
  3568.             (which is part of the LAN Server 1.3 product and does
  3569.             not require installation).  The Import function reads
  3570.             the attributes of each LAN object from the temporary
  3571.             DCDB file in order and writes these attributes to
  3572.             the new DCDB in the destination domain.  A message is
  3573.             displayed on the workstation for each object definition
  3574.             that is successfully written to the new DCDB.
  3575.  
  3576.             If the Import function encounters a duplicate server
  3577.             and path or server and spooler queue combination, or
  3578.             cannot process an attribute, a message that indicates
  3579.             the error is displayed and the function stops.  The
  3580.             error message is also logged in the
  3581.             \IBMLAN\NETPROG\LS12MU.HST file (which also contains
  3582.             entries for all migration activities performed).
  3583.             After you correct the error, edit the temporary DCDB
  3584.             file to correct the attribute in this file as well,
  3585.             and then start the Import function again using the
  3586.             LS12IMPO command described previously.
  3587.  
  3588.  
  3589.                                  5-9
  3590.          
  3591.  
  3592.  
  3593.  
  3594.             NOTES:
  3595.  
  3596.             a. Duplicate user, group, or resource information is
  3597.                ignored by the Import function (the process does
  3598.                not stop).  However, warning messages that indicate
  3599.                the duplicate information are displayed on the
  3600.                workstation and logged in the history file.
  3601.  
  3602.             b. If you are at the C: prompt and want to print
  3603.                the LS12MU.HST file to locate the error, enter
  3604.                the following command:  TYPE LS12MU.HST > PRN
  3605.  
  3606.             Before the Import function completes, it also
  3607.             generates the \IBMLAN\NETPROG\DCDBPSWD.DAT password
  3608.             file.  This file contains new passwords for users
  3609.             that are migrated to the new LAN Server 1.3 domain.
  3610.  
  3611.             When the Import function completes, the following
  3612.             message is displayed:
  3613.  
  3614.             Program completed successfully.
  3615.  
  3616.             NOTE:  If multiple diskettes were used to export the
  3617.                    domain definitions, you must run the Import
  3618.                    function on each diskette. (You will not be
  3619.                    prompted to insert multiple diskettes.)
  3620.                    Be sure to process the diskettes in the same
  3621.                    sequential order in which they were created.
  3622.                    The Import function is actually complete after
  3623.                    the last diskette has been processed.
  3624.  
  3625.             If the Import function does not complete successfully,
  3626.             look through the LS12MU.HST history file to find the
  3627.             error.  If you correct an error, you must rename the
  3628.             history file to preserve its entries before starting
  3629.             the Import function again.
  3630.  
  3631.          2. Secure the \IBMLAN\NETPROG\DCDBPSWD.DAT password
  3632.             file that was generated by the Import function.
  3633.  
  3634.          3. If access control profiles that were defined by the
  3635.             users have been imported, check the destination DCDB
  3636.             to make sure the profiles have been imported correctly.
  3637.  
  3638.             NOTE:  If a printer or serial device does not have
  3639.                    an access control profile, the Migration
  3640.                    Utility (during the Import phase) adds a
  3641.                    default access control profile that grants
  3642.                    access to the printer or serial device for
  3643.                    all users.
  3644.  
  3645.                                  5-10
  3646.          
  3647.  
  3648.  
  3649.  
  3650.  
  3651.          4. Migrate the resources from the LAN Server 1.0 domain
  3652.             controller to the LAN Server 1.3 domain controller.
  3653.             This includes printers, serial devices, files, and
  3654.             applications.
  3655.  
  3656.          5. Migrate the contents of the users' home directories
  3657.             on the LAN Server 1.0 domain controller to the LAN
  3658.             Server 1.3 domain controller.
  3659.  
  3660.          6. If a global access list was used on the source
  3661.             domain, check to see if you need to create or modify
  3662.             the access control profiles for the resources on
  3663.             that list.
  3664.  
  3665.             NOTE: LAN Server 1.3 does not use global access
  3666.                   lists.  In addition, LAN Server 1.3 grants
  3667.                   access to resources only as specified in the
  3668.                   access control profiles.  Access is denied to
  3669.                   any resource that does not have an access
  3670.                   control profile.
  3671.  
  3672.          7. If you have remote IPL machine definitions, copy the
  3673.             RPL.MAP file to the appropriate subdirectory:
  3674.  
  3675.             COPY A:RPL.MAP  C:\IBMLAN\DCDB\IMAGES
  3676.  
  3677.  
  3678.          SETTING UP THE INTERMEDIATE ENVIRONMENT
  3679.  
  3680.          Set up the intermediate environment (see Figure 5-1)
  3681.          with the following steps:
  3682.  
  3683.          1. Print the imported LAN domain definitions and verify
  3684.             the migrated definitions by doing the following:
  3685.  
  3686.             a. Log on as an administrator to the domain
  3687.                controller.
  3688.  
  3689.             b. Select "Definitions" from the main menu.
  3690.  
  3691.             c. Select "Print the domain definition" from
  3692.                the Definitions pull-down.
  3693.  
  3694.             d. Select the default printer (or the printer that
  3695.                applies to you) from the Device Name column on the
  3696.                Print Domain Definition panel.
  3697.  
  3698.  
  3699.  
  3700.  
  3701.                                  5-11
  3702.          
  3703.  
  3704.  
  3705.  
  3706.  
  3707.          2. Create new external resource definitions to access
  3708.             the current resources after they are migrated to the
  3709.             new LAN Server 1.3 domain.  See the printout of the
  3710.             imported DCDB definitions that you made earlier for
  3711.             the netname and server location aliases.
  3712.  
  3713.             For example, on the LAN Server 1.3 domain controller
  3714.             (LS13DC), the directory C:\PAYROLL\PAY89 is defined
  3715.             with a files alias name PAY.  The PAY files alias
  3716.             must be redefined on the LAN Server 1.0 domain as an
  3717.             external files alias as follows:
  3718.  
  3719.             a. Log on as an administrator.
  3720.  
  3721.             b. Select "Definitions" from the Main Panel.
  3722.  
  3723.             c. Select the "Aliases" option.
  3724.  
  3725.             d. Select the "Files" option.
  3726.  
  3727.             e. Select the "PAY" alias.
  3728.  
  3729.             f. Select "Actions" from the action bar.
  3730.  
  3731.             g. Select the "Delete" option to delete the internal
  3732.                PAY files alias.
  3733.  
  3734.             h. Select "Definitions" from the Main Panel.
  3735.  
  3736.             i. Select the "Aliases" option.
  3737.  
  3738.             j. Select the "External Resources" option.
  3739.  
  3740.             k. Select "--New--" from the Manage Aliases panel.
  3741.  
  3742.             l. Select "Actions" from the action bar.
  3743.  
  3744.             m. Select the "Create" option from the Actions
  3745.                pull-down.  The Create Alias panel is displayed.
  3746.  
  3747.             n. Complete the panel with the appropriate
  3748.                information, and select Enter.
  3749.  
  3750.  
  3751.  
  3752.  
  3753.  
  3754.  
  3755.  
  3756.  
  3757.                                  5-12
  3758.          
  3759.  
  3760.  
  3761.  
  3762.  
  3763.             o. Create the external alias batch file for OS/2 (EE
  3764.                1.3 requesters) or DOS (PCLP 1.3 requesters) users
  3765.                with one of the following:
  3766.  
  3767.                - Select "Edit OS/2.CMD file" to create the
  3768.                  external alias batch file for OS/2 users.
  3769.  
  3770.                - Select "Edit DOS.BAT file" to create the
  3771.                  external alias batch file for DOS users.
  3772.  
  3773.  
  3774.                If both OS/2 and DOS users are to access the
  3775.                external resource, create a batch file for each
  3776.                type of user.
  3777.  
  3778.             p. Add a NET USE command to connect to the external
  3779.                resource by entering the command after the
  3780.                appropriate comment in the batch file as shown in
  3781.                the following:
  3782.  
  3783.                #
  3784.                #  This is where you put in your external resource
  3785.                #  connection commands.
  3786.                #
  3787.                   NET USE %1 \\LS13DC\PAY
  3788.  
  3789.                Use the following as the corresponding disconnect
  3790.                command:
  3791.  
  3792.                NET USE %1 /D
  3793.  
  3794.             Repeat this process for all internal aliases
  3795.             (printers, serial devices, and files).  Use the
  3796.             temporary file or printout of the LAN Server 1.3
  3797.             domain definitions as the source document to convert
  3798.             LAN Server 1.0 alias definitions from internal to
  3799.             external.
  3800.  
  3801.          3. Verify that all user logon assignments (NET USE
  3802.             definitions) have been updated as required.
  3803.  
  3804.          4. Issue new passwords for the user IDs that require
  3805.             a password from the \IBMLAN\NETPROG\DCDBPSWD.DAT file
  3806.             that was generated during the Import function.  The
  3807.             new passwords should be the same in both the LAN
  3808.             Server 1.0 and 1.3 domains.
  3809.  
  3810.  
  3811.  
  3812.  
  3813.                                  5-13
  3814.          
  3815.  
  3816.  
  3817.  
  3818.  
  3819.          5. If you have remote IPL images that were migrated, do
  3820.             the following:
  3821.  
  3822.             a. If standard image names were migrated, use the LAN
  3823.                Server 1.3 full-screen interface to select and
  3824.                make each standard image used in the RPL.MAP file.
  3825.  
  3826.             b. If nonstandard image names were migrated, the
  3827.                network administrator must create and make each
  3828.                nonstandard image.  See the IBM OPERATING SYSTEM/2
  3829.                LOCAL AREA NETWORK SERVER VERSION 1.3 NETWORK
  3830.                ADMINISTRATOR'S GUIDE for more information.
  3831.  
  3832.          6. For the requesters in the domain:
  3833.  
  3834.             a. Create DOS LAN Requester IPL images to replace the
  3835.                PCLP 1.3 Requester IPL images if remote IPL
  3836.                machines will continue to be supported.  See
  3837.                the IBM OPERATING SYSTEM/2 LOCAL AREA NETWORK
  3838.                SERVER VERSION 1.3 NETWORK ADMINISTRATOR'S GUIDE
  3839.                for information about how to create these images.
  3840.  
  3841.             b. Install the appropriate operating system on the
  3842.                requesters.
  3843.  
  3844.                If the workstation will be an OS/2 requester,
  3845.                verify that the workstation is appropriately
  3846.                configured (memory and fixed-disk space), and
  3847.                install the OS/2 EE 1.3 program.  See IBM
  3848.                OPERATING SYSTEM/2 EXTENDED EDITION VERSION 1.3
  3849.                GETTING STARTED for installation information.
  3850.  
  3851.                If the workstation will be a DOS LAN Requester,
  3852.                install DOS 3.3 or 4.01, the PC LAN Support
  3853.                Program, and the IBM DOS LAN Requester program.
  3854.                See IBM OPERATING SYSTEM/2 LOCAL AREA NETWORK
  3855.                SERVER VERSION 1.3 GETTING STARTED for
  3856.                installation information.
  3857.  
  3858.          In summary, the intermediate environment has now been
  3859.          created.  Users at LAN Server 1.0 workstations continue
  3860.          to log on at the LAN Server 1.0 domain controller.
  3861.          Users at DOS LAN Requesters or EE 1.3 Requesters log on
  3862.          to the new LAN Server 1.3 domain.  The LAN Server 1.0
  3863.          users have access to the network resources on the LAN
  3864.          Server 1.3 domain controller to which the GUEST user ID
  3865.          has been given access permission.
  3866.  
  3867.  
  3868.  
  3869.                                  5-14
  3870.          
  3871.  
  3872.  
  3873.  
  3874.  
  3875.          COMPLETING THE MIGRATION
  3876.  
  3877.          Complete the migration with the following steps:
  3878.  
  3879.          1. Upgrade the LAN Server 1.0 workstations to DOS LAN
  3880.             Requesters or OS/2 EE 1.3 requesters.  If there are
  3881.             PCLP workstations in the LAN Server 1.0 domain,
  3882.             upgrade these workstations as well.
  3883.  
  3884.          2. If you had PCLP workstations in the LAN Server 1.0
  3885.             environment and assigned the GUEST user ID to the
  3886.             users at these workstations, review the GUEST user ID
  3887.             account.  Revise the account as necessary to restrict
  3888.             the access permissions.
  3889.  
  3890.          The LAN Server 1.0 domain controller is no longer needed
  3891.          to provide logon service.  This workstation can now be
  3892.          reconfigured as an additional server or requester as
  3893.          required by your network.  See the IBM OS/2 VERSION 1.3
  3894.          INFORMATION AND PLANNING GUIDE and the LAN Server 1.3
  3895.          slipcase cover for server memory, fixed-disk, and
  3896.          minimum system requirements.
  3897.  
  3898.  
  3899.  
  3900.  
  3901.  
  3902.  
  3903.  
  3904.  
  3905.  
  3906.  
  3907.  
  3908.  
  3909.  
  3910.  
  3911.  
  3912.  
  3913.  
  3914.  
  3915.  
  3916.  
  3917.  
  3918.  
  3919.  
  3920.  
  3921.  
  3922.  
  3923.  
  3924.  
  3925.                                  5-15
  3926.          
  3927.  
  3928.  
  3929.  
  3930.  
  3931.  
  3932.          APPENDIX.  ERROR MESSAGES AND ERROR RECOVERY
  3933.  
  3934.  
  3935.          The error descriptions in this appendix list the error
  3936.          message and the recovery action to be taken by the
  3937.          network administrator during migration to LAN Server 1.3.
  3938.  
  3939.  
  3940.          PCLP 1.3 EXPORT ERRORS
  3941.  
  3942.          During the PCLP 1.3 Export phase of the migration, the
  3943.          network administrator can receive the following user
  3944.          errors.  The recovery action for each error is also listed.
  3945.  
  3946.          MESSAGE: Error opening output file.
  3947.          ACTION:  The error may be caused by an invalid file
  3948.                   name.  Type the valid file name and try again.
  3949.  
  3950.          MESSAGE: Error opening format file.
  3951.          ACTION:  The error may be caused by an invalid file
  3952.                   name.  Type the valid file name and try again.
  3953.  
  3954.          MESSAGE: Error getting free disk space on target drive.
  3955.          ACTION:  Erase any unnecessary files on the target drive
  3956.                   and try again.
  3957.  
  3958.  
  3959.          LAN SERVER 1.0 EXPORT ERRORS
  3960.  
  3961.          During the LAN Server 1.0 Export phase of the migration,
  3962.          the network administrator can receive the following user
  3963.          errors.  The recovery action for each error is also listed.
  3964.  
  3965.          MESSAGE: No user is logged on this machine.
  3966.          ACTION:  Log on to the domain controller and try again.
  3967.  
  3968.          MESSAGE: You do not have Administrator privilege.
  3969.          ACTION:  Log off and then log on as an administrator.
  3970.  
  3971.          Message: You are not running on a domain controller.
  3972.          ACTION:  Log off and then log on to the domain
  3973.                   controller.
  3974.  
  3975.          MESSAGE: The definition format file does not exist.
  3976.          ACTION:  Reinstall the export program in the
  3977.                   \IBMLAN\NETPROG directory and try again.
  3978.  
  3979.  
  3980.  
  3981.                                  A-1
  3982.          
  3983.  
  3984.  
  3985.  
  3986.  
  3987.  
  3988.          MESSAGE: The definition format file has internal
  3989.                   errors.
  3990.          ACTION:  Reinstall the export program and try again.
  3991.                   If the problem persists, contact your service
  3992.                   coordinator.
  3993.  
  3994.          MESSAGE: Cannot create the output file.
  3995.          ACTION:  The error may be caused by an invalid file
  3996.                   name.  Type the valid file name and try again.
  3997.  
  3998.          MESSAGE: Cannot write to the output file.
  3999.          ACTION:  The error may be caused by an invalid file
  4000.                   name.  Type the valid file name and try again.
  4001.  
  4002.          MESSAGE: Internal errors.  The Logon assignments file
  4003.                   cannot be accessed.
  4004.          ACTION:  Print the domain definition.  Correct any
  4005.                   reported errors and try again.  If the problem
  4006.                   persists, use your most recent network database
  4007.                   backup, or contact your service coordinator.
  4008.  
  4009.          MESSAGE: Program stack overflow or malloc failed.
  4010.          ACTION:  The error may be caused by a format error
  4011.                   in the export file.  Check the export file to
  4012.                   make sure each definition has the correct EOE
  4013.                   (end of entry) and EOR (end of record) markers.
  4014.  
  4015.          MESSAGE: Internal errors.  System files cannot be found.
  4016.                   Files in DCDB are missing.
  4017.          ACTION:  Print the domain definition.  Correct any
  4018.                   reported errors and try again. If the problem
  4019.                   persists, use your most recent network database
  4020.                   backup, or contact your service coordinator.
  4021.  
  4022.  
  4023.          IMPORT ERRORS
  4024.  
  4025.          During the Import phase of the migration, the network
  4026.          administrator can receive user and nonuser (program
  4027.          code) errors.
  4028.  
  4029.          USER ERRORS
  4030.  
  4031.          MESSAGE: No user is logged on this machine.
  4032.          ACTION:  Log on to the domain controller and try again.
  4033.  
  4034.          MESSAGE: You do not have Administrator class privilege.
  4035.          ACTION:  Log off and then log on as an administrator.
  4036.  
  4037.                                  A-2
  4038.          
  4039.  
  4040.  
  4041.  
  4042.  
  4043.  
  4044.          MESSAGE: You are not running on a domain controller.
  4045.          ACTION:  Log off and then log on to the domain
  4046.                   controller.
  4047.  
  4048.          MESSAGE: Cannot open file.
  4049.          ACTION:  Verify that the import file has the correct
  4050.                   name and run the Migration Utility again.
  4051.  
  4052.          MESSAGE: Unrecognized command or attributes.
  4053.          CAUSE:   The error may be caused when the user edits
  4054.                   the import file.  Check the import file to make
  4055.                   sure each record in the file has the correct
  4056.                   format.
  4057.  
  4058.          MESSAGE: Function is not supported.
  4059.          ACTION:  The error may be caused when a function other
  4060.                   than add is used.  Check the import file to
  4061.                   make sure only the add function is used.
  4062.  
  4063.          MESSAGE: Incorrect resource type specified in input file.
  4064.          ACTION:  Check the import file to make sure the
  4065.                   resource types are listed correctly.
  4066.  
  4067.          MESSAGE: Incorrect profile type specified in input file.
  4068.          ACTION:  Check the import file to make sure the profile
  4069.                   types are listed correctly.
  4070.  
  4071.          MESSAGE: Unrecognized field type in input file.
  4072.          ACTION:  Check the import file to make sure the field
  4073.                   types are listed correctly.
  4074.  
  4075.          MESSAGE: Insufficient memory to run program.
  4076.          ACTION:  Erase any unnecessary files to make more memory
  4077.                   available.
  4078.  
  4079.          MESSAGE: Insufficient privilege to access resource.
  4080.          ACTION:  Log off and then log on as an administrator.
  4081.  
  4082.          MESSAGE: Administrative privilege required.
  4083.          ACTION:  Log off and then log on as an administrator.
  4084.  
  4085.          MESSAGE: Incorrect parameter specified.
  4086.          ACTION:  Check the import file to make sure the
  4087.                   parameters are correct for the database
  4088.                   definition. Correct the import file and try
  4089.                   again.
  4090.  
  4091.  
  4092.                                  A-3
  4093.          
  4094.  
  4095.  
  4096.  
  4097.  
  4098.  
  4099.          MESSAGE: Network name cannot be found.
  4100.          ACTION:  The error may be caused by an invalid network
  4101.                   name.  Check the import file to make sure the
  4102.                   network names are valid.
  4103.  
  4104.          MESSAGE: The Server service is not started.
  4105.          ACTION:  Start the Server and try again.
  4106.  
  4107.          MESSAGE: User name not found.
  4108.          ACTION:  Check the destination domain to make sure
  4109.                   the user name is defined and try again.
  4110.  
  4111.          MESSAGE: Incorrect username or groupname parameter.
  4112.          ACTION:  Check the import file to make sure the
  4113.                   parameters are correct for the user or group
  4114.                   definition.  Correct the import file and try
  4115.                   again.
  4116.  
  4117.          MESSAGE: Operation not allowed on special group.
  4118.          ACTION:  Delete the special group from the import file
  4119.                   and try again.
  4120.  
  4121.          MESSAGE: Server cannot be located.
  4122.          ACTION:  The error may be caused by an invalid server
  4123.                   name.  Check the import file to make sure all
  4124.                   the server names are valid.
  4125.  
  4126.          MESSAGE: The name has already been shared.
  4127.          ACTION:  Delete the conflicting share and try the
  4128.                   action again.
  4129.  
  4130.          MESSAGE: The operation is not allowed on a redirected
  4131.                   resource.
  4132.          ACTION:  Specify devices that are not redirected, or
  4133.                   delete the assignments to the redirected
  4134.                   devices.
  4135.  
  4136.          MESSAGE: The printer queue does not exist.
  4137.          ACTION:  Check the printer section of the import file
  4138.                   to identify the spooler queue names.  Use
  4139.                   the LAN Server 1.3 Print Manager to create
  4140.                   necessary spooler queues.  Try again.
  4141.  
  4142.  
  4143.  
  4144.  
  4145.  
  4146.  
  4147.  
  4148.                                  A-4
  4149.          
  4150.  
  4151.  
  4152.          MESSAGE: Too many permission records.
  4153.          ACTION:  If migrating from a PCLP 1.3 domain:
  4154.                   1. Determine sets of users with matching access
  4155.                      permissions to the resource.
  4156.                   2. Delete these permissions and rerun the
  4157.                      Export and Import phases.
  4158.                   3. Create a new group definition on the LAN
  4159.                      Server 1.3 domain and add those users whose
  4160.                      permissions were removed to the new group.
  4161.                   4. Give the group access permissions to the
  4162.                      resources that match those of the removed
  4163.                      users.
  4164.          ACTION:  If migrating from a LAN Server 1.0 domain:
  4165.                   1. Define new groups of users to the LAN Server
  4166.                      1.0 domain.
  4167.                   2. Delete users with similar access permissions
  4168.                      from the profile that exceeded the limit and
  4169.                      add them to the newly defined group.
  4170.                   3. Give the groups access permissions to the
  4171.                      resources that match those of the removed
  4172.                      users.
  4173.  
  4174.          MESSAGE: Device cannot be shared as both a spooled and
  4175.                   a non-spooled resource.
  4176.          ACTION:  Delete the existing shares for the device or
  4177.                   select another device for this share.
  4178.  
  4179.          MESSAGE: The drive letter is in use locally.
  4180.          ACTION:  Try another drive letter that is not in use.
  4181.  
  4182.          MESSAGE: No more file handles.
  4183.          ACTION:  Close a file and try again.
  4184.  
  4185.          MESSAGE: Disk full.
  4186.          ACTION:  Delete a file or files to create more disk
  4187.                   space and try again.
  4188.  
  4189.          MESSAGE: Error reading or writing file.
  4190.          ACTION:  The I/O error may be caused by a bad device or
  4191.                   media.  Try again.  If the problem persists,
  4192.                   run the Export program again to create a new
  4193.                   import file that uses a different media or
  4194.                   device.
  4195.  
  4196.  
  4197.  
  4198.  
  4199.  
  4200.  
  4201.  
  4202.  
  4203.  
  4204.                                  A-5
  4205.          
  4206.  
  4207.  
  4208.  
  4209.  
  4210.          MESSAGE: Cannot create home fileset directory.
  4211.          ACTION:  A drive is bad or a redirected drive is already
  4212.                   in use.  Check the import history file to
  4213.                   identify the home directory drive.  Examine this
  4214.                   drive to locate the problem.  Correct the
  4215.                   problem and try again.
  4216.  
  4217.          MESSAGE: Server and Path/Spooler Queue combination is
  4218.                   already defined by another alias.
  4219.          ACTION:  Determine why the other alias also uses the
  4220.                   same UNC name.  Delete the existing alias, or
  4221.                   delete the redundant alias from the import file
  4222.                   and try again.
  4223.  
  4224.          MESSAGE: Network path not found; possible bad UNC name.
  4225.          ACTION:  The error may be caused by an invalid server name,
  4226.                   netname, or path name.  Check the import file
  4227.                   to make sure these names are valid.
  4228.  
  4229.          MESSAGE: Program stack overflow or malloc failed.
  4230.          ACTION:  The error may be caused by a format error in
  4231.                   the import file.  Check the import file to
  4232.                   make sure each definition has the correct EOE
  4233.                   (end of entry) and EOR (end of record) markers.
  4234.  
  4235.          MESSAGE: Cannot create path.
  4236.          ACTION:  The error may be caused by an invalid path.
  4237.                   Verify that the path format is valid for the
  4238.                   operating system being used.
  4239.  
  4240.          MESSAGE: Unrecognized command or attributes.
  4241.          ACTION:  Check the import file to verify that each
  4242.                   record has the correct format and the file has
  4243.                   been saved with the editor's tab option set to
  4244.                   off.  If tab characters are found or are
  4245.                   suspected in the import file, run the Export
  4246.                   program again.
  4247.  
  4248.          MESSAGE: Accounts database is full.
  4249.          ACTION:  If possible, delete several network accounts
  4250.                   and try again.  If the problem persists,
  4251.                   contact your service coordinator.
  4252.  
  4253.          MESSAGE: Cannot access accounts database.
  4254.          ACTION:  Print the domain definition and correct
  4255.                   network database errors.  If the problem
  4256.                   persists, use your most recent database
  4257.                   backup, or contact your service coordinator.
  4258.  
  4259.  
  4260.                                  A-6
  4261.          
  4262.  
  4263.  
  4264.  
  4265.  
  4266.  
  4267.          PROGRAM CODE ERRORS
  4268.  
  4269.          Following are nonuser (program code) errors.
  4270.  
  4271.          MESSAGE: Cannot get workstation WKS record.
  4272.          CAUSE:   The workstation (WKS) record at the domain
  4273.                   controller cannot be accessed.
  4274.          ACTION:  Stop all applications currently running and
  4275.                   stop and restart the server.  Reformat and
  4276.                   reinstall your target machine.  Redo your
  4277.                   export process.  Ensure that either you or
  4278.                   the network administrator has ADMIN privilege
  4279.                   when logging on.  If the problem persists,
  4280.                   contact your service coordinator.
  4281.  
  4282.          MESSAGE: Incorrect parameter specified.
  4283.          CAUSE:   An incorrect parameter was passed to a
  4284.                   LAN API call.
  4285.          ACTION:  Stop all applications currently running,
  4286.                   reinstall the server code, and restart the
  4287.                   Migration Utility.  If the problem persists,
  4288.                   have your service coordinator send both
  4289.                   your history and input file to IBM.
  4290.  
  4291.          MESSAGE: Unexpected error from DosFind Call.
  4292.          CAUSE:   An unexpected error was received from
  4293.                   DosFind Call.
  4294.          ACTION:  Check the history file to identify which
  4295.                   record caused the problem.  Check the
  4296.                   contents of the input file and make sure the
  4297.                   file is correct.  If there is a problem with
  4298.                   the format of the input file, use the correct
  4299.                   input file and restart the Migration Utility.
  4300.                   If the problem persists, have your service
  4301.                   coordinator send both your history and input
  4302.                   file to IBM.
  4303.  
  4304.          MESSAGE: Unexpected error from DosQFileMode.
  4305.          CAUSE:   An unexpected error was received from
  4306.                   DosQFileMode.
  4307.          ACTION:  Check the history file to identify which
  4308.                   record caused the problem.  Check the
  4309.                   contents of the input file and make sure the
  4310.                   input file is correct.  If there is a problem
  4311.                   with the format of the input file, use the
  4312.                   correct input file and restart the Migration
  4313.                   Utility.  If the problem persists, have your
  4314.                   service coordinator send both your
  4315.                   history and input file to IBM.
  4316.                                    A-7
  4317.          
  4318.  
  4319.  
  4320.  
  4321.  
  4322.  
  4323.          MESSAGE: Incorrect level specified.
  4324.          CAUSE:   The wrong data structure level was used when
  4325.                   invoking the LAN API.
  4326.          ACTION:  Stop all applications currently running,
  4327.                   reinstall the server code, and restart the
  4328.                   Migration Utility.  If the problem persists,
  4329.                   have your service coordinator send both your
  4330.                   history and input file to IBM.
  4331.  
  4332.          MESSAGE: Additional data is available.
  4333.          CAUSE:   The buffer size for information passed to the
  4334.                   LAN API is too small.
  4335.          ACTION:  Ensure that the input data is correct and
  4336.                   ended properly.  Retry the operation.  If the
  4337.                   problem persists, have your service
  4338.                   coordinator send both your history and input
  4339.                   file to IBM.
  4340.  
  4341.          MESSAGE: The API return buffer is too small.
  4342.          CAUSE:   The API return buffer is too small for
  4343.                   fixed-length data.
  4344.          ACTION:  Stop all applications currently running,
  4345.                   reinstall the server code, and restart the
  4346.                   Migration Utility.  If the problem persists,
  4347.                   have your service coordinator send both your
  4348.                   history and input file to IBM.
  4349.  
  4350.          MESSAGE: Remote API error occurred.
  4351.          CAUSE:   A remote API error has occurred.
  4352.          ACTION:  Check the history file to identify which
  4353.                   record caused the problem.  Identify the
  4354.                   server name in the record and ensure that the
  4355.                   server has been started.  If the problem
  4356.                   persists, have your service coordinator send
  4357.                   both your history and input file to IBM.
  4358.  
  4359.          MESSAGE: An Internal error occurred when the workstation
  4360.                   driver was called.
  4361.          CAUSE:   An internal error occurred when the workstation
  4362.                   driver was called.
  4363.          ACTION:  Stop all applications currently running,
  4364.                   reinstall the requester and server code, and
  4365.                   restart the Migration Utility.  If the
  4366.                   problem persists, contact your service
  4367.                   coordinator.
  4368.  
  4369.  
  4370.  
  4371.  
  4372.                                    A-8
  4373.          
  4374.  
  4375.  
  4376.  
  4377.  
  4378.  
  4379.          MESSAGE: RSDE database consistency check failure.
  4380.          CAUSE:   The checksum of information stored in the
  4381.                   DCDB files is incorrect.  Write errors, reboots
  4382.                   during writes, or a power failure occurred.
  4383.          ACTION:  Restore the DCDB from a backup and restart
  4384.                   the Migration Utility.  If the problem
  4385.                   persists, have your service coordinator send
  4386.                   both your history and input file to IBM.
  4387.  
  4388.          MESSAGE: RSDE rsd_enum select function abort.
  4389.          CAUSE:   An internal error occurred.  Possible causes
  4390.                   are:   the disk is full or out of memory.
  4391.          ACTION:  Restore the DCDB from a backup and restart the
  4392.                   Migration Utility.  If the problem persists,
  4393.                   have your service coordinator send both your
  4394.                   history and input file to IBM.
  4395.  
  4396.          MESSAGE: DCDB file is locked.
  4397.          CAUSE:   An error occurred.
  4398.          ACTION:  Restore the DCDB from a backup and restart
  4399.                   the Migration Utility. If the problem persists,
  4400.                   have your service coordinator send both your
  4401.                   history and input file to IBM.
  4402.  
  4403.          MESSAGE: Protection violation.
  4404.          CAUSE:   A protection violation has occurred.
  4405.          ACTION:  Reinstall the server code. If the problem
  4406.                   persists, see your service coordinator and
  4407.                   have your system dump sent to IBM.
  4408.  
  4409.  
  4410.  
  4411.  
  4412.  
  4413.  
  4414.  
  4415.  
  4416.  
  4417.  
  4418.  
  4419.  
  4420.  
  4421.  
  4422.  
  4423.  
  4424.  
  4425.  
  4426.  
  4427.  
  4428.                                    A-9
  4429.          
  4430.  
  4431.  
  4432.  
  4433.  
  4434.  
  4435.          WARNING MESSAGES
  4436.  
  4437.          During the Import phase of the migration, the network
  4438.          administrator can receive the following warning messages:
  4439.  
  4440.          ** Warning ** An alias cannot be defined for a removable
  4441.                        drive.
  4442.  
  4443.          ** Warning ** File path will not be created. Profile not
  4444.                        migrated.
  4445.  
  4446.          ** Warning ** Profile path.
  4447.  
  4448.          ** Warning ** Resource name already exists. Entity not
  4449.                        migrated.
  4450.  
  4451.          ** Warning ** Resource could not be shared at this time.
  4452.  
  4453.          ** Warning ** Profile already exists.
  4454.  
  4455.          ** Warning ** Username or group name already exists.
  4456.  
  4457.          ** Warning ** Resource name not found. Access Control
  4458.                        not migrated.
  4459.  
  4460.          ** Warning ** Requested Device not valid.
  4461.  
  4462.  
  4463.  
  4464.  
  4465.  
  4466.  
  4467.  
  4468.  
  4469.  
  4470.  
  4471.  
  4472.  
  4473.  
  4474.  
  4475.  
  4476.  
  4477.  
  4478.  
  4479.  
  4480.  
  4481.  
  4482.  
  4483.  
  4484.                                  A-10
  4485.           
  4486.