IBM Tivoli ADSTAR User Manual - 1.0 Introduction

Manual is about: Distributed Storage Manager for VM

Summary of Tivoli ADSTAR

  • Page 1

    Ibm program directory for tivoli adstar distributed storage manager for vm version 3 release 1.2 program number 5697-vm3 for use with vm/esa version 2 release 2.0 vm/esa version 2 release 3.0 vm/esa version 2 release 4.0 document date: june 1999 gi10-0548-00

  • Page 2

    Note before using this information and the product it supports, be sure to read the general information under appendix e, “notices” on page 53. This program directory, dated june 1999, applies to tivoli adstar  distributed storage manager version 3 release 1.2 (tivoli adsm for vm), program number 5...

  • Page 3: Contents

    Contents 1.0 introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.1 program description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.2 important vm/esa  2.4.0 information . . . . ....

  • Page 4: Figures

    7.2 servicing tivoli adsm for vm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 7.2.1 prepare to receive service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 7.2.2 receive the service . . . . . . . . . . . . . . . . . . . . . . ...

  • Page 5: 1.0 Introduction

    1.0 introduction this program directory is intended for the system programmer responsible for program installation and maintenance. It contains information concerning the material and procedures associated with the installation and service of tivoli adsm for vm. You should read all of this program d...

  • Page 6

    1.2 important vm/esa  2.4.0 information beginning with vm/esa 2.4.0, tivoli adsm for vm 3.1.2 is a pre-installed, optionally installable product on the vm/esa system ddr in a disabled state. Most of the install steps have already been completed. This includes installing the adsm base tape and rsu t...

  • Page 7: 2.0 Program Materials

    2.0 program materials an ibm program is identified by a program number. The program number for tivoli adstar distributed storage manager version 3 is 5697-vm3. The program announcement material describes the features supported by tivoli adsm for vm. Ask your ibm marketing representative for this inf...

  • Page 8

    2.2 optional machine-readable material there are no optional machine-readable materials for tivoli adsm for vm. 2.3 program publications the following sections identify the basic and optional publications for tivoli adsm for vm. 2.3.1 basic program publications one copy of the following publications...

  • Page 9

    One copy of the vm/esa softcopy displayable cd-rom collection kit, ibm online library omnibus edition: vm collection number sk2t-2067, will be included in your order. Note that this collection kit will not be available until july 23, 1999. It contains all of the tivoli adsm for vm publications. This...

  • Page 10

    Figure 5 (page 2 of 2). Publications useful during installation / service on vm/esa version 2.3.0 and higher publication title form number vm/esa: vmses/e introduction and reference gc24-5837 vm/esa: service guide gc24-5838 vm/esa: planning and administration sc24-5750 vm/esa: cms command reference ...

  • Page 11: 3.0 Program Support

    3.0 program support this section describes the ibm support available for tivoli adsm for vm. 3.1 preventive service planning before installing tivoli adsm for vm, check with your ibm support center or use ibmlink  (servicelink) to see whether there is additional preventive service planning (psp) in...

  • Page 12

    4.0 program and service level information this section identifies the program and any relevant service levels of tivoli adsm for vm. The program level refers to the apar fixes incorporated into the program. The service level refers to the ptfs shipped with this product. Information about the cumulat...

  • Page 13

    5.0 installation requirements and considerations the following sections identify the system requirements for installing the tivoli adsm for vm program product. 5.1 migration requirements if you are a current user of adsm version 2 and will be migrating to tivoli adsm for vm version 3, then you must ...

  • Page 14

    (optional) ibm acf/vtam  version 3 release 4 (5684-095) or later is required for sna communications (3270 and appc) between an adsm client and the server. 5.3.3 program installation/service considerations this section describes items that should be considered before you install or service tivoli ad...

  • Page 15

    If you choose to install tivoli adsm for vm on a common user id the default minidisk addresses for tivoli adsm for vm may already be defined. If any of the default minidisks required by tivoli adsm for vm are already in use you will have to create an override to change the default minidisks for tivo...

  • Page 16

    Figure 8 (page 2 of 2). Dasd storage requirements for target minidisks minidisk owner (user id) default address storage in cylinders fb-512 blocks sfs 4k blocks usage dasd cyls default sfs directory name 5654a09a 4e2 3390 3380 9345 45 54 54 64800 8100 this is the test build disk which will contain t...

  • Page 17

    6.0 installation instructions this chapter describes the installation methods and the step-by-step procedures to install the tivoli adsm for vm program product. The step-by-step procedures are in two column format. The steps to be performed are in bold large numbers. Commands for these steps are on ...

  • Page 18

    For a complete description of all vmses/e installation options refer to vmses/e introduction and reference. 6.2 plan your installation for tivoli adsm for vm note this planning section should be followed no matter what release of vm/esa you are installing on. Follow the instructions that pertain to ...

  • Page 19

    Continue with these procedures until a r/w link is established to the 51d minidisk. What's next? Beginning with vm/esa version 2 release 4.0, tivoli adsm for vm 3.1.2 is pre-installed, using vmses/e, in a disabled state, on the vm/esa system ddrs. If, and only if, you have a license for tivoli adsm ...

  • Page 20

    Is what needs to be updated. You will need to replace the current disabled entry for prodid 5654a09a (tivoli adsm for vm) with the entry from the 5654a09a prodsys file (created by vmfins in the previous step). If necessary, refer to the vm/esa planning and administration manual for more information ...

  • Page 21

    Vmfins276 i vmfins processing started vmfins19 9i vmfins prodlist created on your a-disk vmfins276 i vmfins processing completed successfully ready; 4 5 8 obtain resource planning information for tivoli adsm for vm. Note: the product will not be loaded by the vmfins command at this time. Vmfins inst...

  • Page 22

    Vmfins2767i reading vmfins defaults b for additional options vmfins276 i vmfins processing started vmfins26 1r do you want to create an override for :ppf 5654a 9a adsm :prodid 5654a 9a%adsm? Enter (no), 1 (yes) or 2 (exit) vmfins26 3i processing product :ppf 5654a 9a adsm :prodid 5654a 9a%adsm vmfin...

  • Page 23

    Note complete this step only if you received message vmfreq28 6w for any of the products that are required by tivoli adsm for vm: either ibm language environment (5688-198) or ibm c/370 library (5688-188). Vmfreq28 6w the following requisites for product :ppf 5654a 9a adsm :prodid 5654a 9a%adsm are ...

  • Page 24

    6.3 allocate resources for installing tivoli adsm for vm use the planning information in the 5654a09a planinfo file, created in the plan step, to: create the 5654a09a user directory for minidisk install or create the 5654a09a user directory for sfs install. 6.3.1 installing tivoli adsm for vm on min...

  • Page 25

    2 change the password for 5654a09a from xxxxxxxx to a valid password, in accordance with your security guidelines. 3 if you intend to use an sfs directory in place of the 191 minidisk for the 5654a09a user id, the ipl statement must include the values "parm filepool poolid:" (poolid is the name of t...

  • Page 26

    Note: this must be done from a user id that is an administrator for vmsys: filepool. C determine if there are enough blocks available in the filepool to install tivoli adsm for vm. This information can be obtained with the query filepool status command. Near the end of the output from this command i...

  • Page 27

    3 execute the profile to access maint's minidisks. Profile 4 if the software inventory disk (51d) was accessed r/o (read only) then establish write access to the software inventory disk. Note: if the maint 51d minidisk was accessed r/o, you will need to have the user who has it linked r/w link it as...

  • Page 28

    Vmfins2767i reading vmfins defaults b for additional options vmfins276 i vmfins processing started vmfins26 1r do you want to create an override for :ppf 5654a 9a adsm :prodid 5654a 9a%adsm? Enter (no), 1 (yes) or 2 (exit) vmfins26 3i processing product :ppf 5654a 9a adsm :prodid 5654a 9a%adsm vmfre...

  • Page 30

    Admin client on your system. The book also contains instructions for migrating a version 2 adsm system to version 3. Tivoli adsm for vm is now installed and built on your system. 26 tivoli adsm for vm program directory.

  • Page 31: 7.0 Service Instructions

    7.0 service instructions rsu warning if applying a tivoli adsm for vm rsu (recommended service upgrade) go to the instructions in appendix a, “applying an rsu tape for tivoli adsm for vm” on page 36. You will return to a step in this chapter as specified in that appendix. This section of the program...

  • Page 32

    Build new levels the build task generates the serviced level of an object and places the new object on a test build disk. Place the new service into production once the service is satisfactorily tested it is ready to put into production by copying the new service to the production disk. 7.2 servicin...

  • Page 33

    5654a09a is the ppf that was shipped with the product. If you have your own ppf override you should substitute your ppf name for 5654a09a. Use adsm for installing on minidisks or adsmsfs for installing in shared file system directories. 5 receive the documentation. Electronic service if you are rece...

  • Page 34

    Use adsm for installing on minidisks or adsmsfs for installing in shared file system directories. This command clears the alternate apply disk. 10 review the merge message log ($vmfmrd $msglog). If necessary, correct any problems before going on. For information about handling specific error message...

  • Page 37

    Note if the $ppf files have been serviced you will get the following prompt: vmfbld2185r the following source product parameter files have been serviced: vmfbld2185r 5654a 9a $ppf vmfbld2185r when source product parameter files are serviced, all product parameter files built from them must be recomp...

  • Page 39

    You have finished servicing tivoli adsm for vm. Service instructions 35.

  • Page 40

    Appendix a. Applying an rsu tape for tivoli adsm for vm note you should first read through the rsu hard copy memo contained with the tape before continuing with these instructions. The rsu tape is structured to install all ptfs included on the tape plus the tape files containing the preapplied servi...

  • Page 41

    Building new levels the build tasks generates the serviced level of an object and places the new object on a build disk. Placing the new service into production once the service is satisfactorily tested it should be put into production by copying the new service to the production disk. A.1 apply tiv...

  • Page 42

    A if receiving the rsu from tape vmfins install info (nomemo b if receiving the rsu from an envelope file vmfins install info (nomemo env rptfnum 5 determine dasd sizes for disks to receive service in order to receive the service from the rsu tape, you need to have adequate space available on the al...

  • Page 43

    Use adsm for installing on minidisks or adsmsfs for installing in shared file system directories. This command produces an output file that contains information about the service on the rsu compared against the service and local modifications on your system. The file name is appid psuplan, where app...

  • Page 44

    Vmfins2767i reading vmfins defaults b for additional options vmfins276 i vmfins processing started vmfins26 3i processing product :ppf 5654a 9a adsm :prodid 5654a 9a%adsm vmfreq28 5i product :ppf 5654a 9a adsm :prodid 5654a 9a%adsm has passed requisite checking vmfint26 3i installing product :ppf 56...

  • Page 46

    A.1.5 determine rsu service level the service contained on each rsu constitutes a new service level. Use this service level when ordering corrective service. The service level is updated in the system inventory when the rsu is installed. The following command is used to query the current service lev...

  • Page 47

    Appendix b. Disabling tivoli adsm for vm if you are running vm/esa version 2 release 4.0 and had previously licensed and enabled tivoli adsm for vm 3.1.2 for use, and no longer are licensed for tivoli adsm for vm, you need to explicitly disable tivoli adsm for vm. Perform the following steps to disa...

  • Page 48

    The 5654a09a prodsys file was created by vmfins in the previous step. You need to update the cp system config file so that the next time you ipl your system tivoli adsm for vm will be in the disabled state. If you are not authorized to update the cp system configuration file then contact your cp sys...

  • Page 49: And Creating Ppf Override

    Appendix c. Moving tivoli adsm for vm to sfs directories and creating ppf override this appendix describes how to move tivoli adsm for vm into shared file (sfs) if it was not installed into sfs at initial install time. It also gives sample instructions on creating a ppf (product parameter file) over...

  • Page 50

    Notes: 1. The steps that follow help you determine the tivoli adsm for vm file pool space requirements, file pool enrollment, and sfs directory definitions. If not all of these steps are required - for example, you are changing only sfs directory or subdirectory names - adapt these instructions as n...

  • Page 51

    Set filepool userfilepool: create directory dirid dirid is the name of the sfs directory you're creating, such as the default names: create directory userfilepool:5654a 9a.Adsm create directory userfilepool:5654a 9a.Adsm.Object create directory userfilepool:5654a 9a.Adsm.Delta create directory userf...

  • Page 52

    Where vdev is the minidisk you are copying files from. If you are copying from sfs then substitute in the sfs directory name in place of vdev. Dirid is the name of the (target) sfs directory that you are copying files to. 5654a09a%adsm is the prodid defined within the 5654a09a ppf file for the tivol...

  • Page 53

    2 create (or modify as required) the variable declarations (:dcl.) section for the adsmsfs override area so that it resembles the :dcl. Section as shown below. :overlst. Adsmsfs p p=========================================================p :adsmsfs. Adsm 5654a 9a p===================================...

  • Page 54

    Appendix d. Adsm installation tape contents file 1: ins 99 tape descriptor file $$tape$$ vmses standard header file for ses format tapes 5654a 9a prodpart product parts file 5654a 9a $ppf base product parameter file 5654a 9a ppf default usable form product parameter file 5654a 9a memo adsm for vm me...

  • Page 55

    Anrsvm5 module svm module dsmserv profile sample profile exec for dsmserv virtual machine dsmexit profile sample profile exec for tape mount virtual machine dsmserv sampdir sample dsmserv virtual machine directory definition dsmexit1 sampdir sample dsmexit1 virtual machine directory definition dsmse...

  • Page 56

    Anrvm cntrl control file containing the version vector table level scripts sample server sample scripts anrbaroc sample anrusrxa sample anrusrxc sample anrusrxh sample dsmserv idl server idl file ashg 998 class server web client panel cmmndln class server web client panel dsmcnsl class server web cl...

  • Page 57: Appendix E. Notices

    Appendix e. Notices references in this document to ibm products, programs, or services do not imply that ibm intends to make these available in all countries in which ibm operates. Any reference to an ibm product, program, or service is not intended to state or imply that only ibm's product, program...

  • Page 58

    54 tivoli adsm for vm program directory.

  • Page 59: Reader'S Comments

    Reader's comments tivoli adstar distributed storage manager version 3 release 1.2 your feedback is important in helping to provide the most accurate and high-quality information. If you have comments or suggestions for improving this publication, you can send us comments electronically by using thes...

  • Page 60

    Is this the first time your organization has installed this product? Yes no were the people who did the installation experienced with the installation of vm products using vmses/e? Yes how many years of experience do they have? __________ no how long did it take to install this product? ____________...

  • Page 62

    Ibm program number: 5697-vm3 5802 6001 printed in u.S.A. Gi1 - 548-.