Installing the Plug-in Development Kit Eclipse plug-in

The Plug-in Development Kit (PDK) includes an Eclipse plug-in that you can use in your Eclipse or Rational® Application Developer environment to create and edit some of the configuration files that are used with patterns.

Before you begin

To use the Eclipse plug-in, verify that your environment includes the following prerequisites:
  • Java™ SE 6 or later, 32-bit or 64-bit
  • Eclipse version 3.6.2 or later, 32-bit or 64-bit. The Eclipse IDE for Java EE Developers version is recommended.

The Java Platform, Enterprise Edition version is recommended.

Procedure

  1. Start Eclipse to load the Eclipse SDK workspace.
  2. Click Help > Install New Software. The Available Software window is displayed.
  3. Click Add to add a software repository. The Add Repository window is displayed.
  4. Click Archive to define a local Eclipse repository archive.
  5. Go to the directory where you installed and unpacked the Plug-in Development Kit. For installation details, see "Installing the Plug-in Development Kit."
  6. Select the compressed file com.ibm.maestro.plugin.pdk.site.zip and click Open.
  7. In the Name field of the Add Repository window, specify a name for the new repository archive, such as PDK Eclipse plug-in.
  8. Click OK.
  9. After a moment, the Name area is updated to display the name IBM Workload Plug-in Development Kit.
  10. Click Select All.
  11. Clear the following check box: Contact all update sites during install to find required software.
  12. Click Next.
  13. Wait for the installation to complete.

What to do next

Modify your Eclipse environment preferences to specify the system access information for the remote Cloud Pak System Software for Power® environment by clicking Window > Preferences > IBM Plug-in Toolkit. After you configure the Host name or IP address, User ID, and Password, click Test Connection to confirm that the PDK can connect to Cloud Pak System Software for Power.
Tip:

If the connection fails with a handshake error logged to the Plug-in Development Kit console, add this line to the eclipse.ini file: -Djsse.enableSNIExtension=false and restart the Eclipse client.

Make sure that no warnings are displayed after a successful connection with the Plug-in Development Kit console in the Eclipse client.

From this preferences page, you can access Cloud Pak System Software for Power by clicking the Open Deployer Console link. You can also enable debugging support for your projects and choose to deploy the plugin.unlock plug-in with your plug-in projects.

Use these two perspectives for your work with the PDK Eclipse plug-in:
Workload Plug-in Development
Use this perspective when you are developing projects. Open this perspective by clicking Window > Open Perspective > Other > Workload Plug-in Development.

The Welcome Page in the Workload Plug-in Development perspective provides links to wizards to assist you when you create projects in the PDK. To reopen the Welcome Page if you close it, click Show Welcome Page in the Project Explorer or Package Explorer views. If you do not see either of these views, you can open the Workload Plug-in Development perspective, and then click Window > Reset Perspective > OK.

Workload Plug-in Runtime
Use this perspective to manage test deployments. Open this perspective by clicking Window > Open Perspective > Other > Workload Plug-in Runtime.