This topic applies only on the z/OS operating system.

Customization Dialog walk-through for migrating a managed application server node

Walk through using the Customization Dialog to generate the JCL jobs (CNTL and DATA data sets) for migrating a managed application server node. You must create these jobs before you can begin the actual migration.

Before you begin

Before migrating a managed node, you MUST migrate its deployment manager first. If you have not migrated the deployment manager, see Network Deployment migrations then return to this article after the deployment manager is migrated.
Note: You can reuse the same target data sets, HFS, and JCL procedures in the Customization Dialog walk-through for your managed nodes that you used for the deployment manager, if you so choose. See the system-generated instructions for BBOMMINS for complete details.

Default values can be accepted for all fields and settings except for those that are explicitly identified in the following steps.

Procedure

  1. Invoke the WebSphere Application Server for Version 6.0.x Customization Dialog.
    ex 'product_hlq.SBBOCLIB(BBOWSTRT)' 'options'
    • Example product_hlq: WAS601.WAS
    • Example options: appl(az)

    _________________________________________________________________

  2. From the first menu page, select option 4: Migrate Version 5.x Nodes to V6 Nodes.

    _________________________________________________________________

  3. On the next panel, choose option 3: Migrate a Version 5.x federated node to V6.

    _________________________________________________________________

  4. The next step is to allocate partitioned data sets that you will use to store the generated migration jobs and supporting data. On the "V5.x Federated Node Migration" menu, choose option 1: Allocate target data sets.

    _________________________________________________________________

  5. On the "Allocate Target Data Sets" panel, specify your high-level qualifier and then press Enter to proceed to the next panel.

    _________________________________________________________________

  6. Accept the defaults on the next two panels that specify the parameters for the .CNTL and .DATA data sets.

    _________________________________________________________________

  7. Back on the "V5.x Federated Node Migration" menu, choose option 2: Define variables.

    In the following panels, the migration data collection process begins.

    _________________________________________________________________

  8. On the "Define Variables to migrate a V5.x Federated Node" menu, choose option 1: System Locations (directories, HLQs, etc.).

    _________________________________________________________________

  9. The System Locations (1 of 2) panel collects information about your Version 6.0.x installation libraries, and whether you intend to place the load modules in STEPLIB. Correctly specifying STEPLIB is essential to a successful migration. It is likely that your Version 5.x modules are currently in LPA/LNKLST and that you will begin with your Version 6.0.x libraries being defined in STEPLIB. Specify whether to put your Version 6.0.x modules in STEPLIB, and continue to the next panel.
    Example:
    System Locations (1 of 2)                                                   
                                                                                
      Specify the following V6.0.2 information, then press ENTER to continue.   
                                                                                
      For some data sets, specify "Y" if they are in STEPLIB.                   
                                                                                
    Full Names of Data Sets                                                     
                                                                                
      PROCLIB.:  SYS1.PROCLIB                                                   
                                                                                
    Run WebSphere Application Server from STEPLIB (Y/N)?  Y                     
    SBBOLPA.:  WAS601.WAS.SBBOLPA                                               
    SBBOLOAD:  WAS601.WAS.SBBOLOAD                                              
    SBBOLD2.:  WAS601.WAS.SBBOLD2                                               
                                                                                
                                  Use STEPLIB?                                  
    SCEERUN.:  CEE.SCEERUN              Y                                       
    SCEERUN2:  CEE.SCEERUN2             Y                                       
    SGSKLOAD:  SYS1.GSK.SGSKLOAD        Y                                       
         (leave SGSKLOAD blank if all systems are at z/OS 1.6 or above)                                  

    _________________________________________________________________

  10. On the "System Locations (2 of 2)" panel, specify your Version 6.0.x WebSphere Application Server SMP/E home directory (/usr/lpp/zWebSphere/V6R0 for example) and press Enter to proceed.

    _________________________________________________________________

  11. Back on the "Define Variables to migrate a V5.x Federated Node" menu, option 1 is marked as completed. Choose option 2: System Environment Customization.

    _________________________________________________________________

  12. The System Environment Customization panel is where you specify the Version 6.0.x configuration root HFS, which is where the configuration for the node being migrated is physically stored. You can choose to use an existing Version 6.0.x HFS if you already have an appropriate HFS on the node being migrated. If you choose to use an existing Version 6.0.x HFS, you need to ensure that the mount point you specify here is present before running the migration utilities (BBOWMG1F, BBOWMG2F, and so on) that are created through these dialogs. If you choose to create a new Version 6.0.x HFS on the node being migrated, the actual creation of the new HFS will not occur until you run the BBOWMMMT job during the migration process, after you complete this walk-through (see Migrating a standalone application server node for more information). Specify either an existing mount point or a new mount point and press Enter to proceed.
    Example:
    System Environment Customization                                   
                                                                       
       Specify the following to customize your system environment, then
       press Enter to continue.                                        
                                                                       
     WebSphere Application Server for z/OS HFS Information             
                                                                       
       Mount point....:  /WebSphere/V6R0                               
       Name...........:  OMVS.WAS.CONFIG.HFS                           
       Volume, or '*' for SMS.:  *                                     
       Primary allocation in cylinders...:  250                        
       Secondary allocation in cylinders.:  100

    _________________________________________________________________

  13. Back on the "Define Variables to migrate a V5.x Federated Node" menu, options 1 and 2 are marked as completed. Select option 3: Server Customization.

    _________________________________________________________________

  14. On the Server Customization (1 of 2) panel, specify the source node that you are migrating under "V5.x WebSphere Application Server home directory."

    Also, specify the home location of the profile that will contain your Version 6.0.x migrated node under "V6 WebSphere Application Server home directory."

    On this panel, you can also choose to enable tracing on your migration utilities, which will then remain enabled throughout the entire migration process. Enabling tracing generates a lot of output, and is generally intended for use only when directed by service support.

    During migration, a backup copy of the Version 5.x configuration is required. The default location of this backup is already specified, though you can override if needed. You might need to specify a location other than the default if the /tmp HFS does not have adequate space to store the backup configuration. If you choose to override the default location of the backup copy, the best practice is to keep the same naming convention and just replace the /tmp portion with another path, /myTempmigrate/57638/fed_backup for example. The five-digit number (57638 in this example) is generated uniquely each time you create the migration jobs.

    The migration output messages, which you will need to monitor throughout the migration process, are stored in tmp/migrate/57638 (after migration, the job output in this directory is NOT automatically deleted). The migration output messages are also appended to the JCL sysout messages, which can be viewed in SDSF.

    After you have specified all values or left the defaults, press Enter to proceed to the next panel.

    Example:
    Server Customization (1 of 2)                                          
                                                                           
       Specify the following to customize your migration, then press Enter 
       to continue.                                                        
                                                                           
       V5.x WebSphere Application Server home directory:                   
          /WebSphere/V5R1M0                                                
             / AppServer                                                   
                                                                           
       V6 WebSphere Application Server home directory:                     
          /WebSphere/V6R0                                                  
             / AppServer                                                   
                                                                           
       Migration Options                                                   
                                                                           
         Enable z/OS Migration Tracing:  N                                 
         Enable WASProfile Tracing....:  N                                 
         Enable WASPreUpgrade Tracing.:  N                                 
         Enable WASPostUpgrade Tracing:  N                                 
                                                                           
         Default Backup Directory:  /tmp/migrate/57638/fed_backup          
         User Specified Backup Directory:                                  
    

    _________________________________________________________________

  15. On the Server Customization (2 of 2) panel, specify the High Availability Manager Host, a feature in Version 6.0.1 that has no previous value from Version 5.x. The value you enter here is the IP address of the LPAR you are migrating. This value must resolve to a single IP address, and you can use a dotted decimal address.

    The procedure names used to start the Version 6.0.x servers are also specified on this panel; new procedure names are required for Version 6.0.x. You can keep the defaults or change them if needed. The Customization Dialog creates new Version 6.0.x JCL using the procedure names specified here.

    Because some of the migration jobs require running under a WebSphere Administrator ID, you need to supply a valid administrator ID and password here as well.

    Specify values or accept defaults and press Enter to proceed.

    Example:
    Server Customization (2 of 2)                                          
                                                                           
       Specify the following to customize your migration, then press Enter 
       to continue.                                                        
                                                                           
                                                                           
       High Availability manager Host:                                     
         The High Availability Manager Host MUST resolve to a single       
         IP address. It can not be a multihomed host.                      
                                                                           
       Daemon Procedure name.........:  BBO6DMN                            
                                                                           
       Controller Procedure name.....:  BBO6ACR                            
                                                                           
       Servant Procedure name........:  BBO6ASR                            
                                                                           
       Some migration tasks require running under the                      
       WebSphere Administrators account:                                   
                                                                           
         WebSphere Administrator User ID.:  XXXXXXX                        
         WebSphere Administrator Password:  XXXXXXXX
                                                                           

    Note: The "High Availability Manager Host" field was removed from the dialog in WebSphere Application Server for z/OS Version 6.0.2.

    _________________________________________________________________

  16. After completing the Customization (2 of 2) panel, you will be returned to the "Define Variables to migrate a V5.x Federated Node" menu. Press PF3 to return to the "V5.x Federated Node Migration" menu.

    _________________________________________________________________

  17. On the "V5.x Federated Node Migration" menu, choose option 3: Generate customization jobs.

    _________________________________________________________________

  18. On the Generate Customization Jobs panel, you can see the names of the .CNTL and .DATA data sets that have been customized based on your previous input.

    Now you need to provide a job card customized to your environment-specific requirements.

    When you have entered your job card, press Enter. The generation process runs, and presents you with a list of job streams and files that have been created to perform the migration to Version 6.0.x. These jobs do not require any editing; they are to be submitted "as-is" during the migration process.

    Enter an appropriate job card, and press Enter to proceed.

    Example:
    Generate Customization Jobs                                                 
                                                                                
     This portion of the Customization Dialog generates the jobs you must       
     run after you complete this dialog process. You must complete the          
     customization process before you generate the jobs with this step.         
     If you have not done this, please return to that step.                     
                                                                                
     Jobs and data files will get generated into data sets:                     
       'hlq.CNTL'                                                 
       'hlq.DATA'                                                 
     If you wish to generate customization jobs using other data sets, then     
     exit from this panel and select the "Allocate target data sets" option.    
                                                                                
    All the jobs that will be tailored for you will need a job card.            
    Please enter a valid job card for your installation below. The              
    file tailoring process will update the job name for you in all the          
    generated jobs, so you need not be concerned with that portion of           
    the job cards below. If continuations are needed, replace the               
    comment cards with continuations.                                           
                                                                                
    Specify the job cards, then press Enter to continue.                        
                                                                                
    //jobname JOB (ACCTNO,ROOM),'IBMUSER',CLASS=A,REGION=0M                     
    //*                                                                         
    //*                                                                         
    //*                                                                         
    

    _________________________________________________________________

  19. A list of JCL jobs that have been generated for your migration is displayed. When processing has completed, press Enter to proceed.
    Example:
    Processing for data set 'hlq.CNTL' ...        
    Member BBOWMG1F successfully created.                       
    Member BBOWMG2F successfully created.                       
    Member BBOWMG3F successfully created.                       
    Member BBOWMMMT successfully created.                       
    Member BBOMMCR successfully created.                        
    Member BBOMMCRZ successfully created.                       
    Member BBOMMDN successfully created.                        
    Member BBOMMDNZ successfully created.                       
    Member BBOMMSR successfully created.                        
    Member BBOMMSRZ successfully created.                       
    Member BBOMMCP successfully created.                        
    Member BBOMMINS successfully created.                       
                                                                 
    Processing for data set 'hlq.DATA' ...                
    Member BBOWBMPT successfully created.                       
    Member BBOWMMRF successfully created.                       
    ***                                                                                                              

    _________________________________________________________________

  20. You will be returned back to the "V5.x Federated Node Migration" menu. You should now save your configuration variables for future reference by selecting option S: Save Customization Variables.

    _________________________________________________________________

  21. You have now completed the job generation process and are ready to begin the process of migration. See instructions for performing the migration by selecting option 4: View instructions. Also, proceed to the article Migrating a federated application server node for instructions on performing the migration.

    _________________________________________________________________




In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic    

Terms of Use | Feedback

Last updated: Aug 29, 2010 8:25:23 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=vela&product=was-nd-zos&topic=tinsfedcdwalkthru
File name: tins_fedcdwalkthru.html