Deploying a plug-in

To deploy a new plug-in in your environment, you need to create an update site and install it on the development workstations. But first, you must reference your plug-in in a feature and add this feature to an update site.

Procedure

Follow these steps if you do not have a feature, nor an update site to deploy your plug-in.

  1. Creating a Feature
    1. You must be in the Plug-in Development perspective to create a Feature project.
    2. Select File > New > Project to choose the project to create.

      In the window that opens, select Feature Project in the section Plug-in Development. Then, click Next to open the creation wizard.

      Figure 1. Selecting the Feature Project
      Selecting the Feature Project
    3. In the Feature Properties page, enter a Project name and click Next.
      Figure 2. Properties of the Feature
      Properties of the Feature
    4. In the Referenced Plug-ins and Fragments page, select the plug-in to reference.
      Figure 3. Referenced Plug-ins and Fragments
      Referenced Plug-ins and Fragments
    5. Then, click Finish to start the feature creation.

      The new feature and its components are added to the Package Explorer view.

      Figure 4. Feature components
      Feature components
  2. Creating an Update Site.
    1. You must be in the Plug-in Development perspective to create an Update Site project.
    2. Select File > New > Project to choose the project to create.

      In the window that opens, select Update Site Project in the section Plug-in Development. Then, click Next to open the creation wizard.

      Figure 5. Selecting the Update Site Project
      Selecting the Update Site Project
    3. In the first page of the creation wizard, enter a Project name and click Finish to start the creation of the update site project.
      Figure 6. Properties of the update site project
      Properties of the update site project

      When the creation is finished, the Site Map tab is displayed in the Update Site editor where you must add the features to be published.

    4. To add the feature that was created in the previous step, create a category by clicking New Category. Modify the ID and Name of the category.
      Figure 7. Creating a CategoryCreating a Category
    5. Select the category and click Add Feature
    6. Select a feature in the list that opens and click OK.
      Figure 8. Selecting a feature to add
      Selecting a feature to add

    7. Then, click Build All to start the generation of the update site, that is the files to be published on other environments.

      The new update site and its components are added to the Package Explorer view.

      Figure 9. Update Site components
      Update Site components

      For complete information on the features and the update sites, consult the sections Reference > Wizards and Dialogs > New Project Creation Wizards and Reference > Editors in the Plug-in Development Environment (PDE) User Guide of the Eclipse documentation.

  3. Installing the update site on the development environment
    1. On the developer workstation, open the Pattern Driven Programming perspective of Rational Programming Patterns.
    2. Select Help > Install New Software.
    3. In the Available Software page that opens, you must add, in the list, the update site to take into account (if it is not yet referenced).
      To do so, click Add and select the directory of the update site by clicking Local.
    4. Enter a name to facilitate its reuse and click OK.
      Figure 10. Selecting the location of the update site to add
      Selecting the location of the update site to add
    5. Select the new added element and click Next.
    6. In the Install Details page, click Next.
    7. Accept the terms of the license agreement and click Finish.
    If you have a web server, copy the update site onto this server to facilitate the deployment.
    Attention: You need to restart Rational Programming Patterns for the changes to take effect in your development environment.

    For more information on new software installation, consult the section Workbench basics > Tasks > Updating and installing software in the Eclipse documentation.


Feedback