Novell LINUX ENTERPRISE SERVER STARTER SYSTEM, Installation Manual

Page 1: ...SUSE Linux Enterprise Server Starter System for System z Installation Guide ...

Page 2: ......

Page 3: ...SUSE Linux Enterprise Server Starter System for System z Installation Guide ...

Page 4: ......

Page 5: ...SUSE Linux Enterprise Server Starter System for System z Installation Guide November 29 2007 Novell Inc www novell com ...

Page 6: ...ii Installing the SUSE Linux Enterprise Server Starter System for System z ...

Page 7: ...ion Information 7 Downloaded Components 7 Documentation Downloads 7 Sample CP Directory Entry 8 Utility Downloads 8 Disk Image Downloads 8 Installing the SUSE Linux Enterprise Server Starter System for System z 9 Installing the SUSE Linux Enterprise Server Starter System for System z 10 Preparing the Virtual Machine 10 Performing the Installation 11 Configuring the SUSE Linux Enterprise Server Sta...

Page 8: ...e FTP session is prompting for a write password 35 How to Report Problems With the Starter System 36 What to Collect Before You Report A Problem 36 Where to Report A Problem 36 Appendices 37 Appendix A Contents of Starter System Distribution Archives 38 Appendix B Copyright and License Information 39 General Documentation License 39 Availability of Source Code 39 CMS Utility Licenses 39 Appendix C...

Page 9: ...RC 17 21 Restoring NOV151 DISKIMG to NOVSTART 151 17 22 Erasing NOV151 Image and Distribution Archives 17 23 Release R W Access to NOVSTART F00 17 24 Sample FTP Session from a Workstation to z VM NOVSTART 150 18 25 Re linking NOVSTART 150 On Another Userid 18 26 Access NOVSTART Minidisks 18 27 Unpacking NOV150 VMARC 19 28 Restoring NOV150 DISKIMG to NOVSTART 150 19 29 Erasing NOV151 Image and Dist...

Page 10: ... File Checklist 7 5 Sample Directory Entry Checklist 8 6 CMS Utility Download Checklist 8 7 Disk Image Download Checklist 8 8 Channel Device Identifiers for Client Network based Install 31 9 Install Methods And Parameters 31 10 Starter System Distribution Archive Contents 38 vi Installing the SUSE Linux Enterprise Server Starter System for System z ...

Page 11: ...Preparing to Install the SUSE Linux Enterprise Server Starter System for System z Preparing to Install the SUSE Linux Enterprise Server Starter System for System z 1 ...

Page 12: ... prevent the server from booting and connecting to the network for normal maintenance This document describes the pieces you need to download and the resources needed to install the starter system The instructions also include an example of how to install an additional Linux server from the starter system The Starter System Is Not Suitable for General Use The starter system image has been highly c...

Page 13: ...o hold the system image and the RPM repos itory Use the sample directory entry NOVSTART SAMPDIR and your local directory and disk management practices to allocate the disk space as shown in the sample direc tory entry Sites that use larger model 9 or 27 volumes may combine the minidisks shown in the sample directory entry onto a single larger volume without impact Temporary Disk Requirements Durin...

Page 14: ...e document are available Sample Directory Entry A sample CP directory entry can be downloaded from the location referred to above Two versions are available NOVSTART SAMPDIR The sample directory entry in EBCDIC This version is suitable for direct submission to directory managers or editing on CMS NOVSTART SAMPASC The sample directory in ASCII This version is provided for viewing on ASCII based hos...

Page 15: ...sk Images The starter system disk images can be downloaded from the download area noted above There are 4 files NOV191 VMARC NOV150 VMARC NOV151 VMARC NOV19F VMARC Figure 1 Disk Image Files Where to Get the Components 5 ...

Page 16: ...irtual Address Mini disk Label Desc Device Type Size Starting Cyl Located on CP VolID 0191 NOV191 CMS startup and con figuration utilities 3390 5 cyl 1 019F NOV19F Starter System installa tion and recovery tools for new servers 3390 50 cyl 6 0150 n a Unix Starter System Boot and User Data 3390 3283 cyl 57 0151 n a Unix Starter System RPM Reposi tory 3390 3338 cyl 1 Temporary Minidisk Work Area 6 I...

Page 17: ...o IP Address Netmask Def Gateway DNS Server Downloaded Components All of the following files can be obtained from http download novell com Download buildid M5V5 w8h2M0 Any references in the worksheets to file names or locations should refer to this location e g prepend this URL path to the name of the listed file to download that file Documentation Downloads Table 4 Documentation File Checklist Fi...

Page 18: ...ds Table 6 CMS Utility Download Checklist File Name Location VMAEXEC EXEC vmaexec exec CMSDEXEC EXEC cmsdexec exec Disk Image Downloads Table 7 Disk Image Download Checklist File Name Location NOV191 VMARC nov191 vmarc NOV150 VMARC nov150 vmarc NOV151 VMARC nov151 vmarc NOV19F VMARC nov19f vmarc 8 Installing the SUSE Linux Enterprise Server Starter System for System z ...

Page 19: ...Installing the SUSE Linux Enterprise Server Starter System for System z Installing the SUSE Linux Enterprise Server Starter System for System z 9 ...

Page 20: ...disk sizing The real entries will be added in a later step Elevated CP Privileges Are Not Required The starter system virtual machine does not require any privileges beyond the normal class G privileges available to an ordinary z VM user You should not grant the starter system virtual machine any additional privileges unless you fully understand the results and risks associated 2 Add the minidisks...

Page 21: ... settings in the z VM SYSTEM CONFIG file to permit creation of VDISKs Consult the z VM documentation in Appendix C IBM References on page 40 for more information on updating SYSTEM CONFIG Performing the Installation 1 Ensure that the NOVSTART userid is not logged on to z VM 2 Log into any other z VM userid via a tn3270 session 3 Link the NOVSTART minidisks by typing LINK NOVSTART 191 F191 MR LINK ...

Page 22: ...ARY mode to ensure that the files are not modified in transit Use the planning and installation worksheet as a checklist for the process of uploading the files to z VM The files can also be transferred using magnetic tape if a tape drive is available Use BINARY Mode When Transferring with FTP If you use FTP to transfer the files the files must be transferred using BINARY mode Using the default ASC...

Page 23: ...cepted ftp You put vmaexec exec vmaexec exec System transfer messages ftp You put cmsdexec exec cmsdexec exec System transfer messages ftp You put nov191 vmarc nov191 vmarc System transfer messages ftp You put nov19f vmarc nov19f vmarc System transfer messages ftp You quit System 221 Quit command received Goodbye c Figure 5 Sample FTP Session from a Workstation to z VM 7 Relink the NOVSTART F00 mi...

Page 24: ...MG file to NOVSTART 191 type CMSDDR RESTORE F191 NOV191 DISKIMG A Figure 9 Restoring NOV191 DISKIMG to NOVSTART 191 14 Erase NOV191 DISKIMG and NOV191 VMARC ERASE NOV191 DISKIMG A ERASE NOV191 VMARC A Figure 10 Erasing NOV191 Image and Distribution Archives 15 Unpack NOV19F VMARC To unpack NOV19F VMARC type VMARC UNPACK NOV19F VMARC A A Figure 11 Unpacking NOV19F VMARC The resulting file NOV19F DI...

Page 25: ...chives 19 Format NOVSTART 150 To format NOVSTART 150 type You FORMAT F150 G System DMSFOR0603R FORMAT will erase all files on disk G F150 Do you wish to continue Enter 1 YES or 0 NO You 1 System DMSFOR605R Enter disk label You NOV150 System DMSFOR733I Formatting disk G Ready T 0 02 0 18 15 50 35 Figure 15 Formatting NOVSTART 150 20 Release read write access to NOVSTART 150 RELEASE G DETACH Figure ...

Page 26: ...You binary System 200 Representation type is IMAGE ftp You site fix 80 System 200 Site command was accepted ftp You put nov151 vmarc nov151 vmarc System transfer messages ftp You quit System 221 Quit command received Goodbye c Figure 17 Sample FTP Session from a Workstation to z VM NOVSTART 151 22 Relink NOVSTART 150 to your VM userid LINK NOVSTART 150 F150 MR Figure 18 Re linking NOVSTART 150 On ...

Page 27: ...RESTORE F151 NOV151 DISKIMG A Figure 21 Restoring NOV151 DISKIMG to NOVSTART 151 26 Erase NOV151 DISKIMG and NOV151 VMARC ERASE NOV151 DISKIMG A ERASE NOV151 VMARC G Figure 22 Erasing NOV151 Image and Distribution Archives 27 Release read write access to NOVSTART F00 RELEASE A DETACH Figure 23 Release R W Access to NOVSTART F00 28 Transfer NOV150 VMARC to NOVSTART F00 Installing the SUSE Linux Ent...

Page 28: ...F00 ftp You binary System 200 Representation type is IMAGE ftp You site fix 80 System 200 Site command was accepted ftp You put nov150 vmarc nov150 vmarc System transfer messages ftp You quit System 221 Quit command received Goodbye c Figure 24 Sample FTP Session from a Workstation to z VM NOVSTART 150 29 Relink NOVSTART F00 to your VM userid LINK NOVSTART F00 F000 MR Figure 25 Re linking NOVSTART...

Page 29: ...150 DISKIMG J ERASE NOV150 VMARC J Figure 29 Erasing NOV151 Image and Distribution Archives 34 Release and detach the temporary work disk by typing RELEASE J DETACH NOVSTART F00 may now be deallocated and returned to the system for reuse You have completed the installation of the starter system code Remain logged into the second VM userid and refer to section Configuring the SUSE Linux Enterprise ...

Page 30: ...20 Installing the SUSE Linux Enterprise Server Starter System for System z ...

Page 31: ...Configuring the SUSE Linux Enterprise Server Starter System for System z Configuring the SUSE Linux Enterprise Server Starter System for System z 21 ...

Page 32: ...arter System The starter system uses a simplified form of network configuration based on a CMS file The starter system reads this file when the system is initialized and uses it to COUPLE the network adapter to the correct VSWITCH or guest LAN and provide network parame ters to the Linux IP stack To configure network connectivity for the starter system virtual machine perform these steps 1 Access ...

Page 33: ...lified host name LAYER2 indicates whether the VSWITCH is in layer 2 or layer 3 mode If you are using a guest LAN LAYER2 should always be N DHCP indicates whether the guest should attempt to use DHCP to obtain network information Requires LAYER2 Y and a layer 2 VSWITCH to work IPADDR 10 0 0 2 NETMASK 255 255 255 0 GATEWAY 10 0 0 1 NAMESERVER 10 0 0 23 FQDN novstart example com LAYER2 N DHCP N Figur...

Page 34: ...19F Figure 33 Detaching All NOVSTART Minidisks Configuration is now complete Starting NOVSTART for the First Time From OPERATOR or another privileged userid type AUTOLOG NOVSTART After a minute or so you should be able to ping the IP address of your server from another workstation or the z VM TCPIP stack ping novstart example com Ping Level 520 Pinging host NOVSTART EXAMPLE COM 10 0 0 2 Enter CP E...

Page 35: ...To disable receipt of any mail from outside the starter system you can disable the Postfix daemon using the following commands while logged in as root on the starter system To disable the Postfix installation type cd etc postfix cp main cf main cf save sed 667d main cf main cf new cp main cf new main cf service postfix restart cd Figure 35 Disabling the Postfix MTA Disabling Automatic Filesystem C...

Page 36: ...OVSTART by typing XAUTOLOG NOVSTART from a privileged userid such as MAINT or OPERATOR The starter system will update its network parameters as part of the restart If the NETWORK PARMS file does not exist or is unreadable for some reason the IPL process for NOVSTART will pause and allow entry of network parameters at the virtual machine console Note that while YaST is available on this system it i...

Page 37: ...Installing a New Linux Guest from the Starter System Installing a New Linux Guest from the Starter System 27 ...

Page 38: ...s using the starter system as a source CP Directory Entry Notes When creating a new virtual server the CLIENT SAMPDIR file on NOVSTART 19F can be used as a template CP directory entry CLIENT SAMPDIR defines a basic set of virtual machine options and devices and can be used as a basic convention for installing all your virtual servers The CLIENT SAMPDIR file supplied with the starter system is show...

Page 39: ...ection to a guest LAN in the CP directory entry if you so desire NICDEF 0340 TYPE QDIO LAN SYSTEM GLAN1 These statements show examples of minidisk definitions for the new virtual machine The last token on each line is the CP label of the DASD that will contain the minidisk These should be allocated using your local CP directory management process MDISK 0191 3390 0001 0005 USER03 MDISK 0150 3390 00...

Page 40: ...ap space These tools should be available to all Linux guests installed from the starter system Starting the Install Process To start the install follow these steps 1 Create a new z VM userid based on CLIENT SAMPDIR as described above 2 Log in as the new z VM userid via tn3270 3 Format the minidisk at virtual address 0191 by typing FORMAT 191 A The label of the minidisk is not important 4 Access NO...

Page 41: ...The starter system provides NFS FTP SMB and HTTP based installation support When prompted for the address of the installation source supply the IP address of the starter system virtual machine You may choose any of the supported installation methods all work equally well over the internal network provided by a guest LAN or VSWITCH Each installation method will require some additional information a...

Page 42: ...w much reduction is possible will be dictated by the applications and features you have installed Smaller virtual machines typically help overall system performance by imposing a smaller memory footprint for z VM to manage You can add additional software to your installed virtual machine using YaST and the starter system as a installation source 32 Installing the SUSE Linux Enterprise Server Start...

Page 43: ...If You Have Problems If You Have Problems 33 ...

Page 44: ...PL This error is normally caused by specifying a VSWITCH or guest LAN in PROFILE EXEC or in the CP directory entry that does not exist or to which you do not have permission to connect To solve this problem 1 Verify that you have spelled the VSWITCH or guest LAN name correctly in NETWORK PARMS on NOVSTART 191 2 Grant the guest permission to COUPLE to the guest LAN or VSWITCH using the SET LAN or S...

Page 45: ...The problem results from CMS not permitting multiple virtual machines to have a write link to the same minidisk at the same time and thus to cause data corruption The VM FTP server runs in a different virtual machine and thus triggers this problem if the NOVSTART userid is logged on or if you have the desired disk linked read write from another userid To solve this problem exit the FTP client and ...

Page 46: ... TO START and repeating the failing step A short description of the problem Explain what you are doing and what you expected the outcome to be How you want to be contacted Where to Report A Problem Report your problem to the Novell Customer Center as described in the Novell Customer Center Users Guide You can obtain a copy of the guide online Consult the references provided in Appendix D SUSE Linu...

Page 47: ...Appendices Appendices 37 ...

Page 48: ...The sample CP directory entry for the starter system in ASCII NOV191 VMARC The sample PROFILE EXEC PROFILE XEDIT and NETWORK PARMS for the starter system NOV150 VMARC The bootable Linux image providing the installation functions and basic software for the FTP HTTP SMB and NFS servers NOV151 VMARC The SLES 10 SP1 RPM repository NOV19F VMARC IPLable kernel data the sample virtual server CP directory...

Page 49: ...the Novell Trademark and Service Mark list at www novell com company legal trademarks tmlist html Linux is a registered trademark of Linus Torvalds All other third party trademarks are the property of their respective owners A trademark symbol etc denotes a Novell trademark an asterisk denotes a third party trademark All information found in this book has been compiled with utmost attention to det...

Page 50: ...lation Refer to the z VM program directory for a short installation overview Customization z VM 5 1 CMS Primer SC24 6137 z VM 5 1 XEDIT Commands and Macros Reference SC24 6131 z VM 5 3 CP Commands and Utilities SC24 6081 z VM 5 3 CMS Commands and Utilities Reference SC24 6073 z VM 5 3 Directory Maintenance Facility Tailoring and Administration Guide SC24 6135 z VM 5 3 TCP IP Planning and Customiza...

Page 51: ... This is the main IBM WWW site for z VM information The site contains infor mation about the z VM hypervisor documentation white papers and other helpful configuration information and tips Appendix C IBM References 41 ...

Page 52: ...stem z environment Architecture Specific Information System z www novell com documentation sles10 pdfdoc sles_zseries sles_zseries pdf Architecture specific notes on System z installation and planning Installation SUSE Linux Enterprise Server for System z Installation and Administration Guide www novell com documentation sles10 sles_admin sles_admin pdf Comprehensive installation documentation inc...

Page 53: ... with this and other Novell products Online Articles and References Mailing Lists linux 390 vm marist edu The most popular electronic mailing list for discussing Linux on System z machines To subscribe to the mailing list send an email to listserv vm marist edu with the words SUBSCRIBE linux 390 your name in the BODY of the email message where your text normally goes You will begin to receive mess...

Page 54: ...Printed in USA ...