Technote (troubleshooting)
Problem(Abstract)
If you need to reconfigure an IBM WebSphere DataPower SOA appliance you can use the "reinitialize" CLI command.
Resolving the problem
The reinit CLI command will allow you to reconfigure an IBM WebSphere DataPower SOA appliance. The reinit CLI command will allow you to delete (not erase) all existing configuration and data from an IBM WebSphere DataPower SOA appliance.
When the reinitialize command completes, your network IP configurations, user accounts and other configuration options, are no longer accessible.
You will only be able to connect to the appliance using the serial connection.
You will need to configure your Ethernet and all other settings again using the information in the product information center available from our library page.
Important points:
- Make sure you have a working serial connection to the appliance.
- The admin password will revert to the initial value of "admin" after the command executes.
- A firmware image must be on the appliance prior to running the command. The firmware image used for the last upgrade of the device is removed from the file system automatically when the device reboots. Use DataPower's File Management WebGUI option to confirm you have an image or use these CLI commands:
xi50# configure
xi50# dir image:
If an image file is not found, you will need to load a firmware image to the appliance into the image:/// directory. For example: you can use the WebGUI file management options or from the Control Panel, choose the System Control icon, the under Boot Image, choose the firmware file upload options.
- Use the DataPower File Management to confirm you have sufficient file space. If you don't have sufficient file space, you can delete domains or other files to free up file space to allow the firmware image to be loaded to the appliance.
- reinit is a CLI command available in the config-flash# mode, for example:
xi50# configure terminal
Global configuration mode
xi50(config)# flash
Flash configuration mode
xi50(config-flash)#
reinit <filename>
Where <filename> represents a firmware image contained within the image:/// directory. This will be the firmware image which will be installed during the reinit process
- After the appliance reboots:
- If the firmware image used was for V5 or newer, you will need to accept the license at first logon to the WebGui
- Configure the appliance per the instructions in the appliances configuration guide. This and other documentation on the appliance is available from our library page.
The command is documented in the information center. This and other documentation on the appliance is available from our library page.
If your appliance has the optional RAID (hard drives) reinitialize the RAID using the information in our RAID technote.
If your appliance has the optional HSM, reinitialize the HSM following the instructions in our HSM book or infocenter for your release of the product. These are available on our library page.
| Segment | Product | Component | Platform | Version | Edition |
|---|---|---|---|---|---|
| Business Integration | WebSphere DataPower Low Latency Appliance XM70 | Not Applicable | Firmware | 3.8, 3.8.1, 3.8.2, 4.0.1, 4.0.2 | Edition Independent |
| Business Integration | WebSphere DataPower XML Security Gateway XS40 | Not Applicable | Firmware | 4.0.2, 4.0.1, 3.8.2, 3.8.1, 3.8 | Edition Independent |
| Business Integration | WebSphere DataPower XML Accelerator XA35 | Not Applicable | Firmware | 4.0.2, 4.0.1, 3.8.2, 3.8.1, 3.8 | Edition Independent |
| Business Integration | WebSphere DataPower B2B Appliance XB60 | Not Applicable | Firmware | 4.0.2, 4.0.1, 4.0, 3.8.2, 3.8.1, 3.8 | Edition Independent |
| Business Integration | WebSphere DataPower B2B Appliance XB62 | 4.0.2, 4.0.1 | All Editions | ||
| Business Integration | WebSphere DataPower Integration Appliance XI52 | 4.0.2, 4.0.1 | |||
| Business Integration | WebSphere DataPower Service Gateway XG45 | 4.0.2 | All Editions |
Rate this page:
Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.