Professional Documents
Culture Documents
Version 6.1
Contents
About This Guide
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Crossbeam Systems Product Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cautions, Warnings, and Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Crossbeam Systems Customer Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 5 5 6 6 7 8
Chapter 1: Introduction
Network Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Install Server System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Install sharutils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Crossbeam GPG Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Install nfs-utils, dhcp, tftp-server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Chapter 5: Troubleshooting
Troubleshooting the Install Server Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Intended Audience
This guide is intended for system integrators and other qualified service personnel responsible for installing, configuring, and managing the Crossbeam X-Series or C-Series Platforms.
Related Documentation
Crossbeam Systems Product Documentation
These documents are provided on the Crossbeam Systems Documentation DVD and are available on the Crossbeam Systems support Web site located at http://www.crossbeam.com/services/online_support.php.
Upgrading to the NPM-8600 X80 X-Series Platform Hardware Installation Guide X45 X-Series Platform Hardware Installation Guide XOS Configuration Guide COS Configuration Guide XOS Command Reference Guide RSW Installation Guide XOS V9.0 Release Notes Install Server Release Notes
Conventions
Typographical Conventions
For paragraph text conventions, see Table 1 on page 6. For command-line text conventions, see Table 2 on page 7.
>
From the taskbar, choose Start > Run. From the main menu, choose File > Save As... Right-click on the desktop and choose Arrange Icons By > Name from the pop-up menu.
Courier Bold Information that you must type in exactly as shown. <Courier Italic> Angle brackets surrounding Courier italic text indicate file names, folder names, command names, or other information that you must supply. Square brackets contain optional information that may be supplied with a command. Separates two or more mutually exclusive options. Braces contain two or more mutually exclusive options from which you must choose one.
[root@xxxxx]# md <your_folder_name>
[]
{}
Customer Support
Crossbeam Systems offers a variety of service plans designed to meet your specific technical support requirements. For information on purchasing a service plan for your organization, please contact your account representative or refer to http://www.crossbeam.com/support/technical-support/. If you have purchased a Crossbeam Systems product service plan and need technical assistance, you can report issues by telephone: United States: +1 800-331-1338 OR +1 978-318-7595 EMEA: + 33 4 8986 0400 (during normal working hours) +1 978-318-7595 (outside office hours and on public holidays, if applicable) Asia Pacific: +1 978-318-7595 Latin America: +1 978-318-7595 You can also report issues via e-mail to support@crossbeamsystems.com. In addition, all of our service plans include access to the Crossbeam online support Web site located at http://www.crossbeam.com/support/online-support/. The Crossbeam online support Web site provides you with access to a variety of resources, including Customer Support Knowledgebase articles, technical bulletins, product documentation, and release notes. You can also access our real-time problem reporting application, which lets you submit new technical support requests and view all your open requests. Crossbeam Systems also offers extensive customer training on all of its products. For current course offerings and schedules, please refer to the Crossbeam training and education Web site located at http://www.crossbeam.com/support/training-services/.
1
Introduction
You can use the Crossbeam Install Server to install and update XOS system software on Crossbeam X-Series Platforms. The Install Server streamlines the process of managing, installing, and updating XOS software. In order to use the Install Server effectively, you should be familiar with Red Had Enterprise Linux (RHEL) v5.x and CentOS v5.x, utilities such as YUM, and be able to perform downloads, installations, and upgrades using UNIX commands and the Crossbeam command line interface. With Install Server, you can:
Perform initial XOS installations Upgrade XOS versions on existing Crossbeam platforms Perform XOS installations and upgrades on multiple Crossbeam platforms Manage your inventory of XOS software versions
Crossbeam recommends that you permanently dedicate a Linux system to be the Install Server, especially if you are managing multiple X-Series Platforms, have systems at multiple sites, or if your system configurations are highly sensitive. This chapter contains the following sections:
Network Configuration
Figure 1 is an example of a simple Install Server network configuration. In this figure, the Install Server system has Internet connectivity, allowing YUM to automatically download and install utility packages necessary for Linux OS operation. The Install Server system has two network interface cards, and the target X-Series Platforms (systems on which XOS software will be installed or updated) are located on the same subnets as the Install Server. The Install Server provides each system with a diskless partition for installing the XOS operating system.
Figure 1.
Red Hat Enterprise Linux 5.1 or CentOS 5.2 installed A network interface card (at least one; Install Server supports multiple network interfaces) A network connection An IP address configured on the same subnet as the target X-Series Platforms A pool of static IP addresses to assign to each platform 500 MB of disk space per diskless partition (one partition for each target Crossbeam platform) 550 MB of disk space for each XOS software version 500 MB of disk space for the base Install Server installation
10
4.
You will need a console cable to connect a laptop computer to the Console connector on the CPM.
Install sharutils
You must install the sharutils package on the same system on which you are installing the Install Server. This package is necessary for Install Server installation and operation, and is not part of the automatic download.
2.
These packages are not installed on Red Hat Enterprise Linux 5.1 or CentOS 5.2 by default, but are required for correct operation of the Install Server. If the Install Server system does not have Internet connectivity, the system prompts you to download and install the packages manually. If these packages are not installed, the installation will fail. The following sections of this guide provide instructions on installing the Install Server software, and installing XOS software using the Install Server.
11
12
2
Installation and Use
This chapter describes how to install a new instance of Install Server, and includes the following sections:
Performing an Initial Install Server Installation Initial Install Server Installation Creating Diskless Partitions
If you are upgrading an existing Install Server installation, see Upgrading XOS and Install Server on page 20.
Figure 2.
13
After you have performed the initial installation, the Install Server proceeds directly to the creation of diskless partitions for installing XOS on Crossbeam platforms. Subsequent use of the Install Server does not automatically bring you to the steps for creating diskless partitions. Please refer to Before You Begin on page 11 for a list of prerequisites to the Install Server installation.
14
The information collected in the following questions is used to create a file system on the Install Server and provide the location of the target platform. The MAC, IP, and Default Gateway addresses are the configuration values for the target X-Series CPM or C-Series Platform. 4. Enter the information required by the system. NOTE: Use the Enter key to accept default values. Enter name of the diskless partition [integ1]: solaria Enter name of the Operating System (xos/cos) [XOS]: Enter MAC address of the diskless client [00:00:00:00:00:00]: xx:xx:xx:xx:xx:xx Enter IP address for the diskless client [172.16.19.101]: 172.16.19.31 Enter default gateway address for the diskless client [172.16.19.1]: The is-config tool starts creating the diskless partition after you enter the default gateway address. Each diskless partition is operating system-specific. For example, a diskless partition created for XOS can only be used for X-Series Platforms. Additionally, separate diskless partitions must be created for XOS 9.x. These partitions cannot be used for software versions other than XOS V9.x. NOTE: The diskless client must have an IP address in the same network as the Install Server. For example, if your Install Server has an IP address of 172.16.10.15, and netmask of 255.255.255.0, then the IP address for the diskless client must be in the 172.16.10.x subnet. /crossbeam/bin/cbs_manage_partitions add solaria XOS xx.xx.xx.xx.xx.xx 172.16.19.31 172.16.19.1 Action: Adding new partition solaria (root=/tftpboot/solaria) MAC address = xx.xx.xx.xx.xx.xx IP address = 172.16.19.31 Default Gateway = 172.16.19.1 Creating base directory /tftpboot/solaria The following XOS system software releases were found: 8.5.0-120 9.0.0-123 5. Choose the XOS software to install onto the diskless partition. Please choose one of system software releases for the new diskless partition [9.0.0-123]: Installing RPMs in the diskless partition, this may take a few minutes. The installation log is located in /tmp/install-solariaia.log. Found interface eth0 with IP address: 172.16.19.6 Creating /tftpboot/solaria/etc/fstab Adding /RPMS/XOS_System_Software to /tftpboot/solaria/etc/fstab Editing /etc/dhcpd.conf to support new diskless partition Restarting DHCP service ... Shutting down dhcpd: [ OK ] Starting dhcpd: [ OK ] Procedure for creating diskless partition is complete. If there are no warnings or errors messages, the diskless partition is ready for use. NOTE: To modify the MAC address and/or IP address, run the following: vi /etc/dhcpd.conf /etc/rc.d/init.d/dhcpd restart Add another diskless partition (y/n) ? [y]
15
6. 7.
Enter y to create another diskless partition for another target platform, or enter n to return to the Main Menu. After you have created a diskless partition for each target system, exit the Install Server and proceed to installing XOS on the target systems. To see the results of the diskless partition creation, review the log file /tmp directory: /tmp/install-${partition-name}.log
Proceed to the next section for instructions on using the configured Install Server to install and upgrade XOS software on your Crossbeam platforms.
16
3
Installing and Upgrading XOS
This chapter describes how to install or upgrade XOS on an X-Series Platform using an Install Server. It includes the following sections:
Installing XOS Using Install Server Installing XOS Using a Single Diskless Partition Upgrading XOS and Install Server
Upgrading the Install Server Software Updating XOS on the Install Server Upgrading an Existing Diskless Partition
Figure 3.
17
NOTE: XOS V9.x can only be installed onto a X-Series Platform with a CPM-8600 or above. After you have created the diskless partition and copied the XOS software to it, use the following steps to install the XOS software onto the X-Series Platforms on your network. IMPORTANT: You do not need to uninstall a previous version of XOS from the system before installing a new version. However, Crossbeam recommends that you back up or save configuration files to an external location. The first step of the install process re-partitions and reformats the CPM hard disk drive(s). 1. 2. Use the console connection on the CPM on which you will be installing XOS to start a CLI session and log in with administrative privileges. Back up the systems running configuration: CBS# copy running-config <file-name> The configuration file is stored by default at the following location: /tftpboot/.private/home/admin/<file-name> 3. 4. 5. Save the file to an external server (the Install Server, for example) to retrieve at a later time if necessary. Save the current configuration: CBS# copy running-config startup-config Switch to the UNIX prompt: CBS# unix su Password: [root@xxxxx]# 6. 7. 8. Reboot the CPM at the UNIX prompt: [root@xxxxx]# reboot At the spinning | prompt, press Esc Ctrl-R. From the system console, use the following command to boot the CPM: ROM> boot net The CPM will boot using the diskless partition image on the Install Server configured for this system, pausing at the user login prompt. 9. Login again as root. For XOS V9.x installations, a password is required (default is admin). Red Hat Enterprise Linux Server release 5.2 (Tikanga) Kernel 2.6.18-53.el5_64 on an x86_64 solaria login: root Password: admin Crossbeam Diskless Boot File System XOS: 9.0.0-123 [root@xxxxx]# 10. Use the install-xos command to install XOS_9.0.0-123. The following example uses the parameter /common/REL_9.0.0-123 to save the software packages to the directory REL_9.0.0-123. [root@xxxxx]# /crossbeam/bin/install-xos /common/REL_9.0.0-123 -q disk 1 and 2 present warning: /common/REL_9.0.0-123/crossbeam-xos-9.0.0-123.x86_64.rpm: Header V3 DSA signature: NOKEY, key ID 5fd665b1 WARNING:: This is a non-RAID CPM install and a second drive is present. To make the first drive bootable, we must rewrite the second drive's MBR. Respond 'y' to continue with the rewrite, respond 'n' to leave the MBR alone, or 'q' to quit the install and remove the drive. (y|n|q)? [y]:
18
<Installation messages were deleted from this example> GRUB setup Unmounting Unmounting Unmounting Unmounting Unmounting Unmounting is successful /tmp/cb_root/proc /dev/d1vg1/lv1 /dev/d1vg1/lv0 /dev/d1vg0/lv0 /dev/sda1 /dev/sda7
11. Reboot the CPM at the root prompt: [root@xxxxx]# reboot The XOS installation process completes. 12. Verify the installation by using the show version command to display the updated XOS version information on the CPM. CBS# show version Copyright (c) 2000-2009 by Crossbeam Systems, Inc. All rights reserved. Version: XOS 9.0.0 [Apr 15 2010 08:52:43] (bldmgr) CVS_Label: XOS-9_0_0_0-20100415_2 Kit_Number: 123 CPU at 1995 Mhz processor with 1024820K bytes of memory 0K bytes of memory in use Uptime is Unknown Hard disk is 100(GB) Second Hard disk is 100(GB) Flash is Unknown 13. Return to step 1 and repeat the process for additional target systems that you are installing XOS on.
19
[root@xxxxx]# /etc/rc.d/init.d/dhcpd restart 4. Follow the steps in Installing XOS Using Install Server on page 17 to complete the install.
Figure 4.
20
21
You may specify a different directory name. This directory will be created under /RPMS/XOS_System_Software directory. 6. Enter y to specify a different directory name for the System Software, or enter n to accept the default. Specify a different directory name for the System Software (y/n)? [n]: n The System Software Update Program is complete If there are no error messages or warnings, the Install Server is ready for use. The final step in the Install Server upgrade process is to upgrade the system software on the diskless partiton; see Step 2 on page 22.
7.
After the update process is complete, enter y to update additional diskless partitions, or enter n to exit the upgrade process. Upgrade another diskless partition (y/n)?[y] n The Diskless partitions Menu appears.
8.
To view the result of the diskless partition upgrade select 4 - Show diskless partitions status. Enter your Selection from options above <1-5, x> [5]: 4 The list of diskless partitions appears.
9.
Exit the Diskless Partitions Menu and the is-config tool. Enter your Selection from options above <1-5, x> [5]: x Use the procedure Installing XOS Using Install Server on page 17 to install the updated XOS version on the target Crossbeam platforms.
23
24
4
Managing the Install Server
This chapter describes how to manage and maintain the Install Server, diskless partitions, and software versions. The following are topics discussed in this chapter:
Manage Diskless Partitions (Add/Upgrade/Remove) Removing a Diskless Partition Migrate Install Server to new IP address Uninstall Install Server Software Downgrading the Install Server Software Show Install Server Status
Use the is-config tool and the Install Server Main Menu to select and perform each of the Install Server management tasks. The is-config tool is an interactive, menu-driven tool located in the /crossbeam/bin directory on the Install Server.
Select the option for the activity you want to perform. For more information on using these options, see:
Creating Diskless Partitions on page 14 Upgrading an Existing Diskless Partition on page 22 Removing a Diskless Partition on page 26
25
26
Enter your Selection from options above <1-6, x> [x]: 2. Enter option 2 - Manage XOS/COS System Software on Install Server. The System Software Menu appears. -------------------------------------------------------------System Software Menu -------------------------------------------------------------Please select one of the following options: 1) 2) 3) 4) x) 3. 4. 5. Update XOS/COS System Software on Install Server Show XOS/COS System Software on Install Server Remove XOS/COS System Software on Install Server Back to main menu Exit
Enter option 1 - Update XOS/COS System Software on Install Server Enter the software you want to update - XOS. Enter the location of the software using the menu choices. The System Software can be fetched from one of the sources below: 1) A System Software CD-ROM, or 2) A Software package in tar or "tar.gz" format. 3) A Software package in untared format. For option 2, you need to provide full path to the tar or "tar.gz" file. For option 3, you need to provide full path to the "System_Software" directory. Enter your Selection from options above <1-3> [1]: 2 Specify full path for the "tar.gz" or tar file: /central/software/repository/ XOS/Release/System_Software/XOS-system_software-ocode-A000-9.0.0-123.tar.gz
6.
Press Enter. Install Server begins the update process. Extracting System Software...
27
x) Exit Enter your Selection from options above <1-6, x> [x]: 6 -------------------------------------------------------------Install Server Status -------------------------------------------------------------Install Server Release installed: 6.1.0-1 -------------------------------------------------------------Platform Release Diskless partitions -------------------------------------------------------------XOS 8.1.0-4 titan XOS 8.5.0-120 moon XOS 8.5.0-120 pegasus XOS 9.0.0-123 solaria Press <Enter> to continue
29
30
5
Troubleshooting
Troubleshooting the Install Server Installation
During the Install Server installation you should be aware of the following:
DO NOT access the Install Server software from the DVD directly or change the mount point for the DVD drive with the DVD in the device. If you do, you will not be able to unmount or eject the DVD. If you are using X windows, a Gnome window may pop up when you insert a new DVD. If this occurs, close this window immediately or the script may have trouble unmounting the DVD. If the Install Server has multiple interfaces configured (for example, eth0, eth1), the install script cannot determine which IP network is providing the NFS services. The script displays these interfaces with their respective IP addresses, and prompts you to provide the IP address used for diskless booting. The specified interface must be in the same network as the diskless client. If you encounter a problem in the NFS mount, check the following:
If you are on a network, check the /etc/resolv.conf file on Install Server. The file should contain a nameserver entry and a domain or search entry for NFS to work correctly. The following is an example of a valid /etc/resolv.conf file: $ cat /etc/resolv.conf nameserver 10.1.1.50 nameserver 10.1.1.10 domain <ibsys.com> Where the first two entries are the IP addresses of nameservers queried in the given order, the third entry is the local domain name. To modify this file, use an editor such as vi, emacs, and so on. Please use the nameserver and domain values specific to your network configuration. If you do not have this information, consult your network administrator. For additional information about resolver, refer to the man page for resolv.conf by entering the following command: $ man resolv.conf
If you are using a standalone system with no nameserver or domain, set the option router IP address to the IP address of the Install Server interface connected to the diskless client. The /etc/resolv.conf, /etc/hosts and /etc/dhcpd.conf files should appear as follows: NOTE: In the example shown, 10.2.1.69 is the IP address of the Install Server interface connected with the diskless client. [root@xxxxx]# cat /etc/resolv.conf search localdomain [root@localhost root]# cat /etc/hosts # Do not remove the following line, or various # programs that require network functionality will # fail. 127.0.0.1 localhost.localdomain localhost [root@localhost root]# cat /etc/dhcpd.conf subnet 10.0.0.0 netmask 255.0.0.0 {
31
default-lease-time -1; option subnet-mask 255.0.0.0; } # # Diskless Boot partition added by # cbs_manage_partitions # For platforms running COS # host c25 { hardware ethernet 00:03:d2:10:19:11; fixed-address 10.2.1.2; filename "/tftpboot/c25/boot/pxelinux.0"; option host-name "c25"; option routers 10.2.1.69; }
If you suspect a firewall on your system is blocking UDP traffic, using the following commands to check the status of ipchains and iptables: chkconfig --list ipchains service ipchains status If the UDP traffic is blocked, add the host to the /etc/hosts.allow file. If this does not correct the problem, stop ipchains and iptables, or create a policy to allow tftp. Use the following command to turn off ipchains or iptables: chkconfig --level 2345 ipchains off For additional information about ipchains and iptables, refer to the following manpages: $ man ipchains or $ man iptables
32