Add DataPower appliances to the DataPower appliance manager

We can use the DataPower appliance manager provided with the product to administer a DataPower appliance. After we add an appliance to the DataPower appliance manager, we can make it part of a managed set of appliances if we want the DataPower appliance manager to keep the shared appliance settings for this appliance synchronized with the shared appliance settings of the other appliances that are part of that managed set.

• Verify that the appliance that you are adding is at a Version 3.6.0.4 or higher firmware level. The appliance manager cannot manage an appliances that is not at a Version 3.6.0.4 or higher firmware level.

• Verify that the appliance manager can communicate with the port used for the XML Management interface AMP endpoint on the appliance. The appliance manager uses this port to send commands to an appliance.

• Verify that the appliance can communicate with the port used for the DataPowerMgr_inbound_secure endpoint on the deployment manager. The appliance uses this port to send events to the appliance manager.

• Verify that the Appliance Management Protocol (AMP) endpoint is enabled for each appliance. If the XML Management interface AMP endpoint was disabled during installation, use the DataPower WebGUI to enable the AMP endpoint.

• Verify that there is not a firewall between the deployment manager and the appliances that will be part of a managed set. If there is a firewall between the deployment manager and the appliances, that firewall might prevent the appliance manager from communicating with the appliances in a managed set.

We can use the console to add a new DataPower appliance or to access the DataPower WebGUI. To access the DataPower WebGUI, in the console, click Servers > DataPower > Appliances, and then click Launch. Complete the following steps to add a add a new DataPower appliance.

Avoid trouble: Remember that the XML management interface port, which defaults to port number 5550, is different from the Web Management Service port, which defaults to port number 9090. The DataPower appliance manager uses the XML management interface port to manage the DataPower appliances. Use Web Management Service port to access the WebGUI on the DataPower appliance. We can use the same user ID and password to access both the XML management interface and the WebGUI. gotcha

1. In the console, click Servers > DataPower > Appliances > New.

2. Specify a unique name for the appliance in the Name field. An appliance name must be unique and cannot contain an invalid character. The name field cannot contain the characters # $ @ \ / , : ; " * ? < > | = + & % or '.

3. Specify an IP address or fully qualified host name in the Host name field.

4. Specify the XML management interface port that the DataPower appliance uses in the Administrative port field.

5. Specify the ID to use to connect to the DataPower appliance in the User ID field.

6. Specify the password to associate with the user ID in the Password and Verify password fields.

7. Click OK to add the new appliance.

Results

The DataPower appliance manager is managing this appliance.

What to do next

We can change appliance settings, add the appliance to a managed set, or remove the appliance from the DataPower appliance manager.

Avoid trouble: For security reasons, the DataPower appliance manager does not include Crypto material, such as keys and certificates, in the shareable settings and domain versions that it creates. Therefore, after we add an appliance to the appliance manager, you must manually add any Crypto material to apply for the new appliance.gotcha

Subtopics

• Modify DataPower appliance settings
  We can use the console to modify the shared appliance settings for an appliance.

• Remove a DataPower appliance
  We can use the console to remove an appliance from the DataPower appliance manager.

• Appliance collection
  Use this page to add, change, or remove a DataPower appliance in the DataPower appliance manager. We can also use this page to view information about the DataPower appliances that are in the appliance manager. Adding appliances to a DataPower appliance manager enables you to automatically keep synchronized the settings for all of the appliances that are in a DataPower appliance manager managed set.

• New appliance settings for the DataPower appliance
  Use this page to specify the settings for an appliance that you are adding to the DataPower appliance manager.

• Appliance settings
  Use this page to change the settings for a DataPower appliance. Appliances are added to the DataPower appliance manager to synchronize the firmware, shareable appliance settings and managed domains of a group of appliances called a managed set.

Related concepts

WebSphere DataPower appliance manager overview

Related tasks

Modify a managed set

Set up the DataPower appliance manager

dpManagerCommands (AdminTask)