How to install and check the Eclipse Management plugin for the DataPower appliance.
|How to install and check the Eclipse Management plugin for the DataPower appliance.|
B. Install Eclipse. You can get this from www.eclipse.org, and it requires JRE 1.4.2 or later to run. If you have difficulty installing or using this, please contact Eclipse.
C. Install the DataPower Eclipse plugins
General set up. Do these steps if you are installing either or both plugins.
1. Open a web browser to http://www-01.ibm.com/software/integration/datapower/support/.
2. Under the download sections is the option ‘Firmware and documentation download‘
3. The next page has a section in bold ‘Documentation and files‘, follow the link to the ‘Fix Central download site‘.
4. Select the product group ‘WebSphere‘ and click continue.
5. Select the product ‘WebSphere DataPower SOA Appliances‘ and click continue.
6. Select the appropriate firmware level you are running on your system (eg. 3.8, 3.7.3, 3.7.2, 3.7.1).
7. Keep the Platform selected to ‘All’ and continue.
8. Login with your Public IBM ID Credentials as used in other http://www.ibm.com services.
9. The next page, ‘Identify Fixes’ will have Browse fixes selected as ‘All’, click continue at the bottom of the page.
10. Select ‘All‘ on the Results per page option available on the right hand side of the download list.
11. After making all results available, search for ‘ResourceKit’ and select the checkbox beside the kit that specifies your device type (XA,XS, XI, XB, XM).
12. Scroll to the bottom of the page to select your download method and click Continue.
13. The next page is a User Agreement which will need to be reviewed.
14. The final page will allow you to download the Resource Kit.
15. After extracting the ResourceKit you will find the eclipse plugins inside the ‘eclipse’ directory.
To install the Eclipse Management plugin:
1. Download the Eclipse Management Plugin.
2. Download the root-ca-cert.pem.
3. Download the “Eclipse Management Plug-in” pdf for documentation.
4. On a Unix machine: Import root-ca-cert.pem to lib/security/cacerts trusted certificate store.
5. On a Windows machine: Users must add the root-ca-cert.pem certificate to JRE’s keystore using the Java keytool. Follow these steps:
i. Copy the root-ca-cert.pem file to c:\temp.
ii. Open a command prompt (Start->Run->”cmd”)
iii. Change to Java-Dir/lib/security (cd c:\Program Files\Java\j2re<version
iv. Add the certificate to keystore (..\..\bin\keytool.exe -import -alias dproot -file
\temp\root-ca-cert.pem -keystore cacerts). When prompted by keytool for the
keystore password, use “changeit”, if the default password has not been changed.
6. Unzip the Eclipse Management Plugin zip file into the Eclipse home directory.
7. Open Eclipse. Close down the introductory screen and go to the workbench.
8. In the menu bar at the top of the screen, select Windows>CustomizePerspective.
9. Click on the “Commands” tab and make sure the “DataPower Management” selection is checked. This will add a new button with the DataPower logo in the main Eclipse tool bar. Select the button to switch to Management Perspective. As an alternative, open the Management Perspective through the OpenPerspective button on the upper right side of the tool bar.
In order for the Management plugin to work, you must enable web and XML management:
10. Log into the DataPower device in the default domain.
11. Click the Network menu bar on the left to expand the selection area, and then click “Web Management” (under “Management”).
12. Make sure that web management is on by selecting the radio button next to “enabled” in the Admin field.
13. Click “Apply” if you made any changes.
14. Click the Network menu bar on the left to expand the selection area, and then click “XML Management” (under “Management”).
15. Make sure that XML management is on by selecting the radio button next to “enabled” in the Admin field.
16. Click “Apply” if you made any changes.
To check that the Management plugin is working:
17. Open Eclipse.
18. Click on the DataPower logo icon to enter the management view.
19. The upper left section of the view is a box entitled “Device Manager.” Along the top of the Device Manager box is a series of icons. The left-most icon is a chart with a plus sign on it, and represents adding a device. Click this icon.
20. Click “yes” to add a device.
21. Fill out the hostname, username, and password. Click “OK.” You should now see the device listed in the Device Manager box.
22. Click on the plus sign next to the box’s name to expand it.
23. You will see “Control Panel” as an option under the box. Click on this. You should see the control panel appear.
24. Click on the plus sign next to “File Management” to expand it.
25. Under File Management, click on “image.” This pulls up a table.
26. Drag and drop a small test file from your client machine to the table. Make sure it appears in the table afterwards.
27. Log into the DataPower appliance.
28. On the control panel, click “File Management.”
29. Select “image” from the dropdown. Your file should now be there.
To install the Eclipse CoProcessor plugin:
1. Download the Eclipse XSLT Coproc Plugin (Review Section C. above)
2. Download “Eclipse XSLT Coproc Plugin Instructions” for related documentation.
3. Unzip the Eclipse XSLT Coproc Plugin into the Eclipse home directory.
4. Open Eclipse. Close down the introductory screen and go to the workbench.
5. In the menu bar at the top of the screen, select Windows>CustomizePerspective.
6. Click on the “Commands” tab and make sure the “DataPower Coprocessor” selection is checked. This will add four buttons to your main button bar: upload, compile,
transform, and stylesheet parameter. All four buttons have a pull-down menu for a history of the recently used files.
In order for the Coprocessor plugin to work, you must create a XSL Coprocessor service on the DataPower device to interact with the Eclipse plug-in. Please:
7. Log into the DataPower device.
8. Click the Services menu bar on the left to expand the selection area, and then click “XSL Coprocessor” (under “XSL Service”).
9. Click Add to create a new service.
10. Enter a name for the new service in the Name field.
11. Enter an integer in the Port Number field (must be unique throughout the device).
12. Click Apply.
13. Click Save Configuration.
To check that the Coprocessor plugin is working:
14. Open Eclipse.
15. Select Window>Preferences.
16. In the left hand pane of the dialog you will see “DataPower Coprocessor”. Click on it.
17. Type in your hostname (or ip address) and the port number used for XML Coprocessor service. You can check which port this is by going to the DataPower appliance, clicking the Services menu bar on the left to expand the selection area, and then clicking “XSL Coprocessor Service” (under “XSL Service”).
18. Click Apply then OK.
19. Create a new project for your test.
i. Go to File>New>Project.
ii. Select “Simple” or “General” as the type.
iii. Highlight the “Project” folder under Simple or General and click “Next”.
iv. Give your project a name.
v. Click “Finish”.
20. Create a file called text.xsl on the local file system. In it, place the following:
<?xml version=”1.0″ encoding=”UTF-8″ ?>
<xsl:stylesheet version=”1.0″ xmlns:xsl=”http://www.w3.org/1999/XSL/Transform”>
<confirmation>I got your message.</confirmation>
21. Create a file called test.xml on the local file system. In it, place the following:
<?xml version=”1.0″ encoding=”UTF-8″?>
22. Look for your test project in the lower left panel of Eclipse.
23. Right click the project, and select “Import.”
24. Choose “File System.” (This may be under General.)
25. Click “Next.”
26. Browse to your test files and import them. Click “Finish.” You will now see them in your project. (You might have to expand the folder)
27. Expand the project, and highlight the xsl file.
28. On the main tool bar you will see a button with a downward-pointing arrow. Hover over it and check that it is the “Compile XSLT Stylesheet” button. Click it.
29. You will get a confirmation dialog. Click OK. The file will compile, and you will get a pop-up box confirming this. Click OK to dismiss it.
30. After successful compilation, highlight the xml file.
31. The button to the right of the compile button is the transform button. Hover over it and you will see “Transform XML input with XSLT Stylesheet.”
32. Associated with the “Transform XML” button is an arrow. Click the arrow and select the test.xsl file.
33. You will get a dialog asking if you want to transform test.xml with test.xsl. Click “OK. The file will compile.
34. A TRANSFORM file will appear in your project. Double-click to open it. The contents will look like:
<?xml version=”1.0″ encoding=”UTF-8″?>
<message><confirmation>I got your message.