IBM WebSphere DataPower XC10 User manual

WebSphere®DataPower XC10
First Edition
Installation Guide


WebSphere®DataPower XC10
First Edition
Installation Guide


Note
Before using this information and the product it supports, read the information in “Safety” on page v and, if necessary, the
language-specific information for your locale in IBM Systems Safety Notices, G229-9054-01.
Before using this information and the product it supports, read the information in “Notices” on page 27.
First Edition (June 2010)
This edition applies to IBM WebSphere DataPower XC10 until otherwise indicated in new editions.
© Copyright IBM Corporation 2010.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.

Contents
Safety ...............v
Guidelines for servicing electrical equipment . . . vi
Inspecting for unsafe conditions .......vii
Safety statements ............viii
Danger notices ............ix
Caution notices ............x
Labels ...............xiii
Preface ..............xv
Who should read this document .......xv
How this document is organized .......xv
Related documents ............xv
The Documentation CD ..........xvi
Hardware and software requirements ....xvi
Using the Documentation CD .......xvi
Available documents ..........xvii
Warranty information ..........xvii
Notices and conventions .........xvii
Typeface conventions ..........xviii
Chapter 1. Introduction ........1
Specifications and features..........1
Specifications .............1
Features ...............1
Components ..............2
Front view ..............2
Rear view ..............4
Chapter 2. Preparing for installation . . 7
Skills required ..............7
Information required ...........7
Rack requirements ............7
Tool and supplies .............8
What you need to use WebSphere DataPower XC10 . 8
User interface requirements .........9
Installation overview ...........11
Chapter 3. Installing the appliance in a
rack ................13
Installing rails in the rack frame .......13
Securing the appliance in the rack .......15
Connecting the appliance to an AC power source. . 17
Connecting the appliance to the network ....17
Chapter 4. Setting up the initial
firmware configuration ........19
Requirements..............19
Hardware requirement .........19
Information requirements.........19
Consideration for password to xcadmin account . . 20
Connecting the serial cable to the appliance . . . 20
Initializing the appliance ..........21
Verifying the configuration with the user interface 21
Completing the configuration ........22
Appendix. Getting help and technical
assistance .............23
Searching knowledge bases .........23
Receiving automatic updates ........23
Receiving updates through My support ....23
Receiving updates through RSS feeds.....24
Getting a fix ..............24
Contacting IBM Support ..........25
Notices ..............27
Electronic emission notices .........27
Federal Communications Commission (FCC)
statement ..............27
Industry Canada Compliance Statement ....28
Avis de conformité à la réglementation
d'Industrie Canada ...........28
United Kingdom telecommunications safety
requirement .............28
European Union EMC Directive conformance
statement ..............28
Japanese Voluntary Control Council for
Interference (VCCI) statement .......29
Taiwanese Class A warning statement ....29
Chinese Class A warning statement .....29
Korean Class A warning statement .....29
Russian Class A warning statement .....30
Trademarks ..............30
© Copyright IBM Corp. 2010 iii

iv IBM WebSphere DataPower XC10: Installation Guide

Safety
Before installing this product, read the Safety Information.
Arabic
Brazilian Portuguese
Antes de instalar este produto, leia as Informações de Segurança.
Chinese (simplified)
Chinese (traditional)
Croatian
Czech
Pred instalací tohoto produktu si prectete prírucku bezpecnostních instrukcí.
Danish
Læs sikkerhedsforskrifterne, før du installerer dette produkt.
Dutch
Lees voordat u dit product installeert eerst de veiligheidsvoorschriften.
Finnish
Ennen kuin asennat tämän tuotten, lue turvaohjeet kohdasta Safety
Information.
French
Avant d'installer ce produit, lisez les consignes de sécurité.
German
Vor der Installation dieses Produkts die Sicherheitshinweise lesen.
Greek
Hebrew
Hungarian
Italian
Prima di installare questo prodotto, leggere le Informazioni sulla Sicurezza.
Japanese
Korean
Macedonian
© Copyright IBM Corp. 2010 v

Norwegian
Les sikkerhetsinformasjonen (Safety Information) før du installerer dette
produktet.
Polish
Portuguese
Antes de instalar este produto, leia as Informações sobre Segurança.
Russian
Slovak
Slovenian
Pred namestitvijo tega proizvoda preberite Varnostne informacije.
Spanish
Antes de instalar este producto, lea la información seguridad.
Swedish
Läs säkerhetsinformationen innan du installerar den här produkten.
Guidelines for servicing electrical equipment
Observe the following guidelines when servicing electrical equipment:
vCheck the area for electrical hazards such as moist floors, non-grounded power
extension cords, and missing safety grounds.
vUse only approved tools and test equipment. Some hand tools have handles that
are covered with a soft material that do not provide insulation from live
electrical current.
vRegularly inspect and maintain your electrical hand tools for safe operational
condition. Do not use worn or broken tools or testers.
vDo not touch the reflective surface of a dental mirror to a live electrical circuit.
The surface is conductive and can cause personal injury or equipment damage if
it touches a live electrical circuit.
vSome rubber floor mats contain small conductive fibers to decrease electrostatic
discharge. Do not use this type of mat to protect yourself from electrical shock.
vDo not work alone under hazardous conditions or near equipment that has
hazardous voltages.
vLocate the emergency power-off (EPO) switch, disconnecting switch, or electrical
outlet so that you can turn off the power quickly in the event of an electrical
accident.
vDisconnect all power before you perform a mechanical inspection, work near
power supplies, or remove or install main units.
vBefore you work on the equipment, disconnect the power cord. If you cannot
disconnect the power cord, have the customer power-off the wall box that
supplies power to the equipment and lock the wall box in the off position.
vNever assume that power has been disconnected from a circuit. Check it to
make sure that it has been disconnected.
vIf you have to work on equipment that has exposed electrical circuits, observe
the following precautions:
vi IBM WebSphere DataPower XC10: Installation Guide

– Make sure that another person who is familiar with the power-off controls is
near you and is available to turn off the power if necessary.
– When you are working with powered-on electrical equipment, use only one
hand. Keep the other hand in your pocket or behind your back to avoid
creating a complete circuit that could cause an electrical shock.
– When using a tester, set the controls correctly and use the approved probe
leads and accessories for that tester.
– Stand on a suitable rubber mat to insulate you from grounds such as metal
floor strips and equipment frames.
vUse extreme care when measuring high voltages.
vTo ensure proper grounding of components such as power supplies, pumps,
blowers, fans, and motor generators, do not service these components outside of
their normal operating locations.
vIf an electrical accident occurs, use caution, turn off the power, and send another
person to get medical aid.
Inspecting for unsafe conditions
Use this information to help you identify potential unsafe conditions in an IBM®
product that you are working on.
Each IBM product, as it was designed and manufactured, has required safety items
to protect users and service technicians from injury. The information in this section
addresses only those items. Use good judgment to identify potential unsafe
conditions that might be caused by attachment of non-IBM features or options that
are not addressed in this section. If you identify an unsafe condition, you must
determine how serious the hazard is and whether you must correct the problem
before you work on the product.
Consider the following conditions and the safety hazards that they present:
vElectrical hazards, especially primary power. Primary voltage on the frame can
cause serious or fatal electrical shock.
vExplosive hazards, such as a damaged CRT face or a bulging capacitor.
vMechanical hazards, such as loose or missing hardware.
To inspect the product for potential unsafe conditions, complete the following
steps:
1. Make sure that the power is off and the power cords are disconnected.
2. Make sure that the exterior cover is not damaged or broken, and observe any
sharp edges.
3. Check the power cords:
vMake sure that the third-wire ground connector is in good condition. Use a
meter to measure third-wire ground continuity for 0.1 ohm or less between
the external ground pin and the frame ground.
vMake sure that the power cords are the correct type.
vMake sure that the insulation is not frayed or worn.
4. Check for pinched cables.
Safety vii

Safety statements
The statements in this section are the statements that apply to the WebSphere
DataPower XC10 appliance. These statements are the exact same safety information
that the IBM Systems Safety Notices document provides. However, the IBM Systems
Safety Notices document provides the complete list of all of the safety notices for
IBM Systems.
You can access the IBM Systems Safety Notices document on the IBM WebSphere
DataPower XC10: Documentation CD.
viii IBM WebSphere DataPower XC10: Installation Guide

Danger notices
DANGER
When working on or around the system, observe the following precautions:
Electrical voltage and current from power, telephone, and communication
cables are hazardous. To avoid a shock hazard:
vConnect power to this unit only with the IBM provided power cord. Do not
use the IBM provided power cord for any other product.
vDo not open or service any power supply assembly.
vDo not connect or disconnect any cables or perform installation,
maintenance, or reconfiguration of this product during an electrical storm.
vThe product might be equipped with multiple power cords. To remove all
hazardous voltages, disconnect all power cords.
vConnect all power cords to a properly wired and grounded electrical outlet.
Ensure that the outlet supplies proper voltage and phase rotation according
to the system rating plate.
vConnect any equipment that will be attached to this product to properly
wired outlets.
vWhen possible, use one hand only to connect or disconnect signal cables.
vNever turn on any equipment when there is evidence of fire, water, or
structural damage.
vDisconnect the attached power cords, telecommunications systems,
networks, and modems before you open the device covers, unless
instructed otherwise in the installation and configuration procedures.
vConnect and disconnect cables as described in the following procedures
when installing, moving, or opening covers on this product or attached
devices.
To disconnect:
1. Turn off everything (unless instructed otherwise).
2. Remove the power cords from the outlets.
3. Remove the signal cables from the connectors.
4. Remove all cables from the devices.
To connect:
1. Turn off everything (unless instructed otherwise).
2. Attach all cables to the devices.
3. Attach the signal cables to the connectors.
4. Attach the power cords to the outlets.
5. Turn on the devices.
vSharp edges, corners and joints may be present in and around the system.
Use care when handling equipment to avoid cuts, scrapes and pinching.
(D005)
Safety ix

Caution notices
CAUTION:
The battery contains lithium. To avoid possible explosion, do not burn or charge
the battery.
vDo not throw or immerse into water
vDo not heat to more than 100° C (212° F)
vDo not repair or disassemble
Exchange only with the IBM-approved part. Recycle or discard the battery as
instructed by local regulations. In the United States, IBM has a process for the
collection of this battery. For information, call 1-800-426-4333. Have the IBM part
number for the battery unit available when you call. (C003)
CAUTION:
This part or unit is heavy but has a weight smaller than 18 kg (39.7 lb). Use care
when lifting, removing, or installing this part or unit. (C008)
xIBM WebSphere DataPower XC10: Installation Guide

Use the following general safety information for all rack-mounted devices.
DANGER
Observe the following precautions when working on or around your IT rack
system:
vHeavy equipment — personal injury or equipment damage might result if
mishandled.
vAlways lower the leveling pads on the rack cabinet.
vAlways install stabilizer brackets on the rack cabinet.
vTo avoid hazardous conditions due to uneven mechanical loading, always
install the heaviest devices in the bottom of the rack cabinet. Always install
servers and optional devices starting from the bottom of the rack cabinet.
vRack-mounted devices are not to be used as shelves or work spaces. Do not
place objects on top of rack-mounted devices.
vEach rack cabinet might have more than one power cord. Be sure to
disconnect all power cords in the rack cabinet when directed to disconnect
power during servicing.
vConnect all devices installed in a rack cabinet to power devices installed in
the same rack cabinet. Do not plug a power cord from a device installed in
one rack cabinet into a power device installed in a different rack cabinet.
vAn electrical outlet that is not correctly wired could place hazardous
voltage on the metal parts of the system or the devices that attach to the
system. It is the responsibility of the customer to ensure that the outlet is
correctly wired and grounded to prevent an electrical shock.
(R001 part 1 of 2)
CAUTION:
vDo not install a unit in a rack where the internal rack ambient temperatures
will exceed the manufacturer’s recommended ambient temperature for all your
rack-mounted devices.
vDo not install a unit in a rack where the air flow is compromised. Ensure that
air flow is not blocked or reduced on any side, front, or back of a unit used
for air flow through the unit.
vConsideration should be given to the connection of the equipment to the
supply circuit so that overloading of the circuits does not compromise the
supply wiring or overcurrent protection. To provide the correct power
connection to a rack, refer to the rating labels located on the equipment in the
rack to determine the total power requirement of the supply circuit.
v(For sliding drawers) Do not pull out or install any drawer or feature if the rack
stabilizer brackets are not attached to the rack. Do not pull out more than one
drawer at a time. The rack might become unstable if you pull out more than
one drawer at a time.
v(For fixed drawers) This drawer is a fixed drawer and must not be moved for
servicing unless specified by the manufacturer. Attempting to move the
drawer partially or completely out of the rack might cause the rack to become
unstable or cause the drawer to fall out of the rack.
(R001 part 2 of 2)
Safety xi

CAUTION:
Removing components from the upper positions in the rack cabinet improves
rack stability during relocation. Follow these general guidelines whenever you
relocate a populated rack cabinet within a room or building:
vReduce the weight of the rack cabinet by removing equipment starting at the
top of the rack cabinet. When possible, restore the rack cabinet to the
configuration of the rack cabinet as you received it. If this configuration is not
known, you must observe the following precautions:
– Remove all devices in the 32U position and above.
– Ensure that the heaviest devices are installed in the bottom of the rack
cabinet.
– Ensure that there are no empty U-levels between devices installed in the
rack cabinet below the 32U level.
vIf the rack cabinet you are relocating is part of a suite of rack cabinets, detach
the rack cabinet from the suite.
vInspect the route that you plan to take to eliminate potential hazards.
vVerify that the route that you choose can support the weight of the loaded
rack cabinet. Refer to the documentation that comes with your rack cabinet for
the weight of a loaded rack cabinet.
vVerify that all door openings are at least 760 x 230 mm (30 x 80 in.).
vEnsure that all devices, shelves, drawers, doors, and cables are secure.
vEnsure that the four leveling pads are raised to their highest position.
vEnsure that there is no stabilizer bracket installed on the rack cabinet during
movement.
vDo not use a ramp inclined at more than 10 degrees.
vWhen the rack cabinet is in the new location, complete the following steps:
– Lower the four leveling pads.
– Install stabilizer brackets on the rack cabinet.
– If you removed any devices from the rack cabinet, repopulate the rack
cabinet from the lowest position to the highest position.
vIf a long-distance relocation is required, restore the rack cabinet to the
configuration of the rack cabinet as you received it. Pack the rack cabinet in
the original packaging material, or equivalent. Also lower the leveling pads to
raise the casters off of the pallet and bolt the rack cabinet to the pallet.
(R002)
xii IBM WebSphere DataPower XC10: Installation Guide

Labels
DANGER
Hazardous voltage, current, or energy levels are present inside any component
that has this label attached. Do not open any cover or barrier that contains
this label. (L001)
Safety xiii

xiv IBM WebSphere DataPower XC10: Installation Guide

Preface
IBM WebSphere DataPower XC10 is a drop-in caching appliance allows you to use
fast, simple and elastic data caching in a variety of scenarios. You can connect
multiple appliances in a collective to increase scalability and improve ease of
management. With the monitoring capabilities, you can visualize the performance
of your cache.
Who should read this document
This document is intended for lab personnel who are responsible for the following
activities:
vInstalling rails in the rack frame for the WebSphere DataPower XC10 appliance
vInstalling a WebSphere DataPower XC10 appliance in the rack
vPerforming the base, initial configuration of a WebSphere DataPower XC10
appliance
How this document is organized
This document has the following organization:
vSafety
Provides safety information for the WebSphere DataPower XC10 appliance.
vChapter 1, “Introduction”
Provides the features and specifications for the WebSphere DataPower XC10
appliance.
vChapter 2, “Preparing for installation”
Provides information about the rack, required tools, and the installation
overview.
vChapter 3, “Installing the appliance in a rack”
Provides instructions for installing the rails in the rack, inserting the appliance in
the rack, connecting the appliance to power, and connecting the appliance to the
network.
vChapter 4, “Setting up the initial firmware configuration”
Provides instructions for defining the base, initial firmware configuration.
v“Getting help and technical assistance”
Provides information about getting support.
Related documents
The documentation in the IBM WebSphere DataPower XC10: Information Center is
referenced by this document, but it is not on the IBM WebSphere DataPower XC10:
Documentation CD. You can find the IBM WebSphere DataPower XC10: Information
Center at the following location:
http://publib.boulder.ibm.com/infocenter/wdpxc/v1r0/index.jsp
© Copyright IBM Corp. 2010 xv

The Documentation CD
The IBM WebSphere DataPower XC10: Documentation CD contains documentation for
your DataPower XC10 appliance in Portable Document Format (PDF). This CD
includes the documents listed in the “Available documents” on page xvii section
and includes the IBM Documentation Browser to help you find information
quickly.
Hardware and software requirements
The IBM WebSphere DataPower XC10: Documentation CD requires the following
minimum hardware and software:
vMicrosoft®Windows®XP, Windows 2000, or Red Hat Linux®
v100 MHz microprocessor
v32 MB RAM
vAdobe®Acrobat Reader 3.0 (or later) or xpdf, which comes with Linux operating
systems
Using the Documentation CD
Use the Documentation Browser to browse the contents of the CD, read brief
descriptions of the documents, and view documents, using Adobe Acrobat Reader
or xpdf. The Documentation Browser automatically detects the regional settings in
use in your system and presents the information in the language for that region (if
available). If a topic is not available in the language for that region, the
English-language version is displayed.
Use one of the following procedures to start the Documentation Browser:
vIf Autostart is enabled, insert the CD into the CD-RW/DVD drive. The
Documentation Browser starts automatically.
vIf Autostart is disabled or is not enabled for all users:
For Windows operating systems
1. Insert the CD into the CD-RW/DVD drive
2. Click Start →Run.
3. In the Open field, type e:\win32.bat; where eis the drive letter of
your CD-RW/DVD drive
4. Click OK.
For Red Hat Linux operating systems
1. Insert the CD into the CD-RW/DVD drive
2. Run the following command from the /mnt/cdrom directory:
sh runlinux.sh
Select WebSphere DataPower XC10 from the Product menu. The Available Topics
list displays all the documents for your product. Some documents might be in
folders. A plus sign (+) indicates each folder or document that has additional
topics under it. Click the plus sign to display the additional documents.
When you select a document, a description of the document appears under Topic
Description. To select more than one document, press and hold the Ctrl key while
you select the documents. Click View Book to view the selected document or
documents in Acrobat Reader or xpdf. If you selected more than one document, all
the selected documents are opened in Acrobat Reader or xpdf.
xvi IBM WebSphere DataPower XC10: Installation Guide

To search all the documents, type a word or word string in the Search field and
click Search. The documents in which the word or word string appears are listed
in order of the most occurrences. Click a document to view it, and press Ctrl+F to
use the Acrobat search function, or press Alt+F to use the xpdf search function
within the document.
Click Help for detailed information about using the Documentation Browser.
Available documents
The IBM WebSphere DataPower XC10: Documentation CD contains the following
documents:
vIBM WebSphere DataPower XC10: Quick Start Guide
Provides basic instructions for installing and powering up the WebSphere
DataPower XC10 appliance and placing the appliance in operation.
vIBM WebSphere DataPower XC10: Installation Guide
Provides complete instructions for installing and powering up the WebSphere
DataPower XC10 appliance, creating a startup configuration script, and placing
the appliance in operation.
vIBM WebSphere DataPower XC10: Hardware Problem Determination and Service Guide
Provides information about the features and specifications of the WebSphere
DataPower XC10 appliance, information about diagnosing and troubleshooting
hardware problems, information about ordering, removing, and replacing
hardware, and information about getting additional support to diagnose
hardware problems.
vIBM Systems Safety Notices
Contains all safety notices, by language, for the WebSphere DataPower XC10
appliance.
vIBM Statement of Limited Warranty
Contains information about the terms of warranty for the WebSphere DataPower
XC10 appliance.
Warranty information
The product-specific IBM Statement of Limited Warranty for this product is provided
on the IBM WebSphere DataPower XC10: Documentation CD that comes with this
product. The statement is also available in 29 languages from the IBM Web site at
http://www.ibm.com/servers/support/machine_warranties/ without the
product-specific terms.
Notices and conventions
The caution and danger statements in this document are also in the multilingual
IBM Systems Safety Notices document, which is on the IBM WebSphere DataPower
XC10: Documentation CD. Each statement references the corresponding statement,
in your language, in the IBM Systems Safety Notices.
The following notices and statements are used in this document:
Note These notices provide important tips, guidance, or advice.
Best Practice
These notices provide guidance about how to best accomplish a task.
Preface xvii

Attention
These notices indicate potential damage to programs, devices, or data. An
attention notice is placed just before the instruction or situation in which
damage might occur.
Caution
These statements indicate situations that can be potentially hazardous to
you. A caution statement is placed just before the description of a
potentially hazardous procedure step or situation.
Danger
These statements indicate situations that can be potentially lethal or
extremely hazardous to you. A danger statement is placed just before the
description of a potentially lethal or extremely hazardous procedure step
or situation.
Typeface conventions
The following typeface conventions are used in the documentation:
bold Identifies commands, programming keywords, and GUI controls.
italics Identifies words and phrases used for emphasis and user-supplied
variables.
monospaced
Identifies user-supplied input or computer output.
xviii IBM WebSphere DataPower XC10: Installation Guide