Академический Документы
Профессиональный Документы
Культура Документы
Autotasking, Cray, Cray Channels, Cray Y-MP, GigaRing, LibSci, UNICOS and UNICOS/mk are federally registered
trademarks and Active Manager, CCI, CCMT, CF77, CF90, CFT, CFT2, CFT77, ConCurrent Maintenance Tools, COS, Cray Ada,
Cray Animation Theater, Cray APP, Cray Apprentice2, Cray C++ Compiling System, Cray C90, Cray C90D, Cray CF90, Cray EL,
Cray Fortran Compiler, Cray J90, Cray J90se, Cray J916, Cray J932, Cray MTA, Cray MTA-2, Cray MTX, Cray NQS, Cray Research,
Cray SeaStar, Cray S-MP, Cray SHMEM, Cray SSD-T90, Cray SuperCluster, Cray SV1, Cray SV1ex, Cray SX-5, Cray SX-6, Cray T3D,
Cray T3D MC, Cray T3D MCA, Cray T3D SC, Cray T3E, Cray T90, Cray T916, Cray T932, Cray UNICOS, Cray X1, Cray X1E,
Cray XD1, Cray X-MP, Cray XMS, Cray XT3, Cray Y-MP EL, Cray-1, Cray-2, Cray-3, CrayDoc, CrayLink, Cray-MP, CrayPacs,
Cray/REELlibrarian, CraySoft, CrayTutor, CRInform, CRI/TurboKiva, CSIM, CVT, Delivering the power..., Dgauss, Docview,
EMDS, HEXAR, HSX, IOS, ISP/Superlink, MPP Apprentice, ND Series Network Disk Array, Network Queuing Environment,
Network Queuing Tools, OLNET, RapidArray, RQS, SEGLDR, SMARTE, SSD, SUPERLINK, System Maintenance and
Remote Testing Environment, Trusted UNICOS, TurboKiva, UNICOS MAX, UNICOS/lc, and UNICOS/mp are trademarks of
Cray Inc.
Apache is a trademark of The Apache Software Foundation. CERT is a trademark of Carnegie Mellon University. Dell and
PowerEdge are trademarks of Dell Computer Corporation. ESS-800 is a trademark of SBS Technologies, Inc. FLEXlm is a trademark
of Macrovision Corporation. GNU is a trademark of The Free Software Foundation. Linux is a trademark of Linus Torvalds. Mac OS
is a trademark of Apple Computer, Inc. NFS, Solaris and Sun are trademarks of Sun Microsystems, Inc. in the United States and
other countries. Red Hat is a trademark of Red Hat, Inc. UNIX is a trademark of The Open Group. All other trademarks are the
property of their respective owners.
The UNICOS, UNICOS/mk, and UNICOS/mp operating systems are derived from UNIX System V. These operating systems
are also based in part on the Fourth Berkeley Software Distribution (BSD) under license from The Regents of the University
of California.
Record of Revision
Version Description
S–2366–16 i
Contents
Page
Preface ix
Accessing Product Documentation . . . . . . . . . . . . . . . . . . . ix
Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . x
Reader Comments . . . . . . . . . . . . . . . . . . . . . . . . xi
Introduction [1] 1
Emphasis for the CNS 1.6 Release . . . . . . . . . . . . . . . . . . . 1
Description of the CNS . . . . . . . . . . . . . . . . . . . . . . . 2
Limitations [4] 11
cns_gen_config Command Does Not Configure Static Routes . . . . . . . . . . 11
cns_config restore Sometimes Does Not Work Properly . . . . . . . . . . . 11
PCI Slot Ethernet Card Naming Convention . . . . . . . . . . . . . . . . 11
S–2366–16 iii
Cray Network Subsystem (CNS) Software Installation and Administration
Page
Documentation [5] 15
CrayDoc Documentation Delivery System . . . . . . . . . . . . . . . . . 15
Accessing Product Documentation . . . . . . . . . . . . . . . . . . . 15
Books Provided with This Release . . . . . . . . . . . . . . . . . . . 16
Related Documentation Not Provided with This Release . . . . . . . . . . . . . 16
Ordering Documentation . . . . . . . . . . . . . . . . . . . . . . 17
iv S–2366–16
Contents
Page
S–2366–16 v
Cray Network Subsystem (CNS) Software Installation and Administration
Page
vi S–2366–16
Contents
Page
Index 109
Figures
Figure 1. CNS Function . . . . . . . . . . . . . . . . . . . . . . 2
Figure 2. CNS Network Configuration Worksheet . . . . . . . . . . . . . . 30
S–2366–16 vii
Cray Network Subsystem (CNS) Software Installation and Administration
Page
Tables
Table 1. CNS Terminology . . . . . . . . . . . . . . . . . . . . . 3
Table 2. Books Provided with This Release . . . . . . . . . . . . . . . . 16
Table 3. Legend for CNS Network Configuration . . . . . . . . . . . . . . 31
viii S–2366–16
Preface
Third-party documentation
Access third-party documentation not provided through
CrayDoc according to the information provided with the
product.
S–2366–16 ix
Cray Network Subsystem (CNS) Software Installation and Administration
Conventions
These conventions are used throughout Cray documentation:
Convention Meaning
command This fixed-space font denotes literal items, such as file
names, pathnames, man page names, command names, and
programming language elements.
variable Italic typeface indicates an element that you will replace with a
specific value. For instance, you may replace filename with the
name datafile in your program. It also denotes a word or
concept being defined.
user input This bold, fixed-space font denotes literal items that the user
enters in interactive sessions. Output is shown in nonbold,
fixed-space font.
[] Brackets enclose optional portions of a syntax representation for
a command, library routine, system call, and so on.
... Ellipses indicate that a preceding element can be repeated.
name(N) Denotes man pages that provide system and programming
reference information. Each man page is referred to by its name
followed by a section number in parentheses.
Enter:
% man man
x S–2366–16
Preface
Reader Comments
Contact us with any comments that will help us to improve the accuracy and
usability of this document. Be sure to include the title and number of the
document with your comments. We value your comments and will respond to
them promptly. Contact us in any of the following ways:
E-mail:
docs@cray.com
Telephone (inside U.S., Canada):
1–800–950–2729 (Cray Customer Support Center)
Telephone (outside U.S., Canada):
+1–715–726–4993 (Cray Customer Support Center)
Mail:
Software Publications
Cray Inc.
1340 Mendota Heights Road
Mendota Heights, MN 55120–1128
USA
S–2366–16 xi
Introduction [1]
S–2366–16 1
Cray Network Subsystem (CNS) Software Installation and Administration
Cray mainframe
Communicates with Cray mainframe
using a larger packet size or
maximum transmission unit (MTU)
over Fibre Channel or HIPPI
CNS
Communicates on behalf of the Cray
mainframe to other hosts using a
smaller network packet size or MTU
Site
network
host host
1 2
2 S–2366–16
Introduction [1]
For more detail about CNS functions, see Chapter 9, page 45.
CNS Terminology: Table 1 shows the terminology used to describe the CNS.
S–2366–16 3
Cray Network Subsystem (CNS) Software Installation and Administration
4 S–2366–16
Software Enhancements [2]
The following software enhancements have been made since the last release of
this CNS software.
Note: Documentation changes since the last release of this software are
described in Chapter 5, page 15.
2.1 Upgraded CNS Kernel to the Linux 2.4.21-32.0.1.EL kernel distributed by Red Hat
The CNS kernel has been upgraded to Red Hat kernel version 2.4.21-32.0.1.EL.
This kernel version contains the latest security updates for the Red Hat Enterprise
3.0 release.
S–2366–16 5
Cray Network Subsystem (CNS) Software Installation and Administration
6 S–2366–16
Compatibilities and Differences [3]
3.2 Changes to iptables Affect DNS and NTP Servers for the CNS
Changes made to iptables prevent any connection to the CNS other than from
the Private Ethernet. Connections from site networks are forwarded to the Cray
mainframe; no other connections are allowed to the CNS from any other network.
The implication for sites using an external Domain Name System (DNS) and
Network Time Protocol (NTP) server for the CNS is that DNS and NTP will not
work if you try to configure them to access the site network instead of the CWS;
only gated can send a packet directly to the CNS. Sites using ntpd and DNS
services from a system on an external network will have to make appropriate
adjustments to their /etc/resolv.conf and /etc/ntp.conf files after
upgrading to the CNS 1.3 release or later.
S–2366–16 7
Cray Network Subsystem (CNS) Software Installation and Administration
system, which was used on the Cray L7R. This improves the administrative
flexibility and independence of the CNS.
• The CNS is based on Dell x86 servers rather than the Alpha based hardware
used with the Cray L7R.
• For the CNS, the internal daemon names and administrative details have
been changed to make them more reflective of their actual functions and
purposes. More scripts and standard Linux mechanisms have been adopted
for maintenance and control.
3.6 tip command change for Dell PowerEdge 1650 and Dell PowerEdge 2650
The command to connect to the serial console on the CNS that use the Dell
PowerEdge 2650 and Dell PowerEdge 1650 has changed. The command is now
tip -57600 /dev/ttya or tip -57600 /dev/ttyb.
8 S–2366–16
Compatibilities and Differences [3]
S–2366–16 9
Cray Network Subsystem (CNS) Software Installation and Administration
10 S–2366–16
Limitations [4]
This chapter describes significant limitations with this CNS software release.
To ensure correct configuration, you must always run the following two
commands after running the cns_config restore command:
cns0# cns_gen_config
(answer the questions posed and use defaults as appropriate)
cns0# cns_config install
S–2366–16 11
Cray Network Subsystem (CNS) Software Installation and Administration
The CNS software attempts to ensure that the network interface names are
predictable. However, the interfaces on PCI cards are determined by the order in
which they are discovered by the Linux operating system.
If the number of Gigabit Ethernet interfaces is changed or the PCI cards are
moved to different PCI slots, the interfaces do not necessarily retain the same
interface names. This is important to remember when adding or removing
network interface cards.
The two built-in Gigabit Ethernet interfaces on the motherboard are always
named eth0 and eth1 (Section A.1, page 99 and Section A.2, page 101).
For example, the PCI slots of the Dell 2650 CNS platform are numbered 1, 2, and
3, respectively. Slot 1 is closest to the bottom of the CNS and slot 3 is closet to the
top of the CNS. If Gigabit Ethernet network interface cards are installed in the
slots, they will be named in this same order.
If the first Gigabit Ethernet interface is added to slot 2, it will be the first interface
found and will be named eth2. If only a single Gigabit Ethernet interface is
installed in slot 2, that interface will be named eth2. If another Gigabit Ethernet
interface is then added to slot 1, the Linux operating system determines that the
interface in slot 1 is named eth2, and the interface in slot 2 is named eth3.
12 S–2366–16
Limitations [4]
available about the specific network application, protocol options, and packet
traces (tcpdump or equivalent) to facilitate analysis of the problem.
2. The tcp_assistd daemon performs an active proxy function and handles
the setup and tear-down of the incoming and outgoing connections to the
Cray X1 series system. As a result, port scans of the Cray X1 series system
from the site network, or of the site network from the Cray X1 series system,
will appear as if all of the ports are open even though they are not usable.
Ports appearing to be open might be a concern to sites that depend on port
scans to ensure security.
Workaround:
If you do not need the improved performance of TCP/IP provided by the
TCP-assist function, the system administrator can remove both of these
limitations by disabling the tcp_assistd daemon. However, this changes the
CNS into a simple router, which can severely degrade TCP/IP performance.
See Section 11.6, page 98 for information about disabling the tcp_assistd
daemon.
S–2366–16 13
Cray Network Subsystem (CNS) Software Installation and Administration
CNS is then booted with the CD supplied for an upgrade, the upgrade scripts
sometimes report that the hard disk needs to be reformatted when in fact it does
not. This occurs because fsck operation fail to run on the partitions before
mounting them.
Workaround:
The workaround for this problem is to reboot the CNS from the hard disk, and
shut it down cleanly (that is, a normal shutdown) before rebooting from the CD.
14 S–2366–16
Documentation [5]
This chapter describes the documentation that supports the CNS 1.6 release.
Man pages Access man pages by entering the man command followed by the
name of the man page. For more information about man pages,
see the man(1) man page by entering:
% man man
Third-party documentation
Access third-party documentation not provided through
CrayDoc according to the information provided with the
product.
S–2366–16 15
Cray Network Subsystem (CNS) Software Installation and Administration
Mail:
Software Distribution Center
Cray Inc.
1340 Mendota Heights Road
Mendota Heights, MN 55120–1128
USA
S–2366–16 17
Cray Network Subsystem (CNS) Software Installation and Administration
18 S–2366–16
CNS Release Package [6]
This chapter contains the following information about the CNS 1.6 release:
• Hardware and software requirements
• Contents of the release package
• Licensing
• Ordering software
S–2366–16 19
Cray Network Subsystem (CNS) Software Installation and Administration
20 S–2366–16
CNS Release Package [6]
6.3 Licensing
The CNS is covered under a software license agreement for Cray software.
Upgrades to this product are provided only when a software support agreement
for this Cray software is in place.
S–2366–16 21
Cray Network Subsystem (CNS) Software Installation and Administration
CNS licensing depends on the type of mainframe system used with your CNS:
Cray X1 series systems
A CNS is required for all Cray X1 series systems. Thus,
contractual rights to receive CNS software are included in the
UNICOS/mp license agreement for Cray X1 series systems.
To receive upgrades to your CNS software, you must have your
UNICOS/mp license and a signed support agreement for the
UNICOS/mp software.
Cray GigaRing systems
Cray supports the CNS for use with Cray GigaRing systems
through a HIPPI interface. The CNS software for Cray GigaRing
systems is covered by a separate CNS software license, which is
not dependent on the license for the operating system of your
Cray GigaRing system.
Cray ships the CNS for Cray GigaRing systems with the CNS
software already installed. This software includes a license
agreement that need not be signed by customers; customers are
bound by the license terms and conditions by virtue of using the
software product or any documentation.
To receive upgrades to your CNS software for a CNS used with
a Cray GigaRing system, you must also have a signed support
agreement for your CNS.
This product does not require FLEXlm licensing.
Customers outside the United States and Canada must sign a Letter of Assurance
before software can be shipped to them. For questions about whether you have
signed this agreement, or questions about which software requires this letter,
send e-mail to crayinfo@cray.com.
22 S–2366–16
CNS Release Package [6]
You can order the release package from the Cray Software Distribution Center
in any of the following ways:
E-mail:
orderdsk@cray.com
CRInform (for subscribers):
crinform.cray.com
Click on the Order Cray Software link.
Telephone (inside U.S., Canada):
1–800–284–2729 (BUG CRAY), then 605–9100
Telephone (outside U.S., Canada):
+1–651–605–9100
Fax:
+1–651–605–9001
Mail:
Software Distribution Center
Cray Inc.
1340 Mendota Heights Road
Mendota Heights, MN 55120–1128
USA
Software will be shipped by ground service or 5-day international service.
S–2366–16 23
Cray Network Subsystem (CNS) Software Installation and Administration
24 S–2366–16
Customer Services [7]
This chapter describes the customer services that support this release.
You can also create a Request for Technical Assistance (RTA) and track and
search RTAs and Software Problem Reports (SPRs) online if you are a CRInform
subscriber, as described in Section 7.2.
S–2366–16 25
Cray Network Subsystem (CNS) Software Installation and Administration
7.3 Training
To find out more about Cray training, contact your Cray representative or contact
us in any of the following ways:
E-mail:
wwwtng@cray.com
Web:
www.cray.com/training/
Fax:
+1–715–726–4991
Mail:
Technical Training
Cray Inc.
P.O. Box 6000
Chippewa Falls, WI 54729–0080
USA
26 S–2366–16
Customer Services [7]
S–2366–16 27
Cray Network Subsystem (CNS) Software Installation and Administration
28 S–2366–16
Installation and Configuration [8]
The procedures in this chapter describe what you need to do to get your Cray
Network Subsystem (CNS) running with the CNS 1.6 software. Perform only
those procedures that apply to the situation at your site:
• Preparing (Section 8.1, page 32)
• Configuring Software for a New CNS (Section 8.2, page 33)
• Upgrading Existing CNS Software (Section 8.3, page 35)
• Performing an Initial CNS Software Installation (Section 8.4, page 39)
• Reverting to the Previous CNS Configuration (Section 8.5, page 42)
• Using the Shell During a CNS Software Installation (Section 8.6, page 43)
• Supporting UNICOS/mp Installation (Section 8.7, page 43)
Note: These procedures assume that all required electrical and communication
lines are properly connected (see Appendix A, page 99 for the CNS hardware
connections).
Caution: Cray recommends that you change any default passwords supplied
! by Cray and use complex passwords for root and crayadm as soon as
possible.
For advanced and special configuration topics, refer to Chapter 10, page 59.
Use Figure 2, page 30 as a worksheet for your CNS network configuration during
the CNS software installation or upgrade process.
S–2366–16 29
Cray Network Subsystem (CNS) Software Installation and Administration
Private Ethernet
CNS Gigabit Ethernet
CWS
CWS/SWS 10.0.109.N +1 IPv4 address/Netmask
cnsN N= IPv6 address/Subnet
(N=CNS number)
C
SWS
Usually 10.1.124.N+200 Gigabit
(N determined from bootp) Gateway router
Ethernet IP address
Routing Policy Changes
D
E
Gateway Router
Site Network
30 S–2366–16
Installation and Configuration [8]
The Cray X1 series mainframe uses router solicitation to configure its IPv6 address. Router
solicitation packets are sent over the fibre channel network to the CNS and received by the
radvd daemon. The radvd daemon responds to the Cray X1 series mainframe with its IPv6
prefix. The Cray X1 series mainframe configures the fibre channel interface with an IPv6
address using prefix received from the CNS.
IPv4/IPv6 addresses are configured on the CNS using the cns_gen_config command.
C IPv4/IPv6 address assigned from the site Gigabit Ethernet network.
Note: This is not the Cray mainframe IP address.
D The IPv4/IPv6 address of the default route for the CNS. This is the IP address of the gateway
router on the Gigabit Ethernet network.
E Routing policy changes. The site administrators decide how the site routers recognize the
path to the Cray mainframe. Cray provides two routing methods, static and dynamic.
For static routing, on the site routers you must manually assign a static entry that designates
the CNS as the path to the Cray mainframe Fibre Channel or HIPPI network for both IPv4
and IPv6.
For dynamic routing, configure gated on the CNS to announce to the site network routers
that the CNS is the path to the Cray mainframe Fibre Channel or HIPPI network for IPv4.
The zebra daemon on the CNS is used the announce to the site network routers that the CNS
is the path to the Cray mainframe Fibre Channel network for IPv6.
N For Cray X1 series systems, the CNS number determines the (static) IP address (10.0.109.N+1)
of the CNS on the Cray X1 series mainframe private Ethernet network. For example, for cns0,
where the CNS number (N) is 0, the CNS name is cns0 and the IP address is 10.0.109.1.
For Cray GigaRing systems, the IP address for the CNS private Ethernet eth0 interface on
systems using an SWS is set via bootp protocol. Most private IP addresses on an SWS will
be 10.1.124.N+200. Where N is a unique numerical value in the bootp configuration. Refer
S–2366–16 31
Cray Network Subsystem (CNS) Software Installation and Administration
Key Description
to Section 10.5, page 85 for configuring the bootptab file when connecting a CNS to a Cray
GigaRing system.
A CNS configured this way would be accessible from the CWS or SWS as cns0.
Note: The administrator must ensure that the CWS /etc/hosts file has an entry for cns0.
Note: For Remote Access Controller (RAC) name and IP address, refer to Section 10.4.2,
page 82.
For sites with a Cray X1 series system, refer to UNICOS/mp Networking Facilities
Administration to configure the qfaX interface on the Cray X1 series system,
where X is the ordinal number of the interface.
For sites with a GigaRing system, refer to UNICOS Networking Facilities
Administrator's Guide or UNICOS/mk Networking Facilities Administration to
configure the ghippiX interface on the GigaRing system, where X is the ordinal
number of the interface.
32 S–2366–16
Installation and Configuration [8]
CNS via the CWS private Ethernet network and a window on the CWS
(for upgrades only).
• Use the CNS RAC maintenance port (only after the RAC firmware has
been updated) and Ethernet cable to connect to the CWS via the private
Ethernet network and a window on the CWS. Refer to FCO 4043 for the
Ethernet cable to the RAC and Section 9.6.3, page 55 to configure for
remote console access.
3. Use Figure 2, page 30 as a worksheet (not usually needed for upgrades).
Obtain the configuration information (shown as A through D on the
worksheet) from your local networking administrator. Record that
information in the spaces provided in that figure. In addition, the site's
network administrator needs to configure item E in Figure 2 by following the
instructions in Section 10.3.1, page 60.
4. Obtain the CNS software CD from the release package (not needed for
configuring software on a new CNS).
5. Back up the current CNS configuration. Refer to Section 10.3.8, page 79 for
more information.
S–2366–16 33
Cray Network Subsystem (CNS) Software Installation and Administration
After the introductory output, each network interface will be configured. For
each of these, you need to answer several questions. Use the information you
recorded for C in Figure 2, page 30.
Note: For details and examples of configuring a bonded interface, Ethernet
interfaces, Fibre Channel interfaces, and setting the CNS number, refer to
Section 10.3.5, page 69.
4. When cns_gen_config is finished, install the configuration (stored in
/cray/etc/cns.conf) by entering:
[root@cnsN /root]# cns_config install
6. Find the appropriate time zone information file for your location in the
/usr/share/zoneinfo directory. Set the local time zone for your CNS by
creating a symbolic link to the appropriate zoneinfo file, which is done by
executing these commands as root:
[root@cnsN etc]# cd /etc
[root@cnsN etc]# rm -f localtime
[root@cnsN etc]# ln -s /usr/share/zoneinfo/zoneinfo_file localtime
where zoneinfo_file is the name of the time zone information file, for example
America/Chicago (case is important) for Chicago in the U.S.A.
For more details about setting the CNS time zone and reviewing the setting,
refer to Section 10.2, page 59.
34 S–2366–16
Installation and Configuration [8]
7. To use the newly configured CNS software, reboot the CNS as follows:
Note: Rebooting the CNS will cause existing proxy connections to fail or
hang. It is best to do this while the Cray X1 series network is up.
[root@cnsN /root]# reboot
Caution: Cray recommends that you change the initial root password.
! Site policies should include periodically changing the root password on
the CNS and Remote Access Controller (RAC). A secure root password is
a necessary part of CNS security and should not be overlooked.
9. Change the CNS root and crayadm passwords now using the passwd and
passwd crayadm commands, respectively.
10. If you are configuring a CNS in a GigaRing system, use Section 10.5, page 85
to configure the private Ethernet.
You must configure the network routing. Proceed to Section 8.2.2.
S–2366–16 35
Cray Network Subsystem (CNS) Software Installation and Administration
Perform the following steps to upgrade the current CNS software to the CNS
1.6 release.
Note: The N in cnsN is the CNS number. You must change N to match the
number of the CNS on which you are working.
Note: If you are re-installing the CNS 1.6 release, and therefore have already
upgraded the CNS firmware, you can use the CNS maintenance port (RAC)
for re-installation and subsequent release upgrades. For RAC usage and more
information, refer to Section 9.6, page 54 and the cns_rac(8) man page.
1. Perform the preparation procedures listed in Section 8.1, page 32.
2. Connect to the CNS using one of these methods:
• From the CWS or SWS:
cws/sws$ telnet cnsN
• From CNS RAC: see Section 9.6, page 54 for complete details.
3. Log in to the CNS as root.
4. Locate a directory on the CNS that has at least 500 MB of free space, for
example, /usr/tmp. Check whether an existing INSTALL directory is
present. If so, remove it and make a new one; otherwise, create an INSTALL
directory there and go to the new directory:
cnsN# cd /usr/tmp
cnsN# rm -rf INSTALL
cnsN# mkdir INSTALL
cnsN# cd INSTALL
5. Choose one of the following methods to enable access to the tar file
containing the CNS software for the release upgrade:
• Place the CNS software CD in the CNS CD-ROM drive and, as user root,
enter:
cnsN# mount /dev/hda /mnt/cdrom
cnsN# cd /mnt/cdrom/cray
36 S–2366–16
Installation and Configuration [8]
• Place the CNS software CD in the CD-ROM drive of the CWS or SWS
and enter:
cws/sws$ cd /cdrom/cdrom0/cray
6. Copy the file CNS-pkg-1.6.tar from the CNS software CD to the INSTALL
directory on the CNS using one of the following methods:
• If using the CD mounted on the CNS, enter:
cnsN# cp CNS-pkg-1.6.tar /usr/tmp/INSTALL
• If using the CD mounted on the CWS or SWS, from the CNS enter:
cnsN# ftp cws
Name (cws:root): crayadm
Password:
ftp> cd /cdrom/cdrom0/cray
ftp> bin
ftp> get CNS-pkg-1.6.tar
ftp> quit
Note: If this is not done, the upgraded software will not be used on the
next CNS boot.
11. Use one of the following methods to unmount the CNS software CD, so that
the CNS does not boot from it:
S–2366–16 37
Cray Network Subsystem (CNS) Software Installation and Administration
12. To run the newly upgraded CNS software, reboot the CNS by entering:
cnsN# reboot
This sample shows some of the output obtained when the firmware needed
upgrading:
cnsN# cns_rac firmware
cns_rac: Firmware version of RAC 2.10
cns_rac: Is different than supported version 3.12
Do you want to update the RAC firmware [ yes ]? yes
...
38 S–2366–16
Installation and Configuration [8]
Caution: Cray recommends that you change the initial root password.
! Site policies should include periodically changing the root password on the
CNS and Remote Access Controller (RAC). A secure root password is a
necessary part of CNS security and should not be overlooked.
Perform an initial installation to:
• Recover from a catastrophic disk failure resulting in lost or corrupted software
• Totally replace all CNS software for any release, as requested by your system
administrator or Cray support, such as to install the latest CNS release on a
CNS currently running CNS version 1.0.0
Use the following procedure to perform an initial installation of CNS software.
You need access to the software release CD. The procedure is described for the
following CNS access setups:
• Direct-attached VGA monitor with a keyboard
S–2366–16 39
Cray Network Subsystem (CNS) Software Installation and Administration
4. At the LILO Boot Menu, select Serial Port if working from a CWS/SWS
serial console connection or VGA + keyboard if working from a VGA
monitor and attached keyboard or CNS RAC console.
Note: Serial Port, which is the CWS/SWS serial line, is the default and
is automatically selected in 5 seconds.
5. At the prompt for type of installation, enter: I
Note: Case is not significant.
I)nitial install, U)pgrade, or S)hell [ Upgrade ]?
40 S–2366–16
Installation and Configuration [8]
Is the current local time 'DDD MMM NN hh:mm:ss yyyy '? [ Yes ]
where DDD is the day of the week, MMM is the month, NN is the numeric
day of the month, hh is the hour, mm is the minute, ss is the second, and
yyyy is the year.
If the time is correct, press Enter to continue or enter N for prompts to correct
the time.
8. Answer the questions regarding the interface configuration and CNS number.
Refer to Section 10.3.6, page 76 for details and examples.
9. When the following text is displayed, the CNS initial installation has
completed successfully:
The CNS has been installed successfully.
Booting 1.6 in 20 seconds
The CNS install CD will be ejected from the CNS cdrom drive. The CNS will
automatically reboot to CNS version 1.6.
10. Change the CNS root and crayadm passwords by using the passwd and
passwd crayadm commands, respectively.
11. Find the appropriate time zone information file for your location in the
/usr/share/zoneinfo directory. Set the local time zone for your CNS by
creating a symbolic link to the appropriate zoneinfo file, which is done by
executing these commands as root:
Note: The N in cnsN is the CNS number. You must change N to match the
number of the CNS on which you are working.
S–2366–16 41
Cray Network Subsystem (CNS) Software Installation and Administration
where zoneinfo_file is the name of the time zone information file, for example
America/Chicago (case is important) for Chicago in the U.S.A.
For more details about setting the CNS time zone and reviewing the setting,
refer to Section 10.2, page 59.
12. If you are performing an initial installation of software on a CNS in a
GigaRing I/O system, use Section 10.5, page 85 to configure the private
Ethernet.
This completes the CNS software initial installation procedure.
The asterisk on the line containing VGA_1.1_b indicates that this is the root
partition that will be used by default the next time the CNS is booted.
Reverting to the previous configuration does not affect the RAC firmware
version.
42 S–2366–16
Installation and Configuration [8]
S–2366–16 43
Cray Network Subsystem (CNS) Software Installation and Administration
will become inaccessible from the CWS until the cwsroute open command is
invoked.
Use the cwsroute command to establish a direct route between the CWS and the
Cray X1 series mainframe with the CNS as its default gateway by performing the
following procedure.
Note: In this procedure, replace CRAYADDR with the IP address of the Cray
mainframe (refer to A in Figure 2, page 30).
The N in cnsN is the CNS number. You must change N to match the number
of the CNS on which you are working. This CNS is assumed to be connected to
the Cray mainframe and is the default gateway for that Cray X1 series system.
1. Log in to the CWS, then use telnet to get to the CNS over the private
Ethernet.
2. Login to the CNS as root.
3. Enter:
cnsN# cwsroute open CRAYADDR
4. On the CWS, add the route from the CWS to the Cray X1 series mainframe
by entering:
cws# route add CRAYADDR cns0
44 S–2366–16
CNS Functional Overview and
Administration [9]
This chapter is a functional overview of the CNS and its network environment
and includes the following information:
S–2366–16 45
Cray Network Subsystem (CNS) Software Installation and Administration
Cray mainframe
Communicates with Cray mainframe
using a larger packet size or
maximum transmission unit (MTU)
over Fibre Channel or HIPPI
CNS
Communicates on behalf of the Cray
mainframe to other hosts using a
smaller network packet size or MTU
Site
network
host host
1 2
The mechanism for translating the large maximum transmission units (MTUs) of
the Cray mainframe into the small MTUs of the site network is the tcp_assistd
daemon. This daemon is a process running on the CNS that manages all of the
TCP connections passing through the CNS. It performs appropriate network
address translation (NAT) operations on the packets in these TCP streams to
make the translation transparent to both the Cray mainframe and the endpoint
on the site network.
Because of this, the CNS becomes responsible for managing the flow of data
going between the Cray mainframe and the small MTU Ethernet host. Therefore,
the CNS must process all TCP traffic (all IP packets using the TCP protocol)
that passes between the Cray mainframe and any Ethernet host establishing a
connection with the Cray mainframe through that CNS.
An ordinary router provides only connectivity; there is no provision available
to change the size of a TCP segment. However, the CNS also has the ability to
take many small TCP segments, destined for the Cray mainframe, and create a
new larger TCP segment, then send the data on to the Cray mainframe. In the
46 S–2366–16
CNS Functional Overview and Administration [9]
opposite direction, the CNS receives one large TCP segment and sends it out as
several smaller independent TCP segments.
Note: User Datagram Protocol (UDP), Internet Control Message Protocol
(ICMP), and other non-TCP protocols are simply routed through the CNS
without change. They are not assisted by the CNS as with TCP. Basically, the
CNS operates as a router, passing all packet traffic between site networks and
the Cray mainframe.
Cray X1 series
mainframe
CNS
Site
Gigabit
Ethernet
CWS
KEY
Fibre Channel Serial line (RS-232)
Gigabit Ethernet (fiber or copper)
Cat 5 UTP cable
S–2366–16 47
Cray Network Subsystem (CNS) Software Installation and Administration
SWS
KEY
GigaRing
Parallel HIPPI, copper
Serial HIPPI, fiber HPN - HIPPI node
Gigabit Ethernet, fiber NSR - Node subrack
Cat 5 UTP
Serial line (RS232)
48 S–2366–16
CNS Functional Overview and Administration [9]
Cray X1 series
mainframe
CNS_0
Gigabit Ethernet
to
site network
KEY
Fibre Channel (FC)
Gigabit Ethernet (fiber or copper)
IP Internet Protocol
A bonding interface will enslave all of the Fibre Channel network interfaces on
the CNS. This allows you to use the Fibre Channel as either a single bonded
interface or as two individual interfaces. Once bonding is configured, no Fibre
Channel interface will be individually usable on the CNS.
Note: If the CNS is booted when the Cray X1 series Fibre Channel interfaces
are down, there is a chance that the bonded Fibre Channel network interface
will not function.
Subsequent rebooting of the Cray X1 series mainframe after the CNS is up
should not cause this problem. If the CNS is booted while the Cray X1 series
mainframe is down, reboot the CNS after the Cray X1 series mainframe is up to
restore network functionality.
S–2366–16 49
Cray Network Subsystem (CNS) Software Installation and Administration
Caution: Cray recommends that you change the initial root password.
! Site policies should include periodically changing the root password on the
CNS and Remote Access Controller (RAC). A secure root password is a
necessary part of CNS security and should not be overlooked.
50 S–2366–16
CNS Functional Overview and Administration [9]
Once CNS access is gained, an administrator can log into the CNS as root using
the current root password. The initial root password is initial0.
3. Press Enter to ensure that a prompt displays and the serial line is working.
4. Use the CNS Power button to power-cycle the CNS and force the CNS to
reboot.
5. When the LILO prompt appears, press the Tab key followed by the Enter key
within 5 seconds. This displays a list of options:
LILO Boot Menu
Ser_1.1_b
VGA_1.1_b
where the 1.1 in this example is the release version, which will change with
each release, and where _b is the root from which the CNS will boot (the
other possible choices for the root devices are a and c).
Use the arrow key to select the first option, which is always Ser_1.1_b. The
selected option then appears after the boot prompt:
boot:
boot: Ser_1.1_b
S–2366–16 51
Cray Network Subsystem (CNS) Software Installation and Administration
Note: You have 5 seconds to enter the word single once the boot prompt
appears to force the CNS to boot to single user mode, or the system will
follow the default boot process.
Add a space and then the word single to force the CNS to boot to single
user mode:
boot:
boot: Ser_1.1_b single
6. When the CNS system completes the boot to single user mode and you see
the shell prompt (that is, sh-2.04#), enter the following command and
follow the prompts to reset the root password:
passwd
At this point, the CNS will reboot and the root password is reset.
52 S–2366–16
CNS Functional Overview and Administration [9]
S–2366–16 53
Cray Network Subsystem (CNS) Software Installation and Administration
NTP and DNS configuration files that have been locally modified
will not be carried forward to the CNS 1.6 release upgrade. The
CWS will act as the NTP and DNS server.
Linux kernel
The CNS software uses the Linux 2.4.21-32.0.1.EL kernel
distributed by Red Hat, which contains the latest security
updates from Red Hat.
CERT advisories
Cray tracks the relevant security issues, such as CERT (Computer
Emergency Response Team) advisories, and responds to them as
part of normal CNS support. Additional changes and updates
are made available as necessary.
54 S–2366–16
CNS Functional Overview and Administration [9]
For more information about the cns_rac command, refer to the cns_rac(8)
man page.
Caution: Cray recommends that you change the initial root password.
! Site policies should include periodically changing the root password on the
CNS and Remote Access Controller (RAC). A secure root password is a
necessary part of CNS security and should not be overlooked.
You can change the RAC password by using the cns_rac password command.
For more information about the cns_rac command, refer to Section 9.6.1,
page 54, Section 10.4.1, page 80, and the cns_rac(8) man page.
S–2366–16 55
Cray Network Subsystem (CNS) Software Installation and Administration
These three RAC subcommands are the most useful for CNS administration:
connect, serveraction, and exit.
56 S–2366–16
CNS Functional Overview and Administration [9]
S–2366–16 57
Cray Network Subsystem (CNS) Software Installation and Administration
cns0 login:root
Password:
Last login: Fri Apr 2 11:01:51 from cws
[root@cns0 root]#
Now, you are logged in to the CNS and can run CNS commands.
To exit the CNS command mode and return to the RAC login, press Enter before
typing the ~. escape command. It might be necessary to enter this escape
sequence more than once to effect the escape for logging out of the RAC, as
shown in this example for cns0:
[root@cns0 root]# <CR>~.
-bash: ~.: command not found
[root@cns0 root]# <CR>~.
-bash: ~.: command not found
[root@cns0 root]# <CR>~.
[root]#
58 S–2366–16
Advanced Configuration Topics [10]
After establishing the time zone, you can use the date command to display the
appropriate abbreviation for your time zone, as shown for cns0 in this example:
[root@cns0 etc]# date
Sun Apr 25 17:48:59 CDT 2004
S–2366–16 59
Cray Network Subsystem (CNS) Software Installation and Administration
Routing between the CNS and the site network can be configured statically or
dynamically.
To configure default static routes on the CNS, use the cns_gen_config
command and answer the resulting prompts.
To configure additional static routes, edit the /cray/etc/cns.conf file and
60 S–2366–16
Advanced Configuration Topics [10]
add the following line just prior to the line that contains the END%ROUTES text, so
it looks similar to this:
any net 192.168.0.0 netmask 255.255.255.0 gw IP
or
any 192.168.0.1 gw IP
where IP is the IP address of the site default router on the eth2 network.
After editing the cns.conf file, use the cns_config install command to
write and save the configuration. Once the configuration is written, you must
reboot the CNS for the route to take affect.
10.3.2 Using gated to Configure a Default Dynamic Route for the CNS
The gated gateway routing daemon is used on the CNS to dynamically
configure network routes. The gated daemon handles multiple routing
protocols: RIP, BFP, EGP, HELLO, and OSPF.
Example 1: /etc/gated.conf Default Configuration File for a Fibre
Channel Network
This example shows the /etc/gated.conf default configuration file for gated
using the RIP protocol and announces the CNS as the path to the Fibre Channel
network via the lpfn0 interface to the receiving router on the Gigabit Ethernet
network for the eth2 interface.
This example will also take in RIP updates from the network to which eth2
belongs. The static entry preserves the static default route. The traceoptions
parameter creates a gated log file that logs all gated actions.
traceoptions "/var/tmp/gated.log" replace size 100k files 2 all ;
rip yes {
interface all noripin noripout ;
interface all version 2 ;
interface eth2 ripout ripin version 2 multicast ;
# interface lpfn0 ripout ripin version 2 multicast ;
};
static {
default gateway 192.168.240.1 retain;
};
S–2366–16 61
Cray Network Subsystem (CNS) Software Installation and Administration
default restrict ;
};
static {
default gateway 172.30.7.1 retain;
};
62 S–2366–16
Advanced Configuration Topics [10]
proto direct ;
proto static metric 1;
};
10.3.3 Using zebra to Configure a Default Dynamic Route for the CNS with IPv6
The zebra routing daemon is used on the CNS to dynamically configure
network routes for IPv6. The zebra daemon handles multiple routing protocols:
RIPv1, RIPv2, RIPng, OSPF, OSPF6, BGP4+, and BGP4-.
Example 3: /etc/zebra/zebra.conf and /etc/zebra/ripngd.conf are
the Default IPv6 Configuration Files for a Fibre Channel Network
This example shows the /etc/zebra/zebra.conf and
/etc/zebra/ripngd.conf default configuration files for the zebra
daemon to use the RIPng protocol and announce the CNS as the path to
the Fibre Channel network via the lpfn0 interface to the receiving router on
the Gigabit Ethernet network for the eth2 interface. The second line in the
/etc/zebra/zebra.conf file adds a IPv6 default route.
/etc/zebra/zebra.conf:
hostname cns7
ipv6 route 2000::/3 2001:408:4000:4f0::1 eth2
/etc/zebra/ripngd.conf:
hostname cns7-ripng
!
router ripng
network eth1
! This is the route we are advertising:
route 2001:408:4000:1411::/64
! this is where we are sending it:
distribute-list local-only out eth2
!
log syslog
hostname cns7-zebra
!
log syslog
!
S–2366–16 63
Cray Network Subsystem (CNS) Software Installation and Administration
10.3.4 Configuring Static Routing to the CNS from the Cray Mainframe
For Cray X1 series systems:
You must set a default route from the Cray X1 series mainframe to the CNS
in the UNICOS/mp /etc/config/static-route.options file, as shown
in Example 4.
Example 4: Sample static-route.options File for a Cray X1 series
Mainframe
This example shows the UNICOS/mp
/etc/config/static-route.options file that
establishes the default static route to the CNS from the Cray X1 series mainframe.
# static-route.options
# The network startup script, /etc/init.d/network, invokes this
# script to set static routes. Site-dependent static routes should
# be put here.
#
# Read `man route`.
#
# Since $ROUTE and $QUIET are set in /etc/init.d/network, it is convenient
# to use `route` commands similar to the following here:
#
64 S–2366–16
Advanced Configuration Topics [10]
After you configure the static-route.options file, you can reboot the
Cray X1 series system for the routes to take affect. As an alternative to rebooting
the Cray X1 series system, as the superuser you could set the default route with
the route command:
where cnsN-FCIP is the IP address of the CNS on the Fibre Channel network.
cray# route add default cnsN-FCIP
#
# Interfaces section
#
#
# Definition section
#
#
# Protocol section
S–2366–16 65
Cray Network Subsystem (CNS) Software Installation and Administration
rip yes {
interface all noripout ;
} ;
redirect yes ;
#
# Route section
#
static {
default gateway 172.30.8.50 ;
} ;
#
# Control section
#
66 S–2366–16
Advanced Configuration Topics [10]
You can add these echo commands to the /etc/rc.local file so that the proxy
ARP setting will be set whenever the CNS is rebooted.
Figure 7 shows an example configuration where proxy ARP can be used. Note
that the IP address and network mask of the Cray mainframe subnetwork is a
subset of the IP address and network mask of the Gigabit Ethernet network. The
Gigabit Ethernet network has a range of 192.168.240.0 through 192.168.240.255.
The Cray mainframe subnetwork range is 192.168.240.76 through 192.168.240.79.
This is accomplished by setting the network mask to 255.255.255.252 on the Cray
mainframe subnetwork versus 255.255.255.0 on the Gigabit Ethernet network.
Boxes A, B, and C in Figure 7 show examples of these IP addresses and network
masks.
For sites with a Cray X1 series system, see UNICOS/mp Networking Facilities
Administration to configure the qfaX interface on the Cray X1 series system,
where X is ordinal number of the interface.
For sites with Cray GigaRing systems, see UNICOS Networking Facilities
Administrator's Guide or UNICOS/mk Networking Facilities Administration to
configure the ghippiX interface, where X is the ordinal number of the interface.
S–2366–16 67
Cray Network Subsystem (CNS) Software Installation and Administration
Private Ethernet
CNS
CWS
CWS/SWS
10.0.109.N +1 Gigabit Ethernet
cnsN N= IP address/Netmask
(N=CNS number) 192.168.240.36
255.255.255.0
C
SWS
Usually 10.1.124.N+200 Gigabit
(N determined from bootp) Gateway router
Ethernet IP address
Routing Policy Changes
192.168.240.1 D
E
Gateway Router
Site Network
68 S–2366–16
Advanced Configuration Topics [10]
S–2366–16 69
Cray Network Subsystem (CNS) Software Installation and Administration
70 S–2366–16
Advanced Configuration Topics [10]
The CNS was rebooted as shown here to use the newly configured CNS software:
[root@cns0 /root]# reboot
S–2366–16 71
Cray Network Subsystem (CNS) Software Installation and Administration
72 S–2366–16
Advanced Configuration Topics [10]
You must configure the Ethernet interfaces for the CNS (refer to Example 9).
Example 9: cns_gen_config Output When Configuring CNS Ethernet
Interfaces
This example shows the information, questions, and default answers that display
while running cns_gen_config to generate the master CNS configuration
file when the CNS is attached to a Cray X1 series mainframe via an Ethernet
interface. Answer them as follows:
Note: This is just an example. The values displayed on your Cray X1 series
system or Cray GigaRing system for IP address and NETMASK will be different.
…
Configure interface eth2 [ yes ]? y
How is the IP acquired (none (static), dhcp) [ static ]?
What is the IP address on this interface [ 10.0.3.91 ]?
What is the NETMASK on this interface [ 255.255.255.0 ]?
S–2366–16 73
Cray Network Subsystem (CNS) Software Installation and Administration
Press Enter to use the default value (in brackets). For yes or no questions, the
first character is sufficient (y or n is enough).
You must configure Fibre Channel (Example 10) or HIPPI (Example 11) interface
connections, if present.
Example 10: cns_gen_config Output When Configuring a Fibre Channel
Interface
This example shows partial output of the cns_gen_config command for
configuring a Fibre Channel interface for a Cray X1 series system.
74 S–2366–16
Advanced Configuration Topics [10]
Note: This is just an example. The values displayed on your system for IP
address and NETMASK may be different. You would use the information you
recorded for B in Figure 2, page 30 for the configuration.
…
Configure interface lpfn0 [ yes ]? y
Is this interface directly connected to the Cray [ yes ]?
What is the IP address on this interface [ 10.0.3.91 ]?
What is the NETMASK on this interface [ 255.255.255.0 ]?
What is the IPV6 address ? 2001:408:4000:1408::5/64
The X1 IPV6 address is configured from the CNS
using stateless autoconfiguration. Stateless
autoconfiguration specifies ONLY the PREFIX
portion of the IPV6 address.
What is the IPV6 prefix for the X1 ? 2001:408:4000:1400::/64
S–2366–16 75
Cray Network Subsystem (CNS) Software Installation and Administration
10.3.5.4 Configuring CNS Interfaces That are not Cabled to the CNS
Answer no for CNS interfaces that are not cabled (whether bonded or not
bonded).
…
Configure interface lpfn1 [ yes ]? n
…
The CNS number determines the (static) IP address (10.0.109.N+1) of the CNS
on the Cray X1 mainframe private Ethernet network. For example, for cns0 ,
where the CNS number (N) is 0, the CNS name is cns0 and the IP address is
10.0.109.1.
76 S–2366–16
Advanced Configuration Topics [10]
Use the information you recorded for C in Figure 2, page 30 to supply the
requested information.
Note: This is just an example. The values displayed on your system for IP
addresses and NETMASK may be different.
How is the IP acquired (none (static), dhcp) [ static ]? static
What is the IP address on this interface ? 10.0.1.57
What is the NETMASK on this interface ? 255.255.255.0
What is the IPV6 address ? 2001:408:4000:804::5/64
What is the MTU on this interface [ 1500 ]? 1500
where 10.0.5.57 is the IP address and 255.255.255.0 is the NETMASK that you
must change to be specific to your site in nnn.nnn.nnn.nnn decimal format.
2001:408:4000:804::5/64 is the IPv6 address if you answered yes to
configuring IPv6.
2. At the prompt to configure the next interface, choose the instructions below
for either Fibre Channel (lpfn#) or HIPPI (hip#) depending on your specific
site setup:
Fibre Channel interface:
Configure interface lpfn0 [ yes ]? yes
Use the information you recorded for B in Figure 2, page 30 to supply the
requested information:
Note: This is just an example. The values displayed on your system for IP
addresses and NETMASK will be different.
Is this interface directly connected to the Cray [ yes ]? y
Configure interface lpfn0 [ yes ]?
IP address? 10.0.1.57
What is the IP address on this interface ? 10.0.0.57
What is the NETMASK on this interface ? 255.255.255.0
What is the IPV6 address ? 2001:408:4000:1408::5/64
The X1 IPV6 address is configured from the CNS
using stateless autoconfiguration. Stateless
S–2366–16 77
Cray Network Subsystem (CNS) Software Installation and Administration
where 10.0.5.57 is the IP address and 255.255.255.0 is the NETMASK that you
must change to be specific to your site in nnn.nnn.nnn.nnn decimal format. If
you are using IPv6, 2001:408:4000:1408::5/64 is the IPv6 address and
2001:408:4000:1408::/64 is the prefix address for autoconfiguring the
Cray X1 series system.
HIPPI interface:
Note: This is just an example. The values displayed on your system for IP
address and NETMASK may be different.
Configure interface hip0 [ yes ]? yes
Is this interface directly connected to the Cray [ yes ]?
How is the IP acquired (none (static), dhcp) [ none ]? static
What is the IP address on this interface [ 192.168.242.58 ]?
What is the NETMASK on this interface [ 255.255.255.0 ]?
where nn is number you assign to your CNS. This will also be part of the
CNS name (for example, cns0 for CNS0, that you will use to access the CNS
from the CWS or SWS.
4. Configure the gated daemon on or off.
Do you want to configure the gated daemon on [ no ]? no
The Zebra daemon is used to
configure dynamic routing for IPV6
78 S–2366–16
Advanced Configuration Topics [10]
S–2366–16 79
Cray Network Subsystem (CNS) Software Installation and Administration
To ensure correct configuration, you must always run the following two
commands after running the cns_config restore command:
cns0# cns_gen_config
(answer the questions posed and use defaults as appropriate)
cns0# cns_config install
10.4 Remote Access Controller (RAC) Maintenance Port Setup and Configuration
This section describes the setup and configuration of the Remote Access
Controller (RAC), the standard CNS maintenance port.
80 S–2366–16
Advanced Configuration Topics [10]
connected to the SWS's qe0 or qfe0 port. Refer to FCO 4043 for more
information.
2. Run the cns_rac firmware command. For more information about the
RAC firmware upgrade command, refer to Section 9.6.1, page 54 and the
cns_rac(8) man page.
cns0# cns_rac firmware
cns_rac: Firmware version of RAC 2.10
cns_rac: Is different than supported version 3.12
Do you want to update the RAC firmware [ yes ]? yes
...
3. Set the RAC IP address for a CNS in a Cray X1 series environment or Cray
GigaRing system environment by entering:
Note: For visual help in determining the RAC IP address, refer to Section
10.4.2, page 82.
cns0# cns_rac setip
S–2366–16 81
Cray Network Subsystem (CNS) Software Installation and Administration
82 S–2366–16
Advanced Configuration Topics [10]
Example:
cnsN IP address.(N+101) = RAC IP address
(where N = CNS number)
For cnsN where N = 0, N+101 = 101
cns0 RAC IP address = 10.0.109.101
cns0-rac
to RAC
10.0.104.1 Private CNS0
Ethernet
CWS RAC cns0-rac [root]# connect video
telnet to CNS 10.0.109.101 RAC to CNS
Switch
cns0
10.0.109.1
Serial line
cnsN
N=
CNS number
VGA+keyboard
S–2366–16 83
Cray Network Subsystem (CNS) Software Installation and Administration
the network portion of the CNS IP address and the CNS number plus 240
(10.1.124.N+240), where N is the actual CNS number, not the number in
the bootp configuration used for the host portion of the CNS IP address. For
example, CNS0 (0), which might be assigned an IP address of 10.1.124.206 (in
the bootp configuration), would have a RAC name of cns0-rac and RAC IP
address of 10.1.124.240 (see Figure 9).
Edit the /etc/hosts file on the SWS and manually enter the RAC name and its
IP address to configure the RAC. It should look something like this:
#
# CNS region
#
10.1.124.240 cns0-rac cns0-rac.cns
10.1.124.241 cns1-rac cns1-rac.cns
10.1.124.242 cns2-rac cns2-rac.cns
10.1.124.243 cns3-rac cns3-rac.cns
10.1.124.244 cns4-rac cns4-rac.cns
10.1.124.245 cns5-rac cns5-rac.cns
10.1.124.246 cns6-rac cns6-rac.cns
10.1.124.247 cns7-rac cns7-rac.cns
10.1.124.248 cns8-rac cns8-rac.cns
10.1.124.259 cns9-rac cns9-rac.cns
84 S–2366–16
Advanced Configuration Topics [10]
Example:
cnsN IP address = usually 10.1.124.N + 200
(where N is determined by bootp configuration)
cnsN might be 10.1.124.206
cnsN RAC IP address = 10.1.124.N + 240
(where N is the CNS number you assign)
For cnsN where N=0, CNS0 = cns0
cns0 RAC IP address = 10.1.124.240
Your cnsN RAC IP address:
Usually 10.0.124.200
to RAC
Private CNS0
Ethernet
RAC cns0-rac [root]# connect video
to CNS 10.1.124.240 RAC to CNS
SWS telnet
Switch cns0
10.1.124.206 (bootp)
Serial line
cnsN
N=
CNS number
VGA+keyboard
At this point, you should be able to access the RAC from the CWS or SWS. For
more information about logging in to the RAC, refer to Section 9.6.2, page 55.
S–2366–16 85
Cray Network Subsystem (CNS) Software Installation and Administration
Set the SWS to act as the bootp server for the CNS by executing this command:
sws# /opt/CYRIpkg/bin/swsbp
Note: This command leads you through the steps necessary to set up the SWS
to act as a bootp server for the CNS. You can use Example 12 as a guideline to
configure your private Ethernet connection.
Example 12: Setting Up the SWS to Act as a bootp Server for the CNS
A dialog similar to this takes place when using the swsbp command:
Note: Substitute CNS and cns for L7R and l7r, respectively, throughout this
example.
root =
etcdir = /etc
Press Return.
Enter private network name [default is "taccon-private"]:
note: default is the "SWS's private ethernet host name"
Press Return if the default is correct, or enter the name of the SWS on the correct
private Ethernet interface.
Enter the taccon-private IP address [default is 10.1.124.200]:
note: default is IP address of the SWS on the private network
Press Return.
Enter the number of the task you would like to perform:
1. Make a new SPN entry in bootptab
2. Make a new MPN entry in bootptab
3. Make a new L7R entry in bootptab
4. Delete an existing bootptab entry
5. Modify an existing bootptab entry
6. Display the bootptab file
86 S–2366–16
Advanced Configuration Topics [10]
# 3
Note: This means the CNS hardware address, which is also referred to as the
CNS MAC address. The hardware address needs to be entered without the
colons and using hex numbers in lower case.
You can display the hardware address using the output of the ifconfig eth0
command when logged into the CNS over the serial connection using the
command:
tip -57600 /dev/ttya or tip -57600 /dev/ttyb
You can also use the RAC console; see Section 9.6.2, page 55 for more
information.
The hardware address is displayed in colon-delimited notation following the
HWaddr term shown in the ifconfig eth0 output in this example:
Example:
S–2366–16 87
Cray Network Subsystem (CNS) Software Installation and Administration
# 8
The private Ethernet connection should be functional now. To log in to the CNS
from the SWS, you can telnet to the chosen host name, for example cns0.
88 S–2366–16
CNS Troubleshooting [11]
This chapter describes the basics needed to diagnose and resolve problems
relating to the initial installation and configuration of the CNS.
The troubleshooting approach presented here is broken down by different
sections of the CNS network environments as shown in Figure 10, page 90 and
Figure 11, page 91 and are related as follows:
1. What to do when the CNS is unable to boot (Section 11.1, page 91)
2. Accessing the CNS for troubleshooting (Section 11.2, page 92)
3. Troubleshooting CNS access to Cray mainframes (Section 11.3, page 93)
4. Troubleshooting CNS access to the site network (Section 11.4, page 95)
5. Troubleshooting remote host access to and from Cray mainframes (Section
11.5, page 97)
6. Controlling the tcp_assistd daemon for troubleshooting (Section 11.6,
page 98)
For situations where it is necessary to disable the tcp_assistd daemon, see
Section 11.6, page 98.
S–2366–16 89
Cray Network Subsystem (CNS) Software Installation and Administration
CWS
Cray
mainframe
network
CNS
Key
External Ethernet Serial line (RS232)
Figure 10. The CNS with Ethernet Connections in a Cray X1 Series Environment
90 S–2366–16
CNS Troubleshooting [11]
SWS
GigaRing
mainframe
Cray
mainframe
network
CNS
Key
External Ethernet Serial line (RS232)
Figure 11. The CNS with HIPPI Connections in a Cray GigaRing System Environment
S–2366–16 91
Cray Network Subsystem (CNS) Software Installation and Administration
4. Contact Cray Support if you are still unable to boot the CNS.
An alternate method is to access the RAC (Section 9.6.2, page 55) and the CNS
console as described in Section 9.6.3, page 55.
The CNS eth0 interface connects to the CWS or SWS over a private Ethernet
network as follows:
• For the CWS, the Private Administration subnetwork uses the CWS znb5
interface.
Refer to the section I/O Networks in Cray X1 Series System Configuration and
CWS Administration for details about the Private Administration subnetwork.
• For the SWS, the private Ethernet interface is qex or qfex, where x is a
number 0 through 4.
If the private Ethernet on the CNS is connected properly, the
following message logs in /var/log/messages on the CNS and the
/opt/craylog/ops.log file on the CWS (for earlier CWS releases they were
kept in /opt/craylog/cns.log):
eth0 NIC link is up, 100 Mbps full duplex
92 S–2366–16
CNS Troubleshooting [11]
If the private Ethernet on the CNS is not connected properly, the following
message displays; use the serial connection from the CWS or SWS to the CNS to
further diagnose the problem:
eth0 NIC link is down
The CNS RAC maintenance port interface connects to the CWS or SWS over a
private Ethernet network (Figure 8, page 83 or Figure 9, page 85) and the RAC
can be used to access the CNS with the connnect video or connect com1
command Section 9.6.3, page 55). A RAC Ethernet cable is shipped with the CNS
or provided as described in Field Change Order (FCO) 4043.
Cray mainframe
Cray
mainframe
network
CNS
S–2366–16 93
Cray Network Subsystem (CNS) Software Installation and Administration
is established and the loop is up, you will find messages similar to those shown
in Example 13.
Example 13: Fibre Channel Link Messages in /var/log/messages on the
Cray X1 Series System
Feb 17 00:12:03 6A:sn702 unix: CPU 0VN0S4 (0x4) : qfa0: qlogic 2312, port name 0x100000e08b070ebd
Feb 17 00:12:03 6A:sn702 unix: CPU 0VN0S6 (0x6) : qfa0: LIP detected
Feb 17 00:12:04 6A:sn702 unix: CPU 0VN0S6 (0x6) : qfa0: LOOP UP detected
Feb 17 00:12:04 6A:sn702 unix: CPU 0VN0S6 (0xb) : qfa0: Data rate is 2Gbps
If messages similar to those shown in Example 13, page 94 do not occur, there
is a problem with the Fibre Channel connection between the Cray X1 series
mainframe and the CNS.
If you do find messages similar to those shown in Example 13, page 94, the Fibre
Channel connection is up.
Once the IP addresses have been chosen, you must establish IP communication.
The IP network for the Fibre Channel link will have to be on a separate
subnetwork than the Gigabit Ethernet or HIPPI networks, which are connected to
the site networks. See Section 8.2, page 33 for information about configuring the
Fibre Channel network.
When the Fibre Channel network is configured and the connection is up, you can
use the ping command to verify IP communication.
You can use the netstat -ia command to check for errors of the Fibre Channel
interface (LPNsx), where x is the ordinal number of the interface.
94 S–2366–16
CNS Troubleshooting [11]
You can use the ifconfig command to check the status of the Fibre Channel
interface.
When the HIPPI interface is configured, you can use the ping command to verify
IP communication occurs between the CNS and the Cray mainframe.
You can use the netstat -ia command to check for errors on the HIPPI
interface.
You can use the ifconfig command to check the status of the HIPPI interface.
S–2366–16 95
Cray Network Subsystem (CNS) Software Installation and Administration
CNS
From the CNS perspective, this involves the following configuration information
for the ethN interface (see Figure 2, page 30):
ethN
where N is the desired interface number. The Gigabit Ethernet interface is usually
eth2.
To initialize the specified Ethernet interface, execute the following command
on the CNS:
ifup ethN
96 S–2366–16
CNS Troubleshooting [11]
When the Ethernet interface is configured, you can use the ping command to
verify IP communication occurs between the CNS and the host on a site network.
When the Ethernet interface is configured, you can use the ping command
to verify IPv4 communication occurs between the CNS and the host on a site
network. For IPv6, use the ping6 command to verify communication occurs
between the CNS and the host on the site network.
You can use the netstat -ia command to check for errors on the host
interface.
You can use the ifconfig command to check the status of the host interface.
Cray mainframe
CNS
S–2366–16 97
Cray Network Subsystem (CNS) Software Installation and Administration
The CNS functions as a router, so the mainframe site must choose how
the routing is configured on the CNS. The choices are static, dynamic, or
a combination of static and dynamic routing. For more information on
configurations for routing, refer to Section 10.3, page 60.
If you suspect a routing problem, you can use the route command to check the
routing table of the CNS. Use route -A inet6 -n to check the IPv6 routes.
You can use the traceroute command to verify that routes are configured
properly for IPv4. Use the traceroute6 command to verify IPv6 routes.
98 S–2366–16
CNS Hardware Connections [A]
On-board Ethernet
activity indicators
Power
indicator
eth0
eth1
Disk activity
indicator
Cover latch
Keyboard/ Video monitor
mouse
Power
button/light
CD tray
Diskette
drive
Hard disk
drive
S–2366–16 99
Cray Network Subsystem (CNS) Software Installation and Administration
DATA
850mm
DEST.
SCR.
HPPI
OUT
IN
LINK
Controls and indicators on the CNS (Dell 1650) have the following characteristics:
Power Button/Light
The power button is used to turn power on and off. The power
light, which is contained within the button, has the following
meanings when on:
Blinking There is power to the CNS (Dell 1650), but the
unit is not powered up.
Solid The CNS (Dell 1650) is either booting or running.
Power Indicator
Blinking Green
There is Ethernet activity on this port.
100 S–2366–16
CNS Hardware Connections [A]
S–2366–16 101
Cray Network Subsystem (CNS) Software Installation and Administration
Power
eth1 ard Video
Serial
eth0 Mouse
line
Remote Access
Controller (RAC)
Ethernet port
Controls and indicators on the CNS (Dell 2650) have the following characteristics:
Ethernet Indicators (eth0, eth1)
Indicates the state of the onboard Ethernet port.
Green There is Ethernet connectivity on the port.
Off The Ethernet is not connected.
Power Button
The power button is used to turn power on and off.
Display Displays internal information.
102 S–2366–16
CNS Hardware Connections [A]
Display
Power button
Remote Access
Power Controller (RAC) USB
ethernet port ports
Mouse
Serial eth1
port Keyboard eth0
Video
port
Controls and indicators on the CNS (Dell 2850) have the following characteristics:
S–2366–16 103
Cray Network Subsystem (CNS) Software Installation and Administration
Power Button
The power button is used to turn power on and off.
Display Displays internal information.
104 S–2366–16
HIPPI Network Configuration [B]
B.1 Requirements
To configure the CNS HIPPI network, the following must be available:
• The physical HIPPI hardware must be installed and operational.
• An IP network must be defined and all hosts that exist on this network must
have assigned, unique IP addresses.
• All I-fields must be identified for each IP address and host name for each
host on the HIPPI network.
S–2366–16 105
Cray Network Subsystem (CNS) Software Installation and Administration
Each line in the file defines one host on the HIPPI network and must have
the following format:
hip0 hippi IP address or hostname 00:00:I-field
The first token, hip0, defines the HIPPI interface to which the ARP entry
will be applied.
The second token, hippi, is a constant used for association of this entry to
the CNS HIPPI interface.
The third token is the IP address or host name associated with the Cray
mainframe's HIPPI interface or site HIPPI-connected host.
The fourth token is the I-field that the CNS is to use to route packets through
the HIPPI hardware to the indicated Cray mainframe (00:00: prefix is
required).
An example for the site HIPPI-connected host is:
hip0 hippi crayhost1-hippi 00:00:01:00:00:04
hip0 hippi crayhost2-hippi 00:00:01:00:00:42
An example for the CNS HIPPI connected to the Cray mainframe via a HIPPI
modem is:
hip0 hippi crayhost-1 00:00:00:00:00:00
106 S–2366–16
HIPPI Network Configuration [B]
DEVICE=hip0
Identifies the name of the physical card in the CNS that will
be used to access the HIPPI network.
IPADDR=IP address
Identifies the CNS's IP address on the HIPPI network.
NETMASK=netmask
Identifies the HIPPI network's netmask.
MTU=30000 Identifies the maximum transmission unit (MTU) of the
HIPPI network, as viewed from the CNS.
Note: MTU values larger than 30000 are not supported.
ONBOOT=yes Indicates that this interface is to be initialized during CNS
initialization (during the boot process).
BOOTPROTO=none
Indicates that this interface is defined statically.
Note: The 30000 byte maximum transmission unit (MTU) does not require
changes to the MTU chosen for use by the Cray mainframe. However,
all UDP applications (for example, NFS) that will use the CNS as their
gateway must be configured to use a message size of 30000 bytes or less.
These applications can still use up to the Cray mainframe's HIPPI MTU
value when going Cray mainframe to Cray mainframe over HIPPI.
The MTU on the hip0 interface is set to 30000, as this appears to provide
the best throughput to the Cray mainframe going through the CNS.
The 30000 byte MTU is the only supported value. It was chosen based
on the results obtained during performance testing where the MTU was
varied between 16K and 64K.
S–2366–16 107
Cray Network Subsystem (CNS) Software Installation and Administration
Note: The definition of the CNS's own I-field in the static-arp file
might produce an error message, because loopback over the physical
HIPPI interface is not available. The error message indicates that the I-field
definition is not a valid MAC address for the loopback interface.
B.2.1 Configuration Requirements for the Cray Mainframe for GigaRing Systems
The Cray GigaRing mainframe HIPPI arp file (/etc/ghippi.arp) must be
updated to include the mapping of the CNS host name to its associated I-field.
This is required for the Cray mainframe to correctly route IP packets, which are
destined for the CNS HIPPI IP address through the HIPPI network.
For information about how to update the Cray mainframe's HIPPI arp file, see
UNICOS Networking Facilities Administrator's Guide or UNICOS/mk Networking
Facilities Administration, depending on your operating system.
B.3 Verification
At this point, the CNS should be able to communicate with the Cray mainframe
using TCP/IP.
You can use the ping command, from the Cray mainframe or the CNS, to verify
that IP access exists between them.
108 S–2366–16
Index
A hardware, 99
Accessing Cray documentation, 15 host interface, 19
Account network configuration requirements, 60
crayadm, 52 networking interface compatibility, 19
root, 50 platform description
Address resolution protocol (ARP) Dell 1650, 99
configuring a proxy, 66 Dell 2650, 101
arp file, 108 Dell 2850, 102
Automatic failover purpose, 45
configuration, 71 security, 49–50, 53
description, 48 software, 21
specialized function, 2, 45
B terminology, 3
Backup, 79 cns.conf file, 11, 60
bfc command, 17 cns_config backup command
bfc man page, 17 backup, 79
bondedfibrechannel man page, 17 cns_config restore command
Bonding restore, 79
configuration, 71 cns_gen_config command, 33
Fibre Channel IP description, 48 static routes, 60, 106
Books, 16 cns_rac command, 52, 54–55
accessing, 15 Compatibilities, 7
BOOTPROTO, defining, 107 networking interface, 19
system, 2
C Configuration
automatic failover, 71
CERT advisories, 54
backup, 79
CIT
bonded interface, 71
documentation, 16
CNS HIPPI interface, 105
CNS
CNS interface for FSS, 73
comparison to Cray L7R, 7
cns_gen_config, 33
compatibility, system, 2
default route to Cray X1 series mainframe, 64
configuration backup, 79
default route to GigaRing mainframe, 65
configuration, restore, 79
dynamic routing, 66
configuring HIPPI interface, 105
gated.conf default, 61
definition, 3
generating, 33
description, 2
new CNS, 33
features, 45
NTP, 59
firmware, 21
S–2366–16 109
Cray Network Subsystem (CNS) Software Installation and Administration
110 S–2366–16
Index
iptables, 53 O
ONBOOT, defining, 107
L Ordering
Letter of assurance, 22 documentation, 17
Licensing software, 22
CNS for Cray X1 series systems, 22
CNS for GigaRing systems, 22 P
Limitations, 11 password
after power failure, 13 RAC root, 52
cns_config, 11 Password
cns_gen_config, 11 changing RAC root, 55
PCI slot Ethernet card naming, 12 crayadm, 52
Proxy ARP not supported for IPv6, 14 initial, 34–35, 41
tcp_assist daemon not supported in IPv6, 14 resetting, 51
tcp_assistd, 12–13 root, 50
temporary directory cleanup, 14 PDF, 16
Logging, 54 ping command, 94–95, 97
Problems, 25
M Proxy ARP, configuring, 66
Maintenance port, 54 Publications, 15–16
setup and configuration, 80 accessing, 15
Maintenance port, CNS
configuration for Cray X1 series systems, 82 R
configuration for GigaRing systems, 83 racadm command, 54
setup, 80 Release package, 19, 21
Man page collections, 16 Remote Access Controller (RAC), 54
Man pages setup and configuration, 80
accessing, 15 subcommands, 56
Maximum transmission unit (MTU), setting, 107 Remote Access Controller (RAC), CNS
configuration for Cray X1 series systems, 82
N configuration for GigaRing systems, 83
netstat command, 94–95, 97 setup, 80
Network Request for Technical Assistance (RTA), 25–26
defining MTU, 107 Requirements
defining subnet mask, 107 for CNS network configuration
restrictions for CNS, 60 restrictions, 60
Network Time Protocol (NTP), 59 mainframe, 19
NTP Requirements for hardware and software, 19
See Network Time Protocol (NTP) Restore, 79
ntpd daemon, 59 Reverting to prior configuration, 42
route command, 98
Routing, 60
S–2366–16 111
Cray Network Subsystem (CNS) Software Installation and Administration
112 S–2366–16