V6.

cover

Front cover

AIX Basics
(Course code AN10)

Lab Setup Guide for

Classroom Delivery
ERC 2.0

Lab Setup Guide for Classroom Delivery

Trademarks
The reader should recognize that the following terms, which appear in the content of this
training document, are official trademarks of IBM or other companies:
IBM is a registered trademark of International Business Machines Corporation.
The following are trademarks of International Business Machines Corporation in the United
States, or other countries, or both:
AIX 5L
AS/400
POWER

AIX 6
MVS
System p

AIX
Power

Adobe is either a registered trademark or a trademark of Adobe Systems Incorporated in

the United States, and/or other countries.
Intel is a trademark or registered trademark of Intel Corporation or its subsidiaries in the
United States and other countries.
Linux is a registered trademark of Linus Torvalds in the United States, other countries, or
both.
Windows is a trademark of Microsoft Corporation in the United States, other countries, or
both.
UNIX is a registered trademark of The Open Group in the United States and other
countries.
Java and all Java-based trademarks and logos are trademarks or registered trademarks of
Oracle and/or its affiliates.
Other product and service names might be trademarks of IBM or other companies.

August 2011 edition

The information contained in this document has not been submitted to any formal IBM test and is distributed on an as is basis without
any warranty either express or implied. The use of this information or the implementation of any of these techniques is a customer
responsibility and depends on the customers ability to evaluate and integrate them into the customers operational environment. While
each item may have been reviewed by IBM for accuracy in a specific situation, there is no guarantee that the same or similar results will
result elsewhere. Customers attempting to adapt these techniques to their own environments do so at their own risk.

Copyright International Business Machines Corporation 2010, 2011.

This document may not be reproduced in whole or in part without the prior written permission of IBM.
Note to U.S. Government Users Documentation related to restricted rights Use, duplication or disclosure is subject to restrictions
set forth in GSA ADP Schedule Contract with IBM Corp.

V6.0
Lab Setup Guide for Classroom Delivery

TOC

Contents
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Hardware requirements for a full class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Hardware required whatever the number of students: . . . . . . . . . . . . . . . . . . . . . . . . . 1
Hardware requirements for one team lab set (2 students) . . . . . . . . . . . . . . . . . . . . . . 2
Setup instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Configuration information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Software requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
AIX installation instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
AIX configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Verification procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Course image information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Image information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Copyright IBM Corp. 2010, 2011

Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.

Contents

iii

Lab Setup Guide

iv

AIX Basics

Copyright IBM Corp. 2010, 2011

Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.

V6.0
Lab Setup Guide for Classroom Delivery

TMK

Trademarks
The reader should recognize that the following terms, which appear in the content of this
training document, are official trademarks of IBM or other companies:
IBM is a registered trademark of International Business Machines Corporation.
The following are trademarks of International Business Machines Corporation in the United
States, or other countries, or both:
AIX 5L
AS/400
POWER

AIX 6
MVS
System p

AIX
Power

Adobe is either a registered trademark or a trademark of Adobe Systems Incorporated in

the United States, and/or other countries.
Intel is a trademark or registered trademark of Intel Corporation or its subsidiaries in the
United States and other countries.
Linux is a registered trademark of Linus Torvalds in the United States, other countries, or
both.
Windows is a trademark of Microsoft Corporation in the United States, other countries, or
both.
UNIX is a registered trademark of The Open Group in the United States and other
countries.
Java and all Java-based trademarks and logos are trademarks or registered trademarks of
Oracle and/or its affiliates.
Other product and service names might be trademarks of IBM or other companies.

Copyright IBM Corp. 2010, 2011

Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.

Trademarks

Lab Setup Guide for Classroom Delivery

vi

AIX Basics

Copyright IBM Corp. 2010, 2011

Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.

V6.0
Lab Setup Guide for Classroom Delivery

LSGp

Purpose
This Lab Set Up Guide provides directions for installing, preparing, and verifying the lab
hardware and software in preparation for conducting a class of course AN10.
The Requirements sections of this document can also be used to determine the specific
hardware and software needed to conduct a class.

Copyright IBM Corp. 2010, 2011

Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.

Purpose

vii

Lab Setup Guide for Classroom Delivery

viii

AIX Basics

Copyright IBM Corp. 2010, 2011

Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.

V6.0
Lab Setup Guide for Classroom Delivery

LSG

Requirements
The following tables list the hardware, software, and other materials needed to set up a lab
to conduct a class of course AN10.

Hardware requirements for a full class

Table 1 lists the number of machines, HMCs, and the resources required to conduct the
class for the course class size (8 students)
Table 1: Power System(s) and HMCs for a full class of 8 students
Number of Number of
System
HMC level Number of
Features
machines Teams per Firmware
HMCs
machine
level
1

Physical
Ethernet
Adapters

Physical
Fiber
Channel
Adapters
1

AL710_099 7.7.2 SP0

or late r
or later
Memory
CPUs

2G

1
HEA MCS
value
(always 1?)

HEA
logical
ports

External
Storage
size

N/A

N/A

N/A

Hardware required whatever the number of students:

Table 2: Hardware for running the class whatever number of student.
VIO or Logical
Memory
#VP
CE
Physical
Fiber
AIX LPAR partition Min/Des/Max Min/Des/Max Min/Des/Max Ethernet Channel
name
/Cap/Uncap Adapters Adapters
VIO
vios1 768/768/768 1/1/1/UnCap 1.0/1.0/1.0
1
1
Uncap
Table 3: Storage LUNs required for the class whatever number of students
LUN type
Shared
LUN size
(shared/
If not shared, zoned to:
Function
between:
not shared)
36 GB
not shared
N/A
vios1(physical FC)
rootvg of vios1

Copyright IBM Corp. 2010, 2011

Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.

Requirements

Lab Setup Guide for Classroom Delivery

Hardware requirements for one team lab set (2 students)

Table 4 and Table 5 list the POWER system configuration needed to prepare one team
lab set. When preparing for a class, multiply the items below by the number of lab sets
needed for the class.
Table 4: Hardware required for one Team lab set
PCIe
Fiber
CE
HEA logical
#VP
Min/Des/Max
LPARs
Memory
Ethernet Channel
Min/Des/Max
ports
Cap/Uncap
Adapters Adapters
lpar1
768/768/768 0.2/.4/.4/Uncap
1/2/2/
N/A
N/A
N/A
Table 5: Storage LUNs for one team lab set
LUN type
LUN size
(shared/
Shared between:
not shared)
8GB
not shared
N/A

AIX Basics

zoned to:

Function

vios1(physical FC)

lpar1 rootvg

Copyright IBM Corp. 2010, 2011

Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.

V6.0
Lab Setup Guide for Classroom Delivery

LSG

Setup instructions
Configuration information
The following table describes the configurations of the team lab set.
Table 6: LPARs virtual Storage Adapters configuration for one class lab set
Logical
Client LPAR name/ VIO server name /
vFC
Client VIO / FC
Partition
Virtual SCSI slot # Virtual SCSI slot # Server LPAR / adapter
name
slot
vFC slot
vios1
lpar1/33
vios1/33
N/A
N/A
N/A
Note: If the Client LPAR/slot number is not specified, then the connection will be Any.
Virtual SCSI slots are indicated for information only. The CLP team might change that slots
number to facilitate courses integration.
Table 7 lists the virtual Network Adapters configuration for one class lab set LPARs on the
managed system(s). Duplicate the table if more than one managed system.
Table 7: LPARs virtual Network Adapters configuration for one class lab set
Logical Partiton
Virtual VLAN Access
IEEE
HEA
HEA
HEA
name
Ethernet ID
External 802.1Q Physical Port
logical
slot
network
Port ID Group Port ID
vios1
11
1
Yes
No
N/A
N/A
N/A
lpar1
12
1
No
No
N/A
N/A
N/A
Note: The CLP team might change the adapter slots number and VLAN IDs to facilitate
courses integration.

Software requirements
Table 8 lists the images required for the course.
Table 8: mksysb image requirements
Software image name
Version (oslevel or ioslevel)
mk_an10_erc2_lpars_71TL0SP1
7100-00-01-xxx
mk_an10_erc2_vios_2113FP23
2.1.1.3-FP-23

lpar
lpar1
vios1

Table 9 lists the tools and software needed at the student workstation (usually a remote
facility such as citrix). When preparing for a class, be sure you have the correct number of
licensed copies of any non-IBM software.
Table 9: Software for one student lab set
Software product
Version
Firefox
latest
Putty
recent
VNC Viewer
latest

Licensing requirement

Copyright IBM Corp. 2010, 2011

Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.

Setup instructions

Lab Setup Guide for Classroom Delivery

Table 10 lists the software needed to prepare the host or server machine. Those software
are required to be in the mksysb image(s).
Table 10: Software for host machine
Licensing
Software product
Version
lpars
requirement
CDE
latest
No
lpar1
VNC server
3.3.3r2-6
No
lpar1
AIX Documentation
latest
No
lpar1

Customization scripts requirements

Table 11 lists the scripts required for customizing the mksysb image during the lab setup.
Those scripts are available in the CLP and used during image deployment. .
Table 11 : Scripts needed for the lab setup
script name
Comments
The /etc/security/mkuser.sys script needs
to be modified to create an appropriate
cs_an10_lpar.sh
xstartup file for the VNC server software
when the student userids are created.

Customization scripts code

Scripts codes detail
#!/bin/ksh
LOGFILE=/tmp/an10_lpar.log
exec 1>>$LOGFILE 2>&1
print Begin run for $* on $(date)
echo $course_code >/etc/course_code
echo "$(date '+%Y/%m/%d %H:%M:%S') : Start of customization script for
$course_code course"
echo "
# Create the .vnc directory and xstartup script within it
mkdir $1/.vnc
chown $2 $1/.vnc
chgrp $3 $1/.vnc

cat > $1/.vnc/xstartup << EOF

PATH=\$PATH:/usr/local/bin:/usr/dt/bin
xrdb \$HOME/.Xdefaults
xsetroot -solid grey
aixterm -geometry 80x24+10+10 -ls &
xclock -geometry -0+0 &
mwm &
EOF
4

AIX Basics

Copyright IBM Corp. 2010, 2011

Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.

V6.0
Lab Setup Guide for Classroom Delivery

LSG

chown $2 $1/.vnc/xstartup
chgrp $3 $1/.vnc/xstartup
chmod +x $1/.vnc/xstartup
" >> /etc/security/mkuser.sys
# The file /usr/share/man/whatis needs to be created
catman -w

Copyright IBM Corp. 2010, 2011

Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.

Setup instructions

Lab Setup Guide for Classroom Delivery

AIX installation instructions

Use the following information, in addition to the normal software installation procedures, to
set up the lab software. Once the hardware is connected, you can begin software
installation.
Instructions on installing AIX can be obtained from the AIX Installation and Migration
Guide. An online copy of the guide is available at:
http://publib.boulder.ibm.com/infocenter/aix/v7r1/index.jsp
When going through the AIX Installation Menus, verify that the AIXWindows and CDE
filesets will be installed. Ensure that the Graphics Software option is set to yes, and the
Desktop option is set to CDE.

AIX configuration tasks

__ 1. A series of normal user accounts now needs to be created, one for each student. If
the number of students is known ahead of time, you can just create enough to
satisfy the class size, plus two extra accounts. Otherwise create at least 24 user
accounts. When creating the accounts divide them evenly across both AIX systems.
Create the user accounts in the following manner:
# mkuser team01
A password will also have to be set for each user account. To set the password
for the new user type:
# passwd team01
on the command line and press Enter. You will be prompted to enter a new
password twice. Use the user name as the password.(team01/team01).
Clear the ADMCHG flag that is set on the user account when the root user
assigns the initial password for the user:
# pwdadm -c team01
Repeat the instructions until all users have been created and passwords set.

Verification procedures
Use the following information to verify the installation and configurations of the AIX
systems.
__ 1. Start up a terminal emulation application on one of the student PCs and connect to
the IP address of the AIX system.
__ 2. Login as one of the user accounts with the appropriate password.

AIX Basics

Copyright IBM Corp. 2010, 2011

Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.

V6.0
Lab Setup Guide for Classroom Delivery

LSG

__ 3. To test the VNC server, run the vncserver command from the userid. The program
will ask you to enter a password (twice) for the VNC session, then exit. Run
vncserver again, and it will start the VNC server session and display the name and
session number. (typically of the form hostname:1).
Start a VNC client from the student PC and connect to the VNC session you just set
up. The client should ask you for your password (the one you just set up), then
display a window with the AIXWindows environment in it (large aixterm and xclock).
Close the VNC client session by closing the window, then return to your terminal
emulator application, and kill the VNC server by typing vncserver -kill <sessionid>
where <sessionid> is the VNC session number. (for example, vncserver -kill :1)
Log out of the user account.
__ 4. Open a new terminal emulator window, and login as root with password ibmaix.
__ 5. Display the contents of /etc/passwd to ensure the other user IDs were created by
issuing the following command from the command line:
# more /etc/passwd
__ 6. Access online man pages.
# man tar
This should present information about the tar command if the documentation
was installed correctly.
__ 7. Log out of the root account.
__ 8. Verify Internet connectivity from the student PCs.
Open a Web browser, and connect to the AIX 7.1 Infocenter located at:
http://publib.boulder.ibm.com/infocenter/aix/v7r1/index.jsp

Copyright IBM Corp. 2010, 2011

Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.

Setup instructions

Lab Setup Guide for Classroom Delivery

AIX Basics

Copyright IBM Corp. 2010, 2011

Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.

V6.0
Lab Setup Guide for Classroom Delivery

LSG

Course image information

Complete this section if a standard course image is being created for use during delivery of
the course. Document information about the course image that will be needed by IT
support, classroom providers, and instructors to install and verify the image for a class.

Image information
Platform:

Intel [ ]
AIX [X]
AS/400 [ ]
MVS/Host [ ]

Network access:

Intranet

Network IP configuration: Static

Image login information:

Copyright IBM Corp. 2010, 2011

User ID: root

Password: ibmaix

Course image information

Course materials may not be reproduced in whole or in part

without the prior written permission of IBM.

Lab Setup Guide for Classroom Delivery

10

AIX Basics

Copyright IBM Corp. 2010, 2011

Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.

V6.0

backpg

Back page