Starting NaturalONE

This documentation explains how to work with NaturalONE, which is the Eclipse-based development environment for Natural. It explains the basic functionality for Natural application development. Special topics such as the creation of rich internet applications or web services are explained in other parts of the NaturalONE documentation.

Note
The descriptions and screenshots in this documentation are based on the Windows version of Eclipse, but they also apply to the Linux version of Eclipse.

This document covers the following topics:


Starting the NaturalONE Environment

Start of instruction setTo start NaturalONE in Windows

  • Go to the Start menu and type "NaturalONE <version>" in the search box.

Start of instruction setTo start NaturalONE under Linux

  • Run the start script naturalone from a shell.

    This start script is located in the bin directory of your installation directory. By default, this is /opt/softwareag/bin. All parameters that are specified on the command line are passed to NaturalONE.

    Or:
    Double-click the start script. NaturalONE will then be started using the default parameters.

When you start NaturalONE for the very first time, you will see a "Welcome" page. If this page is not visible, you can open it by choosing the Welcome command from the Help menu of Eclipse.

From the welcome page, you can switch to the NaturalONE perspective and invoke the NaturalONE documentation.

From the welcome page, you can also install sample applications. When you click on a sample application, it is copied to your workspace and is displayed as a new project. For more information, see Sample Applications.

NaturalONE Perspective

In order to work with NaturalONE, open the NaturalONE perspective. For more information, see Opening the NaturalONE Perspective.

License Key

NaturalONE is protected by a license key if the NaturalONE Runtime is installed. When you install NaturalONE with the NaturalONE Runtime, you are prompted to specify the path to your license file. The license file will then be copied to the common/conf directory of your NaturalONE installation.

Moreover, you must use the NaturalONE license file for Windows NDV servers if you want to map the server from a NaturalONE client.

Restore of the Natural Server View

The Natural Server view is restored when the NaturalONE perspective is displayed after NaturalONE has been started (or the first time you switch from another perspective to the NaturalONE perspective after NaturalONE has been started). When Natural environments have already been mapped (see

Accessing a Remote Development Environment) and the option Restore Natural server view is selected on the Runtime Execution page of the Natural preferences, this may take a while, especially when a large number of objects is stored on a server. A dialog box is displayed in this case to indicate the restore progress. During the restore, you can continue working with objects in other views. Up to a certain point, it is also possible to cancel the restore process.

Until the Natural Server view has been fully restored, its tree appears grayed out, indicating that the view is not yet available for use.

Natural for Eclipse Projects

Natural projects which have been created with Natural for Eclipse (NFN) cannot be used immediately with NaturalONE. You have to enable them first. For more information, see Enabling a Natural Project for NaturalONE.