Using Your Own Eclipse

Installing NaturalONE via the Software AG Installer is a prerequisite for using NaturalONE in your existing Eclipse environment. This installation provides the plugins of NaturalONE in the directory <your-installation-directory>/naturalone/updates.


Installing NaturalONE in your Own Eclipse Environment

The typical way to install NaturalONE is via the Software AG Installer. However, you may prefer to use an already existing Eclipse environment. In this case, specific versions of Eclipse and Java are required. See Eclipse Prerequisites and Java Prerequisites in the section System Requirements.

Install the plugins via Eclipse Help > Install New Software.

Important before you start your installation:

  1. During installation on the very first Available Software dialog, deselect the item Contact all update sites during install to find required software, as this option may lead to unintended updates on other Eclipse plugins.

  2. The NaturalONE plugins are not signed. Therefore, you will see a warning dialog.

    Choose Select All and then Trust Selected on this dialog.

Step 1 - Install the NaturalONE Eclipse plugins in your own Eclipse

The following plugin installation order is mandatory:

  1. com.softwareag.cis.ide-<version>.zip

  2. com.softwareag.naturalone.natural.ide-one<version>.zip

Important
Should you intend to install Application Testing, Business Services, or Code Generation, then the following plugin must be installed before all other gen plugins:

com.softwareag.naturalone.gen.testing-one<version>.zip

All other plugins can then be installed in any order.

Step 2 - Copy naturalone.properties

Copy the file naturalone.properties from the directory <your-installation-directory>/naturalone/updates of the NaturalONE installation to the directory of your own Eclipse installation that contains the file eclipse.exe. Normally, this is the root folder of the Eclipse installation.

If the installation from the Software AG Installer is on the same machine on which your own Eclipse installation is located, then you are done, and you can use NaturalONE from within your own Eclipse environment.

Step 3 - Adjustments if the original installation is not accessible

  1. Copy the following directories from <your-installation-directory>/naturalone to a new directory that is accessible from your own Eclipse environment:

    /apache-tomcat
    /njx
    /samples

  2. Adjust the corresponding paths in the file naturalone.properties accordingly.

Installing NaturalONE Fixes in your Own Eclipse Environment

Step 1 - Install fixes with the Update Manager

Use the Software AG Update Manager to install the latest fixes of NaturalONE into your installation from the Software AG Installer.

After the update installation you will find the directory <your-installation-directory>/install/fix/backup/Designer/repo from where the fixes can be installed.

Step 2 - Add a local Software Site

If your installation from the Software AG Installer is on the same machine, as your own Eclipse environment you can define this directory as local Software Site for your Eclipse.

If your installation from the Software AG Installer is on a different machine, copy this directory with all its subfolders to your machine and define it there as local Software Site.

Step 3 - Install updates in your Eclipse

Choose Help > Check for Updates, deselect all other sites and select the NaturalONE update site. Then install the update.

Step 4 - Copy other updated directories

Copy the following directories from <your-installation-directory>/naturalone to the according directory of your Eclipse:

/apache-tomcat
/njx