Note:
This section is applicable if you want to install the Workbench
plug-ins in standalone mode, that is, not as part of the full webMethods
EntireX installation.
Prerequisites for all EntireX components are described centrally in the Release Notes.
Additionally, the Eclipse feature com.softwareag.wsstack.ui_1.2.1.009 is a prerequisite for installing the Workbench plug-ins in standalone mode. Use the directory <EntireX Installation>/../wss/v12/eclipse/updates as a local update site.
This installation contains the following Eclipse feature in the folder <EntireX Installation>/eclipse/updates. The ZIP file contains an archived update site.
com.softwareag.entirex.ide.eclipse.exx-8.0.zip
See EntireX Workbench for more information.
For installation in Eclipse headless mode, use the following command:
java -classpath $ECLIPSE_HOME/startup.jar org.eclipse.core.launcher.Main -application org.eclipse.update.core.standaloneUpdate -data $WORKSPACE -command install -featureId com.softwareag.entirex.ide.eclipse.exx -version 8.0.0.0 -from $SAG/exx/v80/eclipse/updates/com.softwareag.entirex.ide.eclipse.exx-80.zip
This is recommended for all UNIX platforms that are not Linux. See also Detailed Instructions for UNIX Platforms other than Linux.
Note:
The screenshots below were taken with Eclipse 3.1.
To install the plug-in
Using the installation menu, copy the Eclipse features to your disk. By default, the features are copied to the directory Eclipse/Updates in the EntireX installation directory. See Scope of the EntireX Workbench for list of features.
Start Eclipse and use the plug-in installation feature of Eclipse as described below.
Choose to display the Eclipse Feature Updates screen. Choose option Search for new features to install.
Click to display the Eclipse Install screen. The list of displayed sites may vary depending on your installation.
In the right-hand area of the window, click New Archived Site.
In the file chooser dialog, navigate to the location of the archived update sites listed under Scope.
Choose New Archived Site..., and select the archived sites listed under Scope and press .
Unfold the trees and, select the features required and click to display the legal notices.
Accept the terms of the license agreement and click to display the next screen.
Specify the installation location. This can be inside the Eclipse installation or in an extension location. Click to start the installation.
Verify the certificate that signs the feature.
The installation verifies the certificate used to sign the JARs. This verification may fail with the following message:
"You are about to install a signed feature.
The
certificates used to authenticate this feature are not recognized.
The
provider of this feature cannot be verified."
If both certificates (the one used to sign the file and the "according to") are valid, you can continue the installation with .
Restart Eclipse.
Before you can use the views and the editor of the plug-in, you must configure the license. You need the license file exx80.xml of webMethods EntireX 8.0.
To configure the license
Choose and set the location of the license file.
Or:
Set the license file location when you use one of the views, the
IDL Editor, or the Java Wrapper. A dialog asks
for this location on the first use.
The location of the license file has to be set for each Eclipse workspace you use.
No Eclipse is delivered with EntireX for UNIX platforms other than Linux. The distribution medium contains a Workbench package for use on Windows or Linux. Alternatively, the Workbench can be used in command-line mode on some non-Linux UNIX platforms, using following steps:
Install Eclipse
Download the appropriate Eclipse distribution from
www.eclispe.org.
| Platform | Eclipse Distribution |
|---|---|
| Solaris 9 and 10 (64-bit) | eclipse-SDK-3.1.2-solaris-gtk.zip eclipse-SDK-3.1.2-solaris-motif.zip |
| AIX 5.3 (64-bit) | eclipse-SDK-3.1.2-aix-motif.zip |
| HP-UX 11.11 (64-bit), HP-UX 11.23(64-bit) for PA-RISC |
eclipse-SDK-3.1.2-hpux-motif.zip |
Install the EntireX Plug-ins
Install the plug-ins of EntireX into this Eclipse distribution, using
headless mode. See Installation
in Eclipse Headless Mode. This is not supported on the
following platforms, because no Eclipse distribution exists for these:
SUSE Linux Enterprise Server 9 for IBM zSeries (64-bit)
Red Hat Enterprise Linux 4 for IBM zSeries (64-bit)
HP-UX 11.23 for Itanium2
Using the command-line mode is the same on all platforms. See Using EntireX Workbench from a Command Line and the command-line mode documentation of the individual Workbench components for details.
Uninstalling the EntireX Workbench plug-ins is a two-step process: first you have to disable the plug-ins, then you can uninstall them.
To disable the plug-ins
Open Eclipse and choose .
Select the EntireX Plug-ins and choose .
Confirm that you want to disable the feature.
Repeat the steps for the Web Services Stack plug-in.
Restart Eclipse to apply the changes. The plug-ins are now disabled and can be uninstalled as described below.
To uninstall the plug-ins
Choose again . Make sure the Show Disabled Features filter in the toolbar is active.
Select the EntireX Plug-ins and choose .
Confirm that you want to uninstall this feature.
Repeat the steps to uninstall the Web Services Stack plug-in.
Restart Eclipse to apply the changes.
