Hints and tips

You receive the following message when you are running the installer:

Windows error 216 occurred while loading the Java VM

This message is produced if you try to run the installer on a 32-bit Windows system. WebSphere Appliance Management Center supports 64-bit operating systems only.

Adding an IBM® WebSphere DataPower® XC10 Appliance firmware image to the repository by using Mozilla Firefox Version 3.6 on Windows fails with the following message:

The uploaded file was empty.

A browser bug means that large files are not uploaded successfully. Use a different browser to upload the image (for example, Internet Explorer or a newer version of Mozilla Firefox) or use the option to upload from a remote location URL.

The messages.log file contains entries of the following form:

CWWKS4001E: 
The security token cannot be validated. 
This can be for the following reasons
 - The security token was generated on 
   another server using different keys.
 - The token configuration or the security 
   keys of the token service which created 
   the token has been changed.
 - The token service which created the 
   token is no longer available.

This error occurs when a browser caches an LTPA security token from a different instance of the server and is attempting to pass on requests to this server. This error can occur if, for example, WebSphere Appliance Management Center is reinstalled.

The error is benign. A new LTPA security token is provided to the browser.

You cannot find the link to the iKeyman program in the installation_directory/bin directory.

On Linux, when you provide an installation path that contains a space, the installer attempts to create the link in a parallel path where the space is replaced by an underscore (_). For example, installing in /opt/ibm/w amc results in an attempt to create the link in /opt/ibm/w_amc/bin.

If the installer is unable to create this path, you can find the program in the installation_directory/jre/jre/bin directory.

You could not deploy configuration by using deployment policy from default domain with WebSphere Appliance Management Center.

com.ibm.datapower.wamt.amp.DeviceExecutionException: 
WAMT0433E: 
The [hostname]:[port] appliance cannot load 
the [domain] domain.
Status: error - deployment policy [policy] 
not found when attempting to deploy the 
configuration to an appliance.

Before version 5.0 firmware, the implementation of the Appliance Management Protocol on the appliance, by design, exports only the objects from the default domain that are not referenced by a service. Therefore, any deployment policies on the default domain cannot be exported.

You can export the deployment policy by using the appliance WebGUI and then set the deployment policy as the deployment policy for the target domain by using WebSphere Appliance Management Center.

Alternatively, create the deployment policy in a domain other than the default domain.

This problem is resolved in the version 5.0 firmware.

You receive the following message in the WebSphere Appliance Management Center installer: cannot execute binary file.

The WebSphere Appliance Management Center installation program exits with an error because the wrong installer for the operating system was chosen or an unsupported operating system is being used.

./install.bin: line 3320: 
/tmp/install.dir.9187/Linux/resource/jre/jre/bin/java: 
cannot execute binary file

Check that the system on which you are installing uses a 64-bit word length. 32-bit systems are not supported.

You can receive the message in the following scenarios:

You receive the message when you attempt to upgrade an appliance from firmware versions that are earlier than version 6.0.0.0 to firmware versions 6.0.0.0, or later

You cannot use WebSphere Appliance Management Center to upgrade an IBM WebSphere DataPower appliance from a firmware version that is earlier than version 6.0.0.0 to a firmware version of 6.0.0.0, or later.

The Appliance Management Protocol implementation on firmware that is earlier than version 6.0.0.0 is unable to deploy firmware images that are larger than 175 MB. Some IBM WebSphere DataPower firmware images at version 6.0.0.0, or later, exceed this limitation. Because WebSphere Appliance Management Center handles the firmware upgrade process through the Appliance Management Protocol, it is not possible to use WebSphere Appliance Management Center to upgrade an appliance from a firmware version that is earlier than version 6.0.0.0 to a firmware version of 6.0.0.0, or later.

This issue is resolved in firmware versions 6.0.0.0, or later. WebSphere Appliance Management Center can deploy firmware images that are larger than 175 MB to IBM WebSphere DataPower appliances that are running firmware at version 6.0.0.0, or later.

To allow WebSphere Appliance Management Center to deploy future firmware updates to your appliances, you must manually upgrade the firmware of your appliances to version 6.0.0.0, or later, by using the WebGUI or Command Line Interface of the appliances.

You receive the message when you attempt to upgrade an appliance to firmware versions that are earlier than version 6.0.0.0

The Appliance Management Protocol implementation on the existing firmware on the appliance is unable to deploy firmware images that are larger than 136 MB when base64 encoded. For IBM WebSphere DataPower firmware version 4.0.1 and later, some images exceed 136 MB.

This issue is resolved for IBM WebSphere DataPower firmware versions 3.8.0.15, 3.8.1.15, 3.8.2.6, 4.0.1.3, and later.

Use one of the following options:

• Deploy one of the versions for which the issue is resolved, and then move to your required version. For example, to move from version 4.0.0.0 to 4.0.2.0, deploy version 4.0.1.3 and then deploy version 4.0.2.0.
• Deploy your required firmware version directly by using the appliance WebGUI or CLI.

When you are deploying a domain configuration export, the Appliance Management Protocol implementation on the appliance attempts to switch to the named domain before it completes the import, which results in the error.

This issue is resolved in version 4.0.1 of the firmware and later.

For earlier versions of the firmware, you can use a backup of the appliance configuration that contains the required application domain, rather than an export of the domain configuration. In the appliance WebGUI, this action corresponds to selecting Create a backup of one or more application domains, rather than selecting Export configuration and files from the current domain.

Valid firmware downgrade options are not shown in WebSphere Appliance Management Center.

You can use WebSphere Appliance Management Center to manage IBM WebSphere DataPower appliance firmware. Typically you can use this action to update firmware on managed appliances, but you can also use the feature to downgrade to older firmware versions. In some cases, valid firmware downgrade options are not displayed in WebSphere Appliance Management Center.

WebSphere Appliance Management Center determines that a IBM WebSphere DataPower firmware image is suitable for deployment to a IBM WebSphere DataPower appliance only if the appliance model and type match the firmware and the firmware image provides all of the features that are currently enabled on the appliance.

Over time, new appliance features are added to the IBM WebSphere DataPower firmware images. After you upgrade an appliance to a firmware level that includes a new feature, WebSphere Appliance Management Center does not consider that older firmware images without this feature are valid for deployment to the appliance.

For example, firmware version 5.0.0.3 introduced an IPv6 feature. After an appliance is upgraded to version 5.0.0.3, WebSphere Appliance Management Center considers that only those firmware images that provide the IPv6 feature are valid for the appliance. This situation means that firmware images before version 5.0.0.3 cannot be deployed to the appliance by using WebSphere Appliance Management Center.

If you want to downgrade an appliance to an older firmware version and that firmware version does not support all of the appliance features that are provided by the currently deployed version, you must downgrade the firmware by using the IBM WebSphere DataPower appliance WebGUI or CLI. If you use the WebGUI, you are warned that the firmware that you are deploying does not contain support for all of the currently deployed features but you can choose to continue anyway.

Following the expiry of IBM WebSphere DataPower certificates that are used by default to secure the WebGUI and XML manager on 9235 appliances that are running firmware levels before version 5.0.0.0, what do I have to do to configure WebSphere Appliance Management Center to manage these appliances?

The default certificates that are used to secure access to the WebGUI and the XML manager on 9235 appliances that are running firmware levels before version 5.0.0.0 expired in June 2013. The problem is described in detail in this Technote: DataPower default WebGUI certificate is expiring or expired; an internal DataPower CA certificate is expiring or expired (www-01.ibm.com/support/docview.wss?uid=swg21633306).

Upgrade to the June 2013 release, or later, of WebSphere Appliance Management Center. This release allows expired certificates to be accepted by WebSphere Appliance Management Center. You can use your appliance in the same way as any other appliance and no further changes are required.