Novell LINUX ENTERPRISE SERVER STARTER SYSTEM User manual

SUSE Linux Enterprise Server Starter System
for System z
Installation Guide

SUSE Linux Enterprise Server Starter System
for System z
Installation Guide

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

ii Installing the SUSE Linux Enterprise Server Starter System for System z

Contents
Preparing to Install the SUSE Linux Enterprise Server Starter System for System z ....1
Preparing to Install the SUSE Linux Enterprise Server Starter System for System
z. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
What You Need ....................................... 2
Processor Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Networking Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Disk Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Permanent Disk Requirements ............................ 3
Temporary Disk Requirements ............................ 3
Operating System Requirements ............................... 3
Where to Get the Components .............................. 4
Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Sample Directory Entry ................................... 4
CMS Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Starter System Disk Images ................................. 5
SUSE Linux Enterprise Server Starter System for System z Planning Worksheet .6
Hardware Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Permanent Minidisks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Temporary Minidisk Work Area ............................. 6
Network Connection 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 Starter System for System z ........ 21
Configuring the SUSE Linux Enterprise Server Starter System for System z .. 22
Configuring Network Connectivity to the Starter System ................ 22
Starting NOVSTART for the First Time ......................... 24
Other NOVSTART Maintenance Tasks .......................... 25
Changing NOVSTART Root Password ........................ 25
Disabling the Postfix MTA ............................... 25
Disabling Automatic Filesystem Checking for the Repository ............ 25
Recovering from a Damaged or Misconfigured Network Configuration ...... 26
Contents iii

Installing a New Linux Guest from the Starter System ........................ 27
Installing a New Guest from the Starter System ................... 28
CP Directory Entry Notes ................................. 28
Starting the Install Process ................................. 30
Specifying the Install Server Address and Install Method ................ 31
Additional Information About the Install Process .................... 32
If You Have Problems .............................................. 33
Common Problems and Solutions ............................ 34
DDR reports CMS as a invalid operand. ......................... 34
The COUPLE command reports an error in the PROFILE EXEC on IPL ....... 34
The temporary disk is too small to hold the starter system files. ............ 35
The 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. IBM References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
z/VM Books and Information ............................... 40
Online Articles and References ............................ 40
Appendix D. SUSE Linux Enterprise Server References .............. 42
SUSE Linux Enterprise Server for System z Books and Information ......... 42
Online Articles and References .............................. 43
iv Installing the SUSE Linux Enterprise Server Starter System for System z

Figures
1. Disk Image Files ................................... 5
2. Example MDISK Entries with Passwords ..................... 11
3. Linking the NOVSTART Minidisks On Another Userid ............ 11
4. Formatting NOVSTART F00 For Use ...................... 12
5. Sample FTP Session from a Workstation to z/VM ................ 13
6. Unpacking VMARC MODULE .......................... 14
7. Unpacking CMSDDR ............................... 14
8. Unpacking NOV191 VMARC ........................... 14
9. Restoring NOV191 DISKIMG to NOVSTART 191 ............... 14
10. Erasing NOV191 Image and Distribution Archives ............... 14
11. Unpacking NOV19F VMARC ........................... 14
12. Restoring NOV19F DISKIMG to NOVSTART 19F ............... 15
13. Erasing NOV19F Image and Distribution Archives ............... 15
14. Erasing Tools Distribution Archives ....................... 15
15. Formatting NOVSTART 150 ........................... 15
16. Release R/W Access to NOVSTART 150 .................... 15
17. Sample FTP Session from a Workstation to z/VM (NOVSTART 151) .... 16
18. Re-linking NOVSTART 150 On Another Userid ................ 16
19. Access NOVSTART Minidisks .......................... 16
20. Unpacking NOV151 VMARC ........................... 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 Distribution Archives ............... 19
30. Linking the NOVSTART Minidisks On Another Userid ............ 22
31. Sample NETWORK PARMS File ......................... 23
32. Updating PROFILE EXEC on NOVSTART 191 ................. 24
33. Detaching All NOVSTART Minidisks ...................... 24
34. Pinging the NOVSTART Starter System From z/VM .............. 24
35. Disabling the Postfix MTA ............................ 25
36. Disabling Automatic Checking for Repository Filesystems ........... 25
37. Resetting Network Configuration for the Starter System ............ 26
38. Sample CLIENT SAMPDIR ............................ 29
39. Example of SET LAN for the NOVSTART User ................ 34
40. Example of SET VSWITCH for the NOVSTART User ............. 34
41. Attempting to Transfer Files with FTP to an Accessed Minidisk ........ 35
Figures v

Tables
1. Permanent Minidisk Requirements Worksheet ................... 6
2. Temporary Minidisk Requirements Worksheet ................... 7
3. Network Requirements Worksheet ......................... 7
4. Documentation 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

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

Preparing to Install the SUSE Linux Enterprise Server
Starter System for System z
The SUSE Linux Enterprise Server Starter System for System z is a pre-built installation
server for SUSE Linux Enterprise Server for System z that can be installed on your z/VM
system using CMS tools, eliminating the need for coordinating access to a separate Linux
or Unix system elsewhere on your network and minimizing the impact of network-based
installation on your internal and external networks.
The starter system includes:
Utilities and configuration tools for quick installation of the starter system from a
CMS terminal session
Compressed disk images of the starter system, including a complete set of RPM
packages as shipped with the SUSE Linux Enterprise Server for System z release.
Utilities and configuration tools to assist with installation of additional Linux virtual
machines from the starter system installation server. The configuration tools package
also includes a "rescue" system that can be used to recover a SUSE Linux Enterprise
Server for System z virtual machine if there are problems that 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 customized for use as an installation server
for other SUSE Linux Enterprise Server for System z based Linux servers running in
virtual machines. The starter system is NOT suitable for general use and you should
not attempt to use it for any other purpose.
What You Need
To install the starter system, you will need to ensure you have sufficient resources avail-
able on your system to complete the installation and obtain two CMS tools and the starter
system disk images from the Internet.
Processor Requirements
The SUSE Linux Enterprise Server Starter System for System z and all SUSE Linux
Enterprise Server for System z Linux virtual machines require a z/Architecture-capable
processor to operate. 31-bit processors such as any model of the 9672 and ESA/390 archi-
tecture processors are not supported, and will not function.
2Installing the SUSE Linux Enterprise Server Starter System for System z

Networking Requirements
The starter system requires access to a VSWITCH defined on the z/VM system and one
virtual NIC interface attached to that VSWITCH either in the CP directory entry for the
virtual machine or via the CP COUPLE command. A guest LAN connection may also be
used, however the VSWITCH is more flexible and is considered better practice for the
future.
The starter system will require one unique IP address on the network connected to the
VSWITCH, along with correct network mask, default gateway, and DNS server parame-
ters for that network. You should obtain this information from your local network admin-
istrator and record it on the network planning worksheet in section “Network Connection
Information” on page 7.
Disk Requirements
Permanent Disk Requirements
The SUSE Linux Enterprise Server Starter System for System z requires permanent
access to two full 3390 model 3 disk packs to 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
During the installation process, the starter system installation will require an additional
3390 model 3 disk pack or an equivalent amount of space for use in storing disk images
before installation.
Following installation of the starter system, this temporary space may be released for
other uses.
Operating System Requirements
The starter system is designed to work with z/VM release 5.1 and higher. z/VM must be
installed before you begin the installation of the starter system. Refer to the IBM refer-
ence works listed in Appendix C, “IBM References” on page 40 for additional informa-
tion on installing and configuring z/VM.
Preparing to Install the SUSE Linux Enterprise Server Starter System for System z 3

Where to Get the Components
Once you have verified that your system can physically support the starter system
requirements,you need to acquire the pieces of the starter system and the disk images.
The following sections describe where to obtain each piece.
Obtain All Pieces Before Beginning Installation
Complete the planning worksheet and download all the components before you begin
installing the starter system. Having all the parts at the beginning of installation
avoids problems or missing data in the installation process.
All of the following files can be obtained from:
http://download.novell.com/Download?buildid=M5V5-w8h2M0-
Any references in the following sections 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
The documentation (including this file) can be obtained from the download location noted
above. Text and PDF versions of the 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
hosts. It can be used to preview what will need to be done before uploading the files
to the VM system.
CMS Utilities
The CMS utilities required provide the ability to compress and manage disk images. Both
utilities shown below are available from the download location noted above.
VMARC The VMARC file archive utility for CMS, which allows decompressing the
disk image files before restoring.
CMSDDR A modified version of the CMS DDR command which supports reading and
writing disk image data to and from CMS files.
The most current versions of these tools are also included inside the starter system disk
images, and may be newer than the ones available from the Novell web site.
4Installing the SUSE Linux Enterprise Server Starter System for System z

Starter System Disk 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

SUSE Linux Enterprise Server Starter System for
System z Planning Worksheet
Use the following worksheets to record important parameters for the starter system install
process.
Hardware Prerequisites
Permanent Minidisks
Table 1. Permanent Minidisk Requirements Worksheet
Virtual
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
6Installing the SUSE Linux Enterprise Server Starter System for System z

Table 2. Temporary Minidisk Requirements Worksheet
Virtual
Address Mini- disk
Label
Desc Device
Type Size Starting Cyl Located on CP
VolID
F000 NOVTMP Tempo-
rary disk
for
installa-
tion
work
area
3390 3338 cyl 1
Network Connection Information
Table 3. Network Requirements Worksheet
Attribute Adapter 1
Virtual Address 0340
VSWITCH Name
DHCP? No
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
File Name Location
S10SP1 TXT s10sp1.txt
S10SP1 PDFBIN s10sp1.pdf
SUSE Linux Enterprise Server Starter System for System z Planning Worksheet 7

Sample CP Directory Entry
Table 5. Sample Directory Entry Checklist
File Name Location
NOVSTART SAMPDIR novstart.sampdir
NOVSTART SAMPASC novstart.sampasc
Utility Downloads
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
8Installing the SUSE Linux Enterprise Server Starter System for System z

Installing the SUSE Linux Enterprise Server Starter
System for System z
Installing the SUSE Linux Enterprise Server Starter System for System z 9

Installing the SUSE Linux Enterprise Server Starter
System for System z
This section describes a step by step installation of the SUSE Linux Enterprise Server
Starter System for System z.
Be Sure to Read the Procedure Completely Before Beginning
To make sure you understand the process and steps, read the entire procedure through
at least one time from start to finish and ensure that you have completed the planning
worksheets and have all the materials ready before beginning to install the starter
system.
For illustration purposes, the installation procedure assumes you will use VM userid
NOVSTART for the starter system as shown in the sample CP directory entry file. Any
userid may be used, however you will need to modify this procedure according to your
local conventions.
Preparing the Virtual Machine
1. Create the virtual machine NOVSTART using your local CP directory maintenance
procedures. Note that the MDISK entries in the sample directory entry are com-
mented out, and should be used for guidance and 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 specified in the worksheet using your local directory management
procedures. You can use the comments in the sample directory entry or the planning
worksheet values to estimate the amount of space needed.
If using 3390 model 3 volumes, approximately two full volumes will be required. If
using 3390 model 9 or 27 volumes, only a fraction of one volume will be required,
however there will be a performance impact if all the minidisks are located on the
same volume.
If you are not using an external security manager such as RACF on your z/VM
system, ensure that you add minidisk passwords to the minidisks. The 19F minidisk
will need public access, and should be assigned a read password of ALL. Example
MDISK entries might appear similar to these:
10 Installing the SUSE Linux Enterprise Server Starter System for System z