Installing NaturalONE

This document covers the following topics:


Typical Development Installation

NaturalONE is part of the Software AG Designer. The following graphic shows the NaturalONE components that can be installed with NaturalONE. The Application Development functionality is mandatory; NaturalONE cannot be installed without this. The other components are optional. Some of the optional components require that additional software is installed on a server. See also What is NaturalONE? in the Introduction.

Components

Installing NaturalONE Using the Software AG Installer GUI

This installation documentation provides just a brief description on how to install NaturalONE directly on the target machine using the Software AG Installer GUI. For detailed information on the Software AG Installer, see Using the Software AG Installer.

Start of instruction setTo install NaturalONE

Software AG provides a license file for NaturalONE; the installer requires it during installation. Copy the license file to the machine on which you want to install NaturalONE. You can copy it to any temporary location. The installer will ask for the location of your license file and will then copy it to the common/conf directory of your installation directory.

  1. Start the Software AG Installer GUI as described in Using the Software AG Installer.

  2. When the first page of the Software AG Installer GUI (the so-called Welcome panel) is shown, choose the Next button repeatedly (and specify all required information on the shown panels as described in Using the Software AG Installer) until the panel containing the product selection tree appears. This tree lists the products you have licensed and which can be installed on the operating system of the machine on which you are installing.

  3. To install the full functionality of NaturalONE, you need to use Typical Installations and the option NaturalONE Application Development Full Installation (see the description below).

    All required items are automatically selected.

    Product selection tree

    Or:
    Expand Designer > NaturalONE and select the product components that you want to install.

    Application Development is always required. NaturalONE cannot be installed without this item. It contains the core functionality of NaturalONE which consists of the basic functionality for Natural application development plus the possibility to create rich internet applications that use the Ajax technology. All other items under Designer > NaturalONE are optional components for NaturalONE. See also What is NaturalONE? in the Introduction.

    NaturalONE Runtime installs the integrated NaturalONE runtime environment (which is also referred to as the "local Natural runtime"). If you want to use an already installed Natural runtime on the local machine or on a remote machine, see also Using an Existing Natural Development Server Environment.

    A Software AG-supplied Eclipse and a number of shared plug-ins are always installed with NaturalONE.

    Other items in the tree (such as EntireX) are only required for service development. They are automatically selected when Service Development is selected.

    Or:
    Choose the Typical Installations button to display the following dialog box.

    Typical installation

    Select one of the following and choose the OK button:

    • NaturalONE Application Development
      This installs the following, in addition to the Application Development core functionality:

      Application Testing

    • NaturalONE Application Development Full Installation
      This installs the following, in addition to the Application Development core functionality:

      Application Testing
      Mainframe Tools
      Natural Construct
      NaturalONE Runtime
      Predict
      Service Development
      EntireX Workbench and many other items which are required by EntireX

    Note:
    For NaturalONE, it is not required that you select EntireX in this dialog box. EntireX is automatically installed with the Application Testing or Service Development component of NaturalONE.

  4. Choose the Next button.

  5. Read the license agreement, select the check box to agree to the terms of the license agreement, and choose the Next button.

  6. Enter the full path to the NaturalONE license file (or use the Browse button to select it from a dialog box), and choose the Next button.

  7. When a NaturalONE component was selected which requires service-enabling, a panel for Platform Manager appears. Platform Manager is an agent that allows remote administration of one or more selected products in this installation from Command Central. Select Install as Service if you plan to use this capability, otherwise select Install as Application in order to conserve system resources.

  8. When EntireX was selected, additional panels appear. For detailed information on these panels, see the Installing webMethods Products guide. The most up-to-date version of this guide is always available at http://documentation.softwareag.com/ (Empower login required).

  9. On the last panel, review the items you have selected for installation. If the list is correct, choose the Next button to start the installation process.

Completing the Installation

After NaturalONE has been installed, you can start it as described in Starting NaturalONE which is part of Using NaturalONE. NaturalONE's core functionality can be used without further configuration. Additional configuration steps, however, are required in the following cases:

  • You want to use an Eclipse other than the Software AG-installed Eclipse. See Using Your Own Eclipse.

  • You installed a complete development installation, with or without the NaturalONE runtime, and you also want to use an existing Natural Development Server (NDV). See Using an Existing Natural Development Server Environment.

  • You installed the Mainframe Tools component. This component includes Mainframe Navigation, which requires an Entire System Server environment. See Installation and Configuration in the Mainframe Navigation documentation.

  • You installed the Natural Construct component, which requires a Natural Construct server environment. See Requirements in the Using Natural Construct section of the Code Generation documentation.

  • You installed the Predict component, which requires a Predict server environment. See Setting Up a Predict Environment in the Predict Description and Generation documentation.

  • You installed the Service Development component, which requires a Natural Business Services server environment. See Prerequisites in the Business Services documentation.

  • You installed a complete development installation with service-enabling, but you did not install EntireX because you want to use an existing EntireX on the local or a remote machine. See Using an EntireX RPC Environment.

Preparing a Deployment Package

After installing NaturalONE and applying all current fixes to the installed version, you can prepare a compressed package of NaturalONE. The idea is to simplify and speed up the deployment of NaturalONE to additional development stations. No installation step is required, and these stations do not need access to the internet. Another advantage is that you can install additional Eclipse plug-ins which are distributed as well.

By copying and uncompressing this package into a directory on the development station, the "installation" of NaturalONE is finalized.

The required scripts are available at <installdir>/naturalone/scripts/ReducedFootprint.

On Windows, for example, start within this directory the script create_package.cmd. The result is a compressed file named ONE-<vers.no>small.tgz. Copy this compressed file and the script extract_package.cmd into the appropriate directory on the other development station and execute the script. NaturalONE is now operable.

The created package works only if you have installed the Application Development and Application Testing components. If you want to use service generation locally, you still have to do a NaturalONE full installation.

Note:
It is not possible to install fixes with the Software AG Update Manager in this directory on the development station. You must install the fixes in the original environment installed by the Software AG Installer that you used to build the deployment package. You must create a new deployment package, which includes the fixes.

Uninstalling NaturalONE

You uninstall NaturalONE using the Software AG Uninstaller. For information on how to use the uninstaller, see the Using the Software AG Installer guide.