LDP/LDP/howto/docbook/Compaq-Remote-Insight-Board.../Compaq-Remote-Insight-Board...

794 lines
22 KiB
Plaintext

<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<!-- ================================================= -->
<!--
$Id$
This is compaq-remote-insight-lights-out.sgml. It covers all
aspects related to use of Compaq Remote Insight Lights-Out Edition
cards with Linux.
$Log$
Revision 1.2 2001/04/30 22:33:35 gferg
updated
Revision 1.1 2001/04/26 16:34:57 gferg
new entry
Comments: Versions with "i" postfix are internal,
for review, versions without are public and
(supposed to be) released. The section marked
"Internal" are not supposed to show up in the
public releases.
-->
<!-- ================================================= -->
<article>
<!-- Header -->
<artheader>
<title>HOWTO Use a Compaq Remote Insight Lights Out Edition for a
Headless, Remote Linux Installation </title>
<author>
<firstname>Marc</firstname>
<surname>Nozell</surname>
<affiliation>
<OrgName>
Compaq Computer Corporation
</OrgName>
<address>
<email>marc.nozell@compaq.com</email>
</address>
</affiliation>
</author>
<revhistory>
<revision>
<revnumber>v1.1</revnumber>
<date>10 April 2002</date>
<authorinitials>MN</authorinitials>
<revremark>
Update for new Red Hat release, new RIB/LOE firmware
v2.41 release screenshots, add grub.conf suggestion,
misc cleanup of filenames/hostnames.
</revremark>
</revision>
<revision>
<revnumber>v1.0</revnumber>
<date>25 October 2000</date>
<authorinitials>MN</authorinitials>
<revremark>
Initial public release.
</revremark>
</revision>
</revhistory>
<abstract>
<para>
This document describes how to install Linux on a headless Compaq
ProLiant server with a Compaq Remote Insight Lights-Out Edition
card without physical access to the system. The installation
is done remotely through the use of a Java-enabled browser.
</para>
</abstract>
</artheader>
<!-- Section1: intro -->
<sect1 id="intro">
<title>Introduction</title>
<para>
This document is a quick guide which shows how to install Linux
on a remote, headless Compaq ProLiant system equipped with a
Compaq Remote Insight Lights-Out Edition (RIB/LOE) card without needing
physical access to the system.
</para>
<para>
This document further describes how to use a virtual floppy disk
for the initial install of Linux, and to setup an Apache server
to provide the distribution media for completing the
installation.
</para>
<sect2 id="acks">
<title>Trademarks</title>
<para>
Compaq, Compaq Insight Manager, ProLiant, are registered with
the United States Patent and Trademark office.
</para>
<para>
Microsoft, Windows, Windows NT are trademarks and/or registered
trademarks of Microsoft Corporation.
</para>
<para>
Red Hat is a trademark of Red Hat, Inc., in the United States
and other countries.
</para>
<para>
SuSE is a trademark of SuSE GmbH.
</para>
<para>
Linux is a registered trademark of Linus Torvalds.
</para>
<para>
Other product names mentioned herein may be trademarks and/or
registered trademarks of their respective companies.
</para>
</sect2>
<sect2>
<title>Feedback</title>
<para>
Feedback will make this HOWTO more useful. If you have
any suggestions, corrections, or comments, send them to
marc.nozell@compaq.com
</para>
</sect2>
<sect2>
<title>Distribution Policy</title>
<para>
Copyright (c) 2000-2002 Compaq Computer Corporation.
</para>
<para>
The information in this publication is subject to change without notice
and is provided "AS IS" WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK
ARISING OUT OF THE USE OF THIS INFORMATION REMAINS WITH RECIPIENT. IN
NO EVENT SHALL COMPAQ BE LIABLE FOR ANY DIRECT, CONSEQUENTIAL,
INCIDENTAL, SPECIAL, PUNITIVE OR OTHER DAMAGES WHATSOEVER (INCLUDING
WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS
INTERRUPTION OR LOSS OF BUSINESS INFORMATION), EVEN IF COMPAQ HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
</para>
<para>
The limited warranties for Compaq products are exclusively set forth in
the documentation accompanying such products. Nothing herein should be
construed as constituting a further or additional warranty.
</para>
<para>
This publication does not constitute an endorsement of the product or
products that were tested. The configuration or configurations tested
or described may or may not be the only available solution. This test
is not a determination or product quality or correctness, nor does it
ensure compliance with any federal, state, or local requirements.
</para>
<para>
This document may be distributed under the terms set forth in
the LDP license at <ulink url="http://sunsite.unc.edu/LDP/COPYRIGHT.html"> sunsite.unc.edu/LDP/COPYRIGHT.html</ulink>.
</para>
<para>
This HOWTO is free documentation; you can redistribute it
and/or modify it under the terms of the Linux Document Project
(LDP) license. This document is distributed in the hope that
it will be useful, but <emphasis>without any
warranty</emphasis>; without even the implied warranty of
<emphasis>merchantability</emphasis> or <emphasis>fitness for
a particular purpose</emphasis>. See the LDP license for more
details.
</para>
</sect2>
<!-- ====================================================== -->
</sect1>
<sect1>
<title>Compaq Remote Insight Lights-Out Background</title>
<para>
The Remote Insight Lights-Out is an optional management PCI card
with a dedicated LAN connection. It provides full access and
control of servers even when the server is in a failed state.
</para>
<sect2 id="features">
<title>Key Features</title>
<para>
The key features of the Remote Insight Lights-Out card:
<itemizedlist>
<listitem>
<para>
Self-contained with on-board processor, memory, NIC, and ROM
</para>
</listitem>
<listitem>
<para>
External power adapter ensures continuous server access
</para>
</listitem>
<listitem>
<para>
Enables 'headless' server deployments in data centers
</para>
</listitem>
<listitem>
<para>
Virtual Floppy Drive allows host server to remotely boot
from a standard 1.44 MB floppy diskette in a network
client, enabling remote OS installation from a network
drive, and remote server ROM updates
</para>
</listitem>
<listitem>
<para>
Full control of your server with browser-based,
virtual graphical remote console
</para>
</listitem>
<listitem>
<para>
No additional software required for Compaq ProLiant
servers - the client just requires a browser that
supports Java.
</para>
</listitem>
<listitem>
<para>
Virtual Power Button provides full control of remote
server power state - turn your server on or off remotely
</para>
</listitem>
<listitem>
<para>
Remote Reboot allows cold reboot when system is not
responding.
</para>
</listitem>
<listitem>
<para>
SSL encryption of HTTP data before transmitting over the
network
</para>
</listitem>
<listitem>
<para>
Dedicated, low-bandwidth network connection provides
secure access over LAN
</para>
</listitem>
<listitem>
<para>
Group administration for user accounts
</para>
</listitem>
</itemizedlist>
</para>
<para>
To get more information about the Remote Insight Lights-Out
Edition see the Compaq web page
at <ulink url="http://www.compaq.com/lights-out">
http://www.compaq.com/lights-out</ulink>
</para>
</sect2>
</sect1>
<sect1>
<title>Linux Installation using a Remote Insight Lights-Out</title>
<para>
After you have installed the card into the server system you will
need to set up a Linux distribution repository, build and download
a special boot floppy, and drive the installation through a
browser.
</para>
<sect2>
<title>Hardware Installation</title>
<para>
The first step is to install the Remote Insight Lights-Out
Edition card in a Compaq ProLiant Server and configure it for
network access. Using DHCP is the easiest way to get the
Remote Insight Lights-Out card on the network.
</para>
</sect2>
<sect2>
<title>Setting up a Linux Distribution Point</title>
<para>
On another server, make the contents of the
Red Hat installation CD available via HTTP or FTP. For this
example, the server is named disto.OUR-LAB.com and HTTP is
used.
</para>
<para>
Copy the entire CD to the local hard disk and give appropriate
file protections to allow the web server to read it. For Red
Hat V6.2, use the following commands.
<programlisting>
# mount -t iso9660 -o ro /dev/cdrom /mnt/cdrom
# mkdir /usr/src/distros/RH62
# (cd /mnt/cdrom && tar cf - . ) | (cd /usr/src/RHCD && tar xvfp - )
# umount /mnt/cdrom
# chmod +x -R /usr/src/distros/RH62
</programlisting>
Red Hat V7.0 and later versions contain two binary
distribution CDs, so both need to be copied into the same
directory structure. This example shows the steps for Red Hat
7.2. Put the first binary distribution CD into the drive and
as above use the following commands:
<programlisting>
# mount -t iso9660 -o ro /dev/cdrom /mnt/cdrom
# mkdir /usr/src/distros/RH72
# (cd /mnt/cdrom && tar cf - . ) | (cd /usr/src/distros/RH72 && tar xvfp - )
# umount /mnt/cdrom
</programlisting>
Then put the second binary distribution CD into the drive and
issue the following commands.
<programlisting>
# mount -t iso9660 -o ro /dev/cdrom /mnt/cdrom
# mkdir /usr/src/distros/RH72
# (cd /mnt/cdrom && tar cf - . ) | (cd /usr/src/distros/RH72 && tar xvfp - )
# umount /mnt/cdrom
# chmod +x -R /usr/src/distros/RH72
</programlisting>
</para>
<para>
Edit httpd.conf to add the following lines near the section
wehre other Aliases are defined. The location of the
configuration file varies. On a default Red Hat system, it is
in <filename>/etc/httpd/httpd.conf</filename>. If the Apache
server was installed from sources using the default location,
it is in
<filename>/usr/local/apache/conf/httpd.conf</filename>. You
can also try <command>locate httpd.conf</command> to find it.
<programlisting>
&lt;Directory /usr/src/distros/&gt;
Options Indexes
AllowOverride all
&lt;/Directory&gt;
Alias /distros /usr/src/distros
</programlisting>
</para>
<para>
Restart the Apache server. If you are still running the
default Apache shipped with Red Hat, do this:
<programlisting>
# /etc/rc.d/init.d/httpd restart
</programlisting>
</para>
<para>
Other Linux distributions may put the Apache Web Server
startup script in a different place.
</para>
<para>
The location of apachectl may vary; find it with
<command>locate apachectl</command>. If you installed
the Apache server yourself, you may want to use apachectl.
If you used the Apache default file locations, it would be
the following.
<programlisting>
# /usr/local/apache/bin/apachectl restart
</programlisting>
</para>
<para>
Verify that the Red Hat content is available:
<programlisting>
# lynx http://distro.OUR-LAB.com/distros
</programlisting>
</para>
</sect2>
<sect2>
<title>Creating a Virtual Floppy Disk</title>
<para>
Create a special Red Hat boot floppy that can perform a network
installation. The file from the Red Hat CD is in
<filename>images/bootnet.img</filename>;in this example,
<filename>/usr/src/distros/RH72/images/bootnet.img</filename> or
<filename>http://distro.OUR-LAB.com/distros/RH72/images/bootnet.img</filename>.
Other distributions can also install across the network using
similar steps.
</para>
<para>
From a Linux or UNIX system follow these steps.
Put a floppy in the drive.
<programlisting>
# dd if=/usr/src/distros/RH72/images/bootnet.img of=/dev/fd0 bs=1440k
</programlisting>
</para>
<para>
Take that special boot floppy to a Microsoft Windows system
that has the <filename>CPQIMAGE</filename> program to build an
IMG file from a floppy to be uploaded to the Compaq Remote
Insight Lights-Out card. This is the only step that requires
the use of a Microsoft platform. The
<filename>CPQIMAGE</filename> program is not available on any
other platform.
</para>
<para>
The <filename>CPQIMAGE</filename> program for Microsoft
Windows 95/98/NT 4.0/2000 is available for download from
<ulink
url="http://www.compaq.com/manage/lightsout-downloads.html">
http://www.compaq.com/manage/lightsout-downloads.html</ulink>.
Choose the "Diskette Image Utility" download.
</para>
<para>
Build a file named <filename>redhat-bootnet.img</filename>
using that Windows-based application. Note for multi-system
installations, this file can be reused or simply provided to
the customer.
</para>
</sect2>
<sect2>
<title>Downloading a Virtual Floppy Disk to the Server</title>
<para>
Now that a special version of the
<filename>bootnet.img</filename> has been created, it needs to
be loaded into the Virtual Floppy Disk on the Remote Insight
Lights-Out card.
</para>
<para>
<orderedlist>
<listitem>
<para>
Connect to the Remote Insight Lights-Out card of the Linux
system from a Java-enabled browser (Netscape, MSIE) using the
URL https://XX.XX.XX.XX where the X's are the IP address
assigned to the card. You can use a Linux system running
Netscape or a Windows system running Netscape or Microsoft
Internet Explorer. Just have the
<filename>redhat-bootnet.img</filename> local to the system
running the browser. Note that this special image file is
larger than a regular 1.44MB floppy. Note: You may want to use
FTP to move the file to the system that you will run the
browser on.
</para>
</listitem>
<listitem>
<para>
Log in to the Remote Insight Lights-Out card by using a web
browser to connect to the IP address assigned to the card.
</para>
</listitem>
<listitem>
<para>
Select the "Insert Virtual Floppy" from the web interface,
link (on left near the bottom) and load the
<filename>redhat-bootnet.img</filename> file you just created
into the virtual floppy.
<figure>
<title>Uploading bootnet floppy image</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/upload-bootnet.eps" scale="50"
scalefit="1" format="eps">
</imageobject>
<imageobject>
<imagedata fileref="images/upload-bootnet.jpg" format="jpg">
</imageobject>
<textobject>
<phrase>Image of uploading a floppy image to the Virtual Floppy</phrase>
</textobject>
<caption><para>Uploading a floppy image to the Virtual Floppy</para></caption>
</mediaobject>
</figure>
</para>
</listitem>
<listitem>
<para>
Select the "Virtual Floppy Boot Option" of 'Boot Once'
in the "Virtual Floppy Status" section.
<figure>
<title>Virtual Floppy Boot Once Dialog</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/virtual-floppy-bootonce-dialog.eps"
scale="50" scalefit="1" format="eps">
</imageobject>
<imageobject>
<imagedata fileref="images/virtual-floppy-bootonce-dialog.jpg"
format="jpg">
</imageobject>
<textobject>
<phrase>Image of Virtual Floppy Options</phrase>
</textobject>
<caption><para>Image of Virtual Floppy Options</para></caption>
</mediaobject>
</figure>
</para>
</listitem>
</orderedlist>
</para>
</sect2>
<sect2>
<title>Power on and Booting</title>
<para>
Now the system is ready to be powered. From the browser, click
on the 'Virtual Power Button' and power on the server.
<orderedlist>
<listitem>
<para>
Turn on the virtual console by selecting 'Remote Console (2-cursor) under
the "Remote Console" section. This starts a Java applet
that will show you exactly what is being displayed on the
console, for example, the memory self check, BIOS startup,
SCSI probe, etc. If you have a Compaq SmartArray card, you
can click on the button to send an
<keycode>F10</keycode> keypress.
<figure>
<title>BIOS bootup</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/bios-boot.eps"
scale="50" format="eps">
</imageobject>
<imageobject>
<imagedata fileref="images/bios-boot.jpg" format="jpg">
</imageobject>
<textobject>
<phrase>Image browser showing memory check during BIOS boot</phrase>
</textobject>
<caption><para>Browser window showing memory check during BIOS boot</para></caption>
</mediaobject>
</figure>
</para>
</listitem>
<listitem>
<para>
Enter "text" for a non-GUI installation method at the boot: prompt.
The graphical interface would work also, but it is
slower over the network.
</para>
</listitem>
<listitem>
<para>
Follow the Red Hat installation. When it gets to the place
where it asks for where the distribution media location
(CDROM, HardDrive, HTTP, NFS, FTP), select 'HTTP'.
<figure>
<title>Red Hat bootup</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/redhat-boot.eps" scale="50" scalefit="1"
format="eps">
</imageobject>
<imageobject>
<imagedata fileref="images/redhat-boot.jpg"
format="jpg">
</imageobject>
<textobject>
<phrase>Image of Red Hat install in text mode</phrase>
</textobject>
<caption><para>Red Hat text-based installation</para></caption>
</mediaobject>
</figure>
</para>
</listitem>
<listitem>
<para>
Put the name of the web server with the Red Hat distribution
for the hostname, in this example, distro.OUR-LAB.com. The
directory for this example is <filename>/rh</filename>. If you didn't previously
specify a DNS server in the TCP/IP configuration step prior to
this, you can use the IP address of the system serving the
distribution.
<figure>
<title>Red Hat bootup</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/redhat-http-setup.eps" scale="50"
format="eps">
</imageobject>
<imageobject>
<imagedata fileref="images/redhat-http-setup.jpg" format="jpg">
</imageobject>
<textobject>
<phrase>Image of selecting HTTP based installation</phrase>
</textobject>
<caption><para>Selecting HTTP based installation</para></caption>
</mediaobject>
</figure>
</para>
</listitem>
<listitem>
<para>
Proceed with a normal Red Hat installation.
</para>
</listitem>
<listitem>
<para>
Skip the configuration of the X server when it gets to the X11
configuration step.
</para>
<para>
If you want to run a graphical interface on your server
system, it can be configured later using
<filename>Xconfigurator</filename> or
<filename>xf86config</filename>. Compaq suggests that the
server resolution be set to 640x480 at 16-bit color depth
and mouse acceleration to be 1x.
</para>
</listitem>
<listitem>
<para>
Proceed with a normal Red Hat installation. Note that there
is a 15 minute timeout for the Remote Console, if your Red Hat
installation takes longer than that you may be disconnected
from the Remote Console. If this happens, simply reconnect to
the URL https://XX.XX.XX.XX, where the X's are the IP address
assigned to the card, and continue from where you left off.
</para>
</listitem>
</orderedlist>
</para>
</sect2>
<sect2>
<title>Post-installation configuration</title>
<para>
The default configuration for the grub bootloader that Red Hat
7.2 installs goes into graphics mode for the boot selection.
While the Remote Console will work properly, it looks nicer if
there is no splash image. To do this, edit /etc/grub.conf and
remove or comment out the line that looks like:
<programlisting>
splashimage=(hd0,1)/grub/splash.xpm.gz
</programlisting>
and add the following line:
<programlisting>
terminal --dumb --timeout=3 console
</programlisting>
</para>
</sect2>
</sect1>
</article>
<!-- ================================================= -->
<!-- end of compaq-remote-insight-lights-out.sgml -->
<!--
Local Variables:
mode: sgml
End: -->
<!-- ================================================= -->