This document covers the following topics:
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.
This installation documentation provides just a brief description on how to install NaturalONE directly on the target machine using the Installer GUI. For detailed information, see the Software AG Installer documentation.
To install NaturalONE
A license file is provided for NaturalONE; the installer will prompt you during installation to install the NaturalONE runtime. 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.
Start the Installer GUI as described in the Software AG Installer documentation.
When the first page of the Installer GUI (the so-called Welcome panel) is shown, choose the button repeatedly (and specify all required information on the shown panels as described in the Software AG Installer documentation) 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.
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.
Or:
Expand 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 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.
Note
During installation, it is not mandatory to specify a license file for the
integrated NaturalONE runtime environment to install this component successfully.
You can skip the license dialog and later specify the local runtime license file in
NaturalONE. For more information, see Using NaturalONE >
Setting the Preferences >
Local Runtime License.
Or:
Choose the button to display the
following dialog box.
Select one of the following and choose the 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
Choose the button.
Read the license agreement, select the check box to agree to the terms of the license agreement, and choose the button.
Enter the full path to the NaturalONE license file (or use the button to select it from a dialog box), and choose the button.
On the last panel, review the items you have selected for installation. If the list is correct, choose the button to start the installation process.
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 theEclipse installed with NaturalONE. 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.
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/<platform>/ReducedFootprint
For example, on Windows, within this directory, start the script create_package.cmd. The result is a compressed file named ONE-<vers.no>small.tgz, along with the script extract_package.cmd.
Copy both the script and archive into the appropriate directory on the other development station and execute the script. NaturalONE is now operable.
Note
If NaturalONE Runtime is also part of the package on Windows, the latest Microsoft C++
Runtime (x86) must be installed on the target system.
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 Update Manager in this directory on the
development station. You must install the fixes in the original environment installed by
the Installer that you used to build the deployment package. You must create a new
deployment package, which includes the fixes.
If you need EntireX in your NaturalONE Application Development environment, which provides the full Application Testing and Service Development functionality, you have to install the EntireX plugins via > .
For information on where to obtain the EntireX plugins, refer to the documentation of IBM EntireX https://www.ibm.com/docs/en/entirex > Installing > Installing EntireX design-time outside the designer.
You uninstall NaturalONE using the Uninstaller. For information on how to use the uninstaller, see the Software AG Installer documentation.
