9235 installation

8/4/2019 9235 Installation

1/56

WebSphere DataPower SOA Appliances: Type 9235

Installation Guide

Third Edition


2/56


3/56

WebSphere DataPower SOA Appliances: Type 9235

Installation Guide

Third Edition


4/56

NoteBefore using this information and the product it supports, read the information in Safety on page v and, if necessary, thelanguage-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.

Third Edition (November 2008)

This edition applies to IBM WebSphere DataPower SOA Appliances Type 9235 until otherwise indicated in neweditions.

Copyright International Business Machines Corporation 2003, 2008.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.


5/56

Contents

Safety . . . . . . . . . . . . . . . vGuidelines for servicing electrical equipment . . . vi

Inspecting for unsafe conditions . . . . . . . viiSafety statements . . . . . . . . . . . . viii

Danger notices . . . . . . . . . . . . viiiCaution notices . . . . . . . . . . . . ixLabels . . . . . . . . . . . . . . . xii

Preface . . . . . . . . . . . . . . xiiiWho should read this document . . . . . . . xiiiModel types . . . . . . . . . . . . . . xiiiHow this document is organized . . . . . . . xivRelated documents . . . . . . . . . . . . xvThe Documentation CD . . . . . . . . . . xv

Hardware and software requirements . . . . xvUsing the Documentation CD . . . . . . . xv

Available documents . . . . . . . . . . xviWarranty information . . . . . . . . . . xviiNotices conventions . . . . . . . . . . . xviiTypeface conventions . . . . . . . . . . xvii

Chapter 1. Introduction . . . . . . . . 1Specifications and features . . . . . . . . . . 1

Specifications . . . . . . . . . . . . . 1Features . . . . . . . . . . . . . . . 2

Components . . . . . . . . . . . . . . 2Front view . . . . . . . . . . . . . . 2Rear view . . . . . . . . . . . . . . 5

Chapter 2. Preparing for installation . . 9Rack requirements . . . . . . . . . . . . 9Tool requirements . . . . . . . . . . . . 12Installation overview . . . . . . . . . . . 12

Chapter 3. Installing the appliance in arack . . . . . . . . . . . . . . . . 15Installing rails in the rack frame . . . . . . . 15Securing the appliance in the rack . . . . . . . 17Connecting the appliance to an AC power source. . 18Connecting the appliance to the network . . . . 18

Chapter 4. Setting up the initial

firmware configuration . . . . . . . . 19

Requirements. . . . . . . . . . . . . . 19Hardware requirement . . . . . . . . . 19

Information requirements. . . . . . . . . 19Consideration for password to admin account . . . 19Connecting the serial cable to the appliance . . . 20Initializing the appliance . . . . . . . . . . 20Verifying the configuration with the WebGUI . . . 21Completing the configuration . . . . . . . . 21Defining the base configuration manually . . . . 22

Appendix. Getting help and technicalassistance . . . . . . . . . . . . . 23Searching knowledge bases . . . . . . . . . 23Receiving automatic updates . . . . . . . . 23

Receiving updates through My support . . . . 23Receiving updates through RSS feeds. . . . . 24

Getting a fix . . . . . . . . . . . . . . 24Contacting IBM Support . . . . . . . . . . 25

Notices . . . . . . . . . . . . . . 27Product recycling and disposal . . . . . . . . 27Battery return program . . . . . . . . . . 29Electronic emission notices . . . . . . . . . 30

Federal Communications Commission (FCC)statement . . . . . . . . . . . . . . 30Industry Canada Compliance Statement . . . . 31Avis de conformit la rglementationdIndustrie Canada . . . . . . . . . . . 31United Kingdom telecommunications safety

requirement . . . . . . . . . . . . . 31European Union EMC Directive conformancestatement . . . . . . . . . . . . . . 31Japanese Voluntary Control Council forInterference (VCCI) statement . . . . . . . 31Taiwanese Class A warning statement . . . . 32Chinese Class A warning statement . . . . . 32Korean Class A warning statement . . . . . 32Russian Class A warning statement . . . . . 32

Trademarks . . . . . . . . . . . . . . 32

Copyright IBM Corp. 2003, 2008 iii


6/56

iv IBM WebSphere DataPower SOA Appliances: Type 9235: Installation Guide


7/56

Safety

Before installing this product, read the Safety Information.

Arabic

Brazilian PortugueseAntes de instalar este produto, leia as Informaes de Segurana.

Chinese (simplified)

Chinese (traditional)

Croatian

CzechPred instalac tohoto produktu si prectete prrucku bezpecnostnch instrukc.

DanishLs sikkerhedsforskrifterne, fr du installerer dette produkt.

DutchLees voordat u dit product installeert eerst de veiligheidsvoorschriften.

FinnishEnnen kuin asennat tmn tuotten, lue turvaohjeet kohdasta SafetyInformation.

FrenchAvant d'installer ce produit, lisez les consignes de scurit.

GermanVor der Installation dieses Produkts die Sicherheitshinweise lesen.

Greek

Hebrew

Hungarian

ItalianPrima di installare questo prodotto, leggere le Informazioni sulla Sicurezza.

Japanese

Korean

Macedonian

Copyright IBM Corp. 2003, 2008 v


8/56

NorwegianLes sikkerhetsinformasjonen (Safety Information) fr du installerer detteproduktet.

Polish

PortugueseAntes de instalar este produto, leia as Informaes sobre Segurana.

Russian

Slovak

SlovenianPred namestitvijo tega proizvoda preberite Varnostne informacije.

Spanish

Antes de instalar este producto, lea la informacin seguridad.Swedish

Ls skerhetsinformationen innan du installerar den hr produkten.

Guidelines for servicing electrical equipment

Observe the following guidelines when servicing electrical equipment:

v Check the area for electrical hazards such as moist floors, non-grounded powerextension cords, and missing safety grounds.

v Use only approved tools and test equipment. Some hand tools have handles thatare covered with a soft material that do not provide insulation from liveelectrical current.

v Regularly inspect and maintain your electrical hand tools for safe operationalcondition. Do not use worn or broken tools or testers.

v Do 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 ifit touches a live electrical circuit.

v Some rubber floor mats contain small conductive fibers to decrease electrostaticdischarge. Do not use this type of mat to protect yourself from electrical shock.

v Do not work alone under hazardous conditions or near equipment that hashazardous voltages.

v Locate the emergency power-off (EPO) switch, disconnecting switch, or electricaloutlet so that you can turn off the power quickly in the event of an electricalaccident.

v Disconnect all power before you perform a mechanical inspection, work nearpower supplies, or remove or install main units.

v Before you work on the equipment, disconnect the power cord. If you cannotdisconnect the power cord, have the customer power-off the wallbox thatsupplies power to the equipment and lock the wallbox in the off position.

v Never assume that power has been disconnected from a circuit. Check it tomake sure that it has been disconnected.

v If you have to work on equipment that has exposed electrical circuits, observethe following precautions:

vi IBM WebSphere DataPower SOA Appliances: Type 9235: Installation Guide


9/56

Make sure that another person who is familiar with the power-off controls isnear you and is available to turn off the power if necessary.

When you are working with powered-on electrical equipment, use only onehand. Keep the other hand in your pocket orbehind your back to avoidcreating 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.

v Use extreme care when measuring high voltages.

v To ensure proper grounding of components such as power supplies, pumps,blowers, fans, and motor generators, do not service these components outside oftheir normal operating locations.

v If an electrical accident occurs, use caution, turn off the power, and send anotherperson to get medical aid.

Inspecting for unsafe conditions

Use this information to help you identify potential unsafe conditions in an IBMproduct that you are working on.

Each IBM product, as it was designed and manufactured, has required safety itemsto protect users and service technicians from injury. The information in this sectionaddresses only those items. Use good judgment to identify potential unsafeconditions that might be caused by attachment of non-IBM features or options thatare not addressed in this section. If you identify an unsafe condition, you mustdetermine 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:

v Electrical hazards, especially primary power. Primary voltage on the frame cancause serious or fatal electrical shock.

v Explosive hazards, such as a damaged CRT face or a bulging capacitor.

v Mechanical hazards, such as loose or missing hardware.

To inspect the product for potential unsafe conditions, complete the followingsteps:

1. Make sure that the power is off and the power cords are disconnected.

2. Make sure that the exterior cover is not damaged orbroken, and observe anysharp edges.

3. Check the power cords:

v Make 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 betweenthe external ground pin and the frame ground.

v Make sure that the power cords are the correct type.

v Make sure that the insulation is not frayed or worn.

4. Check for pinched cables.

Safety vii


10/56

Safety statements

The statements in this section are the statements that apply to the Type 9235appliance. These statements are the exact same safety information that the IBMSystems Safety Notices document provides. However, the IBM Systems Safety Noticesdocument 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 WebSphereDataPower SOAAppliances: Documentation CD.

Danger noticesDANGER

When working on or around the system, observe the following precautions:

Electrical voltage and current from power, telephone, and communicationcables are hazardous. To avoid a shock hazard:v Connect power to this unit only with the IBM provided power cord. Do notuse the IBM provided power cord for any other product.

v Do not open or service any power supply assembly.v Do not connect or disconnect any cables or perform installation,maintenance, or reconfiguration of this product during an electrical storm.

v The product might be equipped with multiple power cords. To remove allhazardous voltages, disconnect all power cords.

v Connect all power cords to a properly wired and grounded electrical outlet.Ensure that the outlet supplies proper voltage and phase rotation accordingto the system rating plate.

v Connect any equipment that will be attached to this product to properlywired outlets.

v When possible, use one hand only to connect or disconnect signal cables.v Never turn on any equipment when there is evidence of fire, water, orstructural damage.

v Disconnect the attached power cords, telecommunications systems,networks, and modems before you open the device covers, unlessinstructed otherwise in the installation and configuration procedures.

v Connect and disconnect cables as described in the following procedureswhen installing, moving, or opening covers on this product or attacheddevices.

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.

(D005)

viii IBM WebSphere DataPower SOA Appliances: Type 9235: Installation Guide


11/56

Caution noticesCAUTION:The battery contains lithium. To avoid possible explosion, do not burn or chargethe battery.v Do not throw or immerse into waterv Do not heat to more than 100 C (212 F)v

Do not repair or disassemble

Exchange only with the IBM-approved part. Recycle or discard the battery asinstructed by local regulations. In the United States, IBM has a process for thecollection of this battery. For information, call 1-800-426-4333. Have the IBM partnumber 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 carewhen lifting, removing, or installing this part or unit. (C008)

Safety ix


12/56

Use the following general safety information for all rack-mounted devices.

DANGER

Observe the following precautions when working on or around your IT racksystem:v Heavy equipment personal injury or equipment damage might result ifmishandled.

v Always lower the leveling pads on the rack cabinet.v Always install stabilizer brackets on the rack cabinet.v To avoid hazardous conditions due to uneven mechanical loading, alwaysinstall the heaviest devices in the bottom of the rack cabinet. Always installservers and optional devices starting from the bottom of the rack cabinet.

v Rack-mounted devices are not to be used as shelves or work spaces. Do notplace objects on top of rack-mounted devices.

v Each rack cabinet might have more than one power cord. Be sure todisconnect all power cords in the rack cabinet when directed to disconnectpower during servicing.

v Connect all devices installed in a rack cabinet to power devices installed inthe same rack cabinet. Do not plug a power cord from a device installed inone rack cabinet into a power device installed in a different rack cabinet.

v An electrical outlet that is not correctly wired could place hazardousvoltage on the metal parts of the system or the devices that attach to thesystem. It is the responsibility of the customer to ensure that the outlet iscorrectly wired and grounded to prevent an electrical shock.

(R001 part 1 of 2)

CAUTION:v Do not install a unit in a rack where the internal rack ambient temperatureswill exceed the manufacturers recommended ambient temperature for all yourrack-mounted devices.

v Do not install a unit in a rack where the air flow is compromised. Ensure thatair flow is not blocked or reduced on any side, front, or back of a unit usedfor air flow through the unit.

v Consideration should be given to the connection of the equipment to thesupply circuit so that overloading of the circuits does not compromise thesupply wiring or overcurrent protection. To provide the correct powerconnection 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 rackstabilizer brackets are not attached to the rack. Do not pull out more than onedrawer at a time. The rack might become unstable if you pull out more thanone drawer at a time.

v (For fixed drawers) This drawer is a fixed drawer and must not be moved forservicing unless specified by the manufacturer. Attempting to move thedrawer partially or completely out of the rack might cause the rack to becomeunstable or cause the drawer to fall out of the rack.

(R001 part 2 of 2)

x IBM WebSphere DataPower SOA Appliances: Type 9235: Installation Guide


13/56

CAUTION:Removing components from the upper positions in the rack cabinet improvesrack stability during relocation. Follow these general guidelines whenever yourelocate a populated rack cabinet within a room or building:v Reduce the weight of the rack cabinet by removing equipment starting at thetop of the rack cabinet. When possible, restore the rack cabinet to theconfiguration 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 rackcabinet.

Ensure that there are no empty U-levels between devices installed in therack cabinet below the 32U level.

v If the rack cabinet you are relocating is part of a suite of rack cabinets, detachthe rack cabinet from the suite.

v Inspect the route that you plan to take to eliminate potential hazards.v Verify that the route that you choose can support the weight of the loadedrack cabinet. Refer to the documentation that comes with your rack cabinet forthe weight of a loaded rack cabinet.

v Verify that all door openings are at least 760 x 230 mm (30 x 80 in.).v Ensure that all devices, shelves, drawers, doors, and cables are secure.v Ensure that the four leveling pads are raised to their highest position.v Ensure that there is no stabilizer bracket installed on the rack cabinet duringmovement.

v Do not use a ramp inclined at more than 10 degrees.v When 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 rackcabinet from the lowest position to the highest position.

v If a long-distance relocation is required, restore the rack cabinet to theconfiguration of the rack cabinet as you received it. Pack the rack cabinet in

the original packaging material, or equivalent. Also lower the leveling pads toraise the casters off of the pallet and bolt the rack cabinet to the pallet.

(R002)

Safety xi


14/56

LabelsDANGER

Hazardous voltage, current, or energy levels are present inside any componentthat has this label attached. Do not open any cover or barrier that containsthis label. (L001)

xii IBM WebSphere DataPower SOA Appliances: Type 9235: Installation Guide


15/56

Preface

IBM WebSphere DataPower SOA Appliances are purpose-built, easy-to-deploynetwork appliances that simplify, help secure, and accelerate your XML and Web

services deployments while extending your SOA infrastructure. These appliancesoffer an innovative, pragmatic approach to harness the power of SOA whilesimultaneously enabling you to leverage the value of your existing application,security, and networking infrastructure investments.

Who should read this document

This document is intended for lab personnel who are responsible for the followingactivities:

v Installing rails in the rack frame for the DataPower appliance

v Installing a DataPower appliance in the rack

v Performing the base, initial configuration of a DataPower appliance

Model types

The Type 9235 appliance has 15 model types. You can separate these model typesinto the following general product categories that you can differentiate by chassiscolor:

IBM WebSphere DataPower XML Accelerator XA35The DataPower XA35 has a green chassis. There is only one model type.

IBM WebSphere DataPower XML Security Gateway XS40The DataPower XS40 has a yellow chassis. There are four model types.

IBM WebSphere DataPower Integration Appliance XI50

The DataPower XI50 has a blue chassis. There are eight model types.

IBM WebSphere DataPower B2B Appliance XB60The DataPower XB60 has a purple chassis. There is one model type

IBM WebSphere DataPower Low Latency Messaging Appliance XM70The DataPower XM70 has a silver chassis. There is one model type

Each general product category, except the DataPower XA35, has one of thefollowing hardware configurations for auxiliary data storage:

v Compact flash

v Hard disk array

You can differentiate these configurationsby looking at the rear of the chassis. Thecompact flash configuration does not have ventilations holes, while the hard diskarray configuration has ventilation holes.

All models in the DataPower XS40 and DataPower XI50 product categories cancome with hardware security module (HSM). You can differentiate theseconfigurationsby looking at the front of the chassis. These configurations have aPED connector.

All models in the DataPower XI50 product category can come with an internalXML generation four (XG4) accelerator card. You cannot differentiate these models

Copyright IBM Corp. 2003, 2008 xiii


16/56

by looking at the chassis. The only way to know whether you have a model withthis XML accelerator card is to look at the version status provider:

v From the command line, enter show version command.

v From the WebGUI, select STATUS System Version Information.

Table 1 lists the 13 model types as listed on the Service Card in the fan modules.

Table1. Modeltypes

Model type Description

22X XA35 green: CF1

32X XS40 yellow: CF1

3BX XS40 yellow: HDD2

34X XS40 yellow: CF1, HSM3

3DX XS40 yellow: HDD2, HSM3

42X XI50 blue: CF1

4BX XI50 blue: HDD2

43X XI50 blue: CF1, XG44

4CX XI50 blue: HDD2, XG44

44X XI50 blue: CF1, HSM3

4DX XI50 blue: HDD2, HSM3

45X XI50 blue: CF1, HSM3, XG44

4FX XI50 blue: HDD2, HSM3, XG44

62X XB60 purple: HDD2, SQL5

6BX XM70 silver: HDD2

1 Has a compact flash for auxiliary data storage.2 Has a hard disk array for auxiliary data storage.3 Has the hardware security module.

4 Has the XG4 accelerator card.5 Has the SQL/ODBC feature.

How this document is organized

This document has the following organization:

v Safety

Provides safety information for Type 9235.

v Chapter 1, Introduction

Provides the features and specifications for Type 9235.

v Chapter 2, Preparing for installation

Provides information about the rack, required tools, and the installationoverview.

v Chapter 3, Installing the appliance in a rack

Provides instructions for installing the rails in the rack, instructions for insertingthe appliance in the rack, instruction for connecting the appliance to power, andinstructions for connecting the appliance to the network.

v Chapter 4, Setting up the initial firmware configuration

Provides instructions for defining the base, initial firmware configuration.

v Getting help and technical assistance

xiv IBM WebSphere DataPower SOA Appliances: Type 9235: Installation Guide


17/56

Provides information about getting support.

Related documents

The following documents in the IBM WebSphere DataPower SOA Applianceslibrary are referenced by this document, but not on the IBM WebSphere DataPowerSOAAppliances: Documentation CD:

v IBM WebSphere DataPower SOAAppliances:Administrators Guide

Provides information about and instructions for using the GUI to configure andto maintain the DataPower appliance.

v Category-specific IBM WebSphere DataPower: Command Reference

Provides an alphabetical list of all commands, by configuration mode, withsyntactical and functional descriptions.

v IBM WebSphere DataPower SOAAppliances:Hardware Security Module Guide

Provides information about using the Hardware Security Module (HSM) in theDataPower appliance.

The Documentation CD

The IBM WebSphere DataPower SOAAppliances: Documentation CD containsdocumentation for your Type 9235 chassis in Portable Document Format (PDF).This CD includes the following documents and includes the IBM DocumentationBrowser to help you find information quickly.

Hardware and software requirementsThe IBM WebSphere DataPower SOAAppliances: Documentation CD requires thefollowing minimum hardware and software:

v Microsoft Windows XP, Windows 2000, or Red Hat Linux

v 100 MHz microprocessor

v 32 MB RAM

v Adobe Acrobat Reader 3.0 (or later) or xpdf, which comes with Linux operatingsystems

Using the Documentation CDUse the Documentation Browser to browse the contents of the CD, read briefdescriptions of the documents, and view documents, using Adobe Acrobat Readeror xpdf. The Documentation Browser automatically detects the regional settings inuse in your system and presents the information in the language for that region (ifavailable). If a topic is not available in the language for that region, theEnglish-language version is displayed.

Use one of the following procedures to start the Documentation Browser:

v If Autostart is enabled, insert the CD into the CD-RW/DVD drive. TheDocumentation Browser starts automatically.

v If 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 e is the drive letter ofyour CD-RW/DVD drive

Preface xv


18/56

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 Type 9235 from the Product menu. The Available Topics list displays all thedocuments for your product. Some documents might be in folders. A plus sign (+)indicates each folder or document that has additional topics under it. Click theplus sign to display the additional documents.

When you select a document, a description of the document appears under TopicDescription. To select more than one document, press and hold the Ctrl key whileyou select the documents. Click View Book to view the selected document ordocuments in Acrobat Reader or xpdf. If you selected more than one document, allthe selected documents are opened in Acrobat Reader or xpdf.

To search all the documents, type a word or word string in the Search field andclick Search. The documents in which the word or word string appears are listedin order of the most occurrences. Click a document to view it, and press Ctrl+F touse the Acrobat search function, or press Alt+F to use the xpdf search functionwithin the document.

Click Help for detailed information about using the Documentation Browser.

Available documentsThe IBM WebSphere DataPower SOAAppliances: Documentation CD contains thefollowing documents:

v IBM WebSphere DataPower SOAAppliances: Quick Start Guide

Providesbasic instructions for installing and powering up the Type 9235

appliance and placing the appliance in operation.v IBM WebSphere DataPower SOAAppliances: Type 9235: Installation Guide

Provides complete instructions for installing and powering up the Type 9235appliance, creating a startup configuration script, and placing the appliance inoperation.

v IBM WebSphere DataPower SOAAppliances: Type 9235: Hardware ProblemDetermination and Service Guide

Provides information about the features and specifications of the Type 9235appliance, information about diagnosing and troubleshooting hardwareproblems, information about ordering, removing, and replacing hardware, andinformation about getting additional support to diagnose hardware problems.

v IBM Systems Safety Notices

Contains all safety notices, by language, for the Type 9235 appliance.

v IBM Statement of Limited Warranty

Contains information about the terms of warranty for the Type 9235 appliance.

v Agreement for DataPowerAppliance Remote Support

Contains information about the remote support agreement for the Type 9235appliance.

xvi IBM WebSphere DataPower SOA Appliances: Type 9235: Installation Guide


19/56

Warranty information

The product-specific IBM Statement of Limited Warranty for this product is providedon the IBM WebSphere DataPower SOAAppliances: Documentation CD that comeswith this product. The statement is also available in 29 languages from the IBMWeb site at http://www.ibm.com/servers/support/machine_warranties/ withoutthe product-specific terms.

Notices conventions

The caution and danger statements in this document are also in the multilingualIBM Systems Safety Notices document, which is on the IBM WebSphere DataPowerSOAAppliances: Documentation CD. Each statement references to the correspondingstatement 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 PracticeThese notices provide guidance about best practices.

AttentionThese notices indicate potential damage to programs, devices, or data. Anattention notice is placed just before the instruction or situation in whichdamage might occur.

CautionThese statements indicate situations that can be potentially hazardous toyou. A caution statement is placed just before the description of apotentially hazardous procedure step or situation.

DangerThese statements indicate situations that can be potentially lethal orextremely hazardous to you. A danger statement is placed just before the

description of a potentially lethal or extremely hazardous procedure stepor 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-suppliedvariables.

monospaced

Identifies user-supplied input or computer output.

Preface xvii
http://www.ibm.com/servers/support/machine_warranties/http://www.ibm.com/servers/support/machine_warranties/


20/56

xviii IBM WebSphere DataPower SOA Appliances: Type 9235: Installation Guide


21/56

Chapter 1. Introduction

Type 9235 is a 1U rack-mountable appliance. This appliance is offered in threegeneral models. Each model shares a common main chassis. The differentiating

factor among these general models is their color.

Green IBM WebSphere DataPower XML Accelerator XA35

YellowIBM WebSphere DataPower XML Security Gateway XS40

Blue IBM WebSphere DataPower Integration Appliance XI50

Specifications and features

This section contain information about the specifications and features of the Type9235 appliance.

SpecificationsTable 2 summarizes the specifications for the Type 9235 chassis.

Table2. Specifications

Dimensions:

Height 1.7 in. (4.32 cm)

Width 19 in. (48.25 cm)19.13 in. (48.59 cm) with rails

Depth 28.12 in. (71.42 cm)33.05 in. (83.94 cm) with rails

Weight Maximum: 37.48 lb. (17 kg)

Models with a compact flash configuration weigh 1.76 lb. (0.8 kg)less.

Electrical input:

Sine-wave 50 - 60 Hz (single-phase) required

110 Voltage AC Minimum: 100 VRMSMaximum: 127 VRMS

220 Voltage AC Minimum: 200 VRMSMaximum: 240 VRMS

Heat output Maximum: 590 watts (2014 Btu) per hour

Environment:

Air temperature Turned on:v Altitude 0 to 914.4 m (3000 ft.)

50 to 95 F (10 to 35 C)v Altitude: 914.4 m (3000 ft.) to 2133.6 m (7000 ft.)

50 to 89.6 F (10 to 32 C)Maximum altitude: 2133.6 m (7000 ft.)

Turned off: 50 to 109.4 F (10 to 43 C)

Shipping: -40 to 140 F (-40 to 60 C)

Humidity 8% to 80%

Copyright IBM Corp. 2003, 2008 1


22/56

Table2. Specifications (continued)

Fan acoustics Front: LA=50 dB to LA=64 dBRear: LA=51 dB to LA=66 dB

The lower limits indicate the fans during normal operatingconditions. The upper limits indicate the fans during startup orhigh temperature situations.

Power level acoustics 65 to 79 dB (Declared)

FeaturesThe only feature of Type 9235 appliances is the auxiliary data storage. Each Type9235 appliance has one of the following types of auxiliary data storage Table 3summarizes the auxiliary data storage feature for Type 9235 appliances.

Table3. Auxiliarydatastorage

Feature Description

Hard disk array Simple swap Serial Attached SCSI (SAS) hard disk drive

Capacity: 146 GBSpeed: 10 KRPM Interface: SASCache: 16 MBRAID: 1Configuration: RAID 1 (mirrored)Output: 25 watts per drive

Compact flash Type I storage card, 3 mm thick

Capacity: 512 MBOutput: 0.375 watts

ComponentsA Type 9235 appliance includes auxiliary data storage, a system battery, fanmodules, and power modules.

Front viewNo components are installed from the front of a Type 9235 appliance. Figure 1represent the components on the front panel of a Type 9235 appliance.

The labels in Figure 1 represent the following components on the front panel of aType 9235 appliance:

A B C D E F G H I J

K L M N O P

Figure1. Front view

2 IBM WebSphere DataPower SOA Appliances: Type 9235: Installation Guide


23/56

A The activity LED light for the MGMT Ethernet interface.

B The speed LED light for MGMT Ethernet interface.

C The activity LED light for ETH0 Ethernet interface.

D The speed LED light for ETH0 Ethernet interface.

E The power LED light.

F The storage LED light.

G The locate LED light.

H The error alarm LED light.

I The activity LED light for ETH2 Ethernet interface.

J The activity LED light for ETH1 Ethernet interface.

K The CONSOLE connector.

L The network connector to the MGMT Ethernet interface.

M The network connector to the ETH0 Ethernet interface.

N The network connector to the ETH2 Ethernet interface.O The network connector to the ETH1 Ethernet interface.

P The PED connector, not all model types.

CONSOLE connectorThe front panel of all Type 9235 appliances has the CONSOLE connector. Use theDB-9 null-modem cable that is shipped with the appliance to connect from anASCII terminal1 or to connect from a PC that is running terminal emulationsoftware to the appliance.

Network connectorsThe front panel of all Type 9235 appliances has four Ethernet connectors:

MGMT Ethernet connectorThis Ethernet interface can manage all transaction data on the appliance.This connection has an associated activity LED light and speed LED light.

Activity LED lightWhen illuminated, indicates that traffic is passing through thisconnection.

Speed LED lightIndicates Ethernet connection speed and status.

This Ethernet interface does not support the iSCSI protocol.

ETH0 Ethernet connector

This Ethernet interface can manage all transaction data on the appliance.This connection has an associated activity LED light and speed LED light.

Activity LED lightWhen illuminated, indicates that traffic is passing through thisconnection.

Speed LED lightIndicates Ethernet connection speed and status.

1. A simple device that transmits (inputs) and receives (outputs) ASCII data.

Chapter 1. Introduction 3


24/56

This Ethernet interface does not support the iSCSI protocol.

ETH1 Ethernet connectorThis Ethernet interface can manage all transaction data on the appliance.This Ethernet interface supports the iSCSI protocol.

ETH2 Ethernet connectorThis Ethernet interface can manage all transaction data on the appliance.

This Ethernet interface supports the iSCSI protocol.

LED lightsThe front panel of all Type 9235 appliances has four LED lights:

Power LED lightThe green power LED light is illuminated when the appliance is connectedto a power source and the power switch is in the ON position.

Storage LED lightThe green storage LED light is illuminated when auxiliary data storage is

being accessed.

Locate LED light

The blue locate LED light is illuminated when activated by the DataPowerfirmware, and not illuminated when deactivated by the DataPowerfirmware. You can control whether this LED light is illuminated from theWebGUI or from the command line.

WebGUITo activate or deactivate the locate LED light, use the followingprocedure:

1. Select ADMINISTRATION Main System Control todisplay the System Control panel.

2. Locate the Control Locate LED section.

v To activate, click on.

v To deactivate, click off.

3. Click Control Locate LED.

Command lineUse the locate-device command in Global configuration mode.

v To activate, enter the following command:

locate-device on

v To deactivate, enter the following command:

locate-device off

Error alarm LED lightThe yellow error alarm LED light is illuminated when any LED light onthe rear of the appliance is illuminated or after a system event failure.

PIN Entry Device (PED) connectorThe front panel of specific models of the Type 9235 appliance has the PEDconnector. This connector allows you to connect a PED to the appliance. The PEDconnector is on models with a Hardware Security Module (HSM) only.

For information about using an HSM-enabled appliance, refer to the IBMWebSphere DataPower SOAAppliances:Hardware SecurityModule Guide.



25/56

Rear viewThe auxiliary data storage, system battery, fan modules, and power modules areinstalled from the rear of the Type 9235 appliance. Figure 2 represent thecomponents on the rear panel of a Type 9235 appliance.

The labels in Figure 2 represent the following components on the rear panel of aType 9235 appliance:

A The power supply 1 LED light.

B The power supply 2 LED light.

C The LED diagnostics panel.

D Power supply module 1.

E Power supply module 2.

F The auxiliary data storage unit: compact flash or hard disk array.

G The battery tray.

H Fan module 2.

I The power switch.J Fan module 1.

Power supply modulesThe Type 9235 appliance is powered by two fully redundant 650 watt powersupply modules. A single power supply module can supply enough power tosupport appliance operations. The power supply modules can be hot-swapped,which means that you can replace a single power supply module withoutpowering down the appliance.

Each power supply module contains two fans. Failure of at least one fan causes thepower supply module to overheat and generate messages.

At the rear of the appliance, each power supply module has an LED light thatindicates its operational state.

Auxiliary data storage unitEach Type 9235 appliance comes with one of the following types of auxiliary datastorage:

Hard disk arrayThe hard disk array is part the hard disk drive module. This module

A B C

D E F G H I J

Figure2. Rearview



26/56

include two 146 GB disks in a RAID 1 configuration and includes two fans.The disks operate as a single, mirrored volume. The disks cannot be usedas two discrete disks.

Note: Only 70 GB of the 146 GB is made available for auxiliary datastorage.

You need to replace the hard disk drive module if one of the fansbecomesinoperable. A replacement hard disk drive module does not contain thedisks. For a replacement hard disk drive module, you use the existingdisks. If an individual disk becomes inoperable, you can replace that disk.

Compact flashThe compact flash is a Type I storage card that can hold 512 MB of data.

Auxiliary data storage can be used for the following purposes only:

v To store logging data (from log targets or the log action)

v To store XML files or XSLT style sheets

LED diagnostics panel

The rear panel of all Type 9235 appliances include an LED diagnostics panel withsix LED lights. The layout is three LED lights in two rows.

HDDfan

CF orDrive 0 Drive 1

Battery Fan 2 Fan 1

What each LED light indicates depends on whether the compact flash or the harddisk array is the auxiliary data storage. Table 4 lists whether an LED light isapplicable, and, if applicable, what each LED light represents.

Table4. LEDdiagnosticspanelby availableauxiliarydatastorage

Compact flash Hard disk array

Top row, left to right

Not applicable The state of the fans in the hard disk drivemodule

The state of the storage card The state of the Drive 0 hard disk

Not applicable The state of the Drive 1 hard disk

Bottom row, left to right

The state of the battery The state of the battery

The state of the fans in the fan module 2 The state of the fans in the fan module 2

The state of the fans in the fan module 1 The state of the fans in the fan module 1

BatteryThe appliance is equipped with a CR2 three-volt lithium battery. The batterycannot power the appliance. The appliance must be connected to active AC powersources for the appliance to process transactions. The battery maintains thefollowing internal components only:



27/56

v The real time clock

v Static RAM-based memory, which contains various global parameters thatinclude the current date and time for the appliance

Attention: Complete power failure (no AC power to the appliance with a missingor depleted battery) for seven days renders the appliance inoperable by activatingthe intrusion switch. After seven days, you might need to return the appliance toIBM to have the intrusion switch reset.

Leave the appliance connected to active AC power sources. Do not turn off theappliance when the battery needs to be replaced.

Both the firmware and the hardware monitor the battery.

FirmwareThe firmware monitors the age of the battery from its installation date.During a firmware reload, the firmware reads the current timestamp. Ifmore than two years has elapsed, the firmware generates a criticalmessage. The firmware continues to generate this message at 24-hourintervals until you replace the battery. Shortly before you receive your

appliance, the battery time-tracking process is initialized.

HardwareThe hardware monitors the capacity of the battery. The hardware generatescritical messages when the capacity is less than 10%.

Power switchThe power switch is the toggle that either turns on power to the appliance or turnsoff power to the appliance. When the toggle is in the ON position, the power isturned on. When the toggle is in the OFF position, the power is turned off.

Fan modulesThe appliance includes two fan modules. Each fan module holds four individual

fan motors. If one fan motor fails, you must replace the entire fan module tomaintain the required air flow.

The fans should normally operate between the cold chassis speeds and maximumspeeds. The failure threshold is set to a speed that is 20% lower than the coldchassis speed.

Table 5 lists the speeds for the front and rear fans in revolutions per minute (RPM)on the appliance.

v The front fans are five-blade fans.

v The rear fans are four-blade fans.

Table5. Fanspeeds inRPM

Minimum Cold chassis MaximumFailurethreshold

Front 2900 5280 16100 2000

Rear 2300 4880 12400 2000



28/56



29/56

Chapter 2. Preparing for installation

This section provides information about the rack, required tools, and theinstallation overview.

Rack requirements

The Type 9235 appliance is a 1U rack-mountable network appliance. You can installthe appliance in a standard 19 in (48.26 cm) rack with a minimum of 28 in. (71.1cm) of depth. When planning the installation, keep the following in mind:

v The rack must provide rear mounting columns. The appliance requires bothfront and rear mounting support.

v There must be at least 30 in. (76.20 cm) of free space behind the rack frame toremove replaceable parts.

v The ambient temperature in the operating environment and within the rackshould not exceed 104 F (40 C).

v Leave at least 2 in. (5.1 cm) above and below the appliance to provide adequateventilation and to assist in appliance maintenance.



30/56

DANGER

When working on or around the system, observe the following precautions:

Electrical voltage and current from power, telephone, and communicationcables are hazardous. To avoid a shock hazard:v Connect power to this unit only with the IBM provided power cord. Do notuse the IBM provided power cord for any other product.

v Do not open or service any power supply assembly.v Do not connect or disconnect any cables or perform installation,maintenance, or reconfiguration of this product during an electrical storm.

v The product might be equipped with multiple power cords. To remove allhazardous voltages, disconnect all power cords.

v Connect all power cords to a properly wired and grounded electrical outlet.Ensure that the outlet supplies proper voltage and phase rotation accordingto the system rating plate.

v Connect any equipment that will be attached to this product to properlywired outlets.

v When possible, use one hand only to connect or disconnect signal cables.v Never turn on any equipment when there is evidence of fire, water, or

structural damage.v Disconnect the attached power cords, telecommunications systems,networks, and modems before you open the device covers, unlessinstructed otherwise in the installation and configuration procedures.

v Connect and disconnect cables as described in the following procedureswhen installing, moving, or opening covers on this product or attacheddevices.

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.

(D005)



31/56

DANGER

Observe the following precautions when working on or around your IT racksystem:v Heavy equipment personal injury or equipment damage might result ifmishandled.

v Always lower the leveling pads on the rack cabinet.v Always install stabilizer brackets on the rack cabinet.v To avoid hazardous conditions due to uneven mechanical loading, alwaysinstall the heaviest devices in the bottom of the rack cabinet. Always installservers and optional devices starting from the bottom of the rack cabinet.

v Rack-mounted devices are not to be used as shelves or work spaces. Do notplace objects on top of rack-mounted devices.

v Each rack cabinet might have more than one power cord. Be sure todisconnect all power cords in the rack cabinet when directed to disconnectpower during servicing.

v Connect all devices installed in a rack cabinet to power devices installed inthe same rack cabinet. Do not plug a power cord from a device installed inone rack cabinet into a power device installed in a different rack cabinet.

v An electrical outlet that is not correctly wired could place hazardousvoltage on the metal parts of the system or the devices that attach to thesystem. It is the responsibility of the customer to ensure that the outlet iscorrectly wired and grounded to prevent an electrical shock.

(R001 part 1 of 2)

CAUTION:v Do not install a unit in a rack where the internal rack ambient temperatureswill exceed the manufacturers recommended ambient temperature for all yourrack-mounted devices.

v Do not install a unit in a rack where the air flow is compromised. Ensure thatair flow is not blocked or reduced on any side, front, or back of a unit usedfor air flow through the unit.

v Consideration should be given to the connection of the equipment to thesupply circuit so that overloading of the circuits does not compromise thesupply wiring or overcurrent protection. To provide the correct powerconnection to a rack, refer to the rating labels located on the equipment in therack 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 onedrawer at a time. The rack might become unstable if you pull out more thanone drawer at a time.

v (For fixed drawers) This drawer is a fixed drawer and must not be moved forservicing unless specified by the manufacturer. Attempting to move thedrawer partially or completely out of the rack might cause the rack to becomeunstable or cause the drawer to fall out of the rack.

(R001 part 2 of 2)

Chapter 2. Preparing for installation 11


32/56

CAUTION:Removing components from the upper positions in the rack cabinet improvesrack stability during relocation. Follow these general guidelines whenever yourelocate a populated rack cabinet within a room or building:v Reduce the weight of the rack cabinet by removing equipment starting at thetop of the rack cabinet. When possible, restore the rack cabinet to theconfiguration 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 rackcabinet.

Ensure that there are no empty U-levels between devices installed in therack cabinet below the 32U level.

v If the rack cabinet you are relocating is part of a suite of rack cabinets, detachthe rack cabinet from the suite.

v Inspect the route that you plan to take to eliminate potential hazards.v Verify that the route that you choose can support the weight of the loadedrack cabinet. Refer to the documentation that comes with your rack cabinet forthe weight of a loaded rack cabinet.

v Verify that all door openings are at least 760 x 230 mm (30 x 80 in.).v Ensure that all devices, shelves, drawers, doors, and cables are secure.v Ensure that the four leveling pads are raised to their highest position.v Ensure that there is no stabilizer bracket installed on the rack cabinet duringmovement.

v Do not use a ramp inclined at more than 10 degrees.v When 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 rackcabinet from the lowest position to the highest position.

v If a long-distance relocation is required, restore the rack cabinet to theconfiguration of the rack cabinet as you received it. Pack the rack cabinet in

the original packaging material, or equivalent. Also lower the leveling pads toraise the casters off of the pallet and bolt the rack cabinet to the pallet.

(R002)

Tool requirements

You will need the following tools, hardware, and cables to install the Type 9235rack-mounting kit:

v A medium Phillips screwdriver

v Two (2) standard rack screws

You will need the following cables to connect the Type 9235 appliance to yournetwork:

v At least one (1), but up to four (4), network cables.

Installation overview

The overall installation process makes the following assumptions:

v You have fully unpacked the appliance and have located the included two (2)power cords and one (1) serial cable.

v You need to install the mounting rails and have the rack-mounting kit.



33/56

To fully set up and test the appliance in your network, use the following high-levelprocesses:

1. Install the appliance in a rack:

a. Install the rails in the rack.

b. Secure the appliance in the rack.

c. Connect the appliance to an AC source.

d. Connect the appliance to the network.

2. Set up the initial firmware configuration:

a. Connect the serial cable to the appliance.

b. Initialize the appliance.

c. Verify the initial firmware configuration from the WebGUI.

3. Define the base configuration.

Chapter 2. Preparing for installation 13


34/56



35/56

Chapter 3. Installing the appliance in a rack

Use the procedures in this section to install the appliance in a rack.

Installing rails in the rack frame

The rails are for a 19 in. (48.26 cm) rack. These rails require two (2) standard rackscrews to secure the rails to the rack frame.

Note: The standard rack screws are not part of the rack-mounting kit.

The rack-mounting kit includes the following parts:

v Two (2) mounting rails with built-in extenders

v Two (2) brackets with a built-in captive screw to secure the appliance to the rack

v Four (4) screws to secure the brackets to the appliance

Best Practice: Use two people to install the rails in the rack frame.

To install the rails, use the following procedure:

1. Position the left and right mounting rails in the rack so that the two (2) leftblue tabs face the two (2) right blue tabs.

v The front of each rail is capped with an angle bracket.

v The rear of each rail has an angle bracket that is recessed approximately 3 in.(7.6 cm).

Left rail

Right rail

Front

Rear

2. Insert the left rear of the rail into the rack frame:



36/56

a

b

c

a. Place the rearbracket of the rail against the rear column of the rack frame.The rear column should be between the facing plates of the bracket.

b. With your thumb, press and hold the blue release tab.

c. With your index finger, push the blue lever toward the middle of the rack.The facing plates separate to expose the retractable pins.

d. Continue pushing the lever until the retractable pins are fully exposed andare locked into the open position.

e. Align and insert the retractable pin into the appropriate holes in the rackframe.

f. Press the blue release tab to close the facing plates. The facing plates shouldclose against the column of the rack frame.

3. Secure the left rear of the rail to the rack.

a. Insert a standard rack screw, not provided, through the rear column in therack frame to the built-in nut on the angle bracket of the rail.

b. Use a medium Phillips screwdriver to tighten the standard rack screw.4. Insert the left front of the rail:

a

c

b

a. Align the front bracket of the rack with the front column of the rack frame.

b. With your thumb, press and hold the blue release tab.

c. With your index finger, push the blue lever toward the middle of the rack.The facing plates separate to expose the retractable pins.

d. Continue pushing the lever until the retractable pins are fully exposed andare locked into the open position.

e. Align and insert the retractable pin into the appropriate holes in the rackframe.



37/56

f. Press the blue release tab to close the facing plates. The facing plates shouldclose against the column of the rack frame.

5. Repeat step 2 on page 15 to insert the right rear of the rail.

6. Repeat step 3 on page 16 to secure the right rear of the rail to the rack.

7. Repeat step 4 on page 16 to insert the right front of the rail.

Securing the appliance in the rack1. From the front of the rack, slide the appliance onto the mounting rails. Do not

slide until it locks into place.

2. If the appliance is locked into place, slide the appliance toward you so that youcan attach the brackets with the captive screws.

3. Attach the right bracket to the chassis:

Captive screw

a. Align the holes in the right bracket with the holes in the front right side ofthe chassis.

Chapter 3. Installing the appliance in a rack 17


38/56

b. Use a screwdriver to tighten the provided screws into the chassis.

4. Repeat step 3 on page 17 to attach the left bracket to the chassis.

5. Slide the appliance into the rack until it locks into place

6. Hand-tighten the captive screws on the brackets to the rack frame.

Connecting the appliance to an AC power source

Use the provided power cords to connect both power supply modules to an ACpower source. You must connect each power supply modules. Otherwise, theunconnected module is considered tobe in a failed state.

Connecting the appliance to the network

Use Ethernet cables or transceivers (not provided) to connect the DataPowerappliance to its neighboring network devices (link partners), such as switches orload balancers.

Attention: Do not connect to telephone or other telecommunication circuits.

Do not use a cable that is longer than 100 meters.

The DataPower appliance Ethernet port must be connected to a compatible linkpartner, preferably set to auto-negotiate connection speed and mode (half duplexor full duplex). Depending on the negotiated or static connection speed and mode,ensure that the cable complies with the following requirements:

1 gigabit per second (1 Gbps) connectionUse Category 5 wiring or better.

100 megabits per second (100 Mbps) connectionUse Category 5 wiring or better.

10 megabits per second (10 Mbps) connection

Use Category 3 wiring or better.



39/56

Chapter 4. Setting up the initial firmware configuration

Use the procedures in this section to perform the initial, base firmwareconfiguration. This configuration is the minimal configuration to add a DataPower

appliance to your environment.

Requirements

To perform the initial firmware configuration, there are both hardware andinformation requirements.

Hardware requirementTo perform the initial configuration, you must use a serial connection to performthe initial configuration. The serial connection must be between an ASCII terminalor a PC running terminal emulation software to the serial port on the DataPowerappliance. To make this connection, use the provided DB-9 null-modem cable.

Note: If the terminal or PC is not equipped with a serial port, use a USB-to-serialconverter cable (not provided).

Information requirementsBefore defining the base configuration, you need the following information:

v The IP address for the Ethernet interface for appliance management access (MGMT)

v The IP addresses for Ethernet interfaces for appliance service access (ETH0, ETH1,and ETH2)

v The IP address of the default gateways (routers) that supports the subnets forthe Ethernet interfaces

v

The IP address for the network services (SSH, Telnet, and so forth)

Best Practice: Use the MGMT Ethernet interface on a dedicated subnet for allnetwork- and system-wide management functions. This dedicatedsubnet would handle network traffic for logging to FTP, SNMP, XMLManagement, and Web Management (WebGUI) functions.

Use the remaining three Ethernet interfaces to handle data traffic toand from the various DataPower services.

Consideration for password to admin account

The first time that you boot the DataPower appliance is different from any

subsequentboot. On subsequentboots from a serial connection, you will not beprompted to accept the licensing agreement or to change the password for theadmin account. However, you will be prompted to log in with a local account, and,if that account has an expired password, you will be prompted to change thepassword.



40/56

Attention: Do not misplace the new password for the admin account. If youmisplace this password, securitybest practice dictates that you should return theappliance to IBM Support to reset this password.

When you receive the appliance after a password-reset, you must perform aninitial firmware setup. Therefore, none of your configuration data will be on theappliance.

However, if another user account can log in and has the appropriate accesspermission, that user can reset the password for the admin account.

If you need to return the appliance, refer to technote 1257115 athttp://www.ibm.com/support/docview.wss?rs=2362&uid=swg21257115 forinformation about the return process.

Connecting the serial cable to the appliance

To make the serial connection, use the following procedure:

1. Use the null-modem cable or a USB-to-serial converter cable to connect the

terminal or PC to the SERIAL connector on the appliance.2. Ensure that the terminal or PC is configured for standard 9600 8N1 and no

flow control operation. 8N1 is a notation for a serial configuration inasynchronous mode, where there are eight (8) data bits, no (N) parity bit, andone (1) stop bit.

Initializing the appliance

To initialize the appliance, use the following procedure:

1. If the appliance is not turned on, toggle the power switch to the ON position.The power switch is on the rear of the appliance.

v You should see the green power LED light illuminate on the front of the

appliance and hear the fans start up.v You should hear the fans change speed as the screen displays the following

information.

DPOS...

Wait for a few seconds for the appliance toboot.

2. Enter admin2 at the Login: prompt.

3. Enter admin3 at the Password: prompt. You will be prompted to change thispassword.

4. Read and accept the license agreement.

5. Enter a new password at the Please enter new password: prompt.

6. Enter the new password again at the Please re-enter new password to

confirm: prompt.7. Enter y at the Do you want to run the Installation Wizard? prompt to start

the installation wizard.

8. Follow the prompts to complete the base configuration.

2. admin is the name of a local user account. The owner of this account can perform all tasks on the appliance.

3. admin is the default password for the admin account.

http://www.ibm.com/support/docview.wss?rs=2362&uid=swg21257115http://www.ibm.com/support/docview.wss?rs=2362&uid=swg21257115


41/56

After defining the base firmware configuration, the screen displays informationthat is similar to the following information. The screen shows information specificto your appliance.

Welcome to DataPower XI50 console configuration.(C) 2000-2008 by DataPower Technology, Inc.

Version: XI50.3.7.1.0 build 123456 on 2008/01/1 18:00:00Serial number: 000000A

xi50#

The previous sample shows the following information:

v The appliance is a DataPower XI50 appliance

v The firmware version running on the appliance is 3.7.1.0 at the 123456 buildlevel

v The current time on the appliance is 6:00 PM on January 1, 2008

v The serial number for the appliance is of 000000A

If you were not able to complete the firmware installation, you can use the startupcommand to invoke the installation wizard. Refer to Defining the baseconfiguration manually on page 22 for details.

Verifying the configuration with the WebGUI

The following procedure makes the following assumptions:

v The IP address for the Ethernet interface is 10.10.13.35

v The specialized HTTP server to support WebGUI access listens on port 9090

To access the WebGUI from any browser, use the following procedure:

1. Open the Webbrowser.

2. Type the following value in the Address field:https://10.10.13.35:9090

If the Web page displays successfully, the base firmware configuration issuccessful.

3. Log in to the appliance with the local admin account and password.

If the DataPower Control Panel displays, authentication of the local adminaccount is successful.

Completing the configuration

Configurationbeyond the base configuration is beyond the scope of this document.Use the following documents to complete the configuration of your DataPower

appliance:v The product-specific IBM WebSphere DataPower SOAAppliances:Administrators

Guide describes the concepts and tasks to configure the appliance.

v The product-specific IBM WebSphere DataPower: Command Reference describes thecommands to configure the appliance.

Chapter 4. Setting up the initial firmware configuration 21


42/56

Defining the base configuration manually

The base configuration can be defined from the command line only using eitherthe installation wizard provided during the initial boot sequence or with thestartup command. Both methods invoke the installation wizard.

Use the following procedure only if you entered n at the Do you want to run the

Installation Wizard? prompt:

1. Log in to the command line.

2. Enter configure terminal at the prompt to enter Global configuration mode.

3. Enter startup at the prompt to start the installation wizard.

4. Follow the system prompts.

After defining the configuration, verify the configuration with the procedure inVerifying the configuration with the WebGUI on page 21.



43/56

Appendix. Getting help and technical assistance

This section describes the following options for obtaining support for IBMproducts:

v Searching knowledge bases

v Receiving automatic updates

v Getting a fix on page 24

v Contacting IBM Support on page 25

Searching knowledge bases

If you encounter a problem, you want it resolved quickly. You can search theavailable knowledge bases to determine whether the resolution to your problemwas already encountered and is already documented.

Documentation

The IBM WebSphere DataPower documentation library provides extensivedocumentation in Portable Document Format (PDF). You can use thesearch function of Adobe Acrobat Reader to query information. If youdownload and store the documents in a single location, you can use thesearch facility to find all references across the documentation set.

IBM SupportIf you cannot find an answer in the documentation, use the Search Supportfeature from the product-specific support page.

From the Search Support (this product) area of the product-specificsupport page, you can search the following IBM resources:

v IBM technote database

v

IBM downloadsv IBM Redbooks

v IBM developerWorks

Receiving automatic updates

You can receive automatic updates in the following ways:

v My support

v RSS feeds

Receiving updates through My support

To receive weekly email notifications about fixes and other support news, use thefollowing procedure:

1. Go to the IBM Support site at the following Web address:

http://www.ibm.com/support

2. Click My support in the upper-right corner under Personalized support toopen the Sign in page.

3. If you have already registered for My support, sign in and skip to the nextstep.

If you have not registered, complete the following steps:

http://www.ibm.com/supporthttp://www.ibm.com/support


44/56

a. Click register now in the upper right-hand corner of the support page toestablish your user ID and password.

b. Complete the registration form by using your email address as your IBM IDusing your email address as your IBM ID.

c. Click Submit.

4. Click the Edit profile tab.

5. For products about which you want to receive updates, use the filters to chooseyour exact interests:

a. Click Add products

b. From the first list, select the product category; for example, Software

c. From the second list, select the product segment; for example, BusinessIntegration

d. From the third list, select the product sub-segment; for example,Application Integration and Connectivity

e. From the list of displayed products, select all of the products for which youwant to receive updates; for example WebSphere DataPower SOAAppliances

f. Click Add products6. Click Subscribe to email.

7. Select the types of email to receive:

a. From the list, select Software

b. Select Please send these document by weekly email

c. To define a different email address, click Edit

d. From the list of documents, select the one of interest

e. Click Update

Receiving updates through RSS feedsFor information about RSS, including steps for getting started and a list ofRSS-enabled IBM Web pages, visit the following Web site:

http://www.ibm.com/software/support/rss

Getting a fix

A product fix might be available to resolve your problem. To determine what fixesare available for your IBM product, check the product support site by performingthe following steps:

1. Go to the IBM Support site at the following Web address:

http://www.ibm.com/support

2. Select Support & Downloads Downloads Fixes, updates and drivers toopen the Support & downloads page.

3. From the Category list, select WebSphere.

4. From the Sub-Category list, select WebSphere DataPower SOA Appliances.

5. Click the GO icon to display the list of most recent updates.

6. Click the link for the firmware and documentation download that is specific toyour WebSphere DataPower product.

http://www.ibm.com/software/support/rsshttp://www.ibm.com/supporthttp://www.ibm.com/supporthttp://www.ibm.com/software/support/rss


45/56

If you select the link for the wrong WebSphere DataPower product, select thetab for the correct product (XI50, XS40, or XA35) or select Guided download touse the download wizard.

7. Follow the instructions in the technote to download the fix.

Contacting IBM Support

IBM Support provides assistance with product defects. Before contacting IBMSupport, the following criteria must be met:

v Your company has an active maintenance contract.

v You are authorized to submit problems.

To contact IBM Support with a problem, use the following procedure:

1. Define the problem, gather background information, and determine the severityof the problem. For help, refer to the Software Support Handbook. To access theonline version of this handbook, use the following procedure:

a. Access the IBM Software Support Web page at the following Web address:

http://www.ibm.com/software/supportb. Scroll down to the Additional support links section of the page.

c. Under Support tools, click the Software Support Handbook link.

d. Bookmark this page for future reference.

From this page, you can obtain a PDF copy of the handbook.

2. Gather diagnostic information.

a. Access the product support at the following Web address:

http://www.ibm.com/software/integration/datapower/support

b. Locate the Assistance area of the product support page.

c. Click Information to include to access that technote that lists the

information that is required to report a problem.3. Submit the problem in one of the following ways:

OnlineFrom the IBM Support Web site (http://www.ibm.com/support) , selectSupport & Downloads Open a service request. Following theinstructions.

By phoneFor the phone number to call in your country, refer to Contacts in theSoftware Support Handbook. From the Software Support Handbook Website, click Contacts. In the U.S. and Canada, call 1800IBM-SERV(18004267378) and select option 2 for software.

If the problem you should submit is for a software defect or for missing orinaccurate documentation, IBM Support creates an authorized program analysisreport (APAR). The APAR describes the problem in detail. Whenever possible, IBMSupport provides a workaround that you can implement until the APAR isresolved and a fix is delivered.

Appendix. Getting help and technical assistance 25
http://www.ibm.com/software/supporthttp://www.ibm.com/software/integration/datapower/supporthttp://www.ibm.com/supporthttp://www.ibm.com/supporthttp://www.ibm.com/software/integration/datapower/supporthttp://www.ibm.com/software/support


46/56



47/56

Notices

This information was developed for products and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed in this document inother countries. Consult your local IBM representative for information about theproducts and services currently available in your area. Any reference to an IBMproduct, program, or service is not intended to state or imply that only that IBMproduct, program, or service maybe used. Any functionally equivalent product,program, or service that does not infringe any IBM intellectual property right may

be used instead. However, it is the users responsibility to evaluate and verify theoperation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matterdescribed in this document. The furnishing of this document does not grant youany license to these patents. You can send license inquiries, in writing, to:

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785U.S.A.

The following paragraph does not apply to the United Kingdom or any othercountry where such provisions are inconsistent with local law: INTERNATIONALBUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION AS ISWITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFNON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULARPURPOSE. Some states do not allow disclaimer of express or implied warranties in

certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors.Changes are periodically made to the information herein; these changes will beincorporated in new editions of the publication. IBM may make improvements orchanges in the product(s) or the program(s) described in this publication at anytime without notice.

Product recycling and disposal

This unit must be recycled or discarded according to applicable local and nationalregulations. IBM encourages owners of information technology (IT) equipment toresponsibly recycle their equipment when it is no longer needed. IBM offers a

variety of product return programs and services in several countries to assistequipment owners in recycling their IT products. Information on IBM productrecycling offerings can be found at the following IBM Internet sites:

http://www.ibm.com/ibm/recycle/us/index.shtml

http://www.ibm.com/ibm/environment/products/index.shtml

Esta unidad debe reciclarse o desecharse de acuerdo con lo establecido en lanormativa nacional o local aplicable. IBM recomienda a los propietarios de equiposde tecnologa de la informacin (TI) que reciclen responsablemente sus equipos

http://www.ibm.com/ibm/recycle/us/index.shtmlhttp://www.ibm.com/ibm/environment/products/index.shtmlhttp://www.ibm.com/ibm/environment/products/index.shtmlhttp://www.ibm.com/ibm/recycle/us/index.shtml


48/56

cuando stos ya no les sean tiles. IBM dispone de una serie de programas yservicios de devolucin de productos en varios pases, a fin de ayudar a lospropietarios de equipos a reciclar sus productos de TI. Se puede encontrarinformacin sobre las ofertas de reciclado de productos de IBM en el sitio web deIBM


Notice: This mark applies only to countries within the European Union (EU) andNorway.

Appliances are labeled in accordance with European Directive 2002/96/EC

concerning waste electrical and electronic equipment (WEEE). The Directivedetermines the framework for the return and recycling of used appliances asapplicable throughout the European Union. This label is applied to variousproducts to indicate that the product is not to be thrown away, but ratherreclaimed upon end of life per this Directive.

Remarque: Cette marque s'applique uniquement aux pays de l'Union Europenneet la Norvge.

L'etiquette du systme respecte la Directive europenne 2002/96/EC en matire deDchets des Equipements Electriques et Electroniques (DEEE), qui dtermine lesdispositions de retour et de recyclage applicables aux systmes utiliss traversl'Union europenne. Conformment la directive, ladite tiquette prcise que le

produit sur lequel elle est appose ne doit pas tre jet mais tre rcupr en fin devie.

In accordance with the European WEEE Directive, electrical and electronicequipment (EEE) is to be collected separately and to be reused, recycled, orrecovered at end of life. Users of EEE with the WEEE marking per Annex IV of theWEEE Directive, as shown above, must not dispose of end of life EEE as unsortedmunicipal waste, but use the collection framework available to customers for thereturn, recycling and recovery of WEEE. Customer participation is important tominimize any potential effects of EEE on the environment and human health dueto the potential presence of hazardous substances in EEE. For proper collection andtreatment, contact your local IBM representative.

http://www.ibm.com/ibm/environment/products/index.shtmlhttp://www.ibm.com/ibm/environment/products/index.shtml


49/56

Battery return program

This product may contain sealed lead acid, nickel cadmium, nickel metal hydride,lithium, or lithium ion battery. Consult your user manual or service manual forspecific battery information. The battery must be recycled or disposed of properly.Recycling facilities may not be available in your area. For information on disposalof batteries outside the United States, go to the following IBM Internet site or

contact your local waste disposal facility.


In the United States, IBM has established a return process for reuse, recycling, orproper disposal of used IBM sealed lead acid, nickel cadmium, nickel metalhydride, and other battery packs from IBM Equipment. For information on properdisposal of these batteries, contact IBM at 1-800-426-4333. Please have the IBM partnumber listed on the battery available prior to your call.

For Taiwan:

For the European Union:

Notice: This mark applies only to countries within the European Union (EU).

Batteries or packaging for batteries are labeled in accordance with EuropeanDirective 2006/66/EC concerningbatteries and accumulators and waste batteriesand accumulators. The Directive determines the framework for the return andrecycling of used batteries and accumulators as applicable throughout theEuropean Union. This label is applied to various batteries to indicate that the

battery is not to be thrown away, but rather reclaimed upon end of life per thisDirective.

Remarque: Cette marque s'applique uniquement aux pays de l'Union Europenneet la Norvge.

Les batteries ou emballages pour batteries sont tiquets conformment auxdirectives europennes 2006/66/EC, norme relative aux batteries et accumulateursen usage et aux batteries et accumulateurs uss. Les directives dterminent lamarche suivre en vigueur dans l'Union Europenne pour le retour et le recyclagedes batteries et accumulateurs uss. Cette tiquette est applique sur diverses

batteries pour indiquer que la batterie ne doit pas tre mise au rebut mais pluttrcupre en fin de cycle de vie selon cette norme.

Notices 29
http://www.ibm.com/ibm/environment/products/index.shtmlhttp://www.ibm.com/ibm/environment/products/index.shtml


50/56

In accordance with the European Directive 2006/66/EC, batteries and accumulatorsare labeled to indicate that they are to be collected separately and recycled at endof life. The label on the battery may also include a chemical symbol for the metalconcerned in the battery (Pb for lead, Hg for mercury and Cd for cadmium). Usersof batteries and accumulators must not dispose ofbatteries and accumulators asunsorted municipal waste, but use the collection framework available to customersfor the return, recycling and treatment ofbatteries and accumulators. Customerparticipation is important to minimize any potential effects of batteries andaccumulators on the environment and human health due to the potential presenceof hazardous substances. For proper collection and treatment, contact your localIBM representative.

This notice is provided in accordance with Royal Decree 106/2008 of Spain: The

retail price ofbatteries, accumulators and power cells includes the cost of theenvironmental management of their waste.

For California:

Perchlorate Material - special handling may apply. Refer to the following Web site.

http://www.dtsc.ca.gov/hazardouswaste/perchlorate

The foregoing notice is provided in accordance with California Code ofRegulations Title 22, Division 4.5 Chapter 33. Best Management Practices forPerchlorate Materials. This product, part orboth may include a lithium manganesedioxide battery which contains a perchlorate substance.

Electronic emission notices

Federal Communications Commission (FCC) statementNote: This equipment hasbeen tested and found to comply with the limits for aClass A digital device, pursuant to Part 15 of the FCC Rules. These limits aredesigned to provide reasonable protection against harmful interference when theequipment is operated in a commercial environment. This equipment generates,uses, and can radiate radio frequency energy and, if not installed and used inaccordance with the instruction manual, may cause harmful interference to radiocommunications. Operation of this equipment in a residential area is likely to cause

harmful interference, in which case the user will be required to correct theinterference at his own expense.

Properly shielded and grounded cables and connectors must be used in order tomeet FCC emission limits. IBM is not responsible for any radio or televisioninterference caused by using other than recommended cables and connectors or byunauthorized changes or modifications to this equipment. Unauthorized changesor modifications could void the users authority to operate the equipment.

http://www.dtsc.ca.gov/hazardouswaste/perchloratehttp://www.dtsc.ca.gov/hazardouswaste/perchlorate


51/56

This device complies with Part 15 of the FCC rules. Operation is subject to thefollowing two conditions: (1) this device may not cause harmful interference, and(2) this device must accept any interference received, including interference thatmay cause undesired operation.

Industry Canada Compliance Statement

This Class A digital apparatus complies with Canadian ICES-003.

Avis de conformit la rglementation dIndustrie CanadaCet appareil numrique de la classe A est conforme la norme NMB-003 duCanada.

United Kingdom telecommunications safety requirement

Notice to Customers: This apparatus is approved under approval numberNS/G/1234/J/100003 for indirect connection to publictelecommunication systems in the United Kingdom.

European Union EMC Directive conformance statementThis product is in conformity with the protection requirements of EU CouncilDirective 2004/108/EC on the approximation of the laws of the Member Statesrelating to electromagnetic compatibility. IBM cannot accept responsibility for anyfailure to satisfy the protection requirements resulting from a non-recommendedmodification of the product, including the fitting of non-IBM option cards.

This product hasbeen tested and found to comply with the limits for Class AInformation Technology Equipment according to CISPR 22/European Standard EN55022. The limits for Class A equipment were derived for commercial andindustrial environments to provide reasonable protection against interference withlicensed communication equipment.

Attention: This is a Class A product. In a domestic environment this product maycause radio interference in which case the user may be required to take adequatemeasures.

European Community contact:

IBM Technical RegulationsPascalstr. 100, Stuttgart, Germany 70569Telephone: 0049 (0)711 785 1176Fax: 0049 (0)711 785 1283Email: [email protected]

Japanese Voluntary Control Council for Interference (VCCI)

statement

The following is a summary of the VCCIJapanese statement in the box above.

Notices 31


52/56

This is a Class A product based on the standard of the Voluntary Control Councilfor Interference by Information Technology Equipment (VCCI). If this equipment isused in a domestic environment, radio disturbance may arise. When such troubleoccurs, the user may be required to take corrective actions.

Taiwanese Class A warning statement

Chinese Class A warning statement

Korean Class A warning statement

Russian Class A warning statement

Trademarks

IBM, IBM (logo), DataPower, developerWorks, Passport Advantage, Redbooks, andWebSphere are registered trademarks of the International Business MachinesCorporation in the United States or other countries.

Adobe is either a registered trademark or trademark of Adobe SystemsIncorporated in the United States, and/or other countries.

32 IBM WebSphere DataPower SOA Appliances:

9235 installation

Documents